forge-cc 0.1.0

package/dist/gates/index.js

@@ -0,0 +1,106 @@
+import { closeBrowser } from "../utils/browser.js";
+import { verifyTypes } from "./types-gate.js";
+import { verifyLint } from "./lint-gate.js";
+import { verifyTests } from "./tests-gate.js";
+import { verifyVisual } from "./visual-gate.js";
+import { verifyRuntime } from "./runtime-gate.js";
+import { verifyPrd } from "./prd-gate.js";
+/** Gate registry -- maps gate name to its function */
+export const gateRegistry = {
+    types: (input) => verifyTypes(input.projectDir),
+    lint: (input) => verifyLint(input.projectDir),
+    tests: (input) => verifyTests(input.projectDir),
+    visual: (input) => verifyVisual(input.projectDir, input.pages ?? [], {
+        devServerCommand: input.devServerCommand,
+        devServerPort: input.devServerPort,
+    }),
+    runtime: (input) => verifyRuntime(input.projectDir, input.apiEndpoints ?? [], {
+        devServerCommand: input.devServerCommand,
+        devServerPort: input.devServerPort,
+    }),
+    prd: (input) => verifyPrd(input.projectDir, input.prdPath ?? "", input.baseBranch),
+};
+/** Run the full verification pipeline */
+export async function runPipeline(input) {
+    const { gates: requestedGates, maxIterations = 3, } = input;
+    // Determine which gates to run
+    const gatesToRun = requestedGates ?? ["types", "lint", "tests"];
+    const results = [];
+    try {
+        for (const gateName of gatesToRun) {
+            const gateFn = gateRegistry[gateName];
+            if (!gateFn) {
+                results.push({
+                    gate: gateName,
+                    passed: false,
+                    errors: [{ message: `Unknown gate: ${gateName}` }],
+                    warnings: [],
+                    duration_ms: 0,
+                });
+                continue;
+            }
+            const result = await runGateSafe(gateName, () => gateFn(input));
+            results.push(result);
+            // Early exit: if all core gates (types, lint, tests) fail, skip remaining
+            const coreGates = results.filter(r => ["types", "lint", "tests"].includes(r.gate));
+            if (coreGates.length === 3 && coreGates.every(r => !r.passed)) {
+                // Add skipped gates
+                for (const remaining of gatesToRun.slice(gatesToRun.indexOf(gateName) + 1)) {
+                    results.push({
+                        gate: remaining,
+                        passed: false,
+                        errors: [],
+                        warnings: ["Skipped due to core gate failures"],
+                        duration_ms: 0,
+                    });
+                }
+                break;
+            }
+        }
+    }
+    finally {
+        try {
+            await closeBrowser();
+        }
+        catch { /* non-fatal */ }
+    }
+    const passed = results.every(g => g.passed);
+    return {
+        passed,
+        iteration: 1,
+        maxIterations,
+        gates: results,
+        report: "", // Reporter agent in Wave 2 will handle this
+    };
+}
+const GATE_TIMEOUT_MS = 120_000; // 2 minutes per gate
+async function runGateSafe(name, fn) {
+    const start = Date.now();
+    try {
+        const result = await Promise.race([
+            fn(),
+            new Promise((_, reject) => globalThis.setTimeout(() => reject(new Error(`Gate "${name}" timed out after ${GATE_TIMEOUT_MS / 1000}s`)), GATE_TIMEOUT_MS)),
+        ]);
+        return result;
+    }
+    catch (err) {
+        const duration = Date.now() - start;
+        const message = err instanceof Error ? err.message : String(err);
+        const isTimeout = message.includes("timed out");
+        return {
+            gate: name,
+            passed: false,
+            errors: [{ message: isTimeout ? message : `Gate "${name}" crashed: ${message}` }],
+            warnings: [],
+            duration_ms: duration,
+        };
+    }
+}
+// Re-export individual gates for direct use
+export { verifyTypes } from "./types-gate.js";
+export { verifyLint } from "./lint-gate.js";
+export { verifyTests } from "./tests-gate.js";
+export { verifyVisual } from "./visual-gate.js";
+export { verifyRuntime } from "./runtime-gate.js";
+export { verifyPrd } from "./prd-gate.js";
+//# sourceMappingURL=index.js.map

package/dist/gates/index.js.map

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

package/dist/gates/lint-gate.d.ts

@@ -0,0 +1,2 @@
+import type { GateResult } from "../types.js";
+export declare function verifyLint(projectDir: string): Promise<GateResult>;

