issue-flow 0.5.1 → 0.5.2

package/README.md

@@ -167,11 +167,11 @@ Analyzes the project and creates a detailed GitHub issue via Claude headless.
 `run` and `execute` support an optional (off by default) real-time monitoring mode: a local HTTP server (plain `node:http`, zero new dependencies) serves a self-contained, read-only web UI with live progress -- current phase and activity, user stories, commits, pull requests, logs, and time estimates.
 
 ```bash
-# Enable with defaults (http://127.0.0.1:3737)
+# Enable with defaults -- binds to 0.0.0.0:3737, reachable from your LAN/VPN
 npx issue-flow run 42 --web
 
-# Remote access over Tailscale: bind to your machine's Tailscale IP
-npx issue-flow run 42 --web --host 100.101.102.103
+# Restrict to this machine only
+npx issue-flow run 42 --web --host 127.0.0.1
 ```
 
 Each setting resolves with the precedence **CLI flag > environment variable > `.issue-flow.json` > default**:
@@ -180,7 +180,7 @@ Each setting resolves with the precedence **CLI flag > environment variable > `.
 |----------|----------------------|------------------------|---------|
 | `--web` / `--serve` | `ISSUE_FLOW_WEB` | `web.enabled` | `false` |
 | `--port <n>` | `ISSUE_FLOW_WEB_PORT` | `web.port` | `3737` |
-| `--host <h>` | `ISSUE_FLOW_WEB_HOST` | `web.host` | `127.0.0.1` |
+| `--host <h>` | `ISSUE_FLOW_WEB_HOST` | `web.host` | `0.0.0.0` |
 | `--refresh <s>` | `ISSUE_FLOW_WEB_REFRESH` | `web.refreshSeconds` | `5` |
 | `--web-log-limit <n>` | `ISSUE_FLOW_WEB_LOG_LIMIT` | `web.logLimit` | `200` |
 | `--web-no-logs` | -- | `web.includeLogs` | logs included |

package/dist/{analyze-IJ2SYXVM.js → analyze-QVQ4CTCU.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runHeadless
-} from "./chunk-2XWXVWVD.js";
+} from "./chunk-KLBAHTXX.js";
 import {
   applyPlaceholders,
   loadPrompt
@@ -13,7 +13,7 @@ import {
   printInfo,
   printSuccess,
   saveTaskPlan
-} from "./chunk-FNLXZXWP.js";
+} from "./chunk-O5XI2CFF.js";
 
 // src/commands/analyze.ts
 import { mkdir, readFile, writeFile } from "fs/promises";
@@ -63,4 +63,4 @@ async function runAnalyze(issue) {
 export {
   runAnalyze
 };
-//# sourceMappingURL=analyze-IJ2SYXVM.js.map
+//# sourceMappingURL=analyze-QVQ4CTCU.js.map

package/dist/chunk-3ULIAC2J.js

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+import {
+  retryDelaySeconds,
+  sleep
+} from "./chunk-HDV3YDTG.js";
+import {
+  getSessionPublisher,
+  isoNow,
+  printRetry
+} from "./chunk-O5XI2CFF.js";
+
+// src/core/phase-runner.ts
+import { readFile } from "fs/promises";
+var DEFAULT_PHASE_RETRY_LIMIT = 3;
+var DEFAULT_BACKOFF_BASE_SECONDS = 15;
+var DEFAULT_BACKOFF_MAX_SECONDS = 120;
+async function runPhaseWithRetry(options) {
+  const retryLimit = options.retryLimit ?? DEFAULT_PHASE_RETRY_LIMIT;
+  const backoffBaseSeconds = options.backoffBaseSeconds ?? DEFAULT_BACKOFF_BASE_SECONDS;
+  const backoffMaxSeconds = options.backoffMaxSeconds ?? DEFAULT_BACKOFF_MAX_SECONDS;
+  let lastResult = { ok: false, error: "Phase never attempted" };
+  let retryCount = 0;
+  for (let attemptNumber = 1; attemptNumber <= retryLimit; attemptNumber++) {
+    lastResult = await options.attempt(attemptNumber);
+    if (lastResult.ok) return lastResult;
+    if (!lastResult.transient || attemptNumber === retryLimit) return lastResult;
+    retryCount++;
+    const delaySeconds = retryDelaySeconds(retryCount, backoffBaseSeconds, backoffMaxSeconds);
+    getSessionPublisher().publish({
+      type: "retry",
+      at: isoNow(),
+      attempt: retryCount,
+      delaySeconds,
+      reason: lastResult.error
+    });
+    printRetry(
+      `Phase ${options.phase} hit a recoverable failure (attempt ${attemptNumber}/${retryLimit}): ${lastResult.error}. Retrying in ${delaySeconds}s.`
+    );
+    await sleep(delaySeconds);
+  }
+  return lastResult;
+}
+async function readFileWithGrace(path, delaysMs = [300, 800]) {
+  for (let i = 0; ; i++) {
+    try {
+      return await readFile(path, "utf-8");
+    } catch (err) {
+      if (i >= delaysMs.length) throw err;
+      await new Promise((resolve) => setTimeout(resolve, delaysMs[i]));
+    }
+  }
+}
+
+export {
+  runPhaseWithRetry,
+  readFileWithGrace
+};
+//# sourceMappingURL=chunk-3ULIAC2J.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/phase-runner.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { printRetry } from '../ui/logger.js';\nimport { retryDelaySeconds, sleep } from '../utils/retry.js';\nimport { getSessionPublisher } from './session-publisher.js';\nimport { isoNow } from './state-manager.js';\n\nexport interface PhaseAttemptResult {\n  ok: boolean;\n  /** Whether a failed attempt is worth retrying. Ignored when ok is true. */\n  transient?: boolean;\n  error?: string;\n}\n\nexport interface PhaseRetryOptions {\n  phase: string;\n  attempt: (attemptNumber: number) => Promise<PhaseAttemptResult>;\n  retryLimit?: number;\n  backoffBaseSeconds?: number;\n  backoffMaxSeconds?: number;\n}\n\nconst DEFAULT_PHASE_RETRY_LIMIT = 3;\nconst DEFAULT_BACKOFF_BASE_SECONDS = 15;\nconst DEFAULT_BACKOFF_MAX_SECONDS = 120;\n\n/**\n * Bounded retry wrapper for single-shot phases (prd, plan, pr) that invoke\n * the Claude CLI once and validate an artifact. Mirrors the transient-retry\n * pattern already used by the execute phase's iteration loop (core/engine.ts:\n * isTransientFailure + retryDelaySeconds), applied here to phases that\n * previously aborted the whole pipeline on the first failure with no chance\n * to recover. Non-transient failures (or exhausting the retry budget) still\n * end the phase — this bounds recovery attempts, it never retries forever.\n */\nexport async function runPhaseWithRetry(options: PhaseRetryOptions): Promise<PhaseAttemptResult> {\n  const retryLimit = options.retryLimit ?? DEFAULT_PHASE_RETRY_LIMIT;\n  const backoffBaseSeconds = options.backoffBaseSeconds ?? DEFAULT_BACKOFF_BASE_SECONDS;\n  const backoffMaxSeconds = options.backoffMaxSeconds ?? DEFAULT_BACKOFF_MAX_SECONDS;\n\n  let lastResult: PhaseAttemptResult = { ok: false, error: 'Phase never attempted' };\n  let retryCount = 0;\n\n  for (let attemptNumber = 1; attemptNumber <= retryLimit; attemptNumber++) {\n    lastResult = await options.attempt(attemptNumber);\n    if (lastResult.ok) return lastResult;\n    if (!lastResult.transient || attemptNumber === retryLimit) return lastResult;\n\n    retryCount++;\n    const delaySeconds = retryDelaySeconds(retryCount, backoffBaseSeconds, backoffMaxSeconds);\n    getSessionPublisher().publish({\n      type: 'retry',\n      at: isoNow(),\n      attempt: retryCount,\n      delaySeconds,\n      reason: lastResult.error,\n    });\n    printRetry(\n      `Phase ${options.phase} hit a recoverable failure (attempt ${attemptNumber}/${retryLimit}): ${lastResult.error}. Retrying in ${delaySeconds}s.`,\n    );\n    await sleep(delaySeconds);\n  }\n\n  return lastResult;\n}\n\n/**\n * Re-read a file a few times with short delays before giving up. Absorbs a\n * brief filesystem-visibility lag between the Claude CLI's Write tool\n * completing and this process observing the result, without spending a full\n * phase retry (and a new Claude invocation) on what may just be a timing gap.\n */\nexport async function readFileWithGrace(\n  path: string,\n  delaysMs: number[] = [300, 800],\n): Promise<string> {\n  for (let i = 0; ; i++) {\n    try {\n      return await readFile(path, 'utf-8');\n    } catch (err) {\n      if (i >= delaysMs.length) throw err;\n      await new Promise((resolve) => setTimeout(resolve, delaysMs[i]));\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAAA,SAAS,gBAAgB;AAqBzB,IAAM,4BAA4B;AAClC,IAAM,+BAA+B;AACrC,IAAM,8BAA8B;AAWpC,eAAsB,kBAAkB,SAAyD;AAC/F,QAAM,aAAa,QAAQ,cAAc;AACzC,QAAM,qBAAqB,QAAQ,sBAAsB;AACzD,QAAM,oBAAoB,QAAQ,qBAAqB;AAEvD,MAAI,aAAiC,EAAE,IAAI,OAAO,OAAO,wBAAwB;AACjF,MAAI,aAAa;AAEjB,WAAS,gBAAgB,GAAG,iBAAiB,YAAY,iBAAiB;AACxE,iBAAa,MAAM,QAAQ,QAAQ,aAAa;AAChD,QAAI,WAAW,GAAI,QAAO;AAC1B,QAAI,CAAC,WAAW,aAAa,kBAAkB,WAAY,QAAO;AAElE;AACA,UAAM,eAAe,kBAAkB,YAAY,oBAAoB,iBAAiB;AACxF,wBAAoB,EAAE,QAAQ;AAAA,MAC5B,MAAM;AAAA,MACN,IAAI,OAAO;AAAA,MACX,SAAS;AAAA,MACT;AAAA,MACA,QAAQ,WAAW;AAAA,IACrB,CAAC;AACD;AAAA,MACE,SAAS,QAAQ,KAAK,uCAAuC,aAAa,IAAI,UAAU,MAAM,WAAW,KAAK,iBAAiB,YAAY;AAAA,IAC7I;AACA,UAAM,MAAM,YAAY;AAAA,EAC1B;AAEA,SAAO;AACT;AAQA,eAAsB,kBACpB,MACA,WAAqB,CAAC,KAAK,GAAG,GACb;AACjB,WAAS,IAAI,KAAK,KAAK;AACrB,QAAI;AACF,aAAO,MAAM,SAAS,MAAM,OAAO;AAAA,IACrC,SAAS,KAAK;AACZ,UAAI,KAAK,SAAS,OAAQ,OAAM;AAChC,YAAM,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,SAAS,CAAC,CAAC,CAAC;AAAA,IACjE;AAAA,EACF;AACF;","names":[]}

package/dist/{chunk-GYR4YHEB.js → chunk-DLWRUTRL.js}

@@ -7,7 +7,12 @@ import {
   resolvePaths,
   run,
   validateDependencies
-} from "./chunk-TYOFZ6DD.js";
+} from "./chunk-PA3GI7LR.js";
+import {
+  isTransientFailure,
+  retryDelaySeconds,
+  sleep
+} from "./chunk-HDV3YDTG.js";
 import {
   applyPlaceholders,
   loadPrompt
@@ -38,7 +43,7 @@ import {
   trimErrorMessage,
   useColor,
   useUnicode
-} from "./chunk-FNLXZXWP.js";
+} from "./chunk-O5XI2CFF.js";
 
 // src/core/engine.ts
 import { existsSync } from "fs";
@@ -210,47 +215,6 @@ function printSummaryBox(status, iterations, totalRetries, elapsedSeconds, plan,
   printBox(boxLines);
 }
 
-// src/utils/retry.ts
-var TRANSIENT_PATTERNS = [
-  "timed out",
-  "timeout",
-  "connection reset",
-  "connection refused",
-  "connection aborted",
-  "network error",
-  "network unavailable",
-  "temporary failure",
-  "temporarily unavailable",
-  "service unavailable",
-  "overloaded",
-  "rate limit",
-  "too many requests",
-  "bad gateway",
-  "gateway timeout",
-  "internal server error",
-  "http 429",
-  "http 500",
-  "http 502",
-  "http 503",
-  "http 504",
-  "econnreset",
-  "econnrefused",
-  "enotfound",
-  "etimedout",
-  "socket hang up"
-];
-function isTransientFailure(exitCode, output) {
-  if (exitCode === 75) {
-    return true;
-  }
-  const lowered = output.toLowerCase();
-  return TRANSIENT_PATTERNS.some((pattern) => lowered.includes(pattern));
-}
-function retryDelaySeconds(attempt, baseSeconds = 30, maxSeconds = 900) {
-  const delay = baseSeconds * 2 ** (attempt - 1);
-  return Math.min(delay, maxSeconds);
-}
-
 // src/core/executor.ts
 import { execa } from "execa";
 async function executeClaude(prompt) {
@@ -334,9 +298,6 @@ async function publishGitState(publisher, sources = {}) {
 }
 
 // src/core/engine.ts
-function sleep(seconds) {
-  return new Promise((resolve) => setTimeout(resolve, seconds * 1e3));
-}
 function emitLog(message) {
   const cb = getOutputCallback();
   if (cb) {
@@ -604,4 +565,4 @@ export {
   publishGitState,
   runExecute
 };
-//# sourceMappingURL=chunk-GYR4YHEB.js.map
+//# sourceMappingURL=chunk-DLWRUTRL.js.map

package/dist/chunk-DLWRUTRL.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/core/session-git.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 } 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 { applyPlaceholders, loadPrompt } from './prompt-resolver.js';\nimport { publishGitState } from './session-git.js';\nimport { getSessionPublisher } from './session-publisher.js';\nimport {\n  allStoriesPass,\n  clearLastError,\n  initializeState,\n  isoNow,\n  loadTaskPlan,\n  markIssueCompleted,\n  markIssueInProgress,\n  saveTaskPlan,\n  setLastError,\n  trimErrorMessage,\n} from './state-manager.js';\nimport { getOutputCallback, getStoryUpdateCallback, isVerbose } 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 * 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\n  if (plan.issueStatus === 'completed' && allStoriesPass(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)) {\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    getSessionPublisher().publish({ type: 'iteration:start', at: isoNow(), iteration: i });\n\n    // Re-read plan to get latest state\n    plan = await loadTaskPlan(paths.prdFile);\n\n    if (isVerbose()) {\n      printIterationHeader(i, config.maxIterations, plan.userStories);\n    }\n\n    // Apply placeholders to prompt\n    const prompt = applyPlaceholders(promptTemplate, {\n      __PRD_FILE__: paths.prdFile,\n      __PROGRESS_FILE__: paths.progressFile,\n    });\n\n    const iterationStartedAt = isoNow();\n    plan = markIssueInProgress(plan, iterationStartedAt);\n    await saveTaskPlan(paths.prdFile, plan);\n\n    // Execute Claude\n    const result = await executeClaude(prompt);\n\n    if (result.exitCode !== 0) {\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          );\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      );\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    getSessionPublisher().publish({ type: 'iteration:end', at: isoNow(), iteration: i });\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)) {\n        plan = markIssueCompleted(plan);\n        await saveTaskPlan(paths.prdFile, plan);\n\n        const elapsed = Math.floor((Date.now() - startTime) / 1000);\n        printSummaryBox('success', i, totalRetryCount, elapsed, plan);\n        return 0;\n      }\n\n      plan = setLastError(\n        plan,\n        'invalid_completion_signal',\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        '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  );\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 */\nexport function printIterationHeader(\n  iteration: number,\n  maxIter: number | undefined,\n  stories: UserStory[],\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\n    if (story.passes) {\n      icon = icons.success;\n      colorFn = colored ? chalk.green : (s: string) => s;\n    } else if (!foundFirstPending) {\n      // First non-passing story = current in-progress\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 { EngineConfig, TaskPlan } from '../types.js';\nimport { formatDuration, getIcons, getTermWidth, useColor, useUnicode } 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): 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    `Retries:     ${totalRetries}`,\n  ];\n\n  if (extraInfo) {\n    boxLines.push('---');\n    boxLines.push(extraInfo);\n  }\n\n  console.log('');\n  printBox(boxLines);\n}\n","import { execa } from 'execa';\nimport type { ClaudeResult } from '../types.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\n *\n * Captures combined stdout+stderr output. Does not throw on non-zero exit codes.\n * Output is returned via ClaudeResult and routed through the output callback infrastructure.\n */\nexport async function executeClaude(prompt: string): Promise<ClaudeResult> {\n  const result = await execa('claude', ['--dangerously-skip-permissions', '--print'], {\n    input: prompt,\n    reject: false,\n    timeout: 0, // No timeout — let the engine handle iteration limits\n    stripFinalNewline: false,\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 output = stdout + (stderr ? `\\n${stderr}` : '');\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: result.exitCode ?? 1,\n    output,\n  };\n}\n","import { getBaseBranch, getCommitsSince, getCurrentBranch } from '../utils/git.js';\nimport { run } from '../utils/shell.js';\nimport {\n  NullPublisher,\n  type SessionCommit,\n  type SessionPublisher,\n  type SessionPullRequest,\n} from './session-state.js';\nimport { isoNow } from './state-manager.js';\n\n/**\n * Low-frequency enrichment of the session snapshot with git commits and pull\n * requests. Called only at phase boundaries (run.ts) and at the end of each\n * iteration (engine.ts) — never per HTTP request: the server (US-006) serves\n * the in-memory snapshot as-is.\n *\n * Like every monitoring surface, this must never affect the pipeline: with\n * the NullPublisher installed it returns before spawning any subprocess, and\n * every failure is swallowed.\n */\n\n/** Data sources, injectable for tests. */\nexport interface GitStateSources {\n  currentBranch(): Promise<string>;\n  baseBranch(): Promise<string>;\n  commitsSince(base: string): Promise<SessionCommit[]>;\n  pullRequests(branch: string): Promise<SessionPullRequest[]>;\n  now(): string;\n}\n\n/**\n * List PRs whose head is the given branch via the GitHub CLI. Never throws;\n * returns [] when gh is unavailable, unauthenticated or returns bad JSON.\n */\nexport async function listPullRequests(branch: string): Promise<SessionPullRequest[]> {\n  if (!branch) return [];\n\n  const result = await run('gh', [\n    'pr',\n    'list',\n    '--head',\n    branch,\n    '--state',\n    'all',\n    '--json',\n    'number,url,title',\n    '--limit',\n    '10',\n  ]);\n  if (result.exitCode !== 0) return [];\n\n  try {\n    const parsed: unknown = JSON.parse(result.stdout || '[]');\n    if (!Array.isArray(parsed)) return [];\n    return parsed\n      .filter(\n        (pr): pr is { number: number; url: string; title: string } =>\n          typeof pr === 'object' &&\n          pr !== null &&\n          typeof (pr as { number?: unknown }).number === 'number' &&\n          typeof (pr as { url?: unknown }).url === 'string' &&\n          typeof (pr as { title?: unknown }).title === 'string',\n      )\n      .map((pr) => ({ number: pr.number, url: pr.url, title: pr.title }));\n  } catch {\n    return [];\n  }\n}\n\nconst defaultSources: GitStateSources = {\n  currentBranch: getCurrentBranch,\n  baseBranch: getBaseBranch,\n  commitsSince: getCommitsSince,\n  pullRequests: listPullRequests,\n  now: isoNow,\n};\n\n/**\n * Gather branch, base branch, commits and PRs, then publish a single\n * git:update event. Never throws.\n */\nexport async function publishGitState(\n  publisher: SessionPublisher,\n  sources: Partial<GitStateSources> = {},\n): Promise<void> {\n  if (publisher instanceof NullPublisher) return;\n  const src: GitStateSources = { ...defaultSources, ...sources };\n\n  try {\n    const branch = await src.currentBranch();\n    const baseBranch = await src.baseBranch();\n    const [commits, pullRequests] = await Promise.all([\n      src.commitsSince(baseBranch),\n      src.pullRequests(branch),\n    ]);\n\n    publisher.publish({\n      type: 'git:update',\n      at: src.now(),\n      branch,\n      baseBranch,\n      commits,\n      pullRequests,\n    });\n  } catch {\n    // Monitoring enrichment must never propagate errors to the pipeline.\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\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  });\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","elapsed"]}

package/dist/chunk-HDV3YDTG.js

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+
+// src/utils/retry.ts
+var TRANSIENT_PATTERNS = [
+  "timed out",
+  "timeout",
+  "connection reset",
+  "connection refused",
+  "connection aborted",
+  "network error",
+  "network unavailable",
+  "temporary failure",
+  "temporarily unavailable",
+  "service unavailable",
+  "overloaded",
+  "rate limit",
+  "too many requests",
+  "bad gateway",
+  "gateway timeout",
+  "internal server error",
+  "http 429",
+  "http 500",
+  "http 502",
+  "http 503",
+  "http 504",
+  "econnreset",
+  "econnrefused",
+  "enotfound",
+  "etimedout",
+  "socket hang up"
+];
+function isTransientFailure(exitCode, output) {
+  if (exitCode === 75) {
+    return true;
+  }
+  const lowered = output.toLowerCase();
+  return TRANSIENT_PATTERNS.some((pattern) => lowered.includes(pattern));
+}
+function retryDelaySeconds(attempt, baseSeconds = 30, maxSeconds = 900) {
+  const delay = baseSeconds * 2 ** (attempt - 1);
+  return Math.min(delay, maxSeconds);
+}
+function sleep(seconds) {
+  return new Promise((resolve) => setTimeout(resolve, seconds * 1e3));
+}
+
+export {
+  isTransientFailure,
+  retryDelaySeconds,
+  sleep
+};
+//# sourceMappingURL=chunk-HDV3YDTG.js.map

package/dist/chunk-HDV3YDTG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/retry.ts"],"sourcesContent":["/**\n * Transient failure patterns — matching the Bash script's detection heuristics.\n * These are checked case-insensitively against the combined output.\n */\nconst TRANSIENT_PATTERNS = [\n  'timed out',\n  'timeout',\n  'connection reset',\n  'connection refused',\n  'connection aborted',\n  'network error',\n  'network unavailable',\n  'temporary failure',\n  'temporarily unavailable',\n  'service unavailable',\n  'overloaded',\n  'rate limit',\n  'too many requests',\n  'bad gateway',\n  'gateway timeout',\n  'internal server error',\n  'http 429',\n  'http 500',\n  'http 502',\n  'http 503',\n  'http 504',\n  'econnreset',\n  'econnrefused',\n  'enotfound',\n  'etimedout',\n  'socket hang up',\n];\n\n/**\n * Determine if a Claude CLI failure is transient (retryable).\n *\n * A failure is considered transient if:\n * - Exit code is 75 (EX_TEMPFAIL)\n * - Output contains known transient error patterns\n */\nexport function isTransientFailure(exitCode: number, output: string): boolean {\n  // Exit code 75 = EX_TEMPFAIL\n  if (exitCode === 75) {\n    return true;\n  }\n\n  const lowered = output.toLowerCase();\n  return TRANSIENT_PATTERNS.some((pattern) => lowered.includes(pattern));\n}\n\n/**\n * Calculate retry delay using exponential backoff.\n *\n * delay = baseSeconds * 2^(attempt-1), capped at maxSeconds\n *\n * @param attempt - The retry attempt number (1-based)\n * @param baseSeconds - Base delay in seconds (default: 30)\n * @param maxSeconds - Maximum delay in seconds (default: 900)\n */\nexport function retryDelaySeconds(\n  attempt: number,\n  baseSeconds: number = 30,\n  maxSeconds: number = 900,\n): number {\n  const delay = baseSeconds * 2 ** (attempt - 1);\n  return Math.min(delay, maxSeconds);\n}\n\n/**\n * Sleep for a given number of seconds.\n */\nexport function sleep(seconds: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, seconds * 1000));\n}\n"],"mappings":";;;AAIA,IAAM,qBAAqB;AAAA,EACzB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AASO,SAAS,mBAAmB,UAAkB,QAAyB;AAE5E,MAAI,aAAa,IAAI;AACnB,WAAO;AAAA,EACT;AAEA,QAAM,UAAU,OAAO,YAAY;AACnC,SAAO,mBAAmB,KAAK,CAAC,YAAY,QAAQ,SAAS,OAAO,CAAC;AACvE;AAWO,SAAS,kBACd,SACA,cAAsB,IACtB,aAAqB,KACb;AACR,QAAM,QAAQ,cAAc,MAAM,UAAU;AAC5C,SAAO,KAAK,IAAI,OAAO,UAAU;AACnC;AAKO,SAAS,MAAM,SAAgC;AACpD,SAAO,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,UAAU,GAAI,CAAC;AACrE;","names":[]}

package/dist/chunk-JMSRJ43G.js

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+import {
+  readFileWithGrace,
+  runPhaseWithRetry
+} from "./chunk-3ULIAC2J.js";
+import {
+  isTransientFailure
+} from "./chunk-HDV3YDTG.js";
+import {
+  runHeadless
+} from "./chunk-KLBAHTXX.js";
+import {
+  applyPlaceholders,
+  loadPrompt
+} from "./chunk-SLHZPB3C.js";
+import {
+  getGlobalTimeout,
+  loadTaskPlan,
+  printError,
+  printSuccess,
+  saveTaskPlan
+} from "./chunk-O5XI2CFF.js";
+
+// src/commands/prd.ts
+import { mkdir } from "fs/promises";
+import { join } from "path";
+async function runPrd(issue) {
+  const issueNumber = issue.replace(/^#/, "");
+  const issueDir = join("issues", issueNumber);
+  const prdPath = join(issueDir, "prd.md");
+  await mkdir(issueDir, { recursive: true });
+  const template = await loadPrompt("prd");
+  const prompt = applyPlaceholders(template, {
+    __ISSUE_NUMBER__: issueNumber,
+    __PRD_PATH__: prdPath
+  });
+  const outcome = await runPhaseWithRetry({
+    phase: "prd",
+    attempt: async () => {
+      const result = await runHeadless({
+        prompt,
+        maxTurns: 25,
+        timeout: getGlobalTimeout() ?? 3e5,
+        outputFormat: "text",
+        allowedTools: ["Bash", "Read", "Glob", "Grep", "Write"],
+        statusMessage: `Generating PRD for issue #${issueNumber}...`
+      });
+      if (!result.success) {
+        return {
+          ok: false,
+          transient: isTransientFailure(1, result.error ?? ""),
+          error: `PRD generation failed: ${result.error}`
+        };
+      }
+      try {
+        const content = await readFileWithGrace(prdPath);
+        if (content.length < 10) {
+          return { ok: false, transient: true, error: "PRD file was created but appears empty" };
+        }
+      } catch {
+        return { ok: false, transient: true, error: `PRD file was not created at ${prdPath}` };
+      }
+      return { ok: true };
+    }
+  });
+  if (!outcome.ok) {
+    printError(outcome.error ?? `PRD generation failed for issue #${issueNumber}`);
+    return 1;
+  }
+  const tasksPath = join(issueDir, "tasks.json");
+  try {
+    const plan = await loadTaskPlan(tasksPath);
+    plan.pipeline.prdCompleted = true;
+    await saveTaskPlan(tasksPath, plan);
+  } catch {
+  }
+  printSuccess(`PRD saved to ${prdPath}`);
+  return 0;
+}
+
+export {
+  runPrd
+};
+//# sourceMappingURL=chunk-JMSRJ43G.js.map

