@nac3/forge-cli 1.23.4 → 1.23.5

package/docs/doctrine/urazuke.md

@@ -1,38 +1,50 @@
-# Urazuke -- the evidence method, as Forge runs it
-
-Urazuke (github.com/pkuschnirof/urazuke) is the method behind every project
-Forge builds or maintains: 24 ordered steps in four stretches, each with an
-exact prompt, the inputs the owner prepares, the artifacts the agent leaves
-in the repository, and a completion check the owner does WITHOUT reading
-code. An existing system built without it goes through eight normalisation
-stations (N0..N7) first and enters the loop at step 5.
-
-## What is mechanical (not prose)
-
-- The project's workflow is `urazuke` (no code) or `urazuke-legacy` (code
-  without the method's artifacts). Every canonical task carries its step.
-- The CURRENT step's prompt is injected into your system prompt every turn,
-  with the state of its checks (section "URAZUKE -- peldano NN"). Act on
-  that prompt as if the owner had pasted it. Do not skip ahead.
-- A canonical task closes ONLY when `evaluateStep()` is GREEN: the files
-  the step names exist, are not stubs, say what they must; the sizing
-  record is admissible (G9); the plan items carry a spec; the evidence
-  receipts exist. `yujin.pending.close` refuses a red step. An override
-  needs the OWNER's written `force_reason` (kept in history); never pass
-  one on your own initiative.
-- Evidence is a RECEIPT Forge records (command, ref, exit code, counts),
-  never your summary. "Tests pass" without a receipt is a claim.
-
-## How to work inside it
-
-1. Read the URAZUKE section: red checks are what is missing. Produce the
-   artifact at the path named, with real content, or ask the owner for the
-   input that is theirs (`antes de enviar`). Never invent an owner input.
-2. When the section says GREEN, close the task with `yujin.pending.close`
-   (full expediente) and the next step's prompt arrives on the next turn.
-3. `yujin.urazuke.status` shows the whole ladder; `yujin.urazuke.step`
-   shows any step in full (prompts, inputs, artifacts, checklist).
-4. The plan is the pendings: each item needs `spec` (acceptance "given /
-   when / then" + `how_verified`) before it is implemented (step 5).
-5. No deadlines, ever: the method fixes the order and the gates, not the
-   calendar. Speed is a consequence, not the objective.
+# Urazuke -- the evidence method, as Forge runs it
+
+Urazuke (github.com/pkuschnirof/urazuke) is the method behind every project
+Forge builds or maintains: 24 ordered steps in four stretches, each with an
+exact prompt, the inputs the owner prepares, the artifacts the agent leaves
+in the repository, and a completion check the owner does WITHOUT reading
+code. An existing system built without it goes through eight normalisation
+stations (N0..N7) first and enters the loop at step 5.
+
+## What is mechanical (not prose)
+
+- The project's workflow is `urazuke` (no code) or `urazuke-legacy` (code
+  without the method's artifacts). Every canonical task carries its step.
+- The CURRENT step's prompt is injected into your system prompt every turn,
+  with the state of its checks (section "URAZUKE -- peldano NN"). Act on
+  that prompt as if the owner had pasted it. Do not skip ahead.
+- A canonical task closes ONLY when `evaluateStep()` is GREEN: the files
+  the step names exist, are not stubs, say what they must; the sizing
+  record is admissible (G9); the plan items carry a spec; the evidence
+  receipts exist. `yujin.pending.close` refuses a red step. An override
+  needs the OWNER's written `force_reason` (kept in history); never pass
+  one on your own initiative.
+- Evidence is a RECEIPT Forge records (command, ref, exit code, counts),
+  never your summary. "Tests pass" without a receipt is a claim.
+- A LONG run leaves its receipt the same way. `yujin.evidence.run` blocks
+  the turn only while the run fits the blocking window (10 min, lowered with
+  `limits.claude_cli_silence_ms`); over that, or with `background: true`, it
+  is launched detached and returns a HANDLE. That is not a degraded mode:
+  the receipt is written by whoever runs, not by whoever waits. Read it with
+  `yujin.evidence.list` when the task finishes (`yujin.task.status({id})`
+  for the progress). Do NOT relaunch a run that already has a handle.
+- And the corollary for any invocation that dies waiting: a verb call that
+  comes back UNANSWERED (E_VERB_CALL_UNANSWERED) did not necessarily fail.
+  Before redoing the work, LOOK FOR THE TRACE -- `yujin.evidence.list` for a
+  receipt, `yujin.task.list` for a task. Two closes were reported as
+  "believed" over a receipt that existed on disk the whole time.
+
+## How to work inside it
+
+1. Read the URAZUKE section: red checks are what is missing. Produce the
+   artifact at the path named, with real content, or ask the owner for the
+   input that is theirs (`antes de enviar`). Never invent an owner input.
+2. When the section says GREEN, close the task with `yujin.pending.close`
+   (full expediente) and the next step's prompt arrives on the next turn.
+3. `yujin.urazuke.status` shows the whole ladder; `yujin.urazuke.step`
+   shows any step in full (prompts, inputs, artifacts, checklist).
+4. The plan is the pendings: each item needs `spec` (acceptance "given /
+   when / then" + `how_verified`) before it is implemented (step 5).
+5. No deadlines, ever: the method fixes the order and the gates, not the
+   calendar. Speed is a consequence, not the objective.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nac3/forge-cli",
-  "version": "1.23.4",
+  "version": "1.23.5",
   "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>",

package/src/i18n/catalogs/ar.json

@@ -135,6 +135,9 @@
   "error.mobile_turn_undelivered.why": "خادم المحادثة في سطح المكتب لم يكن يستمع على المنفذ {port}. لم يُنفَّذ أي شيء هنا.",
   "error.mobile_turn_undelivered.fix": "افتح لوحة Forge على سطح المكتب (أو شغّلها بـ yf chat) ثم أعد إرسال الطلب.",
   "error.mobile_turn_undelivered.cmd": "yf chat",
+  "error.verb_call_unanswered.what": "لم يُرجع استدعاء {verb} أي استجابة خلال {minutes} دقيقة.",
+  "error.verb_call_unanswered.why": "ما انتهت مدته هو الانتظار لا العمل: قد يستمر هذا الفعل في العمل على جانب Forge وينتهي بنجاح.",
+  "error.verb_call_unanswered.fix": "لا تُعد المحاولة بشكل أعمى. إذا كان الفعل يترك أثرًا فاقرأ الأثر أولًا: yujin.evidence.list للإيصال، وyujin.task.list للمهمة الخلفية.",
   "panel.button.agents": "الوكلاء",
   "panel.agents.title": "الوكلاء",
   "panel.agents.subtitle": "المدير والوكلاء الفرعيون المسجلون في هذا المشروع",

package/src/i18n/catalogs/de.json

@@ -135,6 +135,9 @@
   "error.mobile_turn_undelivered.why": "Der Chat-Server des Desktops lauschte nicht auf Port {port}. Hier wurde nichts ausgefuehrt.",
   "error.mobile_turn_undelivered.fix": "Oeffne das Forge-Panel auf dem Desktop (oder starte es mit yf chat) und sende die Anfrage erneut.",
   "error.mobile_turn_undelivered.cmd": "yf chat",
+  "error.verb_call_unanswered.what": "Der Aufruf von {verb} hat in {minutes} Minuten keine Antwort geliefert.",
+  "error.verb_call_unanswered.why": "Abgelaufen ist das Warten, nicht die Arbeit: das Verb kann auf der Forge-Seite weiterlaufen und korrekt enden.",
+  "error.verb_call_unanswered.fix": "Nicht blind wiederholen. Wenn das Verb eine Spur hinterlasst, lies zuerst die Spur: yujin.evidence.list fuer einen Beleg, yujin.task.list fuer einen Hintergrundauftrag.",
   "panel.button.agents": "Agenten",
   "panel.agents.title": "Agenten",
   "panel.agents.subtitle": "Director und Sub-Agenten registriert in diesem Projekt",

package/src/i18n/catalogs/en.json

@@ -135,6 +135,9 @@
   "error.mobile_turn_undelivered.why": "The desktop chat server was not listening on port {port}. Nothing ran here.",
   "error.mobile_turn_undelivered.fix": "Open the Forge panel on the desktop (or start it with yf chat) and send the request again.",
   "error.mobile_turn_undelivered.cmd": "yf chat",
+  "error.verb_call_unanswered.what": "The call to {verb} returned no response within {minutes} minutes.",
+  "error.verb_call_unanswered.why": "What expired is the wait, not the work: the verb may still be running on the Forge side and finish fine.",
+  "error.verb_call_unanswered.fix": "Do not blindly retry. If the verb leaves a trace, read the trace first: yujin.evidence.list for a receipt, yujin.task.list for a background task.",
   "panel.button.agents": "Agents",
   "panel.agents.title": "Agents",
   "panel.agents.subtitle": "Director and sub-agents registered in this project",

package/src/i18n/catalogs/es.json

@@ -135,6 +135,9 @@
   "error.mobile_turn_undelivered.why": "El servidor de chat del escritorio no estaba escuchando en el puerto {port}. Aca no se ejecuto nada.",
   "error.mobile_turn_undelivered.fix": "Abri el panel de Forge en el escritorio (o arrancalo con yf chat) y volve a mandar el pedido.",
   "error.mobile_turn_undelivered.cmd": "yf chat",
+  "error.verb_call_unanswered.what": "La invocacion de {verb} no devolvio respuesta en {minutes} minutos.",
+  "error.verb_call_unanswered.why": "Lo que vencio es la espera, no el trabajo: el verbo puede seguir corriendo del lado de Forge y terminar bien.",
+  "error.verb_call_unanswered.fix": "No lo repitas a ciegas. Si el verbo deja rastro, mira el rastro primero: yujin.evidence.list para un recibo, yujin.task.list para una tarea de fondo.",
   "panel.button.agents": "Agentes",
   "panel.agents.title": "Agentes",
   "panel.agents.subtitle": "Director + sub-agentes registrados en este proyecto",

package/src/i18n/catalogs/fr.json

@@ -135,6 +135,9 @@
   "error.mobile_turn_undelivered.why": "Le serveur de chat du bureau n'ecoutait pas sur le port {port}. Rien n'a ete execute ici.",
   "error.mobile_turn_undelivered.fix": "Ouvre le panneau Forge sur le bureau (ou lance-le avec yf chat) puis renvoie la demande.",
   "error.mobile_turn_undelivered.cmd": "yf chat",
+  "error.verb_call_unanswered.what": "L'appel de {verb} n'a pas renvoye de reponse en {minutes} minutes.",
+  "error.verb_call_unanswered.why": "Ce qui a expire, c'est l'attente, pas le travail : le verbe peut continuer a tourner cote Forge et se terminer correctement.",
+  "error.verb_call_unanswered.fix": "Ne relancez pas a l'aveugle. Si le verbe laisse une trace, lisez-la d'abord : yujin.evidence.list pour un recu, yujin.task.list pour une tache de fond.",
   "panel.button.agents": "Agents",
   "panel.agents.title": "Agents",
   "panel.agents.subtitle": "Director et sous-agents enregistres dans ce projet",

package/src/i18n/catalogs/hi.json

@@ -135,6 +135,9 @@
   "error.mobile_turn_undelivered.why": "डेस्कटॉप का चैट सर्वर पोर्ट {port} पर सुन नहीं रहा था। यहां कुछ भी नहीं चला।",
   "error.mobile_turn_undelivered.fix": "डेस्कटॉप पर Forge पैनल खोलें (या yf chat से शुरू करें) और अनुरोध दोबारा भेजें।",
   "error.mobile_turn_undelivered.cmd": "yf chat",
+  "error.verb_call_unanswered.what": "{verb} की कॉल ने {minutes} मिनट में कोई उत्तर नहीं लौटाया।",
+  "error.verb_call_unanswered.why": "समय-सीमा प्रतीक्षा की समाप्त हुई, काम की नहीं: यह वर्ब Forge की ओर चलता रह सकता है और ठीक से पूरा हो सकता है।",
+  "error.verb_call_unanswered.fix": "आंख मूंदकर दोबारा न चलाएं। यदि वर्ब कोई निशान छोड़ता है, तो पहले निशान देखें: रसीद के लिए yujin.evidence.list, बैकग्राउंड कार्य के लिए yujin.task.list।",
   "panel.button.agents": "एजेंट",
   "panel.agents.title": "एजेंट",
   "panel.agents.subtitle": "इस परियोजना में पंजीकृत निदेशक और उप-एजेंट",

package/src/i18n/catalogs/it.json

@@ -135,6 +135,9 @@
   "error.mobile_turn_undelivered.why": "Il server di chat del desktop non era in ascolto sulla porta {port}. Qui non e stato eseguito nulla.",
   "error.mobile_turn_undelivered.fix": "Apri il pannello Forge sul desktop (o avvialo con yf chat) e rimanda la richiesta.",
   "error.mobile_turn_undelivered.cmd": "yf chat",
+  "error.verb_call_unanswered.what": "La chiamata di {verb} non ha restituito risposta in {minutes} minuti.",
+  "error.verb_call_unanswered.why": "Cio che e scaduto e l'attesa, non il lavoro: il verbo puo continuare a girare dal lato Forge e finire bene.",
+  "error.verb_call_unanswered.fix": "Non ripetere alla cieca. Se il verbo lascia una traccia, guarda prima la traccia: yujin.evidence.list per una ricevuta, yujin.task.list per un'attivita in background.",
   "panel.button.agents": "Agenti",
   "panel.agents.title": "Agenti",
   "panel.agents.subtitle": "Director e sub-agenti registrati in questo progetto",

package/src/i18n/catalogs/ja.json

@@ -135,6 +135,9 @@
   "error.mobile_turn_undelivered.why": "デスクトップのチャットサーバーがポート {port} で待ち受けていませんでした。ここでは何も実行されていません。",
   "error.mobile_turn_undelivered.fix": "デスクトップで Forge パネルを開き (または yf chat で起動し)、もう一度リクエストを送ってください。",
   "error.mobile_turn_undelivered.cmd": "yf chat",
+  "error.verb_call_unanswered.what": "{verb} の呼び出しは {minutes} 分以内に応答を返しませんでした。",
+  "error.verb_call_unanswered.why": "期限切れになったのは待機であって、作業ではありません。この動詞は Forge 側で動き続け、正常に終わる可能性があります。",
+  "error.verb_call_unanswered.fix": "やみくもに再実行しないでください。痕跡が残る動詞なら、まず痕跡を見てください: レシートは yujin.evidence.list、バックグラウンド処理は yujin.task.list。",
   "panel.button.agents": "エージェント",
   "panel.agents.title": "エージェント",
   "panel.agents.subtitle": "このプロジェクトに登録されたディレクターとサブエージェント",

package/src/i18n/catalogs/pt.json

@@ -135,6 +135,9 @@
   "error.mobile_turn_undelivered.why": "O servidor de chat do desktop nao estava escutando na porta {port}. Aqui nada foi executado.",
   "error.mobile_turn_undelivered.fix": "Abra o painel do Forge no desktop (ou inicie com yf chat) e envie o pedido de novo.",
   "error.mobile_turn_undelivered.cmd": "yf chat",
+  "error.verb_call_unanswered.what": "A chamada de {verb} nao devolveu resposta em {minutes} minutos.",
+  "error.verb_call_unanswered.why": "O que expirou foi a espera, nao o trabalho: o verbo pode continuar rodando no lado do Forge e terminar bem.",
+  "error.verb_call_unanswered.fix": "Nao repita as cegas. Se o verbo deixa rastro, veja o rastro primeiro: yujin.evidence.list para um recibo, yujin.task.list para uma tarefa em segundo plano.",
   "panel.button.agents": "Agentes",
   "panel.agents.title": "Agentes",
   "panel.agents.subtitle": "Director e sub-agentes registados neste projeto",

package/src/i18n/catalogs/zh.json

@@ -135,6 +135,9 @@
   "error.mobile_turn_undelivered.why": "桌面端的聊天服务没有在端口 {port} 上监听。这里没有执行任何操作。",
   "error.mobile_turn_undelivered.fix": "在桌面端打开 Forge 面板（或用 yf chat 启动），然后重新发送请求。",
   "error.mobile_turn_undelivered.cmd": "yf chat",
+  "error.verb_call_unanswered.what": "{verb} 的调用在 {minutes} 分钟内没有返回响应。",
+  "error.verb_call_unanswered.why": "超时的是等待,不是工作:该动词可能仍在 Forge 一侧运行并正常结束。",
+  "error.verb_call_unanswered.fix": "不要盲目重试。如果该动词会留下痕迹,请先查看痕迹:收据用 yujin.evidence.list,后台任务用 yujin.task.list。",
   "panel.button.agents": "智能体",
   "panel.agents.title": "智能体",
   "panel.agents.subtitle": "本项目已注册的总监和子智能体",