issue-flow 0.3.0

package/README.md

@@ -0,0 +1,226 @@
+# issue-flow
+
+> This is the npm package README. For full project documentation, see the [root README](../../README.md).
+
+Unified CLI that orchestrates the full issue-to-PR pipeline via [Claude Code](https://docs.anthropic.com/en/docs/claude-code) Headless mode. Analyzes issues, generates PRDs, creates task plans, implements code iteratively, reviews results, and opens pull requests -- all programmatically, without interactive sessions.
+
+Built on the [Ralph pattern](https://ghuntley.com/ralph/) for autonomous AI agent loops.
+
+## Pipeline Flow
+
+```mermaid
+flowchart LR
+    subgraph "issue-flow run 42"
+        A["init"] --> B["analyze"]
+        B --> C["prd"]
+        C --> D["plan"]
+        D --> E["execute"]
+        E --> F["review"]
+        F --> G{PASS?}
+        G -- Yes --> H["pr"]
+        G -- No --> I{"Retries\n< max?"}
+        I -- Yes --> E
+        I -- No --> J["Stop"]
+    end
+```
+
+## Requirements
+
+- **Node.js** >= 18.0.0
+- **git** installed and available in PATH
+- **Claude Code** (`npm install -g @anthropic-ai/claude-code`)
+- **GitHub CLI** (`gh`) authenticated (`gh auth login`)
+
+Run `npx issue-flow init` to verify all prerequisites.
+
+## Installation
+
+```bash
+# Run directly via npx (no install needed)
+npx issue-flow run 42
+
+# Or install globally
+npm install -g issue-flow
+issue-flow run 42
+```
+
+## Commands
+
+### `run` -- Full pipeline (end-to-end)
+
+```bash
+# Run the complete pipeline for an issue
+npx issue-flow run 42
+
+# Resume from a specific phase
+npx issue-flow run 42 --from execute
+
+# Manual mode (artifacts only, no execution)
+npx issue-flow run 42 --mode manual
+```
+
+Executes all phases in order: **init** → **analyze** → **prd** → **plan** → **execute** → **review** → **pr**. Automatically resumes from the last incomplete phase if pipeline state exists. On review failure, runs correction cycles (re-execute + re-review) up to `maxCorrectionCycles`.
+
+### `init` -- Check prerequisites
+
+```bash
+npx issue-flow init
+```
+
+Verifies that `claude`, `gh` (authenticated), and `git` (inside a repo) are available. Reports pass/fail for each with install hints.
+
+### `analyze` -- Analyze an issue
+
+```bash
+npx issue-flow analyze 42
+```
+
+Invokes Claude headlessly to fetch issue data, analyze the codebase, and produce a structured analysis saved to `issues/42/analysis.md`.
+
+### `prd` -- Generate a PRD
+
+```bash
+npx issue-flow prd 42
+```
+
+Generates a Product Requirements Document from the issue analysis. Reads `issues/N/analysis.md` as context if available. Saves to `issues/42/prd.md`.
+
+### `plan` -- Convert PRD to task plan
+
+```bash
+npx issue-flow plan 42
+```
+
+Converts the PRD into a structured `issues/42/tasks.json` with ordered user stories, acceptance criteria, and pipeline state. Validates the output with zod schemas.
+
+### `execute` -- Run the story execution loop
+
+```bash
+npx issue-flow execute --issue 42
+npx issue-flow execute --issue 42 --max-iterations 15
+npx issue-flow execute --issue 42 --retry-forever
+```
+
+Runs the iterative agent loop. Each iteration is a fresh Claude instance that picks the next pending story, implements it, runs quality checks, and commits.
+
+| Flag | Description |
+|------|-------------|
+| `--issue N` | Issue number -- reads artifacts from `issues/N/` |
+| `--max-iterations N` | Stop after N iterations (default: unlimited) |
+| `--retry-limit N` | Retry transient Claude failures up to N consecutive times (default: 10) |
+| `--retry-forever` | Retry transient Claude failures indefinitely |
+
+### `review` -- Validate the implementation
+
+```bash
+npx issue-flow review 42
+```
+
+Invokes Claude headlessly to verify acceptance criteria, run tests, and check for regressions. Outputs `PASS` or `FAIL` with findings.
+
+### `pr` -- Create a pull request
+
+```bash
+npx issue-flow pr 42
+```
+
+Creates a well-structured PR referencing the issue, with summary and test plan.
+
+### `generate` -- Create a new issue
+
+```bash
+npx issue-flow generate --prompt "Add dark mode support to the settings page"
+```
+
+Analyzes the project and creates a detailed GitHub issue via Claude headless.
+
+## Pipeline State
+
+Each issue's state is tracked in `issues/N/tasks.json`:
+
+```
+issues/42/
+  analysis.md    # Issue analysis
+  prd.md         # Product requirements
+  tasks.json     # Task plan with pipeline state and user stories
+  progress.txt   # Execution log
+```
+
+The `pipeline` field tracks which phases have completed, enabling resume from any point:
+
+```json
+{
+  "pipeline": {
+    "analyzeCompleted": true,
+    "prdCompleted": true,
+    "jsonCompleted": true,
+    "executionCompleted": false,
+    "reviewCompleted": false,
+    "prCreated": false
+  }
+}
+```
+
+## Architecture
+
+```
+src/
+  cli.ts                  # Entry point, subcommand registration (commander)
+  config.ts               # Configuration resolution and defaults
+  types.ts                # Shared TypeScript interfaces
+  schemas.ts              # Zod validation schemas
+  commands/
+    init.ts               # Prerequisite verification
+    generate.ts           # Headless issue creation
+    run.ts                # Full pipeline orchestrator
+    analyze.ts            # Headless issue analysis
+    prd.ts                # Headless PRD generation
+    plan.ts               # Headless PRD-to-JSON conversion
+    execute.ts            # Iterative story execution (engine wrapper)
+    review.ts             # Headless implementation review
+    pr.ts                 # Headless PR creation
+  core/
+    engine.ts             # Main agent loop
+    executor.ts           # Claude CLI invocation via execa
+    headless.ts           # Typed wrapper for claude -p invocations
+    pipeline.ts           # Pipeline state machine
+    state-manager.ts      # Typed CRUD for tasks.json
+    prompt-resolver.ts    # Prompt resolution and templating
+  ui/
+    logger.ts             # Colored logging utilities
+    progress.ts           # Progress bar and iteration headers
+    summary.ts            # Box drawing and summary display
+  utils/
+    shell.ts              # Shell command execution
+    git.ts                # Git operations
+    retry.ts              # Transient failure detection and backoff
+```
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Type check
+npm run typecheck
+
+# Run tests
+npm test
+
+# Watch mode
+npm run dev
+```
+
+For the full development setup, local testing, and NPM publishing guide, see [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## Credits
+
+Based on [Geoffrey Huntley's Ralph pattern](https://ghuntley.com/ralph/) and the [snarktank/ralph](https://github.com/snarktank/ralph) repository.
+
+## See Also
+
+- [Skills & Sub-Agent Architecture](../../docs/skills-and-agents.md) -- Using Issue Flow interactively via Claude Code skills and the `resolve-issue` sub-agent.

package/dist/analyze-YYQQP64A.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import {
+  runAnalyze
+} from "./chunk-7APADNBV.js";
+import "./chunk-PINC2LST.js";
+import "./chunk-64FU2L2T.js";
+import "./chunk-OZVHOVDT.js";
+import "./chunk-L7RIGFP6.js";
+export {
+  runAnalyze
+};
+//# sourceMappingURL=analyze-YYQQP64A.js.map

package/dist/analyze-YYQQP64A.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-64FU2L2T.js

@@ -0,0 +1,180 @@
+#!/usr/bin/env node
+
+// src/schemas.ts
+import { z } from "zod";
+var userStorySchema = z.object({
+  id: z.string(),
+  title: z.string(),
+  description: z.string(),
+  acceptanceCriteria: z.array(z.string()),
+  priority: z.number().int().positive(),
+  passes: z.boolean(),
+  notes: z.string()
+});
+var pipelineStateSchema = z.object({
+  analyzeCompleted: z.boolean(),
+  prdCompleted: z.boolean(),
+  jsonCompleted: z.boolean(),
+  executionCompleted: z.boolean(),
+  reviewCompleted: z.boolean(),
+  prCreated: z.boolean()
+});
+var lastErrorSchema = z.object({
+  category: z.string(),
+  message: z.string(),
+  at: z.string()
+});
+var taskPlanSchema = z.object({
+  project: z.string(),
+  issueNumber: z.number().int().positive(),
+  issueUrl: z.string(),
+  branchName: z.string(),
+  description: z.string(),
+  issueStatus: z.enum(["pending", "in_progress", "completed"]),
+  completedAt: z.string().nullable(),
+  lastAttemptAt: z.string().nullable(),
+  lastError: lastErrorSchema.nullable(),
+  correctionCycle: z.number().int().min(0),
+  maxCorrectionCycles: z.number().int().min(0),
+  pipeline: pipelineStateSchema,
+  userStories: z.array(userStorySchema)
+});
+var headlessResultSchema = z.object({
+  success: z.boolean(),
+  result: z.string(),
+  cost: z.object({
+    inputTokens: z.number().optional(),
+    outputTokens: z.number().optional()
+  }).nullable(),
+  error: z.string().nullable()
+});
+
+// src/core/state-manager.ts
+import { copyFile, mkdtemp, readFile, rename, unlink, writeFile } from "fs/promises";
+import { tmpdir } from "os";
+import { join } from "path";
+import { ZodError } from "zod";
+function isoNow() {
+  return (/* @__PURE__ */ new Date()).toISOString().replace(/\.\d{3}Z$/, "Z");
+}
+async function loadTaskPlan(path) {
+  const content = await readFile(path, "utf-8");
+  const raw = JSON.parse(content);
+  try {
+    return taskPlanSchema.parse(raw);
+  } catch (err) {
+    if (err instanceof ZodError) {
+      const issues = err.issues.map((i) => `  - ${i.path.join(".")}: ${i.message}`).join("\n");
+      throw new Error(`Invalid tasks.json at ${path}:
+${issues}`);
+    }
+    throw err;
+  }
+}
+async function saveTaskPlan(path, plan) {
+  const tmpDir = await mkdtemp(join(tmpdir(), "issue-flow-task-plan-"));
+  const tmpFile = join(tmpDir, "tasks.json");
+  await writeFile(tmpFile, `${JSON.stringify(plan, null, 2)}
+`, "utf-8");
+  try {
+    await rename(tmpFile, path);
+  } catch (err) {
+    if (err.code === "EXDEV") {
+      await copyFile(tmpFile, path);
+      await unlink(tmpFile);
+    } else {
+      throw err;
+    }
+  }
+}
+function initializeState(plan) {
+  const defaultPipeline = {
+    analyzeCompleted: false,
+    prdCompleted: false,
+    jsonCompleted: false,
+    executionCompleted: false,
+    reviewCompleted: false,
+    prCreated: false
+  };
+  return {
+    ...plan,
+    issueStatus: plan.issueStatus ?? "pending",
+    completedAt: plan.completedAt ?? null,
+    lastAttemptAt: plan.lastAttemptAt ?? null,
+    lastError: plan.lastError ?? null,
+    correctionCycle: plan.correctionCycle ?? 0,
+    maxCorrectionCycles: plan.maxCorrectionCycles ?? 3,
+    pipeline: plan.pipeline ? { ...defaultPipeline, ...plan.pipeline } : defaultPipeline
+  };
+}
+function allStoriesPass(plan) {
+  if (plan.userStories.length === 0) {
+    return false;
+  }
+  return plan.userStories.every((story) => story.passes === true);
+}
+function markIssueInProgress(plan, timestamp) {
+  const ts = timestamp ?? isoNow();
+  return {
+    ...plan,
+    issueStatus: "in_progress",
+    completedAt: null,
+    lastAttemptAt: ts
+  };
+}
+function markIssueCompleted(plan) {
+  const ts = isoNow();
+  return {
+    ...plan,
+    issueStatus: "completed",
+    completedAt: ts,
+    lastAttemptAt: ts,
+    lastError: null,
+    pipeline: plan.pipeline ? { ...plan.pipeline, executionCompleted: true } : plan.pipeline
+  };
+}
+function setLastError(plan, category, message) {
+  const ts = isoNow();
+  const error = {
+    category,
+    message,
+    at: ts
+  };
+  return {
+    ...plan,
+    lastAttemptAt: ts,
+    lastError: error
+  };
+}
+function clearLastError(plan, attemptStartedAt) {
+  const ts = isoNow();
+  if (plan.lastError && plan.lastError.at > attemptStartedAt) {
+    return {
+      ...plan,
+      lastAttemptAt: ts
+    };
+  }
+  return {
+    ...plan,
+    lastAttemptAt: ts,
+    lastError: null
+  };
+}
+function trimErrorMessage(message) {
+  return message.split("\n").filter((line) => line.trim().length > 0).slice(0, 8).join("\n");
+}
+
+export {
+  taskPlanSchema,
+  isoNow,
+  loadTaskPlan,
+  saveTaskPlan,
+  initializeState,
+  allStoriesPass,
+  markIssueInProgress,
+  markIssueCompleted,
+  setLastError,
+  clearLastError,
+  trimErrorMessage
+};
+//# sourceMappingURL=chunk-64FU2L2T.js.map

package/dist/chunk-64FU2L2T.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schemas.ts","../src/core/state-manager.ts"],"sourcesContent":["import { z } from 'zod';\n\n/**\n * Zod schemas for validating tasks.json structure and headless invocation outputs.\n */\n\nexport const userStorySchema = z.object({\n  id: z.string(),\n  title: z.string(),\n  description: z.string(),\n  acceptanceCriteria: z.array(z.string()),\n  priority: z.number().int().positive(),\n  passes: z.boolean(),\n  notes: z.string(),\n});\n\nexport const pipelineStateSchema = z.object({\n  analyzeCompleted: z.boolean(),\n  prdCompleted: z.boolean(),\n  jsonCompleted: z.boolean(),\n  executionCompleted: z.boolean(),\n  reviewCompleted: z.boolean(),\n  prCreated: z.boolean(),\n});\n\nconst lastErrorSchema = z.object({\n  category: z.string(),\n  message: z.string(),\n  at: z.string(),\n});\n\nexport const taskPlanSchema = z.object({\n  project: z.string(),\n  issueNumber: z.number().int().positive(),\n  issueUrl: z.string(),\n  branchName: z.string(),\n  description: z.string(),\n  issueStatus: z.enum(['pending', 'in_progress', 'completed']),\n  completedAt: z.string().nullable(),\n  lastAttemptAt: z.string().nullable(),\n  lastError: lastErrorSchema.nullable(),\n  correctionCycle: z.number().int().min(0),\n  maxCorrectionCycles: z.number().int().min(0),\n  pipeline: pipelineStateSchema,\n  userStories: z.array(userStorySchema),\n});\n\nexport const headlessResultSchema = z.object({\n  success: z.boolean(),\n  result: z.string(),\n  cost: z\n    .object({\n      inputTokens: z.number().optional(),\n      outputTokens: z.number().optional(),\n    })\n    .nullable(),\n  error: z.string().nullable(),\n});\n\nexport type ValidatedTaskPlan = z.infer<typeof taskPlanSchema>;\nexport type ValidatedHeadlessResult = z.infer<typeof headlessResultSchema>;\n","import { copyFile, mkdtemp, readFile, rename, unlink, writeFile } from 'node:fs/promises';\nimport { tmpdir } from 'node:os';\nimport { join } from 'node:path';\nimport { ZodError } from 'zod';\nimport { taskPlanSchema } from '../schemas.js';\nimport type { LastError, PipelineState, TaskPlan } from '../types.js';\n\n/**\n * Get the current ISO timestamp.\n */\nexport function isoNow(): string {\n  return new Date().toISOString().replace(/\\.\\d{3}Z$/, 'Z');\n}\n\n/**\n * Load and parse a tasks.json file.\n * Validates that it has the expected structure.\n */\nexport async function loadTaskPlan(path: string): Promise<TaskPlan> {\n  const content = await readFile(path, 'utf-8');\n  const raw = JSON.parse(content);\n\n  try {\n    return taskPlanSchema.parse(raw) as TaskPlan;\n  } catch (err) {\n    if (err instanceof ZodError) {\n      const issues = err.issues.map((i) => `  - ${i.path.join('.')}: ${i.message}`).join('\\n');\n      throw new Error(`Invalid tasks.json at ${path}:\\n${issues}`);\n    }\n    throw err;\n  }\n}\n\n/**\n * Save a TaskPlan to disk atomically (write-to-temp + rename).\n * This prevents corruption if the process is interrupted during write.\n */\nexport async function saveTaskPlan(path: string, plan: TaskPlan): Promise<void> {\n  const tmpDir = await mkdtemp(join(tmpdir(), 'issue-flow-task-plan-'));\n  const tmpFile = join(tmpDir, 'tasks.json');\n\n  await writeFile(tmpFile, `${JSON.stringify(plan, null, 2)}\\n`, 'utf-8');\n\n  try {\n    await rename(tmpFile, path);\n  } catch (err: unknown) {\n    // EXDEV: rename fails across different devices/drives (common on Windows)\n    if ((err as NodeJS.ErrnoException).code === 'EXDEV') {\n      await copyFile(tmpFile, path);\n      await unlink(tmpFile);\n    } else {\n      throw err;\n    }\n  }\n}\n\n/**\n * Initialize default state fields on a TaskPlan.\n * Fills in missing fields with defaults, matching the Bash script behavior.\n */\nexport function initializeState(plan: TaskPlan): TaskPlan {\n  const defaultPipeline: PipelineState = {\n    analyzeCompleted: false,\n    prdCompleted: false,\n    jsonCompleted: false,\n    executionCompleted: false,\n    reviewCompleted: false,\n    prCreated: false,\n  };\n\n  return {\n    ...plan,\n    issueStatus: plan.issueStatus ?? 'pending',\n    completedAt: plan.completedAt ?? null,\n    lastAttemptAt: plan.lastAttemptAt ?? null,\n    lastError: plan.lastError ?? null,\n    correctionCycle: plan.correctionCycle ?? 0,\n    maxCorrectionCycles: plan.maxCorrectionCycles ?? 3,\n    pipeline: plan.pipeline ? { ...defaultPipeline, ...plan.pipeline } : defaultPipeline,\n  };\n}\n\n/**\n * Check if all user stories have passes=true.\n * Returns false if there are no stories.\n */\nexport function allStoriesPass(plan: TaskPlan): boolean {\n  if (plan.userStories.length === 0) {\n    return false;\n  }\n\n  return plan.userStories.every((story) => story.passes === true);\n}\n\n/**\n * Mark a specific story as passing.\n */\nexport function markStoryPassing(plan: TaskPlan, storyId: string): TaskPlan {\n  return {\n    ...plan,\n    userStories: plan.userStories.map((story) =>\n      story.id === storyId ? { ...story, passes: true } : story,\n    ),\n  };\n}\n\n/**\n * Mark the issue as in_progress.\n */\nexport function markIssueInProgress(plan: TaskPlan, timestamp?: string): TaskPlan {\n  const ts = timestamp ?? isoNow();\n  return {\n    ...plan,\n    issueStatus: 'in_progress',\n    completedAt: null,\n    lastAttemptAt: ts,\n  };\n}\n\n/**\n * Mark the issue as completed.\n */\nexport function markIssueCompleted(plan: TaskPlan): TaskPlan {\n  const ts = isoNow();\n  return {\n    ...plan,\n    issueStatus: 'completed',\n    completedAt: ts,\n    lastAttemptAt: ts,\n    lastError: null,\n    pipeline: plan.pipeline ? { ...plan.pipeline, executionCompleted: true } : plan.pipeline,\n  };\n}\n\n/**\n * Set the lastError field on the task plan.\n */\nexport function setLastError(plan: TaskPlan, category: string, message: string): TaskPlan {\n  const ts = isoNow();\n  const error: LastError = {\n    category,\n    message,\n    at: ts,\n  };\n\n  return {\n    ...plan,\n    lastAttemptAt: ts,\n    lastError: error,\n  };\n}\n\n/**\n * Clear the lastError field, but only if it was set before the attempt started.\n * This prevents clearing errors that were set during the current attempt.\n */\nexport function clearLastError(plan: TaskPlan, attemptStartedAt: string): TaskPlan {\n  const ts = isoNow();\n\n  // If the error was set after the attempt started, keep it\n  if (plan.lastError && plan.lastError.at > attemptStartedAt) {\n    return {\n      ...plan,\n      lastAttemptAt: ts,\n    };\n  }\n\n  return {\n    ...plan,\n    lastAttemptAt: ts,\n    lastError: null,\n  };\n}\n\n/**\n * Trim an error message to at most 8 non-empty lines.\n */\nexport function trimErrorMessage(message: string): string {\n  return message\n    .split('\\n')\n    .filter((line) => line.trim().length > 0)\n    .slice(0, 8)\n    .join('\\n');\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-7APADNBV.js

@@ -0,0 +1,68 @@
+#!/usr/bin/env node
+import {
+  runHeadless
+} from "./chunk-PINC2LST.js";
+import {
+  loadTaskPlan,
+  saveTaskPlan
+} from "./chunk-64FU2L2T.js";
+import {
+  applyPlaceholders,
+  loadPrompt
+} from "./chunk-OZVHOVDT.js";
+import {
+  printError,
+  printInfo,
+  printSuccess
+} from "./chunk-L7RIGFP6.js";
+
+// src/commands/analyze.ts
+import { mkdir, readFile, writeFile } from "fs/promises";
+import { join } from "path";
+async function runAnalyze(issue) {
+  const issueNumber = issue.replace(/^#/, "");
+  const issueDir = join("issues", issueNumber);
+  const analysisPath = join(issueDir, "analysis.md");
+  printInfo(`Analyzing issue #${issueNumber}...`);
+  await mkdir(issueDir, { recursive: true });
+  const template = await loadPrompt("analyze");
+  const prompt = applyPlaceholders(template, {
+    __ISSUE_NUMBER__: issueNumber,
+    __ANALYSIS_PATH__: analysisPath
+  });
+  const result = await runHeadless({
+    prompt,
+    maxTurns: 15,
+    timeout: 12e4,
+    outputFormat: "text",
+    allowedTools: ["Bash", "Read", "Glob", "Grep", "Write"]
+  });
+  if (!result.success) {
+    printError(`Analysis failed: ${result.error}`);
+    return 1;
+  }
+  try {
+    const content = await readFile(analysisPath, "utf-8");
+    if (content.length < 10) {
+      printError("Analysis file was created but appears empty");
+      return 1;
+    }
+  } catch {
+    printInfo("Headless did not create analysis file; saving output directly");
+    await writeFile(analysisPath, result.result, "utf-8");
+  }
+  const tasksPath = join(issueDir, "tasks.json");
+  try {
+    const plan = await loadTaskPlan(tasksPath);
+    plan.pipeline.analyzeCompleted = true;
+    await saveTaskPlan(tasksPath, plan);
+  } catch {
+  }
+  printSuccess(`Analysis saved to ${analysisPath}`);
+  return 0;
+}
+
+export {
+  runAnalyze
+};
+//# sourceMappingURL=chunk-7APADNBV.js.map

package/dist/chunk-7APADNBV.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 { printError, printInfo, printSuccess } from '../ui/logger.js';\n\nexport async function runAnalyze(issue: string): Promise<number> {\n  const issueNumber = issue.replace(/^#/, '');\n  const issueDir = join('issues', issueNumber);\n  const analysisPath = join(issueDir, 'analysis.md');\n\n  printInfo(`Analyzing issue #${issueNumber}...`);\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  });\n\n  const result = await runHeadless({\n    prompt,\n    maxTurns: 15,\n    timeout: 120_000,\n    outputFormat: 'text',\n    allowedTools: ['Bash', 'Read', 'Glob', 'Grep', 'Write'],\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;AAMrB,eAAsB,WAAW,OAAgC;AAC/D,QAAM,cAAc,MAAM,QAAQ,MAAM,EAAE;AAC1C,QAAM,WAAW,KAAK,UAAU,WAAW;AAC3C,QAAM,eAAe,KAAK,UAAU,aAAa;AAEjD,YAAU,oBAAoB,WAAW,KAAK;AAE9C,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,EACrB,CAAC;AAED,QAAM,SAAS,MAAM,YAAY;AAAA,IAC/B;AAAA,IACA,UAAU;AAAA,IACV,SAAS;AAAA,IACT,cAAc;AAAA,IACd,cAAc,CAAC,QAAQ,QAAQ,QAAQ,QAAQ,OAAO;AAAA,EACxD,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-7FRXZ2XA.js

@@ -0,0 +1,78 @@
+#!/usr/bin/env node
+import {
+  runHeadless
+} from "./chunk-PINC2LST.js";
+import {
+  loadTaskPlan,
+  saveTaskPlan
+} from "./chunk-64FU2L2T.js";
+import {
+  applyPlaceholders,
+  loadPrompt
+} from "./chunk-OZVHOVDT.js";
+import {
+  printError,
+  printInfo,
+  printSuccess
+} from "./chunk-L7RIGFP6.js";
+
+// src/commands/pr.ts
+import { join } from "path";
+import { execa } from "execa";
+function parsePrUrl(output) {
+  const match = output.match(/(https:\/\/github\.com\/[^\s]+\/pull\/\d+)/);
+  return match?.[1] ?? null;
+}
+async function runPr(issue) {
+  const issueNumber = issue.replace(/^#/, "");
+  const issueDir = join("issues", issueNumber);
+  const tasksPath = join(issueDir, "tasks.json");
+  printInfo(`Creating PR for issue #${issueNumber}...`);
+  let branchName;
+  try {
+    const proc = await execa("git", ["branch", "--show-current"], { reject: false });
+    branchName = proc.stdout?.toString().trim() ?? "";
+    if (!branchName) {
+      printError("Could not determine current branch");
+      return 1;
+    }
+  } catch {
+    printError("Failed to get current branch");
+    return 1;
+  }
+  const template = await loadPrompt("pr");
+  const prompt = applyPlaceholders(template, {
+    __ISSUE_NUMBER__: issueNumber,
+    __BRANCH_NAME__: branchName,
+    __TASKS_PATH__: tasksPath
+  });
+  const result = await runHeadless({
+    prompt,
+    maxTurns: 15,
+    timeout: 12e4,
+    outputFormat: "text",
+    allowedTools: ["Bash", "Read", "Glob", "Grep"]
+  });
+  if (!result.success) {
+    printError(`PR creation failed: ${result.error}`);
+    return 1;
+  }
+  const prUrl = parsePrUrl(result.result);
+  try {
+    const plan = await loadTaskPlan(tasksPath);
+    plan.pipeline.prCreated = true;
+    await saveTaskPlan(tasksPath, plan);
+  } catch {
+  }
+  if (prUrl) {
+    printSuccess(`PR created: ${prUrl}`);
+  } else {
+    printSuccess("PR creation completed");
+  }
+  return 0;
+}
+
+export {
+  runPr
+};
+//# sourceMappingURL=chunk-7FRXZ2XA.js.map

package/dist/chunk-7FRXZ2XA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/pr.ts"],"sourcesContent":["import { join } from 'node:path';\nimport { execa } from 'execa';\nimport { runHeadless } from '../core/headless.js';\nimport { applyPlaceholders, loadPrompt } from '../core/prompt-resolver.js';\nimport { loadTaskPlan, saveTaskPlan } from '../core/state-manager.js';\nimport { printError, printInfo, printSuccess } from '../ui/logger.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\nexport async function runPr(issue: string): Promise<number> {\n  const issueNumber = issue.replace(/^#/, '');\n  const issueDir = join('issues', issueNumber);\n  const tasksPath = join(issueDir, 'tasks.json');\n\n  printInfo(`Creating PR for issue #${issueNumber}...`);\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  });\n\n  const result = await runHeadless({\n    prompt,\n    maxTurns: 15,\n    timeout: 120_000,\n    outputFormat: 'text',\n    allowedTools: ['Bash', 'Read', 'Glob', 'Grep'],\n  });\n\n  if (!result.success) {\n    printError(`PR creation failed: ${result.error}`);\n    return 1;\n  }\n\n  const prUrl = parsePrUrl(result.result);\n\n  // Update pipeline state\n  try {\n    const plan = await loadTaskPlan(tasksPath);\n    plan.pipeline.prCreated = true;\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":";;;;;;;;;;;;;;;;;;;AAAA,SAAS,YAAY;AACrB,SAAS,aAAa;AAStB,SAAS,WAAW,QAA+B;AACjD,QAAM,QAAQ,OAAO,MAAM,4CAA4C;AACvE,SAAO,QAAQ,CAAC,KAAK;AACvB;AAEA,eAAsB,MAAM,OAAgC;AAC1D,QAAM,cAAc,MAAM,QAAQ,MAAM,EAAE;AAC1C,QAAM,WAAW,KAAK,UAAU,WAAW;AAC3C,QAAM,YAAY,KAAK,UAAU,YAAY;AAE7C,YAAU,0BAA0B,WAAW,KAAK;AAGpD,MAAI;AACJ,MAAI;AACF,UAAM,OAAO,MAAM,MAAM,OAAO,CAAC,UAAU,gBAAgB,GAAG,EAAE,QAAQ,MAAM,CAAC;AAC/E,iBAAa,KAAK,QAAQ,SAAS,EAAE,KAAK,KAAK;AAC/C,QAAI,CAAC,YAAY;AACf,iBAAW,oCAAoC;AAC/C,aAAO;AAAA,IACT;AAAA,EACF,QAAQ;AACN,eAAW,8BAA8B;AACzC,WAAO;AAAA,EACT;AAEA,QAAM,WAAW,MAAM,WAAW,IAAI;AACtC,QAAM,SAAS,kBAAkB,UAAU;AAAA,IACzC,kBAAkB;AAAA,IAClB,iBAAiB;AAAA,IACjB,gBAAgB;AAAA,EAClB,CAAC;AAED,QAAM,SAAS,MAAM,YAAY;AAAA,IAC/B;AAAA,IACA,UAAU;AAAA,IACV,SAAS;AAAA,IACT,cAAc;AAAA,IACd,cAAc,CAAC,QAAQ,QAAQ,QAAQ,MAAM;AAAA,EAC/C,CAAC;AAED,MAAI,CAAC,OAAO,SAAS;AACnB,eAAW,uBAAuB,OAAO,KAAK,EAAE;AAChD,WAAO;AAAA,EACT;AAEA,QAAM,QAAQ,WAAW,OAAO,MAAM;AAGtC,MAAI;AACF,UAAM,OAAO,MAAM,aAAa,SAAS;AACzC,SAAK,SAAS,YAAY;AAC1B,UAAM,aAAa,WAAW,IAAI;AAAA,EACpC,QAAQ;AAAA,EAER;AAEA,MAAI,OAAO;AACT,iBAAa,eAAe,KAAK,EAAE;AAAA,EACrC,OAAO;AACL,iBAAa,uBAAuB;AAAA,EACtC;AACA,SAAO;AACT;","names":[]}