issue-flow 0.5.1 → 0.6.0

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-VVG7UABS.js}

@@ -1,11 +1,14 @@
 #!/usr/bin/env node
 import {
+  issuePlaceholders,
+  resolveCommandIssue,
   runHeadless
-} from "./chunk-2XWXVWVD.js";
+} from "./chunk-SVOWWZQJ.js";
 import {
   applyPlaceholders,
   loadPrompt
 } from "./chunk-SLHZPB3C.js";
+import "./chunk-4HT4EVYV.js";
 import {
   getGlobalTimeout,
   loadTaskPlan,
@@ -13,20 +16,27 @@ import {
   printInfo,
   printSuccess,
   saveTaskPlan
-} from "./chunk-FNLXZXWP.js";
+} from "./chunk-WZDCTAWZ.js";
 
 // src/commands/analyze.ts
 import { mkdir, readFile, writeFile } from "fs/promises";
 import { join } from "path";
-async function runAnalyze(issue) {
+async function runAnalyze(issue, resolvedIssue) {
   const issueNumber = issue.replace(/^#/, "");
   const issueDir = join("issues", issueNumber);
   const analysisPath = join(issueDir, "analysis.md");
+  const resolution = await resolveCommandIssue(issueNumber, resolvedIssue);
+  if (!resolution.ok) {
+    return resolution.code;
+  }
   await mkdir(issueDir, { recursive: true });
   const template = await loadPrompt("analyze");
   const prompt = applyPlaceholders(template, {
     __ISSUE_NUMBER__: issueNumber,
-    __ANALYSIS_PATH__: analysisPath
+    __ANALYSIS_PATH__: analysisPath,
+    // Last: the Issue content is substituted in but never scanned again, so a
+    // body that happens to contain a placeholder is left untouched.
+    ...issuePlaceholders(resolution.resolved)
   });
   const result = await runHeadless({
     prompt,
@@ -63,4 +73,4 @@ async function runAnalyze(issue) {
 export {
   runAnalyze
 };
-//# sourceMappingURL=analyze-IJ2SYXVM.js.map
+//# sourceMappingURL=analyze-VVG7UABS.js.map

package/dist/analyze-VVG7UABS.js.map

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

package/dist/chunk-2CSHLHYP.js

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+import {
+  retryDelaySeconds,
+  sleep
+} from "./chunk-HDV3YDTG.js";
+import {
+  getSessionPublisher,
+  isoNow,
+  printRetry
+} from "./chunk-WZDCTAWZ.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-2CSHLHYP.js.map

package/dist/chunk-2CSHLHYP.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-TYOFZ6DD.js → chunk-4HT4EVYV.js}

@@ -1,8 +1,9 @@
 #!/usr/bin/env node
 import {
+  issuesConfigSchema,
   printWarning,
   webConfigSchema
-} from "./chunk-FNLXZXWP.js";
+} from "./chunk-WZDCTAWZ.js";
 
 // src/config.ts
 import { readFile } from "fs/promises";
@@ -126,7 +127,37 @@ async function validateDependencies() {
   }
   return errors;
 }
-var WEB_CONFIG_FILENAME = ".issue-flow.json";
+var PROJECT_CONFIG_FILENAME = ".issue-flow.json";
+var WEB_CONFIG_FILENAME = PROJECT_CONFIG_FILENAME;
+async function readProjectConfigFile(projectRoot, warn) {
+  let root = projectRoot;
+  if (root === void 0) {
+    try {
+      root = await getProjectRoot();
+    } catch {
+      return null;
+    }
+  }
+  const filePath = join(root, PROJECT_CONFIG_FILENAME);
+  let raw;
+  try {
+    raw = await readFile(filePath, "utf-8");
+  } catch {
+    return null;
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    warn(`Ignoring ${PROJECT_CONFIG_FILENAME}: invalid JSON.`);
+    return null;
+  }
+  if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+    warn(`Ignoring ${PROJECT_CONFIG_FILENAME}: expected a JSON object.`);
+    return null;
+  }
+  return parsed;
+}
 var webCliOverrides = {};
 function setWebCliOverrides(overrides) {
   webCliOverrides = overrides;
@@ -170,40 +201,15 @@ function readWebConfigEnv(env, warn) {
   return layer;
 }
 async function readWebConfigFile(projectRoot, warn) {
-  let root = projectRoot;
-  if (root === void 0) {
-    try {
-      root = await getProjectRoot();
-    } catch {
-      return {};
-    }
-  }
-  const filePath = join(root, WEB_CONFIG_FILENAME);
-  let raw;
-  try {
-    raw = await readFile(filePath, "utf-8");
-  } catch {
-    return {};
-  }
-  let parsed;
-  try {
-    parsed = JSON.parse(raw);
-  } catch {
-    warn(`Ignoring ${WEB_CONFIG_FILENAME}: invalid JSON.`);
-    return {};
-  }
-  if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-    warn(`Ignoring ${WEB_CONFIG_FILENAME}: expected a JSON object.`);
-    return {};
-  }
-  const web = parsed.web;
+  const file = await readProjectConfigFile(projectRoot, warn);
+  const web = file?.web;
   if (web === void 0) {
     return {};
   }
   const result = webConfigSchema.partial().safeParse(web);
   if (!result.success) {
     warn(
-      `Ignoring "web" key of ${WEB_CONFIG_FILENAME}: ${result.error.issues[0]?.message ?? "invalid value"}.`
+      `Ignoring "web" key of ${PROJECT_CONFIG_FILENAME}: ${result.error.issues[0]?.message ?? "invalid value"}.`
     );
     return {};
   }
@@ -225,16 +231,56 @@ async function loadWebConfig(options = {}) {
   );
   return webConfigSchema.parse({});
 }
+var issuesCliOverrides = {};
+function setIssuesCliOverrides(overrides) {
+  issuesCliOverrides = overrides;
+}
+async function readIssuesConfigFile(projectRoot, warn) {
+  const file = await readProjectConfigFile(projectRoot, warn);
+  const issues = file?.issues;
+  if (issues === void 0) {
+    return {};
+  }
+  const result = issuesConfigSchema.partial().safeParse(issues);
+  if (!result.success) {
+    warn(
+      `Ignoring "issues" key of ${PROJECT_CONFIG_FILENAME}: ${result.error.issues[0]?.message ?? "invalid value"}.`
+    );
+    return {};
+  }
+  return result.data;
+}
+async function loadIssuesConfig(options = {}) {
+  const warn = options.warn ?? printWarning;
+  const cli = options.cli ?? issuesCliOverrides;
+  const fileLayer = await readIssuesConfigFile(options.projectRoot, warn);
+  const merged = { ...fileLayer, ...cli };
+  const result = issuesConfigSchema.safeParse(merged);
+  if (result.success) {
+    return result.data;
+  }
+  warn(
+    `Invalid Issue provider configuration (${result.error.issues[0]?.message ?? "invalid value"}); using defaults.`
+  );
+  return issuesConfigSchema.parse({});
+}
 
 export {
   run,
+  getProjectRoot,
   getCurrentBranch,
   getBaseBranch,
   getCommitsSince,
+  DEFAULTS,
   createConfig,
   resolvePaths,
+  getInstallHint,
   validateDependencies,
+  PROJECT_CONFIG_FILENAME,
+  WEB_CONFIG_FILENAME,
   setWebCliOverrides,
-  loadWebConfig
+  loadWebConfig,
+  setIssuesCliOverrides,
+  loadIssuesConfig
 };
-//# sourceMappingURL=chunk-TYOFZ6DD.js.map
+//# sourceMappingURL=chunk-4HT4EVYV.js.map

package/dist/chunk-4HT4EVYV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config.ts","../src/utils/shell.ts","../src/utils/git.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { platform } from 'node:os';\nimport { join } from 'node:path';\nimport type { IssuesConfig } from './issues/types.js';\nimport { issuesConfigSchema, type WebConfig, webConfigSchema } from './schemas.js';\nimport type { EngineConfig, ResolvedPaths } from './types.js';\nimport { printWarning } from './ui/logger.js';\nimport { getProjectRoot } from './utils/git.js';\nimport { run } from './utils/shell.js';\n\n/**\n * Default configuration values — matching the Bash script exactly.\n */\nexport const DEFAULTS = {\n  retryLimit: 10,\n  retryForever: false,\n  backoffBaseSeconds: 30,\n  backoffMaxSeconds: 900,\n} as const;\n\n/**\n * Create a EngineConfig with defaults merged with provided options.\n */\nexport function createConfig(options: Partial<EngineConfig>): EngineConfig {\n  return {\n    issueNumber: options.issueNumber,\n    maxIterations: options.maxIterations,\n    retryLimit: options.retryLimit ?? DEFAULTS.retryLimit,\n    retryForever: options.retryForever ?? DEFAULTS.retryForever,\n    backoffBaseSeconds: options.backoffBaseSeconds ?? DEFAULTS.backoffBaseSeconds,\n    backoffMaxSeconds: options.backoffMaxSeconds ?? DEFAULTS.backoffMaxSeconds,\n  };\n}\n\n/**\n * Resolve file paths based on issue number and project root.\n *\n * With --issue N:\n *   prdFile = {projectRoot}/issues/{N}/tasks.json\n *   progressFile = {projectRoot}/issues/{N}/progress.txt\n *\n * Standalone:\n *   prdFile = {projectRoot}/prd.json\n *   progressFile = {projectRoot}/progress.txt\n */\nexport async function resolvePaths(\n  config: EngineConfig,\n  scriptDir?: string,\n): Promise<ResolvedPaths> {\n  const projectRoot = await getProjectRoot();\n\n  if (config.issueNumber) {\n    const issueDir = join(projectRoot, 'issues', config.issueNumber);\n    return {\n      prdFile: join(issueDir, 'tasks.json'),\n      progressFile: join(issueDir, 'progress.txt'),\n      archiveDir: join(issueDir, 'archive'),\n      lastBranchFile: join(issueDir, '.last-branch'),\n      projectRoot,\n    };\n  }\n\n  // Standalone mode — use scriptDir if available, otherwise projectRoot\n  const base = scriptDir ?? projectRoot;\n  return {\n    prdFile: join(base, 'prd.json'),\n    progressFile: join(base, 'progress.txt'),\n    archiveDir: join(base, 'archive'),\n    lastBranchFile: join(base, '.last-branch'),\n    projectRoot,\n  };\n}\n\n/**\n * Return a platform-appropriate install hint for a given package.\n */\nexport function getInstallHint(pkg: string): string {\n  const os = platform();\n\n  if (os === 'darwin') {\n    return `brew install ${pkg}`;\n  }\n  if (os === 'linux') {\n    return `apt install ${pkg}  (or your distro's package manager)`;\n  }\n  if (os === 'win32') {\n    return `winget install ${pkg}  (or choco install ${pkg})`;\n  }\n\n  return `install ${pkg} using your system package manager`;\n}\n\n/**\n * Validate that required external dependencies are available.\n * Returns an array of error messages (empty if all deps are found).\n */\nexport async function validateDependencies(): Promise<string[]> {\n  const errors: string[] = [];\n\n  // Check git\n  const gitResult = await run('git', ['--version']);\n  if (gitResult.exitCode !== 0) {\n    errors.push(`  - git  (install with: ${getInstallHint('git')})`);\n  }\n\n  // Check claude\n  const claudeResult = await run('claude', ['--version']);\n  if (claudeResult.exitCode !== 0) {\n    errors.push('  - claude  (install with: npm install -g @anthropic-ai/claude-code)');\n  }\n\n  // Note: jq is NOT required — the TypeScript CLI handles JSON natively\n\n  return errors;\n}\n\n// ── Per-project configuration file ──────────────────────────────────────────\n\n/** Optional per-project configuration file, read from the project root. */\nexport const PROJECT_CONFIG_FILENAME = '.issue-flow.json';\n\n/** Historical alias kept for the web monitoring call sites. */\nexport const WEB_CONFIG_FILENAME = PROJECT_CONFIG_FILENAME;\n\n/**\n * Read and parse .issue-flow.json from the project root.\n *\n * Never throws: an absent file, unreadable path, invalid JSON or a non-object\n * root all degrade to `null` (with a warning for the malformed cases), so every\n * consumer falls back to its own defaults.\n */\nasync function readProjectConfigFile(\n  projectRoot: string | undefined,\n  warn: (message: string) => void,\n): Promise<Record<string, unknown> | null> {\n  let root = projectRoot;\n  if (root === undefined) {\n    try {\n      root = await getProjectRoot();\n    } catch {\n      return null;\n    }\n  }\n\n  const filePath = join(root, PROJECT_CONFIG_FILENAME);\n  let raw: string;\n  try {\n    raw = await readFile(filePath, 'utf-8');\n  } catch {\n    // The file is entirely optional — absence is the common case.\n    return null;\n  }\n\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw);\n  } catch {\n    warn(`Ignoring ${PROJECT_CONFIG_FILENAME}: invalid JSON.`);\n    return null;\n  }\n\n  if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {\n    warn(`Ignoring ${PROJECT_CONFIG_FILENAME}: expected a JSON object.`);\n    return null;\n  }\n\n  return parsed as Record<string, unknown>;\n}\n\n// ── Web monitoring configuration ────────────────────────────────────────────\n\n/**\n * CLI overrides captured by the preAction hook in cli.ts. Highest-precedence\n * source consumed by loadWebConfig().\n */\nlet webCliOverrides: Partial<WebConfig> = {};\n\nexport function setWebCliOverrides(overrides: Partial<WebConfig>): void {\n  webCliOverrides = overrides;\n}\n\nexport interface LoadWebConfigOptions {\n  /** CLI flag overrides. Defaults to the values set via setWebCliOverrides(). */\n  cli?: Partial<WebConfig>;\n  /** Environment source. Defaults to process.env. */\n  env?: NodeJS.ProcessEnv;\n  /** Directory containing .issue-flow.json. Defaults to the git project root. */\n  projectRoot?: string;\n  /** Warning sink. Defaults to printWarning. */\n  warn?: (message: string) => void;\n}\n\nconst FALSY_ENV_VALUES = new Set(['', '0', 'false', 'no', 'off']);\n\nfunction parseBooleanEnv(value: string): boolean {\n  return !FALSY_ENV_VALUES.has(value.trim().toLowerCase());\n}\n\nfunction readNumberEnv(\n  env: NodeJS.ProcessEnv,\n  name: string,\n  warn: (message: string) => void,\n): number | undefined {\n  const raw = env[name];\n  if (raw === undefined) {\n    return undefined;\n  }\n  const parsed = Number(raw);\n  if (!Number.isFinite(parsed)) {\n    warn(`Ignoring ${name}=\"${raw}\": not a number.`);\n    return undefined;\n  }\n  return parsed;\n}\n\nfunction readWebConfigEnv(\n  env: NodeJS.ProcessEnv,\n  warn: (message: string) => void,\n): Partial<WebConfig> {\n  const layer: Partial<WebConfig> = {};\n  if (env.ISSUE_FLOW_WEB !== undefined) {\n    layer.enabled = parseBooleanEnv(env.ISSUE_FLOW_WEB);\n  }\n  const port = readNumberEnv(env, 'ISSUE_FLOW_WEB_PORT', warn);\n  if (port !== undefined) {\n    layer.port = port;\n  }\n  if (env.ISSUE_FLOW_WEB_HOST !== undefined) {\n    layer.host = env.ISSUE_FLOW_WEB_HOST;\n  }\n  const refresh = readNumberEnv(env, 'ISSUE_FLOW_WEB_REFRESH', warn);\n  if (refresh !== undefined) {\n    layer.refreshSeconds = refresh;\n  }\n  const logLimit = readNumberEnv(env, 'ISSUE_FLOW_WEB_LOG_LIMIT', warn);\n  if (logLimit !== undefined) {\n    layer.logLimit = logLimit;\n  }\n  return layer;\n}\n\nasync function readWebConfigFile(\n  projectRoot: string | undefined,\n  warn: (message: string) => void,\n): Promise<Partial<WebConfig>> {\n  const file = await readProjectConfigFile(projectRoot, warn);\n  const web = file?.web;\n  if (web === undefined) {\n    return {};\n  }\n\n  const result = webConfigSchema.partial().safeParse(web);\n  if (!result.success) {\n    warn(\n      `Ignoring \"web\" key of ${PROJECT_CONFIG_FILENAME}: ${result.error.issues[0]?.message ?? 'invalid value'}.`,\n    );\n    return {};\n  }\n  return result.data;\n}\n\n/**\n * Resolve the web monitoring configuration with the documented precedence:\n * CLI flag > environment variable > .issue-flow.json > defaults.\n *\n * Never throws: missing or invalid sources degrade to the defaults with a\n * warning.\n */\nexport async function loadWebConfig(options: LoadWebConfigOptions = {}): Promise<WebConfig> {\n  const warn = options.warn ?? printWarning;\n  const cli = options.cli ?? webCliOverrides;\n  const env = options.env ?? process.env;\n\n  const fileLayer = await readWebConfigFile(options.projectRoot, warn);\n  const envLayer = readWebConfigEnv(env, warn);\n  const merged = { ...fileLayer, ...envLayer, ...cli };\n\n  const result = webConfigSchema.safeParse(merged);\n  if (result.success) {\n    return result.data;\n  }\n  warn(\n    `Invalid web monitoring configuration (${result.error.issues[0]?.message ?? 'invalid value'}); using defaults.`,\n  );\n  return webConfigSchema.parse({});\n}\n\n// ── Issue provider configuration ────────────────────────────────────────────\n\n/**\n * CLI overrides captured by the preAction hook in cli.ts (--local, --github,\n * --prefer-local, --prefer-github, --ask). Highest-precedence source consumed\n * by loadIssuesConfig().\n */\nlet issuesCliOverrides: Partial<IssuesConfig> = {};\n\nexport function setIssuesCliOverrides(overrides: Partial<IssuesConfig>): void {\n  issuesCliOverrides = overrides;\n}\n\nexport interface LoadIssuesConfigOptions {\n  /** CLI flag overrides. Defaults to the values set via setIssuesCliOverrides(). */\n  cli?: Partial<IssuesConfig>;\n  /** Directory containing .issue-flow.json. Defaults to the git project root. */\n  projectRoot?: string;\n  /** Warning sink. Defaults to printWarning. */\n  warn?: (message: string) => void;\n}\n\nasync function readIssuesConfigFile(\n  projectRoot: string | undefined,\n  warn: (message: string) => void,\n): Promise<Partial<IssuesConfig>> {\n  const file = await readProjectConfigFile(projectRoot, warn);\n  const issues = file?.issues;\n  if (issues === undefined) {\n    return {};\n  }\n\n  const result = issuesConfigSchema.partial().safeParse(issues);\n  if (!result.success) {\n    warn(\n      `Ignoring \"issues\" key of ${PROJECT_CONFIG_FILENAME}: ${result.error.issues[0]?.message ?? 'invalid value'}.`,\n    );\n    return {};\n  }\n  return result.data;\n}\n\n/**\n * Resolve the Issue provider configuration with the documented precedence:\n * CLI flag > .issue-flow.json > defaults.\n *\n * Never throws: missing or invalid sources degrade to the defaults with a\n * warning, and the defaults reproduce the GitHub-only behaviour.\n */\nexport async function loadIssuesConfig(\n  options: LoadIssuesConfigOptions = {},\n): Promise<IssuesConfig> {\n  const warn = options.warn ?? printWarning;\n  const cli = options.cli ?? issuesCliOverrides;\n\n  const fileLayer = await readIssuesConfigFile(options.projectRoot, warn);\n  const merged = { ...fileLayer, ...cli };\n\n  const result = issuesConfigSchema.safeParse(merged);\n  if (result.success) {\n    return result.data;\n  }\n  warn(\n    `Invalid Issue provider configuration (${result.error.issues[0]?.message ?? 'invalid value'}); using defaults.`,\n  );\n  return issuesConfigSchema.parse({});\n}\n","import { type Options as ExecaOptions, execa } from 'execa';\n\nexport interface ExecResult {\n  stdout: string;\n  stderr: string;\n  exitCode: number;\n}\n\n/**\n * Execute a command with arguments and capture its output.\n * Uses execa which calls execFile internally (no shell injection risk).\n * Does not throw on non-zero exit codes.\n */\nexport async function run(\n  command: string,\n  args: string[] = [],\n  options?: ExecaOptions,\n): Promise<ExecResult> {\n  const result = await execa(command, args, {\n    reject: false,\n    ...options,\n  });\n\n  return {\n    stdout: result.stdout?.toString() ?? '',\n    stderr: result.stderr?.toString() ?? '',\n    exitCode: result.exitCode ?? 1,\n  };\n}\n","import { run } from './shell.js';\n\n/**\n * Get the root directory of the current git repository.\n * Throws if not inside a git repository.\n */\nexport async function getProjectRoot(): Promise<string> {\n  const result = await run('git', ['rev-parse', '--show-toplevel']);\n\n  if (result.exitCode !== 0) {\n    throw new Error(\n      'Not inside a git repository. Please run issue-flow from within a git project.',\n    );\n  }\n\n  return result.stdout.trim();\n}\n\n/**\n * Get the current git branch name.\n * Returns an empty string if in detached HEAD state.\n */\nexport async function getCurrentBranch(): Promise<string> {\n  const result = await run('git', ['branch', '--show-current']);\n\n  if (result.exitCode !== 0) {\n    throw new Error(\n      'Failed to detect git branch. Ensure git is installed and you are inside a repository.',\n    );\n  }\n\n  return result.stdout.trim();\n}\n\nexport interface CommitInfo {\n  hash: string;\n  subject: string;\n}\n\n/**\n * Get the base branch of the repository: the remote HEAD (origin/HEAD) when\n * available, otherwise the first of main/master that exists locally.\n * Never throws; defaults to 'main'.\n */\nexport async function getBaseBranch(): Promise<string> {\n  const remoteHead = await run('git', ['symbolic-ref', '--short', 'refs/remotes/origin/HEAD']);\n  if (remoteHead.exitCode === 0) {\n    const name = remoteHead.stdout.trim().replace(/^origin\\//, '');\n    if (name) return name;\n  }\n\n  for (const candidate of ['main', 'master']) {\n    const check = await run('git', ['rev-parse', '--verify', '--quiet', `refs/heads/${candidate}`]);\n    if (check.exitCode === 0) return candidate;\n  }\n\n  return 'main';\n}\n\n/**\n * List commits on HEAD that are not on the given base branch (base..HEAD),\n * most recent first. Never throws; returns [] when the range cannot be\n * resolved (e.g. unknown base branch or shallow clone).\n */\nexport async function getCommitsSince(base: string): Promise<CommitInfo[]> {\n  const result = await run('git', ['log', '--pretty=format:%h%x09%s', `${base}..HEAD`]);\n  if (result.exitCode !== 0) return [];\n\n  return result.stdout\n    .split('\\n')\n    .filter((line) => line.trim() !== '')\n    .map((line) => {\n      const tab = line.indexOf('\\t');\n      return tab === -1\n        ? { hash: line.trim(), subject: '' }\n        : { hash: line.slice(0, tab), subject: line.slice(tab + 1) };\n    });\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-GYR4YHEB.js → chunk-7W5VGYXW.js}

@@ -1,4 +1,13 @@
 #!/usr/bin/env node
+import {
+  isTransientFailure,
+  retryDelaySeconds,
+  sleep
+} from "./chunk-HDV3YDTG.js";
+import {
+  applyPlaceholders,
+  loadPrompt
+} from "./chunk-SLHZPB3C.js";
 import {
   createConfig,
   getBaseBranch,
@@ -7,11 +16,7 @@ import {
   resolvePaths,
   run,
   validateDependencies
-} from "./chunk-TYOFZ6DD.js";
-import {
-  applyPlaceholders,
-  loadPrompt
-} from "./chunk-SLHZPB3C.js";
+} from "./chunk-4HT4EVYV.js";
 import {
   NullPublisher,
   allStoriesPass,
@@ -38,7 +43,7 @@ import {
   trimErrorMessage,
   useColor,
   useUnicode
-} from "./chunk-FNLXZXWP.js";
+} from "./chunk-WZDCTAWZ.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-7W5VGYXW.js.map

package/dist/chunk-7W5VGYXW.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-EHX4J5G5.js

@@ -0,0 +1,91 @@
+#!/usr/bin/env node
+import {
+  readFileWithGrace,
+  runPhaseWithRetry
+} from "./chunk-2CSHLHYP.js";
+import {
+  issuePlaceholders,
+  resolveCommandIssue,
+  runHeadless
+} from "./chunk-SVOWWZQJ.js";
+import {
+  isTransientFailure
+} from "./chunk-HDV3YDTG.js";
+import {
+  applyPlaceholders,
+  loadPrompt
+} from "./chunk-SLHZPB3C.js";
+import {
+  getGlobalTimeout,
+  loadTaskPlan,
+  printError,
+  printSuccess,
+  saveTaskPlan
+} from "./chunk-WZDCTAWZ.js";
+
+// src/commands/prd.ts
+import { mkdir } from "fs/promises";
+import { join } from "path";
+async function runPrd(issue, resolvedIssue) {
+  const issueNumber = issue.replace(/^#/, "");
+  const issueDir = join("issues", issueNumber);
+  const prdPath = join(issueDir, "prd.md");
+  const resolution = await resolveCommandIssue(issueNumber, resolvedIssue);
+  if (!resolution.ok) {
+    return resolution.code;
+  }
+  await mkdir(issueDir, { recursive: true });
+  const template = await loadPrompt("prd");
+  const prompt = applyPlaceholders(template, {
+    __ISSUE_NUMBER__: issueNumber,
+    __PRD_PATH__: prdPath,
+    ...issuePlaceholders(resolution.resolved)
+  });
+  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-EHX4J5G5.js.map

package/dist/chunk-EHX4J5G5.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 { issuePlaceholders, resolveCommandIssue } from '../issues/context.js';\nimport type { ResolvedIssue } from '../issues/types.js';\nimport { printError, printSuccess } from '../ui/logger.js';\nimport { isTransientFailure } from '../utils/retry.js';\n\nexport async function runPrd(issue: string, resolvedIssue?: ResolvedIssue): Promise<number> {\n  const issueNumber = issue.replace(/^#/, '');\n  const issueDir = join('issues', issueNumber);\n  const prdPath = join(issueDir, 'prd.md');\n\n  const resolution = await resolveCommandIssue(issueNumber, resolvedIssue);\n  if (!resolution.ok) {\n    return resolution.code;\n  }\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    ...issuePlaceholders(resolution.resolved),\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;AAWrB,eAAsB,OAAO,OAAe,eAAgD;AAC1F,QAAM,cAAc,MAAM,QAAQ,MAAM,EAAE;AAC1C,QAAM,WAAW,KAAK,UAAU,WAAW;AAC3C,QAAM,UAAU,KAAK,UAAU,QAAQ;AAEvC,QAAM,aAAa,MAAM,oBAAoB,aAAa,aAAa;AACvE,MAAI,CAAC,WAAW,IAAI;AAClB,WAAO,WAAW;AAAA,EACpB;AAEA,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,IACd,GAAG,kBAAkB,WAAW,QAAQ;AAAA,EAC1C,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":[]}