@staff0rd/assist 0.148.0 → 0.149.0

package/dist/index.js

@@ -6,7 +6,7 @@ import { Command } from "commander";
 // package.json
 var package_default = {
   name: "@staff0rd/assist",
-  version: "0.148.0",
+  version: "0.149.0",
   type: "module",
   main: "dist/index.js",
   bin: {
@@ -2286,8 +2286,7 @@ async function notify() {
   console.log(`Notification sent: ${notification_type} for ${projectName}`);
 }
 
-// src/commands/backlog/add/index.ts
-import { existsSync as existsSync13 } from "fs";
+// src/commands/backlog/delete/index.ts
 import chalk26 from "chalk";
 
 // src/commands/backlog/shared.ts
@@ -2394,196 +2393,59 @@ function readStdin2() {
   });
 }
 
-// src/commands/backlog/add/shared.ts
-import { spawnSync } from "child_process";
-import { mkdtempSync, readFileSync as readFileSync11, unlinkSync as unlinkSync2, writeFileSync as writeFileSync12 } from "fs";
-import { tmpdir } from "os";
-import { join as join9 } from "path";
-import enquirer4 from "enquirer";
-async function promptType() {
-  const { type } = await enquirer4.prompt({
-    type: "select",
-    name: "type",
-    message: "Type:",
-    choices: ["story", "bug"],
-    initial: 0
-  });
-  return type;
-}
-async function promptName() {
-  const { name } = await enquirer4.prompt({
-    type: "input",
-    name: "name",
-    message: "Name:",
-    validate: (value) => value.trim().length > 0 || "Name is required"
-  });
-  return name.trim();
-}
-async function promptDescription() {
-  const { useEditor } = await enquirer4.prompt({
-    type: "confirm",
-    name: "useEditor",
-    message: "Open editor for description?",
-    initial: false
-  });
-  if (!useEditor) {
-    const { description } = await enquirer4.prompt({
-      type: "input",
-      name: "description",
-      message: "Description (optional):"
-    });
-    return description.trim() || void 0;
-  }
-  return openEditor();
-}
-function openEditor() {
-  const editor = process.env.EDITOR || process.env.VISUAL || "vi";
-  const dir = mkdtempSync(join9(tmpdir(), "assist-"));
-  const filePath = join9(dir, "description.md");
-  writeFileSync12(filePath, "");
-  const result = spawnSync(editor, [filePath], { stdio: "inherit" });
-  if (result.status !== 0) {
-    unlinkSync2(filePath);
-    return void 0;
-  }
-  const content = readFileSync11(filePath, "utf-8").trim();
-  unlinkSync2(filePath);
-  return content || void 0;
-}
-async function promptAcceptanceCriteria() {
-  const criteria = [];
-  for (; ; ) {
-    const { criterion } = await enquirer4.prompt({
-      type: "input",
-      name: "criterion",
-      message: "Acceptance criterion (empty to finish):"
-    });
-    if (criterion.trim() === "") break;
-    criteria.push(criterion.trim());
-  }
-  return criteria;
-}
-
-// src/commands/backlog/add/index.ts
-var addItemSchema = backlogItemSchema.omit({ id: true, status: true });
-async function addFromJson() {
-  if (process.stdin.isTTY) {
-    console.log(chalk26.red("--json requires piped input on stdin."));
-    return;
-  }
-  const input = await readStdin2();
-  const sanitised = input.replace(
-    /"(?:[^"\\]|\\.)*"/g,
-    (match) => match.replace(/\n/g, "\\n").replace(/\r/g, "\\r").replace(/\t/g, "\\t")
-  );
-  const data = addItemSchema.parse(JSON.parse(sanitised));
-  const items = loadBacklog();
-  const id = getNextId(items);
-  items.push({ ...data, id, status: "todo" });
-  saveBacklog(items);
-  console.log(chalk26.green(`Added item #${id}: ${data.name}`));
-}
-async function addInteractive() {
-  const type = await promptType();
-  const name = await promptName();
-  const description = await promptDescription();
-  const acceptanceCriteria2 = await promptAcceptanceCriteria();
-  const items = loadBacklog();
-  const id = getNextId(items);
-  items.push({
-    id,
-    type,
-    name,
-    description,
-    acceptanceCriteria: acceptanceCriteria2,
-    status: "todo"
-  });
-  saveBacklog(items);
-  console.log(chalk26.green(`Added item #${id}: ${name}`));
-}
-async function add(options2) {
-  if (!existsSync13(getBacklogPath())) {
-    console.log(
-      chalk26.yellow(
-        "No backlog found. Run 'assist backlog init' to create one."
-      )
-    );
-    return;
-  }
-  if (options2.json) {
-    await addFromJson();
-  } else {
-    await addInteractive();
-  }
-}
-
 // src/commands/backlog/delete/index.ts
