issue-flow 0.7.1 → 0.7.3

package/README.md

@@ -103,7 +103,7 @@ Verifies that `claude`, `gh` (authenticated), and `git` (inside a repo) are avai
 npx issue-flow analyze 42
 ```
 
-Invokes Claude headlessly to fetch issue data, analyze the codebase, and produce a structured analysis saved to `issues/42/analysis.md`.
+Invokes Claude headlessly to fetch issue data, analyze the codebase, and produce a structured analysis saved to `~/.issue-flow/…/issues/42/analysis.md` (see [Pipeline State](#pipeline-state)).
 
 ### `prd` -- Generate a PRD
 
@@ -111,7 +111,7 @@ Invokes Claude headlessly to fetch issue data, analyze the codebase, and produce
 npx issue-flow prd 42
 ```
 
-Generates a Product Requirements Document from the issue analysis. Reads `issues/N/analysis.md` as context if available. Saves to `issues/42/prd.md`.
+Generates a Product Requirements Document from the issue analysis. Reads `analysis.md` from the same directory as context if available. Saves to `~/.issue-flow/…/issues/42/prd.md`.
 
 ### `plan` -- Convert PRD to task plan
 
@@ -119,7 +119,7 @@ Generates a Product Requirements Document from the issue analysis. Reads `issues
 npx issue-flow plan 42
 ```
 
-Converts the PRD into a structured `issues/42/tasks.json` with ordered user stories, acceptance criteria, and pipeline state. Validates the output with zod schemas.
+Converts the PRD into a structured `~/.issue-flow/…/issues/42/tasks.json` with ordered user stories, acceptance criteria, and pipeline state. Validates the output with zod schemas.
 
 ### `execute` -- Run the story execution loop
 
@@ -133,7 +133,7 @@ Runs the iterative agent loop. Each iteration is a fresh Claude instance that pi
 
 | Flag | Description |
 |------|-------------|
-| `--issue N` | Issue number -- reads artifacts from `issues/N/` |
+| `--issue N` | Issue number -- reads artifacts from `~/.issue-flow/…/issues/N/` |
 | `--max-iterations N` | Stop after N iterations (default: unlimited) |
 | `--retry-limit N` | Retry transient Claude failures up to N consecutive times (default: 10) |
 | `--retry-forever` | Retry transient Claude failures indefinitely |
