@nac3/forge-cli 1.0.50 → 1.0.52

package/dist/chat/server.js

@@ -261,7 +261,9 @@ export async function startChatServer(opts) {
      * ephemeral runs (vitest sets VITEST; also skip an obvious temp root). */
     const isTestEnv = !!process.env.VITEST || process.env.NODE_ENV === 'test';
     const isTempRoot = /[\\/](?:te?mp|yf-[a-z-]*proj|yf-startup)/i.test(opts.projectRoot);
-    if (!isTestEnv && !isTempRoot) {
+    /* A headless agent sub-session must NEVER touch the global registry --
+     * it would flip the parent's active project (Pablo's scramble bug). */
+    if (!isTestEnv && !isTempRoot && !opts.agentMode) {
         void (async () => {
             try {
                 await upsertProject({ slug: projectSlug, path: opts.projectRoot });
@@ -439,7 +441,12 @@ export async function startChatServer(opts) {
      * so if the user pairs a phone MID-SESSION it wakes up automatically (no
      * restart needed). When the relay is off it is a cheap no-op timer. */
     let commandConsumerHandle = null;
+    /* A headless agent sub-session does NOT consume phone commands -- every
+     * yf chat polls the same relay stream, so a child would race the parent
+     * for ownership and could run a mobile command twice. */
     try {
+        if (opts.agentMode)
+            throw new Error('agent-mode: relay consumer disabled');
         commandConsumerHandle = startDesktopCommandConsumer(opts.port, {
             /* live so a reanchor moves which commands this instance owns */
             getActiveSlug: () => session.projectSlug,
@@ -525,6 +532,7 @@ export async function startChatServer(opts) {
         url,
         port: opts.port,
         store,
+        bridge: bridgeHandle,
         close: () => new Promise((resolve) => {
             /* alpha.59w -- stop the component watcher on shutdown so
              *  vitest does not hang on lingering fs watchers. */
@@ -1934,6 +1942,18 @@ async function route(req, res, ctx) {
         await handleProjectsAdd(req, res);
         return;
     }
+    if (req.method === 'POST' && url.pathname === '/api/forge/projects/remove') {
+        await handleProjectsRemove(req, res);
+        return;
+    }
+    if (req.method === 'GET' && url.pathname === '/api/forge/files-tree') {
+        await handleFilesTree(res, ctx);
+        return;
+    }
+    if (req.method === 'POST' && url.pathname === '/api/forge/open-native') {
+        await handleOpenNative(req, res, ctx);
+        return;
+    }
     if (req.method === 'POST' && url.pathname.startsWith('/api/vault/test/')) {
         const slot = url.pathname.slice('/api/vault/test/'.length);
         await handleVaultTest(req, res, slot);
@@ -3831,6 +3851,15 @@ async function handleStartupTabs(_req, res, ctx, url) {
         kind: 'tasks',
         content: '',
     });
+    /* 6: File explorer -- the tree is fetched live by the panel from
+     * /api/forge/files-tree (so the 12s startup-tabs refresh does NOT
+     * re-scan the repo); the content is a stable placeholder. */
+    tabs.push({
+        key: 'startup_files',
+        title: t('startup.tab.files'),
+        kind: 'files',
+        content: '{}',
+    });
     sendJson(res, 200, { ok: true, enabled: true, tabs });
 }
 /** Formato de id de pending para display (PND-NNN). */
@@ -4388,6 +4417,62 @@ async function handleProjectsAdd(req, res) {
     const reg = await readRegistry();
     sendJson(res, 200, { ok: true, slug, registry: reg });
 }
+/** Remove a project from the local registry (the panel "X"). Never touches
+ *  the repo on disk -- removeProject only edits projects.json (and clears
+ *  active_slug if the removed one was active). */
+async function handleProjectsRemove(req, res) {
+    let body;
+    try {
+        body = JSON.parse(await readBody(req));
+    }
+    catch {
+        sendJson(res, 400, { ok: false, error: 'invalid JSON' });
+        return;
+    }
+    if (typeof body.slug !== 'string' || body.slug.trim() === '') {
+        sendJson(res, 400, { ok: false, error: 'slug (string) required' });
+        return;
+    }
+    const { removeProject } = await import('../core/projects.js');
+    const reg = await removeProject(body.slug);
+    sendJson(res, 200, { ok: true, active: reg.active_slug, registry: reg });
+}
+/** Directory tree of the active project, for the file-explorer tab. */
+async function handleFilesTree(res, ctx) {
+    try {
+        const { listProjectFiles } = await import('../core/file_tree.js');
+        const tree = await listProjectFiles(ctx.projectRoot);
+        sendJson(res, 200, { ok: true, root_name: tree.root.name, tree: tree.root, truncated: tree.truncated, node_count: tree.node_count });
+    }
+    catch (err) {
+        sendJson(res, 500, { ok: false, error: err instanceof Error ? err.message : String(err) });
+    }
+}
+/** Open a project file with the OS-associated application (the file-explorer
+ *  click). Delegates to desktop_open.openNative, which gates the path to the
+ *  project root and refuses executable/script extensions. */
+async function handleOpenNative(req, res, ctx) {
+    let body;
+    try {
+        body = JSON.parse(await readBody(req));
+    }
+    catch {
+        sendJson(res, 400, { ok: false, error: 'invalid JSON' });
+        return;
+    }
+    if (typeof body.path !== 'string' || body.path.trim() === '') {
+        sendJson(res, 400, { ok: false, error: 'path (string) required' });
+        return;
+    }
+    try {
+        const { openNative } = await import('../core/desktop_open.js');
+        const result = await openNative(body.path, ctx.projectRoot);
+        sendJson(res, result.ok ? 200 : 400, result);
+    }
+    catch (err) {
+        sendJson(res, 500, { ok: false, error: err instanceof Error ? err.message : String(err) });
+    }
+}
 async function handleTargetGet(res, ctx) {
     const r = await resolveTarget(ctx.projectRoot);
     sendJson(res, 200, {
@@ -5013,6 +5098,16 @@ async function handleChat(req, res, ctx) {
             mcpAvailable = bridges.some((b) => b.enabled);
         }
         catch (_) { /* registry failure -> stay with MCP-off behaviour */ }
+        /* Multi-agent session orchestration toggle (Pablo 2026-06-28). Default
+         * OFF: the yujin.session.* verbs + their doctrine are hidden from the
+         * prompt and the brain is told the feature is off. The user opts in via
+         * Ajustes > Limites (multiagent.enabled). */
+        let multiagentEnabled = false;
+        try {
+            const { readLimitsConfig } = await import('../core/limits_config.js');
+            multiagentEnabled = (await readLimitsConfig()).multiagent.enabled === true;
+        }
+        catch (_) { /* config failure -> stay OFF (safe default) */ }
         /* alpha.59z.37 NAC-3 v3.x backend tools -- prefetch the
          * adopter app's nac3_backend section (task #23). Empty
          * string when the manifest does not declare it, when the
@@ -5141,7 +5236,7 @@ async function handleChat(req, res, ctx) {
              * pizarron_create_tab tool; in API/managed it is native. */
             ctx.chatProvider === 'claude-code-cli'
                 ? (ctx.panelPushToken ? 'mcp-bridge' : 'none')
-                : 'native', projectIdentity),
+                : 'native', projectIdentity, multiagentEnabled),
             systemDynamic: recentSessionsRecap + projectContextSection + snapshotSection + graphSection + wiringSection + toolingSection + workflowSection + approvalPostureSection,
             maxTokens: _maxTokensPerTurn,
             /* Plan/CLI uses Claude Code's native tools (FORGE_TOOL_SPECS = just
@@ -5341,7 +5436,7 @@ async function handleChat(req, res, ctx) {
                                 model: frontierSel.model,
                             }, globalLearnings, mcpAvailable, backendToolsSection, lastUserText, ctx.chatProvider === 'claude-code-cli'
                                 ? (ctx.panelPushToken ? 'mcp-bridge' : 'none')
-                                : 'native', projectIdentity),
+                                : 'native', projectIdentity, multiagentEnabled),
                         };
                         const frontierReply = await frontierCaller.chat(frontierRequest);
                         reply = frontierReply;
@@ -5800,7 +5895,12 @@ panelMode = 'native',
  *  CLI version with the project's own version (Pablo: "Es Forge v1.0.44"
  *  appeared while anchored to Yuemail 0.6.4). Undefined -> the block
  *  falls back to name + root + Forge-CLI version (back-compat). */
-projectIdentity) {
+projectIdentity, 
+/** Pablo 2026-06-28 -- whether multi-agent session orchestration
+ *  (yujin.session.*) is enabled in config. When false (default) the
+ *  session verbs + their doctrine line are filtered out and the brain is
+ *  told the feature is OFF. The caller prefetches readLimitsConfig(). */
+multiagentEnabled = false) {
     /* alpha.58 -- tier awareness header. When the request is
      *  served by an eco-tier model (Gemini Flash Lite, Haiku),
      *  the model is told its role explicitly so it can be more
@@ -5830,7 +5930,7 @@ projectIdentity) {
         'tengo los verbos NAC-3 enchufados" is FACTUALLY WRONG -- your',
         'runtime DOES have the NAC-3 manifest wired (yujin.fs.*,',
         'yujin.git.*, yujin.graph.*, yujin.wiring.*, yujin.pending.*,',
-        'yujin.doctrine.*, yujin.nac3.*, yujin.bridge.*, plus the rest in',
+        'yujin.doctrine.*, yujin.nac3.*, yujin.bridge.*, yujin.session.*, plus the rest in',
         'the manifest stub below). When in doubt about what is available, call',
         'yujin.manifest.read or yujin.nac3.discover-schemas before',
         'claiming "no tengo X". Falsely claiming otherwise destroys',
@@ -6066,8 +6166,23 @@ projectIdentity) {
         '     yujin.shell.exec is for ops with NO native verb equivalent:',
         '     npm install, docker build, pytest, custom scripts, etc.',
         '',
+        /* Multi-agent orchestration state (Pablo 2026-06-28) -- the brain must
+         * KNOW whether yujin.session.* is available. Default OFF. */
+        ...(multiagentEnabled
+            ? [
+                'ORQUESTACION MULTIAGENTE: ON. Podes lanzar sub-sesiones `yf chat`',
+                'headless con yujin.session.spawn para tareas ORTOGONALES en paralelo',
+                '(ver la doctrina session-orchestration). Siempre yujin.session.collect',
+                'lo que lances.', '',
+            ]
+            : [
+                'ORQUESTACION MULTIAGENTE: OFF. Los verbos yujin.session.* NO estan',
+                'disponibles en esta sesion (no figuran en el manifest). No intentes',
+                'lanzar sub-sesiones. Si el usuario quiere paralelizar con sub-sesiones,',
+                'decile que la active en Ajustes > Limites (multiagent.enabled).', '',
+            ]),
         'MANIFEST:',
-        buildManifestForPrompt({ includeMcpVerbs: mcpAvailable }).text,
+        buildManifestForPrompt({ includeMcpVerbs: mcpAvailable, includeSessionVerbs: multiagentEnabled }).text,
         /* alpha.59z.37 NAC-3 v3.x backend tools (task #23 slice 1):
          * splice the pre-built app.* verbs section. Empty string ->
          * nothing appears (Invariant: identical to v3.0 when no
@@ -6083,7 +6198,7 @@ projectIdentity) {
          * code-quality guardrails, so the condensed essence of EVERY one
          * is injected mandatorily in every prompt (not on-demand). Full
          * text still on-demand via yujin.doctrine.discover. */
-        ...buildDoctrineDigestLines(),
+        ...buildDoctrineDigestLines({ includeSession: multiagentEnabled }),
         '=================================================================',
         'PIZARRON DOCTRINE (condensed; full text on-demand)',
         '=================================================================',