@nac3/forge-cli 1.0.49 → 1.0.51

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. */
@@ -3771,6 +3779,11 @@ async function handleStartupTabs(_req, res, ctx, url) {
         const gNodes = nodes.map((n) => ({ id: n.id, label: n.name || n.id, weight: n.weight, kind: n.kind, confidence: n.confidence, detail: n.purpose || '' }));
         const gEdges = edges.map((e) => ({ from: e.from_id, to: e.to_id, kind: e.kind }));
         tabs.push({ key: 'startup_graph', title: t('startup.tab.graph'), kind: 'graph', content: JSON.stringify({ nodes: gNodes, edges: gEdges }) });
+        /* Vista funcional -- misma data, marcada mode:'functional'. El panel
+         * la renderiza centrada en las funcionalidades de front-end (nodos
+         * del grupo 'frontend') con un selector para filtrar el subgrafo que
+         * cada funcionalidad toca. Reusa el mismo renderer de grafo. */
+        tabs.push({ key: 'startup_graph_func', title: t('startup.tab.graphFunc'), kind: 'graph', content: JSON.stringify({ nodes: gNodes, edges: gEdges, mode: 'functional' }) });
         /* Grafo semantico = misma data en markdown (tabla de nodos por
          * peso + conteo de aristas), con la confianza para distinguir lo
          * declarado (claimed) de lo derivado del codigo (auto). */
@@ -5013,6 +5026,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 +5164,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 +5364,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 +5823,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 +5858,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 +6094,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 +6126,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)',
         '=================================================================',
@@ -6267,6 +6310,14 @@ projectIdentity) {
         'For the full doctrine with MAL/BIEN examples, call',
         'yujin.doctrine.discover({slugs:["r8-modal"]}).',
         '',
+        'R9 -- ASK AND STOP (twin of R8, for a USER DECISION): when you',
+        'truly need the user to decide/clarify, STOP and ask it as your',
+        'FINAL message in plain prose -- no tool after the question, no',
+        'proceeding on a guess, never "I will proceed with X" when X is',
+        'what you needed decided. Do NOT call AskUserQuestion/popups',
+        '(non-interactive here -> lost). Prose as the last thing you say',
+        'IS the question; the user answers next turn. Do not overuse.',
+        '',
         '=================================================================',
         'BYOK + LICENSE (all chat/voice -- LEMA YUJIN)',
         '=================================================================',