issue-flow 0.4.3 → 0.5.1

package/dist/{chunk-2JZCWJEQ.js → chunk-SI4ALORB.js}

@@ -1,20 +1,18 @@
 #!/usr/bin/env node
 import {
   runHeadless
-} from "./chunk-4OQ2ARLP.js";
-import {
-  loadTaskPlan,
-  saveTaskPlan
-} from "./chunk-64FU2L2T.js";
+} from "./chunk-2XWXVWVD.js";
 import {
   applyPlaceholders,
   loadPrompt
-} from "./chunk-OZVHOVDT.js";
+} from "./chunk-SLHZPB3C.js";
 import {
   getGlobalTimeout,
+  loadTaskPlan,
   printError,
-  printSuccess
-} from "./chunk-YAFHVFV5.js";
+  printSuccess,
+  saveTaskPlan
+} from "./chunk-FNLXZXWP.js";
 
 // src/commands/prd.ts
 import { mkdir, readFile } from "fs/promises";
@@ -24,21 +22,9 @@ async function runPrd(issue) {
   const issueDir = join("issues", issueNumber);
   const prdPath = join(issueDir, "prd.md");
   await mkdir(issueDir, { recursive: true });
-  let analysisContext = "";
-  const analysisPath = join(issueDir, "analysis.md");
-  try {
-    const content = await readFile(analysisPath, "utf-8");
-    analysisContext = `
-
-Here is the existing analysis for this issue:
-
-${content}`;
-  } catch {
-  }
   const template = await loadPrompt("prd");
   const prompt = applyPlaceholders(template, {
     __ISSUE_NUMBER__: issueNumber,
-    __ANALYSIS_CONTEXT__: analysisContext,
     __PRD_PATH__: prdPath
   });
   const result = await runHeadless({
@@ -77,4 +63,4 @@ ${content}`;
 export {
   runPrd
 };
-//# sourceMappingURL=chunk-2JZCWJEQ.js.map
+//# sourceMappingURL=chunk-SI4ALORB.js.map

package/dist/chunk-SI4ALORB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/prd.ts"],"sourcesContent":["import { mkdir, readFile } 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 { printError, printSuccess } from '../ui/logger.js';\n\nexport async function runPrd(issue: string): Promise<number> {\n  const issueNumber = issue.replace(/^#/, '');\n  const issueDir = join('issues', issueNumber);\n  const prdPath = join(issueDir, 'prd.md');\n\n  await mkdir(issueDir, { recursive: true });\n\n  const template = await loadPrompt('prd');\n  const prompt = applyPlaceholders(template, {\n    __ISSUE_NUMBER__: issueNumber,\n    __PRD_PATH__: prdPath,\n  });\n\n  const 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    printError(`PRD generation failed: ${result.error}`);\n    return 1;\n  }\n\n  // Verify the file was created\n  try {\n    const content = await readFile(prdPath, 'utf-8');\n    if (content.length < 10) {\n      printError('PRD file was created but appears empty');\n      return 1;\n    }\n  } catch {\n    printError(`PRD file was not created at ${prdPath}`);\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,OAAO,gBAAgB;AAChC,SAAS,YAAY;AAOrB,eAAsB,OAAO,OAAgC;AAC3D,QAAM,cAAc,MAAM,QAAQ,MAAM,EAAE;AAC1C,QAAM,WAAW,KAAK,UAAU,WAAW;AAC3C,QAAM,UAAU,KAAK,UAAU,QAAQ;AAEvC,QAAM,MAAM,UAAU,EAAE,WAAW,KAAK,CAAC;AAEzC,QAAM,WAAW,MAAM,WAAW,KAAK;AACvC,QAAM,SAAS,kBAAkB,UAAU;AAAA,IACzC,kBAAkB;AAAA,IAClB,cAAc;AAAA,EAChB,CAAC;AAED,QAAM,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,6BAA6B,WAAW;AAAA,EACzD,CAAC;AAED,MAAI,CAAC,OAAO,SAAS;AACnB,eAAW,0BAA0B,OAAO,KAAK,EAAE;AACnD,WAAO;AAAA,EACT;AAGA,MAAI;AACF,UAAM,UAAU,MAAM,SAAS,SAAS,OAAO;AAC/C,QAAI,QAAQ,SAAS,IAAI;AACvB,iBAAW,wCAAwC;AACnD,aAAO;AAAA,IACT;AAAA,EACF,QAAQ;AACN,eAAW,+BAA+B,OAAO,EAAE;AACnD,WAAO;AAAA,EACT;AAGA,QAAM,YAAY,KAAK,UAAU,YAAY;AAC7C,MAAI;AACF,UAAM,OAAO,MAAM,aAAa,SAAS;AACzC,SAAK,SAAS,eAAe;AAC7B,UAAM,aAAa,WAAW,IAAI;AAAA,EACpC,QAAQ;AAAA,EAER;AAEA,eAAa,gBAAgB,OAAO,EAAE;AACtC,SAAO;AACT;","names":[]}

package/dist/{chunk-OZVHOVDT.js → chunk-SLHZPB3C.js}

@@ -5,19 +5,25 @@ import { existsSync } from "fs";
 import { readFile } from "fs/promises";
 import { dirname, join } from "path";
 import { fileURLToPath } from "url";
-function getPromptsDir() {
-  const currentFile = fileURLToPath(import.meta.url);
-  let dir = dirname(currentFile);
+function resolvePackageDir(name, startDir) {
+  let dir = startDir ?? dirname(fileURLToPath(import.meta.url));
   for (let i = 0; i < 5; i++) {
-    const candidate = join(dir, "prompts");
+    const candidate = join(dir, name);
     if (existsSync(candidate)) {
       return candidate;
     }
     dir = dirname(dir);
   }
-  throw new Error(
-    "Could not locate the prompts/ directory. Ensure the package is installed correctly."
-  );
+  return null;
+}
+function getPromptsDir() {
+  const dir = resolvePackageDir("prompts");
+  if (dir === null) {
+    throw new Error(
+      "Could not locate the prompts/ directory. Ensure the package is installed correctly."
+    );
+  }
+  return dir;
 }
 async function loadPrompt(name) {
   const promptsDir = getPromptsDir();
@@ -37,7 +43,8 @@ function applyPlaceholders(template, vars) {
 }
 
 export {
+  resolvePackageDir,
   loadPrompt,
   applyPlaceholders
 };
-//# sourceMappingURL=chunk-OZVHOVDT.js.map
+//# sourceMappingURL=chunk-SLHZPB3C.js.map

package/dist/chunk-SLHZPB3C.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/prompt-resolver.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { readFile } from 'node:fs/promises';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\n/**\n * Resolve the absolute path to a directory shipped at the package root\n * (e.g. 'prompts', 'web/public'). Works from both source (src/core/) and\n * compiled (dist/) locations by walking up the directory tree until the\n * named folder is found. Returns null when it cannot be located.\n *\n * `startDir` is injectable for tests; it defaults to this module's directory.\n */\nexport function resolvePackageDir(name: string, startDir?: string): string | null {\n  let dir = startDir ?? dirname(fileURLToPath(import.meta.url));\n\n  for (let i = 0; i < 5; i++) {\n    const candidate = join(dir, name);\n    if (existsSync(candidate)) {\n      return candidate;\n    }\n    dir = dirname(dir);\n  }\n\n  return null;\n}\n\nfunction getPromptsDir(): string {\n  const dir = resolvePackageDir('prompts');\n  if (dir === null) {\n    throw new Error(\n      'Could not locate the prompts/ directory. Ensure the package is installed correctly.',\n    );\n  }\n  return dir;\n}\n\n/**\n * Load a prompt template by name from the package's prompts/ directory.\n *\n * @param name - Prompt name without extension (e.g., 'execute', 'analyze')\n * @returns The raw template content with placeholders intact\n */\nexport async function loadPrompt(name: string): Promise<string> {\n  const promptsDir = getPromptsDir();\n  const filePath = join(promptsDir, `${name}.md`);\n\n  try {\n    return await readFile(filePath, 'utf-8');\n  } catch {\n    throw new Error(`Prompt template not found: ${filePath}`);\n  }\n}\n\n/**\n * Replace placeholders in a prompt template with actual values.\n *\n * Placeholders use the format __KEY__ (e.g., __ISSUE_NUMBER__, __PRD_FILE__).\n */\nexport function applyPlaceholders(template: string, vars: Record<string, string>): string {\n  let result = template;\n  for (const [key, value] of Object.entries(vars)) {\n    result = result.replaceAll(key, value);\n  }\n  return result;\n}\n"],"mappings":";;;AAAA,SAAS,kBAAkB;AAC3B,SAAS,gBAAgB;AACzB,SAAS,SAAS,YAAY;AAC9B,SAAS,qBAAqB;AAUvB,SAAS,kBAAkB,MAAc,UAAkC;AAChF,MAAI,MAAM,YAAY,QAAQ,cAAc,YAAY,GAAG,CAAC;AAE5D,WAAS,IAAI,GAAG,IAAI,GAAG,KAAK;AAC1B,UAAM,YAAY,KAAK,KAAK,IAAI;AAChC,QAAI,WAAW,SAAS,GAAG;AACzB,aAAO;AAAA,IACT;AACA,UAAM,QAAQ,GAAG;AAAA,EACnB;AAEA,SAAO;AACT;AAEA,SAAS,gBAAwB;AAC/B,QAAM,MAAM,kBAAkB,SAAS;AACvC,MAAI,QAAQ,MAAM;AAChB,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;AAQA,eAAsB,WAAW,MAA+B;AAC9D,QAAM,aAAa,cAAc;AACjC,QAAM,WAAW,KAAK,YAAY,GAAG,IAAI,KAAK;AAE9C,MAAI;AACF,WAAO,MAAM,SAAS,UAAU,OAAO;AAAA,EACzC,QAAQ;AACN,UAAM,IAAI,MAAM,8BAA8B,QAAQ,EAAE;AAAA,EAC1D;AACF;AAOO,SAAS,kBAAkB,UAAkB,MAAsC;AACxF,MAAI,SAAS;AACb,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,IAAI,GAAG;AAC/C,aAAS,OAAO,WAAW,KAAK,KAAK;AAAA,EACvC;AACA,SAAO;AACT;","names":[]}

package/dist/chunk-TYOFZ6DD.js

@@ -0,0 +1,240 @@
+#!/usr/bin/env node
+import {
+  printWarning,
+  webConfigSchema
+} from "./chunk-FNLXZXWP.js";
+
+// src/config.ts
+import { readFile } from "fs/promises";
+import { platform } from "os";
+import { join } from "path";
+
+// src/utils/shell.ts
+import { execa } from "execa";
+async function run(command, args = [], options) {
+  const result = await execa(command, args, {
+    reject: false,
+    ...options
+  });
+  return {
+    stdout: result.stdout?.toString() ?? "",
+    stderr: result.stderr?.toString() ?? "",
+    exitCode: result.exitCode ?? 1
+  };
+}
+
+// src/utils/git.ts
+async function getProjectRoot() {
+  const result = await run("git", ["rev-parse", "--show-toplevel"]);
+  if (result.exitCode !== 0) {
+    throw new Error(
+      "Not inside a git repository. Please run issue-flow from within a git project."
+    );
+  }
+  return result.stdout.trim();
+}
+async function getCurrentBranch() {
+  const result = await run("git", ["branch", "--show-current"]);
+  if (result.exitCode !== 0) {
+    throw new Error(
+      "Failed to detect git branch. Ensure git is installed and you are inside a repository."
+    );
+  }
+  return result.stdout.trim();
+}
+async function getBaseBranch() {
+  const remoteHead = await run("git", ["symbolic-ref", "--short", "refs/remotes/origin/HEAD"]);
+  if (remoteHead.exitCode === 0) {
+    const name = remoteHead.stdout.trim().replace(/^origin\//, "");
+    if (name) return name;
+  }
+  for (const candidate of ["main", "master"]) {
+    const check = await run("git", ["rev-parse", "--verify", "--quiet", `refs/heads/${candidate}`]);
+    if (check.exitCode === 0) return candidate;
+  }
+  return "main";
+}
+async function getCommitsSince(base) {
+  const result = await run("git", ["log", "--pretty=format:%h%x09%s", `${base}..HEAD`]);
+  if (result.exitCode !== 0) return [];
+  return result.stdout.split("\n").filter((line) => line.trim() !== "").map((line) => {
+    const tab = line.indexOf("	");
+    return tab === -1 ? { hash: line.trim(), subject: "" } : { hash: line.slice(0, tab), subject: line.slice(tab + 1) };
+  });
+}
+
+// src/config.ts
+var DEFAULTS = {
+  retryLimit: 10,
+  retryForever: false,
+  backoffBaseSeconds: 30,
+  backoffMaxSeconds: 900
+};
+function createConfig(options) {
+  return {
+    issueNumber: options.issueNumber,
+    maxIterations: options.maxIterations,
+    retryLimit: options.retryLimit ?? DEFAULTS.retryLimit,
+    retryForever: options.retryForever ?? DEFAULTS.retryForever,
+    backoffBaseSeconds: options.backoffBaseSeconds ?? DEFAULTS.backoffBaseSeconds,
+    backoffMaxSeconds: options.backoffMaxSeconds ?? DEFAULTS.backoffMaxSeconds
+  };
+}
+async function resolvePaths(config, scriptDir) {
+  const projectRoot = await getProjectRoot();
+  if (config.issueNumber) {
+    const issueDir = join(projectRoot, "issues", config.issueNumber);
+    return {
+      prdFile: join(issueDir, "tasks.json"),
+      progressFile: join(issueDir, "progress.txt"),
+      archiveDir: join(issueDir, "archive"),
+      lastBranchFile: join(issueDir, ".last-branch"),
+      projectRoot
+    };
+  }
+  const base = scriptDir ?? projectRoot;
+  return {
+    prdFile: join(base, "prd.json"),
+    progressFile: join(base, "progress.txt"),
+    archiveDir: join(base, "archive"),
+    lastBranchFile: join(base, ".last-branch"),
+    projectRoot
+  };
+}
+function getInstallHint(pkg) {
+  const os = platform();
+  if (os === "darwin") {
+    return `brew install ${pkg}`;
+  }
+  if (os === "linux") {
+    return `apt install ${pkg}  (or your distro's package manager)`;
+  }
+  if (os === "win32") {
+    return `winget install ${pkg}  (or choco install ${pkg})`;
+  }
+  return `install ${pkg} using your system package manager`;
+}
+async function validateDependencies() {
+  const errors = [];
+  const gitResult = await run("git", ["--version"]);
+  if (gitResult.exitCode !== 0) {
+    errors.push(`  - git  (install with: ${getInstallHint("git")})`);
+  }
+  const claudeResult = await run("claude", ["--version"]);
+  if (claudeResult.exitCode !== 0) {
+    errors.push("  - claude  (install with: npm install -g @anthropic-ai/claude-code)");
+  }
+  return errors;
+}
+var WEB_CONFIG_FILENAME = ".issue-flow.json";
+var webCliOverrides = {};
+function setWebCliOverrides(overrides) {
+  webCliOverrides = overrides;
+}
+var FALSY_ENV_VALUES = /* @__PURE__ */ new Set(["", "0", "false", "no", "off"]);
+function parseBooleanEnv(value) {
+  return !FALSY_ENV_VALUES.has(value.trim().toLowerCase());
+}
+function readNumberEnv(env, name, warn) {
+  const raw = env[name];
+  if (raw === void 0) {
+    return void 0;
+  }
+  const parsed = Number(raw);
+  if (!Number.isFinite(parsed)) {
+    warn(`Ignoring ${name}="${raw}": not a number.`);
+    return void 0;
+  }
+  return parsed;
+}
+function readWebConfigEnv(env, warn) {
+  const layer = {};
+  if (env.ISSUE_FLOW_WEB !== void 0) {
+    layer.enabled = parseBooleanEnv(env.ISSUE_FLOW_WEB);
+  }
+  const port = readNumberEnv(env, "ISSUE_FLOW_WEB_PORT", warn);
+  if (port !== void 0) {
+    layer.port = port;
+  }
+  if (env.ISSUE_FLOW_WEB_HOST !== void 0) {
+    layer.host = env.ISSUE_FLOW_WEB_HOST;
+  }
+  const refresh = readNumberEnv(env, "ISSUE_FLOW_WEB_REFRESH", warn);
+  if (refresh !== void 0) {
+    layer.refreshSeconds = refresh;
+  }
+  const logLimit = readNumberEnv(env, "ISSUE_FLOW_WEB_LOG_LIMIT", warn);
+  if (logLimit !== void 0) {
+    layer.logLimit = logLimit;
+  }
+  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;
+  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"}.`
+    );
+    return {};
+  }
+  return result.data;
+}
+async function loadWebConfig(options = {}) {
+  const warn = options.warn ?? printWarning;
+  const cli = options.cli ?? webCliOverrides;
+  const env = options.env ?? process.env;
+  const fileLayer = await readWebConfigFile(options.projectRoot, warn);
+  const envLayer = readWebConfigEnv(env, warn);
+  const merged = { ...fileLayer, ...envLayer, ...cli };
+  const result = webConfigSchema.safeParse(merged);
+  if (result.success) {
+    return result.data;
+  }
+  warn(
+    `Invalid web monitoring configuration (${result.error.issues[0]?.message ?? "invalid value"}); using defaults.`
+  );
+  return webConfigSchema.parse({});
+}
+
+export {
+  run,
+  getCurrentBranch,
+  getBaseBranch,
+  getCommitsSince,
+  createConfig,
+  resolvePaths,
+  validateDependencies,
+  setWebCliOverrides,
+  loadWebConfig
+};
+//# sourceMappingURL=chunk-TYOFZ6DD.js.map

