@staff0rd/assist 0.225.0 → 0.226.1

package/dist/index.js

@@ -6,7 +6,7 @@ import { Command } from "commander";
 // package.json
 var package_default = {
   name: "@staff0rd/assist",
-  version: "0.225.0",
+  version: "0.226.1",
   type: "module",
   main: "dist/index.js",
   bin: {
@@ -1269,6 +1269,63 @@ function findUnblockedTodos(items) {
 // src/commands/backlog/run.ts
 import chalk12 from "chalk";
 
+// src/commands/backlog/prepareRun.ts
+import chalk9 from "chalk";
+
+// src/commands/backlog/resolvePlan.ts
+function resolvePlan(item) {
+  if (item.plan && item.plan.length > 0) {
+    return item.plan;
+  }
+  return [
+    {
+      name: "Implement",
+      tasks: item.acceptanceCriteria.map((ac) => ({ task: ac }))
+    }
+  ];
+}
+
+// src/commands/backlog/prepareRun.ts
+async function prepareRun(id) {
+  const result = await loadAndFindItem(id);
+  if (!result) return void 0;
+  const { item } = result;
+  const plan2 = resolvePlan(item);
+  const startPhase = (item.currentPhase ?? 1) - 1;
+  if (item.status === "done") {
+    console.log(chalk9.green(`Already done: #${id}: ${item.name}`));
+    return void 0;
+  }
+  if (startPhase > plan2.length) {
+    await setStatus(id, "done");
+    console.log(
+      chalk9.green(`All phases already complete for #${id}: ${item.name}`)
+    );
+    return void 0;
+  }
+  return { item, plan: plan2, startPhase };
+}
+
+// src/commands/backlog/executePhase.ts
+import chalk11 from "chalk";
+
+// src/shared/spawnClaude.ts
+import { spawn } from "child_process";
+function spawnClaude(prompt, options2 = {}) {
+  const args = [prompt];
+  if (options2.allowEdits) {
+    args.push("--permission-mode", "acceptEdits");
+  }
+  const child = spawn("claude", args, {
+    stdio: "inherit"
+  });
+  const done2 = new Promise((resolve15, reject) => {
+    child.on("close", (code) => resolve15(code ?? 0));
+    child.on("error", reject);
+  });
+  return { child, done: done2 };
+}
+
 // src/commands/backlog/buildCommentLines.ts
 function buildCommentLines(comments2) {
   if (!comments2?.length) return [];
@@ -1373,41 +1430,9 @@ function buildPhasePrompt(item, phaseNumber, phase) {
   return buildAuthoredPhasePrompt(item, phaseNumber, phase);
 }
 
-// src/commands/backlog/buildReviewPhase.ts
-function buildReviewPhase() {
-  return {
-    name: REVIEW_PHASE_NAME,
-    tasks: [
-      {
-        task: "Verify acceptance criteria, confirm manual checks, mark done, commit, and signal phase-done."
-      }
-    ]
-  };
-}
-
-// src/commands/backlog/executePhase.ts
-import chalk10 from "chalk";
-
-// src/shared/spawnClaude.ts
-import { spawn } from "child_process";
-function spawnClaude(prompt, options2 = {}) {
-  const args = [prompt];
-  if (options2.allowEdits) {
-    args.push("--permission-mode", "acceptEdits");
-  }
-  const child = spawn("claude", args, {
-    stdio: "inherit"
-  });
-  const done2 = new Promise((resolve15, reject) => {
-    child.on("close", (code) => resolve15(code ?? 0));
-    child.on("error", reject);
-  });
-  return { child, done: done2 };
-}
-
 // src/commands/backlog/resolvePhaseResult.ts
 import { existsSync as existsSync9, unlinkSync as unlinkSync2 } from "fs";
-import chalk9 from "chalk";
+import chalk10 from "chalk";
 
 // src/commands/backlog/handleIncompletePhase.ts
 import enquirer from "enquirer";
@@ -1477,12 +1502,12 @@ async function resolvePhaseResult(phaseIndex, itemId) {
   if (signal?.event === "rewind") {
     const targetPhase = signal.targetPhase;
     const targetPhaseNumber = targetPhase + 1;
-    console.log(chalk9.yellow(`
+    console.log(chalk10.yellow(`
 Rewinding to phase ${targetPhaseNumber}.`));
     return targetPhase;
   }
   const phaseNumber = phaseIndex + 1;
-  console.log(chalk9.green(`
+  console.log(chalk10.green(`
 Phase ${phaseNumber} completed.`));
   return phaseIndex + 1;
 }
@@ -1509,7 +1534,7 @@ async function executePhase(item, phaseIndex, phases, spawnOptions) {
   const phase = phases[phaseIndex];
   const phaseNumber = phaseIndex + 1;
   console.log(
-    chalk10.bold(
+    chalk11.bold(
       `
 --- Phase ${phaseNumber}/${phases.length}: ${phase.name} ---
 `
@@ -1526,41 +1551,54 @@ async function executePhase(item, phaseIndex, phases, spawnOptions) {
   return await resolvePhaseResult(phaseIndex, item.id);
 }
 
-// src/commands/backlog/prepareRun.ts
-import chalk11 from "chalk";
-
-// src/commands/backlog/resolvePlan.ts
-function resolvePlan(item) {
-  if (item.plan && item.plan.length > 0) {
-    return item.plan;
-  }
-  return [
-    {
-      name: "Implement",
-      tasks: item.acceptanceCriteria.map((ac) => ({ task: ac }))
-    }
-  ];
+// src/commands/backlog/reloadPlan.ts
+async function reloadPlan(id) {
+  const result = await loadAndFindItem(String(id));
+  if (!result) return void 0;
+  return resolvePlan(result.item);
 }
 
-// src/commands/backlog/prepareRun.ts
-async function prepareRun(id) {
-  const result = await loadAndFindItem(id);
-  if (!result) return void 0;
-  const { item } = result;
-  const plan2 = resolvePlan(item);
-  const startPhase = (item.currentPhase ?? 1) - 1;
-  if (item.status === "done") {
-    console.log(chalk11.green(`Already done: #${id}: ${item.name}`));
-    return void 0;
-  }
-  if (startPhase > plan2.length) {
-    await setStatus(id, "done");
-    console.log(
-      chalk11.green(`All phases already complete for #${id}: ${item.name}`)
+// src/commands/backlog/runPhases.ts
+async function runPhases(item, startPhase, plan2, spawnOptions) {
+  let phaseIndex = startPhase;
+  let currentPlan = plan2;
+  while (phaseIndex < currentPlan.length) {
+    phaseIndex = await executePhase(
+      item,
+      phaseIndex,
+      currentPlan,
+      spawnOptions
     );
-    return void 0;
+    if (phaseIndex < 0) return false;
+    currentPlan = await reloadPlan(item.id) ?? currentPlan;
   }
-  return { item, plan: plan2, startPhase };
+  return true;
+}
+
+// src/commands/backlog/buildReviewPhase.ts
+function buildReviewPhase() {
+  return {
+    name: REVIEW_PHASE_NAME,
+    tasks: [
+      {
+        task: "Verify acceptance criteria, confirm manual checks, mark done, commit, and signal phase-done."
+      }
+    ]
+  };
+}
+
+// src/commands/backlog/runReview.ts
+async function runReview(item, fallbackPlan, spawnOptions) {
+  const plan2 = await reloadPlan(item.id) ?? fallbackPlan;
+  const reviewPhase = buildReviewPhase();
+  const allPhases = [...plan2, reviewPhase];
+  const reviewResult = await executePhase(
+    item,
+    plan2.length,
+    allPhases,
+    spawnOptions
+  );
+  return reviewResult >= 0;
 }
 
 // src/commands/backlog/run.ts
@@ -1603,25 +1641,6 @@ async function ensureDone(id) {
   } catch {
   }
 }
-async function runPhases(item, startPhase, plan2, spawnOptions) {
-  let phaseIndex = startPhase;
-  while (phaseIndex < plan2.length) {
-    phaseIndex = await executePhase(item, phaseIndex, plan2, spawnOptions);
-    if (phaseIndex < 0) return false;
-  }
-  return true;
-}
-async function runReview(item, plan2, spawnOptions) {
-  const reviewPhase = buildReviewPhase();
-  const allPhases = [...plan2, reviewPhase];
-  const reviewResult = await executePhase(
-    item,
-    plan2.length,
-    allPhases,
-    spawnOptions
-  );
-  return reviewResult >= 0;
-}
 
 // src/commands/backlog/next.ts
 function toChoice(item, items) {
@@ -6366,6 +6385,30 @@ function matchesConfigDeny(command) {
 }
 
 // src/commands/cliHook/resolvePermission.ts
+var SUBCOMMAND_READS = [
+  {
+    prefix: "assist complexity",
+    subcommands: ["maintainability", "cyclomatic", "halstead"]
+  }
+];
+function matchesSubcommandRead(part) {
+  return SUBCOMMAND_READS.find(
+    (rule) => part === rule.prefix || part.startsWith(`${rule.prefix} `)
+  );
+}
+function findSubcommandAdvice(parts) {
+  if (parts.length <= 1) return void 0;
+  for (const part of parts) {
+    const rule = matchesSubcommandRead(part);
+    if (rule) {
+      return {
+        permissionDecision: "deny",
+        permissionDecisionReason: `Do not pipe or chain '${rule.prefix}'. Run a focused sub-command directly for targeted output: ${rule.subcommands.map((s) => `${rule.prefix} ${s} <file>`).join(", ")}.`
+      };
+    }
+  }
+  return void 0;
+}
 function findDeny(toolName, parts) {
   for (const part of parts) {
     const configDeny = matchesConfigDeny(part);
@@ -6376,6 +6419,8 @@ function findDeny(toolName, parts) {
       };
     }
   }
+  const subcommandAdvice = findSubcommandAdvice(parts);
+  if (subcommandAdvice) return subcommandAdvice;
   for (const part of parts) {
     const denied = matchesDeny(toolName, part);
     if (denied) {

package/package.json

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