@@ -185,22 +185,26 @@ Each setting resolves with the precedence **CLI flag > environment variable > `.
 | `--web-log-limit <n>` | `ISSUE_FLOW_WEB_LOG_LIMIT` | `web.logLimit` | `200` |
 | `--web-no-logs` | -- | `web.includeLogs` | logs included |
 
-Monitoring never affects the pipeline: with `--web` off the behavior is byte-for-byte identical, a busy port just skips the server with a warning, and killing the server mid-run has no effect on the execution. While enabled, the snapshot served at `/api/status` is also persisted to `issues/N/session.json` -- if your project commits the `issues/` directory, add `issues/*/session.json` to your `.gitignore`.
+Monitoring never affects the pipeline: with `--web` off the behavior is byte-for-byte identical, a busy port just skips the server with a warning, and killing the server mid-run has no effect on the execution. While enabled, the snapshot served at `/api/status` is also persisted to `~/.issue-flow/…/issues/N/session.json` -- outside your working tree, so there is nothing to add to `.gitignore`.
 
 For the full documentation (endpoints, `session.json` format, Tailscale setup), see the [root README](../../README.md#web-monitoring).
 
 ## Pipeline State
 
-Each issue's state is tracked in `issues/N/tasks.json`:
+Each issue's state is tracked in a directory of its own under `~/.issue-flow`, keyed by a deterministic project id and the issue identifier:
 
 ```
-issues/42/
+~/.issue-flow/projects/<project-id>/issues/42/
   analysis.md    # Issue analysis
   prd.md         # Product requirements
   tasks.json     # Task plan with pipeline state and user stories
   progress.txt   # Execution log
+  session.json   # Live session snapshot (web monitoring only)
+  pr-review/     # PR review reports and index
 ```
 
+Nothing is written to your repository. A `<projectRoot>/issues/` tree left by an earlier release is copied here automatically on first use and then treated as read-only -- see the [root README](../../README.md#global-storage) for the full layout, the project id derivation and the migration.
+
 The `pipeline` field tracks which phases have completed, enabling resume from any point:
 
 ```json

package/dist/{analyze-R25HDGBJ.js → analyze-PJBY346H.js}

@@ -2,17 +2,18 @@
 import {
   issuePlaceholders,
   resolveCommandIssue
-} from "./chunk-RN2FAMUU.js";
+} from "./chunk-7YS3J4A2.js";
 import {
   runHeadless
-} from "./chunk-TCOS2KFB.js";
+} from "./chunk-IWBHBDRU.js";
 import {
   applyPlaceholders,
-  loadPrompt
-} from "./chunk-SLHZPB3C.js";
+  loadPrompt,
+  publishPhaseMetrics
+} from "./chunk-7HX2RPFY.js";
 import {
-  getIssueDir
-} from "./chunk-2AVZZAC6.js";
+  resolveIssuePaths
+} from "./chunk-OCXHO7YP.js";
 import {
   getGlobalTimeout,
   loadTaskPlan,
@@ -20,20 +21,19 @@ import {
   printInfo,
   printSuccess,
   saveTaskPlan
-} from "./chunk-JNEHVQH5.js";
+} from "./chunk-6HGZYTAT.js";
 
 // src/commands/analyze.ts
 import { mkdir, readFile, writeFile } from "fs/promises";
-import { join } from "path";
 async function runAnalyze(issue, resolvedIssue) {
   const issueNumber = issue.replace(/^#/, "");
-  const issueDir = await getIssueDir(issueNumber);
-  const analysisPath = join(issueDir, "analysis.md");
+  const paths = await resolveIssuePaths(issueNumber);
+  const analysisPath = paths.analysisFile;
   const resolution = await resolveCommandIssue(issueNumber, resolvedIssue);
   if (!resolution.ok) {
     return resolution.code;
   }
-  await mkdir(issueDir, { recursive: true });
+  await mkdir(paths.issueDir, { recursive: true });
   const template = await loadPrompt("analyze");
   const prompt = applyPlaceholders(template, {
     __ISSUE_NUMBER__: issueNumber,
@@ -42,14 +42,19 @@ async function runAnalyze(issue, resolvedIssue) {
     // body that happens to contain a placeholder is left untouched.
     ...issuePlaceholders(resolution.resolved)
   });
+  const startedAtMs = Date.now();
   const result = await runHeadless({
     prompt,
     maxTurns: 30,
     timeout: getGlobalTimeout() ?? 3e5,
-    outputFormat: "text",
+    // json (not text) so the CLI reports usage: the envelope's `result` field
+    // carries the same assistant text this phase already consumed.
+    outputFormat: "json",
     allowedTools: ["Bash", "Read", "Glob", "Grep", "Write"],
+    addDirs: [paths.issueDir],
     statusMessage: `Analyzing issue #${issueNumber}...`
   });
+  publishPhaseMetrics("analyze", result.cost, startedAtMs);
   if (!result.success) {
     printError(`Analysis failed: ${result.error}`);
     return 1;
@@ -64,7 +69,7 @@ async function runAnalyze(issue, resolvedIssue) {
     printInfo("Headless did not create analysis file; saving output directly");
     await writeFile(analysisPath, result.result, "utf-8");
   }
-  const tasksPath = join(issueDir, "tasks.json");
+  const tasksPath = paths.tasksFile;
   try {
     const plan = await loadTaskPlan(tasksPath);
     plan.pipeline.analyzeCompleted = true;
@@ -77,4 +82,4 @@ async function runAnalyze(issue, resolvedIssue) {
 export {
   runAnalyze
 };
-//# sourceMappingURL=analyze-R25HDGBJ.js.map
+//# sourceMappingURL=analyze-PJBY346H.js.map

package/dist/analyze-PJBY346H.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/analyze.ts"],"sourcesContent":["import { mkdir, readFile, writeFile } from 'node:fs/promises';\nimport { runHeadless } from '../core/headless.js';\nimport { applyPlaceholders, loadPrompt } from '../core/prompt-resolver.js';\nimport { publishPhaseMetrics } from '../core/session-metrics.js';\nimport { loadTaskPlan, saveTaskPlan } from '../core/state-manager.js';\nimport { getGlobalTimeout } from '../core/verbose.js';\nimport { issuePlaceholders, resolveCommandIssue } from '../issues/context.js';\nimport type { ResolvedIssue } from '../issues/types.js';\nimport { resolveIssuePaths } from '../storage/resolve.js';\nimport { printError, printInfo, printSuccess } from '../ui/logger.js';\n\nexport async function runAnalyze(issue: string, resolvedIssue?: ResolvedIssue): Promise<number> {\n  const issueNumber = issue.replace(/^#/, '');\n  const paths = await resolveIssuePaths(issueNumber);\n  const analysisPath = paths.analysisFile;\n\n  const resolution = await resolveCommandIssue(issueNumber, resolvedIssue);\n  if (!resolution.ok) {\n    return resolution.code;\n  }\n\n  await mkdir(paths.issueDir, { recursive: true });\n\n  const template = await loadPrompt('analyze');\n  const prompt = applyPlaceholders(template, {\n    __ISSUE_NUMBER__: issueNumber,\n    __ANALYSIS_PATH__: analysisPath,\n    // Last: the Issue content is substituted in but never scanned again, so a\n    // body that happens to contain a placeholder is left untouched.\n    ...issuePlaceholders(resolution.resolved),\n  });\n\n  const startedAtMs = Date.now();\n  const result = await runHeadless({\n    prompt,\n    maxTurns: 30,\n    timeout: getGlobalTimeout() ?? 300_000,\n    // json (not text) so the CLI reports usage: the envelope's `result` field\n    // carries the same assistant text this phase already consumed.\n    outputFormat: 'json',\n    allowedTools: ['Bash', 'Read', 'Glob', 'Grep', 'Write'],\n    addDirs: [paths.issueDir],\n    statusMessage: `Analyzing issue #${issueNumber}...`,\n  });\n  // Before the success check: the tokens were spent either way.\n  publishPhaseMetrics('analyze', result.cost, startedAtMs);\n\n  if (!result.success) {\n    printError(`Analysis failed: ${result.error}`);\n    return 1;\n  }\n\n  // Verify the file was created\n  try {\n    const content = await readFile(analysisPath, 'utf-8');\n    if (content.length < 10) {\n      printError('Analysis file was created but appears empty');\n      return 1;\n    }\n  } catch {\n    // File wasn't created by headless — save the result as analysis\n    printInfo('Headless did not create analysis file; saving output directly');\n    await writeFile(analysisPath, result.result, 'utf-8');\n  }\n\n  // Update pipeline state\n  const tasksPath = paths.tasksFile;\n  try {\n    const plan = await loadTaskPlan(tasksPath);\n    plan.pipeline.analyzeCompleted = true;\n    await saveTaskPlan(tasksPath, plan);\n  } catch {\n    // tasks.json may not exist yet — that's OK for standalone analyze\n  }\n\n  printSuccess(`Analysis saved to ${analysisPath}`);\n  return 0;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,OAAO,UAAU,iBAAiB;AAW3C,eAAsB,WAAW,OAAe,eAAgD;AAC9F,QAAM,cAAc,MAAM,QAAQ,MAAM,EAAE;AAC1C,QAAM,QAAQ,MAAM,kBAAkB,WAAW;AACjD,QAAM,eAAe,MAAM;AAE3B,QAAM,aAAa,MAAM,oBAAoB,aAAa,aAAa;AACvE,MAAI,CAAC,WAAW,IAAI;AAClB,WAAO,WAAW;AAAA,EACpB;AAEA,QAAM,MAAM,MAAM,UAAU,EAAE,WAAW,KAAK,CAAC;AAE/C,QAAM,WAAW,MAAM,WAAW,SAAS;AAC3C,QAAM,SAAS,kBAAkB,UAAU;AAAA,IACzC,kBAAkB;AAAA,IAClB,mBAAmB;AAAA;AAAA;AAAA,IAGnB,GAAG,kBAAkB,WAAW,QAAQ;AAAA,EAC1C,CAAC;AAED,QAAM,cAAc,KAAK,IAAI;AAC7B,QAAM,SAAS,MAAM,YAAY;AAAA,IAC/B;AAAA,IACA,UAAU;AAAA,IACV,SAAS,iBAAiB,KAAK;AAAA;AAAA;AAAA,IAG/B,cAAc;AAAA,IACd,cAAc,CAAC,QAAQ,QAAQ,QAAQ,QAAQ,OAAO;AAAA,IACtD,SAAS,CAAC,MAAM,QAAQ;AAAA,IACxB,eAAe,oBAAoB,WAAW;AAAA,EAChD,CAAC;AAED,sBAAoB,WAAW,OAAO,MAAM,WAAW;AAEvD,MAAI,CAAC,OAAO,SAAS;AACnB,eAAW,oBAAoB,OAAO,KAAK,EAAE;AAC7C,WAAO;AAAA,EACT;AAGA,MAAI;AACF,UAAM,UAAU,MAAM,SAAS,cAAc,OAAO;AACpD,QAAI,QAAQ,SAAS,IAAI;AACvB,iBAAW,6CAA6C;AACxD,aAAO;AAAA,IACT;AAAA,EACF,QAAQ;AAEN,cAAU,+DAA+D;AACzE,UAAM,UAAU,cAAc,OAAO,QAAQ,OAAO;AAAA,EACtD;AAGA,QAAM,YAAY,MAAM;AACxB,MAAI;AACF,UAAM,OAAO,MAAM,aAAa,SAAS;AACzC,SAAK,SAAS,mBAAmB;AACjC,UAAM,aAAa,WAAW,IAAI;AAAA,EACpC,QAAQ;AAAA,EAER;AAEA,eAAa,qBAAqB,YAAY,EAAE;AAChD,SAAO;AACT;","names":[]}

package/dist/{chunk-EM43T462.js → chunk-3ISZ7T5M.js}

@@ -2,27 +2,27 @@
 import {
   issuePlaceholders,
   resolveCommandIssue
-} from "./chunk-RN2FAMUU.js";
+} from "./chunk-7YS3J4A2.js";
 import {
   runHeadless
-} from "./chunk-TCOS2KFB.js";
+} from "./chunk-IWBHBDRU.js";
 import {
   applyPlaceholders,
-  loadPrompt
-} from "./chunk-SLHZPB3C.js";
+  loadPrompt,
+  publishPhaseMetrics
+} from "./chunk-7HX2RPFY.js";
 import {
-  getIssueDir
-} from "./chunk-2AVZZAC6.js";
+  resolveIssuePaths
+} from "./chunk-OCXHO7YP.js";
 import {
   getGlobalTimeout,
   loadTaskPlan,
   printError,
   printSuccess,
   saveTaskPlan
-} from "./chunk-JNEHVQH5.js";
+} from "./chunk-6HGZYTAT.js";
 
 // src/commands/review.ts
-import { join } from "path";
 function parseReviewResult(output) {
   const match = output.match(/<review-result>([\s\S]*?)<\/review-result>/);
   if (!match) {
@@ -47,8 +47,8 @@ function parseReviewResult(output) {
 }
 async function runReview(issue, resolvedIssue) {
   const issueNumber = issue.replace(/^#/, "");
-  const issueDir = await getIssueDir(issueNumber);
-  const tasksPath = join(issueDir, "tasks.json");
+  const paths = await resolveIssuePaths(issueNumber);
+  const tasksPath = paths.tasksFile;
   const resolution = await resolveCommandIssue(issueNumber, resolvedIssue);
   if (!resolution.ok) {
     return resolution.code;
@@ -59,14 +59,19 @@ async function runReview(issue, resolvedIssue) {
     __TASKS_PATH__: tasksPath,
     ...issuePlaceholders(resolution.resolved)
   });
+  const startedAtMs = Date.now();
   const result = await runHeadless({
     prompt,
     maxTurns: 25,
     timeout: getGlobalTimeout() ?? 3e5,
-    outputFormat: "text",
+    // json (not text) so the CLI reports usage: the envelope's `result` field
+    // carries the same assistant text parseReviewResult() already consumed.
+    outputFormat: "json",
     allowedTools: ["Bash", "Read", "Glob", "Grep"],
+    addDirs: [paths.issueDir],
     statusMessage: `Reviewing issue #${issueNumber} resolution...`
   });
+  publishPhaseMetrics("review", result.cost, startedAtMs);
   if (!result.success) {
     printError(`Review failed: ${result.error}`);
     return 1;
@@ -100,4 +105,4 @@ async function runReview(issue, resolvedIssue) {
 export {
   runReview
 };
-//# sourceMappingURL=chunk-EM43T462.js.map
+//# sourceMappingURL=chunk-3ISZ7T5M.js.map

package/dist/chunk-3ISZ7T5M.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/review.ts"],"sourcesContent":["import { runHeadless } from '../core/headless.js';\nimport { applyPlaceholders, loadPrompt } from '../core/prompt-resolver.js';\nimport { publishPhaseMetrics } from '../core/session-metrics.js';\nimport { loadTaskPlan, saveTaskPlan } from '../core/state-manager.js';\nimport { getGlobalTimeout } from '../core/verbose.js';\nimport { issuePlaceholders, resolveCommandIssue } from '../issues/context.js';\nimport type { ResolvedIssue } from '../issues/types.js';\nimport { resolveIssuePaths } from '../storage/resolve.js';\nimport { printError, printSuccess } from '../ui/logger.js';\n\nexport interface ReviewResult {\n  status: 'PASS' | 'FAIL';\n  findings?: string;\n}\n\n/**\n * Parse the <review-result> block from headless output.\n */\nfunction parseReviewResult(output: string): ReviewResult {\n  const match = output.match(/<review-result>([\\s\\S]*?)<\\/review-result>/);\n  if (!match) {\n    // Try to detect PASS/FAIL from the raw output\n    if (/STATUS:\\s*PASS/i.test(output)) {\n      return { status: 'PASS' };\n    }\n    if (/STATUS:\\s*FAIL/i.test(output)) {\n      const findingsMatch = output.match(/FINDINGS:([\\s\\S]*?)(?:$|<\\/)/);\n      return { status: 'FAIL', findings: findingsMatch?.[1]?.trim() ?? 'Unknown findings' };\n    }\n    // Default to PASS if no explicit status found and no errors\n    return { status: 'PASS' };\n  }\n\n  const block = match[1];\n  if (/STATUS:\\s*PASS/i.test(block)) {\n    return { status: 'PASS' };\n  }\n\n  const findingsMatch = block.match(/FINDINGS:([\\s\\S]*)/);\n  return {\n    status: 'FAIL',\n    findings: findingsMatch?.[1]?.trim() ?? 'Unknown findings',\n  };\n}\n\nexport async function runReview(issue: string, resolvedIssue?: ResolvedIssue): Promise<number> {\n  const issueNumber = issue.replace(/^#/, '');\n  const paths = await resolveIssuePaths(issueNumber);\n  const tasksPath = paths.tasksFile;\n\n  const resolution = await resolveCommandIssue(issueNumber, resolvedIssue);\n  if (!resolution.ok) {\n    return resolution.code;\n  }\n\n  const template = await loadPrompt('review');\n  const prompt = applyPlaceholders(template, {\n    __ISSUE_NUMBER__: issueNumber,\n    __TASKS_PATH__: tasksPath,\n    ...issuePlaceholders(resolution.resolved),\n  });\n\n  const startedAtMs = Date.now();\n  const result = await runHeadless({\n    prompt,\n    maxTurns: 25,\n    timeout: getGlobalTimeout() ?? 300_000,\n    // json (not text) so the CLI reports usage: the envelope's `result` field\n    // carries the same assistant text parseReviewResult() already consumed.\n    outputFormat: 'json',\n    allowedTools: ['Bash', 'Read', 'Glob', 'Grep'],\n    addDirs: [paths.issueDir],\n    statusMessage: `Reviewing issue #${issueNumber} resolution...`,\n  });\n  // Before the success check: the tokens were spent either way. A correction\n  // cycle calls runReview() again and the reducer sums both invocations.\n  publishPhaseMetrics('review', result.cost, startedAtMs);\n\n  if (!result.success) {\n    printError(`Review failed: ${result.error}`);\n    return 1;\n  }\n\n  const review = parseReviewResult(result.result);\n\n  if (review.status === 'PASS') {\n    // Update pipeline state\n    try {\n      const plan = await loadTaskPlan(tasksPath);\n      plan.pipeline.reviewCompleted = true;\n      plan.lastReviewFindings = null;\n      await saveTaskPlan(tasksPath, plan);\n    } catch {\n      // tasks.json may not exist\n    }\n\n    printSuccess('Review PASSED — implementation meets acceptance criteria');\n    return 0;\n  }\n\n  printError('Review FAILED — issues found:');\n  if (review.findings) {\n    console.log(review.findings);\n  }\n\n  // Persist the findings so a correction cycle can act on them: without this,\n  // a re-run of execute sees every userStories[].passes already true and\n  // exits immediately without attempting any fix (see engine.ts's\n  // \"already complete\" guards).\n  try {\n    const plan = await loadTaskPlan(tasksPath);\n    plan.pipeline.reviewCompleted = false;\n    plan.lastReviewFindings = review.findings ?? 'Unknown findings';\n    await saveTaskPlan(tasksPath, plan);\n  } catch {\n    // tasks.json may not exist\n  }\n\n  return 1;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAkBA,SAAS,kBAAkB,QAA8B;AACvD,QAAM,QAAQ,OAAO,MAAM,4CAA4C;AACvE,MAAI,CAAC,OAAO;AAEV,QAAI,kBAAkB,KAAK,MAAM,GAAG;AAClC,aAAO,EAAE,QAAQ,OAAO;AAAA,IAC1B;AACA,QAAI,kBAAkB,KAAK,MAAM,GAAG;AAClC,YAAMA,iBAAgB,OAAO,MAAM,8BAA8B;AACjE,aAAO,EAAE,QAAQ,QAAQ,UAAUA,iBAAgB,CAAC,GAAG,KAAK,KAAK,mBAAmB;AAAA,IACtF;AAEA,WAAO,EAAE,QAAQ,OAAO;AAAA,EAC1B;AAEA,QAAM,QAAQ,MAAM,CAAC;AACrB,MAAI,kBAAkB,KAAK,KAAK,GAAG;AACjC,WAAO,EAAE,QAAQ,OAAO;AAAA,EAC1B;AAEA,QAAM,gBAAgB,MAAM,MAAM,oBAAoB;AACtD,SAAO;AAAA,IACL,QAAQ;AAAA,IACR,UAAU,gBAAgB,CAAC,GAAG,KAAK,KAAK;AAAA,EAC1C;AACF;AAEA,eAAsB,UAAU,OAAe,eAAgD;AAC7F,QAAM,cAAc,MAAM,QAAQ,MAAM,EAAE;AAC1C,QAAM,QAAQ,MAAM,kBAAkB,WAAW;AACjD,QAAM,YAAY,MAAM;AAExB,QAAM,aAAa,MAAM,oBAAoB,aAAa,aAAa;AACvE,MAAI,CAAC,WAAW,IAAI;AAClB,WAAO,WAAW;AAAA,EACpB;AAEA,QAAM,WAAW,MAAM,WAAW,QAAQ;AAC1C,QAAM,SAAS,kBAAkB,UAAU;AAAA,IACzC,kBAAkB;AAAA,IAClB,gBAAgB;AAAA,IAChB,GAAG,kBAAkB,WAAW,QAAQ;AAAA,EAC1C,CAAC;AAED,QAAM,cAAc,KAAK,IAAI;AAC7B,QAAM,SAAS,MAAM,YAAY;AAAA,IAC/B;AAAA,IACA,UAAU;AAAA,IACV,SAAS,iBAAiB,KAAK;AAAA;AAAA;AAAA,IAG/B,cAAc;AAAA,IACd,cAAc,CAAC,QAAQ,QAAQ,QAAQ,MAAM;AAAA,IAC7C,SAAS,CAAC,MAAM,QAAQ;AAAA,IACxB,eAAe,oBAAoB,WAAW;AAAA,EAChD,CAAC;AAGD,sBAAoB,UAAU,OAAO,MAAM,WAAW;AAEtD,MAAI,CAAC,OAAO,SAAS;AACnB,eAAW,kBAAkB,OAAO,KAAK,EAAE;AAC3C,WAAO;AAAA,EACT;AAEA,QAAM,SAAS,kBAAkB,OAAO,MAAM;AAE9C,MAAI,OAAO,WAAW,QAAQ;AAE5B,QAAI;AACF,YAAM,OAAO,MAAM,aAAa,SAAS;AACzC,WAAK,SAAS,kBAAkB;AAChC,WAAK,qBAAqB;AAC1B,YAAM,aAAa,WAAW,IAAI;AAAA,IACpC,QAAQ;AAAA,IAER;AAEA,iBAAa,+DAA0D;AACvE,WAAO;AAAA,EACT;AAEA,aAAW,oCAA+B;AAC1C,MAAI,OAAO,UAAU;AACnB,YAAQ,IAAI,OAAO,QAAQ;AAAA,EAC7B;AAMA,MAAI;AACF,UAAM,OAAO,MAAM,aAAa,SAAS;AACzC,SAAK,SAAS,kBAAkB;AAChC,SAAK,qBAAqB,OAAO,YAAY;AAC7C,UAAM,aAAa,WAAW,IAAI;AAAA,EACpC,QAAQ;AAAA,EAER;AAEA,SAAO;AACT;","names":["findingsMatch"]}

package/dist/{chunk-EHVKXFFN.js → chunk-4M4EWFZZ.js}

@@ -7,7 +7,7 @@ import {
   getSessionPublisher,
   isoNow,
   printRetry
-} from "./chunk-JNEHVQH5.js";
+} from "./chunk-6HGZYTAT.js";
 
 // src/core/phase-runner.ts
 import { readFile } from "fs/promises";
@@ -55,4 +55,4 @@ export {
   runPhaseWithRetry,
   readFileWithGrace
 };
-//# sourceMappingURL=chunk-EHVKXFFN.js.map
+//# sourceMappingURL=chunk-4M4EWFZZ.js.map

package/dist/{chunk-JNEHVQH5.js → chunk-6HGZYTAT.js}

@@ -2,6 +2,13 @@
 
 // src/schemas.ts
 import { z } from "zod";
+var claudeUsageSchema = z.object({
+  inputTokens: z.number().optional(),
+  outputTokens: z.number().optional(),
+  cacheReadTokens: z.number().optional(),
+  cacheCreationTokens: z.number().optional(),
+  costUsd: z.number().optional()
+});
 var userStorySchema = z.object({
   id: z.string(),
   title: z.string(),
@@ -9,7 +16,9 @@ var userStorySchema = z.object({
   acceptanceCriteria: z.array(z.string()),
   priority: z.number().int().positive(),
   passes: z.boolean(),
-  notes: z.string()
+  notes: z.string(),
+  ...claudeUsageSchema.shape,
+  durationSeconds: z.number().optional()
 });
 var pipelineStateSchema = z.object({
   analyzeCompleted: z.boolean().optional(),
@@ -89,10 +98,7 @@ var taskPlanSchema = z.object({
 var headlessResultSchema = z.object({
   success: z.boolean(),
   result: z.string(),
-  cost: z.object({
-    inputTokens: z.number().optional(),
-    outputTokens: z.number().optional()
-  }).nullable(),
+  cost: claudeUsageSchema.nullable(),
   error: z.string().nullable()
 });
 var sessionLogEntrySchema = z.object({
@@ -100,20 +106,31 @@ var sessionLogEntrySchema = z.object({
   level: z.enum(["info", "warn", "error"]),
   message: z.string()
 });
+var sessionUsageShape = {
+  inputTokens: z.number().nullable().default(null),
+  outputTokens: z.number().nullable().default(null),
+  cacheReadTokens: z.number().nullable().default(null),
+  cacheCreationTokens: z.number().nullable().default(null),
+  costUsd: z.number().nullable().default(null)
+};
 var sessionPhaseSchema = z.object({
   name: z.string(),
   status: z.enum(["pending", "running", "completed", "failed"]),
   startedAt: z.string().nullable(),
   endedAt: z.string().nullable(),
   durationSeconds: z.number().nullable(),
-  error: z.string().nullable()
+  error: z.string().nullable(),
+  ...sessionUsageShape
 });
 var sessionStorySchema = z.object({
   id: z.string(),
   title: z.string(),
   priority: z.number(),
   passes: z.boolean(),
-  completedAt: z.string().nullable()
+  completedAt: z.string().nullable(),
+  // Also introduced with the metrics, hence the same tolerant default.
+  durationSeconds: z.number().nullable().default(null),
+  ...sessionUsageShape
 });
 var sessionSnapshotSchema = z.object({
   schemaVersion: z.literal(1),
@@ -143,6 +160,21 @@ var sessionSnapshotSchema = z.object({
   }).nullable(),
   phases: z.array(sessionPhaseSchema),
   stories: z.array(sessionStorySchema),
+  // The whole aggregate is additive: a snapshot from before it existed parses
+  // into the same "nothing reported" object the reducer starts from.
+  metrics: z.object({
+    totalInputTokens: z.number().nullable().default(null),
+    totalOutputTokens: z.number().nullable().default(null),
+    totalCacheReadTokens: z.number().nullable().default(null),
+    totalCacheCreationTokens: z.number().nullable().default(null),
+    totalCostUsd: z.number().nullable().default(null)
+  }).default({
+    totalInputTokens: null,
+    totalOutputTokens: null,
+    totalCacheReadTokens: null,
+    totalCacheCreationTokens: null,
+    totalCostUsd: null
+  }),
   execution: z.object({
     iteration: z.number(),
     retries: z.number(),
@@ -186,6 +218,24 @@ import { dirname } from "path";
 import { stripVTControlCharacters } from "util";
 var DEFAULT_LOG_LIMIT = 200;
 var DEFAULT_THROTTLE_MS = 1e3;
+function emptyUsage() {
+  return {
+    inputTokens: null,
+    outputTokens: null,
+    cacheReadTokens: null,
+    cacheCreationTokens: null,
+    costUsd: null
+  };
+}
+function emptyMetrics() {
+  return {
+    totalInputTokens: null,
+    totalOutputTokens: null,
+    totalCacheReadTokens: null,
+    totalCacheCreationTokens: null,
+    totalCostUsd: null
+  };
+}
 function createInitialSnapshot() {
   return {
     schemaVersion: 1,
@@ -210,6 +260,7 @@ function createInitialSnapshot() {
     currentActivity: null,
     phases: [],
     stories: [],
+    metrics: emptyMetrics(),
     execution: { iteration: 0, retries: 0, correctionCycle: 0, maxCorrectionCycles: null },
     git: { branch: null, baseBranch: null, commits: [] },
     pullRequests: [],
@@ -221,6 +272,19 @@ function createInitialSnapshot() {
     environment: null
   };
 }
+function accumulate(current, delta) {
+  return delta === void 0 ? current : (current ?? 0) + delta;
+}
+function accumulateUsage(target, event) {
+  return {
+    ...target,
+    inputTokens: accumulate(target.inputTokens, event.inputTokens),
+    outputTokens: accumulate(target.outputTokens, event.outputTokens),
+    cacheReadTokens: accumulate(target.cacheReadTokens, event.cacheReadTokens),
+    cacheCreationTokens: accumulate(target.cacheCreationTokens, event.cacheCreationTokens),
+    costUsd: accumulate(target.costUsd, event.costUsd)
+  };
+}
 function secondsBetween(from, to) {
   if (from === null) return null;
   const fromMs = Date.parse(from);
@@ -284,7 +348,8 @@ function applyEvent(snapshot, event, options) {
           startedAt: null,
           endedAt: null,
           durationSeconds: null,
-          error: null
+          error: null,
+          ...emptyUsage()
         })),
         git: { branch: event.branch ?? null, baseBranch: event.baseBranch ?? null, commits: [] },
         environment: event.environment ?? null
@@ -308,7 +373,8 @@ function applyEvent(snapshot, event, options) {
           startedAt: event.at,
           endedAt: null,
           durationSeconds: null,
-          error: null
+          error: null,
+          ...emptyUsage()
         }
       ];
       return {
@@ -363,7 +429,13 @@ function applyEvent(snapshot, event, options) {
           title: story.title,
           priority: story.priority,
           passes: story.passes,
-          completedAt
+          completedAt,
+          durationSeconds: before?.durationSeconds ?? null,
+          inputTokens: before?.inputTokens ?? null,
+          outputTokens: before?.outputTokens ?? null,
+          cacheReadTokens: before?.cacheReadTokens ?? null,
+          cacheCreationTokens: before?.cacheCreationTokens ?? null,
+          costUsd: before?.costUsd ?? null
         };
       });
       return {
@@ -413,6 +485,44 @@ function applyEvent(snapshot, event, options) {
           maxCorrectionCycles: event.maxCycles
         }
       };
+    case "metrics:update": {
+      if (event.scope === "story") {
+        if (event.storyId === void 0) return snapshot;
+        if (!snapshot.stories.some((s) => s.id === event.storyId)) return snapshot;
+        return {
+          ...snapshot,
+          stories: snapshot.stories.map(
+            (story) => story.id === event.storyId ? {
+              ...accumulateUsage(story, event),
+              durationSeconds: accumulate(story.durationSeconds, event.durationSeconds)
+            } : story
+          )
+        };
+      }
+      if (event.phase === void 0) return snapshot;
+      if (!snapshot.phases.some((p) => p.name === event.phase)) return snapshot;
+      return {
+        ...snapshot,
+        // durationSeconds is deliberately untouched here: phase:start and
+        // phase:end remain the single source of a phase's wall-clock time.
+        phases: snapshot.phases.map(
+          (phase) => phase.name === event.phase ? accumulateUsage(phase, event) : phase
+        ),
+        metrics: {
+          totalInputTokens: accumulate(snapshot.metrics.totalInputTokens, event.inputTokens),
+          totalOutputTokens: accumulate(snapshot.metrics.totalOutputTokens, event.outputTokens),
+          totalCacheReadTokens: accumulate(
+            snapshot.metrics.totalCacheReadTokens,
+            event.cacheReadTokens
+          ),
+          totalCacheCreationTokens: accumulate(
+            snapshot.metrics.totalCacheCreationTokens,
+            event.cacheCreationTokens
+          ),
+          totalCostUsd: accumulate(snapshot.metrics.totalCostUsd, event.costUsd)
+        }
+      };
+    }
     case "session:end":
       return {
         ...snapshot,
@@ -599,6 +709,86 @@ async function writeFileAtomic(path, content) {
   }
 }
 
+// src/core/metrics.ts
+var USAGE_FIELDS = [
+  "inputTokens",
+  "outputTokens",
+  "cacheReadTokens",
+  "cacheCreationTokens",
+  "costUsd"
+];
+function num(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function parseUsage(payload) {
+  if (!isRecord(payload)) return null;
+  const usageRaw = isRecord(payload.usage) ? payload.usage : void 0;
+  const usage = {};
+  const inputTokens = usageRaw ? num(usageRaw.input_tokens) : void 0;
+  const outputTokens = usageRaw ? num(usageRaw.output_tokens) : void 0;
+  const cacheReadTokens = usageRaw ? num(usageRaw.cache_read_input_tokens) : void 0;
+  const cacheCreationTokens = usageRaw ? num(usageRaw.cache_creation_input_tokens) : void 0;
+  const costUsd = num(payload.total_cost_usd);
+  const legacyInput = num(payload.num_input_tokens);
+  const legacyOutput = num(payload.num_output_tokens);
+  const legacyCost = num(payload.cost_usd);
+  const resolvedInput = inputTokens ?? legacyInput;
+  const resolvedOutput = outputTokens ?? legacyOutput;
+  const resolvedCost = costUsd ?? legacyCost;
+  if (resolvedInput !== void 0) usage.inputTokens = resolvedInput;
+  if (resolvedOutput !== void 0) usage.outputTokens = resolvedOutput;
+  if (cacheReadTokens !== void 0) usage.cacheReadTokens = cacheReadTokens;
+  if (cacheCreationTokens !== void 0) usage.cacheCreationTokens = cacheCreationTokens;
+  if (resolvedCost !== void 0) usage.costUsd = resolvedCost;
+  return Object.keys(usage).length > 0 ? usage : null;
+}
+function sumUsage(a, b) {
+  const result = {};
+  for (const field of USAGE_FIELDS) {
+    const left = a?.[field];
+    const right = b?.[field];
+    if (left === void 0 && right === void 0) continue;
+    result[field] = (left ?? 0) + (right ?? 0);
+  }
+  return result;
+}
+function divideUsage(usage, parts) {
+  const result = {};
+  if (!usage) return result;
+  const divisor = Number.isFinite(parts) && parts > 1 ? parts : 1;
+  for (const field of USAGE_FIELDS) {
+    const value = usage[field];
+    if (value === void 0) continue;
+    result[field] = field === "costUsd" ? value / divisor : Math.round(value / divisor);
+  }
+  return result;
+}
+function compactTokens(value) {
+  const abs = Math.abs(value);
+  if (abs >= 1e6) return `${(value / 1e6).toFixed(1)}M`;
+  if (abs >= 1e3) return `${(value / 1e3).toFixed(1)}k`;
+  return String(Math.round(value));
+}
+function formatTokens(usage) {
+  if (!usage) return "";
+  const segments = [];
+  const io = [];
+  if (usage.inputTokens !== void 0) io.push(`${compactTokens(usage.inputTokens)} in`);
+  if (usage.outputTokens !== void 0) io.push(`${compactTokens(usage.outputTokens)} out`);
+  if (io.length > 0) segments.push(io.join(" / "));
+  const cache = usage.cacheReadTokens !== void 0 || usage.cacheCreationTokens !== void 0 ? (usage.cacheReadTokens ?? 0) + (usage.cacheCreationTokens ?? 0) : void 0;
+  if (cache !== void 0) segments.push(`${compactTokens(cache)} cache`);
+  if (usage.costUsd !== void 0) segments.push(`~$${usage.costUsd.toFixed(4)}`);
+  return segments.join(" \xB7 ");
+}
+function hasUsageData(usage) {
+  if (!usage) return false;
+  return USAGE_FIELDS.some((field) => usage[field] !== void 0);
+}
+
 // src/core/state-manager.ts
 function isoNow() {
   return (/* @__PURE__ */ new Date()).toISOString().replace(/\.\d{3}Z$/, "Z");
@@ -650,6 +840,21 @@ function allStoriesPass(plan) {
   }
   return plan.userStories.every((story) => story.passes === true);
 }
+function applyStoryMetrics(plan, storyIds, share, durationSeconds) {
+  if (storyIds.length === 0) return plan;
+  const targets = new Set(storyIds);
+  return {
+    ...plan,
+    userStories: plan.userStories.map((story) => {
+      if (!targets.has(story.id)) return story;
+      const updated = { ...story, ...sumUsage(story, share) };
+      if (story.durationSeconds !== void 0 || durationSeconds !== void 0) {
+        updated.durationSeconds = (story.durationSeconds ?? 0) + (durationSeconds ?? 0);
+      }
+      return updated;
+    })
+  };
+}
 function markIssueInProgress(plan, timestamp) {
   const ts = timestamp ?? isoNow();
   return {
@@ -848,6 +1053,7 @@ var ElapsedTimer = class {
     this.onTick = onTick;
     this.startTime = Date.now();
   }
+  onTick;
   startTime;
   intervalId = null;
   cleanup = () => this.stop();
@@ -887,12 +1093,18 @@ export {
   setSessionPublisher,
   getSessionPublisher,
   writeFileAtomic,
+  parseUsage,
+  sumUsage,
+  divideUsage,
+  formatTokens,
+  hasUsageData,
   isoNow,
   loadTaskPlan,
   saveTaskPlan,
   initializeState,
   hasPendingCorrection,
   allStoriesPass,
+  applyStoryMetrics,
   markIssueInProgress,
   markIssueCompleted,
   setLastError,
@@ -919,4 +1131,4 @@ export {
   formatDuration,
   ElapsedTimer
 };
-//# sourceMappingURL=chunk-JNEHVQH5.js.map
+//# sourceMappingURL=chunk-6HGZYTAT.js.map