-import chalk27 from "chalk";
 async function del(id) {
   const name = removeItem(id);
   if (name) {
-    console.log(chalk27.green(`Deleted item #${id}: ${name}`));
+    console.log(chalk26.green(`Deleted item #${id}: ${name}`));
   }
 }
 
 // src/commands/backlog/done/index.ts
-import chalk28 from "chalk";
+import chalk27 from "chalk";
 async function done(id) {
   const name = setStatus(id, "done");
   if (name) {
-    console.log(chalk28.green(`Completed item #${id}: ${name}`));
-  }
-}
-
-// src/commands/backlog/init/index.ts
-import { existsSync as existsSync14 } from "fs";
-import chalk29 from "chalk";
-async function init6() {
-  const backlogPath = getBacklogPath();
-  if (existsSync14(backlogPath)) {
-    console.log(chalk29.yellow("assist.backlog.yml already exists."));
-    return;
+    console.log(chalk27.green(`Completed item #${id}: ${name}`));
   }
-  saveBacklog([]);
-  console.log(chalk29.green("Created assist.backlog.yml"));
 }
 
-// src/commands/backlog/list/index.ts
-import { existsSync as existsSync15 } from "fs";
-import chalk31 from "chalk";
+// src/commands/backlog/next.ts
+import chalk33 from "chalk";
+import enquirer5 from "enquirer";
 
 // src/commands/backlog/list/shared.ts