package/dist/gates/lint-gate.js

@@ -0,0 +1,66 @@
+import { execSync } from "node:child_process";
+/**
+ * Biome diagnostics often look like:
+ *   path/to/file.ts:10:5 lint/rule ...
+ * or header lines with ━━ separators
+ */
+const BIOME_LOC_RE = /^(.+?):(\d+):\d+\s+(.+)$/;
+export async function verifyLint(projectDir) {
+    const start = Date.now();
+    const errors = [];
+    const warnings = [];
+    try {
+        execSync("npx biome check", {
+            cwd: projectDir,
+            stdio: "pipe",
+            timeout: 60_000,
+        });
+        return { gate: "lint", passed: true, errors, warnings, duration_ms: Date.now() - start };
+    }
+    catch (err) {
+        const stdout = err instanceof Error && "stdout" in err
+            ? String(err.stdout)
+            : "";
+        const stderr = err instanceof Error && "stderr" in err
+            ? String(err.stderr)
+            : "";
+        const output = `${stdout}\n${stderr}`;
+        const rawErrors = [];
+        for (const line of output.split("\n")) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            if (trimmed.includes(" ━━") ||
+                trimmed.toLowerCase().includes("error") ||
+                trimmed.includes("×")) {
+                const match = BIOME_LOC_RE.exec(trimmed);
+                if (match) {
+                    rawErrors.push({
+                        file: match[1],
+                        line: Number.parseInt(match[2], 10),
+                        message: match[3],
+                    });
+                }
+                else {
+                    rawErrors.push({ message: trimmed });
+                }
+            }
+        }
+        // Cap at 50 errors to avoid massive output
+        const cappedErrors = rawErrors.slice(0, 50);
+        if (rawErrors.length > 50) {
+            cappedErrors.push({ message: `... and ${rawErrors.length - 50} more errors` });
+        }
+        if (cappedErrors.length === 0) {
+            cappedErrors.push({ message: "biome check exited with non-zero status but no errors were parsed" });
+        }
+        return {
+            gate: "lint",
+            passed: false,
+            errors: cappedErrors,
+            warnings,
+            duration_ms: Date.now() - start,
+        };
+    }
+}
+//# sourceMappingURL=lint-gate.js.map

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

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

package/dist/gates/prd-gate.d.ts

@@ -0,0 +1,7 @@
+import type { GateResult } from "../types.js";
+/**
+ * Reads the git diff and compares against PRD acceptance criteria
+ * to check coverage. This is a heuristic check -- it helps catch
+ * obvious omissions but cannot verify behavior.
+ */
+export declare function verifyPrd(projectDir: string, prdPath: string, baseBranch?: string): Promise<GateResult>;

package/dist/gates/prd-gate.js

