forge-cc 0.1.41 → 1.0.1

package/dist/setup/templates.js

@@ -1,109 +0,0 @@
-// ── Setup Templates ─────────────────────────────────────────────────
-// String template functions used by /forge:setup to scaffold project files.
-// ── .forge.json ─────────────────────────────────────────────────────
-export function forgeConfigTemplate(ctx) {
-    const config = {
-        gates: ctx.gates,
-        maxIterations: 5,
-    };
-    if (ctx.appDir) {
-        config.appDir = ctx.appDir;
-    }
-    if (ctx.testing) {
-        config.testing = ctx.testing;
-    }
-    if (ctx.forgeVersion) {
-        config.forgeVersion = ctx.forgeVersion;
-    }
-    return JSON.stringify(config, null, 2) + "\n";
-}
-// ── Project CLAUDE.md ───────────────────────────────────────────────
-export function claudeMdTemplate(ctx) {
-    const gatesList = ctx.gates.map((g) => `\`${g}\``).join(", ");
-    return `# ${ctx.projectName} — Claude Code Instructions
-
-## What This Is
-${ctx.description}
-
-**Tech:** ${ctx.techStack}
-
-## Quick Reference
-
-| Action | Command |
-|--------|---------|
-| Run verification | \`npx forge verify\` |
-| Run specific gates | \`npx forge verify --gate ${ctx.gates.join(",")}\` |
-| Check status | \`npx forge status\` |
-| Build | \`npm run build\` |
-| Test | \`npm test\` |
-
-## Code Map
-
-\`\`\`
-src/
-  (add your project structure here)
-\`\`\`
-
-## Key Docs
-
-| File | Purpose |
-|------|---------|
-| \`.planning/status/<slug>.json\` | Per-PRD milestone status |
-| \`tasks/lessons.md\` | Lessons learned (max 10 active) |
-
-## Session Protocol
-- **On start:** Read CLAUDE.md → .planning/status/*.json → tasks/lessons.md
-- **When lost:** Re-read planning docs, don't guess from stale context
-
-## Session Protocol END (Mandatory)
-1. \`.planning/status/<slug>.json\` — update milestone status
-2. \`tasks/lessons.md\` — add/refine lessons (max 10, promote when full)
-3. Commit doc updates to the feature branch
-
-## Execution Rules
-- **Plan before building.** Read the PRD before touching code.
-- **Verify everything.** Run \`npx forge verify\` after changes land.
-- **All changes via PR.** Never commit directly to main.
-- **Branch naming:** \`feat/short-description\` or \`fix/short-description\`
-
-## Verification Gates
-Active gates: ${gatesList}
-
-## Learned Rules
-(none yet)
-`;
-}
-// ── tasks/lessons.md ────────────────────────────────────────────────
-export function lessonsMdTemplate(ctx) {
-    return `# Lessons Learned — ${ctx.projectName}
-
-<!-- Max 10 active one-liners. Format: - **[topic]** The rule -->
-<!-- When full, promote the most battle-tested to CLAUDE.md ## Learned Rules -->
-
-(none yet)
-`;
-}
-// ── ~/.claude/CLAUDE.md (global, for fresh installs) ────────────────
-export function globalClaudeMdTemplate() {
-    return `# Global Claude Code Instructions
-
-## How to Work
-- **Follow instructions exactly.** Skills, CLAUDE.md rules, and workflow steps are tested — execute every step as written, including all AskUserQuestion prompts.
-- **Default to action.** Don't ask for confirmation. Plan internally, execute, verify.
-- **Iterate on failure.** Fix what breaks. Only stop to ask when truly blocked on missing credentials, ambiguous business requirements, or destructive actions on shared infrastructure.
-- **Use agent teams** for non-trivial work (3+ files or 3+ steps).
-
-## Verification
-- Never mark complete without proving it works.
-- Build and tests must pass. Run them.
-
-## Principles
-- Simple changes only. Find root causes. Touch only what's necessary.
-`;
-}
-// ── .gitignore lines ────────────────────────────────────────────────
-export function gitignoreForgeLines() {
-    return `.forge/
-`;
-}
-//# sourceMappingURL=templates.js.map

