forge-cc 1.0.0 → 1.0.1

package/dist/go/auto-chain.js

@@ -1,389 +0,0 @@
-/**
- * Auto-Chain — Multi-Milestone Execution Orchestrator
- *
- * After a milestone completes, spawns a fresh agent with clean context for the
- * next milestone. Fresh agent reads CLAUDE.md + next milestone section only.
- * Loops until all milestones done or a failure stops the chain.
- *
- * This module is the data/logic layer. It does NOT spawn agents — that is
- * the skill file's job (via Claude Code's Task tool). Auto-chain prepares
- * the context and tracks results across milestones.
- */
-import { readFile } from "node:fs/promises";
-import { execSync } from "node:child_process";
-import { join } from "node:path";
-import { readCurrentMilestone } from "../state/reader.js";
-import { findNextPendingMilestone, countPendingMilestones, updateMilestoneStatus, } from "../state/prd-status.js";
-import { isLastMilestone, commitMilestoneWork, } from "../state/writer.js";
-import { buildMilestoneContext } from "./executor.js";
-import { createWorktree, removeWorktree, deleteBranch, getRepoRoot, } from "../worktree/manager.js";
-import { registerSession, deregisterSession, updateSessionStatus, } from "../worktree/session.js";
-import { getCurrentUser } from "../worktree/identity.js";
-import { buildScheduleFromPRD } from "../worktree/parallel.js";
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-async function safeRead(filePath) {
-    try {
-        return await readFile(filePath, "utf-8");
-    }
-    catch {
-        return "";
-    }
-}
-/**
- * Extract the "Quick Context" section from CLAUDE.md.
- *
- * Returns just the abbreviated context block (from "## Quick Context" to the
- * next `##` heading or end of file). Falls back to the first 30 lines of
- * the file if the section header isn't found.
- */
-function extractQuickContext(claudeMd) {
-    if (!claudeMd)
-        return "";
-    const quickMatch = claudeMd.match(/##\s*Quick Context\s*\n([\s\S]*?)(?=\n##\s|$)/);
-    if (quickMatch) {
-        return `## Quick Context\n${quickMatch[1].trim()}`;
-    }
-    // Fallback: first 30 lines (enough context without bloating the prompt)
-    const lines = claudeMd.split("\n").slice(0, 30);
-    return lines.join("\n").trim();
-}
-// ---------------------------------------------------------------------------
-// buildFreshSessionPrompt
-// ---------------------------------------------------------------------------
-/**
- * Build the fresh-context prompt for a milestone agent (Ralph Loop pattern).
- *
- * Reads CLAUDE.md (abbreviated to Quick Context) and the current milestone
- * section from the PRD. The total is kept as small as possible (~200-300
- * lines) while giving the agent enough context to work.
- */
-export async function buildFreshSessionPrompt(projectDir, prdPath, milestoneNumber) {
-    const [claudeMd, milestoneSection] = await Promise.all([
-        safeRead(join(projectDir, "CLAUDE.md")),
-        readCurrentMilestone(prdPath, milestoneNumber),
-    ]);
-    const lines = [];
-    // 1. Abbreviated CLAUDE.md
-    const quickContext = extractQuickContext(claudeMd);
-    if (quickContext) {
-        lines.push("# Project Context");
-        lines.push("");
-        lines.push(quickContext);
-        lines.push("");
-    }
-    // 2. Current milestone section from PRD
-    if (milestoneSection) {
-        lines.push("# Current Milestone");
-        lines.push("");
-        lines.push(milestoneSection.trim());
-        lines.push("");
-    }
-    else {
-        lines.push(`# Current Milestone`);
-        lines.push("");
-        lines.push(`Milestone ${milestoneNumber} section not found in PRD at ${prdPath}.`);
-        lines.push("");
-    }
-    // 3. Session instructions (minimal)
-    lines.push("# Session Instructions");
-    lines.push("");
-    lines.push("You are executing the milestone described above. Follow the PRD precisely.");
-    lines.push("- Run `npx tsc --noEmit` after all changes to verify types.");
-    lines.push("- Stage only files you create/modify (never `git add .`).");
-    lines.push("- Do not commit — the orchestrator handles commits.");
-    lines.push("- On completion, the orchestrator will update the status JSON automatically.");
-    lines.push("- NEVER modify .forge.json, CLAUDE.md, or tasks/lessons.md to resolve verification errors.");
-    lines.push("");
-    return lines.join("\n");
-}
-// Re-export findNextPendingMilestone and countPendingMilestones from prd-status
-// so that existing consumers (cli.ts, tests) can continue importing from auto-chain.
-export { findNextPendingMilestone, countPendingMilestones };
-// ---------------------------------------------------------------------------
-// runAutoChain
-// ---------------------------------------------------------------------------
-/**
- * Auto-chain orchestrator: manages multi-milestone execution with context resets.
- *
- * For each pending milestone:
- * 1. Determines the starting milestone (from options or per-PRD status)
- * 2. Creates a git worktree for isolated execution
- * 3. Registers a session in the session registry
- * 4. Builds a fresh-context prompt for the milestone agent
- * 5. Calls the milestone context builder for structured data
- * 6. Returns results so the calling skill can spawn agents and drive execution
- * 7. On completion or failure, deregisters the session and cleans up the worktree
- *
- * The worktree is created ONCE per /forge:go session, not per milestone.
- * All milestones in the chain execute in the same worktree.
- *
- * The chain stops on the first milestone failure, or when all milestones
- * are complete. The caller is responsible for actually executing each
- * milestone (spawning agents, running waves) — this function provides the
- * orchestration loop and context management.
- */
-export async function runAutoChain(options) {
-    const { projectDir, prdPath, config, branch, project, prdSlug, activePrd, developer, onMilestoneStart, onMilestoneComplete, onChainComplete, } = options;
-    const completed = [];
-    // Determine starting milestone
-    let currentMilestoneNumber;
-    if (options.startMilestone !== undefined) {
-        currentMilestoneNumber = options.startMilestone;
-    }
-    else {
-        // Auto-detect from per-PRD status
-        const nextPending = await findNextPendingMilestone(projectDir, prdSlug);
-        if (!nextPending) {
-            // All milestones are already complete
-            const result = {
-                completed: [],
-                stopped: false,
-                allComplete: true,
-            };
-            onChainComplete?.([]);
-            return result;
-        }
-        currentMilestoneNumber = nextPending.number;
-    }
-    // --- Worktree lifecycle: create once for the entire chain ---
-    const repoRoot = options.repoRoot ?? getRepoRoot(projectDir);
-    const user = getCurrentUser(projectDir);
-    const slug = `${project}-m${currentMilestoneNumber}`;
-    const worktreeResult = createWorktree(repoRoot, slug, user.name, {
-        baseBranch: branch,
-    });
-    const { worktreePath, branch: worktreeBranch } = worktreeResult;
-    const session = registerSession(repoRoot, {
-        user,
-        skill: "go",
-        milestone: `M${currentMilestoneNumber}`,
-        prdSlug,
-        branch: worktreeBranch,
-        worktreePath,
-    });
-    // Use worktree path as the effective project directory for code execution.
-    // CLAUDE.md is read from the main projectDir (see buildFreshSessionPrompt),
-    // PRD files and milestone context come from the worktree.
-    const effectiveProjectDir = worktreePath;
-    try {
-        // Loop through milestones until we run out or hit a failure
-        while (true) {
-            // Update session milestone tracking
-            updateSessionStatus(repoRoot, session.id, "active");
-            // Build fresh-context prompt: CLAUDE.md from main project,
-            // PRD path resolved relative to the worktree
-            const effectivePrdPath = join(effectiveProjectDir, prdPath);
-            const freshPrompt = await buildFreshSessionPrompt(projectDir, effectivePrdPath, currentMilestoneNumber);
-            // Build structured context from the worktree (validates milestone exists in PRD)
-            let context;
-            try {
-                context = await buildMilestoneContext({
-                    projectDir: effectiveProjectDir,
-                    prdPath,
-                    milestoneNumber: currentMilestoneNumber,
-                    config,
-                    prdSlug,
-                });
-                // Attach worktree path to context
-                context.worktreePath = worktreePath;
-            }
-            catch (err) {
-                // Milestone not found in PRD — chain cannot continue
-                const errorMessage = err instanceof Error ? err.message : String(err);
-                const failResult = {
-                    milestoneNumber: currentMilestoneNumber,
-                    milestoneName: "Unknown",
-                    success: false,
-                    isLast: false,
-                    freshPrompt,
-                    worktreePath,
-                    errors: [errorMessage],
-                };
-                completed.push(failResult);
-                onMilestoneComplete?.(currentMilestoneNumber, failResult);
-                const chainResult = {
-                    completed,
-                    stopped: true,
-                    stoppedAt: currentMilestoneNumber,
-                    allComplete: false,
-                };
-                onChainComplete?.(completed);
-                return chainResult;
-            }
-            // Notify: milestone starting
-            onMilestoneStart?.(currentMilestoneNumber, context.milestoneName);
-            // Build the milestone result with the fresh prompt.
-            // The caller uses `freshPrompt` to spawn an agent, then calls
-            // `completeMilestone()` after the agent finishes.
-            const milestoneResult = {
-                milestoneNumber: currentMilestoneNumber,
-                milestoneName: context.milestoneName,
-                success: true, // Optimistic; caller updates via completeMilestone
-                isLast: await isLastMilestone(effectiveProjectDir, prdSlug, currentMilestoneNumber),
-                freshPrompt,
-                worktreePath,
-                errors: [],
-            };
-            completed.push(milestoneResult);
-            // Notify: milestone complete (caller will drive actual execution)
-            onMilestoneComplete?.(currentMilestoneNumber, milestoneResult);
-            // If this was the last milestone, we're done
-            if (milestoneResult.isLast) {
-                const chainResult = {
-                    completed,
-                    stopped: false,
-                    allComplete: true,
-                };
-                onChainComplete?.(completed);
-                return chainResult;
-            }
-            // Find the next pending milestone
-            const nextPending = await findNextPendingMilestone(effectiveProjectDir, prdSlug);
-            if (!nextPending) {
-                // All milestones are complete
-                const chainResult = {
-                    completed,
-                    stopped: false,
-                    allComplete: true,
-                };
-                onChainComplete?.(completed);
-                return chainResult;
-            }
-            currentMilestoneNumber = nextPending.number;
-        }
-    }
-    finally {
-        // --- Worktree cleanup: always runs, even on error ---
-        try {
-            deregisterSession(repoRoot, session.id);
-        }
-        catch {
-            // Non-fatal: best-effort deregistration
-        }
-        try {
-            removeWorktree(repoRoot, worktreePath);
-        }
-        catch {
-            // Non-fatal: best-effort cleanup
-        }
-        // Delete the worktree branch — force-delete since it was merged via worktree flow
-        deleteBranch(repoRoot, worktreeBranch, { force: true });
-    }
-}
-// ---------------------------------------------------------------------------
-// completeMilestone — post-execution bookkeeping
-// ---------------------------------------------------------------------------
-/**
- * Called after a milestone's agent finishes execution.
- *
- * Handles:
- * 1. Updating milestone status in per-PRD status JSON
- * 2. Committing milestone work to git (in the worktree if one was used)
- * 3. Merging worktree branch into the feature branch (if worktree was used)
- * 4. Returning the commit SHA for the milestone result
- *
- * The caller should update the MilestoneResult with the returned commit info.
- */
-export async function completeMilestone(options) {
-    const { projectDir, prdSlug, milestoneNumber, milestoneName, branch, filesToStage, push, worktreePath, repoRoot, } = options;
-    // The effective directory for status updates and commits:
-    // if a worktree was used, commit there; otherwise use projectDir
-    const commitDir = worktreePath ?? projectDir;
-    // Check if this is the last milestone
-    const last = await isLastMilestone(commitDir, prdSlug, milestoneNumber);
-    // Update per-PRD status JSON
-    await updateMilestoneStatus(commitDir, prdSlug, milestoneNumber, "complete");
-    // Commit milestone work (in the worktree if one was used)
-    const commitResult = commitMilestoneWork({
-        projectDir: commitDir,
-        milestoneNumber,
-        milestoneName,
-        filesToStage,
-        push: false, // Don't push from worktree; push happens after merge
-        branch,
-    });
-    // If a worktree was used, merge the worktree branch into the feature branch
-    if (worktreePath && repoRoot) {
-        const worktreeBranch = execSync("git rev-parse --abbrev-ref HEAD", {
-            cwd: worktreePath,
-            encoding: "utf-8",
-            stdio: "pipe",
-        }).trim();
-        mergeWorktreeBranch(repoRoot, worktreeBranch, branch);
-        // Optionally push the feature branch after merge
-        if (push) {
-            try {
-                execSync(`git push origin ${branch}`, {
-                    cwd: repoRoot,
-                    stdio: "pipe",
-                    encoding: "utf-8",
-                });
-            }
-            catch {
-                // Non-fatal: push failure doesn't invalidate the milestone
-            }
-        }
-    }
-    else if (push) {
-        // No worktree — push directly from projectDir (original behavior)
-        try {
-            execSync(`git push origin ${branch}`, {
-                cwd: projectDir,
-                stdio: "pipe",
-                encoding: "utf-8",
-            });
-        }
-        catch {
-            // Non-fatal
-        }
-    }
-    return { commitResult, isLast: last };
-}
-// ---------------------------------------------------------------------------
-// mergeWorktreeBranch — brings worktree commits into the feature branch
-// ---------------------------------------------------------------------------
-/**
- * Merge worktree branch commits into the target branch.
- * Used after milestone completion to bring worktree work back to the feature branch.
- *
- * Checks out the target branch in the main repo, merges the worktree branch,
- * then returns. The caller is responsible for pushing if desired.
- */
-function mergeWorktreeBranch(repoRoot, worktreeBranch, targetBranch) {
-    // Ensure we're on the target branch in the main repo
-    execSync(`git checkout ${targetBranch}`, {
-        cwd: repoRoot,
-        stdio: "pipe",
-        encoding: "utf-8",
-    });
-    // Merge the worktree branch into the target branch
-    execSync(`git merge ${worktreeBranch} --no-edit`, {
-        cwd: repoRoot,
-        stdio: "pipe",
-        encoding: "utf-8",
-    });
-}
-// ---------------------------------------------------------------------------
-// buildParallelPlan — parallel execution planner
-// ---------------------------------------------------------------------------
-/**
- * Build a parallel execution plan for all milestones in a PRD.
- *
- * Parses the PRD markdown for milestone definitions and `dependsOn` fields,
- * builds a dependency DAG, and computes parallel execution waves showing
- * which milestones can run simultaneously.
- *
- * If no `dependsOn` fields are found in the PRD, all milestones are treated
- * as roots (no dependencies) and placed in a single wave. This is backward
- * compatible — the caller can process them sequentially by milestone number.
- *
- * @param prdPath - Absolute path to the PRD markdown file
- * @returns The wave schedule showing which milestones can run simultaneously
- * @throws If a dependency cycle is detected or a referenced dependency doesn't exist
- */
-export async function buildParallelPlan(prdPath) {
-    return buildScheduleFromPRD(prdPath);
-}
-//# sourceMappingURL=auto-chain.js.map

package/dist/go/auto-chain.js.map

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

package/dist/go/executor.d.ts

@@ -1,137 +0,0 @@
-/**
- * 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 { TeamConfig } from "../team/types.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;
-    /** PRD slug for per-PRD status tracking */
-    prdSlug?: string;
-    /** 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;
-    /** Path to the worktree used for isolated execution (if any) */
-    worktreePath?: string;
-    /** Team configuration for agent team lifecycle (M2 integration) */
-    teamConfig?: TeamConfig;
-}
-/**
- * Build the full context needed to execute a milestone.
- * Reads PRD milestone section, CLAUDE.md, lessons, and per-PRD status JSON.
- */
-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;