forge-cc 0.1.0

package/dist/go/verify-loop.js

@@ -0,0 +1,172 @@
+import { runPipeline } from "../gates/index.js";
+/**
+ * Self-healing verification loop.
+ *
+ * Runs the forge verification pipeline, and on failure either invokes the
+ * `onFixAttempt` callback (so the caller can spawn a fix agent) or simply
+ * re-runs verification. Loops until the pipeline passes or max iterations
+ * are exhausted.
+ */
+export async function runVerifyLoop(options) {
+    const { projectDir, config, onIteration, onFixAttempt, } = options;
+    const maxIterations = options.maxIterations ?? config.maxIterations;
+    const results = [];
+    for (let iteration = 1; iteration <= maxIterations; iteration++) {
+        const pipelineInput = {
+            projectDir,
+            gates: config.gates,
+            prdPath: config.prdPath,
+            maxIterations,
+            devServerCommand: config.devServer?.command,
+            devServerPort: config.devServer?.port,
+        };
+        const result = await runPipeline(pipelineInput);
+        // Stamp the iteration number onto the result
+        const stamped = {
+            ...result,
+            iteration,
+            maxIterations,
+        };
+        results.push(stamped);
+        onIteration?.(iteration, stamped);
+        // Success — return immediately
+        if (stamped.passed) {
+            return {
+                passed: true,
+                iterations: iteration,
+                maxIterations,
+                results,
+                finalResult: stamped,
+                failedGates: [],
+                errorSummary: "",
+            };
+        }
+        // Not the last iteration — attempt a fix before retrying
+        if (iteration < maxIterations) {
+            const allErrors = collectErrors(stamped);
+            if (onFixAttempt) {
+                // Give the caller a chance to fix. Even if it returns false we still
+                // loop and re-verify (the caller may have partially fixed things, or
+                // an external process may have intervened).
+                await onFixAttempt(iteration, allErrors);
+            }
+        }
+    }
+    // Exhausted all iterations without passing
+    const finalResult = results[results.length - 1];
+    const failedGates = finalResult.gates
+        .filter((g) => !g.passed)
+        .map((g) => g.gate);
+    return {
+        passed: false,
+        iterations: maxIterations,
+        maxIterations,
+        results,
+        finalResult,
+        failedGates,
+        errorSummary: buildErrorSummary(maxIterations, finalResult),
+    };
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Collect all GateError items from failed gates in a pipeline result */
+function collectErrors(result) {
+    return result.gates
+        .filter((g) => !g.passed)
+        .flatMap((g) => g.errors);
+}
+/**
+ * Build a human-readable error summary for a failed verification run.
+ *
+ * Example output:
+ * ```
+ * Verification failed after 3 iterations.
+ *
+ * Failed gates:
+ * - types: 2 errors
+ *   - src/foo.ts:10: Type 'string' not assignable to 'number'
+ *   - src/bar.ts:5: Property 'x' does not exist on type 'Y'
+ * - lint: 1 error
+ *   - src/baz.ts:20: Unexpected any type
+ * ```
+ */
+function buildErrorSummary(iterations, result) {
+    const lines = [];
+    lines.push(`Verification failed after ${iterations} iteration${iterations === 1 ? "" : "s"}.`);
+    lines.push("");
+    const failedGates = result.gates.filter((g) => !g.passed);
+    if (failedGates.length === 0) {
+        return lines.join("\n");
+    }
+    lines.push("Failed gates:");
+    for (const gate of failedGates) {
+        const errorCount = gate.errors.length;
+        lines.push(`- ${gate.gate}: ${errorCount} error${errorCount === 1 ? "" : "s"}`);
+        for (const err of gate.errors) {
+            const location = formatLocation(err);
+            const prefix = location ? `${location}: ` : "";
+            lines.push(`  - ${prefix}${err.message}`);
+        }
+    }
+    return lines.join("\n");
+}
+/** Format file:line location string for an error */
+function formatLocation(err) {
+    if (!err.file)
+        return "";
+    return err.line ? `${err.file}:${err.line}` : err.file;
+}
+/**
+ * Format gate errors into a structured prompt for a fix agent.
+ *
+ * The output is designed to be directly usable in an AI agent prompt:
+ * it includes file paths, line numbers, error messages, and remediation
+ * hints so the agent can locate and fix issues without extra searching.
+ */
+export function formatErrorsForAgent(result) {
+    const lines = [];
+    const failedGates = result.gates.filter((g) => !g.passed);
+    if (failedGates.length === 0) {
+        return "All gates passed. No errors to fix.";
+    }
+    lines.push("# Verification Errors to Fix");
+    lines.push("");
+    for (const gate of failedGates) {
+        lines.push(`## Gate: ${gate.gate} (${gate.errors.length} errors)`);
+        lines.push("");
+        if (gate.errors.length === 0) {
+            lines.push("Gate failed but reported no structured errors.");
+            lines.push("");
+            continue;
+        }
+        for (const err of gate.errors) {
+            const location = formatLocation(err);
+            if (location) {
+                lines.push(`### ${location}`);
+            }
+            else {
+                lines.push("### (no file location)");
+            }
+            lines.push(`**Error:** ${err.message}`);
+            if (err.remediation) {
+                lines.push(`**Suggested fix:** ${err.remediation}`);
+            }
+            lines.push("");
+        }
+    }
+    // Add warnings as context (non-blocking but useful for agents)
+    const gatesWithWarnings = result.gates.filter((g) => g.warnings.length > 0);
+    if (gatesWithWarnings.length > 0) {
+        lines.push("## Warnings (non-blocking)");
+        lines.push("");
+        for (const gate of gatesWithWarnings) {
+            for (const warning of gate.warnings) {
+                lines.push(`- [${gate.gate}] ${warning}`);
+            }
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=verify-loop.js.map

package/dist/go/verify-loop.js.map

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

package/dist/hooks/pre-commit.d.ts

@@ -0,0 +1,5 @@
+export interface HookResult {
+    allowed: boolean;
+    reason?: string;
+}
+export declare function checkPreCommit(projectDir: string): HookResult;

package/dist/hooks/pre-commit.js

@@ -0,0 +1,69 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { execSync } from "node:child_process";
+import { loadConfig } from "../config/loader.js";
+export function checkPreCommit(projectDir) {
+    // Wrong branch protection
+    try {
+        const branch = execSync("git branch --show-current", {
+            cwd: projectDir,
+            encoding: "utf-8",
+        }).trim();
+        if (branch === "main" || branch === "master") {
+            return {
+                allowed: false,
+                reason: `Cannot commit directly to ${branch}. Create a feature branch first.`,
+            };
+        }
+    }
+    catch {
+        // Can't determine branch — allow
+    }
+    // Check verify cache
+    const cachePath = join(projectDir, ".forge", "last-verify.json");
+    if (!existsSync(cachePath)) {
+        return {
+            allowed: false,
+            reason: "No verification found. Run `npx forge verify` before committing.",
+        };
+    }
+    try {
+        const cache = JSON.parse(readFileSync(cachePath, "utf-8"));
+        // Validate cache structure — treat malformed cache as invalid
+        if (typeof cache.passed !== "boolean" || typeof cache.timestamp !== "string") {
+            return {
+                allowed: false,
+                reason: "Verification cache is malformed (missing or invalid fields). Run `npx forge verify`.",
+            };
+        }
+        if (!cache.passed) {
+            return {
+                allowed: false,
+                reason: "Last verification FAILED. Fix errors and run `npx forge verify` again.",
+            };
+        }
+        const config = loadConfig(projectDir);
+        const age = Date.now() - new Date(cache.timestamp).getTime();
+        if (Number.isNaN(age) || age < 0) {
+            return {
+                allowed: false,
+                reason: "Verification cache has an invalid timestamp. Run `npx forge verify`.",
+            };
+        }
+        if (age > config.verifyFreshness) {
+            const ageMin = Math.round(age / 60_000);
+            return {
+                allowed: false,
+                reason: `Verification is stale (${ageMin}min old). Run \`npx forge verify\` again.`,
+            };
+        }
+        return { allowed: true };
+    }
+    catch {
+        return {
+            allowed: false,
+            reason: "Could not read verification cache. Run `npx forge verify`.",
+        };
+    }
+}
+//# sourceMappingURL=pre-commit.js.map

package/dist/hooks/pre-commit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-commit.js","sourceRoot":"","sources":["../../src/hooks/pre-commit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAOjD,MAAM,UAAU,cAAc,CAAC,UAAkB;IAC/C,0BAA0B;IAC1B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,2BAA2B,EAAE;YACnD,GAAG,EAAE,UAAU;YACf,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAC,IAAI,EAAE,CAAC;QACV,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC7C,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,6BAA6B,MAAM,kCAAkC;aAC9E,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,iCAAiC;IACnC,CAAC;IAED,qBAAqB;IACrB,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,kBAAkB,CAAC,CAAC;IACjE,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EACJ,kEAAkE;SACrE,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;QAE3D,8DAA8D;QAC9D,IAAI,OAAO,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;YAC7E,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EACJ,sFAAsF;aACzF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAClB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EACJ,wEAAwE;aAC3E,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;QACtC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;QAC7D,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;YACjC,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EACJ,sEAAsE;aACzE,CAAC;QACJ,CAAC;QACD,IAAI,GAAG,GAAG,MAAM,CAAC,eAAe,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,MAAM,CAAC,CAAC;YACxC,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,0BAA0B,MAAM,2CAA2C;aACpF,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EACJ,4DAA4D;SAC/D,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/linear/client.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Typed wrapper around the Linear GraphQL API.
+ * Used by lifecycle modules (projects.ts, milestones.ts, issues.ts)
+ * and the execution engine for programmatic Linear management.
+ */
+export interface LinearProject {
+    id: string;
+    name: string;
+    description?: string;
+    state: string;
+    url: string;
+}
+export interface LinearMilestone {
+    id: string;
+    name: string;
+    description?: string;
+    progress: number;
+    sortOrder: number;
+}
+export interface LinearIssue {
+    id: string;
+    identifier: string;
+    title: string;
+    description?: string;
+    state: string;
+    projectId?: string;
+    milestoneId?: string;
+    url: string;
+}
+export interface LinearTeam {
+    id: string;
+    name: string;
+    key: string;
+}
+export interface CreateProjectInput {
+    name: string;
+    description?: string;
+    teamIds: string[];
+    state?: string;
+}
+export interface UpdateProjectInput {
+    name?: string;
+    description?: string;
+    state?: string;
+}
+export interface CreateMilestoneInput {
+    projectId: string;
+    name: string;
+    description?: string;
+    targetDate?: string;
+}
+export interface CreateIssueInput {
+    title: string;
+    description?: string;
+    teamId: string;
+    projectId?: string;
+    milestoneId?: string;
+    priority?: number;
+    state?: string;
+}
+export interface UpdateIssueInput {
+    title?: string;
+    description?: string;
+    state?: string;
+    milestoneId?: string;
+    priority?: number;
+}
+export declare class LinearClientError extends Error {
+    readonly statusCode?: number | undefined;
+    readonly errors?: Array<{
+        message: string;
+    }> | undefined;
+    constructor(message: string, statusCode?: number | undefined, errors?: Array<{
+        message: string;
+    }> | undefined);
+}
+export declare class LinearClient {
+    private readonly apiKey;
+    constructor(apiKey?: string);
+    listProjects(opts?: {
+        query?: string;
+        state?: string;
+    }): Promise<LinearProject[]>;
+    createProject(input: CreateProjectInput): Promise<LinearProject>;
+    updateProject(id: string, input: UpdateProjectInput): Promise<LinearProject>;
+    listMilestones(projectId: string): Promise<LinearMilestone[]>;
+    createMilestone(input: CreateMilestoneInput): Promise<LinearMilestone>;
+    listIssues(opts?: {
+        projectId?: string;
+        milestoneId?: string;
+        state?: string;
+    }): Promise<LinearIssue[]>;
+    createIssue(input: CreateIssueInput): Promise<LinearIssue>;
+    updateIssue(id: string, input: UpdateIssueInput): Promise<LinearIssue>;
+    createComment(issueId: string, body: string): Promise<void>;
+    listTeams(): Promise<LinearTeam[]>;
+    /**
+     * Execute a GraphQL request against the Linear API with retry + backoff.
+     */
+    private request;
+    /**
+     * Auto-paginate a connection query. The query MUST accept `$after: String`
+     * and the root field must return `{ pageInfo { hasNextPage endCursor } nodes { ... } }`.
+     */
+    private paginate;
+    /** Normalize a raw issue node from GraphQL into our flat LinearIssue shape. */
+    private mapIssue;
+}