codeharness 0.30.0 → 0.31.0

package/README.md

@@ -8,7 +8,7 @@ codeharness is an **npm CLI** + **Claude Code plugin** that packages verificatio
 
 1. **Verifies features work** — not just that tests pass. Black-box verification runs the built CLI inside a Docker container with no source code access. If the feature doesn't work from a user's perspective, verification fails.
 2. **Fixes what it finds** — verification failures with code bugs automatically return to development with specific findings. The dev agent gets told exactly what's broken and why.
-3. **Runs sprints autonomously** — reads your sprint plan, picks the highest-priority story, implements it, reviews it, verifies it, and moves to the next one. Cross-epic prioritization, retry management, and session handoff built in.
+3. **Runs sprints autonomously** — reads your sprint plan, picks the highest-priority story, implements it, checks it (tests + lint), verifies it (agent evaluation), and moves to the next one. Cross-epic prioritization, retry management, and session handoff built in.
 4. **Makes agents see runtime** — ephemeral VictoriaMetrics stack (logs, metrics, traces) that agents query programmatically during development. No guessing at what the code does at runtime.
 
 ## Installation
@@ -61,7 +61,7 @@ The plugin provides slash commands that orchestrate the CLI within Claude Code s
 
 | Command | Purpose |
 |---------|---------|
-| `/harness-run` | Autonomous sprint execution — picks stories by priority, runs create → dev → review → verify loop |
+| `/harness-run` | Autonomous sprint execution — picks stories by priority, runs create → implement → check → verify loop |
 | `/harness-init` | Interactive project initialization |
 | `/harness-status` | Quick overview of sprint progress and harness health |
 | `/harness-onboard` | Scan project and generate onboarding plan |
@@ -84,7 +84,7 @@ codeharness integrates with [BMAD Method](https://github.com/bmadcode/BMAD-METHO
 ┌─────────────────────────────────────────┐
 │  Claude Code Session                     │
 │  /harness-run picks next story           │
-│  → create-story → dev → review → verify  │
+│  → create-story → implement → check → verify │
 └────────────────────┬────────────────────┘
                      │ verify
                      ▼

package/dist/{chunk-S3RKDJMC.js → chunk-ITPLJVAB.js}

@@ -2895,7 +2895,7 @@ function generateDockerfileTemplate(projectDir, stackOrDetections) {
 }
 
 // src/modules/infra/init-project.ts
-var HARNESS_VERSION = true ? "0.30.0" : "0.0.0-dev";
+var HARNESS_VERSION = true ? "0.31.0" : "0.0.0-dev";
 function failResult(opts, error) {
   return {
     status: "fail",

package/dist/{docker-7QONH2B5.js → docker-TANMGEDO.js}

@@ -16,7 +16,7 @@ import {
   stopCollectorOnly,
   stopSharedStack,
   stopStack
-} from "./chunk-S3RKDJMC.js";
+} from "./chunk-ITPLJVAB.js";
 export {
   checkRemoteEndpoint,
   cleanupOrphanedContainers,

package/dist/index.js

@@ -40,7 +40,7 @@ import {
   validateDockerfile,
   warn,
   writeState
-} from "./chunk-S3RKDJMC.js";
+} from "./chunk-ITPLJVAB.js";
 
 // src/index.ts
 import { Command } from "commander";
@@ -5046,15 +5046,29 @@ function CompletedTool({ entry }) {
     entry.driver && /* @__PURE__ */ jsx(Text, { dimColor: true, children: ` (${entry.driver})` })
   ] });
 }
-var VISIBLE_COMPLETED_TOOLS = 5;
-function CompletedTools({ tools }) {
-  const visible = tools.slice(-VISIBLE_COMPLETED_TOOLS);
+var DEFAULT_VISIBLE_TOOLS = 5;
+function CompletedTools({ tools, maxVisible }) {
+  const limit = maxVisible ?? DEFAULT_VISIBLE_TOOLS;
+  const visible = tools.slice(-limit);
   const hidden = tools.length - visible.length;
   return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", children: [
     hidden > 0 && /* @__PURE__ */ jsx(Text, { dimColor: true, children: `  \u2026 ${hidden} earlier tools` }),
     visible.map((entry, i) => /* @__PURE__ */ jsx(CompletedTool, { entry }, i))
   ] });
 }