@@ -0,0 +1,193 @@
+import { execSync } from "node:child_process";
+import { readFileSync } from "node:fs";
+/**
+ * Reads the git diff and compares against PRD acceptance criteria
+ * to check coverage. This is a heuristic check -- it helps catch
+ * obvious omissions but cannot verify behavior.
+ */
+export async function verifyPrd(projectDir, prdPath, baseBranch = "main") {
+    const start = Date.now();
+    const errors = [];
+    const warnings = [];
+    try {
+        // Read PRD content
+        const prdContent = readFileSync(prdPath, "utf-8");
+        // Extract acceptance criteria
+        const criteria = extractCriteria(prdContent);
+        if (criteria.length === 0) {
+            warnings.push("No acceptance criteria found in PRD (looked for checkboxes and criteria headings)");
+            return {
+                gate: "prd",
+                passed: true,
+                errors,
+                warnings,
+                duration_ms: Date.now() - start,
+            };
+        }
+        // Get changed file names from diff
+        let changedFiles;
+        try {
+            const nameOnly = execSync(`git diff ${baseBranch}...HEAD --name-only`, { cwd: projectDir, encoding: "utf-8", timeout: 30_000 });
+            changedFiles = nameOnly
+                .split("\n")
+                .map((f) => f.trim())
+                .filter(Boolean);
+        }
+        catch {
+            changedFiles = [];
+            warnings.push("Could not get git diff -- branch may not have diverged from base");
+        }
+        // Get stat summary for additional context
+        let diffStat = "";
+        try {
+            diffStat = execSync(`git diff ${baseBranch}...HEAD --stat`, {
+                cwd: projectDir,
+                encoding: "utf-8",
+                timeout: 30_000,
+            });
+        }
+        catch {
+            // Non-critical -- we still have changedFiles
+        }
+        if (changedFiles.length === 0 && diffStat === "") {
+            warnings.push("No changes detected against base branch -- all criteria marked unclear");
+            for (const criterion of criteria) {
+                warnings.push(`? ${criterion} -- no changes to evaluate against`);
+            }
+            return {
+                gate: "prd",
+                passed: false,
+                errors: [{ message: `No changes found to evaluate against ${criteria.length} criteria` }],
+                warnings,
+                duration_ms: Date.now() - start,
+            };
+        }
+        // Evaluate each criterion against the diff
+        for (const criterion of criteria) {
+            const result = evaluateCriterion(criterion, changedFiles);
+            if (result.status === "covered") {
+                warnings.push(`\u2713 ${criterion} -- likely covered (matched: ${result.matchedFiles.join(", ")})`);
+            }
+            else if (result.status === "unclear") {
+                warnings.push(`? ${criterion} -- could not determine coverage`);
+            }
+            else {
+                errors.push({
+                    message: `\u2717 ${criterion} -- no matching changes found`,
+                    remediation: "Ensure the relevant code changes are committed and address this criterion",
+                });
+            }
+        }
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        errors.push({ message: `PRD verification failed: ${message}` });
+    }
+    return {
+        gate: "prd",
+        passed: errors.length === 0,
+        errors,
+        warnings,
+        duration_ms: Date.now() - start,
+    };
+}
+/**
+ * Extract acceptance criteria from PRD markdown content.
+ * Looks for:
+ * 1. Checkbox lines: `- [ ] ...` or `- [x] ...`
+ * 2. Lines under "## Acceptance Criteria" or "## User Stories" headings
+ */
+function extractCriteria(content) {
+    const lines = content.split("\n");
+    const criteria = [];
+    const seen = new Set();
+    let inCriteriaSection = false;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Check for criteria section headings
+        if (/^#{1,3}\s+(acceptance\s+criteria|user\s+stories)/i.test(trimmed)) {
+            inCriteriaSection = true;
+            continue;
+        }
+        // End criteria section at next heading
+        if (inCriteriaSection && /^#{1,3}\s+/.test(trimmed) && !/^#{1,3}\s+(acceptance\s+criteria|user\s+stories)/i.test(trimmed)) {
+            inCriteriaSection = false;
+            continue;
+        }
+        // Checkbox lines anywhere in the document
+        const checkboxMatch = trimmed.match(/^-\s+\[[ x]\]\s+(.+)/i);
+        if (checkboxMatch) {
+            const text = checkboxMatch[1].trim();
+            if (!seen.has(text)) {
+                seen.add(text);
+                criteria.push(text);
+            }
+            continue;
+        }
+        // Bullet points under a criteria section heading
+        if (inCriteriaSection) {
+            const bulletMatch = trimmed.match(/^[-*]\s+(.+)/);
+            if (bulletMatch) {
+                const text = bulletMatch[1].trim();
+                if (!seen.has(text)) {
+                    seen.add(text);
+                    criteria.push(text);
+                }
+            }
+        }
+    }
+    return criteria;
+}
+/**
+ * Heuristic evaluation of whether a criterion is covered by the diff.
+ * Extracts keywords from the criterion and matches against changed file paths.
+ */
+function evaluateCriterion(criterion, changedFiles) {
+    // Extract meaningful keywords (3+ chars, not common words)
+    const stopWords = new Set([
+        "the", "and", "for", "are", "but", "not", "you", "all", "can", "has",
+        "her", "was", "one", "our", "out", "its", "his", "how", "its", "may",
+        "who", "did", "get", "let", "say", "she", "too", "use", "way", "each",
+        "which", "their", "will", "other", "about", "many", "then", "them",
+        "been", "have", "from", "with", "they", "this", "that", "what", "when",
+        "make", "like", "just", "over", "such", "take", "into", "than", "most",
+        "also", "should", "would", "could", "must", "shall", "might", "does",
+        "display", "show", "page", "user", "view", "click", "able", "ensure",
+        "given", "when", "then",
+    ]);
+    const keywords = criterion
+        .toLowerCase()
+        .replace(/[^a-z0-9\s-]/g, " ")
+        .split(/\s+/)
+        .filter((w) => w.length >= 3 && !stopWords.has(w));
+    if (keywords.length === 0) {
+        return { status: "unclear", matchedFiles: [] };
+    }
+    // Match keywords against file paths
+    const matchedFiles = [];
+    for (const file of changedFiles) {
+        const fileLower = file.toLowerCase();
+        // Extract file name parts (split on /, ., -, _)
+        const fileParts = fileLower.split(/[/.\-_]/).filter(Boolean);
+        for (const keyword of keywords) {
+            if (fileLower.includes(keyword) ||
+                fileParts.some((part) => part.includes(keyword) || keyword.includes(part))) {
+                matchedFiles.push(file);
+                break;
+            }
+        }
+    }
+    if (matchedFiles.length > 0) {
+        // Cap displayed files at 3 for readability
+        const displayFiles = matchedFiles.length > 3
+            ? [...matchedFiles.slice(0, 3), `+${matchedFiles.length - 3} more`]
+            : matchedFiles;
+        return { status: "covered", matchedFiles: displayFiles };
+    }
+    // If no files matched but there are very few keywords, mark as unclear
+    if (keywords.length <= 2) {
+        return { status: "unclear", matchedFiles: [] };
+    }
+    return { status: "not_covered", matchedFiles: [] };
+}
+//# sourceMappingURL=prd-gate.js.map

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

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

