forge-cc 0.1.0

package/.forge.json

@@ -0,0 +1,5 @@
+{
+  "gates": ["types", "lint", "tests"],
+  "maxIterations": 5,
+  "verifyFreshness": 600000
+}

package/AGENTS.md

@@ -0,0 +1,42 @@
+# AGENTS.md -- forge-cc Instructions for Non-Claude Agents
+
+forge-cc is a pre-PR verification tool. You must pass verification before committing code.
+
+## Commands
+
+```bash
+# Run verification (required before every commit)
+npx forge verify
+
+# Check current status
+npx forge status
+```
+
+## Rules
+
+- Run `npx forge verify` and confirm all gates pass before any `git commit`.
+- If verification fails, fix the reported errors and re-run until it passes.
+- Never commit directly to `main` or `master`. Always use a feature branch.
+- Exit code `0` means pass. Exit code `1` means fail.
+
+## Configuration
+
+- Config file: `.forge.json` in project root.
+- If no config exists, gates are auto-detected from `package.json`.
+- Default gates: `types` (tsc), `lint` (biome), `tests` (npm test).
+
+## Structured Output
+
+Use `npx forge verify --json` for machine-readable JSON results.
+
+## Run Specific Gates
+
+Use `--gate` to run only certain gates:
+
+```bash
+npx forge verify --gate types,lint
+```
+
+## More Information
+
+See `README.md` for full documentation.

package/README.md

