commandmate 0.29.0 → 0.29.2

package/.next/types/routes.d.ts

@@ -2,7 +2,7 @@
 // Do not edit this file manually
 
 type AppRoutes = "/" | "/chat" | "/login" | "/more" | "/offline" | "/repositories" | "/review" | "/sessions" | "/skills" | "/skills/[skillId]" | "/skills/installed" | "/worktrees/[id]" | "/worktrees/[id]/files/[...path]" | "/worktrees/[id]/terminal"
-type AppRouteHandlerRoutes = "/api/app/update" | "/api/app/update-check" | "/api/assistant/conversation" | "/api/assistant/current-output" | "/api/assistant/messages" | "/api/assistant/session" | "/api/assistant/start" | "/api/assistant/terminal" | "/api/assistant/tools" | "/api/auth/login" | "/api/auth/logout" | "/api/auth/status" | "/api/capabilities" | "/api/daily-summary" | "/api/daily-summary/status" | "/api/external-apps" | "/api/external-apps/[id]" | "/api/external-apps/[id]/health" | "/api/fs/browse" | "/api/fs/recent-paths" | "/api/hooks/agent-event" | "/api/hooks/claude-done" | "/api/hooks/permission-request" | "/api/metrics/vibe" | "/api/ollama/models" | "/api/push/escalation" | "/api/push/subscriptions" | "/api/push/vapid" | "/api/remote/pair" | "/api/repositories" | "/api/repositories/[id]" | "/api/repositories/[id]/todos" | "/api/repositories/[id]/todos/[todoId]" | "/api/repositories/clone" | "/api/repositories/clone/[jobId]" | "/api/repositories/excluded" | "/api/repositories/restore" | "/api/repositories/scan" | "/api/repositories/sync" | "/api/repositories/validate-path" | "/api/sidebar/group-order" | "/api/skills" | "/api/skills/[id]" | "/api/skills/installations" | "/api/skills/operations" | "/api/skills/reindex" | "/api/slash-commands" | "/api/tasks/[taskId]" | "/api/tasks/[taskId]/cancel" | "/api/templates" | "/api/templates/[id]" | "/api/todos" | "/api/verification/runs" | "/api/verification/runs/[runId]" | "/api/worktrees" | "/api/worktrees/[id]" | "/api/worktrees/[id]/auto-yes" | "/api/worktrees/[id]/capture" | "/api/worktrees/[id]/clear-composer" | "/api/worktrees/[id]/cli-tool" | "/api/worktrees/[id]/cmate/schedules" | "/api/worktrees/[id]/current-output" | "/api/worktrees/[id]/env" | "/api/worktrees/[id]/execution-logs" | "/api/worktrees/[id]/execution-logs/[logId]" | "/api/worktrees/[id]/files/[...path]" | "/api/worktrees/[id]/git/branch/create" | "/api/worktrees/[id]/git/branch/delete" | "/api/worktrees/[id]/git/branches" | "/api/worktrees/[id]/git/checkout" | "/api/worktrees/[id]/git/commit" | "/api/worktrees/[id]/git/diff" | "/api/worktrees/[id]/git/fetch" | "/api/worktrees/[id]/git/log" | "/api/worktrees/[id]/git/pull" | "/api/worktrees/[id]/git/push" | "/api/worktrees/[id]/git/reset" | "/api/worktrees/[id]/git/revert" | "/api/worktrees/[id]/git/show/[commitHash]" | "/api/worktrees/[id]/git/stage" | "/api/worktrees/[id]/git/staged" | "/api/worktrees/[id]/git/stash" | "/api/worktrees/[id]/git/stash/[index]" | "/api/worktrees/[id]/git/stash/apply" | "/api/worktrees/[id]/git/stash/pop" | "/api/worktrees/[id]/git/stash/push" | "/api/worktrees/[id]/git/status" | "/api/worktrees/[id]/git/unstage" | "/api/worktrees/[id]/git/working-diff" | "/api/worktrees/[id]/instances/opencode" | "/api/worktrees/[id]/interrupt" | "/api/worktrees/[id]/kill-session" | "/api/worktrees/[id]/logs" | "/api/worktrees/[id]/logs/[filename]" | "/api/worktrees/[id]/marp-render" | "/api/worktrees/[id]/memos" | "/api/worktrees/[id]/memos/[memoId]" | "/api/worktrees/[id]/messages" | "/api/worktrees/[id]/opencode/diff" | "/api/worktrees/[id]/opencode/session" | "/api/worktrees/[id]/opencode/share" | "/api/worktrees/[id]/prompt-response" | "/api/worktrees/[id]/resolve-target" | "/api/worktrees/[id]/respond" | "/api/worktrees/[id]/schedules" | "/api/worktrees/[id]/schedules/[scheduleId]" | "/api/worktrees/[id]/schedules/active" | "/api/worktrees/[id]/search" | "/api/worktrees/[id]/send" | "/api/worktrees/[id]/skills" | "/api/worktrees/[id]/skills/[skillId]/git-workflow" | "/api/worktrees/[id]/skills/[skillId]/install" | "/api/worktrees/[id]/skills/[skillId]/plan" | "/api/worktrees/[id]/skills/[skillId]/uninstall" | "/api/worktrees/[id]/skills/[skillId]/uninstall-plan" | "/api/worktrees/[id]/skills/[skillId]/update" | "/api/worktrees/[id]/skills/[skillId]/update-plan" | "/api/worktrees/[id]/slash-commands" | "/api/worktrees/[id]/special-keys" | "/api/worktrees/[id]/start-polling" | "/api/worktrees/[id]/tasks" | "/api/worktrees/[id]/terminal" | "/api/worktrees/[id]/timers" | "/api/worktrees/[id]/timers/history" | "/api/worktrees/[id]/todos" | "/api/worktrees/[id]/todos/[todoId]" | "/api/worktrees/[id]/tree" | "/api/worktrees/[id]/tree/[...path]" | "/api/worktrees/[id]/upload/[...path]" | "/api/worktrees/[id]/verify" | "/api/worktrees/[id]/verify/runs" | "/api/worktrees/[id]/verify/runs/[runId]" | "/api/worktrees/[id]/viewed" | "/proxy/[...path]"
+type AppRouteHandlerRoutes = "/api/agents/update" | "/api/agents/versions" | "/api/app/update" | "/api/app/update-check" | "/api/assistant/conversation" | "/api/assistant/current-output" | "/api/assistant/messages" | "/api/assistant/session" | "/api/assistant/start" | "/api/assistant/terminal" | "/api/assistant/tools" | "/api/auth/login" | "/api/auth/logout" | "/api/auth/status" | "/api/capabilities" | "/api/daily-summary" | "/api/daily-summary/status" | "/api/external-apps" | "/api/external-apps/[id]" | "/api/external-apps/[id]/health" | "/api/fs/browse" | "/api/fs/recent-paths" | "/api/hooks/agent-event" | "/api/hooks/claude-done" | "/api/hooks/permission-request" | "/api/metrics/vibe" | "/api/ollama/models" | "/api/push/escalation" | "/api/push/subscriptions" | "/api/push/vapid" | "/api/remote/pair" | "/api/repositories" | "/api/repositories/[id]" | "/api/repositories/[id]/todos" | "/api/repositories/[id]/todos/[todoId]" | "/api/repositories/clone" | "/api/repositories/clone/[jobId]" | "/api/repositories/excluded" | "/api/repositories/restore" | "/api/repositories/scan" | "/api/repositories/sync" | "/api/repositories/validate-path" | "/api/settings/default-agents" | "/api/sidebar/group-order" | "/api/skills" | "/api/skills/[id]" | "/api/skills/installations" | "/api/skills/operations" | "/api/skills/reindex" | "/api/slash-commands" | "/api/tasks/[taskId]" | "/api/tasks/[taskId]/cancel" | "/api/templates" | "/api/templates/[id]" | "/api/todos" | "/api/verification/runs" | "/api/verification/runs/[runId]" | "/api/worktrees" | "/api/worktrees/[id]" | "/api/worktrees/[id]/auto-yes" | "/api/worktrees/[id]/capture" | "/api/worktrees/[id]/clear-composer" | "/api/worktrees/[id]/cli-tool" | "/api/worktrees/[id]/cmate/schedules" | "/api/worktrees/[id]/current-output" | "/api/worktrees/[id]/env" | "/api/worktrees/[id]/execution-logs" | "/api/worktrees/[id]/execution-logs/[logId]" | "/api/worktrees/[id]/files/[...path]" | "/api/worktrees/[id]/git/branch/create" | "/api/worktrees/[id]/git/branch/delete" | "/api/worktrees/[id]/git/branches" | "/api/worktrees/[id]/git/checkout" | "/api/worktrees/[id]/git/commit" | "/api/worktrees/[id]/git/diff" | "/api/worktrees/[id]/git/fetch" | "/api/worktrees/[id]/git/log" | "/api/worktrees/[id]/git/pull" | "/api/worktrees/[id]/git/push" | "/api/worktrees/[id]/git/reset" | "/api/worktrees/[id]/git/revert" | "/api/worktrees/[id]/git/show/[commitHash]" | "/api/worktrees/[id]/git/stage" | "/api/worktrees/[id]/git/staged" | "/api/worktrees/[id]/git/stash" | "/api/worktrees/[id]/git/stash/[index]" | "/api/worktrees/[id]/git/stash/apply" | "/api/worktrees/[id]/git/stash/pop" | "/api/worktrees/[id]/git/stash/push" | "/api/worktrees/[id]/git/status" | "/api/worktrees/[id]/git/unstage" | "/api/worktrees/[id]/git/working-diff" | "/api/worktrees/[id]/instances/opencode" | "/api/worktrees/[id]/interrupt" | "/api/worktrees/[id]/kill-session" | "/api/worktrees/[id]/logs" | "/api/worktrees/[id]/logs/[filename]" | "/api/worktrees/[id]/marp-render" | "/api/worktrees/[id]/memos" | "/api/worktrees/[id]/memos/[memoId]" | "/api/worktrees/[id]/messages" | "/api/worktrees/[id]/opencode/diff" | "/api/worktrees/[id]/opencode/session" | "/api/worktrees/[id]/opencode/share" | "/api/worktrees/[id]/prompt-response" | "/api/worktrees/[id]/resolve-target" | "/api/worktrees/[id]/respond" | "/api/worktrees/[id]/schedules" | "/api/worktrees/[id]/schedules/[scheduleId]" | "/api/worktrees/[id]/schedules/active" | "/api/worktrees/[id]/search" | "/api/worktrees/[id]/send" | "/api/worktrees/[id]/skills" | "/api/worktrees/[id]/skills/[skillId]/git-workflow" | "/api/worktrees/[id]/skills/[skillId]/install" | "/api/worktrees/[id]/skills/[skillId]/plan" | "/api/worktrees/[id]/skills/[skillId]/uninstall" | "/api/worktrees/[id]/skills/[skillId]/uninstall-plan" | "/api/worktrees/[id]/skills/[skillId]/update" | "/api/worktrees/[id]/skills/[skillId]/update-plan" | "/api/worktrees/[id]/slash-commands" | "/api/worktrees/[id]/special-keys" | "/api/worktrees/[id]/start-polling" | "/api/worktrees/[id]/tasks" | "/api/worktrees/[id]/terminal" | "/api/worktrees/[id]/timers" | "/api/worktrees/[id]/timers/history" | "/api/worktrees/[id]/todos" | "/api/worktrees/[id]/todos/[todoId]" | "/api/worktrees/[id]/tree" | "/api/worktrees/[id]/tree/[...path]" | "/api/worktrees/[id]/upload/[...path]" | "/api/worktrees/[id]/verify" | "/api/worktrees/[id]/verify/config" | "/api/worktrees/[id]/verify/runs" | "/api/worktrees/[id]/verify/runs/[runId]" | "/api/worktrees/[id]/verify/runs/[runId]/cancel" | "/api/worktrees/[id]/viewed" | "/api/worktrees/apply-default-agents" | "/proxy/[...path]"
 type PageRoutes = never
 type LayoutRoutes = "/" | "/worktrees/[id]"
 type RedirectRoutes = never