package/dist/gates/runtime-gate.d.ts

@@ -0,0 +1,5 @@
+import type { GateResult } from "../types.js";
+export declare function verifyRuntime(projectDir: string, endpoints: string[], options?: {
+    devServerCommand?: string;
+    devServerPort?: number;
+}): Promise<GateResult>;

package/dist/gates/runtime-gate.js

@@ -0,0 +1,99 @@
+import { startDevServer, stopDevServer, waitForServer, } from "../utils/browser.js";
+export async function verifyRuntime(projectDir, endpoints, options) {
+    const start = Date.now();
+    const port = options?.devServerPort ?? 3000;
+    const errors = [];
+    const warnings = [];
+    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: "runtime",
+                passed: false,
+                errors: [{ message: `Dev server failed to start: ${message}` }],
+                warnings,
+                duration_ms: Date.now() - start,
+            };
+        }
+        // Ensure server is reachable
+        const ready = await waitForServer(port);
+        if (!ready) {
+            return {
+                gate: "runtime",
+                passed: false,
+                errors: [{ message: `Dev server not reachable on port ${port}` }],
+                warnings,
+                duration_ms: Date.now() - start,
+            };
+        }
+        // Test each endpoint
+        for (const endpoint of endpoints) {
+            let method;
+            let path;
+            // Parse "GET /api/foo" or "POST /api/foo" or just "/api/foo"
+            const spaceIndex = endpoint.indexOf(" ");
+            if (spaceIndex !== -1 && spaceIndex < endpoint.indexOf("/")) {
+                method = endpoint.substring(0, spaceIndex).toUpperCase();
+                path = endpoint.substring(spaceIndex + 1).trim();
+            }
+            else {
+                method = "GET";
+                path = endpoint.trim();
+            }
+            const label = `${method} ${path}`;
+            try {
+                const response = await fetch(`http://localhost:${port}${path}`, {
+                    method,
+                });
+                if (response.status >= 200 && response.status < 300) {
+                    // Success -- try to parse as JSON for informational warning
+                    try {
+                        const json = await response.json();
+                        const keys = Object.keys(json);
+                        warnings.push(`${label} -> ${response.status} (JSON, ${keys.length} keys)`);
+                    }
+                    catch {
+                        // Not JSON -- still a success, just note it
+                        warnings.push(`${label} -> ${response.status} (non-JSON response)`);
+                    }
+                }
+                else {
+                    errors.push({
+                        message: `${label} -> ${response.status} ${response.statusText}`,
+                    });
+                }
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : "Request failed";
+                errors.push({
+                    message: `${label} -> FAILED: ${message}`,
+                });
+            }
+        }
+        return {
+            gate: "runtime",
+            passed: errors.length === 0,
+            errors,
+            warnings,
+            duration_ms: Date.now() - start,
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : "Unknown error in verifyRuntime";
+        return {
+            gate: "runtime",
+            passed: false,
+            errors: [{ message }],
+            warnings,
+            duration_ms: Date.now() - start,
+        };
+    }
+    finally {
+        await stopDevServer();
+    }
+}
+//# sourceMappingURL=runtime-gate.js.map

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

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

