issue-flow 0.7.6 → 0.7.7

package/dist/{chunk-DWF46N65.js.map → chunk-6UTVPKNF.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/commands/pr.ts"],"sourcesContent":["import { execa } from 'execa';\nimport { runHeadless } from '../core/headless.js';\nimport { runPhaseWithRetry } from '../core/phase-runner.js';\nimport { applyPlaceholders, loadPrompt } from '../core/prompt-resolver.js';\nimport { publishPhaseMetrics } from '../core/session-metrics.js';\nimport { isoNow, loadTaskPlan, saveTaskPlan } from '../core/state-manager.js';\nimport { getGlobalTimeout } from '../core/verbose.js';\nimport { issuePlaceholders, resolveCommandIssue } from '../issues/context.js';\nimport type { Issue, ResolvedIssue } from '../issues/types.js';\nimport { resolveIssuePaths } from '../storage/resolve.js';\nimport { printError, printSuccess } from '../ui/logger.js';\nimport { isTransientFailure } from '../utils/retry.js';\n\n/**\n * Extract a PR URL from headless output.\n */\nfunction parsePrUrl(output: string): string | null {\n  const match = output.match(/(https:\\/\\/github\\.com\\/[^\\s]+\\/pull\\/\\d+)/);\n  return match?.[1] ?? null;\n}\n\n/**\n * The numeric id inside a PR URL, so later phases (`pr-review`) address the\n * Pull Request without querying GitHub again.\n */\nfunction parsePrNumber(url: string): number | null {\n  const match = url.match(/\\/pull\\/(\\d+)/);\n  return match?.[1] === undefined ? null : Number(match[1]);\n}\n\n/**\n * The `Closes #N` line for the PR body, empty when the Issue has no remote\n * counterpart: GitHub only understands the reference for Issues it hosts, and\n * an invented `#N` would silently point at an unrelated Issue.\n */\nfunction issueClosesLine(issue: Issue, fallbackId: string): string {\n  if (issue.remoteRef === null) {\n    return '';\n  }\n  return `Closes #${issue.number ?? fallbackId}`;\n}\n\nexport async function runPr(issue: string, resolvedIssue?: ResolvedIssue): Promise<number> {\n  const issueNumber = issue.replace(/^#/, '');\n  const paths = await resolveIssuePaths(issueNumber);\n  const tasksPath = paths.tasksFile;\n\n  const resolution = await resolveCommandIssue(issueNumber, resolvedIssue);\n  if (!resolution.ok) {\n    return resolution.code;\n  }\n\n  // Get current branch\n  let branchName: string;\n  try {\n    const proc = await execa('git', ['branch', '--show-current'], { reject: false });\n    branchName = proc.stdout?.toString().trim() ?? '';\n    if (!branchName) {\n      printError('Could not determine current branch');\n      return 1;\n    }\n  } catch {\n    printError('Failed to get current branch');\n    return 1;\n  }\n\n  const template = await loadPrompt('pr');\n  const prompt = applyPlaceholders(template, {\n    __ISSUE_NUMBER__: issueNumber,\n    __BRANCH_NAME__: branchName,\n    __TASKS_PATH__: tasksPath,\n    __ISSUE_CLOSES__: issueClosesLine(resolution.resolved.issue, issueNumber),\n    ...issuePlaceholders(resolution.resolved),\n  });\n\n  let headlessOutput = '';\n\n  const outcome = await runPhaseWithRetry({\n    phase: 'pr',\n    attempt: async () => {\n      const startedAtMs = Date.now();\n      const result = await runHeadless({\n        prompt,\n        maxTurns: 15,\n        timeout: getGlobalTimeout() ?? 300_000,\n        // json (not text) so the CLI reports usage: the envelope's `result`\n        // field carries the same assistant text parsePrUrl() already consumed.\n        outputFormat: 'json',\n        allowedTools: ['Bash', 'Read', 'Glob', 'Grep'],\n        addDirs: [paths.issueDir],\n        statusMessage: `Creating PR for issue #${issueNumber}...`,\n      });\n      // One event per attempt; the reducer sums them into the phase total.\n      publishPhaseMetrics('pr', result.cost, startedAtMs);\n\n      if (!result.success) {\n        return {\n          ok: false,\n          transient: isTransientFailure(1, result.error ?? ''),\n          error: `PR creation failed: ${result.error}`,\n        };\n      }\n\n      headlessOutput = result.result;\n      return { ok: true };\n    },\n  });\n\n  if (!outcome.ok) {\n    printError(outcome.error ?? `PR creation failed for issue #${issueNumber}`);\n    return 1;\n  }\n\n  const prUrl = parsePrUrl(headlessOutput);\n\n  // Update pipeline state\n  try {\n    const plan = await loadTaskPlan(tasksPath);\n    plan.pipeline.prCreated = true;\n    const prNumber = prUrl === null ? null : parsePrNumber(prUrl);\n    // Without a URL the PR is still assumed created (the phase succeeded), but\n    // there is nothing trustworthy to record: an invented number would send\n    // `pr-review` at an unrelated Pull Request.\n    if (prUrl !== null && prNumber !== null) {\n      plan.pullRequest = {\n        number: prNumber,\n        url: prUrl,\n        headBranch: branchName,\n        createdAt: isoNow(),\n      };\n    }\n    await saveTaskPlan(tasksPath, plan);\n  } catch {\n    // tasks.json may not exist\n  }\n\n  if (prUrl) {\n    printSuccess(`PR created: ${prUrl}`);\n  } else {\n    printSuccess('PR creation completed');\n  }\n  return 0;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/commands/pr.ts"],"sourcesContent":["import { execa } from 'execa';\nimport { runHeadless } from '../core/headless.js';\nimport { runPhaseWithRetry } from '../core/phase-runner.js';\nimport { applyPlaceholders, loadPrompt } from '../core/prompt-resolver.js';\nimport { publishPhaseMetrics } from '../core/session-metrics.js';\nimport { isoNow, loadTaskPlan, saveTaskPlan } from '../core/state-manager.js';\nimport { getGlobalTimeout } from '../core/verbose.js';\nimport { issuePlaceholders, resolveCommandIssue } from '../issues/context.js';\nimport type { Issue, ResolvedIssue } from '../issues/types.js';\nimport { resolveIssuePaths } from '../storage/resolve.js';\nimport { printError, printSuccess } from '../ui/logger.js';\nimport { isTransientFailure } from '../utils/retry.js';\n\n/**\n * Extract a PR URL from headless output.\n */\nfunction parsePrUrl(output: string): string | null {\n  const match = output.match(/(https:\\/\\/github\\.com\\/[^\\s]+\\/pull\\/\\d+)/);\n  return match?.[1] ?? null;\n}\n\n/**\n * The numeric id inside a PR URL, so later phases (`pr-review`) address the\n * Pull Request without querying GitHub again.\n */\nfunction parsePrNumber(url: string): number | null {\n  const match = url.match(/\\/pull\\/(\\d+)/);\n  return match?.[1] === undefined ? null : Number(match[1]);\n}\n\n/**\n * The `Closes #N` line for the PR body, empty when the Issue has no remote\n * counterpart: GitHub only understands the reference for Issues it hosts, and\n * an invented `#N` would silently point at an unrelated Issue.\n */\nfunction issueClosesLine(issue: Issue, fallbackId: string): string {\n  if (issue.remoteRef === null) {\n    return '';\n  }\n  return `Closes #${issue.number ?? fallbackId}`;\n}\n\nexport async function runPr(issue: string, resolvedIssue?: ResolvedIssue): Promise<number> {\n  const issueNumber = issue.replace(/^#/, '');\n  const paths = await resolveIssuePaths(issueNumber);\n  const tasksPath = paths.tasksFile;\n\n  const resolution = await resolveCommandIssue(issueNumber, resolvedIssue);\n  if (!resolution.ok) {\n    return resolution.code;\n  }\n\n  // Get current branch\n  let branchName: string;\n  try {\n    const proc = await execa('git', ['branch', '--show-current'], { reject: false });\n    branchName = proc.stdout?.toString().trim() ?? '';\n    if (!branchName) {\n      printError('Could not determine current branch');\n      return 1;\n    }\n  } catch {\n    printError('Failed to get current branch');\n    return 1;\n  }\n\n  const template = await loadPrompt('pr');\n  const prompt = applyPlaceholders(template, {\n    __ISSUE_NUMBER__: issueNumber,\n    __BRANCH_NAME__: branchName,\n    __TASKS_PATH__: tasksPath,\n    __ISSUE_CLOSES__: issueClosesLine(resolution.resolved.issue, issueNumber),\n    ...issuePlaceholders(resolution.resolved),\n  });\n\n  let headlessOutput = '';\n\n  const outcome = await runPhaseWithRetry({\n    phase: 'pr',\n    attempt: async () => {\n      const startedAtMs = Date.now();\n      const result = await runHeadless({\n        prompt,\n        maxTurns: 15,\n        timeout: getGlobalTimeout() ?? 300_000,\n        // json (not text) so the CLI reports usage: the envelope's `result`\n        // field carries the same assistant text parsePrUrl() already consumed.\n        outputFormat: 'json',\n        allowedTools: ['Bash', 'Read', 'Glob', 'Grep'],\n        addDirs: [paths.issueDir],\n        statusMessage: `Creating PR for issue #${issueNumber}...`,\n      });\n      // One event per attempt; the reducer sums them into the phase total.\n      publishPhaseMetrics('pr', result.cost, startedAtMs);\n\n      if (!result.success) {\n        return {\n          ok: false,\n          transient: isTransientFailure(1, result.error ?? ''),\n          error: `PR creation failed: ${result.error}`,\n        };\n      }\n\n      headlessOutput = result.result;\n      return { ok: true };\n    },\n  });\n\n  if (!outcome.ok) {\n    printError(outcome.error ?? `PR creation failed for issue #${issueNumber}`);\n    return 1;\n  }\n\n  const prUrl = parsePrUrl(headlessOutput);\n\n  // Update pipeline state\n  try {\n    const plan = await loadTaskPlan(tasksPath);\n    plan.pipeline.prCreated = true;\n    const prNumber = prUrl === null ? null : parsePrNumber(prUrl);\n    // Without a URL the PR is still assumed created (the phase succeeded), but\n    // there is nothing trustworthy to record: an invented number would send\n    // `pr-review` at an unrelated Pull Request.\n    if (prUrl !== null && prNumber !== null) {\n      plan.pullRequest = {\n        number: prNumber,\n        url: prUrl,\n        headBranch: branchName,\n        createdAt: isoNow(),\n      };\n    }\n    await saveTaskPlan(tasksPath, plan);\n  } catch {\n    // tasks.json may not exist\n  }\n\n  if (prUrl) {\n    printSuccess(`PR created: ${prUrl}`);\n  } else {\n    printSuccess('PR creation completed');\n  }\n  return 0;\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-6S2XT3JE.js → chunk-EOTULFWV.js}

@@ -2,25 +2,27 @@
 import {
   issuePlaceholders,
   resolveCommandIssue
-} from "./chunk-CD7BMWXW.js";
+} from "./chunk-EYVXLRRD.js";
 import {
   runHeadless
-} from "./chunk-DF7SUHT5.js";
+} from "./chunk-KHTLN54U.js";
 import {
-  applyPlaceholders,
-  loadPrompt,
   publishPhaseMetrics
-} from "./chunk-I7FTA5FI.js";
+} from "./chunk-ZYBYMEWG.js";
+import {
+  applyPlaceholders,
+  loadPrompt
+} from "./chunk-SLHZPB3C.js";
 import {
   resolveIssuePaths
-} from "./chunk-5NLLEWJD.js";
+} from "./chunk-RUTDK6ZF.js";
 import {
   getGlobalTimeout,
   loadTaskPlan,
   printError,
   printSuccess,
   saveTaskPlan
-} from "./chunk-5Q2TMW7K.js";
+} from "./chunk-WO6ERABE.js";
 
 // src/commands/review.ts
 function parseReviewResult(output) {
@@ -105,4 +107,4 @@ async function runReview(issue, resolvedIssue) {
 export {
   runReview
 };
-//# sourceMappingURL=chunk-6S2XT3JE.js.map
+//# sourceMappingURL=chunk-EOTULFWV.js.map

package/dist/{chunk-6S2XT3JE.js.map → chunk-EOTULFWV.js.map}

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

package/dist/{chunk-CD7BMWXW.js → chunk-EYVXLRRD.js}

@@ -5,7 +5,7 @@ import {
   resolveIssuePaths,
   resolveProjectPaths,
   run
-} from "./chunk-5NLLEWJD.js";
+} from "./chunk-RUTDK6ZF.js";
 import {
   isoNow,
   issueMetadataSchema,
@@ -13,7 +13,7 @@ import {
   printInfo,
   printWarning,
   writeFileAtomic
-} from "./chunk-5Q2TMW7K.js";
+} from "./chunk-WO6ERABE.js";
 
 // src/issues/registry.ts
 var providers = /* @__PURE__ */ new Map();
@@ -753,4 +753,4 @@ export {
   issuePlaceholders,
   resolveCommandIssue
 };
-//# sourceMappingURL=chunk-CD7BMWXW.js.map
+//# sourceMappingURL=chunk-EYVXLRRD.js.map

package/dist/{chunk-OE7RYTUT.js → chunk-G37JNQKB.js}

@@ -4,7 +4,7 @@ import {
   printInfo,
   printSuccess,
   printWarning
-} from "./chunk-5Q2TMW7K.js";
+} from "./chunk-WO6ERABE.js";
 
 // src/commands/init.ts
 import { execa } from "execa";