package/dist/setup/templates.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/setup/templates.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,4EAA4E;AAgB5E,uEAAuE;AAEvE,MAAM,UAAU,mBAAmB,CAAC,GAAiB;IACnD,MAAM,MAAM,GAA4B;QACtC,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,aAAa,EAAE,CAAC;KACjB,CAAC;IACF,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QACf,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAC7B,CAAC;IACD,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;QAChB,MAAM,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;IAC/B,CAAC;IACD,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;QACrB,MAAM,CAAC,YAAY,GAAG,GAAG,CAAC,YAAY,CAAC;IACzC,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;AAChD,CAAC;AAED,uEAAuE;AAEvE,MAAM,UAAU,gBAAgB,CAAC,GAAiB;IAChD,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE9D,OAAO,KAAK,GAAG,CAAC,WAAW;;;EAG3B,GAAG,CAAC,WAAW;;YAEL,GAAG,CAAC,SAAS;;;;;;;mDAO0B,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBAmCtD,SAAS;;;;CAIxB,CAAC;AACF,CAAC;AAED,uEAAuE;AAEvE,MAAM,UAAU,iBAAiB,CAAC,GAAiB;IACjD,OAAO,uBAAuB,GAAG,CAAC,WAAW;;;;;;CAM9C,CAAC;AACF,CAAC;AAED,uEAAuE;AAEvE,MAAM,UAAU,sBAAsB;IACpC,OAAO;;;;;;;;;;;;;;CAcR,CAAC;AACF,CAAC;AAED,uEAAuE;AAEvE,MAAM,UAAU,mBAAmB;IACjC,OAAO;CACR,CAAC;AACF,CAAC"}

package/dist/setup/test-planner.d.ts

@@ -1,38 +0,0 @@
-import type { TestAnalysisReport } from "../gates/test-analysis.js";
-import type { TestingConfig } from "../types.js";
-import type { ScaffoldPlan } from "./test-scaffold.js";
-export interface TestPlanningData {
-    /** The test analysis report from scanning the project */
-    report: TestAnalysisReport;
-    /** Human-readable summary of findings */
-    summary: string;
-    /** Per-category summaries for user confirmation prompts */
-    categorySummaries: CategorySummary[];
-}
-export interface CategorySummary {
-    name: string;
-    sourceCount: number;
-    testCount: number;
-    untestedCount: number;
-    description: string;
-}
-export interface TestPlannerResult {
-    /** The test analysis report from scanning the project */
-    report: TestAnalysisReport;
-    /** Categories the user confirmed for test scaffolding */
-    confirmedCategories: string[];
-    /** The chosen test runner */
-    runner: "vitest" | "jest";
-    /** The test directory */
-    testDir: string;
-    /** Whether structural tests are included */
-    structural: boolean;
-    /** The generated testing config to persist to .forge.json */
-    testingConfig: TestingConfig;
-    /** The scaffold plan (ready to execute) */
-    scaffoldPlan: ScaffoldPlan;
-}
-/** Analyze the project and prepare the test planning data. */
-export declare function analyzeForTestPlanning(projectDir: string): Promise<TestPlanningData>;
-/** Build the final plan + config after user confirms categories. */
-export declare function buildTestPlan(report: TestAnalysisReport, confirmedCategories: string[], runner: "vitest" | "jest", testDir: string, structural: boolean, projectDir: string): Promise<TestPlannerResult>;

package/dist/setup/test-planner.js