@@ -0,0 +1,283 @@
+# forge-cc
+
+Pre-PR verification harness and development workflow tool for Claude Code agents. Gate runner + CLI + MCP server + workflow skills.
+
+<!-- Badges: npm version, CI status, license -->
+
+## What It Does
+
+- **Verification gates** -- runs TypeScript type-checking, linting, tests, visual screenshots, runtime endpoint validation, and PRD acceptance criteria checks against your project before you commit.
+- **Mechanical enforcement** -- Claude Code PreToolUse hook and git pre-commit hook block commits that haven't passed verification. No discipline required; the machine enforces it.
+- **Workflow skills** -- `/forge:triage` turns brain dumps into Linear projects, `/forge:spec` interviews you and generates a PRD with milestones, `/forge:go` executes milestones with wave-based agent teams.
+- **Linear lifecycle** -- programmatic status transitions through Backlog, Planned, In Progress, In Review, and Done. Every skill keeps Linear in sync automatically.
+
+## Quick Start
+
+```bash
+# Install
+npm install forge-cc
+
+# Run verification against current project
+npx forge verify
+
+# Check last verification status
+npx forge status
+```
+
+On first run with no `.forge.json`, forge auto-detects gates from your `package.json`:
+- Has `typescript` in dependencies? Enables the **types** gate.
+- Has `@biomejs/biome` or `biome` in dependencies? Enables the **lint** gate.
+- Has a `test` script? Enables the **tests** gate.
+
+## Configuration
+
+Create a `.forge.json` in your project root to customize behavior:
+
+```json
+{
+  "gates": ["types", "lint", "tests"],
+  "maxIterations": 5,
+  "verifyFreshness": 600000,
+  "devServer": {
+    "command": "npm run dev",
+    "port": 3000,
+    "readyPattern": "ready on"
+  },
+  "prdPath": ".planning/prds/active.md",
+  "linearProject": "My Project"
+}
+```
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `gates` | `string[]` | `["types", "lint", "tests"]` | Which verification gates to run |
+| `maxIterations` | `number` | `5` | Max retry iterations for the verification pipeline |
+| `verifyFreshness` | `number` | `600000` | How long (ms) a passing verification stays valid. Default: 10 minutes |
+| `devServer.command` | `string` | -- | Command to start the dev server (for visual/runtime gates) |
+| `devServer.port` | `number` | -- | Port the dev server listens on |
+| `devServer.readyPattern` | `string` | -- | Stdout pattern indicating the server is ready |
+| `prdPath` | `string` | -- | Path to PRD file for acceptance criteria checking |
+| `linearProject` | `string` | -- | Linear project name for lifecycle tracking |
+
+If no `.forge.json` exists, forge auto-detects from `package.json` (see Quick Start).
+
+## CLI Commands
+
+### `forge verify`
+
+Run verification gates against the current project.
+
+```bash
+# Run all configured gates
+npx forge verify
+
+# Run specific gates only
+npx forge verify --gate types,lint
+
+# Output structured JSON (for programmatic use)
+npx forge verify --json
+
+# Include PRD acceptance criteria check
+npx forge verify --prd .planning/prds/active.md
+```
+
+| Flag | Description |
+|------|-------------|
+| `--gate <gates>` | Comma-separated list of gates to run (overrides config) |
+| `--json` | Output structured JSON instead of human-readable markdown |
+| `--prd <path>` | Path to PRD file for the `prd` gate |
+
+Exit code: `0` if all gates pass, `1` if any gate fails.
+
+Results are cached to `.forge/last-verify.json` for freshness checking by hooks.
+
+### `forge status`
+
+Print current project state: branch, last verification result, config source.
+
+```bash
+npx forge status
+```
+
+Output includes which gates passed/failed, how long ago verification ran, and whether config is from `.forge.json` or auto-detected.
+
+## Verification Gates
+
+| Gate | What It Checks | Requires |
+|------|---------------|----------|
+| `types` | TypeScript compilation (`tsc --noEmit`) | `typescript` in dependencies |
+| `lint` | Biome linting (`biome check`) | `@biomejs/biome` in dependencies |
+| `tests` | Test suite (`npm run test`) | A `test` script in `package.json` |
+| `visual` | Playwright screenshots + console error detection | Dev server config, `playwright` |
+| `runtime` | HTTP endpoint validation (status codes, response shape) | Dev server config, endpoint list |
+| `prd` | Diff against PRD acceptance criteria | PRD file path, git history |
+
+**Pipeline behavior:** Gates run in order. If all three core gates (types, lint, tests) fail, remaining gates are skipped. Each gate returns structured results with file paths, line numbers, and error messages.
+
+## Enforcement
+
+forge-cc provides two enforcement mechanisms that block commits without passing verification.
+
+### Claude Code PreToolUse Hook
+
+The recommended enforcement for Claude Code users. Intercepts `git commit` commands and checks:
+
+1. **Branch protection** -- blocks commits directly to `main` or `master`.
+2. **Verification required** -- blocks if no `.forge/last-verify.json` exists.
+3. **Verification passed** -- blocks if the last run failed.
+4. **Freshness** -- blocks if verification is older than `verifyFreshness` (default 10 min).
+
+**Install:**
+
+Add to your `.claude/settings.json`:
+
+```json
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node node_modules/forge-cc/hooks/pre-commit-verify.js"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+### Git Pre-Commit Hook
+
+Standard git hook for non-Claude-Code environments. Same four checks as the PreToolUse hook.
+
+The hook logic lives in `src/hooks/pre-commit.ts` and can be wired into any git hook runner (husky, simple-git-hooks, etc.).
+
+## MCP Server
+
+forge-cc registers its gates as MCP tools so agents can call them programmatically.
+
+**Configure in `.mcp.json`:**
+
+```json
+{
+  "mcpServers": {
+    "forge-cc": {
+      "command": "node",
+      "args": ["node_modules/forge-cc/dist/server.js"]
+    }
+  }
+}
+```
+
+**Available MCP tools:**
+
+| Tool | Description |
+|------|-------------|
+| `forge_verify_types` | Run TypeScript type checking |
+| `forge_verify_lint` | Run Biome linting |
+| `forge_verify_tests` | Run project test suite |
+| `forge_verify_visual` | Take screenshots, check console errors |
+| `forge_verify_runtime` | Validate API endpoints |
+| `forge_verify_prd` | Check changes against PRD criteria |
+| `forge_run_pipeline` | Run full verification pipeline |
+
+All tools accept `projectDir` (absolute path) and return structured JSON results.
+
+## Workflow Skills
+
+Claude Code skills that drive the full development lifecycle. Invoke them with slash commands.
+
+### `/forge:triage` -- Brain Dump to Linear Projects
+
+Paste unstructured ideas, sticky notes, or stream-of-consciousness text. The skill extracts distinct projects, deduplicates against your existing Linear backlog, and creates them after your confirmation.
+
+**Flow:** Input text -> extract projects -> deduplicate against Linear -> confirm -> create in Linear (Backlog state).
+
+### `/forge:spec` -- Interview to PRD
+
+Select a Linear project in Backlog state. The skill scans your codebase (structure, patterns, dependencies), conducts an adaptive interview (leading with recommendations, not blank-slate questions), generates a PRD with milestones, and syncs the plan back to Linear.
+
+**Flow:** Select project -> scan codebase -> interview -> generate PRD -> create milestones + issues in Linear -> move project to Planned.
+
+### `/forge:go` -- Execute Milestones
+
+Execute the next pending milestone from your PRD with wave-based agent teams. Each wave runs parallel agents for independent work, with verification between waves. Supports `--auto` to chain all remaining milestones without manual intervention.
+
+**Flow:** Orient (read state) -> pre-flight checks -> execute waves -> verify -> update state -> (optional) create PR.
+
+## Linear Integration
+
+forge-cc manages the full Linear project lifecycle:
+
+```
+Backlog  ->  Planned  ->  In Progress  ->  In Review  ->  Done
+  |            |              |               |            |
+triage     spec/PRD      go/execute      PR created    PR merged
+```
+
+Each skill transitions projects and issues to the appropriate status automatically. The Linear client (`src/linear/client.ts`) handles GraphQL queries, and dedicated modules manage projects, milestones, and issues.
+
+## Multi-Developer Setup
+
+For a new developer joining the team:
+
+1. **Clone the repo** that uses forge-cc.
+2. **Install dependencies:** `npm install` (forge-cc should be in `devDependencies`).
+3. **Run verification:** `npx forge verify` -- confirms your environment is set up correctly.
+4. **Check status:** `npx forge status` -- shows current branch and last verification.
+5. **Install the hook** (optional but recommended): add the PreToolUse hook to `.claude/settings.json` (see Enforcement section above).
+6. **Create a `.forge.json`** if the auto-detected gates don't match your needs.
+
+That's it. The gates run the same commands your CI does, so if `npx forge verify` passes locally, CI will pass too.
+
+## Project Structure
+
+```
+forge-cc/
+  src/
+    cli.ts              # CLI entry point (npx forge)
+    server.ts           # MCP server entry point
+    types.ts            # Core type definitions
+    gates/              # Verification gates (types, lint, tests, visual, runtime, prd)
+    linear/             # Linear API client + lifecycle management
+    hooks/              # Pre-commit hook logic
+    config/             # .forge.json schema + auto-detection loader
+    reporter/           # Human (markdown) and JSON output formatting
+    state/              # Session state reader/writer (STATE.md, ROADMAP.md)
+    spec/               # Spec interview engine + PRD generation
+    go/                 # Execution engine + verify loop + PR creation
+  skills/               # Claude Code skill definitions (/forge:triage, /forge:spec, /forge:go)
+  hooks/                # Installable hook files (PreToolUse)
+  tests/                # Test suite (vitest)
+  .forge.json           # Default configuration
+```
+
+## Development
+
+Working on forge-cc itself:
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run tests
+npm test
+
+# Watch mode (rebuild on changes)
+npm run dev
+
+# Run verification on forge-cc itself
+npm run verify
+```
+
+**Tech stack:** TypeScript (ES2022, strict), Node.js, `@modelcontextprotocol/sdk`, Commander, Playwright, Zod, Vitest.
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,148 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { execSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { runPipeline } from "./gates/index.js";
+import { loadConfig } from "./config/loader.js";
+const program = new Command();
+program
+    .name("forge")
+    .description("forge-cc — verification + workflow CLI for Claude Code agents")
+    .version("0.1.0");
+program
+    .command("verify")
+    .description("Run verification gates against the current project")
+    .option("--gate <gates>", "Comma-separated list of gates to run (e.g., types,lint,tests)")
+    .option("--json", "Output structured JSON instead of human-readable report")
+    .option("--prd <path>", "Path to PRD for acceptance criteria matching")
+    .action(async (opts) => {
+    try {
+        const projectDir = process.cwd();
+        const config = loadConfig(projectDir);
+        const gates = opts.gate ? opts.gate.split(",").map((g) => g.trim()) : config.gates;
+        const prdPath = opts.prd ?? config.prdPath;
+        const result = await runPipeline({
+            projectDir,
+            gates,
+            prdPath,
+            maxIterations: config.maxIterations,
+            devServerCommand: config.devServer?.command,
+            devServerPort: config.devServer?.port,
+        });
+        // Generate report if pipeline didn't produce one
+        if (!result.report) {
+            result.report = formatReport(result);
+        }
+        // Write verify cache (non-fatal if this fails)
+        try {
+            writeVerifyCache(projectDir, result);
+        }
+        catch (cacheErr) {
+            const msg = cacheErr instanceof Error ? cacheErr.message : String(cacheErr);
+            console.error(`Warning: Could not write verify cache: ${msg}`);
+        }
+        // Output
+        if (opts.json) {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else {
+            console.log(result.report);
+        }
+        process.exit(result.passed ? 0 : 1);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        console.error(`Error: forge verify failed — ${message}`);
+        process.exit(1);
+    }
+});
+program
+    .command("status")
+    .description("Print current project state")
+    .action(() => {
+    const projectDir = process.cwd();
+    // Branch
+    let branch = "unknown";
+    try {
+        branch = execSync("git branch --show-current", { encoding: "utf-8" }).trim();
+    }
+    catch { /* not a git repo */ }
+    console.log(`## Forge Status`);
+    console.log(`**Branch:** ${branch}`);
+    // Last verify
+    const cachePath = join(projectDir, ".forge", "last-verify.json");
+    if (existsSync(cachePath)) {
+        const cache = JSON.parse(readFileSync(cachePath, "utf-8"));
+        const status = cache.passed ? "PASSED" : "FAILED";
+        const age = Math.round((Date.now() - new Date(cache.timestamp).getTime()) / 60_000);
+        console.log(`**Last Verify:** ${status} (${age}min ago on ${cache.branch})`);
+        for (const gate of cache.gates) {
+            const icon = gate.passed ? "[x]" : "[ ]";
+            console.log(`  - ${icon} ${gate.gate}: ${gate.passed ? "PASS" : "FAIL"}`);
+        }
+    }
+    else {
+        console.log(`**Last Verify:** none`);
+    }
+    // Config
+    const configPath = join(projectDir, ".forge.json");
+    if (existsSync(configPath)) {
+        const config = JSON.parse(readFileSync(configPath, "utf-8"));
+        console.log(`**Config:** .forge.json (gates: ${config.gates?.join(", ") ?? "default"})`);
+    }
+    else {
+        console.log(`**Config:** auto-detected (no .forge.json)`);
+    }
+});
+function writeVerifyCache(projectDir, result) {
+    const forgeDir = join(projectDir, ".forge");
+    mkdirSync(forgeDir, { recursive: true });
+    let branch = "unknown";
+    try {
+        branch = execSync("git branch --show-current", { encoding: "utf-8" }).trim();
+    }
+    catch { /* not a git repo */ }
+    const cache = {
+        passed: result.passed,
+        timestamp: new Date().toISOString(),
+        gates: result.gates,
+        branch,
+    };
+    writeFileSync(join(forgeDir, "last-verify.json"), JSON.stringify(cache, null, 2));
+}
+function formatReport(result) {
+    const lines = [];
+    const status = result.passed ? "PASSED" : "FAILED";
+    lines.push("## Verification Report");
+    lines.push(`**Status:** ${status}`);
+    const totalMs = result.gates.reduce((sum, g) => sum + g.duration_ms, 0);
+    lines.push(`**Duration:** ${(totalMs / 1000).toFixed(1)}s`);
+    lines.push("");
+    lines.push("### Gates");
+    for (const gate of result.gates) {
+        const icon = gate.passed ? "[x]" : "[ ]";
+        const dur = `${(gate.duration_ms / 1000).toFixed(1)}s`;
+        let suffix = "";
+        if (!gate.passed && gate.errors.length > 0) {
+            suffix = ` — ${gate.errors.length} error${gate.errors.length === 1 ? "" : "s"}`;
+        }
+        lines.push(`- ${icon} ${gate.gate}: ${gate.passed ? "PASS" : "FAIL"} (${dur})${suffix}`);
+    }
+    // Errors detail section
+    const withErrors = result.gates.filter(g => g.errors.length > 0);
+    if (withErrors.length > 0) {
+        lines.push("");
+        lines.push("### Errors");
+        for (const gate of withErrors) {
+            lines.push(`#### ${gate.gate}`);
+            for (const err of gate.errors) {
+                const loc = err.file ? `${err.file}${err.line ? `:${err.line}` : ""}` : "";
+                lines.push(`- ${loc ? `${loc}: ` : ""}${err.message}`);
+            }
+        }
+    }
+    return lines.join("\n");
+}
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config/loader.d.ts

@@ -0,0 +1,2 @@
+import type { ForgeConfig } from "../types.js";
+export declare function loadConfig(projectDir: string): ForgeConfig;

package/dist/config/loader.js

@@ -0,0 +1,44 @@
+import { readFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { forgeConfigSchema } from "./schema.js";
+export function loadConfig(projectDir) {
+    const configPath = join(projectDir, ".forge.json");
+    if (existsSync(configPath)) {
+        try {
+            const raw = JSON.parse(readFileSync(configPath, "utf-8"));
+            return forgeConfigSchema.parse(raw);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.warn(`Warning: Failed to parse .forge.json (${message}). Falling back to auto-detect.`);
+        }
+    }
+    // Auto-detect from package.json
+    return autoDetectConfig(projectDir);
+}
+function autoDetectConfig(projectDir) {
+    const gates = [];
+    try {
+        const pkgPath = join(projectDir, "package.json");
+        const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+        const allDeps = {
+            ...pkg.dependencies,
+            ...pkg.devDependencies,
+        };
+        if (allDeps.typescript)
+            gates.push("types");
+        if (allDeps["@biomejs/biome"] || allDeps.biome)
+            gates.push("lint");
+        if (pkg.scripts?.test)
+            gates.push("tests");
+    }
+    catch {
+        // No package.json or invalid — use defaults
+        gates.push("types", "lint", "tests");
+    }
+    if (gates.length === 0) {
+        gates.push("types", "lint", "tests");
+    }
+    return forgeConfigSchema.parse({ gates });
+}
+//# sourceMappingURL=loader.js.map

package/dist/config/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGhD,MAAM,UAAU,UAAU,CAAC,UAAkB;IAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;IAEnD,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;YAC1D,OAAO,iBAAiB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO,CAAC,IAAI,CAAC,yCAAyC,OAAO,iCAAiC,CAAC,CAAC;QAClG,CAAC;IACH,CAAC;IAED,gCAAgC;IAChC,OAAO,gBAAgB,CAAC,UAAU,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,gBAAgB,CAAC,UAAkB;IAC1C,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;QACjD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QAEvD,MAAM,OAAO,GAAG;YACd,GAAG,GAAG,CAAC,YAAY;YACnB,GAAG,GAAG,CAAC,eAAe;SACvB,CAAC;QAEF,IAAI,OAAO,CAAC,UAAU;YAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,OAAO,CAAC,gBAAgB,CAAC,IAAI,OAAO,CAAC,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnE,IAAI,GAAG,CAAC,OAAO,EAAE,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,4CAA4C;QAC5C,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,iBAAiB,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAC5C,CAAC"}

package/dist/config/schema.d.ts

@@ -0,0 +1,57 @@
+import { z } from "zod";
+export declare const devServerSchema: z.ZodObject<{
+    command: z.ZodString;
+    port: z.ZodNumber;
+    readyPattern: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    port: number;
+    command: string;
+    readyPattern?: string | undefined;
+}, {
+    port: number;
+    command: string;
+    readyPattern?: string | undefined;
+}>;
+export declare const forgeConfigSchema: z.ZodObject<{
+    gates: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    maxIterations: z.ZodDefault<z.ZodNumber>;
+    verifyFreshness: z.ZodDefault<z.ZodNumber>;
+    devServer: z.ZodOptional<z.ZodObject<{
+        command: z.ZodString;
+        port: z.ZodNumber;
+        readyPattern: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        port: number;
+        command: string;
+        readyPattern?: string | undefined;
+    }, {
+        port: number;
+        command: string;
+        readyPattern?: string | undefined;
+    }>>;
+    prdPath: z.ZodOptional<z.ZodString>;
+    linearProject: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    gates: string[];
+    maxIterations: number;
+    verifyFreshness: number;
+    devServer?: {
+        port: number;
+        command: string;
+        readyPattern?: string | undefined;
+    } | undefined;
+    prdPath?: string | undefined;
+    linearProject?: string | undefined;
+}, {
+    gates?: string[] | undefined;
+    maxIterations?: number | undefined;
+    verifyFreshness?: number | undefined;
+    devServer?: {
+        port: number;
+        command: string;
+        readyPattern?: string | undefined;
+    } | undefined;
+    prdPath?: string | undefined;
+    linearProject?: string | undefined;
+}>;
+export type ForgeConfigInput = z.input<typeof forgeConfigSchema>;

package/dist/config/schema.js

@@ -0,0 +1,15 @@
+import { z } from "zod";
+export const devServerSchema = z.object({
+    command: z.string(),
+    port: z.number().int().positive(),
+    readyPattern: z.string().optional(),
+});
+export const forgeConfigSchema = z.object({
+    gates: z.array(z.string()).default(["types", "lint", "tests"]),
+    maxIterations: z.number().int().positive().default(5),
+    verifyFreshness: z.number().int().positive().default(600_000),
+    devServer: devServerSchema.optional(),
+    prdPath: z.string().optional(),
+    linearProject: z.string().optional(),
+});
+//# sourceMappingURL=schema.js.map

package/dist/config/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACjC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACpC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9D,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACrD,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;IAC7D,SAAS,EAAE,eAAe,CAAC,QAAQ,EAAE;IACrC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC"}

package/dist/gates/index.d.ts

@@ -0,0 +1,11 @@
+import type { GateResult, PipelineInput, PipelineResult } from "../types.js";
+/** Gate registry -- maps gate name to its function */
+export declare const gateRegistry: Record<string, (input: PipelineInput) => Promise<GateResult>>;
+/** Run the full verification pipeline */
+export declare function runPipeline(input: PipelineInput): Promise<PipelineResult>;
+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";