نظرة عامة على CLI

كل أمر من أوامر forge مُصنَّف حسب المجموعات Core وMemory وSubstrate وQuality وConfig، إضافةً إلى متغيرات البيئة التي تتحكم في التنفيذ والمخرجات.

يُعرَّف سطح أوامر forge كبيانات (src/commands.js)، ويتم توفيقه مع التوثيق عبر forge docs check، بحيث لا يستطيع أمر أن يُشحن أو يختفي دون أن يلاحظه التوثيق. تُنظَّم الأوامر في خمس مجموعات.

Core

التهيئة والصيانة: init، وsync، وdoctor، وcatalog، وdocs، وupdate.

Memory

الذاكرة عبر الجلسات وذاكرة الفريق: cortex، وrecall، وremember، وbrain، وledger، وreuse، وhandoff، وdecide.

Substrate

بوّابة ما قبل الفعل ومراحلها: substrate، وpreflight، وroute، وimpact، وscope، وcontext، وanchor، وdiagnose، وimagine، وlean.

Quality

التحقق والسلامة: verify، وscan، وspec، وtaste، وuicheck، وharden.

Config

المزوِّدون، والتكلفة، ولوحات المعلومات، والعلامة التجارية، والأطلس، والحزمة: config، وcost، وdash، وbrand، وatlas، وstack.

​

الاصطلاحات

• إرشادي افتراضيًا. اضبط FORGE_ENFORCE=1 لتحويل الركيزة إلى حجب صارم على أقوى الإشارات (طلب فارغ، سياق مطلوب غير قابل للتجميع، نصف قطر انفجار يتجاوز عتبة 25 ملفًا الافتراضية).
• صامت افتراضيًا. العنوان Forge <cmd> — … لكل أمر هو زينة علامة تجارية خلف --verbose / FORGE_VERBOSE؛ يُصدر الأمر نتيجته أولًا.
• مخرَجات ملائمة للأنبوب. نص عادي عند الأنبوب؛ في الطرفية يضيف ألوان لوحة العلامة التجارية ومقاييس الثقة. NO_COLOR يوقف اللون، FORCE_COLOR=1 يُفرضه.
• --json متاح للركيزة ومعظم أوامر التحليل للسكربتات.

​

متغيرات البيئة

المتغيّر	الأثر
FORGE_ENFORCE=1	تحويل أقوى إشارات الركيزة الإرشادية إلى حجب صارم.
FORGE_GUARD_STRICT=1	ترقية تحذير DEGRADED لمُنقّي الأسرار إلى خروج حاجب. افتراضيًا، يطبع فشل الإخفاء secret redaction DEGRADED إلى stderr ويترك المخرَج يمرّ؛ الوضع الصارم يرفض إصدار أي شيء لم يستطع المنقّي تنظيفه كاملًا. استخدمه في CI أو على الأجهزة المشتركة حيث سطر غير مُخفَى أسوأ من أمر فاشل.
FORGE_NO_UPDATE_CHECK=1	إسكات إشعار “commits behind upstream” في forge doctor.
FORGE_NO_HINT=1	كتم تلميح init المُعروض لمرة واحدة الذي يدفعك إلى تشغيل forge init.
FORGE_VERBOSE=1	إظهار عنوان الأمر (Forge <cmd> — …) المخفي افتراضيًا.
FORGE_EMBED=1	تفعيل طبقة التضمينات لاسترجاع الذاكرة (يبقى MinHash افتراضًا بدون تبعيات).

شغّل forge --help للقائمة المحدَّثة دائمًا، أو forge catalog لفهرس البدء لكل أداة وطاقم وحاجز مع سبب موجز.

​

جديد في v0.19+

عدة أوامر وعلامات تصل في خط v0.19. موثقة في صفحات مجموعاتها وموسومة داخل النص:

الأمر / العلامة	المجموعة	ماذا يفعل
forge know	Memory	توجيه حقيقة إلى موطن تخزينها الصحيح.
forge deja	Memory	بحث عن أعمال سابقة مماثلة.
forge precommit	Quality	بوّابة تحقق على مستوى الالتزام.
forge radar	Quality	حلقات حداثة التبعيات.
forge report	Config	تقرير HTML ثابت عن حالة Forge للمستودع.
forge tools	Config	اختيار الأداة الأساسية + توصيل gitignore.
forge verify --deep	Quality	تحقق بإجماع متعدد العدسات.
forge update --to	Core	التثبيت أو الرجوع إلى إصدار معيّن.