+function ActivitySection({ completedTools, activeTool, activeDriverName, lastThought, retryInfo, availableHeight }) {
+  let reserved = 0;
+  if (activeTool) reserved++;
+  if (lastThought) reserved++;
+  if (retryInfo) reserved++;
+  const toolsHeight = Math.max(1, availableHeight - reserved - 1);
+  return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", paddingLeft: 1, children: [
+    /* @__PURE__ */ jsx(CompletedTools, { tools: completedTools, maxVisible: toolsHeight }),
+    activeTool && /* @__PURE__ */ jsx(ActiveTool, { name: activeTool.name, driverName: activeDriverName }),
+    lastThought && /* @__PURE__ */ jsx(LastThought, { text: lastThought }),
+    retryInfo && /* @__PURE__ */ jsx(RetryNotice, { info: retryInfo })
+  ] });
+}
 function ActiveTool({ name, driverName }) {
   return /* @__PURE__ */ jsxs(Box, { children: [
     /* @__PURE__ */ jsx(Text, { color: "yellow", children: "\u26A1 " }),
@@ -5080,13 +5094,6 @@ function RetryNotice({ info: info3 }) {
     "ms)"
   ] });
 }
-function DriverCostSummary({ driverCosts }) {
-  if (!driverCosts) return null;
-  const entries = Object.entries(driverCosts).sort(([a], [b]) => a.localeCompare(b));
-  if (entries.length === 0) return null;
-  const parts = entries.map(([driver, cost]) => `${driver} $${cost.toFixed(2)}`).join(", ");
-  return /* @__PURE__ */ jsx(Text, { dimColor: true, children: `Cost: ${parts}` });
-}
 
 // src/lib/ink-app.tsx
 import { Box as Box7, Static, Text as Text7, useInput } from "ink";
@@ -5094,23 +5101,10 @@ import { Box as Box7, Static, Text as Text7, useInput } from "ink";
 // src/lib/ink-workflow.tsx
 import { Text as Text2, Box as Box2 } from "ink";
 import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
-var termWidth = () => Math.min(process.stdout.columns || 60, 80);
 var SPINNER_FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
 function isLoopBlock2(step) {
   return typeof step === "object" && step !== null && "loop" in step;
 }
-function formatCost(costUsd) {
-  if (costUsd == null) return "...";
-  return `$${costUsd.toFixed(2)}`;
-}
-function formatElapsed2(ms) {
-  if (ms == null) return "...";
-  const seconds = Math.round(ms / 1e3);
-  if (seconds >= 60) {
-    return `${Math.floor(seconds / 60)}m`;
-  }
-  return `${seconds}s`;
-}
 function TaskNode({ name, status, spinnerFrame }) {
   const s = status ?? "pending";
   switch (s) {
@@ -5144,17 +5138,6 @@ function loopIteration(tasks, taskStates) {
   });
   return anyStarted ? 1 : 0;
 }
-function collectTaskNames(flow) {
-  const names = [];
-  for (const step of flow) {
-    if (isLoopBlock2(step)) {
-      names.push(...step.loop);
-    } else {
-      names.push(step);
-    }
-  }
-  return names;
-}
 function hasMetaData(taskMeta) {
   if (!taskMeta) return false;
   return Object.keys(taskMeta).length > 0;
@@ -5200,69 +5183,10 @@ function WorkflowGraph({ flow, currentTask, taskStates, taskMeta }) {
       );
     }
   }
