forge-cc 1.0.0 → 1.0.1

package/dist/setup/test-templates.js

@@ -1,313 +0,0 @@
-// ── Test Templates ──────────────────────────────────────────────────
-// Framework-aware unit test template generators.
-// Each function takes a source file path and returns a complete test file string.
-import { basename, dirname, extname, relative, sep } from "node:path";
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-/**
- * Extract a PascalCase or camelCase module name from a file path.
- * e.g. "src/utils/parse-config.ts" -> "parseConfig"
- */
-function extractModuleName(sourcePath) {
-    const base = basename(sourcePath);
-    const name = base.replace(/\.(ts|tsx|js|jsx)$/, "");
-    // Convert kebab-case to camelCase
-    return name.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
-}
-/**
- * Compute the relative import path from a test file to its source file.
- * Assumes test files live in __tests__/ adjacent to source, or co-located.
- * Returns a path with no extension (for TS imports).
- */
-export function computeRelativeImport(testFilePath, sourceFilePath) {
-    const testDir = dirname(testFilePath);
-    let rel = relative(testDir, sourceFilePath).replace(/\\/g, "/");
-    // Strip the file extension for TypeScript imports
-    rel = rel.replace(/\.(ts|tsx|js|jsx)$/, "");
-    // Ensure it starts with ./
-    if (!rel.startsWith(".")) {
-        rel = "./" + rel;
-    }
-    return rel;
-}
-/**
- * Derive a default test file path from a source path (co-located pattern).
- * e.g. "src/utils/helpers.ts" -> "src/utils/helpers.test.ts"
- */
-function deriveTestPath(sourcePath) {
-    const dir = dirname(sourcePath);
-    const base = basename(sourcePath);
-    const ext = extname(base);
-    const nameWithoutExt = base.replace(/\.(ts|tsx|js|jsx)$/, "");
-    const testExt = ext === ".tsx" || ext === ".jsx" ? ext : ".ts";
-    return `${dir}${sep}${nameWithoutExt}.test${testExt}`.replace(/\\/g, "/");
-}
-// ---------------------------------------------------------------------------
-// Templates
-// ---------------------------------------------------------------------------
-/**
- * Test stub for Next.js App Router API route handlers.
- * Tests GET/POST/PUT/DELETE handler functions with mocked NextRequest/NextResponse.
- */
-export function nextjsApiRouteTemplate(sourcePath) {
-    const moduleName = extractModuleName(sourcePath);
-    const testPath = deriveTestPath(sourcePath);
-    const importPath = computeRelativeImport(testPath, sourcePath);
-    return `import { describe, it, expect } from "vitest";
-import { NextRequest } from "next/server";
-
-// TODO: Update imports to match the actual exports from the source module
-import { GET, POST } from "${importPath}.js";
-
-describe("${moduleName} API route", () => {
-  describe("GET handler", () => {
-    it("should return a successful response", async () => {
-      const request = new NextRequest("http://localhost:3000/api/${moduleName}");
-
-      const response = await GET(request);
-
-      expect(response.status).toBe(200);
-      const body = await response.json();
-      expect(body).toBeDefined();
-    });
-
-    it("should handle errors gracefully", async () => {
-      const request = new NextRequest("http://localhost:3000/api/${moduleName}");
-
-      // TODO: Mock a dependency to trigger an error
-      const response = await GET(request);
-
-      expect(response.status).toBeDefined();
-    });
-  });
-
-  describe("POST handler", () => {
-    it("should accept valid input and return success", async () => {
-      const request = new NextRequest("http://localhost:3000/api/${moduleName}", {
-        method: "POST",
-        body: JSON.stringify({ /* TODO: add valid request body */ }),
-        headers: { "Content-Type": "application/json" },
-      });
-
-      const response = await POST(request);
-
-      expect(response.status).toBe(200);
-    });
-
-    it("should reject invalid input", async () => {
-      const request = new NextRequest("http://localhost:3000/api/${moduleName}", {
-        method: "POST",
-        body: JSON.stringify({}),
-        headers: { "Content-Type": "application/json" },
-      });
-
-      const response = await POST(request);
-
-      // TODO: Assert the expected error status code
-      expect(response.status).toBeDefined();
-    });
-  });
-});
-`;
-}
-/**
- * Test stub for React components using React Testing Library patterns.
- * Includes render test and basic interaction test.
- */
-export function reactComponentTemplate(sourcePath) {
-    const moduleName = extractModuleName(sourcePath);
-    // Capitalize first letter for component name convention
-    const componentName = moduleName.charAt(0).toUpperCase() + moduleName.slice(1);
-    const testPath = deriveTestPath(sourcePath);
-    const importPath = computeRelativeImport(testPath, sourcePath);
-    return `import { describe, it, expect } from "vitest";
-import { render, screen } from "@testing-library/react";
-import userEvent from "@testing-library/user-event";
-
-// TODO: Update import to match the actual default/named export
-import { ${componentName} } from "${importPath}.js";
-
-describe("${componentName} component", () => {
-  it("should render without crashing", () => {
-    render(<${componentName} />);
-
-    // TODO: Replace with an actual text or role query from the component
-    expect(screen.getByRole("heading")).toBeDefined();
-  });
-
-  it("should display expected content", () => {
-    render(<${componentName} />);
-
-    // TODO: Assert on the expected text or elements
-    expect(document.body.textContent).toBeTruthy();
-  });
-
-  it("should handle user interaction", async () => {
-    const user = userEvent.setup();
-    render(<${componentName} />);
-
-    // TODO: Replace with an actual interactive element and expected outcome
-    const button = screen.queryByRole("button");
-    if (button) {
-      await user.click(button);
-      // TODO: Assert the expected state change after interaction
-    }
-  });
-});
-`;
-}
-/**
- * Test stub for pure utility/helper functions.
- * Input/output pattern with describe blocks.
- */
-export function utilityTemplate(sourcePath) {
-    const moduleName = extractModuleName(sourcePath);
-    const testPath = deriveTestPath(sourcePath);
-    const importPath = computeRelativeImport(testPath, sourcePath);
-    return `import { describe, it, expect } from "vitest";
-
-// TODO: Update imports to match the actual exports from the source module
-import { ${moduleName} } from "${importPath}.js";
-
-describe("${moduleName}", () => {
-  describe("when given valid input", () => {
-    it("should return the expected output", () => {
-      // TODO: Replace with actual input and expected output
-      const input = undefined;
-      const result = ${moduleName}(input);
-
-      expect(result).toBeDefined();
-    });
-  });
-
-  describe("when given edge-case input", () => {
-    it("should handle empty input", () => {
-      // TODO: Replace with actual edge-case input
-      const result = ${moduleName}(undefined);
-
-      expect(result).toBeDefined();
-    });
-
-    it("should handle null or undefined", () => {
-      // TODO: Test null/undefined handling if applicable
-      expect(() => ${moduleName}(null as never)).not.toThrow();
-    });
-  });
-
-  describe("when given invalid input", () => {
-    it("should throw or return an error indicator", () => {
-      // TODO: Replace with actual invalid input
-      const invalidInput = undefined;
-
-      // TODO: Assert either a throw or an error return value
-      expect(() => ${moduleName}(invalidInput)).toBeDefined();
-    });
-  });
-});
-`;
-}
-/**
- * Test stub for Express routes using supertest patterns.
- * Tests GET and POST endpoints.
- */
-export function expressRouteTemplate(sourcePath) {
-    const moduleName = extractModuleName(sourcePath);
-    const testPath = deriveTestPath(sourcePath);
-    const importPath = computeRelativeImport(testPath, sourcePath);
-    return `import { describe, it, expect, beforeAll, afterAll } from "vitest";
-import request from "supertest";
-import express from "express";
-
-// TODO: Update import to match the actual export (router or route handler)
-import { router } from "${importPath}.js";
-
-describe("${moduleName} routes", () => {
-  const app = express();
-  app.use(express.json());
-  // TODO: Update the mount path to match the actual route prefix
-  app.use("/${moduleName}", router);
-
-  describe("GET /${moduleName}", () => {
-    it("should return 200 and a valid response", async () => {
-      const res = await request(app).get("/${moduleName}");
-
-      expect(res.status).toBe(200);
-      expect(res.body).toBeDefined();
-    });
-
-    it("should return the expected data structure", async () => {
-      const res = await request(app).get("/${moduleName}");
-
-      // TODO: Assert the shape of the response body
-      expect(res.body).toBeDefined();
-    });
-  });
-
-  describe("POST /${moduleName}", () => {
-    it("should accept valid input and return 201", async () => {
-      const res = await request(app)
-        .post("/${moduleName}")
-        .send({ /* TODO: add valid request body */ });
-
-      expect(res.status).toBe(201);
-    });
-
-    it("should reject invalid input with 400", async () => {
-      const res = await request(app)
-        .post("/${moduleName}")
-        .send({});
-
-      // TODO: Assert the expected error response
-      expect(res.status).toBe(400);
-    });
-  });
-});
-`;
-}
-// ---------------------------------------------------------------------------
-// Dispatcher
-// ---------------------------------------------------------------------------
-/**
- * Select the right template based on the file category and detected app framework.
- *
- * @param sourcePath  - Path to the source file being tested
- * @param category    - From TestCategory.name: "api-routes", "components", "utils",
- *                      "middleware", "models", "other"
- * @param appFramework - From TestAnalysisReport.framework.appFramework:
- *                       "nextjs-app", "nextjs-pages", "react-vite", "express",
- *                       "plain-ts", "unknown"
- */
-export function generateTestTemplate(sourcePath, category, appFramework) {
-    // API routes: pick template based on the app framework
-    if (category === "api-routes") {
-        if (appFramework === "nextjs-app" || appFramework === "nextjs-pages") {
-            return nextjsApiRouteTemplate(sourcePath);
-        }
-        if (appFramework === "express") {
-            return expressRouteTemplate(sourcePath);
-        }
-        // Fallback: use utility template for unknown API route frameworks
-        return utilityTemplate(sourcePath);
-    }
-    // Components: React component template for React-based frameworks
-    if (category === "components") {
-        if (appFramework === "nextjs-app" ||
-            appFramework === "nextjs-pages" ||
-            appFramework === "react-vite") {
-            return reactComponentTemplate(sourcePath);
-        }
-        // Non-React components fall back to utility template
-        return utilityTemplate(sourcePath);
-    }
-    // Middleware: Express middleware uses express template, others use utility
-    if (category === "middleware") {
-        if (appFramework === "express") {
-            return expressRouteTemplate(sourcePath);
-        }
-        return utilityTemplate(sourcePath);
-    }
-    // Utils, models, other: all use the utility template
-    return utilityTemplate(sourcePath);
-}
-//# sourceMappingURL=test-templates.js.map

