forge-cc 0.1.0

package/dist/go/executor.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Milestone Execution Engine
+ *
+ * Programmatic module that reads a PRD milestone definition, prepares
+ * wave-based agent prompts, tracks results, runs verification between
+ * waves, and produces structured output.
+ *
+ * This module does NOT spawn agents — that is the skill file's job
+ * (via Claude Code's Task tool). The executor is the data/logic layer.
+ */
+import type { SessionContext } from "../state/reader.js";
+import type { ForgeConfig, PipelineResult } from "../types.js";
+import type { MilestoneWave } from "../spec/templates.js";
+export interface ExecuteMilestoneOptions {
+    projectDir: string;
+    prdPath: string;
+    milestoneNumber: number;
+    config: ForgeConfig;
+    /** Log prompts but don't run verification (for testing) */
+    dryRun?: boolean;
+}
+export interface AgentPrompt {
+    name: string;
+    task: string;
+    files: string[];
+    prompt: string;
+}
+export interface WaveExecution {
+    waveNumber: number;
+    agents: AgentPrompt[];
+}
+export interface AgentResult {
+    name: string;
+    task: string;
+    success: boolean;
+    error?: string;
+    filesCreated: string[];
+    filesModified: string[];
+}
+export interface WaveResult {
+    waveNumber: number;
+    agents: AgentResult[];
+    verification: PipelineResult | null;
+}
+export interface ExecutionResult {
+    milestoneNumber: number;
+    milestoneName: string;
+    success: boolean;
+    waves: WaveResult[];
+    totalFilesCreated: number;
+    totalFilesModified: number;
+    errors: string[];
+}
+export interface MilestoneContext {
+    milestoneNumber: number;
+    milestoneName: string;
+    milestoneGoal: string;
+    milestoneSection: string;
+    waves: MilestoneWave[];
+    verificationCommands: string[];
+    sessionContext: SessionContext;
+    lessons: string;
+    claudeMd: string;
+}
+/**
+ * Build the full context needed to execute a milestone.
+ * Reads STATE.md, ROADMAP.md, PRD milestone section, CLAUDE.md, and lessons.
+ */
+export declare function buildMilestoneContext(options: ExecuteMilestoneOptions): Promise<MilestoneContext>;
+/**
+ * Build a prompt for a single agent within a milestone wave.
+ *
+ * The prompt includes:
+ * - The agent's specific task and files
+ * - Milestone goal and context
+ * - Key existing code (inlined, not just paths)
+ * - Lessons from tasks/lessons.md
+ * - CLAUDE.md rules (abbreviated)
+ */
+export declare function buildAgentPrompt(agent: MilestoneWave["agents"][number], context: MilestoneContext, existingCode?: string): string;
+/**
+ * Prepare all waves for execution.
+ * Returns structured wave data with agent prompts ready for the skill
+ * to pass to Claude Code's Task tool.
+ */
+export declare function prepareWaves(context: MilestoneContext, existingCodeMap?: Map<string, string>): WaveExecution[];
+/**
+ * Run forge verification pipeline after a wave completes.
+ * Returns the pipeline result with human-readable report.
+ */
+export declare function runWaveVerification(options: ExecuteMilestoneOptions): Promise<PipelineResult>;
+/**
+ * Create an empty execution result for a milestone.
+ */
+export declare function createExecutionResult(context: MilestoneContext): ExecutionResult;
+/**
+ * Record a completed wave's results into the execution result.
+ */
+export declare function recordWaveResult(execution: ExecutionResult, waveResult: WaveResult): ExecutionResult;
+/**
+ * Execute a single milestone end-to-end.
+ *
+ * In dryRun mode: builds context and prompts, runs no verification, returns
+ * the prepared execution plan.
+ *
+ * In normal mode: the caller (skill file) should use this module's functions
+ * step by step:
+ * 1. `buildMilestoneContext()` — read PRD and build context
+ * 2. `prepareWaves()` — get agent prompts for each wave
+ * 3. For each wave: spawn agents, collect results
+ * 4. `runWaveVerification()` — verify after each wave
+ * 5. `recordWaveResult()` — track results
+ *
+ * This `executeMilestone` function is the simplified orchestrator for
+ * programmatic/testing use. For real execution, the skill drives each step.
+ */
+export declare function executeMilestone(options: ExecuteMilestoneOptions): Promise<{
+    context: MilestoneContext;
+    waves: WaveExecution[];
+    result: ExecutionResult;
+}>;
+/**
+ * Format an execution result as a human-readable summary.
+ */
+export declare function formatExecutionSummary(result: ExecutionResult): string;
+/**
+ * Format verification errors into a structured prompt for fix agents.
+ * Used by the self-healing verify loop.
+ */
+export declare function formatErrorsForFixAgent(verification: PipelineResult): string;

package/dist/go/executor.js

@@ -0,0 +1,409 @@
+/**
+ * Milestone Execution Engine
+ *
+ * Programmatic module that reads a PRD milestone definition, prepares
+ * wave-based agent prompts, tracks results, runs verification between
+ * waves, and produces structured output.
+ *
+ * This module does NOT spawn agents — that is the skill file's job
+ * (via Claude Code's Task tool). The executor is the data/logic layer.
+ */
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { readSessionContext } from "../state/reader.js";
+import { runPipeline } from "../gates/index.js";
+import { formatHumanReport } from "../reporter/human.js";
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+async function safeRead(filePath) {
+    try {
+        return await readFile(filePath, "utf-8");
+    }
+    catch {
+        return "";
+    }
+}
+/**
+ * Parse a milestone section from PRD markdown into structured wave data.
+ *
+ * The PRD milestone section has this structure:
+ * ```
+ * ### Milestone N: Name
+ * **Assigned To:** ...
+ * **Goal:** ...
+ *
+ * **Wave 1 (N agents parallel):**
+ * 1. **agent-name**: task description
+ *    - Files: file1, file2
+ * ```
+ *
+ * If a structured Milestone object is available (from templates.ts schema),
+ * prefer using it directly. This parser handles the markdown fallback.
+ */
+function parseMilestoneSection(section) {
+    // Extract milestone name
+    const nameMatch = section.match(/###\s*Milestone\s+\d+\s*[:\u2014\u2013-]\s*(.+)/);
+    const name = nameMatch ? nameMatch[1].trim() : "Unknown Milestone";
+    // Extract goal
+    const goalMatch = section.match(/\*\*Goal:\*\*\s*(.+)/);
+    const goal = goalMatch ? goalMatch[1].trim() : "";
+    // Parse waves
+    const waves = [];
+    const wavePattern = /\*\*Wave\s+(\d+)\s*[^*]*\*\*:\s*\n([\s\S]*?)(?=\*\*Wave\s+\d+|\*\*Verification|\*\*Acceptance|$)/g;
+    let waveMatch;
+    while ((waveMatch = wavePattern.exec(section)) !== null) {
+        const waveNumber = parseInt(waveMatch[1], 10);
+        const waveBody = waveMatch[2];
+        const agents = [];
+        // Parse agent entries: "1. **agent-name**: task description"
+        const agentPattern = /\d+\.\s+\*\*([^*]+)\*\*[:\s]+([^\n]+)\n(?:\s+-\s+(?:Files|Creates|Modifies|Deletes):\s*([^\n]+)\n?)*/g;
+        let agentMatch;
+        while ((agentMatch = agentPattern.exec(waveBody)) !== null) {
+            const agentName = agentMatch[1].trim();
+            const agentTask = agentMatch[2].trim();
+            // Collect all file references from sub-items
+            const files = [];
+            const fileLinePattern = /\s+-\s+(?:Files|Creates|Modifies|Deletes):\s*([^\n]+)/g;
+            const agentBlock = waveBody.slice(agentMatch.index, agentPattern.lastIndex);
+            let fileMatch;
+            while ((fileMatch = fileLinePattern.exec(agentBlock)) !== null) {
+                const fileList = fileMatch[1]
+                    .split(",")
+                    .map((f) => f.trim())
+                    .filter(Boolean);
+                files.push(...fileList);
+            }
+            agents.push({ name: agentName, task: agentTask, files });
+        }
+        if (agents.length > 0) {
+            waves.push({ waveNumber, agents });
+        }
+    }
+    // Parse verification commands
+    const verificationCommands = [];
+    const verifySection = section.match(/\*\*Verification:\*\*\s*\n```(?:bash)?\s*\n([\s\S]*?)```/);
+    if (verifySection) {
+        const lines = verifySection[1].split("\n");
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (trimmed && !trimmed.startsWith("#")) {
+                verificationCommands.push(trimmed);
+            }
+        }
+    }
+    return { name, goal, waves, verificationCommands };
+}
+// ---------------------------------------------------------------------------
+// Context Building
+// ---------------------------------------------------------------------------
+/**
+ * Build the full context needed to execute a milestone.
+ * Reads STATE.md, ROADMAP.md, PRD milestone section, CLAUDE.md, and lessons.
+ */
+export async function buildMilestoneContext(options) {
+    const { projectDir, prdPath, milestoneNumber } = options;
+    // Read session context (STATE.md, ROADMAP.md, milestone section)
+    const sessionContext = await readSessionContext(projectDir, prdPath, milestoneNumber);
+    const milestoneSection = sessionContext.currentMilestoneSection;
+    if (!milestoneSection) {
+        throw new Error(`Milestone ${milestoneNumber} not found in PRD at ${prdPath}`);
+    }
+    // Parse the milestone section into structured data
+    const parsed = parseMilestoneSection(milestoneSection);
+    // Read supporting files
+    const [lessons, claudeMd] = await Promise.all([
+        safeRead(join(projectDir, "tasks", "lessons.md")),
+        safeRead(join(projectDir, "CLAUDE.md")),
+    ]);
+    return {
+        milestoneNumber,
+        milestoneName: parsed.name,
+        milestoneGoal: parsed.goal,
+        milestoneSection,
+        waves: parsed.waves,
+        verificationCommands: parsed.verificationCommands,
+        sessionContext,
+        lessons,
+        claudeMd,
+    };
+}
+// ---------------------------------------------------------------------------
+// Agent Prompt Building
+// ---------------------------------------------------------------------------
+/**
+ * Build a prompt for a single agent within a milestone wave.
+ *
+ * The prompt includes:
+ * - The agent's specific task and files
+ * - Milestone goal and context
+ * - Key existing code (inlined, not just paths)
+ * - Lessons from tasks/lessons.md
+ * - CLAUDE.md rules (abbreviated)
+ */
+export function buildAgentPrompt(agent, context, existingCode) {
+    const lines = [];
+    // Header
+    lines.push(`# Agent: ${agent.name}`);
+    lines.push("");
+    lines.push(`You are working on **Milestone ${context.milestoneNumber}: ${context.milestoneName}**.`);
+    lines.push("");
+    lines.push(`**Milestone Goal:** ${context.milestoneGoal}`);
+    lines.push("");
+    // Agent-specific task
+    lines.push("## Your Task");
+    lines.push("");
+    lines.push(agent.task);
+    lines.push("");
+    // Files to create/modify
+    if (agent.files.length > 0) {
+        lines.push("## Files");
+        lines.push("");
+        for (const file of agent.files) {
+            lines.push(`- ${file}`);
+        }
+        lines.push("");
+    }
+    // Inline existing code if provided
+    if (existingCode) {
+        lines.push("## Existing Code (Reference)");
+        lines.push("");
+        lines.push(existingCode);
+        lines.push("");
+    }
+    // Lessons
+    if (context.lessons) {
+        lines.push("## Lessons (Follow These)");
+        lines.push("");
+        lines.push(context.lessons);
+        lines.push("");
+    }
+    // Rules from CLAUDE.md (abbreviated to key rules only)
+    if (context.claudeMd) {
+        // Extract just the critical rules section if present
+        const rulesMatch = context.claudeMd.match(/## Critical Rules\s*\n([\s\S]*?)(?=\n##\s|$)/);
+        if (rulesMatch) {
+            lines.push("## Rules");
+            lines.push("");
+            lines.push(rulesMatch[1].trim());
+            lines.push("");
+        }
+    }
+    // Verification
+    lines.push("## Verification");
+    lines.push("");
+    lines.push("After completing your work, verify:");
+    lines.push("- `npx tsc --noEmit` passes");
+    if (context.verificationCommands.length > 0) {
+        for (const cmd of context.verificationCommands) {
+            lines.push(`- \`${cmd}\``);
+        }
+    }
+    lines.push("");
+    // Git rules
+    lines.push("## Git Rules");
+    lines.push("");
+    lines.push("- Stage only the files you created/modified (never use `git add .`)");
+    lines.push("- Do not commit — the orchestrator handles commits");
+    lines.push("- Use ES module imports with `.js` extension in import paths");
+    lines.push("");
+    return lines.join("\n");
+}
+// ---------------------------------------------------------------------------
+// Wave Execution Preparation
+// ---------------------------------------------------------------------------
+/**
+ * Prepare all waves for execution.
+ * Returns structured wave data with agent prompts ready for the skill
+ * to pass to Claude Code's Task tool.
+ */
+export function prepareWaves(context, existingCodeMap) {
+    return context.waves.map((wave) => ({
+        waveNumber: wave.waveNumber,
+        agents: wave.agents.map((agent) => ({
+            name: agent.name,
+            task: agent.task,
+            files: agent.files,
+            prompt: buildAgentPrompt(agent, context, existingCodeMap?.get(agent.name)),
+        })),
+    }));
+}
+// ---------------------------------------------------------------------------
+// Verification
+// ---------------------------------------------------------------------------
+/**
+ * Run forge verification pipeline after a wave completes.
+ * Returns the pipeline result with human-readable report.
+ */
+export async function runWaveVerification(options) {
+    const { projectDir, config, prdPath } = options;
+    const pipelineInput = {
+        projectDir,
+        gates: config.gates,
+        prdPath: config.prdPath ?? prdPath,
+        maxIterations: config.maxIterations,
+        devServerCommand: config.devServer?.command,
+        devServerPort: config.devServer?.port,
+    };
+    const result = await runPipeline(pipelineInput);
+    // Attach human-readable report
+    if (!result.report) {
+        result.report = formatHumanReport(result);
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Result Tracking
+// ---------------------------------------------------------------------------
+/**
+ * Create an empty execution result for a milestone.
+ */
+export function createExecutionResult(context) {
+    return {
+        milestoneNumber: context.milestoneNumber,
+        milestoneName: context.milestoneName,
+        success: false,
+        waves: [],
+        totalFilesCreated: 0,
+        totalFilesModified: 0,
+        errors: [],
+    };
+}
+/**
+ * Record a completed wave's results into the execution result.
+ */
+export function recordWaveResult(execution, waveResult) {
+    const updatedWaves = [...execution.waves, waveResult];
+    let totalCreated = 0;
+    let totalModified = 0;
+    const allErrors = [];
+    for (const wave of updatedWaves) {
+        for (const agent of wave.agents) {
+            totalCreated += agent.filesCreated.length;
+            totalModified += agent.filesModified.length;
+            if (agent.error) {
+                allErrors.push(`[${agent.name}] ${agent.error}`);
+            }
+        }
+        if (wave.verification && !wave.verification.passed) {
+            const failedGates = wave.verification.gates
+                .filter((g) => !g.passed)
+                .map((g) => g.gate);
+            allErrors.push(`Wave ${wave.waveNumber} verification failed: ${failedGates.join(", ")}`);
+        }
+    }
+    // Success = all waves complete + last wave verification passed (if any)
+    const lastWave = updatedWaves[updatedWaves.length - 1];
+    const lastVerificationPassed = lastWave?.verification?.passed ?? true;
+    const allAgentsSucceeded = updatedWaves.every((w) => w.agents.every((a) => a.success));
+    const success = allAgentsSucceeded && lastVerificationPassed;
+    return {
+        ...execution,
+        waves: updatedWaves,
+        success,
+        totalFilesCreated: totalCreated,
+        totalFilesModified: totalModified,
+        errors: allErrors,
+    };
+}
+// ---------------------------------------------------------------------------
+// Execution Orchestrator
+// ---------------------------------------------------------------------------
+/**
+ * Execute a single milestone end-to-end.
+ *
+ * In dryRun mode: builds context and prompts, runs no verification, returns
+ * the prepared execution plan.
+ *
+ * In normal mode: the caller (skill file) should use this module's functions
+ * step by step:
+ * 1. `buildMilestoneContext()` — read PRD and build context
+ * 2. `prepareWaves()` — get agent prompts for each wave
+ * 3. For each wave: spawn agents, collect results
+ * 4. `runWaveVerification()` — verify after each wave
+ * 5. `recordWaveResult()` — track results
+ *
+ * This `executeMilestone` function is the simplified orchestrator for
+ * programmatic/testing use. For real execution, the skill drives each step.
+ */
+export async function executeMilestone(options) {
+    // 1. Build context
+    const context = await buildMilestoneContext(options);
+    // 2. Prepare waves
+    const waves = prepareWaves(context);
+    // 3. Create result tracker
+    const result = createExecutionResult(context);
+    if (options.dryRun) {
+        // In dry run, return the plan without executing
+        return { context, waves, result };
+    }
+    // In non-dry-run mode, the executor only runs verification.
+    // Agent spawning is the caller's (skill's) responsibility.
+    // This path is for programmatic testing only.
+    return { context, waves, result };
+}
+// ---------------------------------------------------------------------------
+// Formatting
+// ---------------------------------------------------------------------------
+/**
+ * Format an execution result as a human-readable summary.
+ */
+export function formatExecutionSummary(result) {
+    const lines = [];
+    const status = result.success ? "COMPLETE" : "FAILED";
+    lines.push(`## Milestone ${result.milestoneNumber}: ${result.milestoneName} -- ${status}`);
+    lines.push("");
+    // Wave summary
+    for (const wave of result.waves) {
+        const agentStatus = wave.agents
+            .map((a) => `${a.name}: ${a.success ? "OK" : "FAIL"}`)
+            .join(", ");
+        const verifyStatus = wave.verification
+            ? wave.verification.passed
+                ? "PASSED"
+                : "FAILED"
+            : "SKIPPED";
+        lines.push(`**Wave ${wave.waveNumber}:** ${agentStatus} | Verify: ${verifyStatus}`);
+    }
+    lines.push("");
+    // Stats
+    lines.push(`**Files Created:** ${result.totalFilesCreated}`);
+    lines.push(`**Files Modified:** ${result.totalFilesModified}`);
+    lines.push("");
+    // Errors
+    if (result.errors.length > 0) {
+        lines.push("### Errors");
+        for (const error of result.errors) {
+            lines.push(`- ${error}`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+/**
+ * Format verification errors into a structured prompt for fix agents.
+ * Used by the self-healing verify loop.
+ */
+export function formatErrorsForFixAgent(verification) {
+    const lines = [];
+    lines.push("## Verification Errors to Fix");
+    lines.push("");
+    for (const gate of verification.gates) {
+        if (gate.passed)
+            continue;
+        lines.push(`### ${gate.gate} Gate — FAILED`);
+        for (const error of gate.errors) {
+            const loc = error.file
+                ? `${error.file}${error.line ? `:${error.line}` : ""}`
+                : "";
+            const prefix = loc ? `**${loc}:** ` : "";
+            lines.push(`- ${prefix}${error.message}`);
+            if (error.remediation) {
+                lines.push(`  > Fix: ${error.remediation}`);
+            }
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=executor.js.map

package/dist/go/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../src/go/executor.ts"],"names":[],"mappings":"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"}

package/dist/go/finalize.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Final Milestone Detection and PR Creation
+ *
+ * Handles the transition from "last milestone complete" to "PR ready for review".
+ * Uses `gh pr create` to open a pull request with a forge verification report
+ * in the body. Designed to be called by the execution engine after the final
+ * milestone passes verification.
+ */
+import type { PipelineResult } from "../types.js";
+export interface CreatePROptions {
+    projectDir: string;
+    branch: string;
+    baseBranch?: string;
+    title: string;
+    milestones: Array<{
+        number: number;
+        name: string;
+        success: boolean;
+    }>;
+    verificationReport?: string;
+    commitSha?: string;
+}
+export interface PRResult {
+    url: string;
+    number: number;
+    title: string;
+    created: boolean;
+}
+export interface PRError {
+    url: "";
+    number: 0;
+    title: string;
+    created: false;
+    error: string;
+}
+/**
+ * Generate a PR title summarizing all completed milestones.
+ *
+ * Examples:
+ * - `feat: my-project — Milestone 1 complete`
+ * - `feat: my-project — Milestones 1-5 complete`
+ */
+export declare function buildPRTitle(project: string, milestoneCount: number): string;
+/**
+ * Format a PipelineResult into a PR-ready verification section.
+ *
+ * Includes gate-level pass/fail status with error counts and
+ * duration information. Designed to be embedded in a PR body.
+ */
+export declare function buildVerificationSection(result: PipelineResult): string;
+/**
+ * Create a GitHub pull request using the `gh` CLI.
+ *
+ * Builds a structured PR body with milestone status, verification report,
+ * and metadata, then calls `gh pr create`. If `gh` is not installed or the
+ * command fails, returns a descriptive error result instead of throwing.
+ */
+export declare function createPullRequest(options: CreatePROptions): PRResult | PRError;