@nac3/forge-cli 0.2.0-alpha.9 → 0.2.1-alpha.60

package/docs/doctrine/workflow-phases.md

@@ -0,0 +1,108 @@
+# Workflow phases -- full reference
+
+Fetch when the user asks: "que pasa en la fase X?", "como salgo
+de clarificacion?", "que necesito para arrancar build?",
+"cuales son los specs?".
+
+The Forge build workflow has 6 phases. Each phase has a
+distinctive intent + an exit condition. The cost router uses
+the current phase to pick eco / frontier per turn, and several
+SQ rules pre-empt phase transitions.
+
+## Phase I -- Intake
+
+**Intent:** capture the raw user request + flag whether the
+project already exists.
+**Steps:** triage (auto), tier election (user picks
+starter/standard/advanced/enterprise), workspace bootstrap.
+**Eco-friendly:** yes. Default tier. Cheap.
+**Exit:** tier locked + workspace ready.
+**Gates:** G1 (tier required), G2 (vault has >= 2 BYOK keys).
+
+## Phase II -- Clarification
+
+**Intent:** narrow the request into something a spec can be
+written against. Disambiguation rounds with the user.
+**Steps:** clarifying-questions iterations (`iterations[]`
+schema, see lessons-workflow doctrine for capture model).
+**Eco-friendly:** yes. Default eco; escalate to frontier on
+SQ rule-violation text.
+**Exit:** user signs off the clarification summary.
+**Gates:** none.
+
+## Phase III -- Specification
+
+**Intent:** produce the three core specs: RFP, ARCH, DESIGN.
+**Steps:** spec-extract (auto), spec-plan (auto), spec-validate
+(auto + user approval).
+**Eco-friendly:** mixed -- text-generation pieces escalate to
+frontier; tooling steps stay eco.
+**Exit:** each spec has `done_at` + `approved_at` non-empty in
+workflow_state.specs.
+**Gates:** G3 (no phase-skip), G-DOC (each step ends with a
+commit ASCII-only).
+
+## Phase IV -- Approval
+
+**Intent:** human sign-off on the spec set + block plan.
+**Steps:** review board (async), block-plan, ship-target
+selection.
+**Eco-friendly:** no -- approvals always frontier so the brain
+catches edge cases.
+**Exit:** all `approvals.*.approved_at` non-empty + block_plan
+exists.
+**Gates:** G4 (block-plan OK), G5 (fase V sin OK explicito de
+los 3 spec docs).
+
+## Phase V -- Build
+
+**Intent:** execute the block plan. Code + tests + integrations.
+**Steps:** per-block dev iterations, smoke tests, integration
+gates.
+**Eco-friendly:** no by default; frontier for the meat of the
+work, eco for status queries.
+**Exit:** every block in block_plan has status='done' +
+smoke tests green.
+**Gates:** G6 (block tests rojos = bloqueo), G7 (creds
+faltantes = bloqueo).
+
+## Phase VI -- Ship
+
+**Intent:** deploy + post-launch monitoring.
+**Steps:** ship-target deploy, smoke test prod, launch
+announcement (when asked).
+**Eco-friendly:** mixed.
+**Exit:** smoke-prod green + announcement composed.
+**Gates:** G8 (launch sin smoke verde).
+
+## What the brain MUST do per phase
+
+1. **Read workflow_state from the injected block** -- never
+   re-fetch via yujin.workflow.state for fields already
+   present.
+2. **Acknowledge the current phase/step** before proposing
+   any action that touches it.
+3. **Refuse phase skips > 1 forward** -- G3 hard rule.
+4. **Cite the gate** when refusing -- "no puedo avanzar
+   porque G2-vault-min-keys exige 2 keys, tenes 1".
+5. **Suggest the cheap fix** -- always offer the user the
+   shortest path to clear a gate (e.g. `yf keys setup`).
+
+## How to read iterations[]
+
+When `workflow_state.iterations[]` is non-empty, the brain
+MUST acknowledge the prior iterations (slug + summary) before
+proposing a new one. Stale-iteration replies are a known
+failure mode caught by the
+`iterations_query_history` scenario.
+
+## Forbidden during a phase
+
+- Phase I-III: NEVER write production code. Specs only.
+- Phase IV: NEVER mutate specs that already have
+  approved_at -- propose a new iteration with a different
+  slug.
+- Phase V: NEVER bypass smoke tests. If they fail, the
+  brain MUST surface the failure, not paper it over.
+- Phase VI: NEVER announce a launch before smoke-prod is
+  green.

package/docs/doctrine/workflow.md