@@ -132,4 +132,4 @@ async function runInit(source = "github") {
 export {
   runInit
 };
-//# sourceMappingURL=chunk-OE7RYTUT.js.map
+//# sourceMappingURL=chunk-G37JNQKB.js.map

package/dist/chunk-JOK7VXRV.js

@@ -0,0 +1,447 @@
+#!/usr/bin/env node
+import {
+  resolvePackageDir
+} from "./chunk-SLHZPB3C.js";
+import {
+  getGlobalRoot,
+  webLockSchema
+} from "./chunk-RUTDK6ZF.js";
+import {
+  NullPublisher,
+  isoNow,
+  printInfo,
+  printWarning
+} from "./chunk-WO6ERABE.js";
+
+// src/web/lock.ts
+import { spawn as nodeSpawn } from "child_process";
+import { readFile as readFile2, rm, writeFile } from "fs/promises";
+import { join as join2 } from "path";
+import chalk2 from "chalk";
+
+// src/web/server.ts
+import { createHash } from "crypto";
+import { readFile } from "fs/promises";
+import { createServer } from "http";
+import { createRequire } from "module";
+import { join } from "path";
+import chalk from "chalk";
+var require2 = createRequire(import.meta.url);
+function readPackageVersion() {
+  try {
+    return require2("../../package.json").version;
+  } catch {
+    return "0.0.0";
+  }
+}
+var JSON_TYPE = "application/json; charset=utf-8";
+function publisherSessionSource(publisher) {
+  return {
+    list: () => {
+      const snapshot = publisher.snapshot();
+      return snapshot.sessionId === null ? [] : [snapshot];
+    },
+    get: (sessionId) => {
+      const snapshot = publisher.snapshot();
+      return snapshot.sessionId === sessionId ? snapshot : void 0;
+    }
+  };
+}
+function directorySessionSource(handle) {
+  return {
+    list: () => handle.sessions().map((entry) => entry.snapshot),
+    get: (sessionId) => handle.getSession(sessionId)?.snapshot
+  };
+}
+function resolveSessionSource(options) {
+  if (options.sessions) return directorySessionSource(options.sessions);
+  return publisherSessionSource(options.publisher ?? new NullPublisher());
+}
+var STATIC_ROUTES = {
+  "/": { file: "index.html", contentType: "text/html; charset=utf-8" },
+  "/app.css": { file: "app.css", contentType: "text/css; charset=utf-8" },
+  "/app.js": { file: "app.js", contentType: "text/javascript; charset=utf-8" }
+};
+async function loadStaticAssets(publicDir) {
+  const assets = /* @__PURE__ */ new Map();
+  if (publicDir === null) return assets;
+  for (const [route, { file, contentType }] of Object.entries(STATIC_ROUTES)) {
+    try {
+      const body = await readFile(join(publicDir, file), "utf-8");
+      assets.set(route, { body, contentType });
+    } catch {
+    }
+  }
+  return assets;
+}
+function baseHeaders(res) {
+  res.setHeader("Cache-Control", "no-store");
+  res.setHeader("X-Content-Type-Options", "nosniff");
+  res.setHeader("Referrer-Policy", "no-referrer");
+  res.setHeader("X-Robots-Tag", "noindex, nofollow");
+}
+function respond(res, status, contentType, body) {
+  res.statusCode = status;
+  res.setHeader("Content-Type", contentType);
+  res.end(body);
+}
+function respondJson(res, status, payload) {
+  respond(res, status, JSON_TYPE, JSON.stringify(payload));
+}
+async function startWebServer(options) {
+  const info = options.info ?? printInfo;
+  const warn = options.warn ?? printWarning;
+  const version = options.version ?? readPackageVersion();
+  const startedAtMs = Date.now();
+  const assets = await loadStaticAssets(
+    options.publicDir ?? resolvePackageDir(join("web", "public"))
+  );
+  const source = resolveSessionSource(options);
+  const statusCache = /* @__PURE__ */ new Map();
+  const statusPayload = (snapshot) => {
+    const key = snapshot.sessionId ?? "";
+    const body = JSON.stringify(snapshot);
+    const cached = statusCache.get(key);
+    if (cached !== void 0 && cached.body === body) return cached;
+    const etag = `"${createHash("sha1").update(body).digest("hex")}"`;
+    const entry = { body, etag };
+    statusCache.set(key, entry);
+    return entry;
+  };
+  const handleRequest = (req, res) => {
+    baseHeaders(res);
+    const requestUrl = new URL(req.url ?? "/", "http://localhost");
+    const path = requestUrl.pathname;
+    if (req.method !== "GET" && req.method !== "HEAD") {
+      respondJson(res, 404, { error: "Not found" });
+      return;
+    }
+    if (path === "/api/status" || path === "/status.json") {
+      const sessionId = requestUrl.searchParams.get("session");
+      let snapshot;
+      if (sessionId !== null) {
+        snapshot = source.get(sessionId);
+        if (snapshot === void 0) {
+          respondJson(res, 404, { error: `No active session with id '${sessionId}'.` });
+          return;
+        }
+      } else {
+        const active = source.list();
+        if (active.length === 0) {
+          respondJson(res, 404, {
+            error: "No active session. Pass ?session=<id> \u2014 see GET /api/sessions."
+          });
+          return;
+        }
+        if (active.length > 1) {
+          respondJson(res, 409, {
+            error: "Multiple active sessions; specify ?session=<id>.",
+            sessions: active.map((entry) => entry.sessionId)
+          });
+          return;
+        }
+        snapshot = active[0];
+      }
+      const { body, etag } = statusPayload(snapshot);
+      res.setHeader("ETag", etag);
+      if (req.headers["if-none-match"] === etag) {
+        res.statusCode = 304;
+        res.end();
+        return;
+      }
+      respond(res, 200, JSON_TYPE, body);
+      return;
+    }
+    if (path === "/api/sessions") {
+      respondJson(
+        res,
+        200,
+        source.list().map((snapshot) => ({
+          sessionId: snapshot.sessionId,
+          issueNumber: snapshot.issue.number,
+          status: snapshot.status,
+          startedAt: snapshot.startedAt,
+          updatedAt: snapshot.updatedAt,
+          statusUrl: `/api/status?session=${encodeURIComponent(snapshot.sessionId ?? "")}`
+        }))
+      );
+      return;
+    }
+    if (path === "/api/health") {
+      respondJson(res, 200, {
+        ok: true,
+        uptime: Math.round((Date.now() - startedAtMs) / 1e3),
+        version,
+        refreshSeconds: options.refreshSeconds ?? 5
+      });
+      return;
+    }
+    const asset = assets.get(path);
+    if (asset) {
+      respond(res, 200, asset.contentType, asset.body);
+      return;
+    }
+    respondJson(res, 404, { error: "Not found" });
+  };
+  const server = createServer((req, res) => {
+    try {
+      handleRequest(req, res);
+    } catch (err) {
+      try {
+        respondJson(res, 500, { error: err instanceof Error ? err.message : String(err) });
+      } catch {
+      }
+    }
+  });
+  const listening = await new Promise((resolve) => {
+    const onError = (err) => {
+      if (err.code === "EADDRINUSE") {
+        warn(
+          `Web monitor port ${options.port} is already in use. Continuing without the web server.`
+        );
+      } else {
+        warn(`Web monitor failed to start (${err.message}). Continuing without the web server.`);
+      }
+      resolve(false);
+    };
+    server.once("error", onError);
+    server.listen(options.port, options.host, () => {
+      server.removeListener("error", onError);
+      resolve(true);
+    });
+  });
+  if (!listening) return null;
+  if (options.unref !== false) {
+    server.unref();
+  }
+  server.on("error", (err) => {
+    warn(`Web monitor server error: ${err.message}`);
+  });
+  const address = server.address();
+  const port = address.port;
+  const displayHost = options.host === "0.0.0.0" ? "localhost" : options.host;
+  const url = `http://${displayHost}:${port}`;
+  if (options.host === "0.0.0.0") {
+    warn("Web monitor bound to 0.0.0.0: anyone on your local network can view the session state.");
+  }
+  info(`Web monitor running at ${chalk.bold.cyan(url)}`);
+  let closed = false;
+  let closePromise = null;
+  const doClose = () => new Promise((resolve) => {
+    process.removeListener("SIGINT", onSignal);
+    process.removeListener("SIGTERM", onSignal);
+    server.close(() => resolve());
+    server.closeAllConnections();
+  });
+  const close = () => {
+    if (closed) return closePromise ?? Promise.resolve();
+    closed = true;
+    closePromise = doClose();
+    return closePromise;
+  };
+  const handle = { server, host: options.host, port, url, close };
+  const onSignal = (signal) => {
+    void handle.close().finally(() => {
+      process.kill(process.pid, signal);
+    });
+  };
+  process.once("SIGINT", onSignal);
+  process.once("SIGTERM", onSignal);
+  return handle;
+}
+
+// src/web/lock.ts
+var WEB_LOCK_FILENAME = "web.lock";
+var HEALTH_PROBE_TIMEOUT_MS = 1e3;
+var LOCK_CLAIM_RETRIES = 5;
+var LOCK_CLAIM_RETRY_DELAY_MS = 100;
+function getWebLockFile(options = {}) {
+  return join2(getGlobalRoot(options), WEB_LOCK_FILENAME);
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function isProcessAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (err) {
+    return err.code === "EPERM";
+  }
+}
+function probeUrl(host, port) {
+  const probeHost = host === "0.0.0.0" ? "127.0.0.1" : host;
+  return `http://${probeHost}:${port}/api/health`;
+}
+async function probeHealth(host, port) {
+  try {
+    const res = await fetch(probeUrl(host, port), {
+      signal: AbortSignal.timeout(HEALTH_PROBE_TIMEOUT_MS)
+    });
+    return res.ok;
+  } catch {
+    return false;
+  }
+}
+async function readWebLock(lockFile) {
+  let raw;
+  try {
+    raw = await readFile2(lockFile, "utf-8");
+  } catch {
+    return null;
+  }
+  try {
+    const result = webLockSchema.safeParse(JSON.parse(raw));
+    return result.success ? result.data : null;
+  } catch {
+    return null;
+  }
+}
+async function removeWebLock(lockFile) {
+  try {
+    await rm(lockFile, { force: true });
+  } catch {
+  }
+}
+async function detectActiveInstance(lockFile) {
+  const lock = await readWebLock(lockFile);
+  if (lock === null) return null;
+  if (isProcessAlive(lock.pid) && await probeHealth(lock.host, lock.port)) {
+    return lock;
+  }
+  await removeWebLock(lockFile);
+  return null;
+}
+async function claimWebLock(lockFile, lock) {
+  try {
+    await writeFile(lockFile, JSON.stringify(lock, null, 2), { encoding: "utf-8", flag: "wx" });
+    return true;
+  } catch (err) {
+    if (err.code === "EEXIST") return false;
+    throw err;
+  }
+}
+function reusedHandle(lock) {
+  const displayHost = lock.host === "0.0.0.0" ? "localhost" : lock.host;
+  return {
+    host: lock.host,
+    port: lock.port,
+    url: `http://${displayHost}:${lock.port}`,
+    close: async () => {
+    }
+  };
+}
+async function ensureSingleWebServer(options, lockOptions = {}) {
+  const warn = options.warn ?? printWarning;
+  const info = options.info ?? printInfo;
+  const lockFile = getWebLockFile(lockOptions);
+  for (let attempt = 0; attempt <= LOCK_CLAIM_RETRIES; attempt++) {
+    const active = await detectActiveInstance(lockFile);
+    if (active !== null) {
+      info(`Reusing existing web monitor at ${reusedHandle(active).url}`);
+      return reusedHandle(active);
+    }
+    const handle = await startWebServer(options);
+    if (handle === null) {
+      await sleep(LOCK_CLAIM_RETRY_DELAY_MS);
+      continue;
+    }
+    let claimed;
+    try {
+      claimed = await claimWebLock(lockFile, {
+        pid: process.pid,
+        port: handle.port,
+        host: handle.host,
+        startedAt: isoNow()
+      });
+    } catch (err) {
+      await handle.close();
+      throw err;
+    }
+    if (!claimed) {
+      await handle.close();
+      await sleep(LOCK_CLAIM_RETRY_DELAY_MS);
+      continue;
+    }
+    const originalClose = handle.close;
+    handle.close = async () => {
+      await originalClose();
+      await removeWebLock(lockFile);
+    };
+    return handle;
+  }
+  warn("Could not determine the web monitor lock ownership. Continuing without the web server.");
+  return null;
+}
+var DETACHED_CLAIM_TIMEOUT_MS = 5e3;
+var DETACHED_CLAIM_POLL_MS = 150;
+async function ensureWebMonitor(options, monitorOptions = {}) {
+  const warn = options.warn ?? printWarning;
+  const info = options.info ?? printInfo;
+  let lockFile;
+  try {
+    lockFile = getWebLockFile(monitorOptions);
+  } catch (err) {
+    warn(
+      `Web monitor: global storage unavailable (${err instanceof Error ? err.message : String(err)}). Falling back to legacy in-process mode.`
+    );
+    return startWebServer(options);
+  }
+  const active = await detectActiveInstance(lockFile);
+  if (active !== null) {
+    info(`Reusing existing web monitor at ${reusedHandle(active).url}`);
+    return reusedHandle(active);
+  }
+  const execPath = monitorOptions.execPath ?? process.execPath;
+  const entryScript = monitorOptions.entryScript ?? process.argv[1];
+  if (entryScript === void 0) {
+    warn("Web monitor: could not determine the CLI entry point to spawn a detached server.");
+    return null;
+  }
+  const args = [
+    entryScript,
+    "web",
+    "serve",
+    "--port",
+    String(options.port),
+    "--host",
+    options.host
+  ];
+  if (options.refreshSeconds !== void 0) {
+    args.push("--refresh", String(options.refreshSeconds));
+  }
+  const spawnFn = monitorOptions.spawn ?? nodeSpawn;
+  try {
+    const child = spawnFn(execPath, args, { detached: true, stdio: "ignore" });
+    child.unref();
+  } catch (err) {
+    warn(
+      `Web monitor: failed to start the detached server (${err instanceof Error ? err.message : String(err)}). Continuing without the web server.`
+    );
+    return null;
+  }
+  const timeoutMs = monitorOptions.claimTimeoutMs ?? DETACHED_CLAIM_TIMEOUT_MS;
+  const pollMs = monitorOptions.claimPollIntervalMs ?? DETACHED_CLAIM_POLL_MS;
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    const claimed = await detectActiveInstance(lockFile);
+    if (claimed !== null) {
+      info(`Web monitor running at ${chalk2.bold.cyan(reusedHandle(claimed).url)}`);
+      return reusedHandle(claimed);
+    }
+    await sleep(pollMs);
+  }
+  warn(
+    "Web monitor: the detached server did not start in time. Continuing without the web server."
+  );
+  return null;
+}
+
+export {
+  getWebLockFile,
+  readWebLock,
+  removeWebLock,
+  ensureSingleWebServer,
+  ensureWebMonitor
+};
+//# sourceMappingURL=chunk-JOK7VXRV.js.map