@@ -12,6 +12,8 @@ type Routes = AppRoutes | PageRoutes | LayoutRoutes | RedirectRoutes | RewriteRo
 
 interface ParamMap {
   "/": {}
+  "/api/agents/update": {}
+  "/api/agents/versions": {}
   "/api/app/update": {}
   "/api/app/update-check": {}
   "/api/assistant/conversation": {}
@@ -52,6 +54,7 @@ interface ParamMap {
   "/api/repositories/scan": {}
   "/api/repositories/sync": {}
   "/api/repositories/validate-path": {}
+  "/api/settings/default-agents": {}
   "/api/sidebar/group-order": {}
   "/api/skills": {}
   "/api/skills/[id]": { "id": string; }
@@ -142,9 +145,12 @@ interface ParamMap {
   "/api/worktrees/[id]/tree/[...path]": { "id": string; "path": string[]; }
   "/api/worktrees/[id]/upload/[...path]": { "id": string; "path": string[]; }
   "/api/worktrees/[id]/verify": { "id": string; }
+  "/api/worktrees/[id]/verify/config": { "id": string; }
   "/api/worktrees/[id]/verify/runs": { "id": string; }
   "/api/worktrees/[id]/verify/runs/[runId]": { "id": string; "runId": string; }
+  "/api/worktrees/[id]/verify/runs/[runId]/cancel": { "id": string; "runId": string; }
   "/api/worktrees/[id]/viewed": { "id": string; }
+  "/api/worktrees/apply-default-agents": {}
   "/chat": {}
   "/login": {}
   "/more": {}

package/.next/types/validator.ts

@@ -173,6 +173,24 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../src/app/api/agents/update/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/agents/update">> = Specific
+  const handler = {} as typeof import("../../src/app/api/agents/update/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/api/agents/versions/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/agents/versions">> = Specific
+  const handler = {} as typeof import("../../src/app/api/agents/versions/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../src/app/api/app/update-check/route.ts
 {
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/app/update-check">> = Specific
@@ -533,6 +551,15 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../src/app/api/settings/default-agents/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/settings/default-agents">> = Specific
+  const handler = {} as typeof import("../../src/app/api/settings/default-agents/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../src/app/api/sidebar/group-order/route.ts
 {
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/sidebar/group-order">> = Specific
@@ -1325,6 +1352,15 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../src/app/api/worktrees/[id]/verify/config/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/worktrees/[id]/verify/config">> = Specific
+  const handler = {} as typeof import("../../src/app/api/worktrees/[id]/verify/config/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../src/app/api/worktrees/[id]/verify/route.ts
 {
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/worktrees/[id]/verify">> = Specific
@@ -1334,6 +1370,15 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../src/app/api/worktrees/[id]/verify/runs/[runId]/cancel/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/worktrees/[id]/verify/runs/[runId]/cancel">> = Specific
+  const handler = {} as typeof import("../../src/app/api/worktrees/[id]/verify/runs/[runId]/cancel/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../src/app/api/worktrees/[id]/verify/runs/[runId]/route.ts
 {
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/worktrees/[id]/verify/runs/[runId]">> = Specific
@@ -1361,6 +1406,15 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../src/app/api/worktrees/apply-default-agents/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/worktrees/apply-default-agents">> = Specific
+  const handler = {} as typeof import("../../src/app/api/worktrees/apply-default-agents/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../src/app/api/worktrees/route.ts
 {
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/worktrees">> = Specific

package/dist/cli/commands/agents.d.ts

@@ -0,0 +1,35 @@
+/**
+ * `agents` Command — read the installed agent CLI versions, and update one
+ * (Issue #2069).
+ *
+ *   commandmate agents versions [--json]
+ *   commandmate agents update <tool> [--yes] [--json] [--check]
+ *
+ * ## Why the update runs here rather than through the server
+ *
+ * The whole point of this Issue is that the updater must not run inside an
+ * agent's tmux pane: codex's own "Update now" terminates codex and does not
+ * restart it, leaving the pane at a bare shell (#2070). A CLI process is
+ * already the "somewhere else" that requirement asks for, so this command runs
+ * `lib/updates/agent-updater` directly — no server, no port, and it works on a
+ * machine where CommandMate is not running at all. The GUI's button reaches the
+ * same two functions through `POST /api/agents/update`.
+ *
+ * ## Imports are relative on purpose
+ *
+ * `tsconfig.cli.json` resets `"paths"` to `{}`, so a single `@/...` anywhere in
+ * this file's transitive closure breaks `npm run build:cli` (the #1933 defect
+ * PR #1991 fixed). `lib/updates/*` is written to that constraint — see the note
+ * in `codex-version.ts` about not importing `getCodexHome`.
+ */
+import { Command } from 'commander';
+/** Options accepted by `agents versions` / `agents update`. */
+export interface AgentsCommandOptions {
+    json?: boolean;
+    yes?: boolean;
+    /** Report the plan and stop, changing nothing. */
+    check?: boolean;
+}
+/** Build the `agents` command tree. */
+export declare function createAgentsCommand(): Command;
+//# sourceMappingURL=agents.d.ts.map

package/dist/cli/commands/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/agents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAcpC,+DAA+D;AAC/D,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,kDAAkD;IAClD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AA+KD,uCAAuC;AACvC,wBAAgB,mBAAmB,IAAI,OAAO,CAoC7C"}

package/dist/cli/commands/agents.js

@@ -0,0 +1,212 @@
+"use strict";
+/**
+ * `agents` Command — read the installed agent CLI versions, and update one
+ * (Issue #2069).
+ *
+ *   commandmate agents versions [--json]
+ *   commandmate agents update <tool> [--yes] [--json] [--check]
+ *
+ * ## Why the update runs here rather than through the server
+ *
+ * The whole point of this Issue is that the updater must not run inside an
+ * agent's tmux pane: codex's own "Update now" terminates codex and does not
+ * restart it, leaving the pane at a bare shell (#2070). A CLI process is
+ * already the "somewhere else" that requirement asks for, so this command runs
+ * `lib/updates/agent-updater` directly — no server, no port, and it works on a
+ * machine where CommandMate is not running at all. The GUI's button reaches the
+ * same two functions through `POST /api/agents/update`.
+ *
+ * ## Imports are relative on purpose
+ *
+ * `tsconfig.cli.json` resets `"paths"` to `{}`, so a single `@/...` anywhere in
+ * this file's transitive closure breaks `npm run build:cli` (the #1933 defect
+ * PR #1991 fixed). `lib/updates/*` is written to that constraint — see the note
+ * in `codex-version.ts` about not importing `getCodexHome`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAgentsCommand = createAgentsCommand;
+const commander_1 = require("commander");
+const types_1 = require("../types");
+const logger_1 = require("../utils/logger");
+const command_helpers_1 = require("../utils/command-helpers");
+const prompt_1 = require("../utils/prompt");
+const agent_updater_1 = require("../../lib/updates/agent-updater");
+const agent_versions_1 = require("../../lib/updates/agent-versions");
+const logger = new logger_1.CLILogger();
+/** Render the version rows as a fixed-width table, mirroring `ls` / `instances`. */
+function formatVersionsTable(rows) {
+    if (rows.length === 0)
+        return 'No agent CLIs found.';
+    const headers = ['TOOL', 'INSTALLED', 'LATEST', 'UPDATE'];
+    const dataRows = rows.map((row) => [
+        row.tool,
+        // Blank rather than a placeholder, exactly as `instances` prints an unknown
+        // model: "not installed" is the ordinary state for most of this table.
+        row.installed ?? '',
+        row.latestVersion ?? '',
+        row.updateAvailable ? 'available' : '',
+    ]);
+    const widths = headers.map((header, i) => Math.max(header.length, ...dataRows.map((row) => row[i].length)));
+    const line = (cells) => cells.map((cell, i) => cell.padEnd(widths[i])).join('  ');
+    return [
+        line(headers),
+        widths.map((width) => '-'.repeat(width)).join('  '),
+        ...dataRows.map(line),
+    ].join('\n');
+}
+/** `commandmate agents versions` — print what is installed. */
+async function showVersions(options) {
+    const rows = await (0, agent_versions_1.getAgentVersions)({ force: true });
+    if (options.json) {
+        console.log(JSON.stringify({ tools: rows, updatable: [...agent_updater_1.UPDATABLE_AGENT_TOOLS] }, null, 2));
+        return;
+    }
+    console.log(formatVersionsTable(rows));
+    const stale = rows.filter((row) => row.updateAvailable);
+    if (stale.length > 0) {
+        console.log('');
+        for (const row of stale) {
+            console.log(`Update available for ${row.tool}: ${row.installed ?? 'unknown'} -> ${row.latestVersion ?? 'unknown'}` +
+                // Deliberately not "you dismissed this": on the default #2068
+                // policy CommandMate itself answers codex's dialog with the digit
+                // that writes `dismissed_version`.
+                (row.dismissedInCodex ? ' (marked dismissed in codex)' : ''));
+        }
+        console.log(`Run "commandmate agents update ${stale[0].tool}" to install it.`);
+    }
+}
+/**
+ * `commandmate agents update <tool>` — run the tool's own updater here.
+ *
+ * Exit codes follow `commandmate update`: 2 when the request cannot be honoured
+ * (unknown tool, nothing to run it with, non-interactive without `--yes`), and
+ * 5 when the updater itself failed.
+ */
+async function updateAgent(tool, options) {
+    const planned = await (0, agent_updater_1.resolveAgentUpdatePlan)(tool);
+    if (!planned.ok) {
+        if (options.json) {
+            console.log(JSON.stringify({ ok: false, code: planned.code, error: planned.message }, null, 2));
+        }
+        else {
+            logger.error(planned.message);
+        }
+        process.exit(types_1.ExitCode.CONFIG_ERROR);
+        return;
+    }
+    const plan = planned.plan;
+    if (options.check) {
+        if (options.json) {
+            console.log(JSON.stringify({
+                ok: true,
+                tool: plan.tool,
+                strategy: plan.strategy,
+                command: plan.display,
+                installed: plan.installed,
+            }, null, 2));
+        }
+        else {
+            console.log(`Installed: ${plan.installed ?? 'not installed'}`);
+            console.log(`Would run: ${plan.display}`);
+        }
+        return;
+    }
+    if (!options.yes) {
+        if (!(0, prompt_1.isInteractive)()) {
+            logger.error('Non-interactive環境では --yes が必要です');
+            logger.info(`Run "commandmate agents update ${plan.tool} --yes" to update without a prompt.`);
+            process.exit(types_1.ExitCode.CONFIG_ERROR);
+            return;
+        }
+        const proceed = await (0, prompt_1.confirm)(`Run "${plan.display}" now?`, { default: true });
+        (0, prompt_1.closeReadline)();
+        if (!proceed) {
+            console.log('Cancelled.');
+            return;
+        }
+    }
+    if (!options.json) {
+        console.log(`Running: ${plan.display}`);
+        console.log('');
+    }
+    // Streamed straight through: an install is exactly the case where the user
+    // wants to watch npm talk rather than stare at a spinner.
+    const captured = [];
+    const result = await (0, agent_updater_1.runAgentUpdate)(plan, {
+        onChunk: (chunk) => {
+            if (options.json) {
+                captured.push(chunk.text);
+                return;
+            }
+            if (chunk.stream === 'stderr')
+                process.stderr.write(chunk.text);
+            else
+                process.stdout.write(chunk.text);
+        },
+    });
+    // Re-probed rather than assumed: "the updater exited 0" and "the binary on
+    // PATH changed" are different claims, and this Issue's acceptance criterion
+    // is the second one.
+    const after = (await (0, agent_versions_1.getAgentVersions)({ force: true })).find((row) => row.tool === plan.tool);
+    if (options.json) {
+        console.log(JSON.stringify({
+            ok: result.ok,
+            tool: plan.tool,
+            strategy: plan.strategy,
+            command: plan.display,
+            previousVersion: plan.installed,
+            installed: after?.installed ?? null,
+            exitCode: result.exitCode,
+            output: captured.join(''),
+            ...(result.error ? { error: result.error } : {}),
+        }, null, 2));
+    }
+    else {
+        console.log('');
+        if (result.ok) {
+            logger.success(`${plan.tool}: ${plan.installed ?? 'unknown'} -> ${after?.installed ?? 'unknown'}`);
+            logger.info('Running sessions keep the old binary until they are restarted.');
+        }
+        else {
+            logger.error(result.error ?? `Update exited with status ${String(result.exitCode)}`);
+        }
+    }
+    if (!result.ok) {
+        process.exit(types_1.ExitCode.UPDATE_FAILED);
+    }
+}
+/** Build the `agents` command tree. */
+function createAgentsCommand() {
+    const cmd = new commander_1.Command('agents');
+    cmd
+        .description('Inspect and update the agent CLIs CommandMate drives')
+        .argument('[action]', 'versions (default) or update')
+        .argument('[tool]', `Tool to update (${agent_updater_1.UPDATABLE_AGENT_TOOLS.join(', ')})`)
+        .option('--json', 'JSON output')
+        .option('--yes', 'Skip the confirmation prompt (required in non-interactive shells)')
+        .option('--check', 'Report what would run, and change nothing')
+        .action(async (action, tool, options) => {
+        try {
+            switch (action ?? 'versions') {
+                case 'versions':
+                    await showVersions(options);
+                    break;
+                case 'update': {
+                    if (!tool) {
+                        console.error(`Error: update requires a <tool> argument. Valid tools: ${agent_updater_1.UPDATABLE_AGENT_TOOLS.join(', ')}.`);
+                        process.exit(types_1.ExitCode.CONFIG_ERROR);
+                    }
+                    await updateAgent(tool, options);
+                    break;
+                }
+                default:
+                    console.error(`Error: unknown action '${action}'. Valid actions: versions, update.`);
+                    process.exit(types_1.ExitCode.CONFIG_ERROR);
+            }
+        }
+        catch (error) {
+            (0, command_helpers_1.handleCommandError)(error);
+        }
+    });
+    return cmd;
+}

package/dist/cli/commands/ls.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ls.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/ls.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiIpC;;;GAGG;AACH,wBAAgB,eAAe,IAAI,OAAO,CA8CzC"}
+{"version":3,"file":"ls.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/ls.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkJpC;;;GAGG;AACH,wBAAgB,eAAe,IAAI,OAAO,CA8CzC"}

package/dist/cli/commands/ls.js

@@ -7,6 +7,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createLsCommand = createLsCommand;
 const commander_1 = require("commander");
 const api_client_1 = require("../utils/api-client");
+// The reason vocabulary itself, not a copy of one token of it: `commandmate ls`
+// and the server must not be able to disagree about what `exited` is spelled.
+const status_reason_1 = require("../../lib/detection/status-reason");
 const command_helpers_1 = require("../utils/command-helpers");
 /**
  * Derive display status from worktree flags.
@@ -50,6 +53,13 @@ function pickStatusEntry(wt, status) {
             return entry.isProcessing;
         if (status === 'ready')
             return entry.isRunning;
+        // Issue #2070: `idle` gets an explanation for the first time, and only for
+        // the one reason a stopped session can carry — `exited`. Everything else
+        // about an idle row is unchanged: no entry is picked, so the REASON cell is
+        // still `-`. That is what makes this additive rather than a fourth branch of
+        // `deriveStatus` (DR3-005 keeps the STATUS vocabulary at four words).
+        if (status === 'idle')
+            return entry.sessionStatusReason === status_reason_1.STATUS_REASON.EXITED;
         return false;
     };
     const preferred = wt.cliToolId ? byCli[wt.cliToolId] : undefined;
@@ -70,6 +80,14 @@ function pickStatusEntry(wt, status) {
  * rather than a reading. Today that is exactly the `default` and
  * `no_recent_output` reasons; design Phase 3 widens it per tool, and the marker
  * is what makes the widening visible here without the reason token changing.
+ *
+ * Issue #2070 adds one reason that appears beside `idle`: `exited`, meaning the
+ * tmux session is still there and the agent in it is not. Before it, a codex
+ * that had crashed or updated itself out from under its pane was reported
+ * `running` — and once the detection was fixed, it would have been reported
+ * `idle` with a bare `-`, indistinguishable from a worktree nobody has started.
+ * The distinction is the point: `idle` means "start it", `idle`/`exited` means
+ * "it died under you, and the next send will restart it".
  */
 function deriveReason(wt) {
     const entry = pickStatusEntry(wt, deriveStatus(wt));

package/dist/cli/commands/verify.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/verify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,KAAK,EAMV,uBAAuB,EAExB,MAAM,wBAAwB,CAAC;AAmChC;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,uBAAuB,GAAG,IAAI,CA8BrG;AAyED,wBAAgB,mBAAmB,IAAI,OAAO,CA0D7C"}
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/verify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmBpC,OAAO,KAAK,EAMV,uBAAuB,EAExB,MAAM,wBAAwB,CAAC;AAmChC;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,uBAAuB,GAAG,IAAI,CA8BrG;AAyED,wBAAgB,mBAAmB,IAAI,OAAO,CA2D7C"}

package/dist/cli/commands/verify.js

@@ -18,8 +18,14 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseScopeEvidence = parseScopeEvidence;
 exports.createVerifyCommand = createVerifyCommand;
+const path_1 = require("path");
 const commander_1 = require("commander");
 const types_1 = require("../types");
+// Relative, NOT `@/lib/...`: tsconfig.cli.json resets `paths` to {}, so an alias
+// import here breaks `npm run build:cli`. The drafter reads only fs/path/yaml,
+// which is what lets the CLI and the API route share one implementation of it
+// instead of each growing its own scanner (Issue #2061).
+const verify_draft_1 = require("../../lib/verification/verify-draft");
 const api_client_1 = require("../utils/api-client");
 const command_helpers_1 = require("../utils/command-helpers");
 const verify_runner_1 = require("../utils/verify-runner");
@@ -202,6 +208,7 @@ function createVerifyCommand() {
             (0, command_helpers_1.handleCommandError)(error);
         }
     });
+    addInitCommand(cmd);
     addHistoryCommand(cmd);
     addShowCommand(cmd);
     return cmd;
@@ -338,3 +345,107 @@ function addShowCommand(parent) {
         }
     });
 }
+/**
+ * `commandmate verify init [--cwd <path>] [--dry-run] [--json]`
+ *
+ * Drafts `.commandmate/verify.yaml` from the repository's own CI definitions
+ * (Issue #2061). Local and server-free on purpose: this is the command that
+ * runs *before* a repository has anything to verify, and requiring
+ * `commandmate start` first would put the bootstrap behind the thing it
+ * bootstraps. Every other `verify` subcommand talks to the API because it reads
+ * or writes run rows; this one only reads files.
+ *
+ * Never overwrites. An existing config is the repository's own judgement of
+ * what passing means — usually with the reasoning for each gate beside it — so
+ * it exits 2 and names the file rather than offering a `--force`.
+ */
+function addInitCommand(parent) {
+    parent
+        .command('init')
+        .description('Draft .commandmate/verify.yaml from this repository\'s CI definitions (never overwrites)')
+        .option('--cwd <path>', 'Repository to draft for (default: the current directory)')
+        .option('--dry-run', 'Print the proposal on stdout and write nothing')
+        .option('--json', 'Print the draft as JSON on stdout')
+        .action((options, command) => {
+        try {
+            const json = inheritedFlag(options.json, command, 'json');
+            const repoPath = (0, path_1.resolve)(options.cwd ?? process.cwd());
+            // `--dry-run` must not create the file even by accident, so it takes the
+            // read-only path rather than writing and rolling back.
+            const result = options.dryRun
+                ? (0, verify_draft_1.planVerifyConfigDraft)(repoPath)
+                : (0, verify_draft_1.writeVerifyConfigDraft)(repoPath);
+            if (json) {
+                console.log(JSON.stringify({
+                    created: result.created,
+                    path: result.relativePath,
+                    refusedBecause: result.refusedBecause ?? null,
+                    gates: result.draft.gates.map((gate) => ({
+                        id: gate.id,
+                        command: gate.command,
+                        timeoutSec: gate.timeoutSec,
+                        source: (0, verify_draft_1.describeSource)(gate.source),
+                    })),
+                    excluded: result.draft.excluded.map((item) => ({
+                        command: item.command,
+                        reason: item.reason,
+                        source: (0, verify_draft_1.describeSource)(item.source),
+                    })),
+                    scanned: result.draft.scanned,
+                }, null, 2));
+            }
+            if (result.refusedBecause === 'exists') {
+                if (!json) {
+                    console.error(`Error: ${result.relativePath} already exists. Verification gates are never ` +
+                        'overwritten — edit that file, or delete it first.');
+                }
+                process.exit(types_1.ExitCode.CONFIG_ERROR);
+                return;
+            }
+            if (result.refusedBecause === 'no-gates') {
+                if (!json) {
+                    console.error('Error: no verification gates could be drafted. Nothing in ' +
+                        `${result.draft.scanned.join(', ') || '.github/workflows/, package.json'} ` +
+                        'was usable as a gate; write the file by hand ' +
+                        '(docs/design/verification-config.md).');
+                }
+                process.exit(types_1.ExitCode.CONFIG_ERROR);
+                return;
+            }
+            if (!json)
+                printDraft(result.created, result.relativePath, result.yaml, result.draft);
+            process.exit(types_1.ExitCode.SUCCESS);
+        }
+        catch (error) {
+            (0, command_helpers_1.handleCommandError)(error);
+        }
+    });
+}
+/** Human report: what was drafted, from where, and what was refused. */
+function printDraft(created, relativePath, yaml, draft) {
+    if (created) {
+        console.log(`Wrote ${relativePath} with ${draft.gates.length} gate(s).`);
+    }
+    else {
+        console.log(`Proposed ${relativePath} (--dry-run; nothing was written):`);
+        console.log('');
+        console.log(yaml.trimEnd());
+        console.log('');
+    }
+    console.log(`Scanned: ${draft.scanned.join(', ') || '(nothing)'}`);
+    for (const gate of draft.gates) {
+        console.log(`  ${gate.id}  ${gate.command}  <- ${(0, verify_draft_1.describeSource)(gate.source)}`);
+    }
+    if (draft.excluded.length > 0) {
+        // On stderr: the refusals are the part a reader has to audit, and keeping
+        // them off stdout leaves `--dry-run` output pipeable into the file itself.
+        console.error(`Not drafted as gates (${draft.excluded.length}):`);
+        for (const item of draft.excluded) {
+            console.error(`  [${item.reason}] ${item.command.split('\n')[0]}`);
+        }
+    }
+    if (created) {
+        console.log('');
+        console.log('Review it, then run: commandmate verify <worktree-id>');
+    }
+}

package/dist/cli/config/cli-dependencies.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-dependencies.d.ts","sourceRoot":"","sources":["../../../src/cli/config/cli-dependencies.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,eAAe,EAsDzC,CAAC;AAEF;;GAEG;AACH,wBAAgB,eAAe,IAAI,eAAe,EAAE,CAEnD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,eAAe,EAAE,CAE3D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,eAAe,EAAE,CAE3D"}
+{"version":3,"file":"cli-dependencies.d.ts","sourceRoot":"","sources":["../../../src/cli/config/cli-dependencies.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,eAAe,EAiEzC,CAAC;AAEF;;GAEG;AACH,wBAAgB,eAAe,IAAI,eAAe,EAAE,CAEnD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,eAAe,EAAE,CAE3D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,eAAe,EAAE,CAE3D"}

package/dist/cli/config/cli-dependencies.js

@@ -66,6 +66,17 @@ exports.DEPENDENCIES = [
         versionArg: '--version',
         required: false,
     },
+    // Issue #2069: codex was the one agent CLI CommandMate drives that this list
+    // never named, so `commandmate init` reported a version for claude, copilot
+    // and opencode and said nothing at all about the tool most of this
+    // repository's own sessions run. Optional for the same reason as its
+    // siblings: CommandMate drives codex, it does not require it.
+    {
+        name: 'Codex CLI',
+        command: 'codex',
+        versionArg: '--version',
+        required: false,
+    },
 ];
 /**
  * Get all dependencies