@sechroom/cli 2026.7.26 → 2026.7.28

package/dist/index.js

@@ -3556,29 +3556,30 @@ Examples:
   });
 }
 
-// src/commands/decomposition.ts
+// src/commands/work-plan.ts
 import { readFile } from "fs/promises";
-function registerDecomposition(program2) {
-  const decomposition = program2.command("decomposition").description(
-    "Drive a WLP decomposition: decompose a brief, then execute / accept / reject"
+function registerWorkPlan(program2) {
+  const workPlan = program2.command("work-plan").description(
+    "Drive a work plan: create one from a brief, then execute / accept / reject"
   );
-  decomposition.addHelpText(
+  workPlan.addHelpText(
     "after",
     `
 Examples:
-  $ sechroom decomposition decompose mem_XXXX
-  $ sechroom decomposition from-plan mem_XXXX --file plan.json
-  $ sechroom decomposition plan wlp_XXXX
-  $ sechroom decomposition execute sug_XXXX
-  $ sechroom decomposition publish-run sug_XXXX
-  $ sechroom decomposition accept sug_XXXX
-  $ sechroom decomposition reject sug_XXXX --reason "wrong shape"`
+  $ sechroom work-plan create mem_XXXX
+  $ sechroom work-plan create-from-tasks mem_XXXX --file plan.json
+  $ sechroom work-plan append wlp_XXXX --file append.json
+  $ sechroom work-plan get-plan wlp_XXXX
+  $ sechroom work-plan execute wlp_XXXX
+  $ sechroom work-plan publish-context-pack wlp_XXXX
+  $ sechroom work-plan accept wlp_XXXX
+  $ sechroom work-plan reject wlp_XXXX --reason "wrong shape"`
   );
-  decomposition.command("decompose <briefId>").description(
-    "Decompose a work brief into a candidate Task graph (POST /work-briefs/{id}/decompose)"
+  workPlan.command("create <briefId>").description(
+    "Create a work plan from a work brief \u2014 a candidate Task graph (POST /work-briefs/{id}/decompose)"
   ).action(async (briefId, _opts, cmd) => {
     const cfg = resolveConfig(cmd.optsWithGlobals());
-    const data = await runApi("Queueing decomposition", async () => {
+    const data = await runApi("Creating work plan", async () => {
       const client = await makeClient(cfg);
       return client.POST("/work-briefs/{id}/decompose", {
         params: { path: { id: briefId } },
@@ -3586,13 +3587,13 @@ Examples:
       });
     });
     emitAction(
-      `queued decomposition of ${style.bold(briefId)} \u2192 ${style.bold(data.suggestionId)}`,
+      `created work plan from ${style.bold(briefId)} \u2192 ${style.bold(data.suggestionId)}`,
       data,
       cmd.optsWithGlobals().json
     );
   });
-  decomposition.command("from-plan <briefId>").description(
-    "Create a decomposition from a hand-authored JSON plan; tasks may carry Unix-millisecond wakeAtMs"
+  workPlan.command("create-from-tasks <briefId>").description(
+    "Create a work plan from a hand-authored JSON task list; tasks may carry Unix-millisecond wakeAtMs"
   ).requiredOption(
     "--file <path>",
     "JSON file containing { project, tasks, source? }; use - for stdin"
@@ -3601,7 +3602,7 @@ Examples:
     const body = parsePlanInput(raw, opts.file);
     const cfg = resolveConfig(cmd.optsWithGlobals());
     const data = await runApi(
-      "Creating decomposition from plan",
+      "Creating work plan from tasks",
       async () => {
         const client = await makeClient(cfg);
         return client.POST("/work-briefs/{id}/decompose-from-plan", {
@@ -3616,11 +3617,33 @@ Examples:
       cmd.optsWithGlobals().json
     );
   });
-  decomposition.command("plan <decompositionId>").description(
+  workPlan.command("append <decompositionId>").description(
+    "Append hand-authored task(s) to a running work plan; they land proposed until ratified (POST /decompositions/{id}/append-tasks)"
+  ).requiredOption(
+    "--file <path>",
+    "JSON file containing { tasks, gates? } (the AppendTasksInput shape); use - for stdin"
+  ).action(async (decompositionId, opts, cmd) => {
+    const raw = opts.file === "-" ? await readStdin2() : await readFile(opts.file, "utf8");
+    const body = parseAppendInput(raw, opts.file);
+    const cfg = resolveConfig(cmd.optsWithGlobals());
+    const data = await runApi("Appending tasks to work plan", async () => {
+      const client = await makeClient(cfg);
+      return client.POST("/decompositions/{id}/append-tasks", {
+        params: { path: { id: decompositionId } },
+        body
+      });
+    });
+    emitAction(
+      `appended ${style.bold(String(data.appendedTaskIds.length))} task(s) to ${style.bold(decompositionId)}`,
+      data,
+      cmd.optsWithGlobals().json
+    );
+  });
+  workPlan.command("get-plan <decompositionId>").description(
     "Inspect the compiled plan, including each scheduled step's Unix-millisecond wakeAtMs"
   ).action(async (decompositionId, _opts, cmd) => {
     const cfg = resolveConfig(cmd.optsWithGlobals());
-    const data = await runApi("Reading decomposition plan", async () => {
+    const data = await runApi("Reading work plan", async () => {
       const client = await makeClient(cfg);
       return client.GET("/decompositions/{id}/plan", {
         params: { path: { id: decompositionId } }
@@ -3632,11 +3655,11 @@ Examples:
       cmd.optsWithGlobals().json
     );
   });
-  decomposition.command("execute <decompositionId>").description(
-    "Execute a decomposition's Task graph (POST /decompositions/{id}/execute)"
+  workPlan.command("execute <decompositionId>").description(
+    "Execute a work plan's Task graph (POST /decompositions/{id}/execute)"
   ).action(async (decompositionId, _opts, cmd) => {
     const cfg = resolveConfig(cmd.optsWithGlobals());
-    const data = await runApi("Executing decomposition", async () => {
+    const data = await runApi("Executing work plan", async () => {
       const client = await makeClient(cfg);
       return client.POST("/decompositions/{id}/execute", {
         params: { path: { id: decompositionId } },
@@ -3649,8 +3672,8 @@ Examples:
       cmd.optsWithGlobals().json
     );
   });
-  decomposition.command("publish-run <decompositionId>").description(
-    "Publish an accepted decomposition's context pack on demand (POST /decompositions/{id}/publish-run)"
+  workPlan.command("publish-context-pack <decompositionId>").description(
+    "Publish an accepted work plan's context pack on demand (POST /decompositions/{id}/publish-run)"
   ).action(async (decompositionId, _opts, cmd) => {
     const cfg = resolveConfig(cmd.optsWithGlobals());
     const data = await runApi("Publishing context pack", async () => {
@@ -3666,11 +3689,11 @@ Examples:
       cmd.optsWithGlobals().json
     );
   });
-  decomposition.command("accept <decompositionId>").description(
-    "Accept a Pending decomposition \u2014 promote + ratify its Tasks (POST /decompositions/{id}/accept)"
+  workPlan.command("accept <decompositionId>").description(
+    "Accept a Pending work plan \u2014 promote + ratify its Tasks (POST /decompositions/{id}/accept)"
   ).action(async (decompositionId, _opts, cmd) => {
     const cfg = resolveConfig(cmd.optsWithGlobals());
-    const data = await runApi("Accepting decomposition", async () => {
+    const data = await runApi("Accepting work plan", async () => {
       const client = await makeClient(cfg);
       return client.POST("/decompositions/{id}/accept", {
         params: { path: { id: decompositionId } },
@@ -3678,16 +3701,16 @@ Examples:
       });
     });
     emitAction(
-      `accepted decomposition ${style.bold(decompositionId)}`,
+      `accepted work plan ${style.bold(decompositionId)}`,
       data,
       cmd.optsWithGlobals().json
     );
   });
-  decomposition.command("reject <decompositionId>").description(
-    "Reject a Pending decomposition \u2014 archive its Tasks, bounce the brief (POST /decompositions/{id}/reject)"
+  workPlan.command("reject <decompositionId>").description(
+    "Reject a Pending work plan \u2014 archive its Tasks, bounce the brief (POST /decompositions/{id}/reject)"
   ).option("--reason <reason>", "Optional free-text rejection reason").action(async (decompositionId, opts, cmd) => {
     const cfg = resolveConfig(cmd.optsWithGlobals());
-    const data = await runApi("Rejecting decomposition", async () => {
+    const data = await runApi("Rejecting work plan", async () => {
       const client = await makeClient(cfg);
       return client.POST("/decompositions/{id}/reject", {
         params: { path: { id: decompositionId } },
@@ -3695,12 +3718,25 @@ Examples:
       });
     });
     emitAction(
-      `rejected decomposition ${style.bold(decompositionId)}`,
+      `rejected work plan ${style.bold(decompositionId)}`,
       data,
       cmd.optsWithGlobals().json
     );
   });
 }
+function parseAppendInput(raw, sourceName = "append input") {
+  let value;
+  try {
+    value = JSON.parse(raw);
+  } catch (error) {
+    throw new Error(
+      `${sourceName} is not valid JSON: ${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+  if (!value || typeof value !== "object" || !Array.isArray(value.tasks))
+    throw new Error(`${sourceName} must contain an object with a tasks array`);
+  return value;
+}
 function parsePlanInput(raw, sourceName = "plan input") {
   let value;
   try {
@@ -6511,6 +6547,23 @@ function registerTelemetry(program2) {
       );
     }
   });
+  telemetry.command("show <decompositionId>").description(
+    "Read a run's telemetry \u2014 per-task meters + the raw/parsed/approval/terminal timeline (GET /decompositions/{id}/run/telemetry). Returns hasTelemetry:false, not an error, before any event is ingested \u2014 so an unstarted run and a stalled one read differently. The read side of this group; `emit` is the source side. (FR-sechroom-442 slice 1 step 4; mirrors the work_plan_run_telemetry MCP tool.)"
+  ).action(async (decompositionId, _opts, cmd) => {
+    const globals = cmd.optsWithGlobals();
+    const cfg = resolveConfig(globals);
+    const data = await runApi("Reading run telemetry", async () => {
+      const client = await makeClient(cfg);
+      return client.GET("/decompositions/{id}/run/telemetry", {
+        params: { path: { id: decompositionId } }
+      });
+    });
+    emitAction(
+      data.hasTelemetry ? `read telemetry for ${style.bold(decompositionId)}` : `no telemetry yet for ${style.bold(decompositionId)} (run not started or not yet reporting)`,
+      data,
+      globals.json
+    );
+  });
   telemetry.command("bind").description(
     "Bind this checkout to a decomposition+task so the Stop hook auto-emits per-turn telemetry"
   ).requiredOption(
@@ -7025,6 +7078,77 @@ function capitalize(value) {
   return value.charAt(0).toUpperCase() + value.slice(1);
 }
 
+// src/commands/work-task.ts
+function registerWorkTask(program2) {
+  const workTask = program2.command("work-task").description("Read work tasks and close them out (list \xB7 card \xB7 mark-no-residue)");
+  workTask.addHelpText(
+    "after",
+    `
+Examples:
+  $ sechroom work-task list --status in-progress --lane claude-code-chris
+  $ sechroom work-task card mem_XXXX
+  $ sechroom work-task mark-no-residue mem_XXXX --decomposition wlp_XXXX`
+  );
+  workTask.command("list").description("List work tasks, newest-first (GET /work-tasks)").option("--shape <shape>", "Filter: bare | managed").option("--lane <lane>", "Filter by dispatch-lane value, e.g. claude-code-chris").option("--status <status>", "Filter by status value, e.g. in-progress").option("--page <n>", "1-based page number", (v) => Number.parseInt(v, 10)).option(
+    "--page-size <n>",
+    "Page size (default 50, capped 200)",
+    (v) => Number.parseInt(v, 10)
+  ).action(async (opts, cmd) => {
+    const globals = cmd.optsWithGlobals();
+    const cfg = resolveConfig(globals);
+    const data = await runApi("Listing work tasks", async () => {
+      const client = await makeClient(cfg);
+      return client.GET("/work-tasks", {
+        params: {
+          query: {
+            shape: opts.shape,
+            lane: opts.lane,
+            status: opts.status,
+            page: opts.page,
+            pageSize: opts.pageSize
+          }
+        }
+      });
+    });
+    emitAction(
+      `listed ${style.bold(String(data.items.length))} of ${data.count} task(s)`,
+      data,
+      globals.json
+    );
+  });
+  workTask.command("card <taskId>").description("Read one task's runnable card \u2014 its full working instructions (GET /tasks/{id}/card)").action(async (taskId, _opts, cmd) => {
+    const globals = cmd.optsWithGlobals();
+    const cfg = resolveConfig(globals);
+    const data = await runApi("Reading task card", async () => {
+      const client = await makeClient(cfg);
+      return client.GET("/tasks/{id}/card", {
+        params: { path: { id: taskId } }
+      });
+    });
+    emitAction(`read card ${style.bold(taskId)}`, data, globals.json);
+  });
+  workTask.command("mark-no-residue <taskId>").description(
+    "Mark a task as having produced no residue \u2014 the explicit no-residue marker that lets a lane finish a run it drove end-to-end (POST /work-tasks/mark-no-residue)"
+  ).requiredOption(
+    "--decomposition <id>",
+    "The work plan id (wlp_\u2026) the task belongs to \u2014 the marker is keyed (decompositionId, taskId)"
+  ).action(async (taskId, opts, cmd) => {
+    const globals = cmd.optsWithGlobals();
+    const cfg = resolveConfig(globals);
+    const data = await runApi("Marking task no-residue", async () => {
+      const client = await makeClient(cfg);
+      return client.POST("/work-tasks/mark-no-residue", {
+        body: { taskId, decompositionId: opts.decomposition }
+      });
+    });
+    emitAction(
+      `marked ${style.bold(taskId)} no-residue (minted: ${data.minted})`,
+      data,
+      globals.json
+    );
+  });
+}
+
 // src/index.ts
 function resolveVersion() {
   try {
@@ -7188,7 +7312,8 @@ registerRelationships(program);
 registerWorkspace(program);
 registerProject(program);
 registerWorkBrief(program);
-registerDecomposition(program);
+registerWorkTask(program);
+registerWorkPlan(program);
 registerExecutor(program);
 registerClose(program);
 registerFiling(program);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sechroom/cli",
-  "version": "2026.7.26",
+  "version": "2026.7.28",
   "description": "Sechroom CLI — a thin, generated client over the Sechroom HTTP API. An agent/human surface alongside MCP.",
   "type": "module",
   "license": "UNLICENSED",