package/dist/setup/test-templates.js.map

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

package/dist/spec/generator.d.ts

@@ -1,34 +0,0 @@
-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;
-export interface WorktreePRDResult {
-    /** Absolute path where the PRD was written in the worktree. */
-    prdPath: string;
-    /** Relative path from the worktree root (used for merging back). */
-    relativePath: string;
-}
-/**
- * Write a PRD to a worktree directory.
- *
- * Validates and generates the PRD markdown, then writes it to
- * `<worktreePath>/<relativePrdPath>`. Returns both the absolute path
- * and the relative path so callers can locate the file or merge it
- * back to the main working tree.
- *
- * @param data           - The PRD data to generate and write.
- * @param worktreePath   - Absolute path to the worktree root.
- * @param relativePrdPath - Path relative to the worktree root where
- *                          the PRD should be written (e.g. "tasks/prd.md").
- */
-export declare function writePRDToWorktree(data: PRDData, worktreePath: string, relativePrdPath: string): WorktreePRDResult;

package/dist/spec/generator.js

@@ -1,227 +0,0 @@
-import { writeFileSync, mkdirSync } from "node:fs";
-import { dirname, join } 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}`,
-    ];
-    if (milestone.dependsOn && milestone.dependsOn.length > 0) {
-        lines.push(`**dependsOn:** ${milestone.dependsOn.join(", ")}`);
-    }
-    lines.push("");
-    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");
-}
-/**
- * Write a PRD to a worktree directory.
- *
- * Validates and generates the PRD markdown, then writes it to
- * `<worktreePath>/<relativePrdPath>`. Returns both the absolute path
- * and the relative path so callers can locate the file or merge it
- * back to the main working tree.
- *
- * @param data           - The PRD data to generate and write.
- * @param worktreePath   - Absolute path to the worktree root.
- * @param relativePrdPath - Path relative to the worktree root where
- *                          the PRD should be written (e.g. "tasks/prd.md").
- */
-export function writePRDToWorktree(data, worktreePath, relativePrdPath) {
-    const prdPath = join(worktreePath, relativePrdPath);
-    writePRDToFile(data, prdPath);
-    return { prdPath, relativePath: relativePrdPath };
-}
-//# sourceMappingURL=generator.js.map

package/dist/spec/generator.js.map

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