-import chalk30 from "chalk";
+import chalk28 from "chalk";
 function statusIcon(status2) {
   switch (status2) {
     case "todo":
-      return chalk30.dim("[ ]");
+      return chalk28.dim("[ ]");
     case "in-progress":
-      return chalk30.yellow("[~]");
+      return chalk28.yellow("[~]");
     case "done":
-      return chalk30.green("[x]");
+      return chalk28.green("[x]");
   }
 }
 function typeLabel(type) {
   switch (type) {
     case "bug":
-      return chalk30.magenta("Bug");
+      return chalk28.magenta("Bug");
     case "story":
-      return chalk30.cyan("Story");
+      return chalk28.cyan("Story");
   }
 }
 function phaseLabel(item) {
   if (!item.plan) return "";
-  return chalk30.dim(
+  return chalk28.dim(
     ` (phase ${(item.currentPhase ?? 0) + 1}/${item.plan.length})`
   );
 }
 function printVerboseDetails(item) {
   if (item.description) {
-    console.log(`  ${chalk30.dim("Description:")} ${item.description}`);
+    console.log(`  ${chalk28.dim("Description:")} ${item.description}`);
   }
   if (item.acceptanceCriteria.length > 0) {
-    console.log(`  ${chalk30.dim("Acceptance criteria:")}`);
+    console.log(`  ${chalk28.dim("Acceptance criteria:")}`);
     for (const [i, criterion] of item.acceptanceCriteria.entries()) {
       console.log(`    ${i + 1}. ${criterion}`);
     }
@@ -2591,42 +2453,8 @@ function printVerboseDetails(item) {
   console.log();
 }
 
-// src/commands/backlog/list/index.ts
-function filterItems(items, options2) {
-  if (options2.status) return items.filter((i) => i.status === options2.status);
-  if (!options2.all) return items.filter((i) => i.status !== "done");
-  return items;
-}
-async function list2(options2) {
-  if (!existsSync15(getBacklogPath())) {
-    console.log(
-      chalk31.yellow(
-        "No backlog found. Run 'assist backlog init' to create one."
-      )
-    );
-    return;
-  }
-  const items = filterItems(loadBacklog(), options2);
-  if (items.length === 0) {
-    console.log(chalk31.dim("Backlog is empty."));
-    return;
-  }
-  for (const item of items) {
-    console.log(
-      `${statusIcon(item.status)} ${typeLabel(item.type)} ${chalk31.dim(`#${item.id}`)} ${item.name}${phaseLabel(item)}`
-    );
-    if (options2.verbose) {
-      printVerboseDetails(item);
-    }
-  }
-}
-
-// src/commands/backlog/next.ts
-import chalk36 from "chalk";
-import enquirer6 from "enquirer";
-
 // src/commands/backlog/run.ts
-import chalk35 from "chalk";
+import chalk32 from "chalk";
 
 // src/commands/backlog/buildAuthoredPhasePrompt.ts
 function buildAuthoredPhasePrompt(item, phaseIndex, phase) {
@@ -2726,16 +2554,16 @@ function buildReviewPhase() {
 }
 
 // src/commands/backlog/executePhase.ts
-import chalk34 from "chalk";
+import chalk31 from "chalk";
 
 // src/commands/backlog/resolvePhaseResult.ts
-import { existsSync as existsSync16, unlinkSync as unlinkSync3 } from "fs";
-import chalk33 from "chalk";
+import { existsSync as existsSync13, unlinkSync as unlinkSync2 } from "fs";
+import chalk30 from "chalk";
 
 // src/commands/backlog/handleIncompletePhase.ts
-import enquirer5 from "enquirer";
+import enquirer4 from "enquirer";
 async function handleIncompletePhase() {
-  const { action } = await enquirer5.prompt({
+  const { action } = await enquirer4.prompt({
     type: "select",
     name: "action",
     message: "Phase was not marked complete. What would you like to do?",
@@ -2747,17 +2575,17 @@ async function handleIncompletePhase() {
 }
 
 // src/commands/backlog/phaseDone.ts
-import { writeFileSync as writeFileSync13 } from "fs";
-import { join as join10 } from "path";
-import chalk32 from "chalk";
+import { writeFileSync as writeFileSync12 } from "fs";
+import { join as join9 } from "path";
+import chalk29 from "chalk";
 var PHASE_STATUS_FILE = ".assist-phase-status.json";
 function getPhaseStatusPath() {
-  return join10(process.cwd(), PHASE_STATUS_FILE);
+  return join9(process.cwd(), PHASE_STATUS_FILE);
 }
 function phaseDone(id, phase) {
   const phaseIndex = Number.parseInt(phase, 10);
   const statusPath = getPhaseStatusPath();
-  writeFileSync13(
+  writeFileSync12(
     statusPath,
     JSON.stringify({
       itemId: Number.parseInt(id, 10),
@@ -2766,32 +2594,36 @@ function phaseDone(id, phase) {
     })
   );
   setCurrentPhase(id, phaseIndex + 1);
-  console.log(chalk32.green(`Phase ${phase} of item #${id} marked as complete.`));
+  console.log(chalk29.green(`Phase ${phase} of item #${id} marked as complete.`));
 }
 
 // src/commands/backlog/resolvePhaseResult.ts
 function cleanupMarker() {
   const statusPath = getPhaseStatusPath();
-  if (existsSync16(statusPath)) {
-    unlinkSync3(statusPath);
+  if (existsSync13(statusPath)) {
+    unlinkSync2(statusPath);
   }
 }
 async function resolvePhaseResult(phaseIndex) {
-  if (!existsSync16(getPhaseStatusPath())) {
+  if (!existsSync13(getPhaseStatusPath())) {
     const action = await handleIncompletePhase();
     if (action === "abort") return -1;
     return action === "skip" ? 1 : 0;
   }
   cleanupMarker();
-  console.log(chalk33.green(`
+  console.log(chalk30.green(`
 Phase ${phaseIndex + 1} completed.`));
   return 1;
 }
 
 // src/commands/backlog/spawnClaude.ts
 import { spawn as spawn3 } from "child_process";
-function spawnClaude(prompt) {
-  const child = spawn3("claude", [prompt], {
+function spawnClaude(prompt, options2 = {}) {
+  const args = [prompt];
+  if (options2.allowEdits) {
+    args.push("--permission-mode", "acceptEdits");
+  }
+  const child = spawn3("claude", args, {
     stdio: "inherit"
   });
   const done2 = new Promise((resolve7, reject) => {
@@ -2802,11 +2634,11 @@ function spawnClaude(prompt) {
 }
 
 // src/commands/backlog/watchForMarker.ts
-import { existsSync as existsSync17, unwatchFile, watchFile } from "fs";
+import { existsSync as existsSync14, unwatchFile, watchFile } from "fs";
 function watchForMarker(child) {
   const statusPath = getPhaseStatusPath();
   watchFile(statusPath, { interval: 1e3 }, () => {
-    if (existsSync17(statusPath)) {
+    if (existsSync14(statusPath)) {
       unwatchFile(statusPath);
       child.kill("SIGTERM");
     }
@@ -2817,17 +2649,18 @@ function stopWatching() {
 }
 
 // src/commands/backlog/executePhase.ts
-async function executePhase(item, phaseIndex, phases) {
+async function executePhase(item, phaseIndex, phases, spawnOptions) {
   const phase = phases[phaseIndex];
   console.log(
-    chalk34.bold(
+    chalk31.bold(
       `
 --- Phase ${phaseIndex + 1}/${phases.length}: ${phase.name} ---
 `
     )
   );
   const { child, done: done2 } = spawnClaude(
-    buildPhasePrompt(item, phaseIndex, phase)
+    buildPhasePrompt(item, phaseIndex, phase),
+    spawnOptions
   );
   watchForMarker(child);
   await done2;
@@ -2850,7 +2683,7 @@ function resolvePlan(item) {
 }
 
 // src/commands/backlog/run.ts
-async function run2(id) {
+async function run2(id, spawnOptions) {
   const result = loadAndFindItem(id);
   if (!result) return;
   const { item } = result;
@@ -2859,93 +2692,98 @@ async function run2(id) {
   if (startPhase > plan2.length) {
     if (item.status !== "done") setStatus(id, "done");
     console.log(
-      chalk35.green(`All phases already complete for #${id}: ${item.name}`)
+      chalk32.green(`All phases already complete for #${id}: ${item.name}`)
     );
     return;
   }
   setStatus(id, "in-progress");
-  console.log(chalk35.bold(`Running plan for #${id}: ${item.name}`));
+  console.log(chalk32.bold(`Running plan for #${id}: ${item.name}`));
   if (startPhase > 0) {
     console.log(
-      chalk35.dim(`Resuming from phase ${startPhase + 1}/${plan2.length}
+      chalk32.dim(`Resuming from phase ${startPhase + 1}/${plan2.length}
 `)
     );
   } else {
-    console.log(chalk35.dim(`${plan2.length} phase(s)
+    console.log(chalk32.dim(`${plan2.length} phase(s)
 `));
   }
   let phaseIndex = startPhase;
   while (phaseIndex < plan2.length) {
-    phaseIndex = await executePhase(item, phaseIndex, plan2);
+    phaseIndex = await executePhase(item, phaseIndex, plan2, spawnOptions);
     if (phaseIndex < 0) return;
   }
   const reviewPhase = buildReviewPhase();
   const allPhases = [...plan2, reviewPhase];
   const reviewIndex = plan2.length;
-  const reviewResult = await executePhase(item, reviewIndex, allPhases);
+  const reviewResult = await executePhase(
+    item,
+    reviewIndex,
+    allPhases,
+    spawnOptions
+  );
   if (reviewResult < 0) return;
   if (item.status !== "done") setStatus(id, "done");
-  console.log(chalk35.green(`
+  console.log(chalk32.green(`
 All phases complete for #${id}: ${item.name}`));
 }
 
 // src/commands/backlog/next.ts
-async function next() {
+async function next(options2) {
   const items = loadBacklog();
   const inProgress = items.find((i) => i.status === "in-progress" && i.plan);
   if (inProgress) {
     console.log(
-      chalk36.bold(
+      chalk33.bold(
         `Resuming in-progress item #${inProgress.id}: ${inProgress.name}`
       )
     );
-    await run2(String(inProgress.id));
+    await run2(String(inProgress.id), options2);
     return;
   }
   const todo = items.filter((i) => i.status === "todo");
   if (todo.length === 0) {
-    console.log(chalk36.dim("No incomplete backlog items. Opening /draft..."));
-    await spawnClaude("/draft");
+    console.log(chalk33.dim("No incomplete backlog items. Opening /draft..."));
+    await spawnClaude("/draft", options2);
     return;
   }
   if (todo.length === 1) {
     const only = todo[0];
-    console.log(chalk36.bold(`Starting #${only.id}: ${only.name}`));
-    await run2(String(only.id));
+    console.log(chalk33.bold(`Starting #${only.id}: ${only.name}`));
+    await run2(String(only.id), options2);
     return;
   }
   const choices = todo.map((i) => ({
     name: `${typeLabel(i.type)} #${i.id}: ${i.name}`,
     value: String(i.id)
   }));
-  const { selected } = await enquirer6.prompt({
+  const { selected } = await enquirer5.prompt({
     type: "select",
     name: "selected",
     message: "Choose a backlog item to start:",
     choices: choices.map((c) => c.name)
   });
   const id = selected.match(/#(\d+)/)?.[1] ?? "";
-  await run2(id);
+  await run2(id, options2);
 }
 
 // src/commands/backlog/plan.ts
-import chalk37 from "chalk";
+import chalk34 from "chalk";
 function plan(id) {
   const result = loadAndFindItem(id);
   if (!result) return;
   const { item } = result;
   if (!item.plan || item.plan.length === 0) {
-    console.log(chalk37.dim("No plan defined for this item."));
+    console.log(chalk34.dim("No plan defined for this item."));
     return;
   }
-  console.log(chalk37.bold(item.name));
+  console.log(chalk34.bold(item.name));
   console.log();
   for (const [i, phase] of item.plan.entries()) {
-    console.log(`${chalk37.bold(`Phase ${i + 1}:`)} ${phase.name}`);
+    console.log(`${chalk34.bold(`Phase ${i + 1}:`)} ${phase.name}`);
     for (const task of phase.tasks) {
       console.log(`  - ${task.task}`);
       if (task.verify) {
-        console.log(`    ${chalk37.dim(`verify: ${task.verify}`)}`);
+        console.log(`    ${chalk34.dim(`verify: ${task.verify}`)}`);
       }
     }
     console.log();
@@ -2953,23 +2791,23 @@ function plan(id) {
 }
 
 // src/commands/backlog/start/index.ts
-import chalk38 from "chalk";
+import chalk35 from "chalk";
 async function start(id) {
   const name = setStatus(id, "in-progress");
   if (name) {
-    console.log(chalk38.green(`Started item #${id}: ${name}`));
+    console.log(chalk35.green(`Started item #${id}: ${name}`));
   }
 }
 
 // src/shared/web.ts
 import { exec } from "child_process";
-import { readFileSync as readFileSync12 } from "fs";
+import { readFileSync as readFileSync11 } from "fs";
 import {
   createServer
 } from "http";
-import { dirname as dirname13, join as join11 } from "path";
+import { dirname as dirname13, join as join10 } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
-import chalk39 from "chalk";
+import chalk36 from "chalk";
 function respondJson(res, status2, data) {
   res.writeHead(status2, { "Content-Type": "application/json" });
   res.end(JSON.stringify(data));
@@ -2979,7 +2817,7 @@ function createBundleHandler(importMetaUrl, bundlePath) {
   let cache;
   return (_req, res) => {
     if (!cache) {
-      cache = readFileSync12(join11(dir, bundlePath), "utf-8");
+      cache = readFileSync11(join10(dir, bundlePath), "utf-8");
     }
     res.writeHead(200, { "Content-Type": "application/javascript" });
     res.end(cache);
@@ -3013,8 +2851,8 @@ function startWebServer(label2, port, handler) {
     handler(req, res, port);
   });
   server.listen(port, () => {
-    console.log(chalk39.green(`${label2}: ${url}`));
-    console.log(chalk39.dim("Press Ctrl+C to stop"));
+    console.log(chalk36.green(`${label2}: ${url}`));
+    console.log(chalk36.dim("Press Ctrl+C to stop"));
     exec(`open ${url}`);
   });
 }
@@ -3161,29 +2999,210 @@ async function web(options2) {
   );
 }
 
-// src/commands/registerBacklog.ts
+// src/commands/backlog/add/index.ts
+import { existsSync as existsSync15 } from "fs";
+import chalk37 from "chalk";
+
+// src/commands/backlog/add/shared.ts
+import { spawnSync } from "child_process";
+import { mkdtempSync, readFileSync as readFileSync12, unlinkSync as unlinkSync3, writeFileSync as writeFileSync13 } from "fs";
+import { tmpdir } from "os";
+import { join as join11 } from "path";
+import enquirer6 from "enquirer";
+async function promptType() {
+  const { type } = await enquirer6.prompt({
+    type: "select",
+    name: "type",
+    message: "Type:",
+    choices: ["story", "bug"],
+    initial: 0
+  });
+  return type;
+}
+async function promptName() {
+  const { name } = await enquirer6.prompt({
+    type: "input",
+    name: "name",
+    message: "Name:",
+    validate: (value) => value.trim().length > 0 || "Name is required"
+  });
+  return name.trim();
+}
+async function promptDescription() {
+  const { useEditor } = await enquirer6.prompt({
+    type: "confirm",
+    name: "useEditor",
+    message: "Open editor for description?",
+    initial: false
+  });
+  if (!useEditor) {
+    const { description } = await enquirer6.prompt({
+      type: "input",
+      name: "description",
+      message: "Description (optional):"
+    });
+    return description.trim() || void 0;
+  }
+  return openEditor();
+}
+function openEditor() {
+  const editor = process.env.EDITOR || process.env.VISUAL || "vi";
+  const dir = mkdtempSync(join11(tmpdir(), "assist-"));
+  const filePath = join11(dir, "description.md");
+  writeFileSync13(filePath, "");
+  const result = spawnSync(editor, [filePath], { stdio: "inherit" });
+  if (result.status !== 0) {
+    unlinkSync3(filePath);
+    return void 0;
+  }
+  const content = readFileSync12(filePath, "utf-8").trim();
+  unlinkSync3(filePath);
+  return content || void 0;
+}
+async function promptAcceptanceCriteria() {
+  const criteria = [];
+  for (; ; ) {
+    const { criterion } = await enquirer6.prompt({
+      type: "input",
+      name: "criterion",
+      message: "Acceptance criterion (empty to finish):"
+    });
+    if (criterion.trim() === "") break;
+    criteria.push(criterion.trim());
+  }
+  return criteria;
+}
+
+// src/commands/backlog/add/index.ts
+var addItemSchema = backlogItemSchema.omit({ id: true, status: true });
+async function addFromJson() {
+  if (process.stdin.isTTY) {
+    console.log(chalk37.red("--json requires piped input on stdin."));
+    return;
+  }
+  const input = await readStdin2();
+  const sanitised = input.replace(
+    /"(?:[^"\\]|\\.)*"/g,
+    (match) => match.replace(/\n/g, "\\n").replace(/\r/g, "\\r").replace(/\t/g, "\\t")
+  );
+  const data = addItemSchema.parse(JSON.parse(sanitised));
+  const items = loadBacklog();
+  const id = getNextId(items);
+  items.push({ ...data, id, status: "todo" });
+  saveBacklog(items);
+  console.log(chalk37.green(`Added item #${id}: ${data.name}`));
+}
+async function addInteractive() {
+  const type = await promptType();
+  const name = await promptName();
+  const description = await promptDescription();
+  const acceptanceCriteria2 = await promptAcceptanceCriteria();
+  const items = loadBacklog();
+  const id = getNextId(items);
+  items.push({
+    id,
+    type,
+    name,
+    description,
+    acceptanceCriteria: acceptanceCriteria2,
+    status: "todo"
+  });
+  saveBacklog(items);
+  console.log(chalk37.green(`Added item #${id}: ${name}`));
+}
+async function add(options2) {
+  if (!existsSync15(getBacklogPath())) {
+    console.log(
+      chalk37.yellow(
+        "No backlog found. Run 'assist backlog init' to create one."
+      )
+    );
+    return;
+  }
+  if (options2.json) {
+    await addFromJson();
+  } else {
+    await addInteractive();
+  }
+}
+
+// src/commands/backlog/init/index.ts
+import { existsSync as existsSync16 } from "fs";
+import chalk38 from "chalk";
+async function init6() {
+  const backlogPath = getBacklogPath();
+  if (existsSync16(backlogPath)) {
+    console.log(chalk38.yellow("assist.backlog.yml already exists."));
+    return;
+  }
+  saveBacklog([]);
+  console.log(chalk38.green("Created assist.backlog.yml"));
+}
+
+// src/commands/backlog/list/index.ts
+import { existsSync as existsSync17 } from "fs";
+import chalk39 from "chalk";
+function filterItems(items, options2) {
+  if (options2.status) return items.filter((i) => i.status === options2.status);
+  if (!options2.all) return items.filter((i) => i.status !== "done");
+  return items;
+}
+async function list2(options2) {
+  if (!existsSync17(getBacklogPath())) {
+    console.log(
+      chalk39.yellow(
+        "No backlog found. Run 'assist backlog init' to create one."
+      )
+    );
+    return;
+  }
+  const items = filterItems(loadBacklog(), options2);
+  if (items.length === 0) {
+    console.log(chalk39.dim("Backlog is empty."));
+    return;
+  }
+  for (const item of items) {
+    console.log(
+      `${statusIcon(item.status)} ${typeLabel(item.type)} ${chalk39.dim(`#${item.id}`)} ${item.name}${phaseLabel(item)}`
+    );
+    if (options2.verbose) {
+      printVerboseDetails(item);
+    }
+  }
+}
+
+// src/commands/backlog/registerItemCommands.ts
 function registerItemCommands(cmd) {
   cmd.command("init").description("Create an empty assist.backlog.yml").action(init6);
   cmd.command("list").description("List all backlog items").option("--status <type>", "Filter by status (todo, in-progress, done)").option("-a, --all", "Include done items").option("-v, --verbose", "Show all item details").action(list2);
   cmd.command("add").description("Add a new backlog item").option("--json", "Read item as JSON from stdin").action(add);
 }
+
+// src/commands/registerBacklog.ts
 function registerStatusCommands(cmd) {
   cmd.command("start <id>").description("Set a backlog item to in-progress").action(start);
   cmd.command("done <id>").description("Set a backlog item to done").action(done);
   cmd.command("delete <id>").alias("remove").description("Delete a backlog item").action(del);
   cmd.command("web").description("Start a web view of the backlog").option("-p, --port <number>", "Port to listen on", "3000").action(web);
 }
-function registerOrchestrationCommands(cmd) {
-  cmd.command("next").description("Pick and run the next backlog item, or open /draft if none").action(next);
+function registerPlanCommands(cmd) {
   cmd.command("plan <id>").description("Display the plan for a backlog item").action(plan);
   cmd.command("phase-done <id> <phase>").description("Signal that a plan phase is complete").action(phaseDone);
-  cmd.command("run <id>").description("Run a backlog item's plan phase-by-phase with Claude").action(run2);
+}
+function registerRunCommands(cmd) {
+  cmd.command("next").description("Pick and run the next backlog item, or open /draft if none").option("--allow-edits", "Run Claude with acceptEdits permission mode").action(
+    (opts) => next({ allowEdits: opts.allowEdits })
+  );
+  cmd.command("run <id>").description("Run a backlog item's plan phase-by-phase with Claude").option("--allow-edits", "Run Claude with acceptEdits permission mode").action(
+    (id, opts) => run2(id, { allowEdits: opts.allowEdits })
+  );
 }
 function registerBacklog(program2) {
   const cmd = program2.command("backlog").description("Manage a backlog of work items").action(() => web({ port: "3000" }));
   registerItemCommands(cmd);
   registerStatusCommands(cmd);
-  registerOrchestrationCommands(cmd);
+  registerPlanCommands(cmd);
+  registerRunCommands(cmd);
 }
 
 // src/shared/isApprovedRead.ts

package/package.json

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