package/dist/chunk-JMSRJ43G.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/prd.ts"],"sourcesContent":["import { mkdir } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { runHeadless } from '../core/headless.js';\nimport { readFileWithGrace, runPhaseWithRetry } from '../core/phase-runner.js';\nimport { applyPlaceholders, loadPrompt } from '../core/prompt-resolver.js';\nimport { loadTaskPlan, saveTaskPlan } from '../core/state-manager.js';\nimport { getGlobalTimeout } from '../core/verbose.js';\nimport { printError, printSuccess } from '../ui/logger.js';\nimport { isTransientFailure } from '../utils/retry.js';\n\nexport async function runPrd(issue: string): Promise<number> {\n  const issueNumber = issue.replace(/^#/, '');\n  const issueDir = join('issues', issueNumber);\n  const prdPath = join(issueDir, 'prd.md');\n\n  await mkdir(issueDir, { recursive: true });\n\n  const template = await loadPrompt('prd');\n  const prompt = applyPlaceholders(template, {\n    __ISSUE_NUMBER__: issueNumber,\n    __PRD_PATH__: prdPath,\n  });\n\n  const outcome = await runPhaseWithRetry({\n    phase: 'prd',\n    attempt: async () => {\n      const result = await runHeadless({\n        prompt,\n        maxTurns: 25,\n        timeout: getGlobalTimeout() ?? 300_000,\n        outputFormat: 'text',\n        allowedTools: ['Bash', 'Read', 'Glob', 'Grep', 'Write'],\n        statusMessage: `Generating PRD for issue #${issueNumber}...`,\n      });\n\n      if (!result.success) {\n        return {\n          ok: false,\n          transient: isTransientFailure(1, result.error ?? ''),\n          error: `PRD generation failed: ${result.error}`,\n        };\n      }\n\n      // Verify the file was created. A brief grace period absorbs a lag\n      // between the Write tool completing and this process seeing it; if it\n      // still isn't there, treat it as recoverable and let the phase retry.\n      try {\n        const content = await readFileWithGrace(prdPath);\n        if (content.length < 10) {\n          return { ok: false, transient: true, error: 'PRD file was created but appears empty' };\n        }\n      } catch {\n        return { ok: false, transient: true, error: `PRD file was not created at ${prdPath}` };\n      }\n\n      return { ok: true };\n    },\n  });\n\n  if (!outcome.ok) {\n    printError(outcome.error ?? `PRD generation failed for issue #${issueNumber}`);\n    return 1;\n  }\n\n  // Update pipeline state\n  const tasksPath = join(issueDir, 'tasks.json');\n  try {\n    const plan = await loadTaskPlan(tasksPath);\n    plan.pipeline.prdCompleted = true;\n    await saveTaskPlan(tasksPath, plan);\n  } catch {\n    // tasks.json may not exist yet\n  }\n\n  printSuccess(`PRD saved to ${prdPath}`);\n  return 0;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,aAAa;AACtB,SAAS,YAAY;AASrB,eAAsB,OAAO,OAAgC;AAC3D,QAAM,cAAc,MAAM,QAAQ,MAAM,EAAE;AAC1C,QAAM,WAAW,KAAK,UAAU,WAAW;AAC3C,QAAM,UAAU,KAAK,UAAU,QAAQ;AAEvC,QAAM,MAAM,UAAU,EAAE,WAAW,KAAK,CAAC;AAEzC,QAAM,WAAW,MAAM,WAAW,KAAK;AACvC,QAAM,SAAS,kBAAkB,UAAU;AAAA,IACzC,kBAAkB;AAAA,IAClB,cAAc;AAAA,EAChB,CAAC;AAED,QAAM,UAAU,MAAM,kBAAkB;AAAA,IACtC,OAAO;AAAA,IACP,SAAS,YAAY;AACnB,YAAM,SAAS,MAAM,YAAY;AAAA,QAC/B;AAAA,QACA,UAAU;AAAA,QACV,SAAS,iBAAiB,KAAK;AAAA,QAC/B,cAAc;AAAA,QACd,cAAc,CAAC,QAAQ,QAAQ,QAAQ,QAAQ,OAAO;AAAA,QACtD,eAAe,6BAA6B,WAAW;AAAA,MACzD,CAAC;AAED,UAAI,CAAC,OAAO,SAAS;AACnB,eAAO;AAAA,UACL,IAAI;AAAA,UACJ,WAAW,mBAAmB,GAAG,OAAO,SAAS,EAAE;AAAA,UACnD,OAAO,0BAA0B,OAAO,KAAK;AAAA,QAC/C;AAAA,MACF;AAKA,UAAI;AACF,cAAM,UAAU,MAAM,kBAAkB,OAAO;AAC/C,YAAI,QAAQ,SAAS,IAAI;AACvB,iBAAO,EAAE,IAAI,OAAO,WAAW,MAAM,OAAO,yCAAyC;AAAA,QACvF;AAAA,MACF,QAAQ;AACN,eAAO,EAAE,IAAI,OAAO,WAAW,MAAM,OAAO,+BAA+B,OAAO,GAAG;AAAA,MACvF;AAEA,aAAO,EAAE,IAAI,KAAK;AAAA,IACpB;AAAA,EACF,CAAC;AAED,MAAI,CAAC,QAAQ,IAAI;AACf,eAAW,QAAQ,SAAS,oCAAoC,WAAW,EAAE;AAC7E,WAAO;AAAA,EACT;AAGA,QAAM,YAAY,KAAK,UAAU,YAAY;AAC7C,MAAI;AACF,UAAM,OAAO,MAAM,aAAa,SAAS;AACzC,SAAK,SAAS,eAAe;AAC7B,UAAM,aAAa,WAAW,IAAI;AAAA,EACpC,QAAQ;AAAA,EAER;AAEA,eAAa,gBAAgB,OAAO,EAAE;AACtC,SAAO;AACT;","names":[]}

package/dist/{chunk-2XWXVWVD.js → chunk-KLBAHTXX.js}

@@ -9,7 +9,7 @@ import {
   isVerbose,
   isoNow,
   useColor
-} from "./chunk-FNLXZXWP.js";
+} from "./chunk-O5XI2CFF.js";
 
 // src/core/headless.ts
 import { createInterface } from "readline";
@@ -280,4 +280,4 @@ async function runHeadless(options) {
 export {
   runHeadless
 };
-//# sourceMappingURL=chunk-2XWXVWVD.js.map
+//# sourceMappingURL=chunk-KLBAHTXX.js.map

package/dist/chunk-KMX3DUJN.js

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+import {
+  readFileWithGrace,
+  runPhaseWithRetry
+} from "./chunk-3ULIAC2J.js";
+import {
+  isTransientFailure
+} from "./chunk-HDV3YDTG.js";
+import {
+  runHeadless
+} from "./chunk-KLBAHTXX.js";
+import {
+  applyPlaceholders,
+  loadPrompt
+} from "./chunk-SLHZPB3C.js";
+import {
+  getGlobalTimeout,
+  loadTaskPlan,
+  printError,
+  printSuccess,
+  saveTaskPlan,
+  taskPlanSchema
+} from "./chunk-O5XI2CFF.js";
+
+// src/commands/plan.ts
+import { mkdir, readFile } from "fs/promises";
+import { join } from "path";
+async function runPlan(issue) {
+  const issueNumber = issue.replace(/^#/, "");
+  const issueDir = join("issues", issueNumber);
+  const prdPath = join(issueDir, "prd.md");
+  let prdContent;
+  try {
+    prdContent = await readFile(prdPath, "utf-8");
+  } catch {
+    printError(`PRD not found at ${prdPath}. Run 'issue-flow prd ${issueNumber}' first.`);
+    return 1;
+  }
+  const tasksPath = join(issueDir, "tasks.json");
+  const template = await loadPrompt("plan");
+  const prompt = applyPlaceholders(template, {
+    __ISSUE_NUMBER__: issueNumber,
+    __PRD_CONTENT__: prdContent,
+    __TASKS_PATH__: tasksPath
+  });
+  await mkdir(issueDir, { recursive: true });
+  const outcome = await runPhaseWithRetry({
+    phase: "plan",
+    attempt: async () => {
+      const result = await runHeadless({
+        prompt,
+        maxTurns: 25,
+        timeout: getGlobalTimeout() ?? 3e5,
+        outputFormat: "text",
+        allowedTools: ["Bash", "Read", "Glob", "Grep", "Write"],
+        statusMessage: `Converting PRD to task plan for issue #${issueNumber}...`
+      });
+      if (!result.success) {
+        return {
+          ok: false,
+          transient: isTransientFailure(1, result.error ?? ""),
+          error: `Task plan generation failed: ${result.error}`
+        };
+      }
+      let rawContent;
+      try {
+        rawContent = await readFileWithGrace(tasksPath);
+      } catch {
+        return { ok: false, transient: true, error: `tasks.json was not created at ${tasksPath}` };
+      }
+      let parsed;
+      try {
+        parsed = JSON.parse(rawContent);
+      } catch {
+        return { ok: false, transient: true, error: "tasks.json contains invalid JSON" };
+      }
+      const validation = taskPlanSchema.safeParse(parsed);
+      if (!validation.success) {
+        const issues = validation.error.issues.map((i) => `  - ${i.path.join(".")}: ${i.message}`).join("\n");
+        return {
+          ok: false,
+          transient: true,
+          error: `tasks.json does not match expected schema:
+${issues}`
+        };
+      }
+      return { ok: true };
+    }
+  });
+  if (!outcome.ok) {
+    printError(outcome.error ?? `Task plan generation failed for issue #${issueNumber}`);
+    return 1;
+  }
+  const plan = await loadTaskPlan(tasksPath);
+  plan.pipeline.jsonCompleted = true;
+  await saveTaskPlan(tasksPath, plan);
+  printSuccess(`Task plan saved to ${tasksPath} (${plan.userStories.length} stories)`);
+  return 0;
+}
+
+export {
+  runPlan
+};
+//# sourceMappingURL=chunk-KMX3DUJN.js.map

package/dist/chunk-KMX3DUJN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/plan.ts"],"sourcesContent":["import { mkdir, readFile } from 'node:fs/promises';\nimport { join } from 'node:path';\nimport { runHeadless } from '../core/headless.js';\nimport { readFileWithGrace, runPhaseWithRetry } from '../core/phase-runner.js';\nimport { applyPlaceholders, loadPrompt } from '../core/prompt-resolver.js';\nimport { loadTaskPlan, saveTaskPlan } from '../core/state-manager.js';\nimport { getGlobalTimeout } from '../core/verbose.js';\nimport { taskPlanSchema } from '../schemas.js';\nimport { printError, printSuccess } from '../ui/logger.js';\nimport { isTransientFailure } from '../utils/retry.js';\n\nexport async function runPlan(issue: string): Promise<number> {\n  const issueNumber = issue.replace(/^#/, '');\n  const issueDir = join('issues', issueNumber);\n\n  // Read the PRD\n  const prdPath = join(issueDir, 'prd.md');\n  let prdContent: string;\n  try {\n    prdContent = await readFile(prdPath, 'utf-8');\n  } catch {\n    printError(`PRD not found at ${prdPath}. Run 'issue-flow prd ${issueNumber}' first.`);\n    return 1;\n  }\n\n  const tasksPath = join(issueDir, 'tasks.json');\n\n  const template = await loadPrompt('plan');\n  const prompt = applyPlaceholders(template, {\n    __ISSUE_NUMBER__: issueNumber,\n    __PRD_CONTENT__: prdContent,\n    __TASKS_PATH__: tasksPath,\n  });\n\n  await mkdir(issueDir, { recursive: true });\n\n  const outcome = await runPhaseWithRetry({\n    phase: 'plan',\n    attempt: async () => {\n      const result = await runHeadless({\n        prompt,\n        maxTurns: 25,\n        timeout: getGlobalTimeout() ?? 300_000,\n        outputFormat: 'text',\n        allowedTools: ['Bash', 'Read', 'Glob', 'Grep', 'Write'],\n        statusMessage: `Converting PRD to task plan for issue #${issueNumber}...`,\n      });\n\n      if (!result.success) {\n        return {\n          ok: false,\n          transient: isTransientFailure(1, result.error ?? ''),\n          error: `Task plan generation failed: ${result.error}`,\n        };\n      }\n\n      // Verify the file was created, tolerating a brief FS-visibility lag.\n      let rawContent: string;\n      try {\n        rawContent = await readFileWithGrace(tasksPath);\n      } catch {\n        return { ok: false, transient: true, error: `tasks.json was not created at ${tasksPath}` };\n      }\n\n      // Validate JSON structure — a content defect, not a timing issue, but\n      // still worth a bounded retry since it's a fresh Claude invocation.\n      let parsed: unknown;\n      try {\n        parsed = JSON.parse(rawContent);\n      } catch {\n        return { ok: false, transient: true, error: 'tasks.json contains invalid JSON' };\n      }\n\n      // Validate with zod schema\n      const validation = taskPlanSchema.safeParse(parsed);\n      if (!validation.success) {\n        const issues = validation.error.issues\n          .map((i) => `  - ${i.path.join('.')}: ${i.message}`)\n          .join('\\n');\n        return {\n          ok: false,\n          transient: true,\n          error: `tasks.json does not match expected schema:\\n${issues}`,\n        };\n      }\n\n      return { ok: true };\n    },\n  });\n\n  if (!outcome.ok) {\n    printError(outcome.error ?? `Task plan generation failed for issue #${issueNumber}`);\n    return 1;\n  }\n\n  // Ensure pipeline state reflects completion of this phase\n  const plan = await loadTaskPlan(tasksPath);\n  plan.pipeline.jsonCompleted = true;\n  await saveTaskPlan(tasksPath, plan);\n\n  printSuccess(`Task plan saved to ${tasksPath} (${plan.userStories.length} stories)`);\n  return 0;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,OAAO,gBAAgB;AAChC,SAAS,YAAY;AAUrB,eAAsB,QAAQ,OAAgC;AAC5D,QAAM,cAAc,MAAM,QAAQ,MAAM,EAAE;AAC1C,QAAM,WAAW,KAAK,UAAU,WAAW;AAG3C,QAAM,UAAU,KAAK,UAAU,QAAQ;AACvC,MAAI;AACJ,MAAI;AACF,iBAAa,MAAM,SAAS,SAAS,OAAO;AAAA,EAC9C,QAAQ;AACN,eAAW,oBAAoB,OAAO,yBAAyB,WAAW,UAAU;AACpF,WAAO;AAAA,EACT;AAEA,QAAM,YAAY,KAAK,UAAU,YAAY;AAE7C,QAAM,WAAW,MAAM,WAAW,MAAM;AACxC,QAAM,SAAS,kBAAkB,UAAU;AAAA,IACzC,kBAAkB;AAAA,IAClB,iBAAiB;AAAA,IACjB,gBAAgB;AAAA,EAClB,CAAC;AAED,QAAM,MAAM,UAAU,EAAE,WAAW,KAAK,CAAC;AAEzC,QAAM,UAAU,MAAM,kBAAkB;AAAA,IACtC,OAAO;AAAA,IACP,SAAS,YAAY;AACnB,YAAM,SAAS,MAAM,YAAY;AAAA,QAC/B;AAAA,QACA,UAAU;AAAA,QACV,SAAS,iBAAiB,KAAK;AAAA,QAC/B,cAAc;AAAA,QACd,cAAc,CAAC,QAAQ,QAAQ,QAAQ,QAAQ,OAAO;AAAA,QACtD,eAAe,0CAA0C,WAAW;AAAA,MACtE,CAAC;AAED,UAAI,CAAC,OAAO,SAAS;AACnB,eAAO;AAAA,UACL,IAAI;AAAA,UACJ,WAAW,mBAAmB,GAAG,OAAO,SAAS,EAAE;AAAA,UACnD,OAAO,gCAAgC,OAAO,KAAK;AAAA,QACrD;AAAA,MACF;AAGA,UAAI;AACJ,UAAI;AACF,qBAAa,MAAM,kBAAkB,SAAS;AAAA,MAChD,QAAQ;AACN,eAAO,EAAE,IAAI,OAAO,WAAW,MAAM,OAAO,iCAAiC,SAAS,GAAG;AAAA,MAC3F;AAIA,UAAI;AACJ,UAAI;AACF,iBAAS,KAAK,MAAM,UAAU;AAAA,MAChC,QAAQ;AACN,eAAO,EAAE,IAAI,OAAO,WAAW,MAAM,OAAO,mCAAmC;AAAA,MACjF;AAGA,YAAM,aAAa,eAAe,UAAU,MAAM;AAClD,UAAI,CAAC,WAAW,SAAS;AACvB,cAAM,SAAS,WAAW,MAAM,OAC7B,IAAI,CAAC,MAAM,OAAO,EAAE,KAAK,KAAK,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,EAClD,KAAK,IAAI;AACZ,eAAO;AAAA,UACL,IAAI;AAAA,UACJ,WAAW;AAAA,UACX,OAAO;AAAA,EAA+C,MAAM;AAAA,QAC9D;AAAA,MACF;AAEA,aAAO,EAAE,IAAI,KAAK;AAAA,IACpB;AAAA,EACF,CAAC;AAED,MAAI,CAAC,QAAQ,IAAI;AACf,eAAW,QAAQ,SAAS,0CAA0C,WAAW,EAAE;AACnF,WAAO;AAAA,EACT;AAGA,QAAM,OAAO,MAAM,aAAa,SAAS;AACzC,OAAK,SAAS,gBAAgB;AAC9B,QAAM,aAAa,WAAW,IAAI;AAElC,eAAa,sBAAsB,SAAS,KAAK,KAAK,YAAY,MAAM,WAAW;AACnF,SAAO;AACT;","names":[]}

package/dist/{chunk-MKQIP7YW.js → chunk-LJI45O5B.js}

@@ -1,7 +1,13 @@
 #!/usr/bin/env node
+import {
+  runPhaseWithRetry
+} from "./chunk-3ULIAC2J.js";
+import {
+  isTransientFailure
+} from "./chunk-HDV3YDTG.js";
 import {
   runHeadless
-} from "./chunk-2XWXVWVD.js";
+} from "./chunk-KLBAHTXX.js";
 import {
   applyPlaceholders,
   loadPrompt
@@ -12,7 +18,7 @@ import {
   printError,
   printSuccess,
   saveTaskPlan
-} from "./chunk-FNLXZXWP.js";
+} from "./chunk-O5XI2CFF.js";
 
 // src/commands/pr.ts
 import { join } from "path";
@@ -43,19 +49,34 @@ async function runPr(issue) {
     __BRANCH_NAME__: branchName,
     __TASKS_PATH__: tasksPath
   });
-  const result = await runHeadless({
-    prompt,
-    maxTurns: 15,
-    timeout: getGlobalTimeout() ?? 3e5,
-    outputFormat: "text",
-    allowedTools: ["Bash", "Read", "Glob", "Grep"],
-    statusMessage: `Creating PR for issue #${issueNumber}...`
+  let headlessOutput = "";
+  const outcome = await runPhaseWithRetry({
+    phase: "pr",
+    attempt: async () => {
+      const result = await runHeadless({
+        prompt,
+        maxTurns: 15,
+        timeout: getGlobalTimeout() ?? 3e5,
+        outputFormat: "text",
+        allowedTools: ["Bash", "Read", "Glob", "Grep"],
+        statusMessage: `Creating PR for issue #${issueNumber}...`
+      });
+      if (!result.success) {
+        return {
+          ok: false,
+          transient: isTransientFailure(1, result.error ?? ""),
+          error: `PR creation failed: ${result.error}`
+        };
+      }
+      headlessOutput = result.result;
+      return { ok: true };
+    }
   });
-  if (!result.success) {
-    printError(`PR creation failed: ${result.error}`);
+  if (!outcome.ok) {
+    printError(outcome.error ?? `PR creation failed for issue #${issueNumber}`);
     return 1;
   }
-  const prUrl = parsePrUrl(result.result);
+  const prUrl = parsePrUrl(headlessOutput);
   try {
     const plan = await loadTaskPlan(tasksPath);
     plan.pipeline.prCreated = true;
@@ -73,4 +94,4 @@ async function runPr(issue) {
 export {
   runPr
 };
-//# sourceMappingURL=chunk-MKQIP7YW.js.map
+//# sourceMappingURL=chunk-LJI45O5B.js.map