Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
91 changes: 91 additions & 0 deletions mintlify/ar/cli/config.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,91 @@
---
title: "أوامر Config"
description: "المزوِّدون، والتكلفة، ولوحات المعلومات، والعلامة التجارية، والأطلس، والحزمة: config وcost وdash وbrand وatlas وstack — إضافةً إلى أمرَي report وtools في الإصدار v0.19+."
---

تُغطّي مجموعة Config المزوِّدين، والملاحظة، ورسم الشيفرة، واكتشاف الحزمة.

## `forge config`

إعداد المزوِّد — عرض / تبديل / إضافة المزوِّدين، وضبط النموذج الافتراضي.

```bash
forge config # show current config
forge config switch <provider>
forge config add <provider>
```

## `forge cost`

الإنفاق الفعلي في اليوم عبر معاملات المراحل المُقاسة.

```bash
forge cost # real per-day spend
forge cost --stages # measured per-stage cost factors
```

<Note>
يُبلَّغ عن **المراحل المُقاسة فقط** — المرحلة التي لا أحداث فيها تقول "لا بيانات"،
وليس قيمة افتراضية.
</Note>

## `forge dash`

لوحة معلومات محلية فوق السجل والقياسات ونصف قطر الانفجار.

```bash
forge dash # localhost-only, read-only (default port 4242)
```

## `forge brand`

طباعة خريطة رموز العلامة التجارية الفعّالة.

```bash
forge brand
```

تُخزَّن العلامة التجارية كرمز واحد (`brand.json`)؛ إعادة التسمية تعديل واحد فقط.

## `forge atlas`

بناء/استعلام رسم الشيفرة.

```bash
forge atlas build [path] # walk the tree → .forge/atlas.json
forge atlas query "what calls Z"
forge atlas has <symbol> # hallucinated-symbol check
```

الأطلس JSON عادي — أي أداة تقرؤه، ولا حاجة إلى MCP.

## `forge stack`

اكتشاف حزمة المستودع الفعلية من ملفات البيانات الوصفية.

```bash
forge stack
```

يقرأ `package.json`، و`pyproject.toml`، و`go.mod`، و`Cargo.toml`، و`Gemfile`،
و`composer.json`، و`pom.xml` / `build.gradle`، و`*.csproj`، ويُبلغ عن اللغات،
وأُطر العمل، ومديري الحِزم، وأوامر الاختبار **الفعلية** للمستودع — التي تُغذّي قائمة
تحقق الركيزة.

## `forge report` <sub>v0.19+</sub>

توليد تقرير HTML ثابت عن حالة Forge للمستودع — السجل والقياسات ونصف قطر الانفجار
مُصيَّرة في ملف مكتفٍ ذاتيًا يمكنك مشاركته أو أرشفته.

```bash
forge report
```

## `forge tools` <sub>v0.19+</sub>

اختَر أداة الترميز الأساسية بالذكاء الاصطناعي لهذا المستودع، ووصِّل مدخلات `.gitignore`
المطابقة، ليتم تجاهل الإعدادات المُولَّدة وقطع `.forge/` تجاهلًا صحيحًا لإعدادك.

```bash
forge tools
```
77 changes: 77 additions & 0 deletions mintlify/ar/cli/core.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,77 @@
---
title: "أوامر Core"
description: "تهيئة المستودع والحفاظ عليه: init وsync وdoctor وcatalog وdocs وupdate."
---

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

## `forge init`

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

```bash
forge init
```

يُصدر `AGENTS.md`، و`CLAUDE.md`، و`.gemini/settings.json`، و`.aider.conf.yml`، والباقي
(إضافةً إلى إعداد خادم MCP لأدوات Roo Code وVS Code)، وقاعدة الدمج الاتحادي في
`.gitattributes` التي يحتاجها السجل.

## `forge sync`

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

```bash
forge sync
```

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

## `forge doctor`

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

```bash
forge doctor
```

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

## `forge catalog`

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

```bash
forge catalog
```

## `forge docs`

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

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

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

## `forge update`

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

```bash
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` يُسكت إشعار الطبيب.
107 changes: 107 additions & 0 deletions mintlify/ar/cli/memory.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,107 @@
---
title: "أوامر Memory"
description: "الذاكرة عبر الجلسات وذاكرة الفريق: cortex وrecall وremember وbrain وledger وreuse وhandoff وdecide — تلتقي جميعها في السجل الحامل للإثبات."
---

تُدير مجموعة Memory الذاكرة عبر الجلسات وذاكرة الفريق. تلتقي كلها في السجل الحامل
للإثبات تحت `.forge/ledger/`. راجع
[الذاكرة الحاملة للإثبات](/ar/concepts/proof-carrying-memory) للنموذج.

## `forge cortex`

