@nac3/forge-cli 0.2.0-alpha.5 → 0.2.0-alpha.59z.119

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nac3/forge-cli",
-  "version": "0.2.0-alpha.5",
+  "version": "0.2.0-alpha.59z.119",
   "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>",
@@ -15,17 +15,6 @@
   "exports": {
     ".": "./dist/index.js"
   },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsx watch src/bin/yf.ts",
-    "typecheck": "tsc --noEmit",
-    "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"
-  },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.32.1",
     "@aws-sdk/client-ecs": "^3.1053.0",
@@ -43,6 +32,7 @@
     "@playwright/test": "^1.60.0",
     "@types/node": "22.10.2",
     "@types/prompts": "2.4.9",
+    "acorn": "^8.16.0",
     "pixelmatch": "^7.2.0",
     "pngjs": "^7.0.0",
     "tsx": "4.19.2",
@@ -52,11 +42,13 @@
     "node": ">=18.17",
     "pnpm": ">=9"
   },
-  "packageManager": "pnpm@11.3.0",
   "files": [
     "dist",
     "templates",
     "docs/manuals",
+    "docs/SQ.md",
+    "docs/SQ_BY_STEP.yaml",
+    "docs/doctrine",
     "src/i18n/catalogs",
     "README.md",
     "LICENSE"
@@ -90,5 +82,19 @@
   "publishConfig": {
     "access": "public",
     "tag": "alpha"
+  },
+  "scripts": {
+    "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",
+    "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"
   }
-}
+}

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,60 @@
   "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"
 }

package/src/i18n/catalogs/de.json

@@ -12,7 +12,6 @@
   "panel.button.maximise": "Vergroessern",
   "panel.button.close": "Schliessen",
   "panel.button.language": "Sprache",
-
   "panel.trace.title": "Aktionsprotokoll",
   "panel.trace.count.one": "{n} Werkzeugaufruf",
   "panel.trace.count.other": "{n} Werkzeugaufrufe",
@@ -21,10 +20,8 @@
   "panel.trace.badge.tool": "WERKZEUG",
   "panel.trace.badge.voice": "STIMME",
   "panel.trace.badge.error": "FEHLER",
-
   "panel.stream.empty.kanji": "侑仁",
   "panel.stream.empty.body": "Yujin Forge online. Bitte um Aenderungen am Projekt.",
-
   "panel.status.no_audio": "Kein Audio aufgenommen. Das Mikrofon hat vermutlich nichts erfasst.",
   "panel.status.did_not_catch": "Ich habe das nicht verstanden. Versuche es nochmal.",
   "panel.status.mic_denied": "Mikrofonberechtigung verweigert oder nicht verfuegbar: {error}",
@@ -34,10 +31,8 @@
   "panel.status.reading": "Lese {filename}...",
   "panel.status.ingest_failed": "Aufnahme fehlgeschlagen: {error}",
   "panel.status.read_failed": "Konnte die Spezifikation nicht lesen: {error}",
-
   "panel.drop.title": "Spezifikation hier ablegen",
   "panel.drop.hint": "PDF, DOCX, HTML, MD, RTF, EPUB, CSV, XLSX, TXT",
-
   "panel.ingest.spec_attached": "Spezifikation angehaengt: {filename}, {kb} KB",
   "panel.ingest.read_label": "Gelesen.",
   "panel.ingest.title_label": "Titel: {title}",
@@ -45,7 +40,6 @@
   "panel.ingest.format_label": "Format: {format} / {sections} Abschnitt(e) / {kb} KB",
   "panel.ingest.first_lines": "Erste Zeilen:",
   "panel.ingest.action_done": "Aktion {tool} abgeschlossen.",
-
   "vault.modal.title": "Zugangsdaten (Vault)",
   "vault.modal.aria.close": "Zugangsdaten-Modal schliessen",
   "vault.tab.list": "Geladene Slots",
@@ -60,7 +54,6 @@
   "vault.add.button_cancel": "Abbrechen",
   "vault.add.success": "Slot {slot} gespeichert.",
   "vault.add.overwrite": "Slot {slot} ueberschrieben.",
