@nac3/forge-cli 1.19.0 → 1.19.2

package/dist/chat/server.js

@@ -1777,6 +1777,89 @@ async function route(req, res, ctx) {
         }
         return;
     }
+    /* One project document, for the links of the Urazuke card modal. Gated to
+     * the project root: a path that escapes it is refused. */
+    if (req.method === 'GET' && url.pathname === '/api/forge/project-doc') {
+        const rel = (url.searchParams.get('path') || '').trim();
+        if (!rel) {
+            sendJson(res, 400, { ok: false, error: 'path required' });
+            return;
+        }
+        try {
+            const nodePath = await import('node:path');
+            const fsp = await import('node:fs/promises');
+            const abs = nodePath.resolve(ctx.projectRoot, rel);
+            const inside = abs === ctx.projectRoot || abs.startsWith(ctx.projectRoot + nodePath.sep);
+            if (!inside) {
+                sendJson(res, 403, { ok: false, error: 'path outside the project' });
+                return;
+            }
+            const st = await fsp.stat(abs);
+            if (!st.isFile()) {
+                sendJson(res, 404, { ok: false, error: 'not a file' });
+                return;
+            }
+            if (st.size > 2 * 1024 * 1024) {
+                sendJson(res, 413, { ok: false, error: 'file too big for the panel (2 MB)' });
+                return;
+            }
+            const content = await fsp.readFile(abs, 'utf8');
+            const ext = nodePath.extname(abs).replace('.', '').toLowerCase();
+            sendJson(res, 200, { ok: true, path: nodePath.relative(ctx.projectRoot, abs).split(nodePath.sep).join('/'), content, language: ext || null });
+        }
+        catch (e) {
+            sendJson(res, 404, { ok: false, error: e instanceof Error ? e.message : String(e) });
+        }
+        return;
+    }
+    /* One pending item in full, for the click on a Workflow task. */
+    if (req.method === 'GET' && url.pathname === '/api/forge/pending-item') {
+        const id = (url.searchParams.get('id') || '').trim();
+        if (!id) {
+            sendJson(res, 400, { ok: false, error: 'id required' });
+            return;
+        }
+        try {
+            const { findPending } = await import('../pending/store.js');
+            const item = await findPending(ctx.projectSlug || '', id);
+            if (!item) {
+                sendJson(res, 404, { ok: false, error: 'pending ' + id + ' not found' });
+                return;
+            }
+            sendJson(res, 200, { ok: true, item });
+        }
+        catch (e) {
+            sendJson(res, 500, { ok: false, error: e instanceof Error ? e.message : String(e) });
+        }
+        return;
+    }
+    /* URAZUKE start (2026-10-19): the panel button. */
+    if (req.method === 'POST' && url.pathname === '/api/forge/urazuke-start') {
+        let body = {};
+        try {
+            body = JSON.parse(await readBody(req) || '{}');
+        }
+        catch {
+            body = {};
+        }
+        try {
+            const { startUrazuke } = await import('../urazuke/start.js');
+            const r = await startUrazuke(ctx.projectSlug || '', ctx.projectRoot, { force: body.force === true });
+            if (r.ok) {
+                try {
+                    const { urazukeCurrent } = await import('../urazuke/current.js');
+                    const { announceStepIfChanged } = await import('../urazuke/announce.js');
+                    await announceStepIfChanged(ctx.projectSlug || '', await urazukeCurrent(ctx.projectSlug || '', ctx.projectRoot));
+                }
+                catch { /* best effort */ }
+            }
+            sendJson(res, r.ok ? 200 : 409, { ...r });
+        }
+        catch (e) {
+            sendJson(res, 500, { ok: false, error: e instanceof Error ? e.message : String(e) });
+        }
+        return;
+    }
     if (req.method === 'POST' && url.pathname === '/api/forge/urazuke-prompts') {
         let body;
         try {
@@ -4687,39 +4770,65 @@ async function handleStartupTabs(_req, res, ctx, url) {
         }
     }
     catch { /* sin pendings */ }
+    /* Una sola ventana canonica (Pablo, 2026-10-19): cuando Urazuke esta
+     * encendido y el proyecto corre la escalera, la pestana Urazuke reemplaza
+     * a la pestana Workflow (dibuja lo mismo y mas); cuando esta apagado, la
+     * pestana Urazuke se oculta. `hidden` le dice al panel que pestanas
+     * abiertas tiene que cerrar sin recordarlas como cerradas por el usuario. */
+    const hidden = [];
+    let ladderActive = false;
+    try {
+        const { urazukeEnabled } = await import('../urazuke/enabled.js');
+        const { findUrazukeInstance } = await import('../urazuke/current.js');
+        ladderActive = !!(ctx.projectSlug && await urazukeEnabled() && await findUrazukeInstance(ctx.projectSlug));
+    }
+    catch {
+        ladderActive = false;
+    }
+    let urazukeOn = false;
+    try {
+        urazukeOn = await (await import('../urazuke/enabled.js')).urazukeEnabled();
+    }
+    catch {
+        urazukeOn = false;
+    }
+    if (ladderActive)
+        hidden.push('startup_workflow');
+    else if (!urazukeOn)
+        hidden.push('startup_urazuke');
     /* 4: workflow como GRAFO de nodos (las 6 fases del flujo yujin
      * con sus pasos), coloreadas por estado (done/pendiente) cuando
      * hay workflow state. Cumple el pedido de "workflow como grafo
      * de nodos y conectores con detalle al click". */
-    try {
-        /* PND-094 -- vista jerarquica de FASES + tareas (no grafo): cada
-         * fase con su avance + sus tareas debajo con su estado. */
-        /* PND-094 ext -- multi-workflow: the coexisting WorkflowInstances
-         * with their tasks (pendings) grouped by stage. Falls back to the
-         * legacy single-workflow view when there are no instances yet. */
-        const { computeWorkflowsView } = await import('../workflow/multi_view.js');
-        const cards = await computeWorkflowsView(ctx.projectSlug ?? '', 'open');
-        if (cards.length > 0) {
-            tabs.push({ key: 'startup_workflow', title: t('startup.tab.workflow'), kind: 'workflow', content: JSON.stringify({ workflows: cards }) });
+    if (!ladderActive)
+        try {
+            /* PND-094 -- vista jerarquica de FASES + tareas (no grafo): cada
+             * fase con su avance + sus tareas debajo con su estado. */
+            /* PND-094 ext -- multi-workflow: the coexisting WorkflowInstances
+             * with their tasks (pendings) grouped by stage. Falls back to the
+             * legacy single-workflow view when there are no instances yet. */
+            const { computeWorkflowsView } = await import('../workflow/multi_view.js');
+            const cards = await computeWorkflowsView(ctx.projectSlug ?? '', 'open');
+            if (cards.length > 0) {
+                tabs.push({ key: 'startup_workflow', title: t('startup.tab.workflow'), kind: 'workflow', content: JSON.stringify({ workflows: cards }) });
+            }
+            else {
+                const { readWorkflow } = await import('../workflow/state.js');
+                const { computeWorkflowView } = await import('../workflow/view.js');
+                const view = computeWorkflowView(await readWorkflow(ctx.projectRoot));
+                tabs.push({ key: 'startup_workflow', title: t('startup.tab.workflow'), kind: 'workflow', content: JSON.stringify(view) });
+            }
         }
-        else {
-            const { readWorkflow } = await import('../workflow/state.js');
-            const { computeWorkflowView } = await import('../workflow/view.js');
-            const view = computeWorkflowView(await readWorkflow(ctx.projectRoot));
-            tabs.push({ key: 'startup_workflow', title: t('startup.tab.workflow'), kind: 'workflow', content: JSON.stringify(view) });
+        catch {
+            tabs.push({ key: 'startup_workflow', title: t('startup.tab.workflow'), kind: 'md', content: '# Workflow\n\nSin datos.\n' });
         }
-    }
-    catch {
-        tabs.push({ key: 'startup_workflow', title: t('startup.tab.workflow'), kind: 'md', content: '# Workflow\n\nSin datos.\n' });
-    }
     /* 4b: URAZUKE (2026-10-19) -- la escalera con el estado mecanico de cada
      * peldano y el peldano en curso con su prompt, sus insumos y sus chequeos.
      * Solo cuando el proyecto corre un workflow urazuke / urazuke-legacy. */
     try {
         const { findUrazukeInstance, urazukeLadder, urazukeCurrent } = await import('../urazuke/current.js');
         const slugU = ctx.projectSlug ?? '';
-        const { urazukeEnabled } = await import('../urazuke/enabled.js');
-        if (slugU && await urazukeEnabled() && await findUrazukeInstance(slugU)) {
+        if (slugU && ladderActive && await findUrazukeInstance(slugU)) {
             const ladder = await urazukeLadder(slugU, ctx.projectRoot);
             const cur = await urazukeCurrent(slugU, ctx.projectRoot);
             const current = cur ? {
@@ -4733,6 +4842,12 @@ async function handleStartupTabs(_req, res, ctx, url) {
             } : null;
             tabs.push({ key: 'startup_urazuke', title: t('startup.tab.urazuke'), kind: 'urazuke', content: JSON.stringify({ ladder, current }) });
         }
+        else if (slugU && urazukeOn) {
+            /* No ladder yet: the tab offers the door in (yujin.urazuke.start). */
+            const { urazukeStartHint } = await import('../urazuke/start.js');
+            const start = await urazukeStartHint(slugU, ctx.projectRoot);
+            tabs.push({ key: 'startup_urazuke', title: t('startup.tab.urazuke'), kind: 'urazuke', content: JSON.stringify({ ladder: null, current: null, start }) });
+        }
     }
     catch { /* sin escalera: la pestana no aparece */ }
     /* 5: PND-007 -- Tareas de fondo (se llena en vivo client-side). */
@@ -4751,7 +4866,7 @@ async function handleStartupTabs(_req, res, ctx, url) {
         kind: 'files',
         content: '{}',
     });
-    sendJson(res, 200, { ok: true, enabled: true, tabs });
+    sendJson(res, 200, { ok: true, enabled: true, tabs, hidden });
 }
 /** Formato de id de pending para display (PND-NNN). */
 function formatPendId(id) {
@@ -6196,6 +6311,13 @@ async function handleChat(req, res, ctx) {
             const r = await buildUrazukeSection({ project_slug: ctx.projectSlug || '', project_root: ctx.projectRoot, char_budget: 6000 });
             if (r.rendered_text)
                 urazukeSection = r.rendered_text;
+            /* The owner sees in the chat which step runs and what is expected of
+             * them (never the prompt): one system line per step change. */
+            try {
+                const { announceStepIfChanged } = await import('../urazuke/announce.js');
+                await announceStepIfChanged(ctx.projectSlug || '', r.current);
+            }
+            catch { /* best effort */ }
         }
         catch (_) { /* swallow */ }
         /* alpha.59z.15 HITO 6.3 -- prefetch global learnings from
@@ -6229,6 +6351,14 @@ async function handleChat(req, res, ctx) {
         try {
             const { readLimitsConfig } = await import('../core/limits_config.js');
             multiagentEnabled = (await readLimitsConfig()).multiagent.enabled === true;
+            /* 2026-10-19: on the Claude Plan without another provider's key the
+             * children cannot run; hide the verbs instead of letting the brain
+             * discover it by four dead sub-sessions. */
+            if (multiagentEnabled) {
+                const { hasUsableChildBrain } = await import('./tools/session_verbs.js');
+                if (!(await hasUsableChildBrain()))
+                    multiagentEnabled = false;
+            }
         }
         catch (_) { /* config failure -> stay OFF (safe default) */ }
         /* alpha.59z.37 NAC-3 v3.x backend tools -- prefetch the