@nac3/forge-cli 0.2.1-alpha.60 → 1.0.1

package/docs/doctrine/workflow-kinds.md

@@ -21,32 +21,49 @@ changed. No doc drift.
 
 ## How Forge decides + acts
 
-1. **Classify + ASK.** From the request + whether the project has
-   code, suggest a kind (the classifier is `src/workflow/select.ts`).
-   When confidence is low, ASK the user "esto es correctivo o
-   evolutivo?" before committing. Do NOT silently assume.
-2. **Set the kind.** Persist with `yujin.workflow.set({group:"kind",
-   patch:{kind:"corrective"}, top_level:true})`.
-3. **Run the right workflow.** Greenfield -> the 18-step flow.
-   corrective/evolutive -> the compact 6-stage flow above.
-4. **Log the evolution.** As you cross each stage/step boundary,
-   call `yujin.workflow.log-step({kind, stage_id, step_id?, event,
-   content})`. It writes the per-project doc `docs/WORKFLOW_LOG.md`
-   (auditable) + the mirror in `workflow.evolution[]`. The project
-   then documents its own workflow evolution -- steps + stages with
-   start/end/content.
+The orchestration is DETERMINISTIC code (`src/workflow/orchestrator.ts`),
+not LLM judgement. You drive it through verbs:
+
+1. **Open a workflow with `yujin.workflow.start({request})`.** It
+   classifies the kind (regex over the request + whether the project
+   has code -- `src/workflow/select.ts`). When the result is
+   `needs_confirm:true`, ASK the user "greenfield, correctivo o
+   evolutivo?" and call again with `{kind}`. Do NOT silently assume.
+   `start` then creates the instance (WFL-NNN) + **spawns one pending
+   per canonical task, in mandatory order**. Several workflows can
+   coexist (keyed by name) -- a fix and a feature run side by side.
+2. **Stages are NOT pendings; tasks are.** Work the task pendings in
+   order. The `yf pending close` gate REFUSES to close a task while an
+   earlier-order task is still open (override: `--force-order`). When
+   every task closes, the workflow **auto-closes** -- you do not close
+   it by hand.
+3. **Add tasks at discretion.** If the user OR you decide a
+   corrective/evolutive task is needed mid-workflow, add it with
+   `yujin.workflow.add-task({code, title})` -- it appends at the end of
+   the order (flagged `ad_hoc`).
+4. **Edit the phases/tasks on request.** `yujin.workflow.configure({patch})`
+   rewrites the project's editable definitions
+   (`.forge/workflow-config.json`); the code default stays recoverable
+   (`yf workflow config --reset`).
+5. **Log the evolution.** As you cross stage/step boundaries, call
+   `yujin.workflow.log-step(...)` -- it writes `docs/WORKFLOW_LOG.md` +
+   `workflow.evolution[]` so the project records its own workflow
+   history. Greenfield detail = the 18-step flow (`workflow`,
+   `workflow-phases`); never force it on a live project.
 
 ## Relation to the request lifecycle
 
 The pending request-lifecycle (add -> note -> close with history) is
-the MICRO level (per request). The workflow is the MACRO level (per
-project, with stages). They compose: the macro workflow names the
-stage; each request inside it runs the micro lifecycle. Do not
-duplicate -- a corrective run IS a pending item whose work crosses
-the corrective stages.
+the MICRO level (per task). The workflow is the MACRO level (per
+project, with stages). They are now the SAME store: a workflow task IS
+a pending item (with a `workflow` link). The instance names the stages;
+its tasks are pendings closed in mandatory order.
 
 ## Canonical steps source
 
-The canonical step definitions come from the worker (general,
-shared) with a LOCAL fallback (`src/workflow/definitions.ts`) so
-Forge keeps working offline -- same pattern as doctrines + lessons.
+The canonical step definitions live in `src/workflow/definitions.ts`
+(the immutable DEFAULT + disaster-recovery source). A project may
+override them in `.forge/workflow-config.json` (edited via
+`yujin.workflow.configure`); a `.default.json` snapshot keeps the
+default recoverable. The worker-canonical layer plugs in later, same
+pattern as doctrines + lessons.

package/docs/doctrine/workflow.md

@@ -1,8 +1,16 @@
-# Workflow doctrine -- 6 phases / 18 steps
+# Workflow doctrine -- 6 phases / 18 steps (GREENFIELD)
 
-Yujin Forge guides delivery through 6 phases / 18 steps (PRODUCT_WORKFLOW.md).
-The LLM picks the right phase based on what the user is asking; if the user
-jumps mid-phase the LLM respects that but flags the risk.
+SCOPE: this 6-phase / 18-step methodology is the GREENFIELD workflow --
+building a new app from zero. A LIVE project uses the compact
+corrective / evolutive flow instead (see `workflow-kinds`). Never force
+these 18 steps on an existing project. Open any workflow with
+`yujin.workflow.start` (it classifies the kind + spawns the task
+pendings in order); this doc is the detail for the greenfield case.
+
+Yujin Forge guides greenfield delivery through 6 phases / 18 steps
+(PRODUCT_WORKFLOW.md). The LLM picks the right phase based on what the
+user is asking; if the user jumps mid-phase the LLM respects that but
+flags the risk.
 
 PHASE I -- INTAKE (steps 1-3.5)
   1.   Complexity triage           Simple / Medium / Full tier

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nac3/forge-cli",
-  "version": "0.2.1-alpha.60",
+  "version": "1.0.1",
   "description": "Yujin Forge -- voice-first NAC-3 React development framework. CLI + chat panel + spec ingest + 10-format document reader + voice loop.",
   "license": "SEE LICENSE IN LICENSE",
   "author": "Pablo Kuschnirof <pablo@rpaforce.com>",