-
   "manual.intro": "Yujin Forge -- Benutzerhandbuch",
   "manual.section.welcome": "Willkommen",
   "manual.section.install": "Installation",
@@ -69,7 +62,6 @@
   "manual.section.spec_ingest": "Spezifikations-Ingestion",
   "manual.section.troubleshooting": "Fehlerbehebung",
   "manual.section.support": "Support",
-
   "lang.name.es": "Spanisch",
   "lang.name.en": "Englisch",
   "lang.name.pt": "Portugiesisch",
@@ -80,7 +72,60 @@
   "lang.name.ar": "Arabisch",
   "lang.name.de": "Deutsch",
   "lang.name.it": "Italienisch",
-
   "recap.fallback_period": ".",
-  "recap.empty": "Es gibt noch nichts zusammenzufassen."
+  "recap.empty": "Es gibt noch nichts zusammenzufassen.",
+  "error_ui.severity.info": "INFO",
+  "error_ui.severity.warning": "WARNUNG",
+  "error_ui.severity.error": "FEHLER",
+  "error_ui.severity.fatal": "FATAL",
+  "error_ui.label.what": "Was ist passiert",
+  "error_ui.label.why": "Warum",
+  "error_ui.label.fix": "Wie beheben",
+  "error_ui.label.cmd": "Befehl",
+  "error_ui.label.docs": "Lokale Docs",
+  "error_ui.label.retry": "Erneut versuchen in",
+  "error_ui.copy_btn": "Befehl kopieren",
+  "error_ui.unknown.what": "Forge hat einen internen Fehler gefunden (unbekannter Code).",
+  "error_ui.unknown.why": "Der Code {code} ist nicht im Katalog. Das ist ein Bug.",
+  "error_ui.unknown.fix": "Issue oeffnen auf https://github.com/yujinapp/yujin-forge/issues mit dem Code + Traceback.",
+  "error.cap_frontier_exhausted.what": "Monatliches Token-Cap des Frontier-Tier erschoepft (grosses Modell).",
+  "error.cap_frontier_exhausted.why": "Ihr Plan {plan} erlaubt bis zu {cap} Tokens/Monat auf Frontier. Sie haben {used} verwendet. Reset zum Anfang des naechsten UTC-Monats.",
+  "error.cap_frontier_exhausted.fix": "Wechseln Sie zu direktem Anthropic BYOK: umgeht das monatliche Worker-Cap. Ihre Kosten sind dann was Anthropic direkt berechnet.",
+  "error.cap_frontier_exhausted.cmd": "yf brain config --frontier-provider anthropic --frontier-model claude-opus-4-7",
+  "error.cap_eco_exhausted.what": "Monatliches Token-Cap des Eco-Tier erschoepft (kleines Modell).",
+  "error.cap_eco_exhausted.why": "Ihr Plan {plan} erlaubt bis zu {cap} Tokens/Monat auf Eco. Sie haben {used} verwendet. Reset zum Anfang des naechsten UTC-Monats.",
+  "error.cap_eco_exhausted.fix": "Wechseln Sie zu direktem BYOK oder upgraden Sie Ihren Plan. BYOK umgeht das Worker-Cap.",
+  "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 {tier} ist in Ihrem Plan nicht aktiviert.",
+  "error.tier_not_in_plan.why": "Ihr Plan {plan} enthaelt den {tier}-Tier nicht. Sie sind wahrscheinlich auf free-public oder Ihre Lizenz ist abgelaufen.",
+  "error.tier_not_in_plan.fix": "Aktivieren Sie eine bezahlte Lizenz oder wechseln Sie zu direktem BYOK (Ihre Kosten, ohne Worker-Cap).",
+  "error.tier_not_in_plan.cmd": "yf license activate --key <jwt>",
+  "error.response_truncated.what": "Die Modellantwort wurde vor dem Ende abgeschnitten.",
+  "error.response_truncated.why": "Limit managed_max_tokens_per_turn = {limit} Tokens mitten im Turn erreicht. Das Modell hat aufgehoert zu generieren.",
+  "error.response_truncated.fix": "Erhoehen Sie das Limit via yf limits. Gilt fuer den naechsten Turn ohne Chat-Neustart.",
+  "error.response_truncated.cmd": "yf limits set managed_max_tokens_per_turn 16384",
+  "error.response_truncated.banner": "[Antwort durch max_tokens={max} abgeschnitten. Limit erhoehen mit: yf limits set managed_max_tokens_per_turn {suggested}]",
+  "error.modal_trace_stale.what": "Das Approval-Modal ist abgelaufen oder verwaist.",
+  "error.modal_trace_stale.why": "Die trace_id {trace_id} hat keine pendente Approval im Dispatcher. Wahrscheinlich Race Condition zwischen Invoke und Panel-State, oder ein vorheriger Cancel hat den Trace als Zombie hinterlassen.",
+  "error.modal_trace_stale.fix": "Verb erneut aus dem Chat aufrufen: startet einen neuen sauberen Trace. Wenn es weiterhin passiert, fuehren Sie yf doctor aus, um das Panel zu pruefen.",
+  "error.modal_trace_stale.cmd": "yf doctor",
+  "error.byok_key_missing.what": "API-Key fuer Provider {provider} fehlt.",
+  "error.byok_key_missing.why": "Sie haben {provider} als Provider des {tier}-Tiers konfiguriert, aber der Slot byok_{slot} ist nicht im verschluesselten Vault.",
+  "error.byok_key_missing.fix": "Konfigurieren Sie den Key mit yf keys set (atomar, mode 0600, niemals geloggt).",
+  "error.byok_key_missing.cmd": "yf keys set {slot}",
+  "error.worker_unreachable.what": "Konnte den yujin.app-Worker nicht erreichen.",
+  "error.worker_unreachable.why": "Netzwerk-Timeout oder Worker ausgefallen (HTTP {status}). {attempts} mal wiederholt.",
+  "error.worker_unreachable.fix": "Pruefen Sie Ihr Internet. Falls OK, wechseln Sie temporaer zu direktem BYOK, um die Worker-Abhaengigkeit zu vermeiden.",
+  "error.worker_unreachable.cmd": "yf brain config --frontier-provider anthropic",
+  "error.vault_decrypt_failed.what": "Konnte einen Schluessel aus dem Vault nicht entschluesseln.",
+  "error.vault_decrypt_failed.why": "Der Master-Key ist falsch oder die Vault-Datei ist beschaedigt. Kann passieren, wenn Sie die Konfiguration zwischen Maschinen verschoben haben ohne den Master zu migrieren, oder durch Disk-Error.",
+  "error.vault_decrypt_failed.fix": "Holen Sie die Server-Kopie (verschluesselt mit Ihrem lokalen Master neu), falls Sie Server-Backup aktiv haben.",
+  "error.vault_decrypt_failed.cmd": "yf keys setup --pull",
+  "error.shell_exec_rejected.what": "Sie haben das R8-Modal von yujin.shell.exec abgelehnt.",
+  "error.shell_exec_rejected.why": "Der Befehl {command} wurde als {classification} klassifiziert. shell.exec verlangt immer Approval aus Sicherheit, auch wenn der Befehl read-only ist.",
+  "error.shell_exec_rejected.fix": "Wenn der Befehl read-only war (yf projects active, git status, ls), nutzen Sie das aequivalente native Verb. Wenn er notwendig war und Sie irrtuemlich abgelehnt haben, rufen Sie ihn erneut auf.",
+  "error.project_not_registered.what": "Kein Adopter-Projekt registriert.",
+  "error.project_not_registered.why": "Das aufgerufene Verb benoetigt einen aktiven Project-Root, aber ~/.yujin-forge/projects.json hat keine Eintraege.",
+  "error.project_not_registered.fix": "Erstellen Sie eines mit yujin.project.init oder registrieren Sie ein existierendes mit yf projects add.",
+  "error.project_not_registered.cmd": "yf projects scan"
 }