-  let driverRow = null;
-  let costRow = null;
-  if (showMeta) {
-    const taskNames = collectTaskNames(flow);
-    const driverParts = [];
-    const costParts = [];
-    let hasAnyCost = false;
-    for (const name of taskNames) {
-      const m = meta[name];
-      const driver = m?.driver ?? "";
-      driverParts.push(driver);
-      const state = taskStates[name];
-      if (state === "done") {
-        const costStr = formatCost(m?.costUsd);
-        const timeStr = formatElapsed2(m?.elapsedMs);
-        costParts.push(`${costStr} / ${timeStr}`);
-        hasAnyCost = true;
-      } else {
-        costParts.push("");
-      }
-    }
-    const hasSomeDriver = driverParts.some((d) => d.length > 0);
-    if (hasSomeDriver) {
-      const driverLabels = [];
-      for (let idx = 0; idx < taskNames.length; idx++) {
-        if (idx > 0) {
-          driverLabels.push(/* @__PURE__ */ jsx2(Text2, { children: "   " }, `drv-sep-${idx}`));
-        }
-        driverLabels.push(
-          /* @__PURE__ */ jsx2(Text2, { dimColor: true, children: driverParts[idx] || " " }, `drv-${idx}`)
-        );
-      }
-      driverRow = /* @__PURE__ */ jsxs2(Text2, { children: [
-        "  ",
-        driverLabels
-      ] });
-    }
-    if (hasAnyCost) {
-      const costLabels = [];
-      for (let idx = 0; idx < taskNames.length; idx++) {
-        if (idx > 0) {
-          costLabels.push(/* @__PURE__ */ jsx2(Text2, { children: "   " }, `cost-sep-${idx}`));
-        }
-        costLabels.push(
-          /* @__PURE__ */ jsx2(Text2, { dimColor: true, children: costParts[idx] || " " }, `cost-${idx}`)
-        );
-      }
-      costRow = /* @__PURE__ */ jsxs2(Text2, { children: [
-        "  ",
-        costLabels
-      ] });
-    }
-  }
-  return /* @__PURE__ */ jsxs2(Box2, { flexDirection: "column", children: [
-    /* @__PURE__ */ jsx2(Text2, { children: "\u2501".repeat(termWidth()) }),
-    /* @__PURE__ */ jsxs2(Text2, { children: [
-      "  ",
-      elements
-    ] }),
-    driverRow,
-    costRow,
-    /* @__PURE__ */ jsx2(Text2, { children: "\u2501".repeat(termWidth()) })
-  ] });
+  return /* @__PURE__ */ jsx2(Box2, { flexDirection: "column", children: /* @__PURE__ */ jsxs2(Text2, { children: [
+    "  ",
+    elements
+  ] }) });
 }
 
 // src/lib/ink-lane-container.tsx
@@ -5440,7 +5364,7 @@ import { jsx as jsx5, jsxs as jsxs5 } from "react/jsx-runtime";
 function formatConflictText(count) {
   return count === 1 ? "1 conflict" : `${count} conflicts`;
 }
-function formatCost2(cost) {
+function formatCost(cost) {
   return `$${cost.toFixed(2)}`;
 }
 function SummaryBar({ doneStories, mergingEpic, pendingEpics, completedLanes }) {
@@ -5466,7 +5390,7 @@ function SummaryBar({ doneStories, mergingEpic, pendingEpics, completedLanes })
       /* @__PURE__ */ jsx5(Text5, { children: " \u2502 " }),
       /* @__PURE__ */ jsx5(Text5, { dimColor: true, children: `Pending: ${pendingSection}` })
     ] }),
-    completedLanes && completedLanes.length > 0 && completedLanes.map((lane) => /* @__PURE__ */ jsx5(Text5, { color: "green", children: `[OK] Lane ${lane.laneIndex}: Epic ${lane.epicId} complete (${lane.storyCount} stories, ${formatCost2(lane.cost)}, ${lane.elapsed})` }, `lane-complete-${lane.laneIndex}`))
+    completedLanes && completedLanes.length > 0 && completedLanes.map((lane) => /* @__PURE__ */ jsx5(Text5, { color: "green", children: `[OK] Lane ${lane.laneIndex}: Epic ${lane.epicId} complete (${lane.storyCount} stories, ${formatCost(lane.cost)}, ${lane.elapsed})` }, `lane-complete-${lane.laneIndex}`))
   ] });
 }
 
@@ -5559,29 +5483,36 @@ function App({ state, onCycleLane, onQuit }) {
     }
   }, { isActive: typeof process.stdin.setRawMode === "function" });
   const activeLaneCount = state.laneCount ?? 0;
