commandmate 0.16.0 → 0.17.0

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/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/claude-done" | "/api/ollama/models" | "/api/push/subscriptions" | "/api/push/vapid" | "/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/templates" | "/api/templates/[id]" | "/api/todos" | "/api/worktrees" | "/api/worktrees/[id]" | "/api/worktrees/[id]/auto-yes" | "/api/worktrees/[id]/capture" | "/api/worktrees/[id]/cli-tool" | "/api/worktrees/[id]/cmate/schedules" | "/api/worktrees/[id]/current-output" | "/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]/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]/prompt-response" | "/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]/slash-commands" | "/api/worktrees/[id]/special-keys" | "/api/worktrees/[id]/start-polling" | "/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]/viewed" | "/proxy/[...path]"
+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/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/metrics/vibe" | "/api/ollama/models" | "/api/push/subscriptions" | "/api/push/vapid" | "/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]/cli-tool" | "/api/worktrees/[id]/cmate/schedules" | "/api/worktrees/[id]/current-output" | "/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]/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]/prompt-response" | "/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]/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 PageRoutes = never
 type LayoutRoutes = "/"
 type RedirectRoutes = never
@@ -31,7 +31,9 @@ interface ParamMap {
   "/api/external-apps/[id]/health": { "id": string; }
   "/api/fs/browse": {}
   "/api/fs/recent-paths": {}
+  "/api/hooks/agent-event": {}
   "/api/hooks/claude-done": {}
+  "/api/metrics/vibe": {}
   "/api/ollama/models": {}
   "/api/push/subscriptions": {}
   "/api/push/vapid": {}
@@ -53,9 +55,13 @@ interface ParamMap {
   "/api/skills/operations": {}
   "/api/skills/reindex": {}
   "/api/slash-commands": {}
+  "/api/tasks/[taskId]": { "taskId": string; }
+  "/api/tasks/[taskId]/cancel": { "taskId": string; }
   "/api/templates": {}
   "/api/templates/[id]": { "id": string; }
   "/api/todos": {}
+  "/api/verification/runs": {}
+  "/api/verification/runs/[runId]": { "runId": string; }
   "/api/worktrees": {}
   "/api/worktrees/[id]": { "id": string; }
   "/api/worktrees/[id]/auto-yes": { "id": string; }
@@ -113,6 +119,7 @@ interface ParamMap {
   "/api/worktrees/[id]/slash-commands": { "id": string; }
   "/api/worktrees/[id]/special-keys": { "id": string; }
   "/api/worktrees/[id]/start-polling": { "id": string; }
+  "/api/worktrees/[id]/tasks": { "id": string; }
   "/api/worktrees/[id]/terminal": { "id": string; }
   "/api/worktrees/[id]/timers": { "id": string; }
   "/api/worktrees/[id]/timers/history": { "id": string; }
@@ -121,6 +128,9 @@ interface ParamMap {
   "/api/worktrees/[id]/tree": { "id": string; }
   "/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/runs": { "id": string; }
+  "/api/worktrees/[id]/verify/runs/[runId]": { "id": string; "runId": string; }
   "/api/worktrees/[id]/viewed": { "id": string; }
   "/chat": {}
   "/login": {}

package/.next/types/validator.ts

@@ -344,6 +344,15 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../src/app/api/hooks/agent-event/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/hooks/agent-event">> = Specific
+  const handler = {} as typeof import("../../src/app/api/hooks/agent-event/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../src/app/api/hooks/claude-done/route.ts
 {
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/hooks/claude-done">> = Specific
@@ -353,6 +362,15 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../src/app/api/metrics/vibe/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/metrics/vibe">> = Specific
+  const handler = {} as typeof import("../../src/app/api/metrics/vibe/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../src/app/api/ollama/models/route.ts
 {
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/ollama/models">> = Specific
@@ -542,6 +560,24 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../src/app/api/tasks/[taskId]/cancel/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/tasks/[taskId]/cancel">> = Specific
+  const handler = {} as typeof import("../../src/app/api/tasks/[taskId]/cancel/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/api/tasks/[taskId]/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/tasks/[taskId]">> = Specific
+  const handler = {} as typeof import("../../src/app/api/tasks/[taskId]/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../src/app/api/templates/[id]/route.ts
 {
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/templates/[id]">> = Specific
@@ -569,6 +605,24 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../src/app/api/verification/runs/[runId]/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/verification/runs/[runId]">> = Specific
+  const handler = {} as typeof import("../../src/app/api/verification/runs/[runId]/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/api/verification/runs/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/verification/runs">> = Specific
+  const handler = {} as typeof import("../../src/app/api/verification/runs/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../src/app/api/worktrees/[id]/auto-yes/route.ts
 {
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/worktrees/[id]/auto-yes">> = Specific
@@ -1073,6 +1127,15 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../src/app/api/worktrees/[id]/tasks/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/worktrees/[id]/tasks">> = Specific
+  const handler = {} as typeof import("../../src/app/api/worktrees/[id]/tasks/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../src/app/api/worktrees/[id]/terminal/route.ts
 {
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/worktrees/[id]/terminal">> = Specific
@@ -1145,6 +1208,33 @@ type RouteHandlerConfig<Route extends AppRouteHandlerRoutes = AppRouteHandlerRou
   type __Unused = __Check
 }
 
+// Validate ../../src/app/api/worktrees/[id]/verify/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/worktrees/[id]/verify">> = Specific
+  const handler = {} as typeof import("../../src/app/api/worktrees/[id]/verify/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
+  const handler = {} as typeof import("../../src/app/api/worktrees/[id]/verify/runs/[runId]/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
+// Validate ../../src/app/api/worktrees/[id]/verify/runs/route.ts
+{
+  type __IsExpected<Specific extends RouteHandlerConfig<"/api/worktrees/[id]/verify/runs">> = Specific
+  const handler = {} as typeof import("../../src/app/api/worktrees/[id]/verify/runs/route.js")
+  type __Check = __IsExpected<typeof handler>
+  // @ts-ignore
+  type __Unused = __Check
+}
+
 // Validate ../../src/app/api/worktrees/[id]/viewed/route.ts
 {
   type __IsExpected<Specific extends RouteHandlerConfig<"/api/worktrees/[id]/viewed">> = Specific

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

@@ -1,6 +1,7 @@
 /**
  * report Command - Generate, show, and list daily reports
  * Issue #636: CLI report generate/show/list
+ * Issue #1551: report metrics (Eval metrics)
  */
 import { Command } from 'commander';
 export declare function createReportCommand(): Command;

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

@@ -1 +1 @@
-{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/report.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2CpC,wBAAgB,mBAAmB,IAAI,OAAO,CA8I7C"}
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/report.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiFpC,wBAAgB,mBAAmB,IAAI,OAAO,CA6K7C"}

package/dist/cli/commands/report.js

@@ -2,6 +2,7 @@
 /**
  * report Command - Generate, show, and list daily reports
  * Issue #636: CLI report generate/show/list
+ * Issue #1551: report metrics (Eval metrics)
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createReportCommand = createReportCommand;
@@ -39,6 +40,32 @@ function getDateDaysAgo(daysAgo) {
     const d = String(date.getDate()).padStart(2, '0');
     return `${y}-${m}-${d}`;
 }
+/** Longest metrics window the API accepts. Mirrors MAX_METRICS_DAYS. */
+const MAX_METRICS_DAYS = 90;
+/**
+ * A 0..1 rate as a percentage, or `n/a`.
+ *
+ * `n/a` rather than `0.0%`: a null rate means the denominator was zero, and
+ * printing "0.0%" for "nothing happened" reports a catastrophe that did not
+ * occur.
+ */
+function formatRate(value) {
+    return value === null ? 'n/a' : `${(value * 100).toFixed(1)}%`;
+}
+function formatVibeMetrics(m) {
+    const { tasks, verification, intervention } = m;
+    const topFails = verification.gateFailBreakdown
+        .map((g) => `${g.gateId} x${g.failCount}`)
+        .join(', ');
+    const topFailsSuffix = topFails ? `  (top fails: ${topFails})` : '';
+    return [
+        `Vibe Metrics (last ${m.periodDays} days)`,
+        `Tasks:        ${tasks.total} total / ${tasks.succeeded} succeeded / ${tasks.failed} failed / ${tasks.notStarted} not-started  (success ${formatRate(tasks.successRate)})`,
+        `Verification: ${verification.runs} runs, pass ${formatRate(verification.passRate)}${topFailsSuffix}`,
+        `Intervention: ${intervention.humanResponds} human responds / ${intervention.autoAnswered} auto answered`,
+        `Retry loops:  ${tasks.avgRetryLoops === null ? 'n/a' : `avg ${tasks.avgRetryLoops.toFixed(1)}`} per failed task`,
+    ].join('\n');
+}
 function createReportCommand() {
     const cmd = new commander_1.Command('report');
     cmd.description('Generate, show, and list daily reports');
@@ -165,5 +192,32 @@ function createReportCommand() {
             (0, command_helpers_1.handleCommandError)(error);
         }
     });
+    // ---- report metrics ----
+    cmd
+        .command('metrics')
+        .description('Show Eval metrics (task success rate, human interventions)')
+        .option('--days <days>', 'Window length in days (default: 7)', parseInt)
+        .option('--json', 'JSON output')
+        .option('--token <token>', command_helpers_1.TOKEN_WARNING)
+        .action(async (options) => {
+        try {
+            const days = options.days ?? 7;
+            if (!Number.isInteger(days) || days < 1 || days > MAX_METRICS_DAYS) {
+                console.error(`Error: --days must be an integer between 1 and ${MAX_METRICS_DAYS}.`);
+                process.exit(types_1.ExitCode.CONFIG_ERROR);
+            }
+            const client = new api_client_1.ApiClient({ token: options.token });
+            const data = await client.get(`/api/metrics/vibe?days=${encodeURIComponent(String(days))}`);
+            if (options.json) {
+                console.log(JSON.stringify(data.metrics, null, 2));
+            }
+            else {
+                console.log(formatVibeMetrics(data.metrics));
+            }
+        }
+        catch (error) {
+            (0, command_helpers_1.handleCommandError)(error);
+        }
+    });
     return cmd;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"send.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/send.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+EpC,wBAAgB,iBAAiB,IAAI,OAAO,CA6G3C"}
+{"version":3,"file":"send.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/send.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8IpC,wBAAgB,iBAAiB,IAAI,OAAO,CAmJ3C"}

package/dist/cli/commands/send.js

@@ -66,12 +66,59 @@ async function registerInstance(client, worktreeId, instanceId, cliTool) {
     await (0, agent_instances_1.saveAgentInstances)(client, worktreeId, next);
     console.error(`Instance registered in roster: ${instanceId}`);
 }
+/**
+ * Create the task row for `--contract` and get the message to send back.
+ *
+ * The contract is parsed server-side: the path is relative to the worktree,
+ * which only the server can resolve, and the completion criterion is expanded
+ * from that worktree's verify.yaml. Every violation the server found is printed
+ * before exiting, so a broken contract is fixed in one pass (Issue #1545).
+ */
+async function createContractTask(client, worktreeId, options) {
+    const body = { contractPath: options.contract };
+    if (options.agent) {
+        body.cliToolId = options.agent;
+    }
+    if (options.instance) {
+        body.instanceId = options.instance;
+    }
+    try {
+        const response = await client.post(`/api/worktrees/${worktreeId}/tasks`, body);
+        const created = (0, api_client_1.assertResponseShape)(response, ['task', 'message'], 'POST /api/worktrees/:id/tasks');
+        return { taskId: created.task.id, message: created.message };
+    }
+    catch (error) {
+        if (error instanceof api_client_1.ApiError && error.statusCode === 400 && error.payload?.issues?.length) {
+            console.error('Error: invalid task contract:');
+            for (const issue of error.payload.issues) {
+                console.error(`  - ${issue}`);
+            }
+            process.exit(types_1.ExitCode.CONFIG_ERROR);
+        }
+        throw error;
+    }
+}
+/**
+ * Report a task transition to the server, best effort.
+ *
+ * A failure here is worth a warning but not the command's exit code: the
+ * message either reached the agent or it did not, and that outcome is what the
+ * caller is waiting on.
+ */
+async function reportTaskStatus(client, taskId, status) {
+    try {
+        await client.patch(`/api/tasks/${taskId}`, { status });
+    }
+    catch {
+        console.error(`Warning: could not record task ${taskId} as ${status}.`);
+    }
+}
 function createSendCommand() {
     const cmd = new commander_1.Command('send');
     cmd
         .description('Send a message to a worktree agent')
         .argument('<worktree-id>', 'Worktree ID')
-        .argument('<message>', 'Message to send')
+        .argument('[message]', 'Message to send (omit when using --contract)')
         .option('--agent <agent>', 'CLI tool agent (claude, codex, gemini, vibe-local, opencode, copilot, antigravity)')
         .option('--instance <id>', 'Agent instance ID: <agent> or <agent>-<n> (e.g. claude-2). Defaults to the agent\'s primary instance.')
         .option('--register', 'Register the --instance session into the agent-instance roster (Issue #1000)')
@@ -79,6 +126,7 @@ function createSendCommand() {
         .option('--auto-yes', 'Enable auto-yes before sending')
         .option('--duration <duration>', `Auto-yes duration (${duration_constants_1.ALLOWED_DURATIONS.join(', ')})`)
         .option('--stop-pattern <pattern>', 'Auto-yes stop pattern (regex)')
+        .option('--contract <path>', 'Execution contract path relative to the worktree root (e.g. .commandmate/tasks/my-task.yaml). Records a task and sends the contract preamble plus its goal.')
         .option('--token <token>', command_helpers_1.TOKEN_WARNING)
         .action(async (worktreeId, message, options) => {
         try {
@@ -87,6 +135,16 @@ function createSendCommand() {
                 console.error('Error: Invalid worktree ID format.');
                 process.exit(types_1.ExitCode.CONFIG_ERROR);
             }
+            // Issue #1545: the contract supplies the message, so accepting both
+            // would leave which one the agent receives ambiguous.
+            if (options.contract && message !== undefined) {
+                console.error('Error: --contract supplies the message; do not pass a message argument as well.');
+                process.exit(types_1.ExitCode.CONFIG_ERROR);
+            }
+            if (!options.contract && message === undefined) {
+                console.error('Error: a message argument is required unless --contract is given.');
+                process.exit(types_1.ExitCode.CONFIG_ERROR);
+            }
             // Validate agent if provided
             if (options.agent && !(0, cli_tool_ids_1.isCliToolId)(options.agent)) {
                 console.error(`Error: Invalid agent. Must be one of: ${cli_tool_ids_1.CLI_TOOL_IDS.join(', ')}`);
@@ -130,12 +188,24 @@ function createSendCommand() {
                 }
             }
             const client = new api_client_1.ApiClient({ token: options.token });
+            // Issue #1545: resolve the contract before anything with a side effect,
+            // so an invalid contract cannot leave auto-yes enabled for a message
+            // that was never sent.
+            let taskId;
+            let content = message;
+            if (options.contract) {
+                const task = await createContractTask(client, worktreeId, options);
+                taskId = task.taskId;
+                content = task.message;
+                console.error(`Task created: ${taskId}`);
+                console.log(taskId);
+            }
             // --auto-yes: enable auto-yes first (unless --model is specified, then after send) [DR2-02]
             if (options.autoYes && !options.model) {
                 await enableAutoYes(client, worktreeId, options);
             }
             // [DR2-05] Send API uses "content" not "message"
-            const sendBody = { content: message };
+            const sendBody = { content };
             if (options.agent) {
                 sendBody.cliToolId = options.agent;
             }
@@ -147,8 +217,21 @@ function createSendCommand() {
             if (options.model) {
                 sendBody.model = options.model;
             }
-            await client.post(`/api/worktrees/${worktreeId}/send`, sendBody);
+            try {
+                await client.post(`/api/worktrees/${worktreeId}/send`, sendBody);
+            }
+            catch (error) {
+                // A task whose message never arrived is a failed task, not a pending
+                // one: nothing is working on it and nothing ever will.
+                if (taskId) {
+                    await reportTaskStatus(client, taskId, 'failed');
+                }
+                throw error;
+            }
             console.error('Message sent.');
+            if (taskId) {
+                await reportTaskStatus(client, taskId, 'running');
+            }
             // Issue #1000: register the ad-hoc instance into the roster after the
             // session has started, so a follow-up `commandmate instances` lists it.
             if (options.register && options.instance) {

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

@@ -0,0 +1,11 @@
+/**
+ * task Command - Inspect execution contracts and their outcomes
+ * Issue #1545 (Phase 2-1)
+ *
+ * `task list` answers "what was this worktree asked to do", `task show` answers
+ * "what did the gates say about it" — the two halves of a contract that used to
+ * exist only inside the message text.
+ */
+import { Command } from 'commander';
+export declare function createTaskCommand(): Command;
+//# sourceMappingURL=task.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/task.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6BpC,wBAAgB,iBAAiB,IAAI,OAAO,CAmH3C"}

package/dist/cli/commands/task.js

@@ -0,0 +1,126 @@
+"use strict";
+/**
+ * task Command - Inspect execution contracts and their outcomes
+ * Issue #1545 (Phase 2-1)
+ *
+ * `task list` answers "what was this worktree asked to do", `task show` answers
+ * "what did the gates say about it" — the two halves of a contract that used to
+ * exist only inside the message text.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTaskCommand = createTaskCommand;
+const commander_1 = require("commander");
+const types_1 = require("../types");
+const api_client_1 = require("../utils/api-client");
+const command_helpers_1 = require("../utils/command-helpers");
+const MAX_LIST_LIMIT = 100;
+/** crypto.randomUUID() output; mirrors TASK_ID_PATTERN in the API route. */
+const TASK_ID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function formatTimestamp(value) {
+    return value ?? '-';
+}
+function printTaskLine(task) {
+    const gates = task.contract.verify.gates;
+    console.log([
+        task.id,
+        task.status,
+        task.cliToolId + (task.instanceId ? `/${task.instanceId}` : ''),
+        gates ? gates.join('+') : 'all-gates',
+        task.title,
+    ].join('\t'));
+}
+function createTaskCommand() {
+    const cmd = new commander_1.Command('task');
+    cmd.description('List and inspect execution contracts (tasks)');
+    // ---- task list ----
+    cmd
+        .command('list')
+        .description('List tasks for a worktree, newest first')
+        .argument('<worktree-id>', 'Worktree ID')
+        .option('--limit <n>', `Maximum tasks to list (1..${MAX_LIST_LIMIT})`, parseInt)
+        .option('--json', 'JSON output')
+        .option('--token <token>', command_helpers_1.TOKEN_WARNING)
+        .action(async (worktreeId, options) => {
+        try {
+            if (!(0, api_client_1.isValidWorktreeId)(worktreeId)) {
+                console.error('Error: Invalid worktree ID format.');
+                process.exit(types_1.ExitCode.CONFIG_ERROR);
+                return;
+            }
+            if (options.limit !== undefined &&
+                (!Number.isInteger(options.limit) || options.limit < 1 || options.limit > MAX_LIST_LIMIT)) {
+                console.error(`Error: --limit must be an integer 1..${MAX_LIST_LIMIT}.`);
+                process.exit(types_1.ExitCode.CONFIG_ERROR);
+                return;
+            }
+            const client = new api_client_1.ApiClient({ token: options.token });
+            const query = options.limit === undefined ? '' : `?limit=${options.limit}`;
+            const response = await client.get(`/api/worktrees/${worktreeId}/tasks${query}`);
+            const { tasks } = (0, api_client_1.assertResponseShape)(response, ['tasks'], 'GET /api/worktrees/:id/tasks');
+            if (options.json) {
+                console.log(JSON.stringify(tasks));
+                return;
+            }
+            if (tasks.length === 0) {
+                console.error(`No tasks recorded for worktree '${worktreeId}'.`);
+                return;
+            }
+            tasks.forEach(printTaskLine);
+        }
+        catch (error) {
+            (0, command_helpers_1.handleCommandError)(error);
+        }
+    });
+    // ---- task show ----
+    cmd
+        .command('show')
+        .description('Show one task with the verification run that last judged it')
+        .argument('<task-id>', 'Task ID')
+        .option('--json', 'JSON output')
+        .option('--token <token>', command_helpers_1.TOKEN_WARNING)
+        .action(async (taskId, options) => {
+        try {
+            if (!TASK_ID_PATTERN.test(taskId)) {
+                console.error('Error: Invalid task ID format.');
+                process.exit(types_1.ExitCode.CONFIG_ERROR);
+                return;
+            }
+            const client = new api_client_1.ApiClient({ token: options.token });
+            const response = await client.get(`/api/tasks/${taskId}`);
+            const detail = (0, api_client_1.assertResponseShape)(response, ['task', 'lastVerificationRun'], 'GET /api/tasks/:taskId');
+            if (options.json) {
+                console.log(JSON.stringify(detail));
+                return;
+            }
+            const { task, lastVerificationRun } = detail;
+            console.log(`ID:        ${task.id}`);
+            console.log(`STATUS:    ${task.status}`);
+            console.log(`WORKTREE:  ${task.worktreeId}`);
+            console.log(`AGENT:     ${task.cliToolId}${task.instanceId ? `/${task.instanceId}` : ''}`);
+            console.log(`TITLE:     ${task.title}`);
+            console.log(`CONTRACT:  ${task.contractPath ?? '-'}`);
+            console.log(`SCOPE:     ${task.contract.scope.allow.join(', ') || '-'}`);
+            if (task.contract.scope.deny.length > 0) {
+                console.log(`DENY:      ${task.contract.scope.deny.join(', ')}`);
+            }
+            console.log(`GATES:     ${task.contract.verify.gates?.join(', ') ?? 'all-gates'}`);
+            console.log(`AUTO-YES:  ${task.contract.autoYes.mode ?? 'unset'}`);
+            console.log(`CREATED:   ${task.createdAt}`);
+            console.log(`STARTED:   ${formatTimestamp(task.startedAt)}`);
+            console.log(`FINISHED:  ${formatTimestamp(task.finishedAt)}`);
+            if (!lastVerificationRun) {
+                console.log('VERIFY:    (no verification run yet)');
+                return;
+            }
+            console.log(`VERIFY:    run ${lastVerificationRun.id} ${lastVerificationRun.status}`);
+            for (const gate of lastVerificationRun.gates) {
+                const exit = gate.exitCode === null ? '-' : String(gate.exitCode);
+                console.log(`  GATE ${gate.gateId} ${gate.status} (exit=${exit})`);
+            }
+        }
+        catch (error) {
+            (0, command_helpers_1.handleCommandError)(error);
+        }
+    });
+    return cmd;
+}

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

@@ -0,0 +1,19 @@
+/**
+ * verify Command - Run the repository verification gates for a worktree
+ * Issue #1544
+ *
+ * Exit codes:
+ * - 0:   SUCCESS (every gate passed)
+ * - 20:  VERIFY_FAILED (a gate failed, timed out, or errored)
+ * - 21:  NOT_STARTED (work-evidence found nothing to verify)
+ * - 124: TIMEOUT (--timeout elapsed before the run reached a verdict)
+ * Infrastructure errors and verdict-less runs use ExitCode (1, 2, 99).
+ *
+ * Issue #1593 adds two read-only subcommands, `history` and `show`. They never
+ * return 20/21: those codes mean "this working tree failed verification", and a
+ * query about past runs is not a verdict on the current one. A read that
+ * succeeds exits 0 even when it finds nothing.
+ */
+import { Command } from 'commander';
+export declare function createVerifyCommand(): Command;
+//# sourceMappingURL=verify.d.ts.map

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

@@ -0,0 +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;AAoDpC,wBAAgB,mBAAmB,IAAI,OAAO,CA0D7C"}