package/src/i18n/catalogs/en.json

@@ -82,5 +82,70 @@
   "lang.name.it": "Italian",
 
   "recap.fallback_period": ".",
-  "recap.empty": "There is nothing to recap yet."
+  "recap.empty": "There is nothing to recap yet.",
+
+  "error_ui.severity.info": "INFO",
+  "error_ui.severity.warning": "WARNING",
+  "error_ui.severity.error": "ERROR",
+  "error_ui.severity.fatal": "FATAL",
+  "error_ui.label.what": "What happened",
+  "error_ui.label.why": "Why",
+  "error_ui.label.fix": "How to fix",
+  "error_ui.label.cmd": "Command",
+  "error_ui.label.docs": "Local docs",
+  "error_ui.label.retry": "Retry in",
+  "error_ui.copy_btn": "Copy command",
+  "error_ui.unknown.what": "Forge encountered an internal error (unknown code).",
+  "error_ui.unknown.why": "The code {code} is not in the catalog. This is a bug.",
+  "error_ui.unknown.fix": "Open an issue at https://github.com/yujinapp/yujin-forge/issues with the code + the traceback.",
+
+  "error.cap_frontier_exhausted.what": "Monthly frontier tier token cap reached (large model).",
+  "error.cap_frontier_exhausted.why": "Your plan {plan} allows up to {cap} tokens/month on frontier. You used {used}. Resets at the start of the next UTC month.",
+  "error.cap_frontier_exhausted.fix": "Switch to direct Anthropic BYOK: bypasses the worker monthly cap. Your cost becomes whatever Anthropic charges directly.",
+  "error.cap_frontier_exhausted.cmd": "yf brain config --frontier-provider anthropic --frontier-model claude-opus-4-7",
+
+  "error.cap_eco_exhausted.what": "Monthly eco tier token cap reached (small model).",
+  "error.cap_eco_exhausted.why": "Your plan {plan} allows up to {cap} tokens/month on eco. You used {used}. Resets at the start of the next UTC month.",
+  "error.cap_eco_exhausted.fix": "Switch to direct BYOK or upgrade your plan. BYOK bypasses the worker cap.",
+  "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 {tier} is not enabled on your plan.",
+  "error.tier_not_in_plan.why": "Your plan {plan} does not include the {tier} tier. You are probably on free-public or your license expired.",
+  "error.tier_not_in_plan.fix": "Activate a paid license, or switch to direct BYOK (your cost, no worker cap).",
+  "error.tier_not_in_plan.cmd": "yf license activate --key <jwt>",
+
+  "error.response_truncated.what": "The model response was cut off before finishing.",
+  "error.response_truncated.why": "The managed_max_tokens_per_turn = {limit} tokens limit was reached mid-turn. The model stopped generating.",
+  "error.response_truncated.fix": "Raise the limit via yf limits. Applies to the next turn without restarting the chat.",
+  "error.response_truncated.cmd": "yf limits set managed_max_tokens_per_turn 16384",
+  "error.response_truncated.banner": "[Response truncated by max_tokens={max}. Raise the limit with: yf limits set managed_max_tokens_per_turn {suggested}]",
+
+  "error.modal_trace_stale.what": "The approval modal expired or is orphaned.",
+  "error.modal_trace_stale.why": "Trace_id {trace_id} has no pending approval in the dispatcher. Likely race condition between invoke and panel state, or a previous cancel left the trace zombie.",
+  "error.modal_trace_stale.fix": "Retry the verb from chat: starts a fresh trace. If it persists, run yf doctor to check the panel.",
+  "error.modal_trace_stale.cmd": "yf doctor",
+
+  "error.byok_key_missing.what": "Missing API key for provider {provider}.",
+  "error.byok_key_missing.why": "You configured {provider} as the {tier} tier provider but the byok_{slot} slot is not in the encrypted Vault.",
+  "error.byok_key_missing.fix": "Configure the key with yf keys set (atomic, mode 0600, never logged).",
+  "error.byok_key_missing.cmd": "yf keys set {slot}",
+
+  "error.worker_unreachable.what": "Could not reach the yujin.app worker.",
+  "error.worker_unreachable.why": "Network timeout or worker down (HTTP {status}). Retried {attempts} times.",
+  "error.worker_unreachable.fix": "Check your internet. If it is OK, switch temporarily to direct BYOK to avoid the worker dependency.",
+  "error.worker_unreachable.cmd": "yf brain config --frontier-provider anthropic",
+
+  "error.vault_decrypt_failed.what": "Could not decrypt a key from the Vault.",
+  "error.vault_decrypt_failed.why": "The master key is incorrect or the Vault file is corrupted. Can happen if you moved config between machines without migrating the master, or due to disk error.",
+  "error.vault_decrypt_failed.fix": "Pull the server copy (re-encrypts with your local master) if you have server backup active.",
+  "error.vault_decrypt_failed.cmd": "yf keys setup --pull",
+
+  "error.shell_exec_rejected.what": "You rejected the R8 modal for yujin.shell.exec.",
+  "error.shell_exec_rejected.why": "Command {command} was classified as {classification}. shell.exec always asks for approval for safety, even if the command is read-only.",
+  "error.shell_exec_rejected.fix": "If the command was read-only (yf projects active, git status, ls), use the equivalent native verb. If it was needed and you rejected by mistake, re-invoke.",
+
+  "error.project_not_registered.what": "No adopter project registered.",
+  "error.project_not_registered.why": "The verb you invoked needs an active project root but ~/.yujin-forge/projects.json has no entries.",
+  "error.project_not_registered.fix": "Create one with yujin.project.init or register an existing one with yf projects add.",
+  "error.project_not_registered.cmd": "yf projects scan"
 }