@@ -16,6 +16,7 @@
     ".": "./dist/index.js"
   },
   "scripts": {
+    "version": "node scripts/sync_version.mjs && git add src/version.ts",
     "build": "tsc && node scripts/copy_qa_assets.mjs",
     "dev": "tsx watch src/bin/yf.ts",
     "typecheck": "tsc --noEmit",

package/src/i18n/catalogs/ar.json

@@ -1,210 +1,223 @@
-{
-  "panel.brand": "Yujin Forge",
-  "panel.brand.kanji": "侑",
-  "panel.tagline": "مساعد تطوير صوتي أولاً",
-  "panel.input.placeholder": "اسأل Yujin",
-  "panel.button.send": "إرسال",
-  "panel.button.mic": "تحدث (اضغط مع الاستمرار)",
-  "panel.button.mic.recording": "اضغط لإيقاف التسجيل",
-  "panel.button.tts": "الصوت مفعل",
-  "panel.button.keys": "المفاتيح",
-  "panel.button.minimise": "تصغير",
-  "panel.button.maximise": "تكبير",
-  "panel.button.close": "إغلاق",
-  "panel.button.language": "اللغة",
-  "panel.trace.title": "سجل الإجراءات",
-  "panel.trace.count.one": "{n} استدعاء أداة",
-  "panel.trace.count.other": "{n} استدعاءات أدوات",
-  "panel.trace.empty.kanji": "空",
-  "panel.trace.empty.body": "يعرض Yujin Forge هنا كل أداة يستدعيها للرد عليك: قراءة البيان، البحث في SPEC، تحرير المكونات، قراءة المستندات. اطرح سؤالاً يتطلب الرجوع إليها.",
-  "panel.trace.badge.tool": "أداة",
-  "panel.trace.badge.voice": "صوت",
-  "panel.trace.badge.error": "خطأ",
-  "panel.stream.empty.kanji": "侑仁",
-  "panel.stream.empty.body": "Yujin Forge متصل. اطلب تغييرات على المشروع.",
-  "panel.status.no_audio": "لم يُلتقط أي صوت. ربما لم يستقبل الميكروفون شيئاً.",
-  "panel.status.did_not_catch": "لم أفهم. لنجرب مرة أخرى.",
-  "panel.status.mic_denied": "إذن الميكروفون مرفوض أو غير متاح: {error}",
-  "panel.status.voice_failed": "فشل الصوت: {error}",
-  "panel.status.voice_reply_failed": "تعذر تشغيل الرد: {error}",
-  "panel.status.audio_play_error": "تعذر تشغيل الصوت: {error}",
-  "panel.status.reading": "جارٍ قراءة {filename}...",
-  "panel.status.ingest_failed": "فشل الاستيعاب: {error}",
-  "panel.status.read_failed": "تعذرت قراءة المواصفات: {error}",
-  "panel.drop.title": "أفلت المواصفات هنا",
-  "panel.drop.hint": "PDF, DOCX, HTML, MD, RTF, EPUB, CSV, XLSX, TXT",
-  "panel.ingest.spec_attached": "تم إرفاق المواصفات: {filename}، {kb} KB",
-  "panel.ingest.read_label": "تمت القراءة.",
-  "panel.ingest.title_label": "العنوان: {title}",
-  "panel.ingest.no_title": "(بدون عنوان)",
-  "panel.ingest.format_label": "التنسيق: {format} / {sections} قسم / {kb} KB",
-  "panel.ingest.first_lines": "الأسطر الأولى:",
-  "panel.ingest.action_done": "اكتمل الإجراء {tool}.",
-  "vault.modal.title": "بيانات الاعتماد (الخزنة)",
-  "vault.modal.aria.close": "إغلاق نافذة بيانات الاعتماد",
-  "vault.tab.list": "الخانات المحملة",
-  "vault.tab.add": "إضافة",
-  "vault.list.loading": "جارٍ التحميل...",
-  "vault.list.empty": "لم تقم بتحميل أي مفتاح بعد. انقر على \"إضافة\" للبدء.",
-  "vault.add.slot_label": "اسم الخانة",
-  "vault.add.slot_hint": "أحرف صغيرة، أرقام، شرطة سفلية، واصلة. يجب أن يبدأ بحرف.",
-  "vault.add.value_label": "القيمة النصية (مخفية)",
-  "vault.add.value_hint": "تُعرض مرة واحدة فقط عند الحفظ. بعد ذلك يمكن استبدالها وليس قراءتها.",
-  "vault.add.button_save": "حفظ",
-  "vault.add.button_cancel": "إلغاء",
-  "vault.add.success": "تم حفظ الخانة {slot}.",
-  "vault.add.overwrite": "تم استبدال الخانة {slot}.",
-  "manual.intro": "Yujin Forge -- دليل المستخدم",
-  "manual.section.welcome": "مرحباً",
-  "manual.section.install": "التثبيت",
-  "manual.section.first_run": "التشغيل الأول",
-  "manual.section.voice": "الأوامر الصوتية",
-  "manual.section.spec_ingest": "استيعاب المواصفات",
-  "manual.section.troubleshooting": "حل المشكلات",
-  "manual.section.support": "الدعم",
-  "lang.name.es": "الإسبانية",
-  "lang.name.en": "الإنجليزية",
-  "lang.name.pt": "البرتغالية",
-  "lang.name.fr": "الفرنسية",
-  "lang.name.ja": "اليابانية",
-  "lang.name.zh": "الصينية",
-  "lang.name.hi": "الهندية",
-  "lang.name.ar": "العربية",
-  "lang.name.de": "الألمانية",
-  "lang.name.it": "الإيطالية",
-  "recap.fallback_period": ".",
-  "recap.empty": "لا يوجد ما يمكن تلخيصه بعد.",
-  "error_ui.severity.info": "معلومات",
-  "error_ui.severity.warning": "تحذير",
-  "error_ui.severity.error": "خطأ",
-  "error_ui.severity.fatal": "فادح",
-  "error_ui.label.what": "ماذا حدث",
-  "error_ui.label.why": "لماذا",
-  "error_ui.label.fix": "كيفية الإصلاح",
-  "error_ui.label.cmd": "الأمر",
-  "error_ui.label.docs": "الوثائق المحلية",
-  "error_ui.label.retry": "إعادة المحاولة في",
-  "error_ui.copy_btn": "نسخ الأمر",
-  "error_ui.unknown.what": "واجه Forge خطأ داخليا (رمز غير معروف).",
-  "error_ui.unknown.why": "الرمز {code} ليس في الكتالوج. هذا خطأ برمجي.",
-  "error_ui.unknown.fix": "افتح issue في https://github.com/yujinapp/yujin-forge/issues مع الرمز و traceback.",
-  "error.cap_frontier_exhausted.what": "نفد الحد الشهري لرموز طبقة frontier (نموذج كبير).",
-  "error.cap_frontier_exhausted.why": "خطتك {plan} تسمح بحد أقصى {cap} رمز/شهر على frontier. استخدمت {used}. يعاد الضبط في بداية الشهر UTC التالي.",
-  "error.cap_frontier_exhausted.fix": "انتقل إلى BYOK Anthropic مباشرة: يتجاوز الحد الشهري لـ worker. تصبح تكلفتك ما تتقاضاه Anthropic مباشرة.",
-  "error.cap_frontier_exhausted.cmd": "yf brain config --frontier-provider anthropic --frontier-model claude-opus-4-7",
-  "error.cap_eco_exhausted.what": "نفد الحد الشهري لرموز طبقة eco (نموذج صغير).",
-  "error.cap_eco_exhausted.why": "خطتك {plan} تسمح بحد أقصى {cap} رمز/شهر على eco. استخدمت {used}. يعاد الضبط في بداية الشهر UTC التالي.",
-  "error.cap_eco_exhausted.fix": "انتقل إلى BYOK مباشرة أو قم بترقية الخطة. BYOK يتجاوز حد worker.",
-  "error.cap_eco_exhausted.cmd": "yf brain config --eco-provider google_ai --eco-model gemini-2.5-flash-lite",
-  "error.tier_not_in_plan.what": "الطبقة {tier} غير مفعلة على خطتك.",
-  "error.tier_not_in_plan.why": "خطتك {plan} لا تتضمن طبقة {tier}. ربما أنت على free-public أو انتهت صلاحية ترخيصك.",
-  "error.tier_not_in_plan.fix": "فعل ترخيصا مدفوعا أو انتقل إلى BYOK مباشرة (تكلفتك، دون حد worker).",
-  "error.tier_not_in_plan.cmd": "yf license activate --key <jwt>",
-  "error.response_truncated.what": "تم قطع استجابة النموذج قبل الانتهاء.",
-  "error.response_truncated.why": "تم الوصول إلى حد managed_max_tokens_per_turn = {limit} رمز في منتصف الدور. توقف النموذج عن التوليد.",
-  "error.response_truncated.fix": "ارفع الحد عبر yf limits. ينطبق على الدور التالي دون إعادة تشغيل الدردشة.",
-  "error.response_truncated.cmd": "yf limits set managed_max_tokens_per_turn 16384",
-  "error.response_truncated.banner": "[الاستجابة مقتطعة بواسطة max_tokens={max}. ارفع الحد بـ: yf limits set managed_max_tokens_per_turn {suggested}]",
-  "error.modal_trace_stale.what": "انتهت صلاحية مودال الموافقة أو أصبح يتيما.",
-  "error.modal_trace_stale.why": "trace_id {trace_id} ليس له موافقة معلقة في dispatcher. ربما race condition بين invoke وحالة panel، أو ترك cancel سابق trace في حالة zombie.",
-  "error.modal_trace_stale.fix": "استدع verb من الدردشة مرة أخرى: يبدأ trace جديد نظيف. إذا استمر، شغل yf doctor لفحص panel.",
-  "error.modal_trace_stale.cmd": "yf doctor",
-  "error.byok_key_missing.what": "مفتاح API مفقود للمزود {provider}.",
-  "error.byok_key_missing.why": "لقد أعددت {provider} كمزود لطبقة {tier} لكن الفتحة byok_{slot} ليست في Vault المشفر.",
-  "error.byok_key_missing.fix": "كون المفتاح بـ yf keys set (ذري، mode 0600، لا يسجل أبدا).",
-  "error.byok_key_missing.cmd": "yf keys set {slot}",
-  "error.worker_unreachable.what": "لم أستطع الوصول إلى worker yujin.app.",
-  "error.worker_unreachable.why": "انتهاء مهلة الشبكة أو worker معطل (HTTP {status}). أعدت المحاولة {attempts} مرات.",
-  "error.worker_unreachable.fix": "افحص إنترنتك. إذا كان جيدا، انتقل مؤقتا إلى BYOK مباشرة لتجنب الاعتماد على worker.",
-  "error.worker_unreachable.cmd": "yf brain config --frontier-provider anthropic",
-  "error.vault_decrypt_failed.what": "لم أستطع فك تشفير مفتاح من Vault.",
-  "error.vault_decrypt_failed.why": "مفتاح master غير صحيح أو ملف Vault تالف. يمكن أن يحدث إذا نقلت config بين الأجهزة دون نقل master، أو بسبب disk error.",
-  "error.vault_decrypt_failed.fix": "اسحب نسخة الخادم (يعيد التشفير بـ master المحلي) إذا كان لديك server backup نشط.",
-  "error.vault_decrypt_failed.cmd": "yf keys setup --pull",
-  "error.shell_exec_rejected.what": "رفضت مودال R8 لـ yujin.shell.exec.",
-  "error.shell_exec_rejected.why": "تم تصنيف الأمر {command} على أنه {classification}. shell.exec يطلب الموافقة دائما للأمان، حتى لو كان الأمر read-only.",
-  "error.shell_exec_rejected.fix": "إذا كان الأمر read-only (yf projects active، git status، ls)، استخدم verb الأصلي المكافئ. إذا كان ضروريا ورفضته بالخطأ، استدعه مرة أخرى.",
-  "error.project_not_registered.what": "لا يوجد مشروع adopter مسجل.",
-  "error.project_not_registered.why": "يتطلب verb المستدعى project root نشط لكن ~/.yujin-forge/projects.json ليس به إدخالات.",
-  "error.project_not_registered.fix": "أنشئ واحدا بـ yujin.project.init أو سجل واحدا موجودا بـ yf projects add.",
-  "error.project_not_registered.cmd": "yf projects scan",
-  "panel.button.agents": "الوكلاء",
-  "panel.agents.title": "الوكلاء",
-  "panel.agents.subtitle": "المدير والوكلاء الفرعيون المسجلون في هذا المشروع",
-  "panel.agents.empty.title": "لا يوجد وكلاء بعد",
-  "panel.agents.empty.body": "قم بتشغيل `yf agent install --defaults` لتسجيل المدير ووكلائه الفرعيين الأربعة (المحلل، المبرمج، المختبر، المُجهز).",
-  "panel.agents.legend.eco": "اقتصادي",
-  "panel.agents.legend.managed": "مُدار",
-  "panel.agents.legend.frontier": "حدود",
-  "panel.agents.status.disabled": "وقت تشغيل الوكلاء غير مُشغّل",
-  "panel.agents.event.running": "قيد التشغيل",
-  "panel.agents.event.idle": "خامل",
-  "panel.agents.tick.live": "متصل",
-  "panel.agents.tick.lost": "الاتصال مفقود",
-  "workflow.phase.i": "الفرز والنية",
-  "workflow.phase.ii": "التوضيح (الوظيفي + 4 NFR + الكتل)",
-  "workflow.phase.iii": "المواصفات (RFP + المعمارية + التصميم + الموافقات)",
-  "workflow.phase.iv": "التهيئة",
-  "workflow.phase.v": "تطوير الكتل",
-  "workflow.phase.vi": "النشر + ما بعد الإطلاق",
-  "wizard.title": "مرحبا بك في Yujin Forge",
-  "wizard.close": "إغلاق",
-  "wizard.intro": "للبدء، اختر كيف يتصل Forge بنموذج الذكاء الاصطناعي. يمكنك تغيير ذلك لاحقا من Settings.",
-  "wizard.back": "رجوع",
-  "wizard.start": "ابدأ",
-  "wizard.plan.badge": "موصى به",
-  "wizard.plan.title": "خطة Claude",
-  "wizard.plan.desc": "اشتراك Claude الشهري. الخيار الأكثر اقتصاديا للاستخدام المستمر. Forge يستخدم جلسة claude -p الخاصة بك.",
-  "wizard.plan.price": "رسم شهري ثابت (الخطة)",
-  "wizard.plan.step.title": "وصل خطة Claude الخاصة بك",
-  "wizard.plan.step.1": "افتح موجه أوامر جديد.",
-  "wizard.plan.step.2": "نفذ الأمر claude (بدون وسائط) وأكمل تسجيل الدخول في المتصفح.",
-  "wizard.plan.step.3": "عد إلى هنا واضغط أنا مسجل الدخول للتحقق.",
-  "wizard.plan.done": "أنا مسجل الدخول",
-  "wizard.byok.title": "مفتاح API الخاص بك (BYOK)",
-  "wizard.byok.desc": "مفتاح Anthropic Console الخاص بك. دفع حسب الاستخدام. أكثر مرونة لكن التكلفة متغيرة.",
-  "wizard.byok.price": "دفع حسب الاستخدام (Console)",
-  "wizard.byok.step.title": "الصق مفتاح Anthropic API الخاص بك",
-  "wizard.byok.step.intro": "يبدأ مفتاحك بـ sk-ant- ويتم الحصول عليه من console.anthropic.com. يخزنه Forge مشفرا في Vault المحلي؛ لا يغادر جهازك أبدا.",
-  "wizard.byok.test": "تحقق واحفظ",
-  "wizard.skip.title": "أنا بالفعل معد",
-  "wizard.skip.desc": "تخطي المعالج. يمكنك إعادة فتحه من Settings لاحقا.",
-  "wizard.done.kanji": "تم",
-  "wizard.done.title": "تم",
-  "wizard.done.msg": "Forge جاهز. ابدأ الدردشة.",
-  "pizarron.button.read": "اقرأ بصوت",
-  "pizarron.button.copy": "نسخ",
-  "pizarron.button.edit": "تحرير",
-  "pizarron.graph.refresh": "تحديث",
-  "pizarron.graph.regenerating": "جارٍ إعادة التوليد...",
-  "pizarron.graph.detail.hint": "انقر على عقدة لعرض التفاصيل.",
-  "pizarron.graph.detail.empty": "لا توجد تفاصيل لهذه العقدة.",
-  "pizarron.graph.detail.weight": "الوزن",
-  "startup.tab.graph": "رسم بياني مرئي",
-  "startup.tab.graphSem": "الرسم الدلالي",
-  "startup.tab.pendings": "معلق",
-  "startup.tab.workflow": "سير العمل",
-  "settings.startupTabs": "علامات التبويب عند الفتح",
-  "graph.term.nodes": "عقد",
-  "graph.term.edges": "حواف",
-  "coding.read": "جارٍ قراءة {x}",
-  "coding.read_bare": "جارٍ قراءة ملف",
-  "coding.edit": "جارٍ تعديل {x}",
-  "coding.edit_bare": "جارٍ تعديل ملف",
-  "coding.write": "جارٍ كتابة {x}",
-  "coding.write_bare": "جارٍ كتابة ملف",
-  "coding.notebook_bare": "جارٍ تعديل الدفتر",
-  "coding.bash": "جارٍ التنفيذ: {x}",
-  "coding.bash_bare": "جارٍ تنفيذ أمر",
-  "coding.grep": "جارٍ البحث \"{x}\"",
-  "coding.grep_bare": "جارٍ البحث في الكود",
-  "coding.glob": "جارٍ سرد {x}",
-  "coding.glob_bare": "جارٍ سرد الملفات",
-  "coding.web_bare": "جارٍ قراءة الويب",
-  "coding.websearch": "بحث في الويب: {x}",
-  "coding.websearch_bare": "جارٍ البحث في الويب",
-  "coding.task": "وكيل فرعي: {x}",
-  "coding.task_bare": "جارٍ تشغيل وكيل فرعي",
-  "coding.todo": "جارٍ تحديث قائمة مهامه",
-  "coding.verb_bare": "جارٍ تنفيذ فعل yujin"
-}
+{
+  "panel.brand": "Yujin Forge",
+  "panel.brand.kanji": "侑",
+  "panel.tagline": "مساعد تطوير صوتي أولاً",
+  "panel.input.placeholder": "اسأل Yujin",
+  "panel.button.send": "إرسال",
+  "panel.button.mic": "تحدث (اضغط مع الاستمرار)",
+  "panel.button.mic.recording": "اضغط لإيقاف التسجيل",
+  "panel.button.tts": "الصوت مفعل",
+  "panel.button.keys": "المفاتيح",
+  "panel.button.minimise": "تصغير",
+  "panel.button.maximise": "تكبير",
+  "panel.button.close": "إغلاق",
+  "panel.button.language": "اللغة",
+  "panel.trace.title": "سجل الإجراءات",
+  "panel.trace.count.one": "{n} استدعاء أداة",
+  "panel.trace.count.other": "{n} استدعاءات أدوات",
+  "panel.trace.empty.kanji": "空",
+  "panel.trace.empty.body": "يعرض Yujin Forge هنا كل أداة يستدعيها للرد عليك: قراءة البيان، البحث في SPEC، تحرير المكونات، قراءة المستندات. اطرح سؤالاً يتطلب الرجوع إليها.",
+  "panel.trace.badge.tool": "أداة",
+  "panel.trace.badge.voice": "صوت",
+  "panel.trace.badge.error": "خطأ",
+  "panel.stream.empty.kanji": "侑仁",
+  "panel.stream.empty.body": "Yujin Forge متصل. اطلب تغييرات على المشروع.",
+  "panel.status.no_audio": "لم يُلتقط أي صوت. ربما لم يستقبل الميكروفون شيئاً.",
+  "panel.status.did_not_catch": "لم أفهم. لنجرب مرة أخرى.",
+  "panel.status.mic_denied": "إذن الميكروفون مرفوض أو غير متاح: {error}",
+  "panel.status.voice_failed": "فشل الصوت: {error}",
+  "panel.status.voice_reply_failed": "تعذر تشغيل الرد: {error}",
+  "panel.status.audio_play_error": "تعذر تشغيل الصوت: {error}",
+  "panel.status.reading": "جارٍ قراءة {filename}...",
+  "panel.status.ingest_failed": "فشل الاستيعاب: {error}",
+  "panel.status.read_failed": "تعذرت قراءة المواصفات: {error}",
+  "panel.drop.title": "أفلت المواصفات هنا",
+  "panel.drop.hint": "PDF, DOCX, HTML, MD, RTF, EPUB, CSV, XLSX, TXT",
+  "panel.ingest.spec_attached": "تم إرفاق المواصفات: {filename}، {kb} KB",
+  "panel.ingest.read_label": "تمت القراءة.",
+  "panel.ingest.title_label": "العنوان: {title}",
+  "panel.ingest.no_title": "(بدون عنوان)",
+  "panel.ingest.format_label": "التنسيق: {format} / {sections} قسم / {kb} KB",
+  "panel.ingest.first_lines": "الأسطر الأولى:",
+  "panel.ingest.action_done": "اكتمل الإجراء {tool}.",
+  "vault.modal.title": "بيانات الاعتماد (الخزنة)",
+  "vault.modal.aria.close": "إغلاق نافذة بيانات الاعتماد",
+  "vault.tab.list": "الخانات المحملة",
+  "vault.tab.add": "إضافة",
+  "vault.list.loading": "جارٍ التحميل...",
+  "vault.list.empty": "لم تقم بتحميل أي مفتاح بعد. انقر على \"إضافة\" للبدء.",
+  "vault.add.slot_label": "اسم الخانة",
+  "vault.add.slot_hint": "أحرف صغيرة، أرقام، شرطة سفلية، واصلة. يجب أن يبدأ بحرف.",
+  "vault.add.value_label": "القيمة النصية (مخفية)",
+  "vault.add.value_hint": "تُعرض مرة واحدة فقط عند الحفظ. بعد ذلك يمكن استبدالها وليس قراءتها.",
+  "vault.add.button_save": "حفظ",
+  "vault.add.button_cancel": "إلغاء",
+  "vault.add.success": "تم حفظ الخانة {slot}.",
+  "vault.add.overwrite": "تم استبدال الخانة {slot}.",
+  "manual.intro": "Yujin Forge -- دليل المستخدم",
+  "manual.section.welcome": "مرحباً",
+  "manual.section.install": "التثبيت",
+  "manual.section.first_run": "التشغيل الأول",
+  "manual.section.voice": "الأوامر الصوتية",
+  "manual.section.spec_ingest": "استيعاب المواصفات",
+  "manual.section.troubleshooting": "حل المشكلات",
+  "manual.section.support": "الدعم",
+  "lang.name.es": "الإسبانية",
+  "lang.name.en": "الإنجليزية",
+  "lang.name.pt": "البرتغالية",
+  "lang.name.fr": "الفرنسية",
+  "lang.name.ja": "اليابانية",
+  "lang.name.zh": "الصينية",
+  "lang.name.hi": "الهندية",
+  "lang.name.ar": "العربية",
+  "lang.name.de": "الألمانية",
+  "lang.name.it": "الإيطالية",
+  "recap.fallback_period": ".",
+  "recap.empty": "لا يوجد ما يمكن تلخيصه بعد.",
+  "error_ui.severity.info": "معلومات",
+  "error_ui.severity.warning": "تحذير",
+  "error_ui.severity.error": "خطأ",
+  "error_ui.severity.fatal": "فادح",
+  "error_ui.label.what": "ماذا حدث",
+  "error_ui.label.why": "لماذا",
+  "error_ui.label.fix": "كيفية الإصلاح",
+  "error_ui.label.cmd": "الأمر",
+  "error_ui.label.docs": "الوثائق المحلية",
+  "error_ui.label.retry": "إعادة المحاولة في",
+  "error_ui.copy_btn": "نسخ الأمر",
+  "error_ui.unknown.what": "واجه Forge خطأ داخليا (رمز غير معروف).",
+  "error_ui.unknown.why": "الرمز {code} ليس في الكتالوج. هذا خطأ برمجي.",
+  "error_ui.unknown.fix": "افتح issue في https://github.com/yujinapp/yujin-forge/issues مع الرمز و traceback.",
+  "error.cap_frontier_exhausted.what": "نفد الحد الشهري لرموز طبقة frontier (نموذج كبير).",
+  "error.cap_frontier_exhausted.why": "خطتك {plan} تسمح بحد أقصى {cap} رمز/شهر على frontier. استخدمت {used}. يعاد الضبط في بداية الشهر UTC التالي.",
+  "error.cap_frontier_exhausted.fix": "انتقل إلى BYOK Anthropic مباشرة: يتجاوز الحد الشهري لـ worker. تصبح تكلفتك ما تتقاضاه Anthropic مباشرة.",
+  "error.cap_frontier_exhausted.cmd": "yf brain config --frontier-provider anthropic --frontier-model claude-opus-4-7",
+  "error.cap_eco_exhausted.what": "نفد الحد الشهري لرموز طبقة eco (نموذج صغير).",
+  "error.cap_eco_exhausted.why": "خطتك {plan} تسمح بحد أقصى {cap} رمز/شهر على eco. استخدمت {used}. يعاد الضبط في بداية الشهر UTC التالي.",
+  "error.cap_eco_exhausted.fix": "انتقل إلى BYOK مباشرة أو قم بترقية الخطة. BYOK يتجاوز حد worker.",
+  "error.cap_eco_exhausted.cmd": "yf brain config --eco-provider google_ai --eco-model gemini-2.5-flash-lite",
+  "error.tier_not_in_plan.what": "الطبقة {tier} غير مفعلة على خطتك.",
+  "error.tier_not_in_plan.why": "خطتك {plan} لا تتضمن طبقة {tier}. ربما أنت على free-public أو انتهت صلاحية ترخيصك.",
+  "error.tier_not_in_plan.fix": "فعل ترخيصا مدفوعا أو انتقل إلى BYOK مباشرة (تكلفتك، دون حد worker).",
+  "error.tier_not_in_plan.cmd": "yf license activate --key <jwt>",
+  "error.response_truncated.what": "تم قطع استجابة النموذج قبل الانتهاء.",
+  "error.response_truncated.why": "تم الوصول إلى حد managed_max_tokens_per_turn = {limit} رمز في منتصف الدور. توقف النموذج عن التوليد.",
+  "error.response_truncated.fix": "ارفع الحد عبر yf limits. ينطبق على الدور التالي دون إعادة تشغيل الدردشة.",
+  "error.response_truncated.cmd": "yf limits set managed_max_tokens_per_turn 16384",
+  "error.response_truncated.banner": "[الاستجابة مقتطعة بواسطة max_tokens={max}. ارفع الحد بـ: yf limits set managed_max_tokens_per_turn {suggested}]",
+  "error.modal_trace_stale.what": "انتهت صلاحية مودال الموافقة أو أصبح يتيما.",
+  "error.modal_trace_stale.why": "trace_id {trace_id} ليس له موافقة معلقة في dispatcher. ربما race condition بين invoke وحالة panel، أو ترك cancel سابق trace في حالة zombie.",
+  "error.modal_trace_stale.fix": "استدع verb من الدردشة مرة أخرى: يبدأ trace جديد نظيف. إذا استمر، شغل yf doctor لفحص panel.",
+  "error.modal_trace_stale.cmd": "yf doctor",
+  "error.byok_key_missing.what": "مفتاح API مفقود للمزود {provider}.",
+  "error.byok_key_missing.why": "لقد أعددت {provider} كمزود لطبقة {tier} لكن الفتحة byok_{slot} ليست في Vault المشفر.",
+  "error.byok_key_missing.fix": "كون المفتاح بـ yf keys set (ذري، mode 0600، لا يسجل أبدا).",
+  "error.byok_key_missing.cmd": "yf keys set {slot}",
+  "error.worker_unreachable.what": "لم أستطع الوصول إلى worker yujin.app.",
+  "error.worker_unreachable.why": "انتهاء مهلة الشبكة أو worker معطل (HTTP {status}). أعدت المحاولة {attempts} مرات.",
+  "error.worker_unreachable.fix": "افحص إنترنتك. إذا كان جيدا، انتقل مؤقتا إلى BYOK مباشرة لتجنب الاعتماد على worker.",
+  "error.worker_unreachable.cmd": "yf brain config --frontier-provider anthropic",
+  "error.vault_decrypt_failed.what": "لم أستطع فك تشفير مفتاح من Vault.",
+  "error.vault_decrypt_failed.why": "مفتاح master غير صحيح أو ملف Vault تالف. يمكن أن يحدث إذا نقلت config بين الأجهزة دون نقل master، أو بسبب disk error.",
+  "error.vault_decrypt_failed.fix": "اسحب نسخة الخادم (يعيد التشفير بـ master المحلي) إذا كان لديك server backup نشط.",
+  "error.vault_decrypt_failed.cmd": "yf keys setup --pull",
+  "error.shell_exec_rejected.what": "رفضت مودال R8 لـ yujin.shell.exec.",
+  "error.shell_exec_rejected.why": "تم تصنيف الأمر {command} على أنه {classification}. shell.exec يطلب الموافقة دائما للأمان، حتى لو كان الأمر read-only.",
+  "error.shell_exec_rejected.fix": "إذا كان الأمر read-only (yf projects active، git status، ls)، استخدم verb الأصلي المكافئ. إذا كان ضروريا ورفضته بالخطأ، استدعه مرة أخرى.",
+  "error.project_not_registered.what": "لا يوجد مشروع adopter مسجل.",
+  "error.project_not_registered.why": "يتطلب verb المستدعى project root نشط لكن ~/.yujin-forge/projects.json ليس به إدخالات.",
+  "error.project_not_registered.fix": "أنشئ واحدا بـ yujin.project.init أو سجل واحدا موجودا بـ yf projects add.",
+  "error.project_not_registered.cmd": "yf projects scan",
+  "panel.button.agents": "الوكلاء",
+  "panel.agents.title": "الوكلاء",
+  "panel.agents.subtitle": "المدير والوكلاء الفرعيون المسجلون في هذا المشروع",
+  "panel.agents.empty.title": "لا يوجد وكلاء بعد",
+  "panel.agents.empty.body": "قم بتشغيل `yf agent install --defaults` لتسجيل المدير ووكلائه الفرعيين الأربعة (المحلل، المبرمج، المختبر، المُجهز).",
+  "panel.agents.legend.eco": "اقتصادي",
+  "panel.agents.legend.managed": "مُدار",
+  "panel.agents.legend.frontier": "حدود",
+  "panel.agents.status.disabled": "وقت تشغيل الوكلاء غير مُشغّل",
+  "panel.agents.event.running": "قيد التشغيل",
+  "panel.agents.event.idle": "خامل",
+  "panel.agents.tick.live": "متصل",
+  "panel.agents.tick.lost": "الاتصال مفقود",
+  "workflow.phase.i": "الفرز والنية",
+  "workflow.phase.ii": "التوضيح (الوظيفي + 4 NFR + الكتل)",
+  "workflow.phase.iii": "المواصفات (RFP + المعمارية + التصميم + الموافقات)",
+  "workflow.phase.iv": "التهيئة",
+  "workflow.phase.v": "تطوير الكتل",
+  "workflow.phase.vi": "النشر + ما بعد الإطلاق",
+  "wizard.title": "مرحبا بك في Yujin Forge",
+  "wizard.close": "إغلاق",
+  "wizard.intro": "للبدء، اختر كيف يتصل Forge بنموذج الذكاء الاصطناعي. يمكنك تغيير ذلك لاحقا من Settings.",
+  "wizard.back": "رجوع",
+  "wizard.start": "ابدأ",
+  "wizard.plan.badge": "موصى به",
+  "wizard.plan.title": "خطة Claude",
+  "wizard.plan.desc": "اشتراك Claude الشهري. الخيار الأكثر اقتصاديا للاستخدام المستمر. Forge يستخدم جلسة claude -p الخاصة بك.",
+  "wizard.plan.price": "رسم شهري ثابت (الخطة)",
+  "wizard.plan.step.title": "وصل خطة Claude الخاصة بك",
+  "wizard.plan.step.1": "افتح موجه أوامر جديد.",
+  "wizard.plan.step.2": "نفذ الأمر claude (بدون وسائط) وأكمل تسجيل الدخول في المتصفح.",
+  "wizard.plan.step.3": "عد إلى هنا واضغط أنا مسجل الدخول للتحقق.",
+  "wizard.plan.done": "أنا مسجل الدخول",
+  "wizard.byok.title": "مفتاح API الخاص بك (BYOK)",
+  "wizard.byok.desc": "مفتاح Anthropic Console الخاص بك. دفع حسب الاستخدام. أكثر مرونة لكن التكلفة متغيرة.",
+  "wizard.byok.price": "دفع حسب الاستخدام (Console)",
+  "wizard.byok.step.title": "الصق مفتاح Anthropic API الخاص بك",
+  "wizard.byok.step.intro": "يبدأ مفتاحك بـ sk-ant- ويتم الحصول عليه من console.anthropic.com. يخزنه Forge مشفرا في Vault المحلي؛ لا يغادر جهازك أبدا.",
+  "wizard.byok.test": "تحقق واحفظ",
+  "wizard.skip.title": "أنا بالفعل معد",
+  "wizard.skip.desc": "تخطي المعالج. يمكنك إعادة فتحه من Settings لاحقا.",
+  "wizard.done.kanji": "تم",
+  "wizard.done.title": "تم",
+  "wizard.done.msg": "Forge جاهز. ابدأ الدردشة.",
+  "pizarron.button.read": "اقرأ بصوت",
+  "pizarron.button.copy": "نسخ",
+  "pizarron.button.edit": "تحرير",
+  "pizarron.graph.refresh": "تحديث",
+  "pizarron.graph.regenerating": "جارٍ إعادة التوليد...",
+  "pizarron.graph.detail.hint": "انقر على عقدة لعرض التفاصيل.",
+  "pizarron.graph.detail.empty": "لا توجد تفاصيل لهذه العقدة.",
+  "pizarron.graph.detail.weight": "الوزن",
+  "startup.tab.graph": "رسم بياني مرئي",
+  "startup.tab.graphSem": "الرسم الدلالي",
+  "startup.tab.pendings": "معلق",
+  "startup.tab.workflow": "سير العمل",
+  "settings.startupTabs": "علامات التبويب عند الفتح",
+  "graph.term.nodes": "عقد",
+  "graph.term.edges": "حواف",
+  "coding.read": "جارٍ قراءة {x}",
+  "coding.read_bare": "جارٍ قراءة ملف",
+  "coding.edit": "جارٍ تعديل {x}",
+  "coding.edit_bare": "جارٍ تعديل ملف",
+  "coding.write": "جارٍ كتابة {x}",
+  "coding.write_bare": "جارٍ كتابة ملف",
+  "coding.notebook_bare": "جارٍ تعديل الدفتر",
+  "coding.bash": "جارٍ التنفيذ: {x}",
+  "coding.bash_bare": "جارٍ تنفيذ أمر",
+  "coding.grep": "جارٍ البحث \"{x}\"",
+  "coding.grep_bare": "جارٍ البحث في الكود",
+  "coding.glob": "جارٍ سرد {x}",
+  "coding.glob_bare": "جارٍ سرد الملفات",
+  "coding.web_bare": "جارٍ قراءة الويب",
+  "coding.websearch": "بحث في الويب: {x}",
+  "coding.websearch_bare": "جارٍ البحث في الويب",
+  "coding.task": "وكيل فرعي: {x}",
+  "coding.task_bare": "جارٍ تشغيل وكيل فرعي",
+  "coding.todo": "جارٍ تحديث قائمة مهامه",
+  "coding.verb_bare": "جارٍ تنفيذ فعل yujin",
+  "panel.button.stop": "إيقاف",
+  "panel.status.stopping": "جارٍ الإيقاف...",
+  "panel.status.noActiveTurn": "لم تكن هناك جولة قيد التنفيذ.",
+  "panel.status.interruptFailed": "تعذّر إرسال المقاطعة.",
+  "panel.status.turnInterrupted": "تمت مقاطعة الجولة.",
+  "panel.label.interrupted": "(تمت المقاطعة)",
+  "panel.queue.label": "في الانتظار",
+  "panel.queue.remove": "إزالة من قائمة الانتظار",
+  "panel.project.switchHint": "تبديل المشروع",
+  "panel.project.title": "المشاريع",
+  "panel.project.add": "إضافة مشروع...",
+  "panel.project.addPrompt": "المسار المطلق للمشروع المراد إضافته:",
+  "panel.project.switching": "جارٍ تبديل المشروع..."
+}