@@ -0,0 +1,58 @@
+# Workflow doctrine -- 6 phases / 18 steps
+
+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.
+
+PHASE I -- INTAKE (steps 1-3.5)
+  1.   Complexity triage           Simple / Medium / Full tier
+  2.   Vault keys validation       13 credential families, BYOK
+  3.   Discover intent             migrate / new / modify; desktop / mobile /
+                                   both; chat / voice / document-paste
+  3.5  Audit existing artifacts    if migrating legacy
+
+PHASE II -- CLARIFICATION (steps 4-9)
+  4.   Functional                  user stories, MVP, personas
+  5.   NFR quantitative            volumetry, parallelism, process complexity
+  6.   NFR structural              persistence, middleware, object lifecycle,
+                                   workers
+  7.   NFR governance              compliance (GDPR/HIPAA/PCI/SOC2), audit,
+                                   retention, RBAC, DR
+  8.   NFR operational             i18n, a11y, cost budget, monitoring, SLA
+  9.   Block prioritisation        decompose + dep graph + MVP
+
+PHASE III -- SPECIFICATION (steps 10-12)
+  10.  RFP / PRD                   consolidates Phase I + II
+  11.  Architecture doc            stack + layering + async + topology +
+                                   observability + security, driven by NFRs
+  12.  Solution Design             per-block: data model, APIs, screens,
+                                   state machines
+
+PHASE IV -- APPROVAL GATE (step 13)
+  13.  Explicit OK on the 3 docs   You REFUSE to advance to Phase V without
+                                   explicit "si" on RFP + architecture +
+                                   design.
+
+PHASE V -- BUILD ITERATIVE (steps 14-15)
+  14.  Bootstrap                   NAC-3 baseline + CI gates + test
+                                   scaffolding all layers + observability
+  15.  Iterative cycle per block   implement -> e2e tests with 100%
+                                   structural coverage -> a11y check ->
+                                   green-gate before next block
+
+PHASE VI -- SHIP & OPERATE (steps 16-18)
+  16.  Deploy automation + execute creds + pipeline + secrets + monitoring +
+                                   smoke + rollback
+  17.  Post-launch                 user manual auto-gen, dashboards,
+                                   feedback collect
+  18.  Iteration re-entry          route new requirements back to the right
+                                   phase, keep docs in sync
+
+CROSS-CUTTING: documentation sync, cost tracking, translation of
+user-facing artifacts, versioning + changelog, handoff, backup + DR.
+
+COMPLEXITY TIER MAPPING:
+  Simple  = landing / blog / demo POC                 -> steps 1-3, 9, 14-16
+  Medium  = CRUD app with auth, low-traffic SaaS      -> + 4-7, 10-13
+  Full    = regulated SaaS, multi-tenant, workflows   -> ALL 18 steps + hard
+                                                       gates

package/docs/doctrine/yf-commands.md

@@ -0,0 +1,49 @@
+# yf CLI command catalog
+
+When the user asks "how do I X?", recommend the matching `yf X`
+command (it teaches them the surface). When the user wants the
+result right now ("install Stripe webhook for me"), invoke the
+relevant NAC3 verb directly instead.
+
+PROJECT LIFECYCLE
+  yf new <slug>                  scaffold a new NAC-3 React project
+  yf migrate <repo> --audit      scan existing project for NAC-3 readiness
+  yf migrate <repo> --apply      execute the AST migration (paid seat)
+  yf ship                        deploy gate: validate + license + tests + build
+
+DEV LOOP
+  yf chat                        this panel (you are inside it)
+  yf doctor                      verify environment + license + deps
+  yf gen-tests <dir>             emit e2e tests from manifest
+  yf scenarios:emit              emit Playwright + Maestro from yaml scenarios
+  yf review-screens              visual regression review UI
+  yf review-status               CI gate: 0 iff every screenshot is OK
+
+CONFIG + LICENSE
+  yf keys setup                  interactive BYOK (brain + voice)
+  yf vault                       manage encrypted credentials
+  yf license activate --user-handle <email>   bind to Polar subscription
+  yf license status / cancel / resubscribe    subscription ops
+  yf voice                       voice + wake-word config
+
+SHIP + DEPLOY
+  yf publish --npm               npm publish using vaulted token
+  yf publish --docker            docker push using vaulted token
+  yf deploy                      cloud deploy (AWS built-in, others chat-guided)
+  yf repo                        init repo + GitHub remote pairing
+
+OBSERVABILITY
+  yf log                         per-scope log levels + redaction (SQ.K)
+  yf projects                    cross-device project registry
+
+QA HARNESSES
+  yf qa brain-matrix             E2E test invariants against LLM brains
+  yf graph                       semantic graph CRUD (alpha.59p)
+  yf mcp                         MCP bridge config (alpha.60 stubs)
+  yf limits                      runtime caps (max tool rounds, timeouts)
+
+INTROSPECTION (z.67)
+  yf doctrine list               list available doctrines (md files)
+  yf doctrine show <slug>        print one doctrine
+  yf manifest verbs              enumerate NAC-3 verbs + policies
+  yf manifest verbs --ns office. filter by namespace prefix

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nac3/forge-cli",
-  "version": "0.2.0-alpha.9",
+  "version": "0.2.1-alpha.60",
   "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,19 +16,28 @@
     ".": "./dist/index.js"
   },
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && node scripts/copy_qa_assets.mjs",
     "dev": "tsx watch src/bin/yf.ts",
     "typecheck": "tsc --noEmit",