package/src/i18n/catalogs/es.json

@@ -82,5 +82,70 @@
   "lang.name.it": "Italiano",
 
   "recap.fallback_period": ".",
-  "recap.empty": "No hay nada que recordar todavia."
+  "recap.empty": "No hay nada que recordar todavia.",
+
+  "error_ui.severity.info": "INFO",
+  "error_ui.severity.warning": "ATENCION",
+  "error_ui.severity.error": "ERROR",
+  "error_ui.severity.fatal": "FATAL",
+  "error_ui.label.what": "Que paso",
+  "error_ui.label.why": "Por que",
+  "error_ui.label.fix": "Como destrabar",
+  "error_ui.label.cmd": "Comando",
+  "error_ui.label.docs": "Docs locales",
+  "error_ui.label.retry": "Reintentar en",
+  "error_ui.copy_btn": "Copiar comando",
+  "error_ui.unknown.what": "Forge encontro un error interno (codigo desconocido).",
+  "error_ui.unknown.why": "El codigo {code} no esta en el catalogo. Es un bug.",
+  "error_ui.unknown.fix": "Abri un issue en https://github.com/yujinapp/yujin-forge/issues con el codigo + traceback.",
+
+  "error.cap_frontier_exhausted.what": "Se agoto el cap mensual de tokens del tier frontier (modelo grande).",
+  "error.cap_frontier_exhausted.why": "Tu plan {plan} permite hasta {cap} tokens/mes en frontier. Usaste {used}. Resetea al inicio del proximo mes UTC.",
+  "error.cap_frontier_exhausted.fix": "Pasa a BYOK Anthropic directo: bypassea el cap mensual del worker. Tu costo pasa a ser lo que cobra Anthropic.",
+  "error.cap_frontier_exhausted.cmd": "yf brain config --frontier-provider anthropic --frontier-model claude-opus-4-7",
+
+  "error.cap_eco_exhausted.what": "Se agoto el cap mensual de tokens del tier eco (modelo chico).",
+  "error.cap_eco_exhausted.why": "Tu plan {plan} permite hasta {cap} tokens/mes en eco. Usaste {used}. Resetea al inicio del proximo mes UTC.",
+  "error.cap_eco_exhausted.fix": "Pasa a BYOK directo o sube de plan. BYOK bypassea el cap del 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": "El tier {tier} no esta habilitado en tu plan.",
+  "error.tier_not_in_plan.why": "Tu plan {plan} no incluye el tier {tier}. Probablemente sos free-public o tu license expiro.",
+  "error.tier_not_in_plan.fix": "Activa una licencia paga o pasa a BYOK directo (tu costo, sin cap del worker).",
+  "error.tier_not_in_plan.cmd": "yf license activate --key <jwt>",
+
+  "error.response_truncated.what": "La respuesta del modelo se corto antes de terminar.",
+  "error.response_truncated.why": "Limite managed_max_tokens_per_turn = {limit} tokens alcanzado a mitad del turno. El modelo paro de generar.",
+  "error.response_truncated.fix": "Subi el limite via yf limits. Aplica al proximo turno sin reiniciar el chat.",
+  "error.response_truncated.cmd": "yf limits set managed_max_tokens_per_turn 16384",
+  "error.response_truncated.banner": "[Respuesta truncada por max_tokens={max}. Subi el limite con: yf limits set managed_max_tokens_per_turn {suggested}]",
+
+  "error.modal_trace_stale.what": "El modal de aprobacion expiro o quedo huerfano.",
+  "error.modal_trace_stale.why": "El trace_id {trace_id} no tiene approval pendiente en el dispatcher. Probable race condition entre invoke y panel state, o cancel previo dejo el trace zombie.",
+  "error.modal_trace_stale.fix": "Reintenta el verbo desde el chat: arranca un nuevo trace limpio. Si persiste, corre yf doctor para chequear el panel.",
+  "error.modal_trace_stale.cmd": "yf doctor",
+
+  "error.byok_key_missing.what": "Falta la API key para el provider {provider}.",
+  "error.byok_key_missing.why": "Configuraste {provider} como provider del tier {tier} pero el slot byok_{slot} no esta en el Vault encriptado.",
+  "error.byok_key_missing.fix": "Configura la key con yf keys set (atomico, mode 0600, nunca se logguea).",
+  "error.byok_key_missing.cmd": "yf keys set {slot}",
+
+  "error.worker_unreachable.what": "No pude alcanzar el worker yujin.app.",
+  "error.worker_unreachable.why": "Network timeout o worker caido (HTTP {status}). Reintente {attempts} veces.",
+  "error.worker_unreachable.fix": "Chequea tu internet. Si esta OK, pasa temporalmente a BYOK directo para no depender del worker.",
+  "error.worker_unreachable.cmd": "yf brain config --frontier-provider anthropic",
+
+  "error.vault_decrypt_failed.what": "No pude desencriptar una clave del Vault.",
+  "error.vault_decrypt_failed.why": "La master key es incorrecta o el archivo del Vault esta corrupto. Puede pasar si moviste config entre maquinas sin migrar la master o por disk error.",
+  "error.vault_decrypt_failed.fix": "Traete la copia del server (re-encripta con tu master local) si tenes server backup activo.",
+  "error.vault_decrypt_failed.cmd": "yf keys setup --pull",
+
+  "error.shell_exec_rejected.what": "Rechazaste el modal R8 de yujin.shell.exec.",
+  "error.shell_exec_rejected.why": "El comando {command} se clasifico como {classification}. shell.exec siempre pide aprobacion por seguridad, aunque sea read-only.",
+  "error.shell_exec_rejected.fix": "Si el comando era read-only (yf projects active, git status, ls), usa el verb nativo equivalente. Si era necesario y lo rechazaste por error, reinvoca.",
+
+  "error.project_not_registered.what": "No hay proyecto adopter registrado.",
+  "error.project_not_registered.why": "El verb que invocaste requiere project root activo pero ~/.yujin-forge/projects.json no tiene entradas.",
+  "error.project_not_registered.fix": "Crea uno con yujin.project.init o registra uno existente con yf projects add.",
+  "error.project_not_registered.cmd": "yf projects scan"
 }