@@ -1,91 +0,0 @@
-// ── Test Planner ────────────────────────────────────────────────────
-// Interactive test planning module for /forge:setup integration.
-// Analyzes project test coverage, then builds a scaffold plan + config
-// from user-confirmed categories.
-import { analyzeTestCoverage } from "../gates/test-analysis.js";
-import { buildScaffoldPlan } from "./test-scaffold.js";
-// ---------------------------------------------------------------------------
-// Category Description Helpers
-// ---------------------------------------------------------------------------
-function describeCategoryName(name) {
-    switch (name) {
-        case "api-routes":
-            return "API routes and endpoint handlers";
-        case "components":
-            return "UI components (React/TSX)";
-        case "utils":
-            return "Utility functions and helpers";
-        case "middleware":
-            return "Middleware and interceptors";
-        case "models":
-            return "Data models, schemas, and entities";
-        case "other":
-            return "Other source files";
-        default:
-            return name;
-    }
-}
-// ---------------------------------------------------------------------------
-// Analysis Phase
-// ---------------------------------------------------------------------------
-/** Analyze the project and prepare the test planning data. */
-export async function analyzeForTestPlanning(projectDir) {
-    const report = await analyzeTestCoverage(projectDir);
-    const categorySummaries = report.categories.map((cat) => ({
-        name: cat.name,
-        sourceCount: cat.sourceFiles.length,
-        testCount: cat.testFiles.length,
-        untestedCount: cat.untestedFiles.length,
-        description: describeCategoryName(cat.name),
-    }));
-    const lines = [];
-    lines.push(`Framework: ${report.framework.appFramework}`);
-    lines.push(`Test runner: ${report.framework.testRunner}`);
-    lines.push(`Coverage: ${report.coverage.testFiles} test files / ${report.coverage.sourceFiles} source files (ratio: ${report.coverage.ratio})`);
-    if (report.framework.detectedPatterns.length > 0) {
-        lines.push(`Detected: ${report.framework.detectedPatterns.join(", ")}`);
-    }
-    if (categorySummaries.length > 0) {
-        lines.push("");
-        lines.push("Categories:");
-        for (const cat of categorySummaries) {
-            lines.push(`  - ${cat.name}: ${cat.sourceCount} source, ${cat.testCount} tested, ${cat.untestedCount} untested`);
-        }
-    }
-    return {
-        report,
-        summary: lines.join("\n"),
-        categorySummaries,
-    };
-}
-// ---------------------------------------------------------------------------
-// Plan Building Phase
-// ---------------------------------------------------------------------------
-/** Build the final plan + config after user confirms categories. */
-export async function buildTestPlan(report, confirmedCategories, runner, testDir, structural, projectDir) {
-    const scaffoldPlan = await buildScaffoldPlan(report, {
-        projectDir,
-        testDir,
-        runner,
-        structural,
-        categories: confirmedCategories,
-    });
-    const testingConfig = {
-        enforce: true,
-        runner,
-        testDir,
-        sourceDir: "src",
-        structural,
-        categories: confirmedCategories,
-    };
-    return {
-        report,
-        confirmedCategories,
-        runner,
-        testDir,
-        structural,
-        testingConfig,
-        scaffoldPlan,
-    };
-}
-//# sourceMappingURL=test-planner.js.map

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

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

package/dist/setup/test-scaffold.d.ts

@@ -1,31 +0,0 @@
-import type { TestAnalysisReport } from "../gates/test-analysis.js";
-export interface ScaffoldPlan {
-    configFile: {
-        path: string;
-        content: string;
-    } | null;
-    packageJsonUpdates: {
-        scripts?: Record<string, string>;
-        devDependencies?: Record<string, string>;
-    };
-    testFiles: Array<{
-        path: string;
-        content: string;
-    }>;
-    structuralTests: Array<{
-        path: string;
-        content: string;
-    }>;
-}
-export interface ScaffoldOptions {
-    projectDir: string;
-    testDir?: string;
-    runner?: "vitest" | "jest";
-    structural?: boolean;
-    categories?: string[];
-    entryPoints?: string[];
-}
-export declare function buildScaffoldPlan(report: TestAnalysisReport, options: ScaffoldOptions): Promise<ScaffoldPlan>;
-export declare function executeScaffoldPlan(plan: ScaffoldPlan, projectDir: string): Promise<{
-    filesWritten: string[];
-}>;

package/dist/setup/test-scaffold.js