+    "typecheck:all": "pnpm typecheck && pnpm --filter @yujin/hito4-server typecheck && pnpm --filter @yujin/forge-mobile typecheck",
     "test": "vitest run",
     "test:watch": "vitest",
     "lint": "tsc --noEmit",
     "yf": "tsx src/bin/yf.ts",
     "catalog:lint": "node scripts/catalog_lint.mjs",
-    "prepublishOnly": "pnpm run build && pnpm run typecheck && pnpm run catalog:lint && pnpm run test"
+    "pairing:check": "node scripts/check_pairing_sync.mjs",
+    "brain-matrix:gate": "node scripts/brain_matrix_gate.mjs",
+    "hito4:lint": "node scripts/hito4_lint_bundle.mjs",
+    "publish-alpha-emergency": "node scripts/publish_alpha_emergency.mjs",
+    "prepublishOnly": "pnpm run build && pnpm run typecheck && pnpm run catalog:lint && pnpm run test && pnpm run brain-matrix:gate && pnpm run hito4:lint"
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.32.1",
     "@aws-sdk/client-ecs": "^3.1053.0",
+    "@noble/ciphers": "^2.2.0",
+    "@noble/hashes": "^2.2.0",
+    "@scure/base": "^2.2.0",
+    "better-sqlite3": "^12.10.0",
     "commander": "12.1.0",
     "dotenv": "^17.4.2",
     "kleur": "4.1.5",
@@ -36,13 +45,17 @@
     "node-html-parser": "6.1.13",
     "pdfjs-dist": "^4.10.38",
     "prompts": "2.4.2",
+    "qrcode": "^1.5.4",
     "typescript": "5.7.2",
     "xlsx": "https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz"
   },
   "devDependencies": {
     "@playwright/test": "^1.60.0",
+    "@types/better-sqlite3": "^7.6.13",
     "@types/node": "22.10.2",
     "@types/prompts": "2.4.9",
+    "@types/qrcode": "^1.5.6",
+    "acorn": "^8.16.0",
     "pixelmatch": "^7.2.0",
     "pngjs": "^7.0.0",
     "tsx": "4.19.2",
@@ -57,6 +70,9 @@
     "dist",
     "templates",
     "docs/manuals",
+    "docs/SQ.md",
+    "docs/SQ_BY_STEP.yaml",
+    "docs/doctrine",
     "src/i18n/catalogs",
     "README.md",
     "LICENSE"

package/src/i18n/catalogs/ar.json

@@ -12,7 +12,6 @@
   "panel.button.maximise": "تكبير",
   "panel.button.close": "إغلاق",
   "panel.button.language": "اللغة",
-
   "panel.trace.title": "سجل الإجراءات",
   "panel.trace.count.one": "{n} استدعاء أداة",
   "panel.trace.count.other": "{n} استدعاءات أدوات",
@@ -21,10 +20,8 @@
   "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}",
@@ -34,10 +31,8 @@
   "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}",
@@ -45,7 +40,6 @@
   "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": "الخانات المحملة",
@@ -60,7 +54,6 @@
   "vault.add.button_cancel": "إلغاء",
   "vault.add.success": "تم حفظ الخانة {slot}.",
   "vault.add.overwrite": "تم استبدال الخانة {slot}.",
-
   "manual.intro": "Yujin Forge -- دليل المستخدم",
   "manual.section.welcome": "مرحباً",
   "manual.section.install": "التثبيت",
@@ -69,7 +62,6 @@
   "manual.section.spec_ingest": "استيعاب المواصفات",
   "manual.section.troubleshooting": "حل المشكلات",
   "manual.section.support": "الدعم",
-
   "lang.name.es": "الإسبانية",
   "lang.name.en": "الإنجليزية",
   "lang.name.pt": "البرتغالية",
@@ -80,7 +72,139 @@
   "lang.name.ar": "العربية",
   "lang.name.de": "الألمانية",
   "lang.name.it": "الإيطالية",
-
   "recap.fallback_period": ".",
-  "recap.empty": "لا يوجد ما يمكن تلخيصه بعد."
+  "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"
 }