package/src/i18n/catalogs/fr.json

@@ -12,7 +12,6 @@
   "panel.button.maximise": "Agrandir",
   "panel.button.close": "Fermer",
   "panel.button.language": "Langue",
-
   "panel.trace.title": "Trace des actions",
   "panel.trace.count.one": "{n} appel d'outil",
   "panel.trace.count.other": "{n} appels d'outils",
@@ -21,10 +20,8 @@
   "panel.trace.badge.tool": "OUTIL",
   "panel.trace.badge.voice": "VOIX",
   "panel.trace.badge.error": "ERREUR",
-
   "panel.stream.empty.kanji": "侑仁",
   "panel.stream.empty.body": "Yujin Forge en ligne. Demande des changements au projet.",
-
   "panel.status.no_audio": "Aucun audio capture. Le micro n'a probablement rien recu.",
   "panel.status.did_not_catch": "Je n'ai pas compris. Essayons a nouveau.",
   "panel.status.mic_denied": "Permission micro refusee ou indisponible : {error}",
@@ -34,10 +31,8 @@
   "panel.status.reading": "Lecture de {filename}...",
   "panel.status.ingest_failed": "L'ingestion a echoue : {error}",
   "panel.status.read_failed": "Impossible de lire la specification : {error}",
-
   "panel.drop.title": "Depose la specification ici",
   "panel.drop.hint": "PDF, DOCX, HTML, MD, RTF, EPUB, CSV, XLSX, TXT",