ذاكرة مشروع ذاتية التصحيح — دروس مستنبطة من التصحيحات.

```bash
forge cortex status # what's been learned
forge cortex why <symbol> # why a lesson applies here
```

## `forge recall`

إدارة الذاكرة الشخصية عبر الجلسات.

```bash
forge recall list # facts the recall-load guard injects next session
forge recall add "db port" "Postgres is on 5433 here, not 5432"
forge recall consolidate # summarize (advisory, human-reviewable)
```

## `forge remember`

إضافة حقيقة دائمة وقابلة للحفظ في المستودع إلى ذاكرة المستودع المحمولة.

```bash
forge remember "<fact>"
```

## `forge brain`

عرض أو إعادة بناء فهرس ذاكرة المشروع المحمول.

```bash
forge brain # show the index
forge brain --rebuild # rebuild it
```

## `forge ledger`

الذاكرة الحاملة للإثبات — مخزن الادعاءات المعنون بمحتواه.

```bash
forge ledger stats # what the repo knows, by kind and trust level
forge ledger verify # re-check claims are in normal form
forge ledger show <id> # a claim and its evidence
forge ledger blame <id-prefix> # who minted it, every oracle outcome, per-author trust
forge ledger query "<text>" # retrieve by relevance
forge ledger ratify <id> # human accept
forge ledger retract <id> # tombstone a claim
forge ledger merge <path> # fold a teammate's ledger in, conflict-free
forge ledger import # bridge legacy stores into the ledger
```

أضف `--personal` للحصول على سجل خاص بالمستخدم.

## `forge reuse`

مخبأ شيفرة حامل للإثبات — يُقدَّم فقط عندما تظل أدلته صالحة.

```bash
forge reuse query "<spec>" # verified code you already have
forge reuse mint "<spec>" --file <path> # add an artifact to the cache
forge reuse stats # cache stats
```

## `forge handoff`

لقطة جلسة محدودة — تُعيد كتابة `.forge/state.md`، وتُحقن في بداية كل جلسة.

```bash
forge handoff "<what's done>" --next "<what's next>"
```

## `forge decide`

سجل قرارات إضافي فقط — إدخالات ADR-lite بصيغة `D-####` في `.forge/decisions.md`.

```bash
forge decide "<decision> — <reason>"
forge decide # read the log before re-deciding
```

## `forge know` <sub>v0.19+</sub>

توجيه حقيقة إلى موطن تخزينها الصحيح — يقرر ما إذا كانت المعرفة تنتمي إلى
`recall`، أو `remember`/`brain`، أو قرار، أو درس cortex، ويودعها هناك.

```bash
forge know "<fact>"
```

## `forge deja` <sub>v0.19+</sub>

بحث عن أعمال سابقة مماثلة — يُظهر الأعمال السابقة في السجل التي تشبه ما توشك على
عمله، لتعيد استخدام الإثبات بدلًا من التوليد من جديد.

```bash
forge deja "<what you're about to build>"
```
60 changes: 60 additions & 0 deletions mintlify/ar/cli/overview.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,60 @@
---
title: "نظرة عامة على CLI"
description: "كل أمر من أوامر forge مُصنَّف حسب المجموعات Core وMemory وSubstrate وQuality وConfig — سطح الأوامر بيانات، ويتم توفيقه مع التوثيق بفحص انحراف صارم."
---

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

<CardGroup cols={2}>
<Card title="Core" icon="gear" href="/ar/cli/core">
التهيئة والصيانة: `init`، و`sync`، و`doctor`، و`catalog`، و`docs`، و`update`.
</Card>
<Card title="Memory" icon="brain" href="/ar/cli/memory">
الذاكرة عبر الجلسات وذاكرة الفريق: `cortex`، و`recall`، و`remember`، و`brain`،
و`ledger`، و`reuse`، و`handoff`، و`decide`.
</Card>
<Card title="Substrate" icon="diagram-project" href="/ar/cli/substrate">
بوّابة ما قبل الفعل ومراحلها: `substrate`، و`preflight`، و`route`، و`impact`،
و`scope`، و`context`، و`anchor`، و`diagnose`، و`imagine`، و`lean`.
</Card>
<Card title="Quality" icon="shield-check" href="/ar/cli/quality">
التحقق والسلامة: `verify`، و`scan`، و`spec`، و`taste`، و`uicheck`، و`harden`.
</Card>
<Card title="Config" icon="sliders" href="/ar/cli/config">
المزوِّدون، والتكلفة، ولوحات المعلومات، والعلامة التجارية، والأطلس، والحزمة:
`config`، و`cost`، و`dash`، و`brand`، و`atlas`، و`stack`.
</Card>
</CardGroup>

## الاصطلاحات

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

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

## جديد في 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 | التثبيت أو الرجوع إلى إصدار معيّن. |
Loading
Loading