+  const termRows = process.stdout.rows || 24;
+  const fixedHeight = 10;
+  const availableHeight = Math.max(3, termRows - fixedHeight);
   return /* @__PURE__ */ jsxs7(Box7, { flexDirection: "column", children: [
     /* @__PURE__ */ jsx7(Static, { items: state.messages, children: (msg, i) => /* @__PURE__ */ jsx7(StoryMessageLine, { msg }, i) }),
     /* @__PURE__ */ jsx7(Header, { info: state.sprintInfo, laneCount: laneCount > 1 ? laneCount : void 0 }),
-    laneCount > 1 ? /* @__PURE__ */ jsx7(LaneContainer, { lanes, terminalWidth }) : /* @__PURE__ */ jsxs7(Fragment, { children: [
-      /* @__PURE__ */ jsx7(WorkflowGraph, { flow: state.workflowFlow, currentTask: state.currentTaskName, taskStates: state.taskStates, taskMeta: state.taskMeta }),
-      /* @__PURE__ */ jsx7(StoryBreakdown, { stories: state.stories, sprintInfo: state.sprintInfo }),
-      /* @__PURE__ */ jsx7(DriverCostSummary, { driverCosts: state.driverCosts })
-    ] }),
-    laneCount > 1 && state.summaryBar && /* @__PURE__ */ jsxs7(Fragment, { children: [
+    laneCount > 1 ? /* @__PURE__ */ jsxs7(Fragment, { children: [
+      /* @__PURE__ */ jsx7(LaneContainer, { lanes, terminalWidth }),
+      state.summaryBar && /* @__PURE__ */ jsxs7(Fragment, { children: [
+        /* @__PURE__ */ jsx7(Separator, {}),
+        /* @__PURE__ */ jsx7(SummaryBar, { ...state.summaryBar })
+      ] }),
+      state.mergeState && /* @__PURE__ */ jsxs7(Fragment, { children: [
+        /* @__PURE__ */ jsx7(Separator, {}),
+        /* @__PURE__ */ jsx7(MergeStatus, { mergeState: state.mergeState })
+      ] }),
       /* @__PURE__ */ jsx7(Separator, {}),
-      /* @__PURE__ */ jsx7(SummaryBar, { ...state.summaryBar })
-    ] }),
-    laneCount > 1 && state.mergeState && /* @__PURE__ */ jsxs7(Fragment, { children: [
+      /* @__PURE__ */ jsxs7(Box7, { flexDirection: "column", paddingLeft: 1, children: [
+        /* @__PURE__ */ jsx7(LaneActivityHeader, { activeLaneId: state.activeLaneId ?? null, laneCount: activeLaneCount }),
+        /* @__PURE__ */ jsx7(ActivitySection, { completedTools: state.completedTools, activeTool: state.activeTool, activeDriverName: state.activeDriverName, lastThought: state.lastThought, retryInfo: state.retryInfo, availableHeight })
+      ] })
+    ] }) : /* @__PURE__ */ jsxs7(Fragment, { children: [
       /* @__PURE__ */ jsx7(Separator, {}),
-      /* @__PURE__ */ jsx7(MergeStatus, { mergeState: state.mergeState })
-    ] }),
-    (state.stories.length > 0 || laneCount > 1 && (state.summaryBar || state.mergeState)) && /* @__PURE__ */ jsx7(Separator, {}),
-    /* @__PURE__ */ jsxs7(Box7, { flexDirection: "column", paddingLeft: 1, children: [
-      /* @__PURE__ */ jsx7(LaneActivityHeader, { activeLaneId: state.activeLaneId ?? null, laneCount: activeLaneCount }),
-      /* @__PURE__ */ jsx7(CompletedTools, { tools: state.completedTools }),
-      state.activeTool && /* @__PURE__ */ jsx7(ActiveTool, { name: state.activeTool.name, driverName: state.activeDriverName }),
-      state.lastThought && /* @__PURE__ */ jsx7(LastThought, { text: state.lastThought }),
-      state.retryInfo && /* @__PURE__ */ jsx7(RetryNotice, { info: state.retryInfo })
+      /* @__PURE__ */ jsx7(ProgressBar, { done: state.sprintInfo?.done ?? 0, total: state.sprintInfo?.total ?? 0 }),
+      /* @__PURE__ */ jsx7(EpicInfo, { info: state.sprintInfo }),
+      /* @__PURE__ */ jsx7(StoryContext, { entries: state.storyContext ?? [] }),
+      /* @__PURE__ */ jsx7(Separator, {}),
+      /* @__PURE__ */ jsx7(WorkflowGraph, { flow: state.workflowFlow, currentTask: state.currentTaskName, taskStates: state.taskStates }),
+      /* @__PURE__ */ jsx7(Separator, {}),
+      /* @__PURE__ */ jsx7(ActivitySection, { completedTools: state.completedTools, activeTool: state.activeTool, activeDriverName: state.activeDriverName, lastThought: state.lastThought, retryInfo: state.retryInfo, availableHeight })
     ] })
   ] });
 }
@@ -5596,139 +5527,54 @@ function shortKey(key) {
   const m = key.match(/^(\d+-\d+)/);
   return m ? m[1] : key;
 }
-function formatCost3(cost) {
+function formatCost2(cost) {
   return `$${cost.toFixed(2)}`;
 }
 function Header({ info: info3, laneCount }) {
   if (!info3) return null;
   const parts = ["codeharness run"];
-  if (laneCount != null && laneCount > 1) {
-    parts.push(`${laneCount} lanes`);
-  }
-  if (info3.iterationCount != null) {
-    parts.push(`iteration ${info3.iterationCount}`);
-  }
-  if (info3.elapsed) {
-    parts.push(`${info3.elapsed} elapsed`);
-  }
+  if (laneCount != null && laneCount > 1) parts.push(`${laneCount} lanes`);
+  if (info3.elapsed) parts.push(`${info3.elapsed} elapsed`);
   const displayCost = laneCount != null && laneCount > 1 && info3.laneTotalCost != null ? info3.laneTotalCost : info3.totalCost;
-  if (displayCost != null) {
-    parts.push(`${formatCost3(displayCost)} spent`);
-  }
-  const headerLine = parts.join(" | ");
-  let phaseLine = "";
-  if (info3.phase) {
-    phaseLine = `Phase: ${info3.phase}`;
-    if (info3.acProgress) {
-      phaseLine += ` \u2192 AC ${info3.acProgress}`;
-    }
-    if (info3.currentCommand) {
-      phaseLine += ` (${info3.currentCommand})`;
-    }
-  }
-  return /* @__PURE__ */ jsxs8(Box8, { flexDirection: "column", children: [
-    /* @__PURE__ */ jsx8(Text8, { children: headerLine }),
-    /* @__PURE__ */ jsx8(Separator, {}),
-    /* @__PURE__ */ jsx8(Text8, { children: `Story: ${info3.storyKey || "(waiting)"}` }),
-    phaseLine && /* @__PURE__ */ jsx8(Text8, { children: phaseLine })
+  if (displayCost != null) parts.push(`${formatCost2(displayCost)} spent`);
+  const left = parts.join(" | ");
+  const right = "[q to quit]";
+  const width = process.stdout.columns || 80;
+  const pad = Math.max(0, width - left.length - right.length);
+  return /* @__PURE__ */ jsxs8(Text8, { children: [
+    left,
+    " ".repeat(pad),
+    /* @__PURE__ */ jsx8(Text8, { dimColor: true, children: right })
   ] });
 }
-function StoryBreakdown({ stories, sprintInfo }) {
-  if (stories.length === 0) return null;
-  const done = [];
-  const inProgress = [];
-  const pending = [];
-  const failed = [];
-  const blocked = [];
-  for (const s of stories) {
-    switch (s.status) {
-      case "done":
-        done.push(s);
-        break;
-      case "in-progress":
-        inProgress.push(s);
-        break;
-      case "pending":
-        pending.push(s);
-        break;
-      case "failed":
-        failed.push(s);
-        break;
-      case "blocked":
-        blocked.push(s);
-        break;
-    }
-  }
-  const lines = [];
-  if (done.length > 0) {
-    const doneItems = done.map((s) => {
-      let item = `${shortKey(s.key)} \u2713`;
-      if (s.costByDriver && Object.keys(s.costByDriver).length > 0) {
-        const costParts = Object.keys(s.costByDriver).sort().map(
-          (driver) => `${driver} ${formatCost3(s.costByDriver[driver])}`
-        );
-        item += ` ${costParts.join(", ")}`;
-      }
-      return item;
-    }).join("  ");
-    lines.push(
-      /* @__PURE__ */ jsxs8(Text8, { children: [
-        /* @__PURE__ */ jsx8(Text8, { color: "green", children: "Done: " }),
-        /* @__PURE__ */ jsx8(Text8, { color: "green", children: doneItems })
-      ] }, "done")
-    );
-  }
-  if (inProgress.length > 0) {
-    for (const s of inProgress) {
-      let thisText = `${shortKey(s.key)} \u25C6`;
-      if (sprintInfo && sprintInfo.storyKey && shortKey(s.key) === shortKey(sprintInfo.storyKey)) {
-        if (sprintInfo.phase) thisText += ` ${sprintInfo.phase}`;
-        if (sprintInfo.acProgress) thisText += ` (${sprintInfo.acProgress} ACs)`;
-      }
-      lines.push(
-        /* @__PURE__ */ jsxs8(Text8, { children: [
-          /* @__PURE__ */ jsx8(Text8, { color: "cyan", children: "This: " }),
-          /* @__PURE__ */ jsx8(Text8, { color: "cyan", children: thisText })
-        ] }, `this-${s.key}`)
-      );
-    }
-  }
-  if (pending.length > 0) {
-    lines.push(
-      /* @__PURE__ */ jsxs8(Text8, { children: [
-        /* @__PURE__ */ jsx8(Text8, { children: "Next: " }),
-        /* @__PURE__ */ jsx8(Text8, { children: shortKey(pending[0].key) }),
-        pending.length > 1 && /* @__PURE__ */ jsx8(Text8, { dimColor: true, children: ` (+${pending.length - 1} more)` })
-      ] }, "next")
-    );
-  }
-  if (blocked.length > 0) {
-    const blockedItems = blocked.map((s) => {
-      let item = `${shortKey(s.key)} \u2715`;
-      if (s.retryCount != null && s.maxRetries != null) item += ` (${s.retryCount}/${s.maxRetries})`;
-      return item;
-    }).join("  ");
-    lines.push(
-      /* @__PURE__ */ jsxs8(Text8, { children: [
-        /* @__PURE__ */ jsx8(Text8, { color: "yellow", children: "Blocked: " }),
-        /* @__PURE__ */ jsx8(Text8, { color: "yellow", children: blockedItems })
-      ] }, "blocked")
-    );
-  }
-  if (failed.length > 0) {
-    const failedItems = failed.map((s) => {
-      let item = `${shortKey(s.key)} \u2717`;
-      if (s.retryCount != null && s.maxRetries != null) item += ` (${s.retryCount}/${s.maxRetries})`;
-      return item;
-    }).join("  ");
-    lines.push(
-      /* @__PURE__ */ jsxs8(Text8, { children: [
-        /* @__PURE__ */ jsx8(Text8, { color: "red", children: "Failed: " }),
-        /* @__PURE__ */ jsx8(Text8, { color: "red", children: failedItems })
-      ] }, "failed")
-    );
-  }
-  return /* @__PURE__ */ jsx8(Box8, { flexDirection: "column", children: lines });
+function ProgressBar({ done, total }) {
+  const width = Math.max(10, (process.stdout.columns || 80) - 30);
+  const pct = total > 0 ? done / total : 0;
+  const filled = Math.round(width * pct);
+  const bar = "\u2588".repeat(filled) + "\u2591".repeat(width - filled);
+  const pctStr = total > 0 ? `${Math.round(pct * 100)}%` : "0%";
+  return /* @__PURE__ */ jsxs8(Text8, { children: [
+    "Progress: ",
+    /* @__PURE__ */ jsx8(Text8, { color: "green", children: bar }),
+    ` ${done}/${total} stories (${pctStr})`
+  ] });
+}
+function EpicInfo({ info: info3 }) {
+  if (!info3?.epicId) return null;
+  const title = info3.epicTitle ?? `Epic ${info3.epicId}`;
+  const progress = info3.epicStoriesTotal ? ` \u2014 ${info3.epicStoriesDone ?? 0}/${info3.epicStoriesTotal} stories done` : "";
+  return /* @__PURE__ */ jsxs8(Text8, { children: [
+    /* @__PURE__ */ jsx8(Text8, { bold: true, children: `Epic ${info3.epicId}: ${title}` }),
+    /* @__PURE__ */ jsx8(Text8, { dimColor: true, children: progress })
+  ] });
+}
+function StoryContext({ entries }) {
+  if (entries.length === 0) return null;
+  return /* @__PURE__ */ jsx8(Box8, { flexDirection: "column", children: entries.map((e, i) => {
+    if (e.role === "prev") return /* @__PURE__ */ jsx8(Text8, { children: /* @__PURE__ */ jsx8(Text8, { color: "green", children: `  Prev: ${shortKey(e.key)} \u2713` }) }, i);
+    if (e.role === "current") return /* @__PURE__ */ jsx8(Text8, { children: /* @__PURE__ */ jsx8(Text8, { color: "cyan", children: `  This: ${shortKey(e.key)} \u25C6 ${e.task ?? ""}` }) }, i);
+    return /* @__PURE__ */ jsx8(Text8, { children: /* @__PURE__ */ jsx8(Text8, { dimColor: true, children: `  Next: ${shortKey(e.key)}` }) }, i);
+  }) });
 }
 
 // src/lib/ink-renderer.tsx
@@ -5771,6 +5617,7 @@ function startRenderer(options) {
     taskMeta: {},
     activeDriverName: null,
     driverCosts: {},
+    storyContext: [],
     activeLaneId: null,
     laneCount: 0
   };
@@ -6125,6 +5972,24 @@ function startRenderer(options) {
       lastStoryKey = currentKey;
     }
     state.stories = updatedStories;
+    const ctx = [];
+    const currentStory = currentKey ?? "";
+    const currentTask = state.currentTaskName ?? "";
+    let foundCurrent = false;
+    let prevKey = null;
+    for (const s of updatedStories) {
+      if (s.key === currentStory) {
+        if (prevKey) ctx.push({ key: prevKey, role: "prev" });
+        ctx.push({ key: s.key, role: "current", task: currentTask });
+        foundCurrent = true;
+      } else if (foundCurrent && s.status === "pending") {
+        ctx.push({ key: s.key, role: "next" });
+        break;
+      } else if (s.status === "done") {
+        prevKey = s.key;
+      }
+    }
+    state.storyContext = ctx;
     rerender();
   }
   function addMessage(msg) {
@@ -6326,15 +6191,28 @@ function registerRunCommand(program) {
     let currentTaskName = "";
     const headerRefresh = setInterval(() => {
       if (interrupted) return;
+      const epicId = currentStoryKey ? extractEpicId2(currentStoryKey) : "";
+      const epic = epicId ? epicData[epicId] : void 0;
       renderer.updateSprintState({
         storyKey: currentStoryKey,
         phase: currentTaskName,
         done: storiesDone,
         total: counts.total,
         totalCost: totalCostUsd,
-        elapsed: formatElapsed(Date.now() - sessionStartMs)
+        elapsed: formatElapsed(Date.now() - sessionStartMs),
+        epicId: epicId || void 0,
+        epicStoriesDone: epic?.storiesDone,
+        epicStoriesTotal: epic?.storiesTotal
       });
     }, 2e3);
+    const epicData = {};
+    const sprintStateResult = getSprintState2();
+    if (sprintStateResult.success) {
+      for (const [epicKey, epic] of Object.entries(sprintStateResult.data.epics ?? {})) {
+        const epicId = epicKey.replace("epic-", "");
+        epicData[epicId] = { storiesDone: epic.storiesDone ?? 0, storiesTotal: epic.storiesTotal ?? 0 };
+      }
+    }
     const taskStates = {};
     const taskMeta = {};
     for (const [tn, task] of Object.entries(parsedWorkflow.tasks)) {
@@ -6357,13 +6235,18 @@ function registerRunCommand(program) {
       if (event.type === "dispatch-start") {
         currentStoryKey = event.storyKey;
         currentTaskName = event.taskName;
+        const epicId = extractEpicId2(event.storyKey);
+        const epic = epicData[epicId];
         renderer.updateSprintState({
           storyKey: event.storyKey,
           phase: event.taskName,
           done: storiesDone,
           total: counts.total,
           totalCost: totalCostUsd,
-          elapsed: formatElapsed(Date.now() - sessionStartMs)
+          elapsed: formatElapsed(Date.now() - sessionStartMs),
+          epicId,
+          epicStoriesDone: epic?.storiesDone ?? 0,
+          epicStoriesTotal: epic?.storiesTotal ?? 0
         });
         taskStates[event.taskName] = "active";
         renderer.updateWorkflowState(parsedWorkflow.flow, event.taskName, { ...taskStates }, { ...taskMeta });
@@ -10593,7 +10476,7 @@ async function handleDockerCheck(isJson) {
     }
   }
 }
-function formatElapsed3(ms) {
+function formatElapsed2(ms) {
   const s = Math.floor(ms / 1e3);
   const h = Math.floor(s / 3600);
   const m = Math.floor(s % 3600 / 60);
@@ -10613,7 +10496,7 @@ function printWorkflowState() {
   console.log(`  Tasks completed: ${state.tasks_completed.length}`);
   if (state.phase === "executing" && state.started) {
     const elapsed = Date.now() - Date.parse(state.started);
-    console.log(`  Elapsed: ${formatElapsed3(elapsed)}`);
+    console.log(`  Elapsed: ${formatElapsed2(elapsed)}`);
   }
   if (state.evaluator_scores.length > 0) {
     const latest = state.evaluator_scores[state.evaluator_scores.length - 1];
@@ -10638,7 +10521,7 @@ function getWorkflowStateData() {
   };
   if (state.phase === "executing" && state.started) {
     data.elapsed_ms = Date.now() - Date.parse(state.started);
-    data.elapsed = formatElapsed3(data.elapsed_ms);
+    data.elapsed = formatElapsed2(data.elapsed_ms);
   }
   return data;
 }
@@ -11290,7 +11173,7 @@ function registerTeardownCommand(program) {
     } else if (otlpMode === "remote-routed") {
       if (!options.keepDocker) {
         try {
-          const { stopCollectorOnly: stopCollectorOnly2 } = await import("./docker-7QONH2B5.js");
+          const { stopCollectorOnly: stopCollectorOnly2 } = await import("./docker-TANMGEDO.js");
           stopCollectorOnly2();
           result.docker.stopped = true;
           if (!isJson) {
@@ -11322,7 +11205,7 @@ function registerTeardownCommand(program) {
         info("Shared stack: kept running (other projects may use it)");
       }
     } else if (isLegacyStack) {
-      const { isStackRunning: isStackRunning2, stopStack } = await import("./docker-7QONH2B5.js");
+      const { isStackRunning: isStackRunning2, stopStack } = await import("./docker-TANMGEDO.js");
       let stackRunning = false;
       try {
         stackRunning = isStackRunning2(composeFile);
@@ -13863,12 +13746,12 @@ var CodexDriver = class {
         opts.plugins
       );
     }
-    const args = [];
+    const args = ["exec"];
     if (opts.model) {
       args.push("--model", opts.model);
     }
     if (opts.cwd) {
-      args.push("--cwd", opts.cwd);
+      args.push("--cd", opts.cwd);
     }
     args.push(opts.prompt);
     let yieldedResult = false;
@@ -14218,7 +14101,7 @@ function registerDriversCommand(program) {
 }
 
 // src/index.ts
-var VERSION = true ? "0.30.0" : "0.0.0-dev";
+var VERSION = true ? "0.31.0" : "0.0.0-dev";
 function createProgram() {
   const program = new Command();
   program.name("codeharness").description("Makes autonomous coding agents produce software that actually works").version(VERSION).option("--json", "Output in machine-readable JSON format");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeharness",
-  "version": "0.30.0",
+  "version": "0.31.0",
   "type": "module",
   "description": "CLI for codeharness — makes autonomous coding agents produce software that actually works",
   "bin": {

package/templates/agents/checker.yaml

@@ -0,0 +1,65 @@
+name: checker
+role:
+  title: Automated Checker
+  purpose: Run tests, linter, and coverage checks — report pass/fail objectively
+persona:
+  identity: |
+    CI bot that runs the project's test suite, linter, and coverage tool.
+    Reports results objectively — no interpretation, no fixes, just facts.
+  communication_style: "Machine-like. Commands run, output captured, pass/fail reported."
+  principles:
+    - Run the project's actual test command (npm test, pytest, cargo test, etc.)
+    - Run the project's linter if configured (eslint, ruff, clippy, etc.)
+    - Check coverage against target if configured
+    - Report exact command, exit code, and output for each check
+    - Never fix code — only report results
+prompt_template: |
+  ## Role
+
+  You are running automated checks on the implementation. Run tests, linter, and coverage. Report results.
+
+  ## Process
+
+  1. **Detect check commands** from the project (package.json scripts, pyproject.toml, Makefile, etc.)
+  2. **Run tests**: execute the test command, capture output and exit code
+  3. **Run linter**: execute the lint command if available
+  4. **Check coverage**: if a coverage target exists, verify it's met
+
+  ## Output Format
+
+  Output a single JSON object:
+
+  ```json
+  {
+    "verdict": "pass" | "fail",
+    "checks": [
+      {
+        "name": "tests",
+        "command": "npm test",
+        "exit_code": 0,
+        "passed": true,
+        "summary": "42 tests passed"
+      },
+      {
+        "name": "lint",
+        "command": "npm run lint",
+        "exit_code": 0,
+        "passed": true,
+        "summary": "no issues"
+      },
+      {
+        "name": "coverage",
+        "command": "npm run coverage",
+        "exit_code": 0,
+        "passed": true,
+        "summary": "98% (target: 100%)"
+      }
+    ]
+  }
+  ```
+
+  Verdict is "pass" only if ALL checks pass.
+
+  ## Output Location
+
+  Write results to ./verdict/check.json

package/templates/workflows/default.yaml

@@ -11,6 +11,12 @@ tasks:
     session: fresh
     source_access: true
     model: claude-sonnet-4-6
+  check:
+    agent: checker
+    scope: per-story
+    session: fresh
+    source_access: true
+    driver: codex
   review:
     agent: reviewer
     scope: per-story
@@ -39,10 +45,12 @@ tasks:
 flow:
   - create-story
   - implement
+  - check
   - review
   - verify
   - loop:
       - retry
+      - check
       - review
       - verify
   - retro