-
   "panel.ingest.spec_attached": "Specification jointe : {filename}, {kb} KB",
   "panel.ingest.read_label": "Lue.",
   "panel.ingest.title_label": "Titre : {title}",
@@ -45,7 +40,6 @@
   "panel.ingest.format_label": "Format : {format} / {sections} section(s) / {kb} KB",
   "panel.ingest.first_lines": "Premieres lignes :",
   "panel.ingest.action_done": "Action {tool} terminee.",
-
   "vault.modal.title": "Identifiants (vault)",
   "vault.modal.aria.close": "Fermer la modale des identifiants",
   "vault.tab.list": "Slots charges",
@@ -60,7 +54,6 @@
   "vault.add.button_cancel": "Annuler",
   "vault.add.success": "Slot {slot} enregistre.",
   "vault.add.overwrite": "Slot {slot} ecrase.",
-
   "manual.intro": "Yujin Forge -- manuel utilisateur",
   "manual.section.welcome": "Bienvenue",
   "manual.section.install": "Installation",
@@ -69,7 +62,6 @@
   "manual.section.spec_ingest": "Ingestion de specifications",
   "manual.section.troubleshooting": "Depannage",
   "manual.section.support": "Support",
-
   "lang.name.es": "Espagnol",
   "lang.name.en": "Anglais",
   "lang.name.pt": "Portugais",
