issue-flow 0.7.7 → 0.9.0

package/dist/{chunk-6UTVPKNF.js → chunk-66ZGYXTH.js}

@@ -1,27 +1,27 @@
 #!/usr/bin/env node
 import {
   runPhaseWithRetry
-} from "./chunk-OPIDR2DC.js";
+} from "./chunk-NB6WKTBL.js";
 import {
   issuePlaceholders,
   resolveCommandIssue
-} from "./chunk-EYVXLRRD.js";
+} from "./chunk-KXAG24DD.js";
 import {
   isTransientFailure
 } from "./chunk-HDV3YDTG.js";
 import {
   runHeadless
-} from "./chunk-KHTLN54U.js";
+} from "./chunk-JGKPSWOA.js";
 import {
   publishPhaseMetrics
-} from "./chunk-ZYBYMEWG.js";
+} from "./chunk-DTNM3LTO.js";
 import {
   applyPlaceholders,
   loadPrompt
 } from "./chunk-SLHZPB3C.js";
 import {
   resolveIssuePaths
-} from "./chunk-RUTDK6ZF.js";
+} from "./chunk-MTJQOOMG.js";
 import {
   getGlobalTimeout,
   isoNow,
@@ -29,7 +29,7 @@ import {
   printError,
   printSuccess,
   saveTaskPlan
-} from "./chunk-WO6ERABE.js";
+} from "./chunk-57MH6RYJ.js";
 
 // src/commands/pr.ts
 import { execa } from "execa";
@@ -47,7 +47,46 @@ function issueClosesLine(issue, fallbackId) {
   }
   return `Closes #${issue.number ?? fallbackId}`;
 }