package/dist/chunk-TYOFZ6DD.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 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// ── Web monitoring configuration ────────────────────────────────────────────\n\n/** Optional per-project configuration file, read from the project root. */\nexport const WEB_CONFIG_FILENAME = '.issue-flow.json';\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  let root = projectRoot;\n  if (root === undefined) {\n    try {\n      root = await getProjectRoot();\n    } catch {\n      return {};\n    }\n  }\n\n  const filePath = join(root, WEB_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 {};\n  }\n\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw);\n  } catch {\n    warn(`Ignoring ${WEB_CONFIG_FILENAME}: invalid JSON.`);\n    return {};\n  }\n\n  if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {\n    warn(`Ignoring ${WEB_CONFIG_FILENAME}: expected a JSON object.`);\n    return {};\n  }\n\n  const web = (parsed as Record<string, unknown>).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 ${WEB_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","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-4PZXIOXD.js → chunk-XJJP4TSK.js}

@@ -1,20 +1,18 @@
 #!/usr/bin/env node
 import {
   runHeadless
-} from "./chunk-4OQ2ARLP.js";
-import {
-  loadTaskPlan,
-  saveTaskPlan
-} from "./chunk-64FU2L2T.js";
+} from "./chunk-2XWXVWVD.js";
 import {
   applyPlaceholders,
   loadPrompt
-} from "./chunk-OZVHOVDT.js";
+} from "./chunk-SLHZPB3C.js";
 import {
   getGlobalTimeout,
+  loadTaskPlan,
   printError,
-  printSuccess
-} from "./chunk-YAFHVFV5.js";
+  printSuccess,
+  saveTaskPlan
+} from "./chunk-FNLXZXWP.js";
 
 // src/commands/review.ts
 import { join } from "path";