@@ -80,7 +72,60 @@
   "lang.name.ar": "Arabe",
   "lang.name.de": "Allemand",
   "lang.name.it": "Italien",
-
   "recap.fallback_period": ".",
-  "recap.empty": "Il n'y a rien a resumer pour l'instant."
+  "recap.empty": "Il n'y a rien a resumer pour l'instant.",
+  "error_ui.severity.info": "INFO",
+  "error_ui.severity.warning": "ATTENTION",
+  "error_ui.severity.error": "ERREUR",
+  "error_ui.severity.fatal": "FATAL",
+  "error_ui.label.what": "Que s'est-il passe",
+  "error_ui.label.why": "Pourquoi",
+  "error_ui.label.fix": "Comment debloquer",
+  "error_ui.label.cmd": "Commande",
+  "error_ui.label.docs": "Docs locales",
+  "error_ui.label.retry": "Reessayer dans",
+  "error_ui.copy_btn": "Copier la commande",
+  "error_ui.unknown.what": "Forge a rencontre une erreur interne (code inconnu).",
+  "error_ui.unknown.why": "Le code {code} n'est pas dans le catalogue. C'est un bug.",
+  "error_ui.unknown.fix": "Ouvrez un issue sur https://github.com/yujinapp/yujin-forge/issues avec le code + le traceback.",
+  "error.cap_frontier_exhausted.what": "Cap mensuel de tokens du tier frontier epuise (gros modele).",
+  "error.cap_frontier_exhausted.why": "Votre plan {plan} permet jusqu'a {cap} tokens/mois en frontier. Vous avez utilise {used}. Reset au debut du prochain mois UTC.",
+  "error.cap_frontier_exhausted.fix": "Passez au BYOK Anthropic direct: ignore le cap mensuel du worker. Votre cout devient ce qu'Anthropic facture.",
+  "error.cap_frontier_exhausted.cmd": "yf brain config --frontier-provider anthropic --frontier-model claude-opus-4-7",
+  "error.cap_eco_exhausted.what": "Cap mensuel de tokens du tier eco epuise (petit modele).",
+  "error.cap_eco_exhausted.why": "Votre plan {plan} permet jusqu'a {cap} tokens/mois en eco. Vous avez utilise {used}. Reset au debut du prochain mois UTC.",
+  "error.cap_eco_exhausted.fix": "Passez au BYOK direct ou montez de plan. BYOK ignore le cap du 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": "Le tier {tier} n'est pas active sur votre plan.",
+  "error.tier_not_in_plan.why": "Votre plan {plan} n'inclut pas le tier {tier}. Vous etes probablement en free-public ou votre licence a expire.",
+  "error.tier_not_in_plan.fix": "Activez une licence payante ou passez au BYOK direct (votre cout, sans cap du worker).",
+  "error.tier_not_in_plan.cmd": "yf license activate --key <jwt>",
+  "error.response_truncated.what": "La reponse du modele a ete coupee avant la fin.",
+  "error.response_truncated.why": "Limite managed_max_tokens_per_turn = {limit} tokens atteinte en plein turn. Le modele a arrete de generer.",
+  "error.response_truncated.fix": "Augmentez la limite via yf limits. S'applique au prochain turn sans redemarrer le chat.",
+  "error.response_truncated.cmd": "yf limits set managed_max_tokens_per_turn 16384",
+  "error.response_truncated.banner": "[Reponse tronquee par max_tokens={max}. Augmentez la limite avec: yf limits set managed_max_tokens_per_turn {suggested}]",
+  "error.modal_trace_stale.what": "Le modal d'approbation a expire ou est orphelin.",
+  "error.modal_trace_stale.why": "Le trace_id {trace_id} n'a pas d'approval en attente dans le dispatcher. Probable race condition entre invoke et etat du panel, ou cancel precedent a laisse le trace zombie.",
+  "error.modal_trace_stale.fix": "Reinvoquez le verb depuis le chat: demarre un nouveau trace propre. Si ca persiste, lancez yf doctor pour verifier le panel.",
+  "error.modal_trace_stale.cmd": "yf doctor",
+  "error.byok_key_missing.what": "API key manquante pour le provider {provider}.",
+  "error.byok_key_missing.why": "Vous avez configure {provider} comme provider du tier {tier} mais le slot byok_{slot} n'est pas dans le Vault chiffre.",
+  "error.byok_key_missing.fix": "Configurez la key avec yf keys set (atomique, mode 0600, jamais journalise).",
+  "error.byok_key_missing.cmd": "yf keys set {slot}",
+  "error.worker_unreachable.what": "Impossible d'atteindre le worker yujin.app.",
+  "error.worker_unreachable.why": "Timeout reseau ou worker en panne (HTTP {status}). Reessaye {attempts} fois.",
+  "error.worker_unreachable.fix": "Verifiez votre internet. Si OK, passez temporairement au BYOK direct pour eviter la dependance au worker.",
+  "error.worker_unreachable.cmd": "yf brain config --frontier-provider anthropic",
+  "error.vault_decrypt_failed.what": "Impossible de dechiffrer une cle du Vault.",
+  "error.vault_decrypt_failed.why": "La master key est incorrecte ou le fichier du Vault est corrompu. Peut arriver si vous avez deplace la config entre machines sans migrer la master ou par disk error.",
+  "error.vault_decrypt_failed.fix": "Recuperez la copie du serveur (rechiffre avec votre master locale) si vous avez le server backup actif.",
+  "error.vault_decrypt_failed.cmd": "yf keys setup --pull",
+  "error.shell_exec_rejected.what": "Vous avez rejete le modal R8 de yujin.shell.exec.",
+  "error.shell_exec_rejected.why": "La commande {command} a ete classee comme {classification}. shell.exec demande toujours approbation par securite, meme si la commande est read-only.",
+  "error.shell_exec_rejected.fix": "Si la commande etait read-only (yf projects active, git status, ls), utilisez le verb natif equivalent. Si elle etait necessaire et vous avez rejete par erreur, reinvoquez.",
+  "error.project_not_registered.what": "Aucun projet adopter enregistre.",
+  "error.project_not_registered.why": "Le verb invoque necessite un project root actif mais ~/.yujin-forge/projects.json n'a pas d'entrees.",
+  "error.project_not_registered.fix": "Creez-en un avec yujin.project.init ou enregistrez un existant avec yf projects add.",
+  "error.project_not_registered.cmd": "yf projects scan"
 }