@@ -1,209 +0,0 @@
-// ── Test Scaffold Engine ────────────────────────────────────────────
-// Orchestrator that takes a TestAnalysisReport + options and produces
-// a ScaffoldPlan: config files, package.json updates, unit test stubs,
-// and structural test stubs. Can also execute the plan to disk.
-import { mkdir, writeFile } from "node:fs/promises";
-import { dirname, basename, extname } from "node:path";
-import { generateTestTemplate } from "./test-templates.js";
-import { generateStructuralTests } from "./structural-templates.js";
-// ---------------------------------------------------------------------------
-// Config Generation
-// ---------------------------------------------------------------------------
-function needsJsdom(report) {
-    const fw = report.framework.appFramework;
-    return fw === "nextjs-app" || fw === "nextjs-pages" || fw === "react-vite";
-}
-function generateVitestConfig(report, testDir) {
-    const lines = [];
-    lines.push(`import { defineConfig } from "vitest/config";`);
-    lines.push(``);
-    lines.push(`export default defineConfig({`);
-    lines.push(`  test: {`);
-    lines.push(`    include: ["${testDir}/**/*.test.ts", "${testDir}/**/*.test.tsx"],`);
-    if (needsJsdom(report)) {
-        lines.push(`    environment: "jsdom",`);
-    }
-    lines.push(`    coverage: {`);
-    lines.push(`      provider: "v8",`);
-    lines.push(`      include: ["src/**/*.ts", "src/**/*.tsx"],`);
-    lines.push(`      exclude: ["src/**/*.test.ts", "src/**/*.test.tsx", "src/**/*.d.ts"],`);
-    lines.push(`    },`);
-    lines.push(`  },`);
-    lines.push(`});`);
-    lines.push(``);
-    return lines.join("\n");
-}
-function generateJestConfig(report, testDir) {
-    const lines = [];
-    lines.push(`import type { Config } from "jest";`);
-    lines.push(``);
-    lines.push(`const config: Config = {`);
-    lines.push(`  testMatch: ["<rootDir>/${testDir}/**/*.test.ts", "<rootDir>/${testDir}/**/*.test.tsx"],`);
-    lines.push(`  transform: {`);
-    lines.push(`    "^.+\\\\.tsx?$": "ts-jest",`);
-    lines.push(`  },`);
-    if (needsJsdom(report)) {
-        lines.push(`  testEnvironment: "jsdom",`);
-    }
-    lines.push(`};`);
-    lines.push(``);
-    lines.push(`export default config;`);
-    lines.push(``);
-    return lines.join("\n");
-}
-// ---------------------------------------------------------------------------
-// Package.json Updates
-// ---------------------------------------------------------------------------
-function buildPackageJsonUpdates(runner, report) {
-    const scripts = {};
-    const devDependencies = {};
-    if (runner === "vitest") {
-        scripts["test"] = "vitest run";
-        devDependencies["vitest"] = "^4.0.0";
-    }
-    else {
-        scripts["test"] = "jest";
-        devDependencies["jest"] = "^29.0.0";
-        devDependencies["ts-jest"] = "^29.0.0";
-        devDependencies["@types/jest"] = "^29.0.0";
-    }
-    const fw = report.framework.appFramework;
-    // React frameworks need testing-library
-    if (fw === "nextjs-app" || fw === "nextjs-pages" || fw === "react-vite") {
-        devDependencies["@testing-library/react"] = "^16.0.0";
-        devDependencies["@testing-library/user-event"] = "^14.0.0";
-        if (runner === "vitest") {
-            devDependencies["jsdom"] = "^25.0.0";
-        }
-    }
-    // Express needs supertest
-    if (fw === "express") {
-        devDependencies["supertest"] = "^7.0.0";
-        devDependencies["@types/supertest"] = "^6.0.0";
-    }
-    return { scripts, devDependencies };
-}
-// ---------------------------------------------------------------------------
-// Unit Test Stub Generation
-// ---------------------------------------------------------------------------
-function deriveTestFilePath(sourcePath, testDir) {
-    // Strip leading source directory prefix to get the relative sub-path
-    const srcPrefixes = ["src/", "lib/", "app/", "pages/"];
-    let subPath = sourcePath.replace(/\\/g, "/");
-    for (const prefix of srcPrefixes) {
-        if (subPath.startsWith(prefix)) {
-            subPath = subPath.slice(prefix.length);
-            break;
-        }
-    }
-    const dir = dirname(subPath);
-    const base = basename(subPath);
-    const ext = extname(base);
-    const nameWithoutExt = base.replace(/\.(ts|tsx|js|jsx)$/, "");
-    const testExt = ext === ".tsx" || ext === ".jsx" ? ext : ".ts";
-    const dirPart = dir === "." ? "" : `${dir}/`;
-    return `${testDir}/${dirPart}${nameWithoutExt}.test${testExt}`;
-}
-function buildUnitTestStubs(report, testDir, categoryFilter) {
-    const results = [];
-    const appFramework = report.framework.appFramework;
-    for (const category of report.categories) {
-        // If a category filter is provided, skip categories not in the list
-        if (categoryFilter && categoryFilter.length > 0) {
-            if (!categoryFilter.includes(category.name)) {
-                continue;
-            }
-        }
-        for (const untestedFile of category.untestedFiles) {
-            const testPath = deriveTestFilePath(untestedFile, testDir);
-            const content = generateTestTemplate(untestedFile, category.name, appFramework);
-            results.push({ path: testPath, content });
-        }
-    }
-    return results;
-}
-// ---------------------------------------------------------------------------
-// Main
-// ---------------------------------------------------------------------------
-export async function buildScaffoldPlan(report, options) {
-    const testDir = options.testDir ?? "tests";
-    const runner = options.runner ?? "vitest";
-    const structural = options.structural ?? true;
-    // Config file
-    let configFile = null;
-    if (runner === "vitest") {
-        configFile = {
-            path: "vitest.config.ts",
-            content: generateVitestConfig(report, testDir),
-        };
-    }
-    else {
-        configFile = {
-            path: "jest.config.ts",
-            content: generateJestConfig(report, testDir),
-        };
-    }
-    // Package.json updates
-    const packageJsonUpdates = buildPackageJsonUpdates(runner, report);
-    // Unit test stubs
-    const testFiles = buildUnitTestStubs(report, testDir, options.categories);
-    // Structural tests
-    let structuralTests = [];
-    if (structural) {
-        const sourceDir = report.categories.length > 0
-            ? guessSourceDir(report)
-            : "src";
-        structuralTests = generateStructuralTests({
-            sourceDir,
-            testDir,
-            entryPoints: options.entryPoints,
-        });
-    }
-    return {
-        configFile,
-        packageJsonUpdates,
-        testFiles,
-        structuralTests,
-    };
-}
-/** Infer the source directory from the report's source file paths. */
-function guessSourceDir(report) {
-    for (const cat of report.categories) {
-        for (const f of cat.sourceFiles) {
-            const normalized = f.replace(/\\/g, "/");
-            if (normalized.startsWith("src/"))
-                return "src";
-            if (normalized.startsWith("lib/"))
-                return "lib";
-            if (normalized.startsWith("app/"))
-                return "app";
-        }
-    }
-    return "src";
-}
-export async function executeScaffoldPlan(plan, projectDir) {
-    const filesWritten = [];
-    // Write config file
-    if (plan.configFile) {
-        const fullPath = `${projectDir}/${plan.configFile.path}`;
-        await mkdir(dirname(fullPath), { recursive: true });
-        await writeFile(fullPath, plan.configFile.content, "utf-8");
-        filesWritten.push(plan.configFile.path);
-    }
-    // Write unit test stubs
-    for (const file of plan.testFiles) {
-        const fullPath = `${projectDir}/${file.path}`;
-        await mkdir(dirname(fullPath), { recursive: true });
-        await writeFile(fullPath, file.content, "utf-8");
-        filesWritten.push(file.path);
-    }
-    // Write structural tests
-    for (const file of plan.structuralTests) {
-        const fullPath = `${projectDir}/${file.path}`;
-        await mkdir(dirname(fullPath), { recursive: true });
-        await writeFile(fullPath, file.content, "utf-8");
-        filesWritten.push(file.path);
-    }
-    return { filesWritten };
-}
-//# sourceMappingURL=test-scaffold.js.map

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

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

package/dist/setup/test-templates.d.ts

@@ -1,37 +0,0 @@
-/**
- * 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 declare function computeRelativeImport(testFilePath: string, sourceFilePath: string): string;
-/**
- * Test stub for Next.js App Router API route handlers.
- * Tests GET/POST/PUT/DELETE handler functions with mocked NextRequest/NextResponse.
- */
-export declare function nextjsApiRouteTemplate(sourcePath: string): string;
-/**
- * Test stub for React components using React Testing Library patterns.
- * Includes render test and basic interaction test.
- */
-export declare function reactComponentTemplate(sourcePath: string): string;
-/**
- * Test stub for pure utility/helper functions.
- * Input/output pattern with describe blocks.
- */
-export declare function utilityTemplate(sourcePath: string): string;
-/**
- * Test stub for Express routes using supertest patterns.
- * Tests GET and POST endpoints.
- */
-export declare function expressRouteTemplate(sourcePath: string): string;
-/**
- * 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 declare function generateTestTemplate(sourcePath: string, category: string, appFramework: string): string;