@cleocode/cleo 2026.5.131 → 2026.5.132

package/dist/cli/index.js

@@ -47108,24 +47108,143 @@ var init_server = __esm({
   }
 });
 
-// packages/cleo/src/cli/commands/docs-viewer.ts
-import { spawn } from "node:child_process";
-import { open as fsOpen } from "node:fs/promises";
+// packages/cleo/src/cli/docs-viewer-subsystem.ts
+import { mkdir as mkdir2 } from "node:fs/promises";
 import { join as join20 } from "node:path";
-import { fileURLToPath as fileURLToPath5 } from "node:url";
-import { getCleoHome as getCleoHome3, getProjectRoot as getProjectRoot37 } from "@cleocode/core";
-function getCleoBinPath() {
-  const thisFile = fileURLToPath5(import.meta.url);
-  return join20(thisFile, "..", "..", "index.js");
+import { getCleoHome as getCleoHome3 } from "@cleocode/core";
+import { defineSubsystem } from "@cleocode/runtime/daemon";
+function getViewerPaths() {
+  const cleoHome = getCleoHome3();
+  return {
+    pidFile: viewerPidFilePath(),
+    logFile: join20(cleoHome, "viewer.log"),
+    logDir: cleoHome
+  };
+}
+function isViewerProcessRunning(pid) {
+  return isProcessAlive(pid);
 }
-async function waitForExit(pid, timeoutMs, intervalMs = 100) {
-  const deadline = Date.now() + timeoutMs;
-  while (Date.now() < deadline) {
-    if (!isProcessAlive(pid)) return true;
-    await new Promise((r) => setTimeout(r, intervalMs));
+async function getViewerStatus() {
+  const record = await readViewerPidFile();
+  if (!record) return { running: false, pid: null, port: null, host: null, url: null };
+  if (!isProcessAlive(record.pid)) {
+    await removeViewerPidFile();
+    return { running: false, pid: null, port: null, host: null, url: null };
   }
-  return !isProcessAlive(pid);
+  return {
+    running: true,
+    pid: record.pid,
+    port: record.port,
+    host: record.host,
+    url: `http://${record.host}:${record.port}`
+  };
 }
+function createDocsViewerSubsystem(opts = {}) {
+  const startPort = opts.startPort ?? VIEWER_DEFAULT_PORT;
+  const endPort = opts.endPort ?? VIEWER_DEFAULT_END_PORT;
+  const host = opts.host ?? VIEWER_DEFAULT_HOST;
+  const autoIncrement = !(opts.noAutoPort ?? false);
+  let live;
+  return defineSubsystem({
+    name: VIEWER_SUBSYSTEM_NAME,
+    async start() {
+      const { pidFile, logDir } = getViewerPaths();
+      const existing = await getViewerStatus();
+      if (existing.running && existing.pid !== null) {
+        const ctx2 = {
+          pid: existing.pid,
+          pidFile,
+          port: existing.port ?? startPort,
+          host: existing.host ?? host
+        };
+        live = ctx2;
+        return ctx2;
+      }
+      await mkdir2(logDir, { recursive: true });
+      const handle = await startViewer({
+        startPort,
+        endPort,
+        host,
+        autoIncrement
+      });
+      await writeViewerPidFile({
+        pid: process.pid,
+        port: handle.port,
+        host: handle.host,
+        projectRoot: process.cwd(),
+        startedAt: Date.now()
+      });
+      const ctx = {
+        pid: process.pid,
+        pidFile,
+        port: handle.port,
+        host: handle.host
+      };
+      live = ctx;
+      return ctx;
+    },
+    healthProbe() {
+      if (live === void 0) {
+        const stopped = "stopped";
+        return {
+          child_id: VIEWER_SUBSYSTEM_NAME,
+          pid: 0,
+          state: stopped,
+          restart_count: 0,
+          detail: "not started"
+        };
+      }
+      const alive = isViewerProcessRunning(live.pid);
+      const state = alive ? "running" : "stopped";
+      return {
+        child_id: VIEWER_SUBSYSTEM_NAME,
+        pid: alive ? live.pid : 0,
+        state,
+        restart_count: 0,
+        detail: alive ? `url=http://${live.host}:${live.port} pid=${live.pid}` : `pid=${live.pid} exited`
+      };
+    },
+    async shutdown(context) {
+      if (!isViewerProcessRunning(context.pid)) {
+        await removeViewerPidFile();
+        live = void 0;
+        return;
+      }
+      try {
+        process.kill(context.pid, "SIGTERM");
+      } catch {
+      }
+      for (let i = 0; i < SIGTERM_GRACE_ITERATIONS; i++) {
+        if (!isViewerProcessRunning(context.pid)) break;
+        await new Promise((resolve11) => setTimeout(resolve11, 500));
+      }
+      if (isViewerProcessRunning(context.pid)) {
+        try {
+          process.kill(context.pid, "SIGKILL");
+        } catch {
+        }
+      }
+      await removeViewerPidFile();
+      live = void 0;
+    }
+  });
+}
+var VIEWER_DEFAULT_PORT, VIEWER_DEFAULT_END_PORT, VIEWER_DEFAULT_HOST, VIEWER_SUBSYSTEM_NAME, SIGTERM_GRACE_ITERATIONS;
+var init_docs_viewer_subsystem = __esm({
+  "packages/cleo/src/cli/docs-viewer-subsystem.ts"() {
+    "use strict";
+    init_pidfile();
+    init_server();
+    VIEWER_DEFAULT_PORT = 7777;
+    VIEWER_DEFAULT_END_PORT = 7800;
+    VIEWER_DEFAULT_HOST = "127.0.0.1";
+    VIEWER_SUBSYSTEM_NAME = "cleo-docs-viewer";
+    SIGTERM_GRACE_ITERATIONS = 20;
+  }
+});
+
+// packages/cleo/src/cli/commands/docs-viewer.ts
+import { spawn } from "node:child_process";
 function openInBrowser(url) {
   try {
     let cmd;
@@ -47144,72 +47263,40 @@ function openInBrowser(url) {
   } catch {
   }
 }
-async function spawnDetachedServer(opts) {
-  const logFile = join20(getCleoHome3(), "viewer.log");
-  const handle = await fsOpen(logFile, "a").catch(() => null);
-  const stdio = handle ? ["ignore", handle.fd, handle.fd] : ["ignore", "ignore", "ignore"];
-  const args = [
-    getCleoBinPath(),
-    "docs",
-    "serve",
-    "--port",
-    String(opts.startPort),
-    "--end-port",
-    String(opts.endPort),
-    "--host",
-    opts.host
-  ];
-  if (opts.noAutoPort) args.push("--no-auto-port");
-  const child = spawn(process.execPath, args, {
-    detached: true,
-    stdio,
-    env: { ...process.env, [DETACHED_CHILD_ENV]: "1" },
-    cwd: getProjectRoot37()
-  });
-  child.unref();
-  if (handle) await handle.close();
-  return child;
-}
-var DETACHED_CHILD_ENV, serveCommand, openCommand, stopCommand4, viewerStatusCommand, runViewerStatus, viewerCommand, docsViewerSubcommands;
+var serveCommand, openCommand, stopCommand4, viewerStatusCommand, runViewerStatus, viewerCommand, docsViewerSubcommands;
 var init_docs_viewer = __esm({
   "packages/cleo/src/cli/commands/docs-viewer.ts"() {
     "use strict";
     init_src2();
     init_dist();
     init_pidfile();
-    init_server();
+    init_docs_viewer_subsystem();
     init_renderers();
-    DETACHED_CHILD_ENV = "CLEO_VIEWER_DETACHED_CHILD";
     serveCommand = defineCommand({
       meta: {
         name: "serve",
-        description: "[legacy] Run docs viewer \u2014 prefer `cleo docs viewer start`"
+        description: "Run docs viewer \u2014 prefer `cleo docs viewer start`"
       },
       args: {
         port: {
           type: "string",
           description: "Starting port (default 7777)",
-          default: "7777"
+          default: String(VIEWER_DEFAULT_PORT)
         },
         "end-port": {
           type: "string",
           description: "Last port to try when auto-incrementing (default 7800)",
-          default: "7800"
+          default: String(VIEWER_DEFAULT_END_PORT)
         },
         host: {
           type: "string",
           description: "Bind host (default 127.0.0.1)",
-          default: "127.0.0.1"
+          default: VIEWER_DEFAULT_HOST
         },
         "no-auto-port": {
           type: "boolean",
           description: "Disable auto-increment when start port is busy",
           default: false
-        },
-        detach: {
-          type: "boolean",
-          description: "Run in background; write pid to viewer.pid; exit immediately",
-          default: false
         }
       },
       async run({ args }) {
@@ -47217,8 +47304,6 @@ var init_docs_viewer = __esm({
         const endPort = Number.parseInt(String(args["end-port"]), 10);
         const host = String(args.host);
         const noAutoPort = Boolean(args["no-auto-port"]);
-        const detach = Boolean(args.detach);
-        const isDetachedChild = process.env[DETACHED_CHILD_ENV] === "1";
         if (!Number.isFinite(startPort) || startPort < 1 || startPort > 65535) {
           cliError(`invalid --port: ${args.port}`, 6 /* VALIDATION_ERROR */, { name: "E_VALIDATION" });
           return;
@@ -47229,79 +47314,25 @@ var init_docs_viewer = __esm({
           });
           return;
         }
-        if (detach && !isDetachedChild) {
-          const existing = await readViewerPidFile();
-          if (existing && isProcessAlive(existing.pid)) {
-            cliOutput(
-              {
-                running: true,
-                pid: existing.pid,
-                port: existing.port,
-                host: existing.host,
-                url: `http://${existing.host}:${existing.port}`,
-                pidFile: viewerPidFilePath()
-              },
-              {
-                command: "docs serve",
-                operation: "docs.serve",
-                message: `viewer already running on http://${existing.host}:${existing.port}`
-              }
-            );
-            return;
-          }
-          const child = await spawnDetachedServer({ startPort, endPort, host, noAutoPort });
-          if (!child.pid) {
-            cliError("failed to spawn detached viewer process", 1 /* GENERAL_ERROR */, {
-              name: "E_SPAWN_FAILED"
-            });
-            return;
-          }
-          let record2 = null;
-          const deadline = Date.now() + 1e4;
-          while (Date.now() < deadline) {
-            await new Promise((r) => setTimeout(r, 150));
-            record2 = await readViewerPidFile();
-            if (record2 && record2.pid === child.pid) break;
-            if (!isProcessAlive(child.pid)) {
-              cliError(
-                "detached viewer exited before binding (check ~/.local/share/cleo/viewer.log)",
-                1 /* GENERAL_ERROR */,
-                { name: "E_VIEWER_EXITED" }
-              );
-              return;
-            }
-          }
-          if (!record2 || record2.pid !== child.pid) {
-            cliError("timed out waiting for detached viewer to bind", 1 /* GENERAL_ERROR */, {
-              name: "E_VIEWER_TIMEOUT"
-            });
-            return;
-          }
+        try {
+          const subsystem = createDocsViewerSubsystem({ startPort, endPort, host, noAutoPort });
+          const ctx = await subsystem.start();
+          const { pidFile } = getViewerPaths();
           cliOutput(
             {
               running: true,
-              pid: record2.pid,
-              port: record2.port,
-              host: record2.host,
-              url: `http://${record2.host}:${record2.port}`,
-              pidFile: viewerPidFilePath()
+              pid: ctx.pid,
+              port: ctx.port,
+              host: ctx.host,
+              url: `http://${ctx.host}:${ctx.port}`,
+              pidFile
             },
             {
               command: "docs serve",
               operation: "docs.serve",
-              message: `viewer started on http://${record2.host}:${record2.port}`
+              message: `viewer started on http://${ctx.host}:${ctx.port}`
             }
           );
-          return;
-        }
-        let handle;
-        try {
-          handle = await startViewer({
-            startPort,
-            endPort,
-            host,
-            autoIncrement: !noAutoPort
-          });
         } catch (err) {
           const e = err;
           if (e.code === "E_NO_PORT" || e.code === "EADDRINUSE") {
@@ -47312,49 +47343,12 @@ var init_docs_viewer = __esm({
           }
           throw err;
         }
-        const record = {
-          pid: process.pid,
-          port: handle.port,
-          host: handle.host,
-          projectRoot: getProjectRoot37(),
-          startedAt: Date.now()
-        };
-        await writeViewerPidFile(record);
-        const url = `http://${handle.host}:${handle.port}`;
-        if (isDetachedChild) {
-        } else {
-          humanInfo(`viewer listening on ${url} (Ctrl+C to stop)`);
-          cliOutput(
-            {
-              running: true,
-              pid: record.pid,
-              port: record.port,
-              host: record.host,
-              url,
-              pidFile: viewerPidFilePath()
-            },
-            {
-              command: "docs serve",
-              operation: "docs.serve",
-              message: `viewer running on ${url}`
-            }
-          );
-        }
-        const shutdown = async (signal) => {
-          handle.server.close();
-          await removeViewerPidFile();
-          process.exit(signal === "SIGINT" ? 130 : 143);
-        };
-        process.on("SIGINT", () => void shutdown("SIGINT"));
-        process.on("SIGTERM", () => void shutdown("SIGTERM"));
-        await new Promise((res) => handle.server.on("close", res));
-        await removeViewerPidFile();
       }
     });
     openCommand = defineCommand({
       meta: {
         name: "open",
-        description: "[legacy] Open docs viewer in browser \u2014 prefer `cleo docs viewer open`"
+        description: "Open docs viewer in browser \u2014 prefer `cleo docs viewer open`"
       },
       args: {
         slug: {
@@ -47365,17 +47359,17 @@ var init_docs_viewer = __esm({
         port: {
           type: "string",
           description: "Starting port for the viewer (default 7777)",
-          default: "7777"
+          default: String(VIEWER_DEFAULT_PORT)
         },
         "end-port": {
           type: "string",
           description: "Last port to try (default 7800)",
-          default: "7800"
+          default: String(VIEWER_DEFAULT_END_PORT)
         },
         host: {
           type: "string",
           description: "Bind host (default 127.0.0.1)",
-          default: "127.0.0.1"
+          default: VIEWER_DEFAULT_HOST
         },
         "no-launch": {
           type: "boolean",
@@ -47385,49 +47379,30 @@ var init_docs_viewer = __esm({
       },
       async run({ args }) {
         const slug = args.slug ? String(args.slug) : void 0;
-        let record = await readViewerPidFile();
-        if (record && !isProcessAlive(record.pid)) {
-          await removeViewerPidFile();
-          record = null;
-        }
-        if (!record) {
+        let status = await getViewerStatus();
+        if (!status.running) {
           const startPort = Number.parseInt(String(args.port), 10);
           const endPort = Number.parseInt(String(args["end-port"]), 10);
           const host = String(args.host);
-          const child = await spawnDetachedServer({
-            startPort,
-            endPort,
-            host,
-            noAutoPort: false
-          });
-          if (!child.pid) {
-            cliError("failed to spawn detached viewer process", 1 /* GENERAL_ERROR */, {
-              name: "E_SPAWN_FAILED"
-            });
-            return;
-          }
-          const deadline = Date.now() + 1e4;
-          while (Date.now() < deadline) {
-            await new Promise((r) => setTimeout(r, 150));
-            record = await readViewerPidFile();
-            if (record && record.pid === child.pid) break;
-            if (!isProcessAlive(child.pid)) {
-              cliError(
-                "detached viewer exited before binding (check ~/.local/share/cleo/viewer.log)",
-                1 /* GENERAL_ERROR */,
-                { name: "E_VIEWER_EXITED" }
-              );
-              return;
-            }
-          }
-          if (!record) {
-            cliError("timed out waiting for viewer to bind", 1 /* GENERAL_ERROR */, {
-              name: "E_VIEWER_TIMEOUT"
+          try {
+            const subsystem = createDocsViewerSubsystem({ startPort, endPort, host });
+            await subsystem.start();
+            status = await getViewerStatus();
+          } catch (err) {
+            const e = err;
+            cliError(e.message ?? "failed to start docs viewer", 1 /* GENERAL_ERROR */, {
+              name: "E_VIEWER_START_FAILED"
             });
             return;
           }
         }
-        const url = slug ? `http://${record.host}:${record.port}/docs/${encodeURIComponent(slug)}` : `http://${record.host}:${record.port}/`;
+        if (!status.running || status.pid === null || status.port === null || status.host === null) {
+          cliError("timed out waiting for viewer to bind", 1 /* GENERAL_ERROR */, {
+            name: "E_VIEWER_TIMEOUT"
+          });
+          return;
+        }
+        const url = slug ? `http://${status.host}:${status.port}/docs/${encodeURIComponent(slug)}` : `http://${status.host}:${status.port}/`;
         if (!args["no-launch"]) {
           openInBrowser(url);
         }
@@ -47435,9 +47410,9 @@ var init_docs_viewer = __esm({
           {
             opened: true,
             slug: slug ?? null,
-            pid: record.pid,
-            port: record.port,
-            host: record.host,
+            pid: status.pid,
+            port: status.port,
+            host: status.host,
             url
           },
           {
@@ -47451,7 +47426,7 @@ var init_docs_viewer = __esm({
     stopCommand4 = defineCommand({
       meta: {
         name: "stop",
-        description: "[legacy] Stop the docs viewer \u2014 prefer `cleo docs viewer stop`"
+        description: "Stop the docs viewer \u2014 prefer `cleo docs viewer stop`"
       },
       args: {
         timeout: {
@@ -47485,38 +47460,29 @@ var init_docs_viewer = __esm({
           );
           return;
         }
-        try {
-          process.kill(record.pid, "SIGTERM");
-        } catch (err) {
-          const e = err;
-          if (e.code !== "ESRCH") {
-            cliError(
-              `failed to signal viewer pid ${record.pid}: ${e.message ?? e.code}`,
-              1 /* GENERAL_ERROR */,
-              { name: "E_SIGNAL_FAILED" }
-            );
-            return;
-          }
-        }
+        const { pidFile } = getViewerPaths();
+        const subsystem = createDocsViewerSubsystem({
+          startPort: record.port,
+          host: record.host
+        });
+        await subsystem.shutdown({
+          pid: record.pid,
+          pidFile,
+          port: record.port,
+          host: record.host
+        });
         const timeoutSec = Math.max(1, Number.parseInt(String(args.timeout), 10) || 10);
-        const exited = await waitForExit(record.pid, timeoutSec * 1e3);
-        if (!exited) {
-          try {
-            process.kill(record.pid, "SIGKILL");
-          } catch {
-          }
-        }
-        await removeViewerPidFile();
         cliOutput(
           {
             stopped: true,
             pid: record.pid,
-            graceful: exited
+            graceful: true,
+            timeoutSec
           },
           {
             command: "docs stop",
             operation: "docs.stop",
-            message: exited ? `viewer (pid ${record.pid}) stopped gracefully` : `viewer (pid ${record.pid}) force-killed after ${timeoutSec}s`
+            message: `viewer (pid ${record.pid}) stopped`
           }
         );
       }
@@ -47524,15 +47490,15 @@ var init_docs_viewer = __esm({
     viewerStatusCommand = defineCommand({
       meta: {
         name: "viewer-status",
-        description: "[legacy] Report viewer state \u2014 prefer `cleo docs viewer status`"
+        description: "Report viewer state \u2014 prefer `cleo docs viewer status`"
       },
       async run() {
         await runViewerStatus();
       }
     });
     runViewerStatus = async () => {
-      const record = await readViewerPidFile();
-      if (!record) {
+      const status = await getViewerStatus();
+      if (!status.running || status.pid === null) {
         cliOutput(
           { running: false, pidFile: viewerPidFilePath() },
           {
@@ -47543,40 +47509,19 @@ var init_docs_viewer = __esm({
         );
         return;
       }
-      const alive = isProcessAlive(record.pid);
-      if (!alive) {
-        await removeViewerPidFile();
-        cliOutput(
-          {
-            running: false,
-            reason: "stale pidfile",
-            pid: record.pid,
-            pidFile: viewerPidFilePath()
-          },
-          {
-            command: "docs viewer-status",
-            operation: "docs.viewer-status",
-            message: `stale pidfile removed (pid ${record.pid} not alive)`
-          }
-        );
-        return;
-      }
       cliOutput(
         {
           running: true,
-          pid: record.pid,
-          port: record.port,
-          host: record.host,
-          projectRoot: record.projectRoot,
-          startedAt: record.startedAt,
-          uptimeMs: Date.now() - record.startedAt,
-          url: `http://${record.host}:${record.port}`,
+          pid: status.pid,
+          port: status.port,
+          host: status.host,
+          url: status.url,
           pidFile: viewerPidFilePath()
         },
         {
           command: "docs viewer-status",
           operation: "docs.viewer-status",
-          message: `viewer running (pid ${record.pid})`
+          message: `viewer running (pid ${status.pid})`
         }
       );
     };
@@ -47613,7 +47558,7 @@ __export(docs_exports, {
   _llmOutputCommand: () => _llmOutputCommand,
   docsCommand: () => docsCommand
 });
-import { appendFile, mkdir as mkdir2, readdir, readFile as readFile4, writeFile as writeFile2 } from "node:fs/promises";
+import { appendFile, mkdir as mkdir3, readdir, readFile as readFile4, writeFile as writeFile2 } from "node:fs/promises";
 import { dirname as dirname8, isAbsolute as isAbsolute2, join as join21, resolve as resolve5 } from "node:path";
 import { pushWarning as pushWarning3 } from "@cleocode/core";
 import {
@@ -47624,7 +47569,7 @@ import {
   DEFAULT_SIMILARITY_THRESHOLD,
   detectStrayCleoDb as detectStrayCleoDb2,
   getAgentOutputsAbsolute,
-  getProjectRoot as getProjectRoot38,
+  getProjectRoot as getProjectRoot37,
   readJson,
   resolveWorktreeFilePath,
   resolveWorktreeRouting as resolveWorktreeRouting4
@@ -47896,7 +47841,7 @@ var init_docs3 = __esm({
           resolvedFile = resolveWorktreeFilePath(String(fileArg), routing);
         }
         if (args.slug && args.type) {
-          const projectRoot = await getProjectRoot38();
+          const projectRoot = await getProjectRoot37();
           let warnThreshold = DEFAULT_SIMILARITY_THRESHOLD;
           let mode = DEFAULT_SIMILARITY_MODE;
           try {
@@ -47955,7 +47900,7 @@ var init_docs3 = __esm({
                 })}
 `;
                 try {
-                  await mkdir2(join21(projectRoot, ".cleo", "audit"), { recursive: true });
+                  await mkdir3(join21(projectRoot, ".cleo", "audit"), { recursive: true });
                   await appendFile(
                     join21(projectRoot, ".cleo", "audit", "similar-bypass.jsonl"),
                     auditLine,
@@ -48276,7 +48221,7 @@ var init_docs3 = __esm({
         const taskId = String(args.task);
         const includeAttachments = args["include-attachments"] !== false;
         const includeMemoryRefs = args["include-memory-refs"] === true;
-        const projectRoot = getProjectRoot38();
+        const projectRoot = getProjectRoot37();
         try {
           const result = await dispatchDocsRaw("query", "llm-output", {
             mode: "task-export",
@@ -48287,7 +48232,7 @@ var init_docs3 = __esm({
           let writtenPath;
           if (typeof args.out === "string" && args.out.length > 0) {
             const outPath = isAbsolute2(args.out) ? args.out : resolve5(projectRoot, args.out);
-            await mkdir2(dirname8(outPath), { recursive: true });
+            await mkdir3(dirname8(outPath), { recursive: true });
             await writeFile2(outPath, result.content, "utf8");
             writtenPath = outPath;
           }
@@ -48347,7 +48292,7 @@ var init_docs3 = __esm({
       },
       async run({ args }) {
         const forId = String(args.for);
-        const projectRoot = getProjectRoot38();
+        const projectRoot = getProjectRoot37();
         try {
           const result = await dispatchDocsRaw("query", "llm-output", {
             for: forId,
@@ -48359,7 +48304,7 @@ var init_docs3 = __esm({
           let writtenPath;
           if (typeof args.out === "string" && args.out.length > 0) {
             const outPath = isAbsolute2(args.out) ? args.out : resolve5(projectRoot, args.out);
-            await mkdir2(dirname8(outPath), { recursive: true });
+            await mkdir3(dirname8(outPath), { recursive: true });
             await writeFile2(outPath, result.content, "utf8");
             writtenPath = outPath;
           }
@@ -48424,7 +48369,7 @@ var init_docs3 = __esm({
       },
       async run({ args }) {
         const forId = String(args.for);
-        const projectRoot = getProjectRoot38();
+        const projectRoot = getProjectRoot37();
         try {
           const result = await dispatchDocsRaw("query", "llm-output", {
             for: forId,
@@ -48436,7 +48381,7 @@ var init_docs3 = __esm({
           let writtenPath;
           if (typeof args.out === "string" && args.out.length > 0) {
             const outPath = isAbsolute2(args.out) ? args.out : resolve5(projectRoot, args.out);
-            await mkdir2(dirname8(outPath), { recursive: true });
+            await mkdir3(dirname8(outPath), { recursive: true });
             await writeFile2(outPath, result.content, "utf8");
             writtenPath = outPath;
           }
@@ -48650,7 +48595,7 @@ var init_docs3 = __esm({
         }
       },
       async run({ args }) {
-        const projectRoot = getProjectRoot38();
+        const projectRoot = getProjectRoot37();
         const rawStrategy = args.strategy ?? "three-way";
         const strategy = rawStrategy === "cherry-pick" || rawStrategy === "multi-diff" ? rawStrategy : "three-way";
         try {
@@ -48662,7 +48607,7 @@ var init_docs3 = __esm({
           });
           if (typeof args.out === "string" && args.out.length > 0) {
             const outPath = isAbsolute2(args.out) ? args.out : resolve5(projectRoot, args.out);
-            await mkdir2(dirname8(outPath), { recursive: true });
+            await mkdir3(dirname8(outPath), { recursive: true });
             await writeFile2(outPath, result.merged, "utf8");
             humanInfo(`Wrote merged content to ${outPath}`);
           }
@@ -49420,7 +49365,7 @@ var init_docs3 = __esm({
         }
       },
       async run({ args }) {
-        const projectRoot = getProjectRoot38();
+        const projectRoot = getProjectRoot37();
         const dirArg = String(args.dir);
         const scanRoot = isAbsolute2(dirArg) ? dirArg : resolve5(projectRoot, dirArg);
         const dryRun = args["dry-run"] === true;
@@ -49434,7 +49379,7 @@ var init_docs3 = __esm({
           })}
 `;
           try {
-            await mkdir2(join21(projectRoot, ".cleo", "audit"), { recursive: true });
+            await mkdir3(join21(projectRoot, ".cleo", "audit"), { recursive: true });
             await appendFile(
               join21(projectRoot, ".cleo", "audit", "import-force-bypass.jsonl"),
               auditLine,
@@ -49482,7 +49427,7 @@ var init_docs3 = __esm({
         }
       },
       async run({ args }) {
-        const projectRoot = getProjectRoot38();
+        const projectRoot = getProjectRoot37();
         const { registry, configError } = loadCliRegistry(projectRoot);
         const kinds = registry.list().map(toWireKind);
         const extensionsCount = kinds.filter((k) => k.isExtension).length;
@@ -49537,7 +49482,7 @@ var init_docs3 = __esm({
           deprecated: "docs list-types",
           replacement: "docs schema"
         });
-        const projectRoot = getProjectRoot38();
+        const projectRoot = getProjectRoot37();
         const { registry, configError } = loadCliRegistry(projectRoot);
         const kinds = registry.list().map(toWireKind);
         const extensionsCount = kinds.filter((k) => k.isExtension).length;
@@ -49631,7 +49576,7 @@ var doctor_db_substrate_exports = {};
 __export(doctor_db_substrate_exports, {
   doctorDbSubstrateCommand: () => doctorDbSubstrateCommand
 });
-import { getProjectRoot as getProjectRoot39, pushWarning as pushWarning4 } from "@cleocode/core";
+import { getProjectRoot as getProjectRoot38, pushWarning as pushWarning4 } from "@cleocode/core";
 import { surveyDbSubstrate, surveyFleetDbSubstrate } from "@cleocode/core/doctor/db-substrate.js";
 function pushSubstrateWarnings(result) {
   for (const warning of result.warnings) {
@@ -49764,7 +49709,7 @@ var init_doctor_db_substrate = __esm({
         const result = isFleet ? surveyFleetDbSubstrate(
           typeof args["fleet-root"] === "string" && args["fleet-root"].length > 0 ? args["fleet-root"] : DEFAULT_FLEET_ROOT,
           options
-        ) : surveyDbSubstrate(getProjectRoot39(), options);
+        ) : surveyDbSubstrate(getProjectRoot38(), options);
         pushSubstrateWarnings(result);
         pushPerDbWarnings(result);
         cliOutput(result, {
@@ -49784,7 +49729,7 @@ var doctor_legacy_backups_exports = {};
 __export(doctor_legacy_backups_exports, {
   doctorLegacyBackupsCommand: () => doctorLegacyBackupsCommand
 });
-import { getProjectRoot as getProjectRoot40 } from "@cleocode/core";
+import { getProjectRoot as getProjectRoot39 } from "@cleocode/core";
 import { pruneLegacyBackups, scanLegacyBackups } from "@cleocode/core/doctor/legacy-backups.js";
 function parsePositiveInt(raw, fallback) {
   if (raw === void 0 || raw === null) return fallback;
@@ -49828,7 +49773,7 @@ var init_doctor_legacy_backups = __esm({
       async run({ args }) {
         const softRetentionDays = parsePositiveInt(args["soft-retention-days"], 30);
         const hardRetentionDays = parsePositiveInt(args["hard-retention-days"], 90);
-        const projectRoot = getProjectRoot40();
+        const projectRoot = getProjectRoot39();
         let result;
         if (args.prune === true) {
           const dryRun = args["dry-run"] !== false;
@@ -50395,7 +50340,7 @@ __export(migrate_agents_v2_exports, {
 import { createHash as createHash2 } from "node:crypto";
 import { appendFileSync as appendFileSync2, existsSync as existsSync14, mkdirSync as mkdirSync3, readdirSync as readdirSync2, readFileSync as readFileSync13 } from "node:fs";
 import { join as join23 } from "node:path";
-import { getProjectRoot as getProjectRoot41, installAgentFromCant } from "@cleocode/core/internal";
+import { getProjectRoot as getProjectRoot40, installAgentFromCant } from "@cleocode/core/internal";
 import { openCleoDb as openCleoDb2 } from "@cleocode/core/store/open-cleo-db";
 function sha256Hex(bytes) {
   return createHash2("sha256").update(bytes).digest("hex");
@@ -50582,7 +50527,7 @@ var init_migrate_agents_v2 = __esm({
         }
       },
       async run({ args }) {
-        const projectRoot = getProjectRoot41();
+        const projectRoot = getProjectRoot40();
         const verbose = args.quiet !== true;
         if (verbose) {
           humanInfo("Scanning .cleo/cant/agents/ and .cleo/agents/ for unregistered agents...");
@@ -50626,7 +50571,7 @@ __export(doctor_exports, {
 });
 import { mkdirSync as mkdirSync4, writeFileSync as writeFileSync4 } from "node:fs";
 import { join as join24 } from "node:path";
-import { getProjectRoot as getProjectRoot42, pushWarning as pushWarning5 } from "@cleocode/core";
+import { getProjectRoot as getProjectRoot41, pushWarning as pushWarning5 } from "@cleocode/core";
 import { renderInvariantAuditLines } from "@cleocode/core/doctor/invariant-audit-render.js";
 import {
   quarantineRogueCleoDir,
@@ -50899,9 +50844,18 @@ var init_doctor = __esm({
           type: "boolean",
           description: "Migrate <root>/.cleo/worktree-include (legacy) \u2192 <root>/.worktreeinclude (canonical, T9983). Combine with --dry-run to preview."
         },
+        /**
+         * T11489 — DHQ-037/019: detect and auto-heal a leaked `core.worktree` key
+         * in the shared `.git/config`. Reports E_WT_CONFIG_LEAK when found; heals
+         * automatically unless `--dry-run` is passed.
+         */
+        "check-worktree-config": {
+          type: "boolean",
+          description: "Detect and auto-heal a leaked core.worktree key in .git/config (T11489 / DHQ-037). Combine with --dry-run to report without healing."
+        },
         "dry-run": {
           type: "boolean",
-          description: "With --quarantine-rogue-cleo-dirs or --scan-stray-nexus-dbs: print what would be done without acting"
+          description: "With --quarantine-rogue-cleo-dirs, --scan-stray-nexus-dbs, or --check-worktree-config: print what would be done without acting"
         },
         /**
          * Show brain.db health dashboard (T1908 / BBTT-W2-4).
@@ -50951,9 +50905,64 @@ var init_doctor = __esm({
         const progress = createDoctorProgress(isHuman);
         progress.start();
         try {
+          if (args["check-worktree-config"]) {
+            const { execFileSync: execFile2 } = await import("node:child_process");
+            const { join: pathJoin } = await import("node:path");
+            const { existsSync: existsSync21 } = await import("node:fs");
+            const { detectAndHealCoreWorktreeLeak } = await import("@cleocode/worktree");
+            const projectRoot = getProjectRoot41();
+            let gitRoot = projectRoot;
+            try {
+              gitRoot = execFile2("git", ["rev-parse", "--show-toplevel"], {
+                cwd: projectRoot,
+                encoding: "utf-8",
+                stdio: ["pipe", "pipe", "pipe"]
+              }).trim();
+            } catch {
+            }
+            const isDryRun = args["dry-run"] === true;
+            progress.step(0, "Checking for leaked core.worktree in .git/config");
+            if (isDryRun) {
+              const gitConfigPath = pathJoin(gitRoot, ".git", "config");
+              let leakedValue;
+              if (existsSync21(gitConfigPath)) {
+                try {
+                  leakedValue = execFile2("git", ["config", "--file", gitConfigPath, "--get", "core.worktree"], {
+                    encoding: "utf-8",
+                    stdio: ["pipe", "pipe", "pipe"]
+                  }).trim() || void 0;
+                } catch {
+                }
+              }
+              const report = {
+                gitRoot,
+                gitConfigPath,
+                leakDetected: !!leakedValue,
+                leakedValue,
+                healed: false,
+                dryRun: true,
+                message: leakedValue ? `DRY-RUN: core.worktree="${leakedValue}" found \u2014 would unset` : "No core.worktree leak detected"
+              };
+              progress.complete(report.message);
+              cliOutput(report, { command: "doctor", operation: "doctor.check-worktree-config" });
+              if (leakedValue) process.exitCode = 2;
+            } else {
+              const result = detectAndHealCoreWorktreeLeak(gitRoot);
+              const report = {
+                gitRoot,
+                ...result,
+                dryRun: false,
+                message: result.leakDetected ? result.healed ? `E_WT_CONFIG_LEAK healed: removed core.worktree="${result.leakedValue}"` : `E_WT_CONFIG_LEAK detected but heal FAILED: ${result.healError}` : "No core.worktree leak detected"
+              };
+              progress.complete(report.message);
+              cliOutput(report, { command: "doctor", operation: "doctor.check-worktree-config" });
+              if (result.leakDetected && !result.healed) process.exitCode = 1;
+            }
+            return;
+          }
           if (args.brain) {
             const { computeBrainHealthDashboard } = await import("@cleocode/core/memory/brain-health-dashboard.js");
-            const projectRoot = getProjectRoot42();
+            const projectRoot = getProjectRoot41();
             const dashboard = await computeBrainHealthDashboard(projectRoot);
             cliOutput(dashboard, { command: "doctor", operation: "doctor.brain" });
             if (dashboard.hasP0Failure) {
@@ -50962,7 +50971,7 @@ var init_doctor = __esm({
             return;
           }
           if (args["scan-test-fixtures-in-prod"]) {
-            const projectRoot = getProjectRoot42();
+            const projectRoot = getProjectRoot41();
             const matches = await scanTestFixturesInProd(projectRoot);
             const dryRun = args["dry-run"] !== false && args.quarantine !== true;
             const quarantined = !dryRun && matches.length > 0 ? await quarantineTestFixtures(projectRoot, matches) : void 0;
@@ -51050,7 +51059,7 @@ var init_doctor = __esm({
             progress.complete("Comprehensive diagnostics complete");
           } else if (args["scan-rogue-cleo-dirs"]) {
             progress.step(0, "Scanning for rogue .cleo/ directories");
-            const projectRoot = getProjectRoot42();
+            const projectRoot = getProjectRoot41();
             const reports = scanRogueCleoDirs(projectRoot);
             progress.complete(
               `Found ${reports.length} rogue .cleo/ director${reports.length === 1 ? "y" : "ies"}`
@@ -51059,7 +51068,7 @@ var init_doctor = __esm({
           } else if (args["quarantine-rogue-cleo-dirs"]) {
             const isDryRun = args["dry-run"] === true;
             progress.step(0, `${isDryRun ? "[DRY RUN] " : ""}Scanning for rogue .cleo/ directories`);
-            const projectRoot = getProjectRoot42();
+            const projectRoot = getProjectRoot41();
             const reports = scanRogueCleoDirs(projectRoot);
             if (reports.length === 0) {
               progress.complete("No rogue .cleo/ directories found \u2014 nothing to quarantine");
@@ -51113,7 +51122,7 @@ var init_doctor = __esm({
             const { detectAndRemoveLegacyGlobalFiles, detectAndRemoveStrayProjectNexus } = await import("@cleocode/core/store/cleanup-legacy.js");
             const { getCleoHome: getCleoHome6 } = await import("@cleocode/core");
             const cleoHome = getCleoHome6();
-            const projectRoot = getProjectRoot42();
+            const projectRoot = getProjectRoot41();
             const legacyResult = detectAndRemoveLegacyGlobalFiles(cleoHome);
             const strayResult = detectAndRemoveStrayProjectNexus(projectRoot);
             const isDryRun = args["dry-run"] === true;
@@ -51146,7 +51155,7 @@ var init_doctor = __esm({
           } else if (args["audit-worktree-orphans"]) {
             progress.step(0, "Comprehensive worktree anomaly audit (T9808 / council D009)");
             const { auditWorktreeOrphansComprehensive, scanWorktreeOrphansBudgeted } = await import("@cleocode/core/doctor/worktree-orphans.js");
-            const projectRoot = getProjectRoot42();
+            const projectRoot = getProjectRoot41();
             const timeoutSecs = args["timeout"] !== void 0 ? Number.parseInt(String(args["timeout"]), 10) : 30;
             const timeoutMs = Number.isFinite(timeoutSecs) && timeoutSecs > 0 ? timeoutSecs * 1e3 : 3e4;
             const maxEntriesPerLevel = args["max-entries-per-level"] !== void 0 ? Number.parseInt(String(args["max-entries-per-level"]), 10) : 500;
@@ -51203,7 +51212,7 @@ var init_doctor = __esm({
               `${isDryRun ? "[DRY RUN] " : ""}Scanning + pruning worktree-orphan .cleo/ directories`
             );
             const { pruneWorktreeOrphans, scanWorktreeOrphansBudgeted } = await import("@cleocode/core/doctor/worktree-orphans.js");
-            const projectRoot = getProjectRoot42();
+            const projectRoot = getProjectRoot41();
             const timeoutSecs = args["timeout"] !== void 0 ? Number.parseInt(String(args["timeout"]), 10) : 30;
             const timeoutMs = Number.isFinite(timeoutSecs) && timeoutSecs > 0 ? timeoutSecs * 1e3 : 3e4;
             const maxEntriesPerLevel = args["max-entries-per-level"] !== void 0 ? Number.parseInt(String(args["max-entries-per-level"]), 10) : 500;
@@ -51282,7 +51291,7 @@ var init_doctor = __esm({
               `${isDryRun ? "[DRY RUN] " : ""}Migrating .cleo/worktree-include \u2192 .worktreeinclude`
             );
             const { migrateWorktreeIncludeFile } = await import("@cleocode/core");
-            const projectRoot = getProjectRoot42();
+            const projectRoot = getProjectRoot41();
             const result = await migrateWorktreeIncludeFile(projectRoot, { dryRun: isDryRun });
             progress.complete(`Migration ${result.action}`);
             cliOutput(result, { command: "doctor", operation: "doctor.migrate-worktree-include" });
@@ -51301,7 +51310,7 @@ var init_doctor = __esm({
             const stepLabel = isFocusedAlias ? "Auditing Saga hierarchy for ADR-073 invariants" : "Walking central INVARIANTS_REGISTRY";
             progress.step(0, stepLabel);
             const { auditInvariantRegistry } = await import("@cleocode/core/doctor/invariant-audit.js");
-            const projectRoot = getProjectRoot42();
+            const projectRoot = getProjectRoot41();
             const result = await auditInvariantRegistry(projectRoot, { adrFilter });
             const operation = isFocusedAlias ? "doctor.audit-sagas" : "doctor.audit-invariants";
             const summary = `Invariant audit complete \u2014 ${result.totalCount} entries walked, ${result.errorCount} error / ${result.warningCount} warning / ${result.infoCount} info violation(s), ${result.notApplicableCount} not-applicable, ${result.documentedCount} documented`;
@@ -51323,7 +51332,7 @@ var init_doctor = __esm({
               { command: "doctor", operation: "admin.health" }
             );
             try {
-              const projectRoot = getProjectRoot42();
+              const projectRoot = getProjectRoot41();
               const conflicts = readMigrationConflicts(projectRoot);
               if (conflicts.length > 0) {
                 progress.complete(
@@ -51354,7 +51363,7 @@ var init_doctor = __esm({
               progress.complete("Health check complete");
             }
             try {
-              const projectRoot = getProjectRoot42();
+              const projectRoot = getProjectRoot41();
               const { auditSagaHierarchy } = await import("@cleocode/core/doctor/saga-audit.js");
               const sagaAudit = await auditSagaHierarchy(projectRoot);
               if (sagaAudit.sagas.length === 0) {
@@ -52522,6 +52531,48 @@ var init_gc = __esm({
   }
 });
 
+// packages/cleo/src/cli/commands/go.ts
+var go_exports = {};
+__export(go_exports, {
+  goCommand: () => goCommand
+});
+import { getProjectRoot as getProjectRoot42, go } from "@cleocode/core";
+var goCommand;
+var init_go = __esm({
+  "packages/cleo/src/cli/commands/go.ts"() {
+    "use strict";
+    init_define_cli_command();
+    init_renderers();
+    goCommand = defineCommand({
+      meta: {
+        name: "go",
+        description: "SG-AUTOPILOT: run one turn of briefing\u2192sagaNext\u2192ready\u2192stage-branch\u2192ivtr loop"
+      },
+      args: {
+        saga: {
+          type: "string",
+          description: "Optional saga task ID to scope the autopilot run (default: auto-select)",
+          required: false
+        },
+        headless: {
+          type: "boolean",
+          description: "Suppress interactive annotations; suitable for daemon / unattended use",
+          required: false
+        }
+      },
+      async run({ args }) {
+        const projectRoot = getProjectRoot42();
+        const result = await go.cleoGo({
+          sagaId: typeof args.saga === "string" && args.saga.length > 0 ? args.saga : void 0,
+          headless: args.headless === true,
+          projectRoot
+        });
+        cliOutput(result.success ? result.data : result, { command: "go", operation: "go.run" });
+      }
+    });
+  }
+});
+
 // packages/cleo/src/cli/commands/goal.ts
 var goal_exports = {};
 __export(goal_exports, {
@@ -52541,7 +52592,7 @@ function resolveTurnBudget(turns) {
   const n = typeof turns === "string" ? Number.parseInt(turns, 10) : Number(turns);
   return Number.isInteger(n) && n > 0 ? n : DEFAULT_TURN_BUDGET;
 }
-var DEFAULT_TURN_BUDGET, setCommand, statusCommand9, subgoalCommand, appendCommand, goalCommand;
+var DEFAULT_TURN_BUDGET, setCommand, statusCommand9, subgoalCommand, advanceCommand2, appendCommand, goalCommand;
 var init_goal2 = __esm({
   "packages/cleo/src/cli/commands/goal.ts"() {
     "use strict";
@@ -52636,6 +52687,34 @@ var init_goal2 = __esm({
         cliOutput(record, { command: "goal subgoal", operation: "goal.subgoal" });
       }
     });
+    advanceCommand2 = defineCommand({
+      meta: {
+        name: "advance",
+        description: "Advance a goal one turn (load \u2192 judge \u2192 persist \u2192 continuation). Entry point for the Stop-hook loop."
+      },
+      args: {
+        goalId: {
+          type: "positional",
+          description: "The goal id (idempotency key) to advance"
+        }
+      },
+      async run({ args }) {
+        const goalId = String(args.goalId ?? "").trim();
+        if (goalId.length === 0) {
+          cliError("goal advance requires a <goalId>", 6 /* VALIDATION_ERROR */, {
+            name: "E_VALIDATION"
+          });
+          return;
+        }
+        const cwd = getProjectRoot43();
+        const result = await goal.advanceGoalWithPersist(goalId, { cwd });
+        if (!result) {
+          cliError(`Goal '${goalId}' not found.`, 4 /* NOT_FOUND */, { name: "E_NOT_FOUND" });
+          return;
+        }
+        cliOutput(result, { command: "goal advance", operation: "goal.advance" });
+      }
+    });
     appendCommand = defineCommand({
       meta: {
         name: "append",
@@ -52671,11 +52750,12 @@ var init_goal2 = __esm({
     goalCommand = defineCommand({
       meta: {
         name: "goal",
-        description: "DB-persisted, per-agent, evidence-gate-aware goal loop (set/status/subgoal/append)."
+        description: "DB-persisted, per-agent, evidence-gate-aware goal loop (set/status/advance/subgoal/append)."
       },
       subCommands: {
         set: setCommand,
         status: statusCommand9,
+        advance: advanceCommand2,
         subgoal: subgoalCommand,
         append: appendCommand
       },
@@ -53842,7 +53922,7 @@ __export(init_exports, {
 });
 import { existsSync as existsSync15, readFileSync as readFileSync14 } from "node:fs";
 import { join as join27 } from "node:path";
-import { fileURLToPath as fileURLToPath6 } from "node:url";
+import { fileURLToPath as fileURLToPath5 } from "node:url";
 import {
   CleoError as CleoError5,
   getWorkflowTemplatesDir as getCoreWorkflowTemplatesDir,
@@ -53853,7 +53933,7 @@ import {
 import { getTemplatesByKind } from "@cleocode/core/templates/registry";
 function getGitignoreTemplate() {
   try {
-    const thisFile = fileURLToPath6(import.meta.url);
+    const thisFile = fileURLToPath5(import.meta.url);
     const packageRoot = join27(thisFile, "..", "..", "..", "..");
     const localTemplatePath = join27(packageRoot, "templates", "cleo-gitignore");
     const monorepoTemplatePath = join27(packageRoot, "..", "..", "templates", "cleo-gitignore");
@@ -58481,7 +58561,7 @@ var nexus_exports = {};
 __export(nexus_exports, {
   nexusCommand: () => nexusCommand
 });
-import { appendFile as appendFile2, mkdir as mkdir3 } from "node:fs/promises";
+import { appendFile as appendFile2, mkdir as mkdir4 } from "node:fs/promises";
 import { homedir as homedir5 } from "node:os";
 import path4 from "node:path";
 import { getProjectRoot as getProjectRoot48 } from "@cleocode/core";
@@ -58493,7 +58573,7 @@ async function appendDeprecationTelemetry(op, replacement) {
   try {
     const dateStr = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
     const dir = path4.join(homedir5(), ".local", "state", "cleo", "nexus-deprecation");
-    await mkdir3(dir, { recursive: true });
+    await mkdir4(dir, { recursive: true });
     const record = JSON.stringify({ ts: (/* @__PURE__ */ new Date()).toISOString(), op, replacement }) + "\n";
     await appendFile2(path4.join(dir, `${dateStr}.jsonl`), record, "utf8");
   } catch {
@@ -62168,7 +62248,7 @@ var phase_exports = {};
 __export(phase_exports, {
   phaseCommand: () => phaseCommand
 });
-var showCommand10, listCommand15, setCommand2, startCommand6, completeCommand3, advanceCommand2, renameCommand, deleteCommand2, phaseCommand;
+var showCommand10, listCommand15, setCommand2, startCommand6, completeCommand3, advanceCommand3, renameCommand, deleteCommand2, phaseCommand;
 var init_phase = __esm({
   "packages/cleo/src/cli/commands/phase.ts"() {
     "use strict";
@@ -62268,7 +62348,7 @@ var init_phase = __esm({
         );
       }
     });
-    advanceCommand2 = defineCommand({
+    advanceCommand3 = defineCommand({
       meta: { name: "advance", description: "Complete current phase and start next" },
       args: {
         force: {
@@ -62350,7 +62430,7 @@ var init_phase = __esm({
         set: setCommand2,
         start: startCommand6,
         complete: completeCommand3,
-        advance: advanceCommand2,
+        advance: advanceCommand3,
         rename: renameCommand,
         delete: deleteCommand2
       },
@@ -65609,7 +65689,7 @@ __export(saga_exports, {
   sagaCommand: () => sagaCommand
 });
 import { parseAcceptanceCriteria } from "@cleocode/core";
-var createCommand3, addCommand12, detachCommand2, listCommand22, membersCommand, repairCommand, reconcileCommand5, rollupCommand2, sagaCommand;
+var createCommand3, addCommand12, detachCommand2, listCommand22, membersCommand, repairCommand, reconcileCommand5, rollupCommand2, nextCommand3, sagaCommand;
 var init_saga = __esm({
   "packages/cleo/src/cli/commands/saga.ts"() {
     "use strict";
@@ -65820,6 +65900,26 @@ var init_saga = __esm({
         cliOutput(response.data ?? {}, { command: "saga", operation: "tasks.saga.rollup" });
       }
     });
+    nextCommand3 = defineCommand({
+      meta: {
+        name: "next",
+        description: "Return the next actionable Saga and its ready-frontier task IDs"
+      },
+      args: {
+        sagaId: {
+          type: "positional",
+          description: "Optional saga task ID. Omit to auto-select from canonical order.",
+          required: false
+        }
+      },
+      async run({ args }) {
+        const { sagas: sagas2, getProjectRoot: getProjectRoot57 } = await import("@cleocode/core");
+        const projectRoot = getProjectRoot57();
+        const sagaId = typeof args.sagaId === "string" && args.sagaId.length > 0 ? args.sagaId : void 0;
+        const result = await sagas2.sagaNext(projectRoot, { sagaId });
+        cliOutput(result.success ? result.data : result, { command: "saga", operation: "saga.next" });
+      }
+    });
     sagaCommand = defineCommand({
       meta: {
         name: "saga",
@@ -65833,7 +65933,8 @@ var init_saga = __esm({
         members: membersCommand,
         rollup: rollupCommand2,
         repair: repairCommand,
-        reconcile: reconcileCommand5
+        reconcile: reconcileCommand5,
+        next: nextCommand3
       },
       async run({ cmd, rawArgs }) {
         const firstArg = rawArgs?.find((a) => !a.startsWith("-"));
@@ -66075,7 +66176,7 @@ async function writeRuntimeVersionMetadata(mode, source, version) {
     `installed=${(/* @__PURE__ */ new Date()).toISOString()}`
   ];
   await import("node:fs/promises").then(
-    ({ writeFile: writeFile4, mkdir: mkdir5 }) => mkdir5(cleoHome, { recursive: true }).then(
+    ({ writeFile: writeFile4, mkdir: mkdir6 }) => mkdir6(cleoHome, { recursive: true }).then(
       () => writeFile4(join29(cleoHome, "VERSION"), `${lines.join("\n")}
 `, "utf-8")
     )
@@ -72919,15 +73020,12 @@ var init_verify = __esm({
   }
 });
 
-// packages/cleo/src/cli/commands/web.ts
-var web_exports = {};
-__export(web_exports, {
-  webCommand: () => webCommand
-});
+// packages/cleo/src/cli/web-subsystem.ts
 import { execFileSync as execFileSync4, spawn as spawn3 } from "node:child_process";
-import { mkdir as mkdir4, open, readFile as readFile8, rm, stat as stat2, writeFile as writeFile3 } from "node:fs/promises";
+import { mkdir as mkdir5, open, readFile as readFile8, rm, stat as stat2, writeFile as writeFile3 } from "node:fs/promises";
 import { join as join35 } from "node:path";
-import { CleoError as CleoError12, formatError as formatError5, getCleoHome as getCleoHome5 } from "@cleocode/core";
+import { getCleoHome as getCleoHome5 } from "@cleocode/core";
+import { defineSubsystem as defineSubsystem2 } from "@cleocode/runtime/daemon";
 function getWebPaths() {
   const cleoHome = getCleoHome5();
   return {
@@ -72937,7 +73035,7 @@ function getWebPaths() {
     logFile: join35(cleoHome, "logs", "web-server.log")
   };
 }
-function isProcessRunning(pid) {
+function isWebProcessRunning(pid) {
   try {
     process.kill(pid, 0);
     return true;
@@ -72945,20 +73043,20 @@ function isProcessRunning(pid) {
     return false;
   }
 }
-async function getStatus() {
+async function getWebStatus() {
   const { pidFile, configFile } = getWebPaths();
   try {
     const pidStr = (await readFile8(pidFile, "utf-8")).trim();
     const pid = Number.parseInt(pidStr, 10);
-    if (Number.isNaN(pid) || !isProcessRunning(pid)) {
+    if (Number.isNaN(pid) || !isWebProcessRunning(pid)) {
       return { running: false, pid: null, port: null, host: null, url: null };
     }
-    let port = DEFAULT_PORT;
-    let host = DEFAULT_HOST;
+    let port = WEB_DEFAULT_PORT;
+    let host = WEB_DEFAULT_HOST;
     try {
       const config = JSON.parse(await readFile8(configFile, "utf-8"));
-      port = config.port ?? DEFAULT_PORT;
-      host = config.host ?? DEFAULT_HOST;
+      port = config.port ?? WEB_DEFAULT_PORT;
+      host = config.host ?? WEB_DEFAULT_HOST;
     } catch {
     }
     return { running: true, pid, port, host, url: `http://${host}:${port}` };
@@ -72966,118 +73064,212 @@ async function getStatus() {
     return { running: false, pid: null, port: null, host: null, url: null };
   }
 }
-async function startWebServer(port, host) {
-  const { pidFile, configFile, logFile, logDir } = getWebPaths();
-  const status = await getStatus();
-  if (status.running) {
-    throw new CleoError12(1 /* GENERAL_ERROR */, `Server already running (PID: ${status.pid})`);
-  }
-  const projectRoot = process.env["CLEO_ROOT"] ?? process.cwd();
-  const studioDir = process.env["CLEO_STUDIO_DIR"] ?? join35(projectRoot, "packages", "studio", "build");
-  await mkdir4(logDir, { recursive: true });
-  await writeFile3(
-    configFile,
-    JSON.stringify({
-      port,
-      host,
-      startedAt: (/* @__PURE__ */ new Date()).toISOString()
-    })
-  );
-  const webIndexPath = join35(studioDir, "index.js");
-  try {
-    await stat2(webIndexPath);
-  } catch {
-    try {
-      execFileSync4("pnpm", ["--filter", "@cleocode/studio", "run", "build"], {
-        cwd: projectRoot,
-        stdio: "ignore"
-      });
-    } catch {
-      throw new CleoError12(
-        1 /* GENERAL_ERROR */,
-        `Studio build failed. Run: pnpm --filter @cleocode/studio run build
-Logs: ${logFile}`
+function createWebSubsystem(opts = {}) {
+  const port = opts.port ?? WEB_DEFAULT_PORT;
+  const host = opts.host ?? WEB_DEFAULT_HOST;
+  let live;
+  return defineSubsystem2({
+    name: WEB_SUBSYSTEM_NAME,
+    async start() {
+      const { pidFile, configFile, logFile, logDir } = getWebPaths();
+      const existing = await getWebStatus();
+      if (existing.running && existing.pid !== null) {
+        const ctx2 = {
+          pid: existing.pid,
+          pidFile,
+          logFile,
+          port: existing.port ?? port,
+          host: existing.host ?? host
+        };
+        live = ctx2;
+        return ctx2;
+      }
+      const projectRoot = process.env["CLEO_ROOT"] ?? process.cwd();
+      const studioDir = process.env["CLEO_STUDIO_DIR"] ?? join35(projectRoot, "packages", "studio", "build");
+      const webIndexPath = join35(studioDir, "index.js");
+      await mkdir5(logDir, { recursive: true });
+      await writeFile3(
+        configFile,
+        JSON.stringify({ port, host, startedAt: (/* @__PURE__ */ new Date()).toISOString() })
       );
-    }
-  }
-  const logFileHandle = await open(logFile, "a");
-  const serverProcess = spawn3("node", [webIndexPath], {
-    cwd: studioDir,
-    env: {
-      ...process.env,
-      HOST: host,
-      PORT: String(port),
-      // Pass CLEO paths through to the studio server
-      CLEO_ROOT: projectRoot
+      try {
+        await stat2(webIndexPath);
+      } catch {
+        try {
+          execFileSync4("pnpm", ["--filter", "@cleocode/studio", "run", "build"], {
+            cwd: projectRoot,
+            stdio: "ignore"
+          });
+        } catch {
+          throw new Error(
+            `Studio build failed. Run: pnpm --filter @cleocode/studio run build
+Logs: ${logFile}`
+          );
+        }
+      }
+      const logFileHandle = await open(logFile, "a");
+      const serverProcess = spawn3("node", [webIndexPath], {
+        cwd: studioDir,
+        env: {
+          ...process.env,
+          HOST: host,
+          PORT: String(port),
+          CLEO_ROOT: projectRoot
+        },
+        detached: true,
+        stdio: ["ignore", logFileHandle.fd, logFileHandle.fd]
+      });
+      serverProcess.unref();
+      const pidFileTmp = `${pidFile}.tmp`;
+      await writeFile3(pidFileTmp, String(serverProcess.pid));
+      await rm(pidFile, { force: true });
+      await writeFile3(pidFile, String(serverProcess.pid));
+      await rm(pidFileTmp, { force: true });
+      await logFileHandle.close();
+      let started = false;
+      for (let i = 0; i < STARTUP_POLL_ITERATIONS; i++) {
+        try {
+          const response = await fetch(`http://${host}:${port}/api/health`);
+          if (response.ok) {
+            started = true;
+            break;
+          }
+        } catch {
+        }
+        await new Promise((resolve11) => setTimeout(resolve11, 500));
+      }
+      if (!started) {
+        try {
+          process.kill(serverProcess.pid, "SIGTERM");
+        } catch {
+        }
+        await rm(pidFile, { force: true });
+        throw new Error("Studio web server failed to start within 15 seconds");
+      }
+      const ctx = {
+        pid: serverProcess.pid,
+        pidFile,
+        logFile,
+        port,
+        host
+      };
+      live = ctx;
+      return ctx;
     },
-    detached: true,
-    stdio: ["ignore", logFileHandle.fd, logFileHandle.fd]
-  });
-  serverProcess.unref();
-  const pidFileTmp = `${pidFile}.tmp`;
-  await writeFile3(pidFileTmp, String(serverProcess.pid));
-  await rm(pidFile, { force: true });
-  await writeFile3(pidFile, String(serverProcess.pid));
-  await rm(pidFileTmp, { force: true });
-  await logFileHandle.close();
-  const maxAttempts = 30;
-  let started = false;
-  for (let i = 0; i < maxAttempts; i++) {
-    try {
-      const response = await fetch(`http://${host}:${port}/api/health`);
-      if (response.ok) {
-        started = true;
-        break;
+    healthProbe() {
+      if (live === void 0) {
+        const stopped = "stopped";
+        return {
+          child_id: WEB_SUBSYSTEM_NAME,
+          pid: 0,
+          state: stopped,
+          restart_count: 0,
+          detail: "not started"
+        };
       }
-    } catch {
-    }
-    await new Promise((resolve11) => setTimeout(resolve11, 500));
-  }
-  if (!started) {
-    try {
-      process.kill(serverProcess.pid);
-    } catch {
-    }
-    await rm(pidFile, { force: true });
-    throw new CleoError12(1 /* GENERAL_ERROR */, "Server failed to start within 15 seconds");
-  }
-  cliOutput(
-    {
-      pid: serverProcess.pid,
-      port,
-      host,
-      url: `http://${host}:${port}`,
-      logFile
+      const alive = isWebProcessRunning(live.pid);
+      const state = alive ? "running" : "stopped";
+      return {
+        child_id: WEB_SUBSYSTEM_NAME,
+        pid: alive ? live.pid : 0,
+        state,
+        restart_count: 0,
+        detail: alive ? `url=http://${live.host}:${live.port} pid=${live.pid}` : `pid=${live.pid} exited`
+      };
     },
-    { command: "web", message: `CLEO Web UI running on port ${port}` }
-  );
+    async shutdown(context) {
+      const { pidFile } = context;
+      if (!isWebProcessRunning(context.pid)) {
+        await rm(pidFile, { force: true });
+        live = void 0;
+        return;
+      }
+      try {
+        if (process.platform === "win32") {
+          spawn3("taskkill", ["/PID", String(context.pid), "/T"], { stdio: "ignore" });
+        } else {
+          process.kill(context.pid, "SIGTERM");
+        }
+      } catch {
+      }
+      for (let i = 0; i < SIGTERM_GRACE_ITERATIONS2; i++) {
+        if (!isWebProcessRunning(context.pid)) break;
+        await new Promise((resolve11) => setTimeout(resolve11, 500));
+      }
+      if (isWebProcessRunning(context.pid)) {
+        try {
+          if (process.platform === "win32") {
+            spawn3("taskkill", ["/PID", String(context.pid), "/F", "/T"], { stdio: "ignore" });
+          } else {
+            process.kill(context.pid, "SIGKILL");
+          }
+        } catch {
+        }
+      }
+      await rm(pidFile, { force: true });
+      live = void 0;
+    }
+  });
 }
-var DEFAULT_PORT, DEFAULT_HOST, startCommand9, stopCommand6, restartCommand, statusCommand18, openCommand3, webCommand;
+var WEB_DEFAULT_PORT, WEB_DEFAULT_HOST, WEB_SUBSYSTEM_NAME, SIGTERM_GRACE_ITERATIONS2, STARTUP_POLL_ITERATIONS;
+var init_web_subsystem = __esm({
+  "packages/cleo/src/cli/web-subsystem.ts"() {
+    "use strict";
+    WEB_DEFAULT_PORT = 3456;
+    WEB_DEFAULT_HOST = "127.0.0.1";
+    WEB_SUBSYSTEM_NAME = "cleo-web";
+    SIGTERM_GRACE_ITERATIONS2 = 60;
+    STARTUP_POLL_ITERATIONS = 30;
+  }
+});
+
+// packages/cleo/src/cli/commands/web.ts
+var web_exports = {};
+__export(web_exports, {
+  webCommand: () => webCommand
+});
+import { spawn as spawn4 } from "node:child_process";
+import { rm as rm2 } from "node:fs/promises";
+import { CleoError as CleoError12, formatError as formatError5 } from "@cleocode/core";
+var startCommand9, stopCommand6, restartCommand, statusCommand18, openCommand3, webCommand;
 var init_web = __esm({
   "packages/cleo/src/cli/commands/web.ts"() {
     "use strict";
     init_src2();
     init_dist();
     init_renderers();
-    DEFAULT_PORT = 3456;
-    DEFAULT_HOST = "127.0.0.1";
+    init_web_subsystem();
     startCommand9 = defineCommand({
       meta: { name: "start", description: "Start the web server" },
       args: {
         port: {
           type: "string",
           description: "Server port",
-          default: String(DEFAULT_PORT)
+          default: String(WEB_DEFAULT_PORT)
         },
         host: {
           type: "string",
           description: "Server host",
-          default: DEFAULT_HOST
+          default: WEB_DEFAULT_HOST
         }
       },
       async run({ args }) {
         try {
-          await startWebServer(Number.parseInt(args.port, 10), args.host);
+          const port = Number.parseInt(args.port, 10);
+          const host = args.host;
+          const subsystem = createWebSubsystem({ port, host });
+          const ctx = await subsystem.start();
+          const { logFile } = getWebPaths();
+          cliOutput(
+            {
+              pid: ctx.pid,
+              port: ctx.port,
+              host: ctx.host,
+              url: `http://${ctx.host}:${ctx.port}`,
+              logFile
+            },
+            { command: "web", message: `CLEO Web UI running on port ${ctx.port}` }
+          );
         } catch (err) {
           if (err instanceof CleoError12) {
             console.error(formatError5(err));
@@ -73091,36 +73283,24 @@ var init_web = __esm({
       meta: { name: "stop", description: "Stop the web server" },
       async run() {
         try {
-          const { pidFile } = getWebPaths();
-          const status = await getStatus();
-          if (!status.running || !status.pid) {
-            await rm(pidFile, { force: true });
+          const { pidFile, logFile } = getWebPaths();
+          const status = await getWebStatus();
+          if (!status.running || status.pid === null) {
+            await rm2(pidFile, { force: true });
             cliOutput({ running: false }, { command: "web", message: "Server is not running" });
             return;
           }
-          try {
-            if (process.platform === "win32") {
-              spawn3("taskkill", ["/PID", String(status.pid), "/T"], { stdio: "ignore" });
-            } else {
-              process.kill(status.pid, "SIGTERM");
-            }
-          } catch {
-          }
-          for (let i = 0; i < 60; i++) {
-            if (!isProcessRunning(status.pid)) break;
-            await new Promise((resolve11) => setTimeout(resolve11, 500));
-          }
-          if (isProcessRunning(status.pid)) {
-            try {
-              if (process.platform === "win32") {
-                spawn3("taskkill", ["/PID", String(status.pid), "/F", "/T"], { stdio: "ignore" });
-              } else {
-                process.kill(status.pid, "SIGKILL");
-              }
-            } catch {
-            }
-          }
-          await rm(pidFile, { force: true });
+          const subsystem = createWebSubsystem({
+            port: status.port ?? WEB_DEFAULT_PORT,
+            host: status.host ?? WEB_DEFAULT_HOST
+          });
+          await subsystem.shutdown({
+            pid: status.pid,
+            pidFile,
+            logFile,
+            port: status.port ?? WEB_DEFAULT_PORT,
+            host: status.host ?? WEB_DEFAULT_HOST
+          });
           cliOutput({ stopped: true }, { command: "web", message: "CLEO Web UI stopped" });
         } catch (err) {
           if (err instanceof CleoError12) {
@@ -73137,44 +73317,45 @@ var init_web = __esm({
         port: {
           type: "string",
           description: "Server port",
-          default: String(DEFAULT_PORT)
+          default: String(WEB_DEFAULT_PORT)
         },
         host: {
           type: "string",
           description: "Server host",
-          default: DEFAULT_HOST
+          default: WEB_DEFAULT_HOST
         }
       },
       async run({ args }) {
         try {
-          const { pidFile } = getWebPaths();
-          const status = await getStatus();
-          if (status.running && status.pid) {
-            try {
-              if (process.platform === "win32") {
-                spawn3("taskkill", ["/PID", String(status.pid), "/T"], { stdio: "ignore" });
-              } else {
-                process.kill(status.pid, "SIGTERM");
-              }
-            } catch {
-            }
-            for (let i = 0; i < 60; i++) {
-              if (!isProcessRunning(status.pid)) break;
-              await new Promise((resolve11) => setTimeout(resolve11, 500));
-            }
-            if (isProcessRunning(status.pid)) {
-              try {
-                if (process.platform === "win32") {
-                  spawn3("taskkill", ["/PID", String(status.pid), "/F", "/T"], { stdio: "ignore" });
-                } else {
-                  process.kill(status.pid, "SIGKILL");
-                }
-              } catch {
-              }
-            }
-            await rm(pidFile, { force: true });
+          const port = Number.parseInt(args.port, 10);
+          const host = args.host;
+          const { pidFile, logFile } = getWebPaths();
+          const status = await getWebStatus();
+          if (status.running && status.pid !== null) {
+            const stopSubsystem = createWebSubsystem({
+              port: status.port ?? port,
+              host: status.host ?? host
+            });
+            await stopSubsystem.shutdown({
+              pid: status.pid,
+              pidFile,
+              logFile,
+              port: status.port ?? port,
+              host: status.host ?? host
+            });
           }
-          await startWebServer(Number.parseInt(args.port, 10), args.host);
+          const startSubsystem = createWebSubsystem({ port, host });
+          const ctx = await startSubsystem.start();
+          cliOutput(
+            {
+              pid: ctx.pid,
+              port: ctx.port,
+              host: ctx.host,
+              url: `http://${ctx.host}:${ctx.port}`,
+              logFile
+            },
+            { command: "web", message: `CLEO Web UI running on port ${ctx.port}` }
+          );
         } catch (err) {
           if (err instanceof CleoError12) {
             console.error(formatError5(err));
@@ -73188,7 +73369,7 @@ var init_web = __esm({
       meta: { name: "status", description: "Check server status" },
       async run() {
         try {
-          const status = await getStatus();
+          const status = await getWebStatus();
           cliOutput(status, { command: "web" });
         } catch (err) {
           if (err instanceof CleoError12) {
@@ -73203,7 +73384,7 @@ var init_web = __esm({
       meta: { name: "open", description: "Open browser to the UI" },
       async run() {
         try {
-          const status = await getStatus();
+          const status = await getWebStatus();
           if (!status.running || !status.url) {
             throw new CleoError12(
               1 /* GENERAL_ERROR */,
@@ -73214,11 +73395,11 @@ var init_web = __esm({
           const platform = process.platform;
           try {
             if (platform === "linux") {
-              spawn3("xdg-open", [url], { detached: true, stdio: "ignore" }).unref();
+              spawn4("xdg-open", [url], { detached: true, stdio: "ignore" }).unref();
             } else if (platform === "darwin") {
-              spawn3("open", [url], { detached: true, stdio: "ignore" }).unref();
+              spawn4("open", [url], { detached: true, stdio: "ignore" }).unref();
             } else if (platform === "win32") {
-              spawn3("cmd", ["/c", "start", "", url], { detached: true, stdio: "ignore" }).unref();
+              spawn4("cmd", ["/c", "start", "", url], { detached: true, stdio: "ignore" }).unref();
             }
           } catch {
           }
@@ -73257,7 +73438,7 @@ __export(workgraph_exports, {
 });
 import { readFileSync as readFileSync20 } from "node:fs";
 import { resolve as resolve10 } from "node:path";
-var validateCommand10, applyCommand, planCommand4, structureCommand, workgraphCommand;
+var validateCommand10, applyCommand, planCommand4, structureCommand, statusCommand19, workgraphCommand;
 var init_workgraph2 = __esm({
   "packages/cleo/src/cli/commands/workgraph.ts"() {
     "use strict";
@@ -73401,16 +73582,64 @@ var init_workgraph2 = __esm({
         cliOutput2(result, { command: "workgraph", operation: "structure" });
       }
     });
+    statusCommand19 = defineCommand({
+      meta: {
+        name: "status",
+        description: "One-shot saga-to-saga workgraph dashboard (tracking checklist)"
+      },
+      async run() {
+        const { sagas: sagas2, getProjectRoot: getProjectRoot57 } = await import("@cleocode/core");
+        const { cliOutput: cliOutput2 } = await Promise.resolve().then(() => (init_renderers(), renderers_exports));
+        const projectRoot = getProjectRoot57();
+        const listResult = await sagas2.sagaList(projectRoot);
+        if (!listResult.success) {
+          cliOutput2(listResult, { command: "workgraph", operation: "workgraph.status" });
+          return;
+        }
+        const allSagas = listResult.data?.sagas ?? [];
+        const sagaMap = new Map(
+          allSagas.map((s) => [s.id, s])
+        );
+        const TERMINAL = /* @__PURE__ */ new Set(["done", "cancelled", "deleted", "archived", "completed"]);
+        const rows = [];
+        for (let i = 0; i < sagas2.CANONICAL_SAGA_ORDER.length; i++) {
+          const [id, label] = sagas2.CANONICAL_SAGA_ORDER[i];
+          const saga = sagaMap.get(id);
+          if (!saga) continue;
+          const status = saga.status ?? "pending";
+          const rollupResult = await sagas2.sagaRollup(projectRoot, { sagaId: id });
+          const rollup = rollupResult.success ? rollupResult.data : { total: 0, done: 0, completionPct: 0 };
+          rows.push({
+            rank: i + 1,
+            sagaId: id,
+            status,
+            completionPct: rollup.completionPct ?? 0,
+            done: rollup.done ?? 0,
+            total: rollup.total ?? 0,
+            label: TERMINAL.has(status) ? `${label} \u2713` : label
+          });
+        }
+        cliOutput2(
+          {
+            rows,
+            total: rows.length,
+            activeSagaCount: rows.filter((r) => !TERMINAL.has(r.status)).length
+          },
+          { command: "workgraph", operation: "workgraph.status" }
+        );
+      }
+    });
     workgraphCommand = defineCommand({
       meta: {
         name: "workgraph",
-        description: "PM-Core V2 WorkGraph operations \u2014 validate, apply, plan, structure"
+        description: "PM-Core V2 WorkGraph operations \u2014 validate, apply, plan, structure, status"
       },
       subCommands: {
         validate: validateCommand10,
         apply: applyCommand,
         plan: planCommand4,
-        structure: structureCommand
+        structure: structureCommand,
+        status: statusCommand19
       },
       async run({ cmd, rawArgs }) {
         const firstArg = rawArgs?.find((a) => !a.startsWith("-"));
@@ -73775,7 +74004,7 @@ init_field_context();
 init_format_context();
 import { readFileSync as readFileSync21 } from "node:fs";
 import { dirname as dirname11, join as join37 } from "node:path";
-import { fileURLToPath as fileURLToPath7 } from "node:url";
+import { fileURLToPath as fileURLToPath6 } from "node:url";
 import { enforceNodeVersion } from "@cleocode/paths";
 
 // packages/cleo/src/cli/generated/command-manifest.ts
@@ -74176,10 +74405,16 @@ var COMMAND_MANIFEST = [
     description: "Transcript garbage collection: manual trigger and status",
     load: async () => (await Promise.resolve().then(() => (init_gc(), gc_exports))).gcCommand
   },
+  {
+    exportName: "goCommand",
+    name: "go",
+    description: "SG-AUTOPILOT: run one turn of briefing\u2192sagaNext\u2192ready\u2192stage-branch\u2192ivtr loop",
+    load: async () => (await Promise.resolve().then(() => (init_go(), go_exports))).goCommand
+  },
   {
     exportName: "goalCommand",
     name: "goal",
-    description: "DB-persisted, per-agent, evidence-gate-aware goal loop (set/status/subgoal/append).",
+    description: "DB-persisted, per-agent, evidence-gate-aware goal loop (set/status/advance/subgoal/append).",
     load: async () => (await Promise.resolve().then(() => (init_goal2(), goal_exports))).goalCommand
   },
   {
@@ -74659,7 +74894,7 @@ var COMMAND_MANIFEST = [
   {
     exportName: "workgraphCommand",
     name: "workgraph",
-    description: "PM-Core V2 WorkGraph operations \u2014 validate, apply, plan, structure",
+    description: "PM-Core V2 WorkGraph operations \u2014 validate, apply, plan, structure, status",
     load: async () => (await Promise.resolve().then(() => (init_workgraph2(), workgraph_exports))).workgraphCommand
   },
   {
@@ -74940,7 +75175,7 @@ async function resolveSubCommandForHelp(cmd, rawArgs) {
 init_summary_context();
 enforceNodeVersion();
 function getPackageVersion() {
-  const pkgPath = join37(dirname11(fileURLToPath7(import.meta.url)), "../../package.json");
+  const pkgPath = join37(dirname11(fileURLToPath6(import.meta.url)), "../../package.json");
   const pkg = JSON.parse(readFileSync21(pkgPath, "utf-8"));
   return pkg.version;
 }