ralphctl 0.3.0 → 0.4.0

package/dist/{chunk-4GHVNKLV.mjs → chunk-MRN3Z2XC.mjs}

@@ -6,7 +6,7 @@ import {
 } from "./chunk-D2YGPLIV.mjs";
 import {
   editorInput
-} from "./chunk-JXMHLW42.mjs";
+} from "./chunk-7JLZQICD.mjs";
 import {
   addProjectRepo,
   getProject,
@@ -52,7 +52,7 @@ import {
   updateTask,
   updateTaskStatus,
   validateImportTasks
-} from "./chunk-CDOPLXFK.mjs";
+} from "./chunk-JYCGQA2D.mjs";
 import {
   fetchIssueFromUrl,
   formatIssueContext,
@@ -61,8 +61,9 @@ import {
   getTicket,
   listTickets,
   removeTicket,
+  truncate,
   updateTicket
-} from "./chunk-HL4ZMHCQ.mjs";
+} from "./chunk-JOQO4HMM.mjs";
 import {
   EXIT_ERROR,
   exitWithCode
@@ -176,7 +177,7 @@ import {
 // package.json
 var package_default = {
   name: "ralphctl",
-  version: "0.3.0",
+  version: "0.4.0",
   description: "Agent harness for long-running AI coding tasks \u2014 orchestrates Claude Code & GitHub Copilot across repositories",
   homepage: "https://github.com/lukas-grigis/ralphctl",
   type: "module",
@@ -421,8 +422,8 @@ function useCurrentPrompt() {
 }
 
 // src/integration/ui/prompts/confirm-prompt.tsx
-import "react";
-import { Box, Text } from "ink";
+import { useEffect as useEffect2, useMemo, useState as useState2 } from "react";
+import { Box, Text, useInput, useStdout } from "ink";
 import { ConfirmInput } from "@inkjs/ui";
 
 // src/integration/ui/theme/tokens.ts
@@ -491,43 +492,112 @@ var spacing = {
 var FIELD_LABEL_WIDTH = 12;
 
 // src/integration/ui/prompts/confirm-prompt.tsx
-import { jsx, jsxs } from "react/jsx-runtime";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+var RESERVED_ROWS = 10;
+var MIN_VIEWPORT = 6;
+var MAX_VIEWPORT = 40;
+function useTerminalRows() {
+  const { stdout } = useStdout();
+  const [rows, setRows] = useState2(stdout.rows);
+  useEffect2(() => {
+    const onResize = () => {
+      setRows(stdout.rows);
+    };
+    stdout.on("resize", onResize);
+    return () => {
+      stdout.off("resize", onResize);
+    };
+  }, [stdout]);
+  return rows;
+}
 function ConfirmPrompt({ options, onSubmit }) {
   const hint = options.default === false ? "(y/N)" : "(Y/n)";
-  return /* @__PURE__ */ jsxs(Box, { children: [
-    /* @__PURE__ */ jsxs(Text, { children: [
-      emoji.donut,
-      " ",
-      options.message,
-      " "
-    ] }),
-    /* @__PURE__ */ jsxs(Text, { dimColor: true, children: [
-      hint,
-      " "
-    ] }),
-    /* @__PURE__ */ jsx(
-      ConfirmInput,
+  const details = options.details?.trim();
+  const lines = useMemo(() => details ? details.split("\n") : [], [details]);
+  const terminalRows = useTerminalRows();
+  const viewport = Math.max(MIN_VIEWPORT, Math.min(MAX_VIEWPORT, terminalRows - RESERVED_ROWS));
+  const total = lines.length;
+  const maxOffset = Math.max(0, total - viewport);
+  const scrollable = total > viewport;
+  const [offset, setOffset] = useState2(0);
+  useInput((_input, key) => {
+    if (!scrollable) return;
+    if (key.upArrow) setOffset((o) => Math.max(0, o - 1));
+    else if (key.downArrow) setOffset((o) => Math.min(maxOffset, o + 1));
+    else if (key.pageUp) setOffset((o) => Math.max(0, o - viewport));
+    else if (key.pageDown) setOffset((o) => Math.min(maxOffset, o + viewport));
+  });
+  const visibleLines = scrollable ? lines.slice(offset, offset + viewport) : lines;
+  return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", children: [
+    details ? /* @__PURE__ */ jsxs(
+      Box,
       {
-        defaultChoice: options.default === false ? "cancel" : "confirm",
-        onConfirm: () => {
-          onSubmit(true);
-        },
-        onCancel: () => {
-          onSubmit(false);
-        }
+        flexDirection: "column",
+        borderStyle: "round",
+        borderColor: inkColors.muted,
+        paddingX: spacing.gutter,
+        marginBottom: spacing.section,
+        children: [
+          visibleLines.map((line, idx) => /* @__PURE__ */ jsx(Text, { children: line.length > 0 ? /* @__PURE__ */ jsxs(Fragment, { children: [
+            /* @__PURE__ */ jsxs(Text, { color: inkColors.muted, children: [
+              glyphs.quoteRail,
+              " "
+            ] }),
+            line
+          ] }) : " " }, idx)),
+          scrollable ? /* @__PURE__ */ jsxs(Text, { color: inkColors.muted, children: [
+            glyphs.inlineDot,
+            " lines ",
+            String(offset + 1),
+            "\u2013",
+            String(Math.min(offset + viewport, total)),
+            " of",
+            " ",
+            String(total),
+            " ",
+            glyphs.inlineDot,
+            " \u2191/\u2193 scroll ",
+            glyphs.inlineDot,
+            " PgUp/PgDn page"
+          ] }) : null
+        ]
       }
-    )
+    ) : null,
+    /* @__PURE__ */ jsxs(Box, { children: [
+      /* @__PURE__ */ jsxs(Text, { children: [
+        emoji.donut,
+        " ",
+        options.message,
+        " "
+      ] }),
+      /* @__PURE__ */ jsxs(Text, { dimColor: true, children: [
+        hint,
+        " "
+      ] }),
+      /* @__PURE__ */ jsx(
+        ConfirmInput,
+        {
+          defaultChoice: options.default === false ? "cancel" : "confirm",
+          onConfirm: () => {
+            onSubmit(true);
+          },
+          onCancel: () => {
+            onSubmit(false);
+          }
+        }
+      )
+    ] })
   ] });
 }
 
 // src/integration/ui/prompts/input-prompt.tsx
-import { useState as useState2 } from "react";
-import { Box as Box2, Text as Text2, useInput } from "ink";
+import { useState as useState3 } from "react";
+import { Box as Box2, Text as Text2, useInput as useInput2 } from "ink";
 import { TextInput } from "@inkjs/ui";
 import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
 function InputPrompt({ options, onSubmit, onCancel }) {
-  const [error2, setError] = useState2(null);
-  useInput((_input, key) => {
+  const [error2, setError] = useState3(null);
+  useInput2((_input, key) => {
     if (key.escape) onCancel();
   });
   return /* @__PURE__ */ jsxs2(Box2, { flexDirection: "column", children: [
@@ -565,13 +635,13 @@ function InputPrompt({ options, onSubmit, onCancel }) {
 }
 
 // src/integration/ui/prompts/select-prompt.tsx
-import { useState as useState3 } from "react";
-import { Box as Box3, Text as Text3, useInput as useInput2 } from "ink";
+import { useState as useState4 } from "react";
+import { Box as Box3, Text as Text3, useInput as useInput3 } from "ink";
 import { jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
 function SelectPrompt({ options, onSubmit, onCancel }) {
   const initialIdx = findInitialIdx(options);
-  const [focusedIdx, setFocusedIdx] = useState3(initialIdx);
-  useInput2((_input, key) => {
+  const [focusedIdx, setFocusedIdx] = useState4(initialIdx);
+  useInput3((_input, key) => {
     if (key.escape) {
       onCancel();
       return;
@@ -634,14 +704,14 @@ function stepFocus(choices, from, delta) {
 }
 
 // src/integration/ui/prompts/checkbox-prompt.tsx
-import { useState as useState4 } from "react";
-import { Box as Box4, Text as Text4, useInput as useInput3 } from "ink";
+import { useState as useState5 } from "react";
+import { Box as Box4, Text as Text4, useInput as useInput4 } from "ink";
 import { jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
 function CheckboxPrompt({ options, onSubmit, onCancel }) {
   const initialFocus = options.choices.findIndex((c) => !isDisabled2(c));
-  const [focusedIdx, setFocusedIdx] = useState4(initialFocus >= 0 ? initialFocus : 0);
-  const [checked, setChecked] = useState4(() => seedCheckedSet(options));
-  useInput3((input, key) => {
+  const [focusedIdx, setFocusedIdx] = useState5(initialFocus >= 0 ? initialFocus : 0);
+  const [checked, setChecked] = useState5(() => seedCheckedSet(options));
+  useInput4((input, key) => {
     if (key.escape) {
       onCancel();
       return;
@@ -717,8 +787,8 @@ function stepFocus2(choices, from, delta) {
 }
 
 // src/integration/ui/prompts/editor-prompt.tsx
-import { useState as useState5, useMemo } from "react";
-import { Box as Box5, Text as Text5, useInput as useInput4 } from "ink";
+import { useState as useState6, useMemo as useMemo2 } from "react";
+import { Box as Box5, Text as Text5, useInput as useInput5 } from "ink";
 import { jsx as jsx5, jsxs as jsxs5 } from "react/jsx-runtime";
 var MIN_EDIT_ROWS = 8;
 function splitLines(text) {
@@ -734,13 +804,13 @@ function clampCursor(lines, cursor) {
   return { row, col };
 }
 function EditorPrompt({ options, onSubmit, onCancel }) {
-  const [lines, setLines] = useState5(() => splitLines(options.default ?? ""));
-  const [cursor, setCursor] = useState5(() => {
+  const [lines, setLines] = useState6(() => splitLines(options.default ?? ""));
+  const [cursor, setCursor] = useState6(() => {
     const init = splitLines(options.default ?? "");
     const lastRow = init.length - 1;
     return { row: lastRow, col: (init[lastRow] ?? "").length };
   });
-  useInput4((input, key) => {
+  useInput5((input, key) => {
     if (key.escape || key.ctrl && input === "c") {
       onCancel();
       return;
@@ -836,7 +906,7 @@ function EditorPrompt({ options, onSubmit, onCancel }) {
       });
     }
   });
-  const renderedLines = useMemo(() => {
+  const renderedLines = useMemo2(() => {
     const padCount = Math.max(0, MIN_EDIT_ROWS - lines.length);
     const padded = lines.map((line, i) => {
       if (i !== cursor.row) return line.length > 0 ? line : " ";
@@ -883,11 +953,11 @@ function EditorPrompt({ options, onSubmit, onCancel }) {
 }
 
 // src/integration/ui/prompts/file-browser-prompt.tsx
-import { useEffect as useEffect2, useMemo as useMemo2, useState as useState6 } from "react";
+import { useEffect as useEffect3, useMemo as useMemo3, useState as useState7 } from "react";
 import { readdirSync, statSync } from "fs";
 import { homedir } from "os";
 import { dirname, join, resolve } from "path";
-import { Box as Box6, Text as Text6, useInput as useInput5 } from "ink";
+import { Box as Box6, Text as Text6, useInput as useInput6 } from "ink";
 import { jsx as jsx6, jsxs as jsxs6 } from "react/jsx-runtime";
 function listDirectories(dirPath) {
   try {
@@ -905,20 +975,20 @@ function isGitRepo(dirPath) {
 }
 var PAGE_SIZE = 12;
 function FileBrowserPrompt({ options, onSubmit, onCancel }) {
-  const [currentPath, setCurrentPath] = useState6(
+  const [currentPath, setCurrentPath] = useState7(
     () => options.startPath ? resolve(options.startPath) : homedir()
   );
-  const [dirs, setDirs] = useState6([]);
-  const [cursor, setCursor] = useState6(0);
-  const [offset, setOffset] = useState6(0);
-  useEffect2(() => {
+  const [dirs, setDirs] = useState7([]);
+  const [cursor, setCursor] = useState7(0);
+  const [offset, setOffset] = useState7(0);
+  useEffect3(() => {
     setDirs(listDirectories(currentPath));
     setCursor(0);
     setOffset(0);
   }, [currentPath]);
   const message = options.message ?? "Browse to directory:";
   const parent = dirname(currentPath);
-  useInput5((input, key) => {
+  useInput6((input, key) => {
     if (key.escape) {
       onCancel();
       return;
@@ -952,11 +1022,11 @@ function FileBrowserPrompt({ options, onSubmit, onCancel }) {
       return;
     }
   });
-  useEffect2(() => {
+  useEffect3(() => {
     if (cursor < offset) setOffset(cursor);
     else if (cursor >= offset + PAGE_SIZE) setOffset(cursor - PAGE_SIZE + 1);
   }, [cursor, offset]);
-  const visible = useMemo2(() => dirs.slice(offset, offset + PAGE_SIZE), [dirs, offset]);
+  const visible = useMemo3(() => dirs.slice(offset, offset + PAGE_SIZE), [dirs, offset]);
   return /* @__PURE__ */ jsxs6(Box6, { flexDirection: "column", borderStyle: "round", borderColor: "gray", paddingX: 1, children: [
     /* @__PURE__ */ jsx6(Box6, { children: /* @__PURE__ */ jsxs6(Text6, { children: [
       emoji.donut,
@@ -1897,7 +1967,7 @@ async function selectTicket(message = "Select ticket:", filter) {
         default: true
       });
       if (create) {
-        const { ticketAddCommand } = await import("./add-JGUOR4Z5.mjs");
+        const { ticketAddCommand } = await import("./add-CIM72NE3.mjs");
         await ticketAddCommand({ interactive: true });
         const updated = await listTickets();
         const refiltered = filter ? updated.filter(filter) : updated;
@@ -2688,6 +2758,8 @@ function parseArgs2(args) {
     if (arg === "--project") {
       options.project = nextArg;
       i++;
+    } else if (arg === "--auto") {
+      options.auto = true;
     } else if (!arg?.startsWith("-")) {
       sprintId = arg;
     }
@@ -2710,7 +2782,7 @@ async function sprintRefineCommand(args) {
   console.log(field("ID", sprint.id));
   log.newline();
   const shared = getSharedDeps();
-  const pipeline = createRefinePipeline(shared, { project: options.project });
+  const pipeline = createRefinePipeline(shared, { project: options.project, auto: options.auto });
   const result = await executePipeline(pipeline, { sprintId: id });
   if (!result.ok) {
     showError(result.error.message);
@@ -3893,6 +3965,100 @@ async function taskImportCommand(args) {
   }
 }
 
+// src/integration/cli/commands/task/why.ts
+function collectBlockers(root, byId) {
+  const out = [];
+  const visited = /* @__PURE__ */ new Set([root.id]);
+  function walk(task, depth) {
+    for (const blockerId of task.blockedBy) {
+      const blocker = byId.get(blockerId);
+      if (!blocker) {
+        out.push({
+          task: { id: blockerId, name: `(missing ${blockerId})`, status: "todo" },
+          depth,
+          missing: true
+        });
+        continue;
+      }
+      if (visited.has(blocker.id)) continue;
+      visited.add(blocker.id);
+      out.push({ task: blocker, depth, missing: false });
+      if (blocker.status !== "done") walk(blocker, depth + 1);
+    }
+  }
+  walk(root, 0);
+  return out;
+}
+function renderBlockerLine(node) {
+  const indent = "    " + "  ".repeat(node.depth);
+  const connector = colors.muted(node.depth === 0 ? "\u251C\u2500" : "\u21B3");
+  const idPart = colors.muted(node.task.id);
+  if (node.missing) {
+    return `${indent}${connector} ${colors.error(icons.error)} ${idPart}  ${colors.error("(referenced but missing)")}`;
+  }
+  const status = formatTaskStatus(node.task.status);
+  const marker = node.task.status === "done" ? colors.success(icons.success) : colors.warning(icons.warning);
+  return `${indent}${connector} ${marker} ${idPart}  ${node.task.name}  ${status}`;
+}
+async function taskWhyCommand(taskId) {
+  let id = taskId;
+  if (!id) {
+    const selected = await selectTask("Which task is blocked?");
+    if (!selected) return;
+    id = selected;
+  }
+  const r = await wrapAsync(() => getTasks(), ensureError);
+  if (!r.ok) {
+    showError(r.error.message);
+    return;
+  }
+  const tasks = r.value;
+  const byId = new Map(tasks.map((t) => [t.id, t]));
+  const root = byId.get(id);
+  if (!root) {
+    showError(new TaskNotFoundError(id).message);
+    return;
+  }
+  printHeader("Why blocked?");
+  log.newline();
+  console.log(`  ${icons.task} ${colors.highlight(root.name)}  ${formatTaskStatus(root.status)}`);
+  console.log(`  ${colors.muted("id:")} ${colors.muted(root.id)}`);
+  log.newline();
+  if (root.status === "done") {
+    console.log(`  ${colors.success(icons.success)} ${colors.success("Task is done \u2014 nothing blocking it.")}`);
+    log.newline();
+    return;
+  }
+  if (root.blockedBy.length === 0) {
+    console.log(`  ${colors.success(icons.success)} ${colors.success("No blockers \u2014 ready to execute.")}`);
+    log.newline();
+    showNextStep(`ralphctl task status ${root.id} in_progress`, "Start working on this task");
+    log.newline();
+    return;
+  }
+  const nodes = collectBlockers(root, byId);
+  const unmet = nodes.filter((n) => !n.missing && n.task.status !== "done");
+  const leafUnmet = unmet.filter((n) => n.task.blockedBy.every((bid) => byId.get(bid)?.status === "done"));
+  console.log(`  ${colors.muted("Dependency chain:")}`);
+  for (const node of nodes) console.log(renderBlockerLine(node));
+  log.newline();
+  if (unmet.length === 0) {
+    console.log(`  ${colors.success(icons.success)} ${colors.success("All blockers are done \u2014 ready to execute.")}`);
+    log.newline();
+    showNextStep(`ralphctl task status ${root.id} in_progress`, "Start working on this task");
+    log.newline();
+    return;
+  }
+  const actionable = leafUnmet.length > 0 ? leafUnmet : unmet;
+  console.log(
+    `  ${colors.warning(icons.warning)} ${colors.warning(`Unblock by completing ${String(actionable.length)} task${actionable.length !== 1 ? "s" : ""} first:`)}`
+  );
+  for (const node of actionable) {
+    console.log(`    ${colors.muted("\u2192")} ${colors.highlight(node.task.id)}  ${node.task.name}`);
+  }
+  log.newline();
+}
+
 // src/integration/cli/commands/ticket/edit.ts
 function validateUrl(url) {
   try {
@@ -4092,7 +4258,7 @@ async function ticketListCommand(args) {
     log.raw(`  ${icons.bullet} ${formatTicketDisplay(ticket)} ${reqBadge}`);
     if (ticket.description) {
       const preview = ticket.description.split("\n")[0] ?? "";
-      const truncated = preview.length > 60 ? preview.slice(0, 57) + "..." : preview;
+      const truncated = truncate(preview, 60);
       log.raw(`      ${muted(truncated)}`, 1);
     }
   }
@@ -5048,6 +5214,7 @@ export {
   taskNextCommand,
   taskReorderCommand,
   taskImportCommand,
+  taskWhyCommand,
   ticketEditCommand,
   ticketListCommand,
   ticketShowCommand,

package/dist/cli.mjs

@@ -5,6 +5,8 @@ import {
   configShowCommand,
   createSharedDeps,
   doctorCommand,
+  getNextAction,
+  loadDashboardData,
   progressLogCommand,
   progressShowCommand,
   projectListCommand,
@@ -33,12 +35,13 @@ import {
   taskReorderCommand,
   taskShowCommand,
   taskStatusCommand,
+  taskWhyCommand,
   ticketEditCommand,
   ticketListCommand,
   ticketRefineCommand,
   ticketRemoveCommand,
   ticketShowCommand
-} from "./chunk-4GHVNKLV.mjs";
+} from "./chunk-MRN3Z2XC.mjs";
 import {
   projectAddCommand
 } from "./chunk-D2YGPLIV.mjs";
@@ -47,13 +50,15 @@ import {
 } from "./chunk-3QBEBKMZ.mjs";
 import {
   ticketAddCommand
-} from "./chunk-JXMHLW42.mjs";
+} from "./chunk-7JLZQICD.mjs";
 import "./chunk-NUYQK5MN.mjs";
 import {
   getTasks,
   sprintStartCommand
-} from "./chunk-CDOPLXFK.mjs";
-import "./chunk-HL4ZMHCQ.mjs";
+} from "./chunk-JYCGQA2D.mjs";
+import {
+  truncate
+} from "./chunk-JOQO4HMM.mjs";
 import {
   EXIT_ERROR
 } from "./chunk-CFUVE2BP.mjs";
@@ -68,6 +73,7 @@ import {
 import {
   colors,
   error,
+  formatSprintStatus,
   icons,
   log,
   printBanner,
@@ -195,7 +201,7 @@ async function sprintInsightsCommand(args) {
     console.log(`  ${colors.accent("Evaluation output:")}`);
     for (const task of withOutput) {
       const output = task.evaluationOutput ?? "";
-      const truncated = output.length > 200 ? output.slice(0, 200) + "..." : output;
+      const truncated = truncate(output, 200);
       console.log(`    ${icons.bullet} ${colors.accent(task.name)}: ${colors.muted(truncated)}`);
     }
     log.newline();
@@ -281,10 +287,11 @@ Examples:
   sprint.command("switch").description("Quick sprint switcher (opens selector)").action(async () => {
     await sprintSwitchCommand();
   });
-  sprint.command("refine [id]").description("Refine ticket specifications").option("--project <name>", "Only refine tickets for specific project").action(async (id, opts) => {
+  sprint.command("refine [id]").description("Refine ticket specifications").option("--project <name>", "Only refine tickets for specific project").option("--auto", "Run without approval prompts (AI drafts requirements autonomously)").action(async (id, opts) => {
     const args = [];
     if (id) args.push(id);
     if (opts?.project) args.push("--project", opts.project);
+    if (opts?.auto) args.push("--auto");
     await sprintRefineCommand(args);
   });
   sprint.command("ideate [id]").description("Quick idea to tasks (refine + plan in one session)").option("--auto", "Run without user interaction (AI decides autonomously)").option("--all-paths", "Explore all project repositories instead of prompting for selection").option("--project <name>", "Pre-select project (skip interactive selection)").action(async (id, opts) => {
@@ -424,6 +431,9 @@ Examples:
     });
   });
   task.command("next").description("Get next task").action(taskNextCommand);
+  task.command("why [id]").description("Explain why a task is blocked (walks the dependency chain)").action(async (id) => {
+    await taskWhyCommand(id);
+  });
   task.command("reorder [id] [position]").description("Change task priority").action(async (id, position) => {
     const args = [];
     if (id) args.push(id);
@@ -576,6 +586,85 @@ Checks performed:
   });
 }
 
+// src/integration/cli/commands/next/next.ts
+function toCommand(action) {
+  return `ralphctl ${action.group} ${action.subCommand}`;
+}
+function computePayload(data) {
+  if (!data) {
+    return { sprint: null, action: null, reason: "no-sprint" };
+  }
+  const sprint = { id: data.sprint.id, name: data.sprint.name, status: data.sprint.status };
+  if (data.sprint.status === "closed") {
+    return { sprint, action: null, reason: "sprint-closed" };
+  }
+  const next = getNextAction(data);
+  if (!next) {
+    return { sprint, action: null, reason: "all-done" };
+  }
+  return {
+    sprint,
+    action: { command: toCommand(next), label: next.label, description: next.description },
+    reason: "action-ready"
+  };
+}
+function renderPorcelain(payload) {
+  if (payload.action) {
+    console.log(payload.action.command);
+    return;
+  }
+  console.log("");
+}
+function renderHuman(payload) {
+  log.newline();
+  if (payload.reason === "no-sprint") {
+    console.log(`  ${colors.muted(icons.inactive)} ${colors.muted("No current sprint.")}`);
+    console.log(`  ${colors.muted(icons.tip)} ${colors.muted("Create one to get started:")}`);
+    console.log(`    ${colors.highlight("ralphctl sprint create")}`);
+    log.newline();
+    return;
+  }
+  if (!payload.sprint) return;
+  const sprintLine = `${icons.sprint} ${colors.highlight(payload.sprint.name)}  ${formatSprintStatus(payload.sprint.status)}`;
+  console.log(`  ${sprintLine}`);
+  if (payload.reason === "sprint-closed") {
+    console.log(`  ${colors.muted(icons.info)} ${colors.muted("Sprint is closed. Start a new one:")}`);
+    console.log(`    ${colors.highlight("ralphctl sprint create")}`);
+    log.newline();
+    return;
+  }
+  if (payload.reason === "all-done") {
+    console.log(`  ${colors.success(icons.success)} ${colors.success("Nothing left to do.")}`);
+    log.newline();
+    return;
+  }
+  const action = payload.action;
+  if (!action) return;
+  console.log(`  ${colors.muted(icons.tip)} ${colors.muted(action.label + ":")} ${colors.muted(action.description)}`);
+  console.log(`    ${colors.highlight(action.command)}`);
+  log.newline();
+}
+async function nextCommand(options = {}) {
+  const data = await loadDashboardData();
+  const payload = computePayload(data);
+  if (options.json) {
+    console.log(JSON.stringify(payload));
+    return;
+  }
+  if (options.porcelain) {
+    renderPorcelain(payload);
+    return;
+  }
+  renderHuman(payload);
+}
+
+// src/integration/cli/commands/next/register.ts
+function registerNextCommands(program2) {
+  program2.command("next").description("Suggest the next workflow action for the current sprint").option("--porcelain", "Print only the suggested command (for shell/tmux integration)").option("--json", "Emit a machine-readable JSON payload").action(async (options) => {
+    await nextCommand(options);
+  });
+}
+
 // src/application/entrypoint.ts
 setSharedDeps(createSharedDeps());
 var program = new Command();
@@ -601,6 +690,12 @@ registerDashboardCommands(program);
 registerConfigCommands(program);
 registerCompletionCommands(program);
 registerDoctorCommands(program);
+registerNextCommands(program);
+function isQuietCommand(argv) {
+  const cmd = argv[2];
+  if (cmd === "next" && (argv.includes("--porcelain") || argv.includes("--json"))) return true;
+  return false;
+}
 async function main() {
   if (process.env["COMP_CWORD"] && process.env["COMP_POINT"] && process.env["COMP_LINE"]) {
     const { handleCompletionRequest } = await import("./handle-BBAZJ44Y.mjs");
@@ -610,7 +705,7 @@ async function main() {
   const isBare = argv.length <= 2;
   const isInteractive = argv[2] === "interactive";
   if (isBare || isInteractive) {
-    const { mountInkApp } = await import("./mount-XZPBDRPZ.mjs");
+    const { mountInkApp } = await import("./mount-XMN3S4W6.mjs");
     const { fallback } = await mountInkApp({ initialView: "repl" });
     if (!fallback) return;
     printBanner();
@@ -621,10 +716,10 @@ async function main() {
     return;
   }
   if (argv[2] === "sprint" && argv[3] === "start") {
-    const { parseSprintStartArgs } = await import("./start-MMWC7QLI.mjs");
+    const { parseSprintStartArgs } = await import("./start-D35SOXMM.mjs");
     const parsed = parseSprintStartArgs(argv.slice(4));
     if (parsed.ok) {
-      const { mountInkApp } = await import("./mount-XZPBDRPZ.mjs");
+      const { mountInkApp } = await import("./mount-XMN3S4W6.mjs");
       const { getSharedDeps } = await import("./bootstrap-FMHG6DRY.mjs");
       let sprintId;
       try {
@@ -642,7 +737,7 @@ async function main() {
       }
     }
   }
-  printBanner();
+  if (!isQuietCommand(argv)) printBanner();
   await program.parseAsync(argv);
 }
 main().catch((err) => {