feat(scripts): pnpm work ready + blocked subcommands, DAG-aware next

scripts/work/cli.mjs

@@ -20,7 +20,9 @@ const STATE_FILE = path.join(WORK_ROOT, "_state.json");
 function rebuildState() {
   const state = buildState(WORK_ROOT);
   fs.writeFileSync(STATE_FILE, JSON.stringify(state, null, 2) + "\n");
-  console.log(`Rebuilt ${path.relative(REPO_ROOT, STATE_FILE)} with ${Object.keys(state.epics).length} epic(s).`);
+  console.log(
+    `Rebuilt ${path.relative(REPO_ROOT, STATE_FILE)} with ${Object.keys(state.epics).length} epic(s).`,
+  );
 }
 
 function printStatus() {
@@ -41,31 +43,67 @@ function printStatus() {
       { total: 0, done: 0 },
     );
     const epicMark = mark(epic.status);
-    console.log(`${epicMark} ${epicId} — ${epic.title} (${storyTotals.done}/${storyTotals.total} tasks done)`);
+    console.log(
+      `${epicMark} ${epicId} — ${epic.title} (${storyTotals.done}/${storyTotals.total} tasks done)`,
+    );
     for (const sid of storyIds) {
       const s = epic.stories[sid];
-      console.log(`    ${mark(s.status)} ${sid} (${s.ac_completed}/${s.ac_total}) — ${s.title}`);
+      console.log(
+        `    ${mark(s.status)} ${sid} (${s.ac_completed}/${s.ac_total}) — ${s.title}`,
+      );
     }
   }
 }
 
 function printNext() {
   const state = buildState(WORK_ROOT);
-  const epicIds = Object.keys(state.epics).sort();
+  if (state.ready.length === 0) {
-  for (const epicId of epicIds) {
+    if (state.blocked.length > 0) {
-    const epic = state.epics[epicId];
+      console.log("No ready stories. Blocked:");
-    if (epic.status === "done") continue;
+      for (const b of state.blocked) {
-    const storyIds = Object.keys(epic.stories).sort();
+        console.log(
-    for (const sid of storyIds) {
+          `  ${b.epic} / ${b.story} — waiting on: ${b.waiting_on.join(", ")}`,
-      const s = epic.stories[sid];
+        );
-      if (s.status !== "done") {
+      }
-        console.log(`${epicId} / ${sid} — ${s.title}`);
+    } else {
-        console.log(`  status: ${s.status}, tasks: ${s.ac_completed}/${s.ac_total}`);
+      console.log("All epics + stories are done. ✓");
+    }
     return;
   }
+  const r = state.ready[0];
+  console.log(`${r.epic} / ${r.story} — ${r.title}`);
+  console.log(`  (use \`pnpm work ready\` to see all ready stories)`);
+}
+
+function printReady() {
+  const state = buildState(WORK_ROOT);
+  if (state.ready.length === 0) {
+    console.log(
+      "No ready stories. Run `pnpm work blocked` to see what's waiting on what.",
+    );
+    return;
+  }
+  console.log(
+    `${state.ready.length} ready stor${state.ready.length === 1 ? "y" : "ies"}:`,
+  );
+  for (const r of state.ready) {
+    console.log(`  ${r.epic} / ${r.story} — ${r.title}`);
   }
 }
-  console.log("All epics + stories are done. ✓");
+
+function printBlocked() {
+  const state = buildState(WORK_ROOT);
+  if (state.blocked.length === 0) {
+    console.log("No blocked stories.");
+    return;
+  }
+  console.log(
+    `${state.blocked.length} blocked stor${state.blocked.length === 1 ? "y" : "ies"}:`,
+  );
+  for (const b of state.blocked) {
+    console.log(`  ${b.epic} / ${b.story} — ${b.title}`);
+    console.log(`    waiting on: ${b.waiting_on.join(", ")}`);
+  }
 }
 
 function mark(status) {
@@ -76,7 +114,7 @@ function mark(status) {
 }
 
 function usage() {
-  console.log("Usage: pnpm work <rebuild-state|status|next>");
+  console.log("Usage: pnpm work <rebuild-state|status|next|ready|blocked>");
   process.exit(2);
 }
 
@@ -84,4 +122,6 @@ const cmd = process.argv[2];
 if (cmd === "rebuild-state") rebuildState();
 else if (cmd === "status") printStatus();
 else if (cmd === "next") printNext();
+else if (cmd === "ready") printReady();
+else if (cmd === "blocked") printBlocked();
 else usage();

scripts/work/cli.test.mjs

@@ -21,6 +21,8 @@ describe("pnpm work cli", () => {
     expect(out).toContain("rebuild-state");
     expect(out).toContain("status");
     expect(out).toContain("next");
+    expect(out).toContain("ready");
+    expect(out).toContain("blocked");
   });
 
   it("rebuild-state writes _state.json", () => {
@@ -39,4 +41,14 @@ describe("pnpm work cli", () => {
     const out = run("next");
     expect(out.length).toBeGreaterThan(0);
   });
+
+  it("ready prints something", () => {
+    const out = run("ready");
+    expect(out.length).toBeGreaterThan(0);
+  });
+
+  it("blocked prints something", () => {
+    const out = run("blocked");
+    expect(out.length).toBeGreaterThan(0);
+  });
 });