-async function runPr(issue, resolvedIssue) {
+function issueRef(entry) {
+  return entry.number === null ? entry.id : `#${entry.number}`;
+}
+function issueClosesLines(issues) {
+  return issues.filter((entry) => entry.source === "github" && entry.number !== null).map((entry) => `Closes #${entry.number}`).join("\n");
+}
+function multiIssueContext(queue) {
+  if (queue === void 0 || queue.issues.length <= 1) {
+    return "";
+  }
+  const order = queue.issues.map(
+    (entry, index) => `${index + 1}. ${issueRef(entry)}${entry.title ? ` \u2014 ${entry.title}` : ""}`
+  ).join("\n");
+  const pending = [
+    ...queue.excluded.map(
+      (entry) => `- ${issueRef(entry)}${entry.title ? ` \u2014 ${entry.title}` : ""}: ${entry.reason}`
+    ),
+    ...queue.pending.map((note) => `- ${note}`)
+  ].join("\n");
+  return [
+    "",
+    "This Pull Request consolidates several issues implemented on this same branch,",
+    "in this execution order:",
+    "",
+    order,
+    "",
+    "The PR body MUST additionally contain:",
+    '- an "Issues implemented" section listing every issue above, in that order,',
+    "  with one line per issue describing what it delivered;",
+    '- a "Pending" section with the items below, verbatim, plus anything you find',
+    '  unfinished while reviewing the diff. Write "None" when the list below is',
+    "  empty and you find nothing else;",
+    "",
+    pending === "" ? "(no known pending items)" : pending,
+    "",
+    "The commits of this branch are scoped per issue (`feat(issue-N): \u2026`), which is",
+    "how you tell which change belongs to which issue in `git log`."
+  ].join("\n");
+}
+async function runPr(issue, resolvedIssue, options = {}) {
   const issueNumber = issue.replace(/^#/, "");
   const paths = await resolveIssuePaths(issueNumber);
   const tasksPath = paths.tasksFile;
@@ -67,12 +106,15 @@ async function runPr(issue, resolvedIssue) {
     printError("Failed to get current branch");
     return 1;
   }
+  const queue = options.queue;
+  const consolidating = queue !== void 0 && queue.issues.length > 1;
   const template = await loadPrompt("pr");
   const prompt = applyPlaceholders(template, {
     __ISSUE_NUMBER__: issueNumber,
     __BRANCH_NAME__: branchName,
     __TASKS_PATH__: tasksPath,
-    __ISSUE_CLOSES__: issueClosesLine(resolution.resolved.issue, issueNumber),
+    __ISSUE_CLOSES__: consolidating ? issueClosesLines(queue.issues) : issueClosesLine(resolution.resolved.issue, issueNumber),
+    __MULTI_ISSUE_CONTEXT__: multiIssueContext(queue),
     ...issuePlaceholders(resolution.resolved)
   });
   let headlessOutput = "";
@@ -132,6 +174,8 @@ async function runPr(issue, resolvedIssue) {
 }
 
 export {
+  issueClosesLines,
+  multiIssueContext,
   runPr
 };
-//# sourceMappingURL=chunk-6UTVPKNF.js.map
+//# sourceMappingURL=chunk-66ZGYXTH.js.map

package/dist/chunk-66ZGYXTH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/pr.ts"],"sourcesContent":["import { execa } from 'execa';\nimport { runHeadless } from '../core/headless.js';\nimport { runPhaseWithRetry } from '../core/phase-runner.js';\nimport { applyPlaceholders, loadPrompt } from '../core/prompt-resolver.js';\nimport { publishPhaseMetrics } from '../core/session-metrics.js';\nimport { isoNow, loadTaskPlan, saveTaskPlan } from '../core/state-manager.js';\nimport { getGlobalTimeout } from '../core/verbose.js';\nimport { issuePlaceholders, resolveCommandIssue } from '../issues/context.js';\nimport type { Issue, IssueSource, ResolvedIssue } from '../issues/types.js';\nimport { resolveIssuePaths } from '../storage/resolve.js';\nimport { printError, printSuccess } from '../ui/logger.js';\nimport { isTransientFailure } from '../utils/retry.js';\n\n/**\n * Extract a PR URL from headless output.\n */\nfunction parsePrUrl(output: string): string | null {\n  const match = output.match(/(https:\\/\\/github\\.com\\/[^\\s]+\\/pull\\/\\d+)/);\n  return match?.[1] ?? null;\n}\n\n/**\n * The numeric id inside a PR URL, so later phases (`pr-review`) address the\n * Pull Request without querying GitHub again.\n */\nfunction parsePrNumber(url: string): number | null {\n  const match = url.match(/\\/pull\\/(\\d+)/);\n  return match?.[1] === undefined ? null : Number(match[1]);\n}\n\n/**\n * The `Closes #N` line for the PR body, empty when the Issue has no remote\n * counterpart: GitHub only understands the reference for Issues it hosts, and\n * an invented `#N` would silently point at an unrelated Issue.\n */\nfunction issueClosesLine(issue: Issue, fallbackId: string): string {\n  if (issue.remoteRef === null) {\n    return '';\n  }\n  return `Closes #${issue.number ?? fallbackId}`;\n}\n\n/** One Issue of a queue, as the consolidated Pull Request has to describe it. */\nexport interface PrQueueIssue {\n  id: string;\n  number: number | null;\n  title: string;\n  /** `null` when the Issue was never read — see {@link issueClosesLines}. */\n  url: string | null;\n  /** Origin the Issue came from; `github` is what GitHub can close. */\n  source: IssueSource;\n}\n\n/**\n * What a multi-issue queue hands to the `pr` phase.\n *\n * Absent for every standalone run, and that absence is what guarantees the\n * single-issue Pull Request is byte-for-byte the one this command has always\n * produced: the extra placeholders resolve to empty strings.\n */\nexport interface PrQueueContext {\n  /** Issues of the queue, in the order they were executed. */\n  issues: PrQueueIssue[];\n  /** Issues discovered but not executed, with the reason. */\n  excluded: { id: string; number: number | null; title: string; reason: string }[];\n  /** Anything else worth reporting as pending (unresolved review findings). */\n  pending: string[];\n}\n\nexport interface RunPrOptions {\n  /** Set only when the Pull Request consolidates a queue. */\n  queue?: PrQueueContext;\n}\n\n/** `#51` when the Issue has a number, its raw identifier otherwise. */\nfunction issueRef(entry: { id: string; number: number | null }): string {\n  return entry.number === null ? entry.id : `#${entry.number}`;\n}\n\n/**\n * Every `Closes #N` line of a consolidated Pull Request, one per line.\n *\n * Issues that GitHub does not host are skipped for the same reason a\n * single-issue Pull Request skips them — it cannot close what it does not\n * host — and a queue that mixes both origins still gets a valid body.\n *\n * The test is the origin and the number, not the URL: an Issue whose read\n * failed during discovery reaches the queue with `url: null`, and it is still\n * executed and still closed by the queue. Filtering on the URL would leave it\n * out of the very body that is supposed to reference it.\n */\nexport function issueClosesLines(issues: readonly PrQueueIssue[]): string {\n  return issues\n    .filter((entry) => entry.source === 'github' && entry.number !== null)\n    .map((entry) => `Closes #${entry.number}`)\n    .join('\\n');\n}\n\n/**\n * The extra instructions the prompt receives when the Pull Request covers a\n * whole queue.\n *\n * Returns `''` for a standalone run, which is what keeps `pr.md` rendering\n * exactly as before for the single-issue path — no empty \"Issues implemented\"\n * section, no redundant ordering of a list of one.\n */\nexport function multiIssueContext(queue: PrQueueContext | undefined): string {\n  if (queue === undefined || queue.issues.length <= 1) {\n    return '';\n  }\n\n  const order = queue.issues\n    .map(\n      (entry, index) => `${index + 1}. ${issueRef(entry)}${entry.title ? ` — ${entry.title}` : ''}`,\n    )\n    .join('\\n');\n\n  const pending = [\n    ...queue.excluded.map(\n      (entry) => `- ${issueRef(entry)}${entry.title ? ` — ${entry.title}` : ''}: ${entry.reason}`,\n    ),\n    ...queue.pending.map((note) => `- ${note}`),\n  ].join('\\n');\n\n  return [\n    '',\n    'This Pull Request consolidates several issues implemented on this same branch,',\n    'in this execution order:',\n    '',\n    order,\n    '',\n    'The PR body MUST additionally contain:',\n    '- an \"Issues implemented\" section listing every issue above, in that order,',\n    '  with one line per issue describing what it delivered;',\n    '- a \"Pending\" section with the items below, verbatim, plus anything you find',\n    '  unfinished while reviewing the diff. Write \"None\" when the list below is',\n    '  empty and you find nothing else;',\n    '',\n    pending === '' ? '(no known pending items)' : pending,\n    '',\n    'The commits of this branch are scoped per issue (`feat(issue-N): …`), which is',\n    'how you tell which change belongs to which issue in `git log`.',\n  ].join('\\n');\n}\n\nexport async function runPr(\n  issue: string,\n  resolvedIssue?: ResolvedIssue,\n  options: RunPrOptions = {},\n): 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  // Get current branch\n  let branchName: string;\n  try {\n    const proc = await execa('git', ['branch', '--show-current'], { reject: false });\n    branchName = proc.stdout?.toString().trim() ?? '';\n    if (!branchName) {\n      printError('Could not determine current branch');\n      return 1;\n    }\n  } catch {\n    printError('Failed to get current branch');\n    return 1;\n  }\n\n  const queue = options.queue;\n  const consolidating = queue !== undefined && queue.issues.length > 1;\n\n  const template = await loadPrompt('pr');\n  const prompt = applyPlaceholders(template, {\n    __ISSUE_NUMBER__: issueNumber,\n    __BRANCH_NAME__: branchName,\n    __TASKS_PATH__: tasksPath,\n    __ISSUE_CLOSES__: consolidating\n      ? issueClosesLines(queue.issues)\n      : issueClosesLine(resolution.resolved.issue, issueNumber),\n    __MULTI_ISSUE_CONTEXT__: multiIssueContext(queue),\n    ...issuePlaceholders(resolution.resolved),\n  });\n\n  let headlessOutput = '';\n\n  const outcome = await runPhaseWithRetry({\n    phase: 'pr',\n    attempt: async () => {\n      const startedAtMs = Date.now();\n      const result = await runHeadless({\n        prompt,\n        maxTurns: 15,\n        timeout: getGlobalTimeout() ?? 300_000,\n        // json (not text) so the CLI reports usage: the envelope's `result`\n        // field carries the same assistant text parsePrUrl() already consumed.\n        outputFormat: 'json',\n        allowedTools: ['Bash', 'Read', 'Glob', 'Grep'],\n        addDirs: [paths.issueDir],\n        statusMessage: `Creating PR for issue #${issueNumber}...`,\n      });\n      // One event per attempt; the reducer sums them into the phase total.\n      publishPhaseMetrics('pr', result.cost, startedAtMs);\n\n      if (!result.success) {\n        return {\n          ok: false,\n          transient: isTransientFailure(1, result.error ?? ''),\n          error: `PR creation failed: ${result.error}`,\n        };\n      }\n\n      headlessOutput = result.result;\n      return { ok: true };\n    },\n  });\n\n  if (!outcome.ok) {\n    printError(outcome.error ?? `PR creation failed for issue #${issueNumber}`);\n    return 1;\n  }\n\n  const prUrl = parsePrUrl(headlessOutput);\n\n  // Update pipeline state\n  try {\n    const plan = await loadTaskPlan(tasksPath);\n    plan.pipeline.prCreated = true;\n    const prNumber = prUrl === null ? null : parsePrNumber(prUrl);\n    // Without a URL the PR is still assumed created (the phase succeeded), but\n    // there is nothing trustworthy to record: an invented number would send\n    // `pr-review` at an unrelated Pull Request.\n    if (prUrl !== null && prNumber !== null) {\n      plan.pullRequest = {\n        number: prNumber,\n        url: prUrl,\n        headBranch: branchName,\n        createdAt: isoNow(),\n      };\n    }\n    await saveTaskPlan(tasksPath, plan);\n  } catch {\n    // tasks.json may not exist\n  }\n\n  if (prUrl) {\n    printSuccess(`PR created: ${prUrl}`);\n  } else {\n    printSuccess('PR creation completed');\n  }\n  return 0;\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-WGDLUPSF.js → chunk-DP43WJY4.js}

@@ -6,14 +6,14 @@ import {
 } from "./chunk-HDV3YDTG.js";
 import {
   publishGitState
-} from "./chunk-XPW46TI5.js";
+} from "./chunk-M37YZYDO.js";
 import {
   EXECUTE_PHASE,
   elapsedSecondsSince,
   getPhaseUsageTotals,
   publishIterationMetrics,
   publishStoryMetrics
-} from "./chunk-ZYBYMEWG.js";
+} from "./chunk-DTNM3LTO.js";
 import {
   applyPlaceholders,
   loadPrompt
@@ -22,7 +22,7 @@ import {
   createConfig,
   resolvePaths,
   validateDependencies
-} from "./chunk-RUTDK6ZF.js";
+} from "./chunk-MTJQOOMG.js";
 import {
   allStoriesPass,
   applyStoryMetrics,
@@ -33,6 +33,7 @@ import {
   getIcons,
   getOutputCallback,
   getSessionPublisher,
+  getStoryStageCallback,
   getStoryUpdateCallback,
   getTermWidth,
   hasPendingCorrection,
@@ -49,11 +50,12 @@ import {
   printSuccess,
   printWarning,
   saveTaskPlan,
+  selectActiveStory,
   setLastError,
   trimErrorMessage,
   useColor,
   useUnicode
-} from "./chunk-WO6ERABE.js";
+} from "./chunk-57MH6RYJ.js";
 
 // src/core/engine.ts
 import { existsSync } from "fs";
@@ -80,7 +82,7 @@ function printProgressBar(passed, total) {
   }
   return `${bar} ${text}`;
 }
-function printIterationHeader(iteration, maxIter, stories) {
+function printIterationHeader(iteration, maxIter, stories, activeStoryId) {
   const icons = getIcons();
   const colored = useColor();
   const cb = getOutputCallback();
@@ -97,10 +99,11 @@ function printIterationHeader(iteration, maxIter, stories) {
   for (const story of stories) {
     let icon;
     let colorFn;
+    const isActive = activeStoryId !== void 0 ? story.id === activeStoryId : !story.passes && !foundFirstPending;
     if (story.passes) {
       icon = icons.success;
       colorFn = colored ? chalk.green : (s) => s;
-    } else if (!foundFirstPending) {
+    } else if (isActive) {
       icon = icons.pending;
       colorFn = colored ? chalk.yellow : (s) => s;
       foundFirstPending = true;
@@ -251,6 +254,50 @@ function buildRunSummaryLines(info) {
   }
   return lines;
 }
+function buildQueueSummaryLines(info) {
+  const lines = [];
+  lines.push(`  Branch:   ${info.branchName ?? "current"}`);
+  lines.push(`  Issues:   ${info.issues.length}`);
+  for (const issue of info.issues) {
+    const tokens2 = formatTokens(issue.usage);
+    const title = issue.title === "" ? "" : ` ${issue.title}`;
+    lines.push(
+      `    #${issue.id}${title} \u2014 ${issue.storyCount} stories, ${formatDuration(issue.elapsedSeconds)}` + (tokens2 === "" ? "" : `, ${tokens2}`)
+    );
+  }
+  lines.push(`  Duration: ${formatDuration(info.elapsedSeconds)}`);
+  const tokens = formatTokens(info.usage);
+  if (tokens !== "") {
+    lines.push(`  Tokens:   ${tokens}`);
+  }
+  if (info.prUrl !== null) {
+    lines.push(`  PR:       ${info.prUrl}`);
+  }
+  if (info.excluded.length > 0) {
+    lines.push(`  Skipped:  ${info.excluded.map((entry) => `#${entry.id}`).join(", ")}`);
+  }
+  const review = info.prReview;
+  if (review) {
+    lines.push(
+      `  Review:   ${review.recommendation ?? (review.requestedChanges ? "REQUEST_CHANGES" : "unknown")}`
+    );
+    if (review.reportPath !== null) {
+      lines.push(`  Report:   ${review.reportPath}`);
+    }
+  }
+  return lines;
+}
+function printQueueSummary(info) {
+  console.log("");
+  if (info.prReview?.requestedChanges === true) {
+    printWarning(`Queue finished for issue #${info.queueId}, but the PR review requested changes.`);
+  } else {
+    printSuccess(`Queue complete for issue #${info.queueId} (${info.issues.length} issues)!`);
+  }
+  for (const line of buildQueueSummaryLines(info)) {
+    console.log(line);
+  }
+}
 function printRunSummary(info) {
   console.log("");
   if (info.prReview?.requestedChanges) {
@@ -323,6 +370,13 @@ function newlyCompletedStoryIds(before, after) {
   const wasPassing = new Map(before.map((story) => [story.id, story.passes]));
   return after.filter((story) => story.passes && wasPassing.get(story.id) === false).map((story) => story.id);
 }
+function commitPlaceholders(scope) {
+  const suffix = scope === void 0 || scope === "" ? "" : `(${scope})`;
+  return {
+    __COMMIT_MESSAGE__: `feat${suffix}: [Story ID] - [Story Title]`,
+    __FIX_COMMIT_MESSAGE__: `fix${suffix}: address review findings`
+  };
+}
 async function ensureProgressFile(progressFile) {
   if (!existsSync(progressFile)) {
     const content = `# Issue Flow Progress Log
@@ -421,15 +475,23 @@ async function runEngine(config, paths) {
       break;
     }
     i++;
-    getSessionPublisher().publish({ type: "iteration:start", at: isoNow(), iteration: i });
     plan = await loadTaskPlan(paths.prdFile);
     const storiesBeforeIteration = plan.userStories;
+    const activeStoryId = selectActiveStory(plan.userStories)?.id;
+    getSessionPublisher().publish({
+      type: "iteration:start",
+      at: isoNow(),
+      iteration: i,
+      storyId: activeStoryId
+    });
+    getStoryStageCallback()?.(activeStoryId);
     if (isVerbose()) {
-      printIterationHeader(i, config.maxIterations, plan.userStories);
+      printIterationHeader(i, config.maxIterations, plan.userStories, activeStoryId);
     }
     const prompt = applyPlaceholders(promptTemplate, {
       __PRD_FILE__: paths.prdFile,
-      __PROGRESS_FILE__: paths.progressFile
+      __PROGRESS_FILE__: paths.progressFile,
+      ...commitPlaceholders(config.commitScope)
     });
     const iterationStartedAt = isoNow();
     plan = markIssueInProgress(plan, iterationStartedAt);
@@ -589,7 +651,8 @@ async function runExecute(positionalMaxIter, options) {
     issueNumber: options.issue,
     maxIterations,
     retryLimit: options.retryLimit,
-    retryForever: options.retryForever
+    retryForever: options.retryForever,
+    commitScope: options.commitScope
   });
   const paths = await resolvePaths(config);
   const exitCode = await runEngine(config, paths);
@@ -607,7 +670,8 @@ async function runExecute(positionalMaxIter, options) {
 }
 
 export {
+  printQueueSummary,
   printRunSummary,
   runExecute
 };
-//# sourceMappingURL=chunk-WGDLUPSF.js.map
+//# sourceMappingURL=chunk-DP43WJY4.js.map

package/dist/chunk-DP43WJY4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/engine.ts","../src/ui/progress.ts","../src/ui/summary.ts","../src/core/executor.ts","../src/commands/execute.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { cp, mkdir, readFile, writeFile } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport type { EngineConfig, ResolvedPaths, TaskPlan, UserStory } from '../types.js';\nimport { printError, printInfo, printRetry, printSuccess, printWarning } from '../ui/logger.js';\nimport { printIterationHeader } from '../ui/progress.js';\nimport { printStartupHeader, printSummaryBox } from '../ui/summary.js';\nimport { isTransientFailure, retryDelaySeconds, sleep } from '../utils/retry.js';\nimport { executeClaude } from './executor.js';\nimport { divideUsage } from './metrics.js';\nimport { applyPlaceholders, loadPrompt } from './prompt-resolver.js';\nimport { publishGitState } from './session-git.js';\nimport {\n  EXECUTE_PHASE,\n  elapsedSecondsSince,\n  getPhaseUsageTotals,\n  publishIterationMetrics,\n  publishStoryMetrics,\n} from './session-metrics.js';\nimport { getSessionPublisher } from './session-publisher.js';\nimport {\n  allStoriesPass,\n  applyStoryMetrics,\n  clearLastError,\n  hasPendingCorrection,\n  initializeState,\n  isoNow,\n  loadTaskPlan,\n  markIssueCompleted,\n  markIssueInProgress,\n  saveTaskPlan,\n  selectActiveStory,\n  setLastError,\n  trimErrorMessage,\n} from './state-manager.js';\nimport {\n  getOutputCallback,\n  getStoryStageCallback,\n  getStoryUpdateCallback,\n  isVerbose,\n} from './verbose.js';\n\n/**\n * Emit a message through the output callback if available, otherwise console.log.\n * Used for bare console.log calls in engine functions so they route through listr2.\n */\nfunction emitLog(message: string): void {\n  const cb = getOutputCallback();\n  if (cb) {\n    // Skip empty lines in listr2 context — they don't render meaningfully\n    if (message) {\n      cb(message);\n    }\n  } else {\n    console.log(message);\n  }\n}\n\n/**\n * Ids of the stories that flipped from `passes: false` to `passes: true`\n * between the two readings of the plan taken around one execute iteration.\n *\n * Stories already passing before the iteration, and stories that only exist in\n * the newer plan, are never attributed: nothing says this iteration paid for\n * them.\n */\nfunction newlyCompletedStoryIds(before: UserStory[], after: UserStory[]): string[] {\n  const wasPassing = new Map(before.map((story) => [story.id, story.passes]));\n  return after\n    .filter((story) => story.passes && wasPassing.get(story.id) === false)\n    .map((story) => story.id);\n}\n\n/**\n * Commit message formats handed to the execute prompt.\n *\n * Without a scope they are byte-for-byte what the prompt has always spelled\n * out, so a single-issue run produces the same history it always did. With one\n * — the only case being several issues sharing a branch — the issue becomes a\n * conventional-commit scope, which is what makes `git log` on the shared branch\n * readable per issue.\n */\nexport function commitPlaceholders(scope?: string): Record<string, string> {\n  const suffix = scope === undefined || scope === '' ? '' : `(${scope})`;\n  return {\n    __COMMIT_MESSAGE__: `feat${suffix}: [Story ID] - [Story Title]`,\n    __FIX_COMMIT_MESSAGE__: `fix${suffix}: address review findings`,\n  };\n}\n\n/**\n * Initialize the progress file if it doesn't exist.\n */\nasync function ensureProgressFile(progressFile: string): Promise<void> {\n  if (!existsSync(progressFile)) {\n    const content = `# Issue Flow Progress Log\\nStarted: ${new Date().toString()}\\n---\\n`;\n    await writeFile(progressFile, content, 'utf-8');\n  }\n}\n\n/**\n * Archive previous run artifacts if the branch has changed.\n */\nasync function archiveIfBranchChanged(plan: TaskPlan, paths: ResolvedPaths): Promise<void> {\n  const { lastBranchFile, archiveDir, prdFile, progressFile } = paths;\n\n  if (!existsSync(lastBranchFile)) {\n    return;\n  }\n\n  const currentBranch = plan.branchName ?? '';\n  let lastBranch = '';\n\n  try {\n    lastBranch = (await readFile(lastBranchFile, 'utf-8')).trim();\n  } catch {\n    return;\n  }\n\n  if (currentBranch && lastBranch && currentBranch !== lastBranch) {\n    const dateStr = new Date().toISOString().split('T')[0];\n    const folderName = lastBranch.replace(/^issue\\//, '').replace(/[<>:\"|?*\\\\]/g, '_');\n    const archiveFolder = join(archiveDir, `${dateStr}-${folderName}`);\n\n    printInfo(`Archiving previous run: ${lastBranch}`);\n    await mkdir(archiveFolder, { recursive: true });\n\n    if (existsSync(prdFile)) {\n      await cp(prdFile, join(archiveFolder, 'tasks.json'));\n    }\n    if (existsSync(progressFile)) {\n      await cp(progressFile, join(archiveFolder, 'progress.txt'));\n    }\n\n    printInfo(`   Archived to: ${archiveFolder}`);\n\n    // Reset progress file for new run\n    await writeFile(\n      progressFile,\n      `# Issue Flow Progress Log\\nStarted: ${new Date().toString()}\\n---\\n`,\n      'utf-8',\n    );\n  }\n}\n\n/**\n * Write the current branch to the last-branch tracking file.\n */\nasync function trackBranch(plan: TaskPlan, lastBranchFile: string): Promise<void> {\n  const branch = plan.branchName ?? '';\n  if (branch) {\n    await writeFile(lastBranchFile, `${branch}\\n`, 'utf-8');\n  }\n}\n\n/**\n * Run the issue-flow engine loop.\n *\n * This replicates the full execution flow:\n * 1. Load and initialize task plan state\n * 2. Check for early exit (already complete)\n * 3. Archive previous run if branch changed\n * 4. Resolve prompt\n * 5. Main loop: iterate, execute Claude, handle results\n * 6. Print summary\n */\nexport async function runEngine(config: EngineConfig, paths: ResolvedPaths): Promise<number> {\n  // Load task plan\n  if (!existsSync(paths.prdFile)) {\n    printError(`PRD file not found at ${paths.prdFile}`);\n    if (config.issueNumber) {\n      emitLog(`Have you run the resolve-issue skill for issue #${config.issueNumber} first?`);\n    }\n    return 1;\n  }\n\n  let plan = await loadTaskPlan(paths.prdFile);\n  plan = initializeState(plan);\n  await saveTaskPlan(paths.prdFile, plan);\n\n  // Check if already completed. A pending correction (a failed review whose\n  // findings haven't been addressed yet) always overrides this, even though\n  // every userStories[].passes is already true — otherwise a correction\n  // cycle's re-run of execute would exit here without ever looking at what\n  // the review found.\n  if (plan.issueStatus === 'completed' && allStoriesPass(plan) && !hasPendingCorrection(plan)) {\n    emitLog(`Issue already marked complete in ${paths.prdFile}`);\n    return 0;\n  }\n\n  // Warn if marked complete but stories still pending\n  if (plan.issueStatus === 'completed' && !allStoriesPass(plan)) {\n    printWarning(\n      'Issue marked completed but some stories are still pending. Resetting to in_progress.',\n    );\n    plan = markIssueInProgress(plan);\n    plan = setLastError(\n      plan,\n      'invalid_completion_state',\n      'tasks.json claimed the issue was completed before every story had passes=true.',\n    );\n    await saveTaskPlan(paths.prdFile, plan);\n  }\n\n  // Check if all stories already pass\n  if (allStoriesPass(plan) && !hasPendingCorrection(plan)) {\n    emitLog('All user stories already pass. Marking issue as completed.');\n    plan = markIssueCompleted(plan);\n    await saveTaskPlan(paths.prdFile, plan);\n    return 0;\n  }\n\n  // Archive previous run if branch changed\n  await archiveIfBranchChanged(plan, paths);\n\n  // Track current branch\n  await trackBranch(plan, paths.lastBranchFile);\n\n  // Initialize progress file\n  await ensureProgressFile(paths.progressFile);\n\n  // Load prompt template\n  const promptTemplate = await loadPrompt('execute');\n\n  // Print startup header\n  printStartupHeader(config, plan);\n\n  const startTime = Date.now();\n  let i = 0;\n  let retryCount = 0;\n  let totalRetryCount = 0;\n\n  // Main loop\n  while (true) {\n    // Check iteration limit\n    if (config.maxIterations !== undefined && i >= config.maxIterations) {\n      break;\n    }\n\n    i++;\n\n    // Re-read plan to get latest state\n    plan = await loadTaskPlan(paths.prdFile);\n    // Baseline for story attribution: whatever was still pending before the\n    // agent ran is what this iteration can claim credit for.\n    const storiesBeforeIteration = plan.userStories;\n\n    // Highest-priority story with passes: false — the same rule\n    // prompts/execute.md gives the agent. Computed once, here, and shared by\n    // the published event and the verbose terminal header, so every surface\n    // agrees on who is active instead of each deriving its own heuristic.\n    const activeStoryId = selectActiveStory(plan.userStories)?.id;\n    getSessionPublisher().publish({\n      type: 'iteration:start',\n      at: isoNow(),\n      iteration: i,\n      storyId: activeStoryId,\n    });\n    getStoryStageCallback()?.(activeStoryId);\n\n    if (isVerbose()) {\n      printIterationHeader(i, config.maxIterations, plan.userStories, activeStoryId);\n    }\n\n    // Apply placeholders to prompt\n    const prompt = applyPlaceholders(promptTemplate, {\n      __PRD_FILE__: paths.prdFile,\n      __PROGRESS_FILE__: paths.progressFile,\n      ...commitPlaceholders(config.commitScope),\n    });\n\n    const iterationStartedAt = isoNow();\n    plan = markIssueInProgress(plan, iterationStartedAt);\n    await saveTaskPlan(paths.prdFile, plan);\n\n    // Execute Claude\n    const iterationStartedAtMs = Date.now();\n    const result = await executeClaude(prompt);\n    const iterationSeconds = elapsedSecondsSince(iterationStartedAtMs);\n\n    if (result.exitCode !== 0) {\n      // A failed iteration still burned tokens: report them on the execute\n      // phase, with no attribution to any story.\n      publishIterationMetrics(i, result.cost, iterationSeconds);\n\n      const errorMessage = trimErrorMessage(result.output);\n\n      if (isTransientFailure(result.exitCode, result.output)) {\n        retryCount++;\n        totalRetryCount++;\n        plan = await loadTaskPlan(paths.prdFile);\n        plan = setLastError(plan, 'transient_claude_failure', errorMessage);\n        await saveTaskPlan(paths.prdFile, plan);\n\n        if (!config.retryForever && retryCount > config.retryLimit) {\n          const elapsed = Math.floor((Date.now() - startTime) / 1000);\n          plan = await loadTaskPlan(paths.prdFile);\n          printSummaryBox(\n            'failed',\n            i,\n            totalRetryCount,\n            elapsed,\n            plan,\n            `Exceeded retry limit (${config.retryLimit}) on transient errors`,\n            getPhaseUsageTotals(EXECUTE_PHASE),\n          );\n          return result.exitCode;\n        }\n\n        const delaySeconds = retryDelaySeconds(\n          retryCount,\n          config.backoffBaseSeconds,\n          config.backoffMaxSeconds,\n        );\n        getSessionPublisher().publish({\n          type: 'retry',\n          at: isoNow(),\n          attempt: retryCount,\n          delaySeconds,\n          reason: 'transient_claude_failure',\n        });\n\n        if (isVerbose()) {\n          emitLog('');\n        }\n        printRetry(\n          `Transient Claude failure on iteration ${i} (attempt ${retryCount}). Retrying in ${delaySeconds}s.`,\n        );\n\n        // Stay within current iteration budget\n        i--;\n        await sleep(delaySeconds);\n        continue;\n      }\n\n      // Fatal failure\n      plan = await loadTaskPlan(paths.prdFile);\n      plan = setLastError(plan, 'fatal_claude_failure', errorMessage);\n      await saveTaskPlan(paths.prdFile, plan);\n\n      const elapsed = Math.floor((Date.now() - startTime) / 1000);\n      printSummaryBox(\n        'failed',\n        i,\n        totalRetryCount,\n        elapsed,\n        plan,\n        `Claude CLI failed with exit code ${result.exitCode}`,\n        getPhaseUsageTotals(EXECUTE_PHASE),\n      );\n      return result.exitCode;\n    }\n\n    // Success — reset retry counter\n    retryCount = 0;\n    plan = await loadTaskPlan(paths.prdFile);\n    plan = clearLastError(plan, iterationStartedAt);\n    await saveTaskPlan(paths.prdFile, plan);\n\n    // Notify story progress listeners (e.g., listr2 subtasks)\n    const storyUpdateCb = getStoryUpdateCallback();\n    if (storyUpdateCb) {\n      storyUpdateCb(plan.userStories);\n    }\n    getSessionPublisher().publish({\n      type: 'stories:update',\n      at: isoNow(),\n      stories: plan.userStories,\n    });\n\n    // Story attribution — an approximation by construction: the CLI reports a\n    // single usage for the whole iteration, so the stories that flipped to\n    // passing in it split tokens, cost and duration evenly. With none, nothing\n    // is attributed and the whole cost stays on the execute phase. Published\n    // after stories:update, which rebuilds the stories array.\n    const completedStoryIds = newlyCompletedStoryIds(storiesBeforeIteration, plan.userStories);\n    if (completedStoryIds.length > 0) {\n      const storyShare = divideUsage(result.cost, completedStoryIds.length);\n      const storySeconds = Math.round(iterationSeconds / completedStoryIds.length);\n      for (const storyId of completedStoryIds) {\n        publishStoryMetrics(storyId, storyShare, storySeconds);\n      }\n\n      // The same shares also land on tasks.json, so the numbers outlive the\n      // session and are readable with web monitoring off. Persisting them is\n      // observational: a write failure must never change the iteration's\n      // outcome, so the plan in memory only advances when the write succeeded.\n      const planWithMetrics = applyStoryMetrics(plan, completedStoryIds, storyShare, storySeconds);\n      try {\n        await saveTaskPlan(paths.prdFile, planWithMetrics);\n        plan = planWithMetrics;\n      } catch {\n        // Metrics are a nice-to-have; the iteration succeeded regardless.\n      }\n    }\n\n    getSessionPublisher().publish({ type: 'iteration:end', at: isoNow(), iteration: i });\n    publishIterationMetrics(i, result.cost, iterationSeconds);\n    // Low-frequency commit/PR enrichment: iteration end is one of the only\n    // two sanctioned points (the other is phase boundaries in run.ts).\n    await publishGitState(getSessionPublisher());\n\n    // Check for completion signal\n    if (result.output.includes('<promise>COMPLETE</promise>')) {\n      plan = await loadTaskPlan(paths.prdFile);\n      if (allStoriesPass(plan) && !hasPendingCorrection(plan)) {\n        plan = markIssueCompleted(plan);\n        await saveTaskPlan(paths.prdFile, plan);\n\n        const elapsed = Math.floor((Date.now() - startTime) / 1000);\n        printSummaryBox(\n          'success',\n          i,\n          totalRetryCount,\n          elapsed,\n          plan,\n          undefined,\n          getPhaseUsageTotals(EXECUTE_PHASE),\n        );\n        return 0;\n      }\n\n      plan = setLastError(\n        plan,\n        'invalid_completion_signal',\n        hasPendingCorrection(plan)\n          ? 'Claude returned <promise>COMPLETE</promise> while lastReviewFindings was still set.'\n          : 'Claude returned <promise>COMPLETE</promise> before every story had passes=true.',\n      );\n      await saveTaskPlan(paths.prdFile, plan);\n\n      emitLog('');\n      printWarning(\n        hasPendingCorrection(plan)\n          ? 'Claude returned a completion signal, but lastReviewFindings is still set. Ignoring completion and continuing.'\n          : 'Claude returned a completion signal, but tasks.json still has pending stories. Ignoring completion and continuing.',\n      );\n    }\n\n    if (isVerbose()) {\n      printSuccess(`Iteration ${i} complete. Continuing...`);\n    }\n    await sleep(2);\n  }\n\n  // Reached max iterations\n  const elapsed = Math.floor((Date.now() - startTime) / 1000);\n  plan = await loadTaskPlan(paths.prdFile);\n  printSummaryBox(\n    'incomplete',\n    config.maxIterations ?? i,\n    totalRetryCount,\n    elapsed,\n    plan,\n    'Reached max iterations without completing all tasks.',\n    getPhaseUsageTotals(EXECUTE_PHASE),\n  );\n  return 1;\n}\n","import chalk from 'chalk';\nimport { getOutputCallback } from '../core/verbose.js';\nimport type { UserStory } from '../types.js';\nimport { getIcons, useColor, useUnicode } from './logger.js';\n\n/**\n * Print a visual progress bar showing passed/total stories.\n */\nexport function printProgressBar(passed: number, total: number): string {\n  const barWidth = 20;\n  let pct = 0;\n  let filled = 0;\n\n  if (total > 0) {\n    pct = Math.floor((passed * 100) / total);\n    filled = Math.floor((passed * barWidth) / total);\n  }\n\n  const empty = barWidth - filled;\n  const fillChar = useUnicode() ? '\\u2588' : '#';\n  const emptyChar = useUnicode() ? '\\u2591' : '-';\n\n  const bar = fillChar.repeat(filled) + emptyChar.repeat(empty);\n  const text = `${passed}/${total} (${pct}%)`;\n\n  if (useColor()) {\n    return `${chalk.green(bar)} ${text}`;\n  }\n  return `${bar} ${text}`;\n}\n\n/**\n * Print the iteration header showing story statuses and progress bar.\n *\n * When a global output callback is set (e.g., inside a listr2 task),\n * output is routed through it instead of console.log.\n *\n * `activeStoryId`, when provided, identifies the story the engine is\n * actually about to work on this iteration (the same id published on\n * `iteration:start` \\u2014 see `core/state-manager.ts`'s `selectActiveStory`),\n * so the header agrees with the session snapshot instead of guessing.\n * Omitted, it falls back to the previous heuristic (\"first non-passing story\n * in array order\"), which existing callers that cannot supply the real id\n * keep relying on.\n */\nexport function printIterationHeader(\n  iteration: number,\n  maxIter: number | undefined,\n  stories: UserStory[],\n  activeStoryId?: string,\n): void {\n  const icons = getIcons();\n  const colored = useColor();\n  const cb = getOutputCallback();\n\n  const iterLabel = maxIter ? `Iteration ${iteration} of ${maxIter}` : `Iteration ${iteration}`;\n\n  const total = stories.length;\n  const passed = stories.filter((s) => s.passes).length;\n\n  const lines: string[] = [];\n\n  if (colored) {\n    lines.push(chalk.blue(`\\u2501\\u2501\\u2501 ${icons.start} ${iterLabel} \\u2501\\u2501\\u2501`));\n  } else {\n    lines.push(`--- ${icons.start} ${iterLabel} ---`);\n  }\n\n  // Display each story status\n  let foundFirstPending = false;\n  for (const story of stories) {\n    let icon: string;\n    let colorFn: (s: string) => string;\n    const isActive =\n      activeStoryId !== undefined\n        ? story.id === activeStoryId\n        : !story.passes && !foundFirstPending;\n\n    if (story.passes) {\n      icon = icons.success;\n      colorFn = colored ? chalk.green : (s: string) => s;\n    } else if (isActive) {\n      icon = icons.pending;\n      colorFn = colored ? chalk.yellow : (s: string) => s;\n      foundFirstPending = true;\n    } else {\n      // Not yet reached\n      icon = icons.notReached;\n      colorFn = colored ? chalk.gray : (s: string) => s;\n    }\n\n    lines.push(colorFn(`  ${icon} ${story.id}: ${story.title}`));\n  }\n\n  lines.push(`  ${printProgressBar(passed, total)}`);\n\n  if (cb) {\n    // Send as single output to listr2 task context\n    cb(lines.join('\\n'));\n  } else {\n    console.log('');\n    for (const line of lines) {\n      console.log(line);\n    }\n    console.log('');\n  }\n}\n","import chalk from 'chalk';\nimport { type ClaudeUsage, formatTokens } from '../core/metrics.js';\nimport type { EngineConfig, PrReviewRecommendation, TaskPlan } from '../types.js';\nimport {\n  formatDuration,\n  getIcons,\n  getTermWidth,\n  printSuccess,\n  printWarning,\n  useColor,\n  useUnicode,\n} from './logger.js';\n\n/**\n * Truncate or pad a string to fit within a given width.\n */\nfunction fitLine(text: string, width: number): string {\n  if (text.length > width) {\n    return text.substring(0, width);\n  }\n  return text.padEnd(width);\n}\n\n/**\n * Print a box with border characters around content lines.\n * Lines equal to \"---\" render as separator rows.\n */\nexport function printBox(lines: string[]): void {\n  const colored = useColor();\n  const unicode = useUnicode();\n  const termWidth = getTermWidth();\n\n  // Find max content width\n  let maxContentWidth = 0;\n  for (const line of lines) {\n    if (line !== '---' && line.length > maxContentWidth) {\n      maxContentWidth = line.length;\n    }\n  }\n\n  // Cap to terminal width (border + padding = 4 chars)\n  const available = termWidth - 4;\n  if (maxContentWidth > available) {\n    maxContentWidth = available;\n  }\n  if (maxContentWidth < 20) {\n    maxContentWidth = 20;\n  }\n\n  // Box drawing characters\n  const tl = unicode ? '\\u256D' : '+';\n  const tr = unicode ? '\\u256E' : '+';\n  const bl = unicode ? '\\u2570' : '+';\n  const br = unicode ? '\\u256F' : '+';\n  const h = unicode ? '\\u2500' : '-';\n  const v = unicode ? '\\u2502' : '|';\n  const sepL = unicode ? '\\u251C' : '+';\n  const sepR = unicode ? '\\u2524' : '+';\n\n  const hrule = h.repeat(maxContentWidth + 2);\n\n  const blue = colored ? chalk.blue : (s: string) => s;\n  const _reset = (s: string) => s;\n\n  // Top border\n  console.log(blue(`${tl}${hrule}${tr}`));\n\n  // Content lines\n  for (const line of lines) {\n    if (line === '---') {\n      console.log(blue(`${sepL}${hrule}${sepR}`));\n    } else {\n      const fitted = fitLine(line, maxContentWidth);\n      console.log(`${blue(v)} ${fitted} ${blue(v)}`);\n    }\n  }\n\n  // Bottom border\n  console.log(blue(`${bl}${hrule}${br}`));\n}\n\n/**\n * Print the startup header box showing engine configuration.\n */\nexport function printStartupHeader(config: EngineConfig, plan: TaskPlan): void {\n  const icons = getIcons();\n\n  const storiesTotal = plan.userStories.length;\n  const storiesPassing = plan.userStories.filter((s) => s.passes).length;\n  const branchName = plan.branchName ?? 'N/A';\n\n  const issueLabel = config.issueNumber ? `Issue #${config.issueNumber}` : 'Standalone mode';\n\n  const maxIterLabel =\n    config.maxIterations !== undefined ? String(config.maxIterations) : 'unlimited';\n\n  const retryLabel = config.retryForever\n    ? 'unlimited retries'\n    : `${config.retryLimit} consecutive retries`;\n\n  printBox([\n    `${icons.start} Issue Flow`,\n    '---',\n    `Issue:       ${issueLabel}`,\n    `Branch:      ${branchName}`,\n    `Stories:     ${storiesPassing}/${storiesTotal} passing`,\n    `Iterations:  ${maxIterLabel}`,\n    `Retries:     ${retryLabel}`,\n  ]);\n}\n\n// Re-export formatDuration from logger to maintain backwards compatibility\nexport { formatDuration } from './logger.js';\n\n/**\n * Print the final summary box.\n */\nexport function printSummaryBox(\n  status: 'success' | 'incomplete' | 'failed',\n  iterations: number,\n  totalRetries: number,\n  elapsedSeconds: number,\n  plan: TaskPlan,\n  extraInfo?: string,\n  /**\n   * Tokens and cost spent by this run, already resolved by the caller (the\n   * process-owned counters in `core/session-metrics.ts`, never the session\n   * snapshot — that one is empty whenever web monitoring is off). Omitted or\n   * empty means \"the CLI reported nothing\", and the line is skipped entirely.\n   */\n  usage?: ClaudeUsage | null,\n): void {\n  const icons = getIcons();\n\n  const storiesTotal = plan.userStories.length;\n  const storiesPassing = plan.userStories.filter((s) => s.passes).length;\n  const duration = formatDuration(elapsedSeconds);\n\n  let statusIcon: string;\n  let statusLabel: string;\n\n  switch (status) {\n    case 'success':\n      statusIcon = icons.success;\n      statusLabel = 'Completed';\n      break;\n    case 'incomplete':\n      statusIcon = icons.warn;\n      statusLabel = 'Incomplete';\n      break;\n    case 'failed':\n      statusIcon = icons.fail;\n      statusLabel = 'Failed';\n      break;\n  }\n\n  const boxLines = [\n    `${icons.end} Issue Flow Summary`,\n    '---',\n    `Status:      ${statusIcon} ${statusLabel}`,\n    `Stories:     ${storiesPassing}/${storiesTotal} passing`,\n    `Iterations:  ${iterations}`,\n    `Duration:    ${duration}`,\n  ];\n\n  const tokens = formatTokens(usage);\n  if (tokens !== '') {\n    boxLines.push(`Tokens:      ${tokens}`);\n  }\n\n  boxLines.push(`Retries:     ${totalRetries}`);\n\n  if (extraInfo) {\n    boxLines.push('---');\n    boxLines.push(extraInfo);\n  }\n\n  console.log('');\n  printBox(boxLines);\n}\n\n/**\n * What the optional `pr-review` phase produced, as far as the summary cares.\n * `null` in `recommendation` means the verdict could not be recovered from\n * disk — the exit code still told us whether changes were requested.\n */\nexport interface RunSummaryPrReview {\n  requestedChanges: boolean;\n  recommendation: PrReviewRecommendation | null;\n  reportPath: string | null;\n}\n\n/**\n * Everything the final `run` summary prints, already resolved by the caller.\n */\nexport interface RunSummaryInfo {\n  issueNumber: string;\n  /** 'unknown' when the branch could not be detected. */\n  branchName: string;\n  /** Pipelines run with --no-branch open no Pull Request. */\n  noBranch: boolean;\n  storyCount: number;\n  elapsedSeconds: number;\n  /** 'unknown' when no Pull Request could be resolved. */\n  prUrl: string;\n  /** Only set when the pr-review phase actually ran. */\n  prReview?: RunSummaryPrReview | null;\n  /**\n   * Tokens and cost of the whole pipeline, from the process-owned counters in\n   * `core/session-metrics.ts`. Absent or empty omits the line.\n   */\n  usage?: ClaudeUsage | null;\n}\n\n/**\n * Detail lines of the final `run` summary (everything below the headline).\n *\n * Kept separate from the printing so the shape is testable without capturing\n * stdout. Without `prReview` the lines are exactly the ones the pipeline has\n * always printed.\n */\nexport function buildRunSummaryLines(info: RunSummaryInfo): string[] {\n  const lines = [\n    `  Branch:   ${info.branchName}${info.noBranch ? ' (current)' : ''}`,\n    `  Stories:  ${info.storyCount}`,\n    `  Duration: ${formatDuration(info.elapsedSeconds)}`,\n  ];\n\n  // Skipped altogether when the CLI reported nothing — better no line than\n  // \"0 in / 0 out\" or \"~$NaN\".\n  const tokens = formatTokens(info.usage);\n  if (tokens !== '') {\n    lines.push(`  Tokens:   ${tokens}`);\n  }\n\n  if (!info.noBranch) {\n    lines.push(`  PR:       ${info.prUrl}`);\n  }\n\n  const review = info.prReview;\n  if (review) {\n    // The exit code is the source of truth for the verdict, so a report whose\n    // recommendation could not be read still reports REQUEST_CHANGES.\n    const verdict =\n      review.recommendation ?? (review.requestedChanges ? 'REQUEST_CHANGES' : 'unknown');\n    lines.push(`  Review:   ${verdict}`);\n    if (review.reportPath !== null) {\n      lines.push(`  Report:   ${review.reportPath}`);\n    }\n  }\n\n  return lines;\n}\n\n/** One issue of a multi-issue queue, as the consolidated summary reports it. */\nexport interface QueueIssueSummary {\n  id: string;\n  title: string;\n  storyCount: number;\n  elapsedSeconds: number;\n  /** Tokens and cost of this issue alone — never of the whole queue. */\n  usage?: ClaudeUsage | null;\n}\n\n/** Everything the consolidated summary of a queue prints. */\nexport interface QueueSummaryInfo {\n  /** Identifier of the queue, i.e. of its primary issue. */\n  queueId: string;\n  /** Branch every issue shared, `null` when the queue ran with --no-branch. */\n  branchName: string | null;\n  issues: QueueIssueSummary[];\n  /** Issues discovered but left out of the run. */\n  excluded: { id: string; title: string }[];\n  elapsedSeconds: number;\n  /** The single consolidated Pull Request, `null` when none was opened. */\n  prUrl: string | null;\n  /** Tokens and cost of the whole queue. */\n  usage?: ClaudeUsage | null;\n  /** Verdict of the pr-review phase, when the queue ran it. */\n  prReview?: RunSummaryPrReview | null;\n}\n\n/**\n * Detail lines of a queue's final summary.\n *\n * Per-issue lines carry their own duration and cost, which is the visible half\n * of the per-issue metric scoping: what one issue spent is never folded into\n * another's line.\n */\nexport function buildQueueSummaryLines(info: QueueSummaryInfo): string[] {\n  const lines: string[] = [];\n\n  lines.push(`  Branch:   ${info.branchName ?? 'current'}`);\n  lines.push(`  Issues:   ${info.issues.length}`);\n\n  for (const issue of info.issues) {\n    const tokens = formatTokens(issue.usage);\n    const title = issue.title === '' ? '' : ` ${issue.title}`;\n    lines.push(\n      `    #${issue.id}${title} — ${issue.storyCount} stories, ${formatDuration(issue.elapsedSeconds)}` +\n        (tokens === '' ? '' : `, ${tokens}`),\n    );\n  }\n\n  lines.push(`  Duration: ${formatDuration(info.elapsedSeconds)}`);\n\n  const tokens = formatTokens(info.usage);\n  if (tokens !== '') {\n    lines.push(`  Tokens:   ${tokens}`);\n  }\n  if (info.prUrl !== null) {\n    lines.push(`  PR:       ${info.prUrl}`);\n  }\n  if (info.excluded.length > 0) {\n    lines.push(`  Skipped:  ${info.excluded.map((entry) => `#${entry.id}`).join(', ')}`);\n  }\n\n  const review = info.prReview;\n  if (review) {\n    lines.push(\n      `  Review:   ${review.recommendation ?? (review.requestedChanges ? 'REQUEST_CHANGES' : 'unknown')}`,\n    );\n    if (review.reportPath !== null) {\n      lines.push(`  Report:   ${review.reportPath}`);\n    }\n  }\n\n  return lines;\n}\n\n/** Print the consolidated summary of a multi-issue queue. */\nexport function printQueueSummary(info: QueueSummaryInfo): void {\n  console.log('');\n  if (info.prReview?.requestedChanges === true) {\n    printWarning(`Queue finished for issue #${info.queueId}, but the PR review requested changes.`);\n  } else {\n    printSuccess(`Queue complete for issue #${info.queueId} (${info.issues.length} issues)!`);\n  }\n  for (const line of buildQueueSummaryLines(info)) {\n    console.log(line);\n  }\n}\n\n/**\n * Print the final summary of a `run` (the flat listing, not the box used by\n * the execute engine).\n */\nexport function printRunSummary(info: RunSummaryInfo): void {\n  console.log('');\n  if (info.prReview?.requestedChanges) {\n    printWarning(\n      `Pipeline finished for issue #${info.issueNumber}, but the PR review requested changes.`,\n    );\n  } else {\n    printSuccess(`Pipeline complete for issue #${info.issueNumber}!`);\n  }\n  for (const line of buildRunSummaryLines(info)) {\n    console.log(line);\n  }\n}\n","import { execa } from 'execa';\nimport type { ClaudeResult } from '../types.js';\nimport { type ClaudeUsage, parseUsage } from './metrics.js';\nimport { getOutputCallback } from './verbose.js';\n\n/**\n * Execute Claude CLI with a prompt piped to stdin.\n *\n * Runs: echo $PROMPT | claude --dangerously-skip-permissions --print --output-format json\n *\n * The JSON envelope is requested purely for observability: it carries the token\n * and cost metrics of the execute phase. Every flow decision keeps working off\n * the same values as before — `exitCode` and the assistant's text — so the\n * envelope is unwrapped here and never leaks to callers. Whenever stdout is not\n * parseable JSON (or the CLI failed), the behaviour falls back exactly to the\n * previous combined stdout+stderr text with no metrics.\n */\nexport async function executeClaude(prompt: string): Promise<ClaudeResult> {\n  const result = await execa(\n    'claude',\n    ['--dangerously-skip-permissions', '--print', '--output-format', 'json'],\n    {\n      input: prompt,\n      reject: false,\n      timeout: 0, // No timeout — let the engine handle iteration limits\n      stripFinalNewline: false,\n    },\n  );\n\n  // Combine stdout and stderr to match Bash's 2>&1 behavior\n  const stdout = result.stdout?.toString() ?? '';\n  const stderr = result.stderr?.toString() ?? '';\n  const exitCode = result.exitCode ?? 1;\n\n  let output = stdout + (stderr ? `\\n${stderr}` : '');\n  let cost: ClaudeUsage | null = null;\n\n  // Only unwrap on success: a failing CLI may print diagnostics on stderr that\n  // trimErrorMessage()/isTransientFailure() need to see verbatim.\n  if (exitCode === 0) {\n    try {\n      const parsed: unknown = JSON.parse(stdout);\n      const text = (parsed as { result?: unknown } | null)?.result;\n      // Non-string `result` would break the callers that treat output as text.\n      output = typeof text === 'string' ? text : stdout;\n      cost = parseUsage(parsed);\n    } catch {\n      // Not JSON — keep the raw combined output and report no metrics.\n    }\n  }\n\n  // Forward output through the global callback (listr2 renderer) when active\n  const onOutput = getOutputCallback();\n  if (onOutput) {\n    const trimmed = output.trim();\n    if (trimmed) {\n      onOutput(trimmed);\n    }\n  }\n\n  return {\n    exitCode,\n    output,\n    cost,\n  };\n}\n","import { createConfig, resolvePaths, validateDependencies } from '../config.js';\nimport { runEngine } from '../core/engine.js';\nimport { allStoriesPass, loadTaskPlan, saveTaskPlan } from '../core/state-manager.js';\nimport { printError } from '../ui/logger.js';\n\nexport interface ExecuteOptions {\n  issue?: string;\n  maxIterations?: number;\n  retryLimit?: number;\n  retryForever?: boolean;\n  /**\n   * Conventional-commit scope for the stories of this issue (`issue-71`).\n   * Only the multi-issue queue sets it — see `EngineConfig.commitScope`.\n   */\n  commitScope?: string;\n}\n\nexport async function runExecute(\n  positionalMaxIter: number | undefined,\n  options: ExecuteOptions,\n): Promise<number> {\n  const errors = await validateDependencies();\n  if (errors.length > 0) {\n    printError('The following required tools are not installed:');\n    for (const err of errors) {\n      console.log(err);\n    }\n    return 1;\n  }\n\n  const maxIterations = options.maxIterations ?? positionalMaxIter;\n\n  const config = createConfig({\n    issueNumber: options.issue,\n    maxIterations,\n    retryLimit: options.retryLimit,\n    retryForever: options.retryForever,\n    commitScope: options.commitScope,\n  });\n\n  const paths = await resolvePaths(config);\n  const exitCode = await runEngine(config, paths);\n\n  // Update pipeline state if all stories pass\n  if (exitCode === 0 && config.issueNumber) {\n    try {\n      const plan = await loadTaskPlan(paths.prdFile);\n      if (allStoriesPass(plan)) {\n        plan.pipeline.executionCompleted = true;\n        await saveTaskPlan(paths.prdFile, plan);\n      }\n    } catch {\n      // Non-critical — engine already handled state\n    }\n  }\n\n  return exitCode;\n}\n"],"mappings":"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","names":["chalk","chalk","tokens","elapsed"]}

package/dist/{chunk-ZYBYMEWG.js → chunk-DTNM3LTO.js}

@@ -4,25 +4,47 @@ import {
   hasUsageData,
   isoNow,
   sumUsage
-} from "./chunk-WO6ERABE.js";
+} from "./chunk-57MH6RYJ.js";
 
 // src/core/session-metrics.ts
 function elapsedSecondsSince(startedAtMs) {
   return Math.max(0, Math.round((Date.now() - startedAtMs) / 1e3));
 }
-var runTotals = {
-  all: {},
-  byPhase: /* @__PURE__ */ new Map()
-};
+function createAccumulator() {
+  return { all: {}, byPhase: /* @__PURE__ */ new Map() };
+}
+var scopes = [createAccumulator()];
+function current() {
+  return scopes[scopes.length - 1];
+}
 function recordRunUsage(phase, usage) {
-  runTotals.all = sumUsage(runTotals.all, usage);
-  runTotals.byPhase.set(phase, sumUsage(runTotals.byPhase.get(phase), usage));
+  for (const scope of scopes) {
+    scope.all = sumUsage(scope.all, usage);
+    scope.byPhase.set(phase, sumUsage(scope.byPhase.get(phase), usage));
+  }
 }
 function getRunUsageTotals() {
-  return { ...runTotals.all };
+  return { ...current().all };
 }
 function getPhaseUsageTotals(phase) {
-  return { ...runTotals.byPhase.get(phase) ?? {} };
+  return { ...current().byPhase.get(phase) ?? {} };
+}
+function beginUsageScope() {
+  const accumulator = createAccumulator();
+  scopes.push(accumulator);
+  let open = true;
+  return {
+    totals: () => ({ ...accumulator.all }),
+    phaseTotals: (phase) => ({ ...accumulator.byPhase.get(phase) ?? {} }),
+    end: () => {
+      if (open) {
+        const index = scopes.indexOf(accumulator);
+        if (index > 0) scopes.splice(index, 1);
+        open = false;
+      }
+      return { ...accumulator.all };
+    }
+  };
 }
 function publishPhaseMetrics(phase, usage, startedAtMs) {
   if (usage == null || !hasUsageData(usage)) return;
@@ -70,9 +92,10 @@ export {
   elapsedSecondsSince,
   getRunUsageTotals,
   getPhaseUsageTotals,
+  beginUsageScope,
   publishPhaseMetrics,
   EXECUTE_PHASE,
   publishIterationMetrics,
   publishStoryMetrics
 };
-//# sourceMappingURL=chunk-ZYBYMEWG.js.map
+//# sourceMappingURL=chunk-DTNM3LTO.js.map

package/dist/chunk-DTNM3LTO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/session-metrics.ts"],"sourcesContent":["import { type ClaudeUsage, hasUsageData, sumUsage } from './metrics.js';\nimport { getSessionPublisher } from './session-publisher.js';\nimport { isoNow } from './state-manager.js';\n\n/**\n * Publication helper for the single-invocation phases (analyze, generate, prd,\n * plan, review, pr, pr-review).\n *\n * Each of them owns its own `runHeadless` call, so the metrics are published\n * from inside the command rather than from the `instrumentedRunners` wrapper in\n * run.ts: the wrapper only sees `() => Promise<void>` and never touches the\n * HeadlessResult. Publishing here also covers standalone invocations\n * (`issue-flow prd 42`), which never go through the pipeline wrapper at all.\n */\n\n/** Whole seconds elapsed since a `Date.now()` mark, never negative. */\nexport function elapsedSecondsSince(startedAtMs: number): number {\n  return Math.max(0, Math.round((Date.now() - startedAtMs) / 1000));\n}\n\n/**\n * Process-owned totals, accumulated alongside every published event.\n *\n * The session snapshot cannot be the source of the terminal summary: with web\n * monitoring off the publisher is a `NullPublisher` and its snapshot stays\n * empty, so the numbers would silently vanish exactly in the default mode.\n * These counters live in the process and are therefore independent of any\n * publisher.\n *\n * Only phase- and iteration-scoped usage is recorded. Story metrics are a\n * rateio of an iteration already counted here — adding them would double the\n * totals, the same rule the reducer follows.\n */\ninterface UsageAccumulator {\n  all: ClaudeUsage;\n  byPhase: Map<string, ClaudeUsage>;\n}\n\nfunction createAccumulator(): UsageAccumulator {\n  return { all: {}, byPhase: new Map() };\n}\n\n/**\n * Stack of active accumulators, innermost last.\n *\n * The bottom entry is the process total and always exists. A multi-issue run\n * pushes one accumulator per issue (and one for the whole queue) so the terminal\n * summary of issue B never inherits what issue A spent — the leak `core/CLAUDE.md`\n * warned about when it stated that the module-level counters were safe \"only\n * under the current one-issue-per-process model\".\n *\n * Every publication feeds **all** active accumulators, so a scope is a view of\n * the same events rather than a redirection of them.\n */\nconst scopes: UsageAccumulator[] = [createAccumulator()];\n\n/** Innermost active scope: what `run` and the engine report right now. */\nfunction current(): UsageAccumulator {\n  return scopes[scopes.length - 1] as UsageAccumulator;\n}\n\nfunction recordRunUsage(phase: string, usage: ClaudeUsage): void {\n  for (const scope of scopes) {\n    scope.all = sumUsage(scope.all, usage);\n    scope.byPhase.set(phase, sumUsage(scope.byPhase.get(phase), usage));\n  }\n}\n\n/** Everything the innermost active scope has spent, across all phases. */\nexport function getRunUsageTotals(): ClaudeUsage {\n  return { ...current().all };\n}\n\n/** What a single phase has spent so far. Empty when the phase reported nothing. */\nexport function getPhaseUsageTotals(phase: string): ClaudeUsage {\n  return { ...(current().byPhase.get(phase) ?? {}) };\n}\n\n/** A usage scope opened by {@link beginUsageScope}. */\nexport interface UsageScope {\n  /** Everything published while this scope was open. */\n  totals(): ClaudeUsage;\n  /** What one phase published while this scope was open. */\n  phaseTotals(phase: string): ClaudeUsage;\n  /** Close the scope. Idempotent, and safe to call out of order. */\n  end(): ClaudeUsage;\n}\n\n/**\n * Open a nested usage scope, for a run that processes several issues in one\n * process.\n *\n * The scope accumulates only what is published while it is open, which is what\n * lets a queue report a per-issue cost and a consolidated total from the same\n * stream of events. Closing it never discards anything: the outer scopes were\n * fed in parallel.\n */\nexport function beginUsageScope(): UsageScope {\n  const accumulator = createAccumulator();\n  scopes.push(accumulator);\n  let open = true;\n\n  return {\n    totals: () => ({ ...accumulator.all }),\n    phaseTotals: (phase: string) => ({ ...(accumulator.byPhase.get(phase) ?? {}) }),\n    end: () => {\n      if (open) {\n        const index = scopes.indexOf(accumulator);\n        // Never pop the process total, even if a caller double-ends a scope.\n        if (index > 0) scopes.splice(index, 1);\n        open = false;\n      }\n      return { ...accumulator.all };\n    },\n  };\n}\n\n/** Test seam: the counters are module state and must be cleared between runs. */\nexport function resetRunUsageTotals(): void {\n  scopes.splice(0, scopes.length, createAccumulator());\n}\n\n/**\n * Publish one `metrics:update` event of scope `phase` for a headless\n * invocation.\n *\n * A no-op when the CLI reported no usage at all: an event with every field\n * undefined would bump the snapshot version without adding information, and the\n * reducer would leave every counter at null anyway.\n *\n * A command with more than one invocation (the retrying phases, or `review`\n * inside a correction cycle) calls this once per invocation — the reducer's\n * summing is what turns them into the phase total.\n *\n * Never throws and never returns a value: publishing metrics must not be able\n * to change a command's exit code.\n */\nexport function publishPhaseMetrics(\n  phase: string,\n  usage: ClaudeUsage | null | undefined,\n  startedAtMs?: number,\n): void {\n  if (usage == null || !hasUsageData(usage)) return;\n\n  recordRunUsage(phase, usage);\n\n  getSessionPublisher().publish({\n    type: 'metrics:update',\n    at: isoNow(),\n    scope: 'phase',\n    phase,\n    ...usage,\n    // Informational only: a phase's durationSeconds keeps coming exclusively\n    // from phase:start/phase:end, so the reducer ignores this for scope 'phase'.\n    durationSeconds: startedAtMs === undefined ? undefined : elapsedSecondsSince(startedAtMs),\n  });\n}\n\n/** The execute loop is the only producer of iteration- and story-scoped metrics. */\nexport const EXECUTE_PHASE = 'execute';\n\n/**\n * Publish one `metrics:update` event of scope `iteration` for a pass of the\n * execute loop.\n *\n * Lands on the `execute` phase and on the issue-wide aggregate, exactly like a\n * phase-scoped event: an iteration *is* a slice of the execute phase. Failed\n * iterations (transient or fatal) publish too — those tokens were spent.\n *\n * A no-op when the CLI reported no usage. Never throws.\n */\nexport function publishIterationMetrics(\n  iteration: number,\n  usage: ClaudeUsage | null | undefined,\n  durationSeconds?: number,\n): void {\n  if (usage == null || !hasUsageData(usage)) return;\n\n  recordRunUsage(EXECUTE_PHASE, usage);\n\n  getSessionPublisher().publish({\n    type: 'metrics:update',\n    at: isoNow(),\n    scope: 'iteration',\n    phase: EXECUTE_PHASE,\n    iteration,\n    ...usage,\n    // Informational only: the reducer keeps a phase's durationSeconds coming\n    // exclusively from phase:start/phase:end.\n    durationSeconds,\n  });\n}\n\n/**\n * Publish one `metrics:update` event of scope `story`.\n *\n * The values are the rateio of the iteration that completed the story, so the\n * reducer deliberately keeps them off the phase and the aggregate — the\n * iteration event of the same cycle already counted them there.\n *\n * A no-op when there is neither usage nor a duration to report. Never throws.\n */\nexport function publishStoryMetrics(\n  storyId: string,\n  usage: ClaudeUsage | null | undefined,\n  durationSeconds?: number,\n): void {\n  if (!hasUsageData(usage) && durationSeconds === undefined) return;\n\n  getSessionPublisher().publish({\n    type: 'metrics:update',\n    at: isoNow(),\n    scope: 'story',\n    storyId,\n    ...(usage ?? {}),\n    durationSeconds,\n  });\n}\n"],"mappings":";;;;;;;;;AAgBO,SAAS,oBAAoB,aAA6B;AAC/D,SAAO,KAAK,IAAI,GAAG,KAAK,OAAO,KAAK,IAAI,IAAI,eAAe,GAAI,CAAC;AAClE;AAoBA,SAAS,oBAAsC;AAC7C,SAAO,EAAE,KAAK,CAAC,GAAG,SAAS,oBAAI,IAAI,EAAE;AACvC;AAcA,IAAM,SAA6B,CAAC,kBAAkB,CAAC;AAGvD,SAAS,UAA4B;AACnC,SAAO,OAAO,OAAO,SAAS,CAAC;AACjC;AAEA,SAAS,eAAe,OAAe,OAA0B;AAC/D,aAAW,SAAS,QAAQ;AAC1B,UAAM,MAAM,SAAS,MAAM,KAAK,KAAK;AACrC,UAAM,QAAQ,IAAI,OAAO,SAAS,MAAM,QAAQ,IAAI,KAAK,GAAG,KAAK,CAAC;AAAA,EACpE;AACF;AAGO,SAAS,oBAAiC;AAC/C,SAAO,EAAE,GAAG,QAAQ,EAAE,IAAI;AAC5B;AAGO,SAAS,oBAAoB,OAA4B;AAC9D,SAAO,EAAE,GAAI,QAAQ,EAAE,QAAQ,IAAI,KAAK,KAAK,CAAC,EAAG;AACnD;AAqBO,SAAS,kBAA8B;AAC5C,QAAM,cAAc,kBAAkB;AACtC,SAAO,KAAK,WAAW;AACvB,MAAI,OAAO;AAEX,SAAO;AAAA,IACL,QAAQ,OAAO,EAAE,GAAG,YAAY,IAAI;AAAA,IACpC,aAAa,CAAC,WAAmB,EAAE,GAAI,YAAY,QAAQ,IAAI,KAAK,KAAK,CAAC,EAAG;AAAA,IAC7E,KAAK,MAAM;AACT,UAAI,MAAM;AACR,cAAM,QAAQ,OAAO,QAAQ,WAAW;AAExC,YAAI,QAAQ,EAAG,QAAO,OAAO,OAAO,CAAC;AACrC,eAAO;AAAA,MACT;AACA,aAAO,EAAE,GAAG,YAAY,IAAI;AAAA,IAC9B;AAAA,EACF;AACF;AAsBO,SAAS,oBACd,OACA,OACA,aACM;AACN,MAAI,SAAS,QAAQ,CAAC,aAAa,KAAK,EAAG;AAE3C,iBAAe,OAAO,KAAK;AAE3B,sBAAoB,EAAE,QAAQ;AAAA,IAC5B,MAAM;AAAA,IACN,IAAI,OAAO;AAAA,IACX,OAAO;AAAA,IACP;AAAA,IACA,GAAG;AAAA;AAAA;AAAA,IAGH,iBAAiB,gBAAgB,SAAY,SAAY,oBAAoB,WAAW;AAAA,EAC1F,CAAC;AACH;AAGO,IAAM,gBAAgB;AAYtB,SAAS,wBACd,WACA,OACA,iBACM;AACN,MAAI,SAAS,QAAQ,CAAC,aAAa,KAAK,EAAG;AAE3C,iBAAe,eAAe,KAAK;AAEnC,sBAAoB,EAAE,QAAQ;AAAA,IAC5B,MAAM;AAAA,IACN,IAAI,OAAO;AAAA,IACX,OAAO;AAAA,IACP,OAAO;AAAA,IACP;AAAA,IACA,GAAG;AAAA;AAAA;AAAA,IAGH;AAAA,EACF,CAAC;AACH;AAWO,SAAS,oBACd,SACA,OACA,iBACM;AACN,MAAI,CAAC,aAAa,KAAK,KAAK,oBAAoB,OAAW;AAE3D,sBAAoB,EAAE,QAAQ;AAAA,IAC5B,MAAM;AAAA,IACN,IAAI,OAAO;AAAA,IACX,OAAO;AAAA,IACP;AAAA,IACA,GAAI,SAAS,CAAC;AAAA,IACd;AAAA,EACF,CAAC;AACH;","names":[]}

package/dist/{chunk-KHTLN54U.js → chunk-JGKPSWOA.js}

@@ -10,7 +10,7 @@ import {
   isoNow,
   parseUsage,
   useColor
-} from "./chunk-WO6ERABE.js";
+} from "./chunk-57MH6RYJ.js";
 
 // src/core/headless.ts
 import { createInterface } from "readline";
@@ -279,4 +279,4 @@ async function runHeadless(options) {
 export {
   runHeadless
 };
-//# sourceMappingURL=chunk-KHTLN54U.js.map
+//# sourceMappingURL=chunk-JGKPSWOA.js.map