@staff0rd/assist 0.452.0 → 0.453.1

package/dist/index.js

@@ -6,7 +6,7 @@ import { Command } from "commander";
 // package.json
 var package_default = {
   name: "@staff0rd/assist",
-  version: "0.452.0",
+  version: "0.453.1",
   type: "module",
   main: "dist/index.js",
   bin: {
@@ -7178,7 +7178,8 @@ var KNOWN = [
   "bug",
   "refine",
   "review",
-  "run"
+  "run",
+  "update"
 ];
 function deriveHistoryFields(commandName, commandArgs, name) {
   const fields = {};
@@ -11323,6 +11324,11 @@ function registerImportCommand(cmd) {
 // src/commands/backlog/add/index.ts
 import chalk74 from "chalk";
 
+// src/lib/isClaudeCode.ts
+function isClaudeCode() {
+  return process.env.CLAUDECODE !== void 0;
+}
+
 // src/commands/backlog/insertPhaseAt.ts
 import { eq as eq23 } from "drizzle-orm";
 
@@ -11489,6 +11495,15 @@ async function promptAcceptanceCriteria() {
 
 // src/commands/backlog/add/index.ts
 async function add(options2) {
+  if (isClaudeCode()) {
+    console.error(
+      chalk74.red(
+        "Error: 'assist backlog add' is for human use. Compose the whole item \u2014 name, type, description, acceptance criteria and every phase \u2014 and run 'assist backlog propose --json <file|->' so it is previewed and approved before anything is written."
+      )
+    );
+    process.exitCode = 1;
+    return;
+  }
   if (!ensureRemoteOrigin()) return;
   const type = options2.type ?? await promptType();
   const name = options2.name ?? await promptName();
@@ -11503,7 +11518,7 @@ async function add(options2) {
   console.log(chalk74.green(`Added item ${formatItemId(id)}: ${name}`));
 }
 
-// src/commands/backlog/addPhase.ts
+// src/commands/backlog/addPhase/index.ts
 import chalk76 from "chalk";
 
 // src/commands/backlog/resolveInsertPosition.ts
@@ -11526,76 +11541,8 @@ async function resolveInsertPosition(orm, itemId2, position) {
   return pos - 1;
 }
 
-// src/commands/backlog/addPhase.ts
-async function addPhase(id, name, options2) {
-  if (!ensureRemoteOrigin()) return;
-  const found = await findOneItem(id);
-  if (!found) return;
-  const tasks = options2.task ?? [];
-  if (tasks.length === 0) {
-    console.log(chalk76.red("At least one --task is required."));
-    process.exitCode = 1;
-    return;
-  }
-  const { orm } = found;
-  const itemId2 = found.item.id;
-  const phaseIdx = await resolveInsertPosition(orm, itemId2, options2.position);
-  if (phaseIdx === void 0) return;
-  await insertPhaseAt(
-    orm,
-    itemId2,
-    phaseIdx,
-    name,
-    tasks,
-    serializeManualChecks(options2.manualCheck),
-    found.item.currentPhase
-  );
-  const verb = options2.position !== void 0 ? "Inserted" : "Added";
-  console.log(
-    chalk76.green(
-      `${verb} phase ${phaseIdx + 1} "${name}" to item ${formatItemId(itemId2)} with ${tasks.length} task(s).`
-    )
-  );
-}
-
-// src/commands/backlog/list/index.ts
-import chalk77 from "chalk";
-function filterItems(items2, options2) {
-  if (options2.status) return items2.filter((i) => i.status === options2.status);
-  if (!options2.all)
-    return items2.filter((i) => i.status !== "done" && i.status !== "wontdo");
-  return items2;
-}
-function repoPrefixer(items2, allRepos) {
-  if (!allRepos) return () => "";
-  const labels = originDisplayLabels(
-    items2.flatMap((i) => i.origin ? [i.origin] : [])
-  );
-  const repoNameOf = (item) => item.origin ? labels.get(item.origin) ?? "" : "";
-  const width = Math.max(0, ...items2.map((i) => repoNameOf(i).length));
-  return (item) => `${chalk77.dim(repoNameOf(item).padEnd(width))} `;
-}
-async function list2(options2) {
-  const allItems = await loadBacklog(options2.allRepos);
-  const items2 = filterItems(allItems, options2);
-  if (items2.length === 0) {
-    console.log(chalk77.dim("Backlog is empty."));
-    return;
-  }
-  const prefixOf = repoPrefixer(items2, !!options2.allRepos);
-  for (const item of items2) {
-    console.log(
-      `${prefixOf(item)}${statusIcon(item.status)} ${typeLabel(item.type)} ${chalk77.dim(formatItemId(item.id))} ${starMarker(item)}${item.name}${phaseLabel(item)}${dependencyLabel(item, allItems)}`
-    );
-    if (options2.verbose) {
-      printVerboseDetails(item);
-    }
-  }
-}
-
-// src/commands/backlog/propose/index.ts
+// src/commands/backlog/addPhase/reviewProposedPhase.ts
 import { randomUUID as randomUUID2 } from "crypto";
-import chalk79 from "chalk";
 
 // src/commands/sessions/shared/reportPreviewRejection.ts
 function reportPreviewRejection(subject, decision) {
@@ -11687,6 +11634,113 @@ async function awaitPreviewApproval(subject, request) {
   return decision;
 }
 
+// src/commands/backlog/renderPhaseSection.ts
+function renderPhaseSection(phase, idx) {
+  const parts = [
+    `### Phase ${idx + 1}: ${phase.name}`,
+    phase.tasks.map((task) => `- ${task}`).join("\n")
+  ];
+  const manualChecks = phase.manualChecks ?? [];
+  if (manualChecks.length > 0)
+    parts.push(
+      "**Manual checks:**",
+      manualChecks.map((check2) => `- ${check2}`).join("\n")
+    );
+  return parts.join("\n\n");
+}
+
+// src/commands/backlog/addPhase/reviewProposedPhase.ts
+async function reviewProposedPhase(item, phaseIdx, phase) {
+  const sessionId = process.env.ASSIST_SESSION_ID;
+  if (!isClaudeCode() || process.env.ASSIST_SESSION !== "1" || !sessionId)
+    return;
+  await awaitPreviewApproval("Backlog phase preview", {
+    sessionId,
+    requestId: randomUUID2(),
+    title: `Add a phase to ${formatItemId(item.id)}: ${item.name}`,
+    body: renderPhaseSection(phase, phaseIdx),
+    prNumber: null,
+    kind: "backlog-item",
+    itemType: item.type
+  });
+}
+
+// src/commands/backlog/addPhase/index.ts
+async function addPhase(id, name, options2) {
+  if (!ensureRemoteOrigin()) return;
+  const found = await findOneItem(id);
+  if (!found) return;
+  const tasks = options2.task ?? [];
+  if (tasks.length === 0) {
+    console.log(chalk76.red("At least one --task is required."));
+    process.exitCode = 1;
+    return;
+  }
+  const { orm } = found;
+  const itemId2 = found.item.id;
+  const phaseIdx = await resolveInsertPosition(orm, itemId2, options2.position);
+  if (phaseIdx === void 0) return;
+  await reviewProposedPhase(found.item, phaseIdx, {
+    name,
+    tasks,
+    manualChecks: options2.manualCheck
+  });
+  await insertPhaseAt(
+    orm,
+    itemId2,
+    phaseIdx,
+    name,
+    tasks,
+    serializeManualChecks(options2.manualCheck),
+    found.item.currentPhase
+  );
+  const verb = options2.position !== void 0 ? "Inserted" : "Added";
+  console.log(
+    chalk76.green(
+      `${verb} phase ${phaseIdx + 1} "${name}" to item ${formatItemId(itemId2)} with ${tasks.length} task(s).`
+    )
+  );
+}
+
+// src/commands/backlog/list/index.ts
+import chalk77 from "chalk";
+function filterItems(items2, options2) {
+  if (options2.status) return items2.filter((i) => i.status === options2.status);
+  if (!options2.all)
+    return items2.filter((i) => i.status !== "done" && i.status !== "wontdo");
+  return items2;
+}
+function repoPrefixer(items2, allRepos) {
+  if (!allRepos) return () => "";
+  const labels = originDisplayLabels(
+    items2.flatMap((i) => i.origin ? [i.origin] : [])
+  );
+  const repoNameOf = (item) => item.origin ? labels.get(item.origin) ?? "" : "";
+  const width = Math.max(0, ...items2.map((i) => repoNameOf(i).length));
+  return (item) => `${chalk77.dim(repoNameOf(item).padEnd(width))} `;
+}
+async function list2(options2) {
+  const allItems = await loadBacklog(options2.allRepos);
+  const items2 = filterItems(allItems, options2);
+  if (items2.length === 0) {
+    console.log(chalk77.dim("Backlog is empty."));
+    return;
+  }
+  const prefixOf = repoPrefixer(items2, !!options2.allRepos);
+  for (const item of items2) {
+    console.log(
+      `${prefixOf(item)}${statusIcon(item.status)} ${typeLabel(item.type)} ${chalk77.dim(formatItemId(item.id))} ${starMarker(item)}${item.name}${phaseLabel(item)}${dependencyLabel(item, allItems)}`
+    );
+    if (options2.verbose) {
+      printVerboseDetails(item);
+    }
+  }
+}
+
+// src/commands/backlog/propose/index.ts
+import { randomUUID as randomUUID3 } from "crypto";
+import chalk79 from "chalk";
+
 // src/commands/backlog/propose/readProposedItem.ts
 import { readFileSync as readFileSync23 } from "fs";
 import chalk78 from "chalk";
@@ -11742,18 +11796,6 @@ ${issues}`);
 }
 
 // src/commands/backlog/propose/renderProposedItem.ts
-function renderPhase(phase, i) {
-  const parts = [
-    `### Phase ${i + 1}: ${phase.name}`,
-    phase.tasks.map((task) => `- ${task}`).join("\n")
-  ];
-  if (phase.manualChecks.length > 0)
-    parts.push(
-      "**Manual checks:**",
-      phase.manualChecks.map((check2) => `- ${check2}`).join("\n")
-    );
-  return parts.join("\n\n");
-}
 function renderProposedItem(item) {
   const sections = [`**Type:** ${item.type}`];
   if (item.description) sections.push("## Description", item.description);
@@ -11763,7 +11805,7 @@ function renderProposedItem(item) {
       item.acceptanceCriteria.map((ac, i) => `${i + 1}. ${ac}`).join("\n")
     );
   if (item.phases.length > 0)
-    sections.push("## Plan", ...item.phases.map(renderPhase));
+    sections.push("## Plan", ...item.phases.map(renderPhaseSection));
   return sections.join("\n\n");
 }
 
@@ -11774,7 +11816,7 @@ async function reviewProposal(item) {
   if (process.env.ASSIST_SESSION === "1" && sessionId) {
     await awaitPreviewApproval("Backlog item preview", {
       sessionId,
-      requestId: randomUUID2(),
+      requestId: randomUUID3(),
       title: item.name,
       body,
       prNumber: null,
@@ -12047,7 +12089,7 @@ import chalk87 from "chalk";
 import enquirer7 from "enquirer";
 
 // src/commands/backlog/launchMode.ts
-import { randomUUID as randomUUID3 } from "crypto";
+import { randomUUID as randomUUID4 } from "crypto";
 
 // src/shared/spawnCodex.ts
 function spawnCodex(prompt, options2 = {}) {
@@ -12168,7 +12210,7 @@ async function launchMode(slashCommand, options2) {
   const resumeSessionId = options2?.resumeSessionId;
   if (!resumeSessionId) pullIfConfigured();
   process.env.ASSIST_SESSION_ID ??= String(process.pid);
-  const claudeSessionId = resumeSessionId ?? randomUUID3();
+  const claudeSessionId = resumeSessionId ?? randomUUID4();
   emitActivity({
     kind: "command",
     name: slashCommand,
@@ -13950,11 +13992,6 @@ function colorize(plainOutput) {
   }).join("\n");
 }
 
-// src/lib/isClaudeCode.ts
-function isClaudeCode() {
-  return process.env.CLAUDECODE !== void 0;
-}
-
 // src/commands/permitCliReads/mapAsync.ts
 async function mapAsync(items2, concurrency, fn) {
   const results = Array.from({ length: items2.length });
@@ -17641,7 +17678,7 @@ function registerRefineLaunch(program2, resumeFlag) {
 }
 
 // src/commands/reviewPrComments.ts
-import { randomUUID as randomUUID4 } from "crypto";
+import { randomUUID as randomUUID5 } from "crypto";
 
 // src/commands/review/checkoutPr.ts
 import { execFileSync as execFileSync6 } from "child_process";
@@ -18029,7 +18066,7 @@ async function checkoutPr(number) {
 // src/commands/reviewPrComments.ts
 async function reviewPrComments(number) {
   if (number) await checkoutPr(number);
-  const claudeSessionId = randomUUID4();
+  const claudeSessionId = randomUUID5();
   emitActivity({
     kind: "command",
     name: "review-pr-comments",
@@ -19885,7 +19922,7 @@ async function placePr(prNumber, title, body, options2) {
 }
 
 // src/commands/prs/previewAndPlace.ts
-import { randomUUID as randomUUID5 } from "crypto";
+import { randomUUID as randomUUID6 } from "crypto";
 
 // src/commands/prs/appendScreenshots.ts
 function appendScreenshots(body, screenshots) {
@@ -19901,7 +19938,7 @@ ${screenshots.join("\n\n")}`;
 async function previewAndPlace(args) {
   const decision = await awaitPreviewApproval("PR preview", {
     sessionId: args.sessionId,
-    requestId: randomUUID5(),
+    requestId: randomUUID6(),
     title: args.title,
     body: args.body,
     prNumber: args.prNumber
@@ -26730,7 +26767,7 @@ var ClientHub = class extends Set {
 };
 
 // src/commands/sessions/daemon/createSession.ts
-import { randomUUID as randomUUID6 } from "crypto";
+import { randomUUID as randomUUID7 } from "crypto";
 
 // src/commands/sessions/daemon/resolveRunConfig.ts
 function resolveRunConfig(name, cwd) {
@@ -26869,7 +26906,7 @@ function sessionBase(id, status3) {
 // src/commands/sessions/daemon/createSession.ts
 function createSession(id, prompt, cwd, design, harness, holdPty) {
   if (harness === "pi") return createPiSession(id, prompt, cwd, holdPty);
-  const claudeSessionId = randomUUID6();
+  const claudeSessionId = randomUUID7();
   return {
     ...sessionBase(id, prompt ? "running" : "waiting"),
     name: prompt?.slice(0, 40) || `Session ${id}`,
@@ -28185,7 +28222,7 @@ function respawnSession(session, respawn, status3, clients, onStatusChange) {
 }
 
 // src/commands/sessions/daemon/respawnPlan.ts
-import { randomUUID as randomUUID7 } from "crypto";
+import { randomUUID as randomUUID8 } from "crypto";
 
 // src/commands/sessions/daemon/assistResumeArgs.ts
 function assistResumeArgs(session) {
@@ -28226,7 +28263,7 @@ function respawnPlan(session) {
   return null;
 }
 function freshClaudePlan(session, prompt, cwd) {
-  const claudeSessionId = randomUUID7();
+  const claudeSessionId = randomUUID8();
   return {
     spawn: () => {
       session.claudeSessionId = claudeSessionId;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@staff0rd/assist",
-	"version": "0.452.0",
+	"version": "0.453.1",
 	"type": "module",
 	"main": "dist/index.js",
 	"bin": {