package/dist/gates/tests-gate.d.ts

@@ -0,0 +1,2 @@
+import type { GateResult } from "../types.js";
+export declare function verifyTests(projectDir: string): Promise<GateResult>;

package/dist/gates/tests-gate.js

@@ -0,0 +1,116 @@
+import { execSync } from "node:child_process";
+/**
+ * Common test failure patterns with file/line info:
+ *   FAIL src/foo.test.ts > suite > test name
+ *   at src/foo.test.ts:42:10
+ */
+const TEST_FILE_RE = /^FAIL\s+(.+?)(?:\s+>|$)/;
+const STACKTRACE_RE = /at\s+.*?([^\s(]+):(\d+):\d+/;
+export async function verifyTests(projectDir) {
+    const start = Date.now();
+    const errors = [];
+    const warnings = [];
+    // Check if the test script exists in package.json
+    try {
+        const pkgRaw = execSync("node -e \"process.stdout.write(JSON.stringify(require('./package.json')))\"", {
+            cwd: projectDir,
+            stdio: "pipe",
+            timeout: 10_000,
+        });
+        const pkg = JSON.parse(String(pkgRaw));
+        if (!pkg.scripts?.test) {
+            return {
+                gate: "tests",
+                passed: true,
+                errors: [],
+                warnings: ["No test script found"],
+                duration_ms: Date.now() - start,
+            };
+        }
+    }
+    catch {
+        return {
+            gate: "tests",
+            passed: true,
+            errors: [],
+            warnings: ["No test script found"],
+            duration_ms: Date.now() - start,
+        };
+    }
+    try {
+        const result = execSync("npm run test -- --run", {
+            cwd: projectDir,
+            stdio: "pipe",
+            timeout: 300_000,
+        });
+        const output = String(result);
+        // Parse test summary from Vitest output
+        const summaryMatch = output.match(/Tests\s+(\d+)\s+passed(?:\s*\|\s*(\d+)\s+failed)?/);
+        if (summaryMatch) {
+            const passed = summaryMatch[1];
+            const failed = summaryMatch[2] ?? "0";
+            warnings.push(`${passed} passed, ${failed} failed`);
+        }
+        return {
+            gate: "tests",
+            passed: true,
+            errors: [],
+            warnings,
+            duration_ms: Date.now() - start,
+        };
+    }
+    catch (err) {
+        const stdout = err instanceof Error && "stdout" in err
+            ? String(err.stdout)
+            : "";
+        const stderr = err instanceof Error && "stderr" in err
+            ? String(err.stderr)
+            : "";
+        const output = `${stdout}\n${stderr}`;
+        let lastFailFile;
+        for (const line of output.split("\n")) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            // Track which test file we're in
+            const failMatch = TEST_FILE_RE.exec(trimmed);
+            if (failMatch) {
+                lastFailFile = failMatch[1];
+            }
+            // Try to extract stack trace location
+            const stackMatch = STACKTRACE_RE.exec(trimmed);
+            if (stackMatch) {
+                lastFailFile = stackMatch[1];
+            }
+            if (trimmed.includes("FAIL") ||
+                trimmed.includes("AssertionError") ||
+                trimmed.includes("AssertionError") ||
+                trimmed.includes("Expected") ||
+                trimmed.includes("Received")) {
+                errors.push({
+                    file: lastFailFile,
+                    line: stackMatch ? Number.parseInt(stackMatch[2], 10) : undefined,
+                    message: trimmed,
+                });
+            }
+        }
+        // Also try to extract the summary even on failure
+        const summaryMatch = output.match(/Tests\s+(?:(\d+)\s+passed\s*\|\s*)?(\d+)\s+failed/);
+        if (summaryMatch) {
+            const passed = summaryMatch[1] ?? "0";
+            const failed = summaryMatch[2];
+            warnings.push(`${passed} passed, ${failed} failed`);
+        }
+        if (errors.length === 0) {
+            errors.push({ message: "Test runner exited with non-zero status" });
+        }
+        return {
+            gate: "tests",
+            passed: false,
+            errors,
+            warnings,
+            duration_ms: Date.now() - start,
+        };
+    }
+}
+//# sourceMappingURL=tests-gate.js.map

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

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

package/dist/gates/types-gate.d.ts

@@ -0,0 +1,2 @@
+import type { GateResult } from "../types.js";
+export declare function verifyTypes(projectDir: string): Promise<GateResult>;