أوامر Core

تُهيّئ مجموعة Core المستودع وتحافظ على صحته.

`forge init`

بناء إعداد هذا المستودع — يُصدر لكل أداة من مصدر مشترك واحد.

forge init

يُصدر AGENTS.md، وCLAUDE.md، و.gemini/settings.json، و.aider.conf.yml، والباقي (إضافةً إلى إعداد خادم MCP لأدوات Roo Code وVS Code)، وقاعدة الدمج الاتحادي في .gitattributes التي يحتاجها السجل. كما يدمج forge init خطّافات Forge وأذوناتها في ملف ~/.claude/settings.json العام، لذا يُعلن عن الدمج قبل الكتابة. الدمج عديم الأثر، محميّ بعلامة، ولا يُلغي مطلقًا مدخلات المستخدم.

علامات init

العلامة	ماذا تفعل
`--profile <name>`	اختيار ملف السياسة لهذا المستودع. يقبل `minimal` أو `standard` (الافتراضي). قيمة غير صالحة تُجهض قبل أي بناء أو كتابة `.forge/` أو دمج.
`--no-settings`	تخطّي دمج ملف `~/.claude/settings.json` العام كليًا — تُكتب فقط الإعدادات الخاصة بالمستودع.
`--remove-settings`	عكس دمج إعدادات سابق. تُزال الخطّافات والأذونات وسطر الحالة ذات شكل Forge وعلامة `_forge`؛ تُكتب نسخة احتياطية موسومة بالوقت أولًا، وتُحفظ مدخلاتك. يُستدعى أيضًا من `install.sh --uninstall`.
`--settings-only`	دمج الإعدادات العامة فقط — لا يمسّ المستودع. يستخدمه `install.sh` لتوصيل الخطّافات والأذونات.

إذا رُفض دمج الإعدادات أو أخفق، يفشل forge init بخروج 1 ويكتب السبب إلى stderr بدلًا من الإبلاغ عن النجاح.

ملفات السياسة

تختار --profile مجموعة القواعد التي يُصرّفها forge sync إلى إعداد كل أداة الأصلي. يُدعم ملفان اثنان فقط:

standard (الافتراضي) — الحزمة الكاملة: قواعد الذاكرة المشتركة، وتحليل الأثر، ومجموعة الخطّافات الحارسة الكاملة.
minimal — مجموعة قواعد أخفّ للمستودعات الصغيرة أو تفريعات المساهمين.

الأسماء الموروثة web-app وbackend-service وlibrary وregulated أسماء بديلة مهجورة لـ standard. لا تزال تعمل: يُحذّر forge init مرة واحدة، ويحفظ standard، وتتزامن الإعدادات الحالية التي تحمل اسمًا موروثًا كما لو كانت standard. على المستودعات الجديدة استخدام standard مباشرةً. أي قيمة أخرى غير صالحة وتُجهض قبل أن يمسّ Forge المستودع.

forge init --profile minimal            # leaner ruleset
forge init --no-settings                # per-repo only, skip the global merge
forge init --remove-settings            # reverse a past global merge

`forge sync`

إعادة تصريف المصدر القانوني إلى ملفات الإعداد الأصلية لكل أداة.

forge sync

عديم الأثر — يعيد كتابة ما تغيّر فقط. شغّله بعد تعديل source/rules.json أو .forge/rules.json الخاص بالمستودع.

`forge doctor`

فحص صحة الأدوات المثبتة، والحواجز، ومصادقة MCP، وانحراف الإعدادات.

forge doctor

نجاح/إخفاق عبر الأدوات، والحواجز، وتوصيلات MCP، وانحراف الإعدادات، وحالة التحديث. كل مسار يفشل بلطف. يطبع صف نماذج البوّابة التعيين المحلول tier → model عند إعداد بوّابة مخصّصة.

`forge catalog`

ابدأ من هنا — يعرض كل أداة، وطاقم، وحاجز مع سبب موجز من سطر واحد.

forge catalog

`forge docs`

انحراف التوثيق ↔ الشيفرة.

forge docs check     # registry reconcile — commands, env vars, MCP tools, CHANGELOG
forge docs sync      # diff-driven stale-docs sweep

يفشل docs check في CI عندما تنحرف الأوامر، أو متغيرات البيئة، أو أدوات MCP، أو CHANGELOG عن الشيفرة. يمسح docs sync الفرق ويُبلغ عن UPDATED / STALE / VERIFIED-UNAFFECTED.

`forge update`

تحديث ذاتي عبر أنماط التثبيت الثلاثة كلها.

forge update              # apply the update (git checkout or npm/copy install)
forge update --check      # report whether a newer version is available
forge update --to <version>   # pin or downgrade to a specific version (v0.19+)

كل مسار يفشل بلطف — دون اتصال أو منبع أو رأس منفصل يُرجَع “غير معروف”، لا خطأ. FORGE_NO_UPDATE_CHECK=1 يُسكت إشعار الطبيب.

​forge init

​علامات init

​ملفات السياسة

​forge sync

​forge doctor

​forge catalog

​forge docs

​forge update

`forge init`

علامات init

ملفات السياسة

`forge sync`

`forge doctor`

`forge catalog`

`forge docs`

`forge update`