@@ -82,4 +80,4 @@ async function runReview(issue) {
 export {
   runReview
 };
-//# sourceMappingURL=chunk-4PZXIOXD.js.map
+//# sourceMappingURL=chunk-XJJP4TSK.js.map

package/dist/{chunk-4PZXIOXD.js.map → chunk-XJJP4TSK.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/commands/review.ts"],"sourcesContent":["import { 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 { 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): Promise<number> {\n  const issueNumber = issue.replace(/^#/, '');\n  const issueDir = join('issues', issueNumber);\n  const tasksPath = join(issueDir, 'tasks.json');\n\n  const template = await loadPrompt('review');\n  const prompt = applyPlaceholders(template, {\n    __ISSUE_NUMBER__: issueNumber,\n    __TASKS_PATH__: tasksPath,\n  });\n\n  const result = await runHeadless({\n    prompt,\n    maxTurns: 25,\n    timeout: getGlobalTimeout() ?? 300_000,\n    outputFormat: 'text',\n    allowedTools: ['Bash', 'Read', 'Glob', 'Grep'],\n    statusMessage: `Reviewing issue #${issueNumber} resolution...`,\n  });\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      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  return 1;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA,SAAS,YAAY;AAerB,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,OAAgC;AAC9D,QAAM,cAAc,MAAM,QAAQ,MAAM,EAAE;AAC1C,QAAM,WAAW,KAAK,UAAU,WAAW;AAC3C,QAAM,YAAY,KAAK,UAAU,YAAY;AAE7C,QAAM,WAAW,MAAM,WAAW,QAAQ;AAC1C,QAAM,SAAS,kBAAkB,UAAU;AAAA,IACzC,kBAAkB;AAAA,IAClB,gBAAgB;AAAA,EAClB,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,MAAM;AAAA,IAC7C,eAAe,oBAAoB,WAAW;AAAA,EAChD,CAAC;AAED,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,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;AACA,SAAO;AACT;","names":["findingsMatch"]}
+{"version":3,"sources":["../src/commands/review.ts"],"sourcesContent":["import { 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 { 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): Promise<number> {\n  const issueNumber = issue.replace(/^#/, '');\n  const issueDir = join('issues', issueNumber);\n  const tasksPath = join(issueDir, 'tasks.json');\n\n  const template = await loadPrompt('review');\n  const prompt = applyPlaceholders(template, {\n    __ISSUE_NUMBER__: issueNumber,\n    __TASKS_PATH__: tasksPath,\n  });\n\n  const result = await runHeadless({\n    prompt,\n    maxTurns: 25,\n    timeout: getGlobalTimeout() ?? 300_000,\n    outputFormat: 'text',\n    allowedTools: ['Bash', 'Read', 'Glob', 'Grep'],\n    statusMessage: `Reviewing issue #${issueNumber} resolution...`,\n  });\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      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  return 1;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAAA,SAAS,YAAY;AAerB,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,OAAgC;AAC9D,QAAM,cAAc,MAAM,QAAQ,MAAM,EAAE;AAC1C,QAAM,WAAW,KAAK,UAAU,WAAW;AAC3C,QAAM,YAAY,KAAK,UAAU,YAAY;AAE7C,QAAM,WAAW,MAAM,WAAW,QAAQ;AAC1C,QAAM,SAAS,kBAAkB,UAAU;AAAA,IACzC,kBAAkB;AAAA,IAClB,gBAAgB;AAAA,EAClB,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,MAAM;AAAA,IAC7C,eAAe,oBAAoB,WAAW;AAAA,EAChD,CAAC;AAED,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,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;AACA,SAAO;AACT;","names":["findingsMatch"]}

package/dist/cli.js

@@ -1,9 +1,12 @@
 #!/usr/bin/env node
+import {
+  setWebCliOverrides
+} from "./chunk-TYOFZ6DD.js";
 import {
   printError,
   setGlobalTimeout,
   setVerbose
-} from "./chunk-YAFHVFV5.js";
+} from "./chunk-FNLXZXWP.js";
 
 // src/cli.ts
 import { createRequire } from "module";
@@ -24,6 +27,31 @@ function withGlobalOptions(cmd) {
     parseInteger
   );
 }
+function withWebOptions(cmd) {
+  return cmd.option("--web", "Enable the web monitoring server").option("--serve", "Alias for --web").option("--port <n>", "Web server port (default: 3737)", parseInteger).option("--host <h>", "Web server host (default: 127.0.0.1)").option("--refresh <s>", "Suggested UI polling interval in seconds", parseInteger).option("--web-log-limit <n>", "Max log entries kept in the snapshot", parseInteger).option("--web-no-logs", "Exclude logs from the published snapshot");
+}
+function resolveWebOverrides(opts) {
+  const overrides = {};
+  if (opts.web === true || opts.serve === true) {
+    overrides.enabled = true;
+  }
+  if (opts.port !== void 0) {
+    overrides.port = opts.port;
+  }
+  if (opts.host !== void 0) {
+    overrides.host = opts.host;
+  }
+  if (opts.refresh !== void 0) {
+    overrides.refreshSeconds = opts.refresh;
+  }
+  if (opts.webLogLimit !== void 0) {
+    overrides.logLimit = opts.webLogLimit;
+  }
+  if (opts.webNoLogs === true) {
+    overrides.includeLogs = false;
+  }
+  return overrides;
+}
 var program = new Command();
 program.name("issue-flow").description(
   "Unified CLI for orchestrating the full issue-flow pipeline via Claude Code Headless."
@@ -36,59 +64,68 @@ program.hook("preAction", (_thisCommand, actionCommand) => {
   if (opts.timeout !== void 0) {
     setGlobalTimeout(opts.timeout * 1e3);
   }
+  setWebCliOverrides(resolveWebOverrides(opts));
 });
 withGlobalOptions(
   program.command("init").description("Verify that all prerequisites (claude, gh, git) are met")
 ).action(async () => {
-  const { runInit } = await import("./init-SXFGOCML.js");
+  const { runInit } = await import("./init-6AWQI3IE.js");
   const code = await runInit();
   process.exit(code);
 });
 withGlobalOptions(
   program.command("generate").description("Create a GitHub issue via Claude Code Headless").requiredOption("--prompt <text>", "Issue description text")
 ).action(async (options) => {
-  const { runGenerate } = await import("./generate-HP4CPMJG.js");
+  const { runGenerate } = await import("./generate-5OWWNRIB.js");
   const code = await runGenerate(options.prompt);
   process.exit(code);
 });
-withGlobalOptions(
-  program.command("run").description("Execute the full pipeline: analyze \u2192 prd \u2192 plan \u2192 execute \u2192 review \u2192 pr").argument("<issue>", "Issue number").option("--mode <mode>", "Execution mode: auto | manual", "auto").option("--from <phase>", "Resume from a specific phase")
+withWebOptions(
+  withGlobalOptions(
+    program.command("run").description("Execute the full pipeline: prd \u2192 plan \u2192 execute \u2192 review \u2192 pr").argument("<issue>", "Issue number").option("--mode <mode>", "Execution mode: auto | manual", "auto").option("--from <phase>", "Resume from a specific phase").option("--no-branch", "Run pipeline on current branch without creating a new branch or PR")
+  )
 ).action(async (issue, options) => {
-  const { runPipeline } = await import("./run-PKHPULYL.js");
-  const code = await runPipeline(issue, options.mode, options.from);
+  const { runPipeline } = await import("./run-UCSNYSQO.js");
+  const code = await runPipeline(issue, options.mode, options.from, options.noBranch);
   process.exit(code);
 });
 withGlobalOptions(
   program.command("analyze").description("Analyze a GitHub issue via Claude Code Headless").argument("<issue>", "Issue number")
 ).action(async (issue) => {
-  const { runAnalyze } = await import("./analyze-3SN7ZAZU.js");
+  const { runAnalyze } = await import("./analyze-IJ2SYXVM.js");
   const code = await runAnalyze(issue);
   process.exit(code);
 });
 withGlobalOptions(
   program.command("prd").description("Generate a PRD from an analyzed issue via Claude Code Headless").argument("<issue>", "Issue number")
 ).action(async (issue) => {
-  const { runPrd } = await import("./prd-ET2QN7GB.js");
+  const { runPrd } = await import("./prd-WB3QH6QF.js");
   const code = await runPrd(issue);
   process.exit(code);
 });
 withGlobalOptions(
   program.command("plan").description("Convert a PRD to a tasks.json task plan via Claude Code Headless").argument("<issue>", "Issue number")
 ).action(async (issue) => {
-  const { runPlan } = await import("./plan-HWZRG5GP.js");
+  const { runPlan } = await import("./plan-RQXK2OCP.js");
   const code = await runPlan(issue);
   process.exit(code);
 });
-withGlobalOptions(
-  program.command("execute").description("Run the iterative story execution loop (issue-flow engine)").option("--issue <number>", "Issue number \u2014 reads artifacts from issues/N/").option("--max-iterations <number>", "Stop after N iterations", parseInteger).option(
-    "--retry-limit <number>",
-    "Retry transient Claude failures up to N consecutive times",
-    parseInteger
-  ).option("--retry-forever", "Retry transient Claude failures indefinitely").argument("[max-iterations]", "Backward-compatible alias for --max-iterations N", parseInteger)
+withWebOptions(
+  withGlobalOptions(
+    program.command("execute").description("Run the iterative story execution loop (issue-flow engine)").option("--issue <number>", "Issue number \u2014 reads artifacts from issues/N/").option("--max-iterations <number>", "Stop after N iterations", parseInteger).option(
+      "--retry-limit <number>",
+      "Retry transient Claude failures up to N consecutive times",
+      parseInteger
+    ).option("--retry-forever", "Retry transient Claude failures indefinitely").argument(
+      "[max-iterations]",
+      "Backward-compatible alias for --max-iterations N",
+      parseInteger
+    )
+  )
 ).action(
   async (positionalMaxIter, options) => {
     try {
-      const { runExecute } = await import("./execute-GIA4IKS5.js");
+      const { runExecute } = await import("./execute-DALVYZIH.js");
       const code = await runExecute(positionalMaxIter, options);
       process.exit(code);
     } catch (error) {
@@ -100,14 +137,14 @@ withGlobalOptions(
 withGlobalOptions(
   program.command("review").description("Validate an issue resolution via Claude Code Headless").argument("<issue>", "Issue number")
 ).action(async (issue) => {
-  const { runReview } = await import("./review-3QDZCOMT.js");
+  const { runReview } = await import("./review-2WHYJG7M.js");
   const code = await runReview(issue);
   process.exit(code);
 });
 withGlobalOptions(
   program.command("pr").description("Create a pull request via Claude Code Headless").argument("<issue>", "Issue number")
 ).action(async (issue) => {
-  const { runPr } = await import("./pr-TTOFYUCV.js");
+  const { runPr } = await import("./pr-UU4H7ZZR.js");
   const code = await runPr(issue);
   process.exit(code);
 });