forge-cc 1.0.0 → 1.0.1

package/dist/gates/test-analysis.js

@@ -1,394 +0,0 @@
-import { readdir, readFile, stat } from "node:fs/promises";
-import { join, relative, basename, dirname, extname } from "node:path";
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-/** Recursively collect files under a directory. */
-async function collectFiles(dir) {
-    const results = [];
-    let entries;
-    try {
-        entries = await readdir(dir, { withFileTypes: true });
-    }
-    catch {
-        return results;
-    }
-    for (const entry of entries) {
-        const full = join(dir, entry.name);
-        if (entry.isDirectory()) {
-            // Skip common non-source directories
-            if (entry.name === "node_modules" ||
-                entry.name === "dist" ||
-                entry.name === ".git" ||
-                entry.name === ".next" ||
-                entry.name === "coverage") {
-                continue;
-            }
-            results.push(...(await collectFiles(full)));
-        }
-        else if (entry.isFile()) {
-            results.push(full);
-        }
-    }
-    return results;
-}
-/** Check whether a file path is a test file. */
-function isTestFile(filePath) {
-    const base = basename(filePath);
-    return (base.endsWith(".test.ts") ||
-        base.endsWith(".test.tsx") ||
-        base.endsWith(".spec.ts") ||
-        base.endsWith(".spec.tsx") ||
-        base.endsWith(".test.js") ||
-        base.endsWith(".test.jsx") ||
-        base.endsWith(".spec.js") ||
-        base.endsWith(".spec.jsx"));
-}
-/** Check whether a file is a TypeScript/JavaScript source file (not a test, not a declaration). */
-function isSourceFile(filePath) {
-    const base = basename(filePath);
-    const ext = extname(filePath);
-    if (![".ts", ".tsx", ".js", ".jsx"].includes(ext))
-        return false;
-    if (isTestFile(filePath))
-        return false;
-    if (base.endsWith(".d.ts"))
-        return false;
-    return true;
-}
-/** Check whether a directory exists. */
-async function dirExists(dirPath) {
-    try {
-        const s = await stat(dirPath);
-        return s.isDirectory();
-    }
-    catch {
-        return false;
-    }
-}
-/** Check whether a file exists. */
-async function fileExists(filePath) {
-    try {
-        const s = await stat(filePath);
-        return s.isFile();
-    }
-    catch {
-        return false;
-    }
-}
-/** Read and parse package.json, returning null on failure. */
-async function readPackageJson(projectDir) {
-    try {
-        const raw = await readFile(join(projectDir, "package.json"), "utf-8");
-        return JSON.parse(raw);
-    }
-    catch {
-        return null;
-    }
-}
-async function detectTestRunner(projectDir, pkg) {
-    const patterns = [];
-    const deps = (pkg?.devDependencies ?? {});
-    const allDeps = {
-        ...(pkg?.dependencies ?? {}),
-        ...deps,
-    };
-    // Check for vitest
-    if ("vitest" in allDeps) {
-        patterns.push("vitest in dependencies");
-    }
-    if (await fileExists(join(projectDir, "vitest.config.ts"))) {
-        patterns.push("vitest.config.ts found");
-    }
-    if (await fileExists(join(projectDir, "vitest.config.js"))) {
-        patterns.push("vitest.config.js found");
-    }
-    // Check for jest
-    if ("jest" in allDeps) {
-        patterns.push("jest in dependencies");
-    }
-    if ("ts-jest" in allDeps) {
-        patterns.push("ts-jest in dependencies");
-    }
-    if (await fileExists(join(projectDir, "jest.config.ts"))) {
-        patterns.push("jest.config.ts found");
-    }
-    if (await fileExists(join(projectDir, "jest.config.js"))) {
-        patterns.push("jest.config.js found");
-    }
-    // Check for testing-library
-    for (const dep of Object.keys(allDeps)) {
-        if (dep.startsWith("@testing-library/")) {
-            patterns.push(`${dep} in devDeps`);
-            break;
-        }
-    }
-    // Determine runner
-    const hasVitest = patterns.some((p) => p.includes("vitest"));
-    const hasJest = patterns.some((p) => p.includes("jest"));
-    let runner = "none";
-    if (hasVitest)
-        runner = "vitest";
-    else if (hasJest)
-        runner = "jest";
-    return { runner, patterns };
-}
-async function detectAppFramework(projectDir, pkg) {
-    const patterns = [];
-    const deps = {
-        ...(pkg?.dependencies ?? {}),
-        ...(pkg?.devDependencies ?? {}),
-    };
-    const hasNext = "next" in deps;
-    const hasReact = "react" in deps;
-    const hasExpress = "express" in deps;
-    const hasVite = "vite" in deps;
-    if (hasNext) {
-        patterns.push("next in dependencies");
-        // Detect App Router vs Pages Router
-        const hasAppDir = await dirExists(join(projectDir, "app")) ||
-            await dirExists(join(projectDir, "src", "app"));
-        const hasPagesDir = await dirExists(join(projectDir, "pages")) ||
-            await dirExists(join(projectDir, "src", "pages"));
-        if (hasAppDir) {
-            patterns.push("app/ directory found (App Router)");
-            return { framework: "nextjs-app", patterns };
-        }
-        if (hasPagesDir) {
-            patterns.push("pages/ directory found (Pages Router)");
-            return { framework: "nextjs-pages", patterns };
-        }
-        // Next.js detected but neither router pattern found — default to app
-        return { framework: "nextjs-app", patterns };
-    }
-    if (hasReact && hasVite) {
-        patterns.push("react + vite in dependencies");
-        return { framework: "react-vite", patterns };
-    }
-    if (hasExpress) {
-        patterns.push("express in dependencies");
-        return { framework: "express", patterns };
-    }
-    // Check for TypeScript project
-    if (await fileExists(join(projectDir, "tsconfig.json"))) {
-        patterns.push("tsconfig.json found");
-        return { framework: "plain-ts", patterns };
-    }
-    return { framework: "unknown", patterns };
-}
-// ---------------------------------------------------------------------------
-// File Discovery
-// ---------------------------------------------------------------------------
-/** Locate test directories and co-located test files. */
-async function discoverTestFiles(projectDir) {
-    const testFiles = [];
-    const allFiles = await collectFiles(projectDir);
-    for (const f of allFiles) {
-        if (isTestFile(f)) {
-            testFiles.push(relative(projectDir, f));
-        }
-    }
-    return testFiles;
-}
-/** Locate source files, using sourceDir as the primary search root. */
-async function discoverSourceFiles(projectDir, sourceDir) {
-    const sourceFiles = [];
-    // Scan the source directory
-    const srcPath = join(projectDir, sourceDir);
-    if (await dirExists(srcPath)) {
-        const allFiles = await collectFiles(srcPath);
-        for (const f of allFiles) {
-            if (isSourceFile(f)) {
-                sourceFiles.push(relative(projectDir, f));
-            }
-        }
-    }
-    // Also scan app/ and pages/ for Next.js projects
-    for (const extra of ["app", "pages"]) {
-        const extraPath = join(projectDir, extra);
-        if (await dirExists(extraPath)) {
-            const allFiles = await collectFiles(extraPath);
-            for (const f of allFiles) {
-                if (isSourceFile(f)) {
-                    const rel = relative(projectDir, f);
-                    if (!sourceFiles.includes(rel)) {
-                        sourceFiles.push(rel);
-                    }
-                }
-            }
-        }
-    }
-    return sourceFiles;
-}
-// ---------------------------------------------------------------------------
-// Source-to-Test Mapping
-// ---------------------------------------------------------------------------
-/**
- * Build a mapping from source file to its corresponding test file (if any).
- * Tries several naming conventions:
- *   - Co-located: src/foo/bar.ts -> src/foo/bar.test.ts
- *   - Mirrored:   src/foo/bar.ts -> tests/foo/bar.test.ts
- *   - __tests__:  src/foo/bar.ts -> src/foo/__tests__/bar.test.ts
- */
-function mapSourceToTests(sourceFiles, testFiles) {
-    const testSet = new Set(testFiles.map((t) => t.replace(/\\/g, "/")));
-    const mapping = new Map();
-    for (const src of sourceFiles) {
-        const normalized = src.replace(/\\/g, "/");
-        const dir = dirname(normalized);
-        const base = basename(normalized);
-        const nameWithoutExt = base.replace(/\.(ts|tsx|js|jsx)$/, "");
-        const ext = extname(base);
-        const testExt = ext === ".tsx" || ext === ".jsx" ? ext : ".ts";
-        // Candidate patterns
-        const candidates = [
-            // Co-located: same directory
-            `${dir}/${nameWithoutExt}.test${testExt}`,
-            `${dir}/${nameWithoutExt}.spec${testExt}`,
-            // __tests__ subdirectory
-            `${dir}/__tests__/${nameWithoutExt}.test${testExt}`,
-            `${dir}/__tests__/${nameWithoutExt}.spec${testExt}`,
-        ];
-        // Mirrored directory: replace leading source dir with common test dirs
-        const srcPrefixes = ["src/", "lib/", "app/", "pages/"];
-        const testPrefixes = ["tests/", "test/", "__tests__/"];
-        for (const sp of srcPrefixes) {
-            if (normalized.startsWith(sp)) {
-                const rest = normalized.slice(sp.length);
-                const restDir = dirname(rest);
-                const restBase = basename(rest).replace(/\.(ts|tsx|js|jsx)$/, "");
-                for (const tp of testPrefixes) {
-                    candidates.push(`${tp}${restDir}/${restBase}.test${testExt}`, `${tp}${restDir}/${restBase}.spec${testExt}`, `${tp}${restBase}.test${testExt}`, `${tp}${restBase}.spec${testExt}`);
-                }
-            }
-        }
-        let matched = null;
-        for (const c of candidates) {
-            // Normalize candidate (handle ./ prefix from dirname of top-level files)
-            const clean = c.replace(/^\.\//, "");
-            if (testSet.has(clean)) {
-                matched = clean;
-                break;
-            }
-        }
-        mapping.set(normalized, matched);
-    }
-    return mapping;
-}
-function categorizeFile(filePath) {
-    const normalized = filePath.replace(/\\/g, "/");
-    const parts = normalized.split("/");
-    const base = basename(normalized);
-    const ext = extname(normalized);
-    // API routes
-    if (parts.includes("api") ||
-        parts.includes("routes") ||
-        normalized.includes("app/api/") ||
-        normalized.includes("pages/api/")) {
-        return "api-routes";
-    }
-    // Middleware
-    if (base.startsWith("middleware") ||
-        parts.includes("middleware")) {
-        return "middleware";
-    }
-    // Models / schemas / entities
-    if (parts.includes("models") ||
-        parts.includes("schemas") ||
-        parts.includes("entities")) {
-        return "models";
-    }
-    // Components: .tsx files or in components/ directory
-    if (parts.includes("components") || ext === ".tsx") {
-        return "components";
-    }
-    // Utils / lib / helpers
-    if (parts.includes("utils") ||
-        parts.includes("lib") ||
-        parts.includes("helpers")) {
-        return "utils";
-    }
-    return "other";
-}
-function buildCategories(sourceFiles, mapping) {
-    const buckets = new Map();
-    for (const src of sourceFiles) {
-        const normalized = src.replace(/\\/g, "/");
-        const cat = categorizeFile(normalized);
-        if (!buckets.has(cat)) {
-            buckets.set(cat, { sources: [], tests: [], untested: [] });
-        }
-        const bucket = buckets.get(cat);
-        bucket.sources.push(normalized);
-        const testFile = mapping.get(normalized);
-        if (testFile) {
-            bucket.tests.push(testFile);
-        }
-        else {
-            bucket.untested.push(normalized);
-        }
-    }
-    // Sort categories in a stable order
-    const order = [
-        "api-routes",
-        "components",
-        "utils",
-        "middleware",
-        "models",
-        "other",
-    ];
-    const categories = [];
-    for (const name of order) {
-        const bucket = buckets.get(name);
-        if (bucket && bucket.sources.length > 0) {
-            categories.push({
-                name,
-                sourceFiles: bucket.sources.sort(),
-                testFiles: bucket.tests.sort(),
-                untestedFiles: bucket.untested.sort(),
-            });
-        }
-    }
-    return categories;
-}
-// ---------------------------------------------------------------------------
-// Main
-// ---------------------------------------------------------------------------
-export async function analyzeTestCoverage(projectDir) {
-    const pkg = await readPackageJson(projectDir);
-    // Detect frameworks
-    const { runner, patterns: runnerPatterns } = await detectTestRunner(projectDir, pkg);
-    const { framework, patterns: frameworkPatterns } = await detectAppFramework(projectDir, pkg);
-    const detectedPatterns = [...runnerPatterns, ...frameworkPatterns];
-    // Discover files
-    const sourceDir = "src";
-    const sourceFiles = await discoverSourceFiles(projectDir, sourceDir);
-    const testFiles = await discoverTestFiles(projectDir);
-    // Build mapping
-    const mapping = mapSourceToTests(sourceFiles, testFiles);
-    // Compute coverage
-    const untestedFiles = [];
-    for (const [src, test] of mapping) {
-        if (!test) {
-            untestedFiles.push(src);
-        }
-    }
-    const ratio = sourceFiles.length > 0 ? testFiles.length / sourceFiles.length : 0;
-    // Build categories
-    const categories = buildCategories(sourceFiles, mapping);
-    return {
-        framework: {
-            testRunner: runner,
-            appFramework: framework,
-            detectedPatterns,
-        },
-        coverage: {
-            sourceFiles: sourceFiles.length,
-            testFiles: testFiles.length,
-            ratio: Math.round(ratio * 100) / 100,
-            untestedFiles: untestedFiles.sort(),
-        },
-        categories,
-    };
-}
-//# sourceMappingURL=test-analysis.js.map

package/dist/gates/test-analysis.js.map

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

package/dist/gates/visual-capture.d.ts

@@ -1,24 +0,0 @@
-import type { Page } from "playwright";
-import type { ViewportConfig, VisualCaptureResult } from "../types.js";
-/** Default viewports for multi-viewport capture: desktop, tablet, mobile */
-export declare const DEFAULT_VIEWPORTS: ViewportConfig[];
-/** Options for the visual capture function */
-export interface CaptureOptions {
-    pagePath: string;
-    screenshotDir: string;
-    viewports?: ViewportConfig[];
-}
-/**
- * Capture multi-viewport screenshots and extract DOM structure from a Playwright page.
- *
- * For each viewport in the configuration:
- * 1. Resizes the viewport via page.setViewportSize()
- * 2. Waits for layout to settle (500ms)
- * 3. Takes a full-page screenshot saved as {safeName}_{viewportName}.png
- * 4. Extracts the serialized DOM tree via page.evaluate()
- *
- * @param page - Playwright Page instance (already navigated to the target URL)
- * @param options - Capture configuration including page path, screenshot dir, and optional viewports
- * @returns VisualCaptureResult with screenshots array, DOM snapshots per viewport, and metadata
- */
-export declare function captureVisual(page: Page, options: CaptureOptions): Promise<VisualCaptureResult>;

package/dist/gates/visual-capture.js

@@ -1,144 +0,0 @@
-import { mkdirSync } from "node:fs";
-import { join } from "node:path";
-/** Default viewports for multi-viewport capture: desktop, tablet, mobile */
-export const DEFAULT_VIEWPORTS = [
-    { name: "desktop", width: 1280, height: 800 },
-    { name: "tablet", width: 768, height: 1024 },
-    { name: "mobile", width: 390, height: 844 },
-];
-/**
- * Sanitize a page path into a safe filename component.
- * Replaces slashes with underscores and strips leading underscores.
- * Falls back to "index" for root path.
- */
-function sanitizePageName(pagePath) {
-    const sanitized = pagePath.replace(/\//g, "_").replace(/^_/, "");
-    return sanitized || "index";
-}
-/**
- * Extract DOM snapshot from the page via page.evaluate().
- * The entire extraction logic runs inside the browser context so it must be
- * self-contained -- no references to Node.js modules or TypeScript types.
- */
-async function extractDOM(page) {
-    return await page.evaluate(() => {
-        function walkElement(el, isTopLevel) {
-            const style = window.getComputedStyle(el);
-            const visible = style.display !== "none" &&
-                style.visibility !== "hidden" &&
-                style.opacity !== "0";
-            const node = {
-                tag: el.tagName.toLowerCase(),
-                visible,
-                children: [],
-            };
-            if (el.id) {
-                node.id = el.id;
-            }
-            if (el.className &&
-                typeof el.className === "string" &&
-                el.className.trim()) {
-                node.className = el.className.trim();
-            }
-            // Only capture bounding rect for top-level elements to limit payload size
-            if (isTopLevel) {
-                const rect = el.getBoundingClientRect();
-                node.rect = {
-                    x: Math.round(rect.x),
-                    y: Math.round(rect.y),
-                    width: Math.round(rect.width),
-                    height: Math.round(rect.height),
-                };
-            }
-            const childElements = el.children;
-            for (let i = 0; i < childElements.length; i++) {
-                node.children.push(walkElement(childElements[i], false));
-            }
-            return node;
-        }
-        const body = document.body;
-        if (!body) {
-            return { tag: "body", visible: true, children: [] };
-        }
-        const snapshot = {
-            tag: "body",
-            visible: true,
-            children: [],
-        };
-        if (body.id) {
-            snapshot.id = body.id;
-        }
-        if (body.className &&
-            typeof body.className === "string" &&
-            body.className.trim()) {
-            snapshot.className = body.className.trim();
-        }
-        const childElements = body.children;
-        for (let i = 0; i < childElements.length; i++) {
-            snapshot.children.push(walkElement(childElements[i], true));
-        }
-        return snapshot;
-    });
-}
-/**
- * Capture multi-viewport screenshots and extract DOM structure from a Playwright page.
- *
- * For each viewport in the configuration:
- * 1. Resizes the viewport via page.setViewportSize()
- * 2. Waits for layout to settle (500ms)
- * 3. Takes a full-page screenshot saved as {safeName}_{viewportName}.png
- * 4. Extracts the serialized DOM tree via page.evaluate()
- *
- * @param page - Playwright Page instance (already navigated to the target URL)
- * @param options - Capture configuration including page path, screenshot dir, and optional viewports
- * @returns VisualCaptureResult with screenshots array, DOM snapshots per viewport, and metadata
- */
-export async function captureVisual(page, options) {
-    const start = Date.now();
-    const viewports = options.viewports ?? DEFAULT_VIEWPORTS;
-    const safeName = sanitizePageName(options.pagePath);
-    mkdirSync(options.screenshotDir, { recursive: true });
-    const screenshots = [];
-    const domSnapshots = {};
-    for (const viewport of viewports) {
-        try {
-            // Resize viewport
-            await page.setViewportSize({
-                width: viewport.width,
-                height: viewport.height,
-            });
-            // Wait for layout to settle after resize
-            await page.waitForTimeout(500);
-            // Take full-page screenshot
-            const screenshotPath = join(options.screenshotDir, `${safeName}_${viewport.name}.png`);
-            try {
-                await page.screenshot({ path: screenshotPath, fullPage: true });
-                screenshots.push({
-                    page: options.pagePath,
-                    viewport: viewport.name,
-                    path: screenshotPath,
-                });
-            }
-            catch {
-                // Screenshot failed for this viewport — skip it but continue
-            }
-            // Extract DOM snapshot
-            const domSnapshot = await extractDOM(page);
-            domSnapshots[viewport.name] = domSnapshot;
-        }
-        catch {
-            // Viewport resize or other operation failed — skip this viewport entirely
-        }
-    }
-    return {
-        screenshots,
-        domSnapshots,
-        metadata: {
-            viewports,
-            pagePath: options.pagePath,
-            capturedAt: new Date().toISOString(),
-            durationMs: Date.now() - start,
-        },
-    };
-}
-//# sourceMappingURL=visual-capture.js.map

package/dist/gates/visual-capture.js.map

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

package/dist/gates/visual-gate.d.ts

@@ -1,18 +0,0 @@
-import type { VisualResult } from "../types.js";
-/**
- * Capture and store "before" snapshots for the given pages.
- * Snapshots are persisted to disk (.forge/screenshots/before/*.snapshot.json)
- * so they survive across separate CLI invocations.
- */
-export declare function captureBeforeSnapshots(projectDir: string, pages: string[], options?: {
-    devServerCommand?: string;
-    devServerPort?: number;
-    screenshotDir?: string;
-}): Promise<void>;
-/** Clear all stored "before" snapshots from disk (e.g. between milestones). */
-export declare function clearBeforeSnapshots(projectDir: string): void;
-export declare function verifyVisual(projectDir: string, pages: string[], options?: {
-    devServerCommand?: string;
-    devServerPort?: number;
-    screenshotDir?: string;
-}): Promise<VisualResult>;