forge-cc 0.1.0

package/dist/reporter/human.js.map

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

package/dist/reporter/json.d.ts

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

package/dist/reporter/json.js

@@ -0,0 +1,4 @@
+export function formatJsonReport(result) {
+    return JSON.stringify(result, null, 2);
+}
+//# sourceMappingURL=json.js.map

package/dist/reporter/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/reporter/json.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,gBAAgB,CAAC,MAAsB;IACrD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACzC,CAAC"}

package/dist/server.d.ts

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

package/dist/server.js

@@ -0,0 +1,109 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { verifyTypes, verifyLint, verifyTests, verifyVisual, verifyRuntime, verifyPrd, runPipeline, } from "./gates/index.js";
+const server = new McpServer({
+    name: "forge-cc",
+    version: "0.1.0",
+});
+// Individual gate tools
+// Each handler is wrapped in try-catch to return structured errors instead of crashing the MCP server.
+function errorResponse(err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return { content: [{ type: "text", text: JSON.stringify({ error: message }) }] };
+}
+server.tool("forge_verify_types", "Run TypeScript type checking (tsc --noEmit)", { projectDir: z.string().describe("Absolute path to project root") }, async ({ projectDir }) => {
+    try {
+        const result = await verifyTypes(projectDir);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (err) {
+        return errorResponse(err);
+    }
+});
+server.tool("forge_verify_lint", "Run Biome linting checks", { projectDir: z.string().describe("Absolute path to project root") }, async ({ projectDir }) => {
+    try {
+        const result = await verifyLint(projectDir);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (err) {
+        return errorResponse(err);
+    }
+});
+server.tool("forge_verify_tests", "Run project test suite", { projectDir: z.string().describe("Absolute path to project root") }, async ({ projectDir }) => {
+    try {
+        const result = await verifyTests(projectDir);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (err) {
+        return errorResponse(err);
+    }
+});
+server.tool("forge_verify_visual", "Take screenshots and check for console errors", {
+    projectDir: z.string().describe("Absolute path to project root"),
+    pages: z.array(z.string()).default(["/"]).describe("Page paths to check"),
+    devServerCommand: z.string().optional().describe("Dev server start command"),
+    devServerPort: z.number().optional().describe("Dev server port"),
+}, async ({ projectDir, pages, devServerCommand, devServerPort }) => {
+    try {
+        const result = await verifyVisual(projectDir, pages, { devServerCommand, devServerPort });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (err) {
+        return errorResponse(err);
+    }
+});
+server.tool("forge_verify_runtime", "Validate API endpoints return expected responses", {
+    projectDir: z.string().describe("Absolute path to project root"),
+    endpoints: z.array(z.string()).describe("API endpoints to test (e.g., 'GET /api/health')"),
+    devServerCommand: z.string().optional().describe("Dev server start command"),
+    devServerPort: z.number().optional().describe("Dev server port"),
+}, async ({ projectDir, endpoints, devServerCommand, devServerPort }) => {
+    try {
+        const result = await verifyRuntime(projectDir, endpoints, { devServerCommand, devServerPort });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (err) {
+        return errorResponse(err);
+    }
+});
+server.tool("forge_verify_prd", "Check code changes against PRD acceptance criteria", {
+    projectDir: z.string().describe("Absolute path to project root"),
+    prdPath: z.string().describe("Path to PRD markdown file"),
+    baseBranch: z.string().default("main").describe("Base branch for diff comparison"),
+}, async ({ projectDir, prdPath, baseBranch }) => {
+    try {
+        const result = await verifyPrd(projectDir, prdPath, baseBranch);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (err) {
+        return errorResponse(err);
+    }
+});
+server.tool("forge_run_pipeline", "Run full verification pipeline (all configured gates)", {
+    projectDir: z.string().describe("Absolute path to project root"),
+    gates: z.array(z.string()).optional().describe("Gates to run (default: types,lint,tests)"),
+    prdPath: z.string().optional().describe("Path to PRD file"),
+    maxIterations: z.number().optional().describe("Max retry iterations"),
+}, async ({ projectDir, gates, prdPath, maxIterations }) => {
+    try {
+        const result = await runPipeline({
+            projectDir,
+            gates,
+            prdPath,
+            maxIterations,
+        });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (err) {
+        return errorResponse(err);
+    }
+});
+// Start server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch(console.error);
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/spec/generator.d.ts

@@ -0,0 +1,14 @@
+import type { PRDData } from "./templates.js";
+/**
+ * Generates a complete PRD markdown document from validated PRD data.
+ */
+export declare function generatePRD(data: PRDData): string;
+/**
+ * Generates a partial PRD from incomplete data (for incremental updates during interview).
+ * Fills missing fields with placeholders.
+ */
+export declare function generateDraftPRD(data: Partial<PRDData>): string;
+/**
+ * Validates PRD data, generates markdown, and writes to disk.
+ */
+export declare function writePRDToFile(data: PRDData, outputPath: string): void;

package/dist/spec/generator.js

@@ -0,0 +1,206 @@
+import { writeFileSync, mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import { validatePRD } from "./templates.js";
+// ── Section Generators ───────────────────────────────────────────────
+function renderHeader(data) {
+    const lines = [
+        `# ${data.project} — Specification`,
+        "",
+        `**Project:** ${data.project}`,
+        `**Status:** ${data.status}`,
+        `**Branch:** ${data.branch}`,
+        `**Created:** ${data.created}`,
+        `**Assigned To:** ${data.assignedTo}`,
+    ];
+    if (data.linearProject) {
+        lines.push(`**Linear Project:** ${data.linearProject}`);
+    }
+    return lines.join("\n");
+}
+function renderOverview(overview) {
+    return `## Overview\n\n${overview}`;
+}
+function renderProblemStatement(problemStatement) {
+    return `## Problem Statement\n\n${problemStatement}`;
+}
+function renderScope(scope) {
+    const sections = ["## Scope"];
+    sections.push("\n### In Scope");
+    for (const item of scope.inScope) {
+        sections.push(`- ${item}`);
+    }
+    sections.push("\n### Out of Scope");
+    for (const item of scope.outOfScope) {
+        sections.push(`- ${item}`);
+    }
+    sections.push("\n### Sacred / Do NOT Touch");
+    for (const item of scope.sacred) {
+        sections.push(`- ${item}`);
+    }
+    return sections.join("\n");
+}
+function renderUserStory(story) {
+    const lines = [
+        `### US-${story.id}: ${story.title}`,
+        `**Description:** ${story.description}`,
+        "**Acceptance Criteria:**",
+    ];
+    for (const criterion of story.acceptanceCriteria) {
+        lines.push(`- [ ] ${criterion}`);
+    }
+    return lines.join("\n");
+}
+function renderUserStories(stories) {
+    const sections = ["## User Stories", ""];
+    for (const story of stories) {
+        sections.push(renderUserStory(story));
+        sections.push("");
+    }
+    return sections.join("\n").trimEnd();
+}
+function renderTechnicalDesign(design) {
+    const sections = ["## Technical Design"];
+    if (design.projectStructure) {
+        sections.push(`\n### Project Structure\n${design.projectStructure}`);
+    }
+    if (design.keyTypes) {
+        sections.push(`\n### Key Types\n${design.keyTypes}`);
+    }
+    if (design.dependencies && design.dependencies.length > 0) {
+        sections.push("\n### Dependencies");
+        for (const dep of design.dependencies) {
+            sections.push(`- ${dep}`);
+        }
+    }
+    if (design.existingCode) {
+        sections.push(`\n### Existing Code\n${design.existingCode}`);
+    }
+    return sections.join("\n");
+}
+function renderMilestone(milestone) {
+    const lines = [
+        `### Milestone ${milestone.number}: ${milestone.name}`,
+        `**Assigned To:** ${milestone.assignedTo}`,
+        `**Goal:** ${milestone.goal}`,
+        "",
+    ];
+    for (const wave of milestone.waves) {
+        const agentCount = wave.agents.length;
+        lines.push(`**Wave ${wave.waveNumber} (${agentCount} agent${agentCount !== 1 ? "s" : ""} parallel):**`);
+        for (let i = 0; i < wave.agents.length; i++) {
+            const agent = wave.agents[i];
+            lines.push(`${i + 1}. **${agent.name}**: ${agent.task}`);
+            if (agent.files.length > 0) {
+                lines.push(`   - Files: ${agent.files.join(", ")}`);
+            }
+        }
+        lines.push("");
+    }
+    if (milestone.verificationCommands.length > 0) {
+        lines.push("**Verification:**");
+        lines.push("```bash");
+        for (const cmd of milestone.verificationCommands) {
+            lines.push(cmd);
+        }
+        lines.push("```");
+    }
+    return lines.join("\n");
+}
+function renderMilestones(milestones) {
+    const sections = ["## Implementation Milestones", ""];
+    for (const milestone of milestones) {
+        sections.push(renderMilestone(milestone));
+        sections.push("");
+        sections.push("---");
+        sections.push("");
+    }
+    // Remove trailing separator
+    if (sections.length > 2) {
+        sections.pop(); // empty line
+        sections.pop(); // ---
+    }
+    return sections.join("\n").trimEnd();
+}
+function renderVerification(verification) {
+    const sections = ["## Verification"];
+    sections.push("\n### Per-Milestone");
+    for (const item of verification.perMilestone) {
+        sections.push(`- ${item}`);
+    }
+    sections.push("\n### Overall");
+    for (const item of verification.overall) {
+        sections.push(`- ${item}`);
+    }
+    return sections.join("\n");
+}
+// ── Public API ───────────────────────────────────────────────────────
+/**
+ * Generates a complete PRD markdown document from validated PRD data.
+ */
+export function generatePRD(data) {
+    const sections = [
+        renderHeader(data),
+        renderOverview(data.overview),
+        renderProblemStatement(data.problemStatement),
+        renderScope(data.scope),
+        renderUserStories(data.userStories),
+        renderTechnicalDesign(data.technicalDesign),
+        renderMilestones(data.milestones),
+        renderVerification(data.verification),
+    ];
+    return sections.join("\n\n") + "\n";
+}
+/**
+ * Generates a partial PRD from incomplete data (for incremental updates during interview).
+ * Fills missing fields with placeholders.
+ */
+export function generateDraftPRD(data) {
+    const sections = [];
+    // Header — always present
+    const project = data.project ?? "Untitled Project";
+    const headerLines = [
+        `# ${project} — Specification`,
+        "",
+        `**Project:** ${project}`,
+        `**Status:** ${data.status ?? "Draft"}`,
+        `**Branch:** ${data.branch ?? "TBD"}`,
+        `**Created:** ${data.created ?? new Date().toISOString().split("T")[0]}`,
+        `**Assigned To:** ${data.assignedTo ?? "TBD"}`,
+    ];
+    if (data.linearProject) {
+        headerLines.push(`**Linear Project:** ${data.linearProject}`);
+    }
+    sections.push(headerLines.join("\n"));
+    if (data.overview) {
+        sections.push(renderOverview(data.overview));
+    }
+    if (data.problemStatement) {
+        sections.push(renderProblemStatement(data.problemStatement));
+    }
+    if (data.scope) {
+        sections.push(renderScope(data.scope));
+    }
+    if (data.userStories && data.userStories.length > 0) {
+        sections.push(renderUserStories(data.userStories));
+    }
+    if (data.technicalDesign) {
+        sections.push(renderTechnicalDesign(data.technicalDesign));
+    }
+    if (data.milestones && data.milestones.length > 0) {
+        sections.push(renderMilestones(data.milestones));
+    }
+    if (data.verification) {
+        sections.push(renderVerification(data.verification));
+    }
+    return sections.join("\n\n") + "\n";
+}
+/**
+ * Validates PRD data, generates markdown, and writes to disk.
+ */
+export function writePRDToFile(data, outputPath) {
+    const validated = validatePRD(data);
+    const markdown = generatePRD(validated);
+    mkdirSync(dirname(outputPath), { recursive: true });
+    writeFileSync(outputPath, markdown, "utf-8");
+}
+//# sourceMappingURL=generator.js.map

package/dist/spec/generator.js.map

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

package/dist/spec/interview.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Adaptive interview engine for spec generation.
+ *
+ * Pure logic — no side effects, no I/O. All state is passed in and returned.
+ * The interview leads with recommendations derived from codebase scan results,
+ * follows interesting threads based on user responses, and determines when
+ * enough info has been gathered for each PRD section.
+ */
+import type { ScanAllResult } from "./scanner.js";
+/** PRD sections in priority order */
+export declare const PRD_SECTIONS: readonly ["problem_and_goals", "user_stories", "technical_approach", "scope", "milestones"];
+export type PRDSection = (typeof PRD_SECTIONS)[number];
+/** Human-readable labels for each section */
+export declare const SECTION_LABELS: Record<PRDSection, string>;
+/** A single interview question */
+export interface InterviewQuestion {
+    id: string;
+    section: PRDSection;
+    text: string;
+    /** Recommendation or observation that motivates the question */
+    context: string;
+    /** Follow-up depth — 0 = top-level, 1+ = follow-up */
+    depth: number;
+}
+/** A recorded answer to a question */
+export interface InterviewAnswer {
+    questionId: string;
+    section: PRDSection;
+    answer: string;
+    timestamp: number;
+}
+/** Completeness status for a single section */
+export interface SectionStatus {
+    section: PRDSection;
+    answeredCount: number;
+    /** Minimum answers needed before the section is considered covered */
+    minRequired: number;
+    isComplete: boolean;
+}
+/** Full interview state — serializable, passed in/out of every function */
+export interface InterviewState {
+    projectName: string;
+    scanResults: ScanAllResult;
+    questions: InterviewQuestion[];
+    answers: InterviewAnswer[];
+    /** Counter used to generate unique question IDs */
+    nextQuestionId: number;
+    /** Tracks which sections the engine has asked top-level questions for */
+    askedSections: PRDSection[];
+    /** Number of answers recorded since the last PRD draft update */
+    answersSinceLastDraft: number;
+}
+/** Structured summary of gathered info for PRD generation */
+export interface InterviewSummary {
+    projectName: string;
+    sections: Record<PRDSection, {
+        label: string;
+        answers: Array<{
+            question: string;
+            answer: string;
+        }>;
+        isComplete: boolean;
+    }>;
+    scanResults: ScanAllResult;
+}
+/**
+ * Initialize a new interview with codebase context.
+ * The scan results inform the recommendations attached to questions.
+ */
+export declare function createInterview(projectName: string, scanResults: ScanAllResult): InterviewState;
+/**
+ * Generate 1-3 next questions based on current state.
+ * Prioritizes sections with the most gaps, leads with recommendations.
+ * Returns questions and the updated state (with new questions appended).
+ */
+export declare function generateNextQuestions(state: InterviewState): {
+    questions: InterviewQuestion[];
+    state: InterviewState;
+};
+/**
+ * Record the user's answer and return updated state.
+ */
+export declare function recordAnswer(state: InterviewState, questionId: string, answer: string): InterviewState;
+/**
+ * Returns true every 2-3 answers (triggers at 2, then every 3).
+ * The caller is responsible for resetting the counter after updating the draft.
+ */
+export declare function shouldUpdateDraft(state: InterviewState): boolean;
+/**
+ * Reset the draft update counter (call after updating the PRD draft).
+ */
+export declare function markDraftUpdated(state: InterviewState): InterviewState;
+/**
+ * Returns true when all sections have met their minimum answer thresholds.
+ */
+export declare function isComplete(state: InterviewState): boolean;
+/**
+ * Get the completeness status for all sections.
+ */
+export declare function getSectionStatuses(state: InterviewState): SectionStatus[];
+/**
+ * Build a structured summary of everything gathered, for PRD generation.
+ */
+export declare function getInterviewSummary(state: InterviewState): InterviewSummary;