forge-cc 1.0.0 → 1.0.1

package/dist/gates/visual-gate.js

@@ -1,234 +0,0 @@
-import { getBrowser, startDevServer, stopDevServer, waitForServer, } from "../utils/browser.js";
-import { captureVisual } from "./visual-capture.js";
-import { reviewVisual } from "./visual-reviewer.js";
-import { existsSync, mkdirSync, readFileSync, readdirSync, unlinkSync, writeFileSync } from "node:fs";
-import { join } from "node:path";
-// ---------------------------------------------------------------------------
-// Before snapshot disk persistence
-// ---------------------------------------------------------------------------
-/** Sanitize a page path to a safe filename key (e.g. "/" -> "index", "/dashboard" -> "dashboard") */
-function snapshotKey(pagePath) {
-    const sanitized = pagePath.replace(/\//g, "_").replace(/^_/, "");
-    return sanitized || "index";
-}
-/** Save a before snapshot to disk so it survives across CLI invocations. */
-function saveBeforeSnapshot(screenshotDir, pagePath, result) {
-    const dir = join(screenshotDir, "before");
-    mkdirSync(dir, { recursive: true });
-    const filePath = join(dir, `${snapshotKey(pagePath)}.snapshot.json`);
-    writeFileSync(filePath, JSON.stringify(result, null, 2));
-}
-/** Load a before snapshot from disk. Returns null if none exists. */
-function loadBeforeSnapshot(screenshotDir, pagePath) {
-    const filePath = join(screenshotDir, "before", `${snapshotKey(pagePath)}.snapshot.json`);
-    if (!existsSync(filePath))
-        return null;
-    try {
-        return JSON.parse(readFileSync(filePath, "utf-8"));
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Capture and store "before" snapshots for the given pages.
- * Snapshots are persisted to disk (.forge/screenshots/before/*.snapshot.json)
- * so they survive across separate CLI invocations.
- */
-export async function captureBeforeSnapshots(projectDir, pages, options) {
-    const resolvedPages = pages.length > 0 ? pages : ["/"];
-    const port = options?.devServerPort ?? 3000;
-    const screenshotDir = options?.screenshotDir ?? join(projectDir, ".forge", "screenshots");
-    const beforeDir = join(screenshotDir, "before");
-    mkdirSync(beforeDir, { recursive: true });
-    try {
-        await startDevServer(projectDir, options?.devServerCommand, port);
-        const ready = await waitForServer(port);
-        if (!ready) {
-            return; // Cannot capture baseline — verifyVisual will still work without it
-        }
-        const browser = await getBrowser();
-        const context = await browser.newContext();
-        try {
-            for (const pagePath of resolvedPages) {
-                const page = await context.newPage();
-                try {
-                    await page.goto(`http://localhost:${port}${pagePath}`, {
-                        waitUntil: "networkidle",
-                        timeout: 30_000,
-                    });
-                    const result = await captureVisual(page, {
-                        pagePath,
-                        screenshotDir: beforeDir,
-                    });
-                    saveBeforeSnapshot(screenshotDir, pagePath, result);
-                }
-                catch {
-                    // Failed to capture baseline for this page — skip it
-                }
-                finally {
-                    await page.close();
-                }
-            }
-        }
-        finally {
-            await context.close();
-        }
-    }
-    finally {
-        await stopDevServer();
-    }
-}
-/** Clear all stored "before" snapshots from disk (e.g. between milestones). */
-export function clearBeforeSnapshots(projectDir) {
-    const dir = join(projectDir, ".forge", "screenshots", "before");
-    let files;
-    try {
-        files = readdirSync(dir);
-    }
-    catch {
-        return; // Directory doesn't exist — nothing to clear
-    }
-    for (const file of files) {
-        if (file.endsWith(".snapshot.json")) {
-            try {
-                unlinkSync(join(dir, file));
-            }
-            catch { /* ignore */ }
-        }
-    }
-}
-// ---------------------------------------------------------------------------
-// Main visual gate
-// ---------------------------------------------------------------------------
-export async function verifyVisual(projectDir, pages, options) {
-    const start = Date.now();
-    const resolvedPages = pages.length > 0 ? pages : ["/"];
-    const port = options?.devServerPort ?? 3000;
-    const screenshotDir = options?.screenshotDir ?? join(projectDir, ".forge", "screenshots");
-    const afterDir = join(screenshotDir, "after");
-    const consoleErrors = [];
-    const warnings = [];
-    const screenshots = [];
-    mkdirSync(afterDir, { recursive: true });
-    try {
-        // Start dev server
-        try {
-            await startDevServer(projectDir, options?.devServerCommand, port);
-        }
-        catch (err) {
-            const message = err instanceof Error ? err.message : "Unknown dev server error";
-            return {
-                gate: "visual",
-                passed: false,
-                errors: [{ message: `Dev server failed to start: ${message}` }],
-                warnings,
-                duration_ms: Date.now() - start,
-                screenshots,
-                consoleErrors,
-            };
-        }
-        // Ensure server is reachable
-        const ready = await waitForServer(port);
-        if (!ready) {
-            return {
-                gate: "visual",
-                passed: false,
-                errors: [{ message: `Dev server not reachable on port ${port}` }],
-                warnings,
-                duration_ms: Date.now() - start,
-                screenshots,
-                consoleErrors,
-            };
-        }
-        // Launch browser and create context
-        const browser = await getBrowser();
-        const context = await browser.newContext();
-        const reviewerErrors = [];
-        try {
-            for (const pagePath of resolvedPages) {
-                const page = await context.newPage();
-                // Collect console errors
-                page.on("console", (msg) => {
-                    if (msg.type() === "error") {
-                        consoleErrors.push(msg.text());
-                    }
-                });
-                page.on("pageerror", (err) => {
-                    consoleErrors.push(err.message);
-                });
-                // Navigate to the page
-                try {
-                    await page.goto(`http://localhost:${port}${pagePath}`, {
-                        waitUntil: "networkidle",
-                        timeout: 30_000,
-                    });
-                }
-                catch (err) {
-                    const message = err instanceof Error ? err.message : "Navigation failed";
-                    consoleErrors.push(`Navigation error for ${pagePath}: ${message}`);
-                    await page.close();
-                    continue;
-                }
-                // Capture "after" snapshot using the M1 capture module
-                try {
-                    const afterResult = await captureVisual(page, {
-                        pagePath,
-                        screenshotDir: afterDir,
-                    });
-                    // Map multi-viewport screenshots to the flat { page, path } format
-                    for (const shot of afterResult.screenshots) {
-                        screenshots.push({ page: shot.page, path: shot.path });
-                    }
-                    // Compare with "before" snapshot if one exists (loaded from disk)
-                    const beforeResult = loadBeforeSnapshot(screenshotDir, pagePath);
-                    if (beforeResult) {
-                        const findings = reviewVisual(beforeResult, afterResult);
-                        reviewerErrors.push(...findings);
-                    }
-                    else {
-                        warnings.push(`No baseline snapshot for ${pagePath} — before/after comparison skipped. Call captureBeforeSnapshots() before verifyVisual() to enable.`);
-                    }
-                }
-                catch (err) {
-                    const message = err instanceof Error ? err.message : "Visual capture failed";
-                    warnings.push(`Visual capture failed for ${pagePath}: ${message}`);
-                }
-                await page.close();
-            }
-        }
-        finally {
-            await context.close();
-        }
-        // Combine console errors and reviewer errors into a single GateError list
-        const errors = [
-            ...consoleErrors.map((msg) => ({ message: msg })),
-            ...reviewerErrors,
-        ];
-        return {
-            gate: "visual",
-            passed: errors.length === 0,
-            errors,
-            warnings,
-            duration_ms: Date.now() - start,
-            screenshots,
-            consoleErrors,
-        };
-    }
-    catch (err) {
-        const message = err instanceof Error ? err.message : "Unknown error in verifyVisual";
-        return {
-            gate: "visual",
-            passed: false,
-            errors: [{ message }],
-            warnings,
-            duration_ms: Date.now() - start,
-            screenshots,
-            consoleErrors,
-        };
-    }
-    finally {
-        await stopDevServer();
-    }
-}
-//# sourceMappingURL=visual-gate.js.map

package/dist/gates/visual-gate.js.map

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

package/dist/gates/visual-reviewer.d.ts

@@ -1,11 +0,0 @@
-import type { GateError, VisualCaptureResult } from "../types.js";
-/**
- * Compare before and after visual capture results using DOM structural
- * analysis. Returns a list of `GateError` entries describing detected
- * differences per viewport.
- *
- * This does NOT perform pixel-level comparison — it analyses the serialized
- * DOM trees for element count changes, missing/added elements, visibility
- * changes, and significant layout dimension shifts.
- */
-export declare function reviewVisual(before: VisualCaptureResult, after: VisualCaptureResult): GateError[];

package/dist/gates/visual-reviewer.js

@@ -1,211 +0,0 @@
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-/**
- * Build a human-readable DOM path string from root to the given node.
- * Example: "body > div#main > nav.sidebar"
- */
-function domPath(node, ancestors) {
-    const parts = [];
-    for (const a of ancestors) {
-        parts.push(nodeLabel(a));
-    }
-    parts.push(nodeLabel(node));
-    return parts.join(" > ");
-}
-/** Produce a concise label for a single DOM node: tag#id.className */
-function nodeLabel(node) {
-    let label = node.tag;
-    if (node.id) {
-        label += `#${node.id}`;
-    }
-    if (node.className) {
-        // Collapse whitespace and join with dots
-        label += "." + node.className.split(/\s+/).join(".");
-    }
-    return label;
-}
-/**
- * Build an identity key for a node so we can match elements across
- * before/after snapshots. Nodes with an `id` get that as their key;
- * otherwise we fall back to tag+className which is less unique but still
- * useful.
- */
-function nodeKey(node) {
-    if (node.id) {
-        return `id:${node.id}`;
-    }
-    return `tag:${node.tag}|class:${node.className ?? ""}`;
-}
-/**
- * Recursively flatten a DOM tree into a list of FlatNode entries, each
- * carrying its identity key and human-readable path.
- */
-function flattenTree(root, ancestors = []) {
-    const result = [];
-    const currentPath = domPath(root, ancestors);
-    result.push({ node: root, path: currentPath, key: nodeKey(root) });
-    const nextAncestors = [...ancestors, root];
-    for (const child of root.children) {
-        result.push(...flattenTree(child, nextAncestors));
-    }
-    return result;
-}
-/** Count the total number of nodes in a DOM tree (including the root). */
-function countNodes(root) {
-    let count = 1;
-    for (const child of root.children) {
-        count += countNodes(child);
-    }
-    return count;
-}
-// ---------------------------------------------------------------------------
-// Comparison thresholds
-// ---------------------------------------------------------------------------
-/** If total element count changes by more than this ratio, flag it. */
-const ELEMENT_COUNT_CHANGE_THRESHOLD = 0.20; // 20%
-/** Bounding-rect shift (in px) above which we flag a layout change. */
-const LAYOUT_SHIFT_PX = 50;
-// ---------------------------------------------------------------------------
-// Per-viewport comparison
-// ---------------------------------------------------------------------------
-function compareSnapshots(viewport, before, after) {
-    const errors = [];
-    // --- Element count change ------------------------------------------------
-    const beforeCount = countNodes(before);
-    const afterCount = countNodes(after);
-    if (beforeCount > 0) {
-        const ratio = Math.abs(afterCount - beforeCount) / beforeCount;
-        if (ratio > ELEMENT_COUNT_CHANGE_THRESHOLD) {
-            const direction = afterCount > beforeCount ? "increase" : "decrease";
-            errors.push({
-                message: `[${viewport}] Significant element count ${direction}: ${beforeCount} -> ${afterCount} (${Math.round(ratio * 100)}% change)`,
-                remediation: `Review the DOM on the "${viewport}" viewport — a large element count ${direction} may indicate unintended additions or removals.`,
-            });
-        }
-    }
-    // --- Flatten both trees and index by key ---------------------------------
-    const beforeFlat = flattenTree(before);
-    const afterFlat = flattenTree(after);
-    const beforeByKey = new Map();
-    for (const entry of beforeFlat) {
-        const existing = beforeByKey.get(entry.key);
-        if (existing) {
-            existing.push(entry);
-        }
-        else {
-            beforeByKey.set(entry.key, [entry]);
-        }
-    }
-    const afterByKey = new Map();
-    for (const entry of afterFlat) {
-        const existing = afterByKey.get(entry.key);
-        if (existing) {
-            existing.push(entry);
-        }
-        else {
-            afterByKey.set(entry.key, [entry]);
-        }
-    }
-    // --- Missing elements (in before, not in after) --------------------------
-    for (const [key, beforeEntries] of beforeByKey) {
-        if (!afterByKey.has(key)) {
-            // All instances of this key are missing in `after`
-            for (const entry of beforeEntries) {
-                errors.push({
-                    message: `[${viewport}] Missing element: ${entry.path}`,
-                    remediation: `Element ${nodeLabel(entry.node)} missing on "${viewport}" viewport — check responsive CSS rules and conditional rendering logic.`,
-                });
-            }
-        }
-    }
-    // --- Added elements (in after, not in before) — informational ------------
-    for (const [key, afterEntries] of afterByKey) {
-        if (!beforeByKey.has(key)) {
-            for (const entry of afterEntries) {
-                errors.push({
-                    message: `[${viewport}] Added element: ${entry.path}`,
-                    remediation: `New element ${nodeLabel(entry.node)} detected on "${viewport}" viewport — verify this addition is intentional.`,
-                });
-            }
-        }
-    }
-    // --- Visibility changes and layout shifts --------------------------------
-    // For elements present in both snapshots, compare visibility and rect.
-    for (const [key, beforeEntries] of beforeByKey) {
-        const afterEntries = afterByKey.get(key);
-        if (!afterEntries)
-            continue;
-        // Compare pairwise (first-to-first, etc.) up to the shorter list length
-        const pairCount = Math.min(beforeEntries.length, afterEntries.length);
-        for (let i = 0; i < pairCount; i++) {
-            const bEntry = beforeEntries[i];
-            const aEntry = afterEntries[i];
-            // Visibility change
-            if (bEntry.node.visible && !aEntry.node.visible) {
-                errors.push({
-                    message: `[${viewport}] Element became hidden: ${bEntry.path}`,
-                    remediation: `Element ${nodeLabel(bEntry.node)} changed from visible to hidden on "${viewport}" viewport — check CSS display/visibility/opacity rules.`,
-                });
-            }
-            else if (!bEntry.node.visible && aEntry.node.visible) {
-                errors.push({
-                    message: `[${viewport}] Element became visible: ${bEntry.path}`,
-                    remediation: `Element ${nodeLabel(bEntry.node)} changed from hidden to visible on "${viewport}" viewport — verify this visibility change is intentional.`,
-                });
-            }
-            // Layout dimension shift (only when both have rect data)
-            if (bEntry.node.rect && aEntry.node.rect) {
-                const bRect = bEntry.node.rect;
-                const aRect = aEntry.node.rect;
-                const dx = Math.abs(aRect.x - bRect.x);
-                const dy = Math.abs(aRect.y - bRect.y);
-                const dw = Math.abs(aRect.width - bRect.width);
-                const dh = Math.abs(aRect.height - bRect.height);
-                const shifts = [];
-                if (dx > LAYOUT_SHIFT_PX)
-                    shifts.push(`x shifted by ${dx}px`);
-                if (dy > LAYOUT_SHIFT_PX)
-                    shifts.push(`y shifted by ${dy}px`);
-                if (dw > LAYOUT_SHIFT_PX)
-                    shifts.push(`width changed by ${dw}px`);
-                if (dh > LAYOUT_SHIFT_PX)
-                    shifts.push(`height changed by ${dh}px`);
-                if (shifts.length > 0) {
-                    errors.push({
-                        message: `[${viewport}] Layout shift on ${bEntry.path}: ${shifts.join(", ")}`,
-                        remediation: `Element ${nodeLabel(bEntry.node)} dimensions shifted by >${LAYOUT_SHIFT_PX}px on "${viewport}" viewport — review layout changes.`,
-                    });
-                }
-            }
-        }
-    }
-    return errors;
-}
-// ---------------------------------------------------------------------------
-// Public API
-// ---------------------------------------------------------------------------
-/**
- * Compare before and after visual capture results using DOM structural
- * analysis. Returns a list of `GateError` entries describing detected
- * differences per viewport.
- *
- * This does NOT perform pixel-level comparison — it analyses the serialized
- * DOM trees for element count changes, missing/added elements, visibility
- * changes, and significant layout dimension shifts.
- */
-export function reviewVisual(before, after) {
-    const errors = [];
-    // Only compare viewports present in both snapshots
-    const beforeViewports = new Set(Object.keys(before.domSnapshots));
-    const afterViewports = new Set(Object.keys(after.domSnapshots));
-    for (const viewport of beforeViewports) {
-        if (!afterViewports.has(viewport))
-            continue;
-        const beforeSnap = before.domSnapshots[viewport];
-        const afterSnap = after.domSnapshots[viewport];
-        errors.push(...compareSnapshots(viewport, beforeSnap, afterSnap));
-    }
-    return errors;
-}
-//# sourceMappingURL=visual-reviewer.js.map

package/dist/gates/visual-reviewer.js.map

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

package/dist/go/auto-chain.d.ts

@@ -1,136 +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 { findNextPendingMilestone, countPendingMilestones } from "../state/prd-status.js";
-import type { CommitResult } from "../state/writer.js";
-import type { ForgeConfig } from "../types.js";
-import type { SchedulerResult } from "../worktree/parallel.js";
-export interface AutoChainOptions {
-    projectDir: string;
-    prdPath: string;
-    config: ForgeConfig;
-    branch: string;
-    /** Project name (e.g., "forge-cc") */
-    project: string;
-    /** PRD slug for per-PRD status tracking */
-    prdSlug: string;
-    /** Relative PRD path for state docs */
-    activePrd: string;
-    /** Developer name for session memory */
-    developer: string;
-    /** Repository root (for worktree operations). Defaults to projectDir. */
-    repoRoot?: string;
-    /** If not provided, detect from per-PRD status */
-    startMilestone?: number;
-    /** Called when a milestone begins execution */
-    onMilestoneStart?: (milestoneNumber: number, name: string) => void;
-    /** Called when a milestone finishes (success or failure) */
-    onMilestoneComplete?: (milestoneNumber: number, result: MilestoneResult) => void;
-    /** Called when the entire chain finishes */
-    onChainComplete?: (results: MilestoneResult[]) => void;
-}
-export interface MilestoneResult {
-    milestoneNumber: number;
-    milestoneName: string;
-    success: boolean;
-    commitSha?: string;
-    isLast: boolean;
-    /** Fresh-context prompt for spawning this milestone's agent */
-    freshPrompt: string;
-    /** Path to the worktree used for execution */
-    worktreePath?: string;
-    errors: string[];
-}
-export interface AutoChainResult {
-    completed: MilestoneResult[];
-    /** true if the chain stopped due to a milestone failure */
-    stopped: boolean;
-    /** Milestone number where the chain stopped (on failure) */
-    stoppedAt?: number;
-    /** true if every milestone in the roadmap is complete */
-    allComplete: boolean;
-}
-/**
- * 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 declare function buildFreshSessionPrompt(projectDir: string, prdPath: string, milestoneNumber: number): Promise<string>;
-export { findNextPendingMilestone, countPendingMilestones };
-/**
- * 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 declare function runAutoChain(options: AutoChainOptions): Promise<AutoChainResult>;
-/**
- * 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 declare function completeMilestone(options: {
-    projectDir: string;
-    project: string;
-    prdSlug: string;
-    milestoneNumber: number;
-    milestoneName: string;
-    branch: string;
-    activePrd: string;
-    developer: string;
-    filesToStage: string[];
-    push?: boolean;
-    /** Path to the worktree used for execution. If set, commit happens in the worktree. */
-    worktreePath?: string;
-    /** Repository root, required when worktreePath is provided (for merge operations). */
-    repoRoot?: string;
-}): Promise<{
-    commitResult: CommitResult;
-    isLast: boolean;
-}>;
-/**
- * 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 declare function buildParallelPlan(prdPath: string): Promise<SchedulerResult>;