api-tests-coverage 1.0.17 → 1.0.19

package/dist/src/generation/ai-flow-exporter.js

@@ -0,0 +1,260 @@
+"use strict";
+/**
+ * Feature 28 — AiFlowExporter
+ * Produces ai-ready-flows.md and ai-ready-flows.json for AI coding assistants.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.exportAiFlows = exportAiFlows;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const gap_extractor_1 = require("./gap-extractor");
+const context_builder_1 = require("./context-builder");
+const template_renderer_1 = require("./template-renderer");
+const file_router_1 = require("./file-router");
+// ─── Priority filter ──────────────────────────────────────────────────────────
+const PRIORITY_VALUES = {
+    P0: 0, P1: 1, P2: 2, P3: 3, P4: 4, P5: 5,
+};
+function priorityGte(a, b) {
+    return PRIORITY_VALUES[a] <= PRIORITY_VALUES[b];
+}
+// ─── Copilot prompt builder ───────────────────────────────────────────────────
+function buildCopilotPrompt(gap, projectName, testFramework, appImportPath) {
+    var _a;
+    const lines = [
+        `Generate a ${testFramework} test file at \`${gap.suggestedOutputPath}\` for ${gap.endpoint.method} ${gap.endpoint.path}.`,
+        `Import the app: \`import { app } from '${appImportPath}'\`.`,
+        `Test cases to cover:`,
+    ];
+    for (const tc of gap.missingTestCases) {
+        lines.push(`- ${tc.description} (expect HTTP ${tc.expectedStatus})`);
+    }
+    if (gap.endpoint.auth.required) {
+        lines.push(`Auth: Required (${(_a = gap.endpoint.auth.scheme) !== null && _a !== void 0 ? _a : 'Bearer'} token). Use POST /api/users/login to get a token.`);
+    }
+    if (gap.existingSimilarTests.length > 0) {
+        lines.push(`Follow the pattern in \`${gap.existingSimilarTests[0]}\` for style guidance.`);
+    }
+    lines.push(`Rules: assert status code BEFORE body; no toBeTruthy(); use specific matchers.`);
+    const prompt = lines.join(' ');
+    // Truncate to ~800 tokens (~3200 chars as rough estimate)
+    return prompt.length > 3200 ? prompt.slice(0, 3197) + '...' : prompt;
+}
+// ─── Missing test case builder ────────────────────────────────────────────────
+function buildMissingTestCases(gap) {
+    var _a, _b, _c, _d, _e, _f;
+    const cases = [];
+    const successStatus = (_c = (_b = (_a = gap.responses) === null || _a === void 0 ? void 0 : _a.find(r => r.statusCode >= 200 && r.statusCode < 300)) === null || _b === void 0 ? void 0 : _b.statusCode) !== null && _c !== void 0 ? _c : 200;
+    cases.push({ id: 'happy-path', description: 'valid request succeeds', expectedStatus: successStatus });
+    if (gap.endpoint.auth.required) {
+        cases.push({ id: 'no-auth', description: 'missing auth token', expectedStatus: 401 });
+        cases.push({ id: 'invalid-auth', description: 'invalid token', expectedStatus: 401 });
+    }
+    if (gap.endpoint.auth.optional) {
+        cases.push({ id: 'no-auth-optional', description: 'request without auth (optional)', expectedStatus: successStatus });
+    }
+    const errorResponses = (_e = (_d = gap.responses) === null || _d === void 0 ? void 0 : _d.filter(r => r.statusCode >= 400)) !== null && _e !== void 0 ? _e : [];
+    for (const resp of errorResponses.slice(0, 3)) {
+        cases.push({
+            id: `error-${resp.statusCode}`,
+            description: (_f = resp.description) !== null && _f !== void 0 ? _f : `error ${resp.statusCode}`,
+            expectedStatus: resp.statusCode,
+        });
+    }
+    return cases;
+}
+// ─── Markdown generator ───────────────────────────────────────────────────────
+function buildMarkdown(flows) {
+    var _a, _b;
+    const lines = [
+        `# AI-Ready Test Generation Context`,
+        `> Generated by api-test-coverage-analyzer | Project: ${flows.project.name} | Analyzed: ${flows.generatedAt.split('T')[0]}`,
+        ``,
+        `## How to Use This Document`,
+        `This document contains structured context for an AI assistant to generate missing tests.`,
+        `For each gap section below, instruct your AI: "Generate tests for this gap using the context provided."`,
+        ``,
+        `---`,
+        ``,
+    ];
+    for (let i = 0; i < flows.gaps.length; i++) {
+        const gap = flows.gaps[i];
+        lines.push(`## Gap ${i + 1}: ${gap.endpoint.method} ${gap.endpoint.path} — [PRIORITY: ${gap.priority} | RISK: ${gap.riskScore}]`);
+        lines.push(``);
+        lines.push(`### What Needs Testing`);
+        lines.push(`Endpoint \`${gap.endpoint.method} ${gap.endpoint.path}\` is missing test coverage. Tests needed for:`);
+        for (const tc of gap.missingTestCases) {
+            lines.push(`- ${tc.description} (expect ${tc.expectedStatus})`);
+        }
+        lines.push(``);
+        lines.push(`### Endpoint Contract`);
+        lines.push(`- **Method:** ${gap.endpoint.method}`);
+        lines.push(`- **Path:** \`${gap.endpoint.path}\``);
+        if (gap.endpoint.auth.required) {
+            lines.push(`- **Auth:** Required (${(_a = gap.endpoint.auth.type) !== null && _a !== void 0 ? _a : 'JWT'} ${(_b = gap.endpoint.auth.scheme) !== null && _b !== void 0 ? _b : 'Bearer'} token)`);
+        }
+        else {
+            lines.push(`- **Auth:** Not required`);
+        }
+        lines.push(``);
+        lines.push(`### Project Context`);
+        lines.push(`- **Language:** ${flows.project.language}`);
+        lines.push(`- **Test Framework:** ${flows.project.testFramework}`);
+        lines.push(`- **App Import:** \`import { app } from '${flows.project.appImportPath}'\``);
+        if (gap.existingSimilarTests.length > 0) {
+            lines.push(`- **Existing Similar Tests:** See \`${gap.existingSimilarTests[0]}\` for patterns`);
+        }
+        lines.push(``);
+        lines.push(`### Copilot Instructions`);
+        lines.push(gap.copilotPrompt);
+        if (gap.generatedCode) {
+            lines.push(``);
+            lines.push(`### Generated Scaffold`);
+            lines.push(`\`\`\`typescript`);
+            lines.push(gap.generatedCode);
+            lines.push(`\`\`\``);
+        }
+        lines.push(``);
+        lines.push(`---`);
+        lines.push(``);
+    }
+    return lines.join('\n');
+}
+// ─── Similar test finder ──────────────────────────────────────────────────────
+function findSimilarTests(apiPath) {
+    const testsDir = path.join(process.cwd(), 'tests');
+    if (!fs.existsSync(testsDir))
+        return [];
+    try {
+        const files = fs.readdirSync(testsDir).filter(f => f.endsWith('.test.ts') || f.endsWith('.test.js'));
+        // Return up to 2 similar test files
+        return files.slice(0, 2).map(f => `tests/${f}`);
+    }
+    catch {
+        return [];
+    }
+}
+// ─── Public API ───────────────────────────────────────────────────────────────
+async function exportAiFlows(opts) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
+    const format = (_a = opts.format) !== null && _a !== void 0 ? _a : 'both';
+    const maxGaps = (_b = opts.maxGaps) !== null && _b !== void 0 ? _b : 50;
+    const minPriority = (_c = opts.priority) !== null && _c !== void 0 ? _c : 'P3';
+    // Load discovery info
+    const summaryPath = path.join(opts.reportsDir, 'coverage-summary.json');
+    let projectName = 'my-api';
+    let language = 'typescript';
+    let testFramework = 'jest';
+    let appImportPath = '../../src/app';
+    if (fs.existsSync(summaryPath)) {
+        try {
+            const summary = JSON.parse(fs.readFileSync(summaryPath, 'utf8'));
+            projectName = (_e = (_d = summary.project) === null || _d === void 0 ? void 0 : _d.name) !== null && _e !== void 0 ? _e : projectName;
+            language = (_g = (_f = summary.discoveryInfo) === null || _f === void 0 ? void 0 : _f.language) !== null && _g !== void 0 ? _g : language;
+            testFramework = (_j = (_h = summary.discoveryInfo) === null || _h === void 0 ? void 0 : _h.testFramework) !== null && _j !== void 0 ? _j : testFramework;
+            appImportPath = (_l = (_k = summary.discoveryInfo) === null || _k === void 0 ? void 0 : _k.appImportPath) !== null && _l !== void 0 ? _l : appImportPath;
+        }
+        catch {
+            // Use defaults
+        }
+    }
+    // Extract and filter gaps
+    let gaps = (0, gap_extractor_1.extractGapsFromReports)(opts.reportsDir);
+    gaps = (0, file_router_1.sortGapsByPriority)(gaps.filter(g => priorityGte(g.priority, minPriority)));
+    gaps = gaps.slice(0, maxGaps);
+    const aiGaps = [];
+    for (const gap of gaps) {
+        const suggestedOutputPath = (0, file_router_1.routeOutputFile)(gap, 'unit', 'tests', language);
+        const discoveryInfo = {
+            name: projectName,
+            language,
+            framework: 'express',
+            testFramework,
+            baseUrl: 'http://localhost:3000',
+            projectRoot: process.cwd(),
+            appImportPath,
+        };
+        const ctx = (0, context_builder_1.buildContext)(gap, suggestedOutputPath, discoveryInfo);
+        const generatedCode = (0, template_renderer_1.renderTemplate)(ctx, { language, testType: 'unit' });
+        const missingTestCases = buildMissingTestCases(gap);
+        const existingSimilarTests = findSimilarTests(gap.endpoint.path);
+        const aiGap = {
+            gapId: gap.id,
+            priority: gap.priority,
+            riskScore: gap.riskScore,
+            type: gap.type,
+            endpoint: {
+                method: gap.endpoint.method,
+                path: gap.endpoint.path,
+                auth: {
+                    required: gap.endpoint.auth.required,
+                    type: gap.endpoint.auth.type,
+                    scheme: gap.endpoint.auth.scheme,
+                },
+            },
+            missingTestCases,
+            copilotPrompt: '',
+            suggestedOutputPath,
+            existingSimilarTests,
+            generatedCode,
+        };
+        aiGap.copilotPrompt = buildCopilotPrompt(aiGap, projectName, testFramework, appImportPath);
+        aiGaps.push(aiGap);
+    }
+    const result = {
+        generatedAt: new Date().toISOString(),
+        project: {
+            name: projectName,
+            language,
+            testFramework,
+            appImportPath,
+        },
+        gaps: aiGaps,
+    };
+    // Write outputs
+    fs.mkdirSync(opts.outDir, { recursive: true });
+    if (format === 'json' || format === 'both') {
+        const jsonPath = path.join(opts.outDir, 'ai-ready-flows.json');
+        fs.writeFileSync(jsonPath, JSON.stringify(result, null, 2), 'utf8');
+        console.log(`AI flows JSON written to: ${jsonPath}`);
+    }
+    if (format === 'markdown' || format === 'both') {
+        const mdPath = path.join(opts.outDir, 'ai-ready-flows.md');
+        fs.writeFileSync(mdPath, buildMarkdown(result), 'utf8');
+        console.log(`AI flows Markdown written to: ${mdPath}`);
+    }
+    return result;
+}

package/dist/src/generation/context-builder.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Feature 28 — ContextBuilder
+ * Assembles a GenerationContext from a DetectedGap and project discovery info.
+ */
+import type { DetectedGap, GenerationContext } from './types';
+export interface ProjectDiscoveryInfo {
+    name: string;
+    language: string;
+    framework: string;
+    testFramework: string;
+    baseUrl: string;
+    projectRoot: string;
+    appImportPath?: string;
+}
+export declare function buildContext(gap: DetectedGap, outputFilePath: string, discovery: ProjectDiscoveryInfo): GenerationContext;
+//# sourceMappingURL=context-builder.d.ts.map

package/dist/src/generation/context-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-builder.d.ts","sourceRoot":"","sources":["../../../src/generation/context-builder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EAGlB,MAAM,SAAS,CAAC;AAoFjB,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,YAAY,CAC1B,GAAG,EAAE,WAAW,EAChB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,oBAAoB,GAC9B,iBAAiB,CA8CnB"}

package/dist/src/generation/context-builder.js

@@ -0,0 +1,170 @@
+"use strict";
+/**
+ * Feature 28 — ContextBuilder
+ * Assembles a GenerationContext from a DetectedGap and project discovery info.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildContext = buildContext;
+const path = __importStar(require("path"));
+// ─── Path normalisation ───────────────────────────────────────────────────────
+/**
+ * Convert an OpenAPI-style path (/api/articles/{slug}) to framework-native
+ * Express/supertest style (/api/articles/:slug).
+ */
+function normalizePathParam(p) {
+    return p.replace(/\{([^}]+)\}/g, ':$1');
+}
+// ─── Fixture generation ───────────────────────────────────────────────────────
+function buildValidPayload(params) {
+    const payload = {};
+    for (const p of params) {
+        if (p.in !== 'body')
+            continue;
+        const { name, schema } = p;
+        payload[name] = generateExampleValue(schema);
+    }
+    return payload;
+}
+function buildInvalidPayload(params) {
+    const payload = {};
+    for (const p of params) {
+        if (p.in !== 'body' || !p.required)
+            continue;
+        // Omit required fields to create invalid payload
+    }
+    return payload;
+}
+function buildPathParams(pathTemplate) {
+    var _a;
+    const params = {};
+    const matches = (_a = pathTemplate.match(/\{([^}]+)\}/g)) !== null && _a !== void 0 ? _a : [];
+    for (const m of matches) {
+        const name = m.slice(1, -1);
+        if (name.toLowerCase().includes('id')) {
+            params[name] = '1';
+        }
+        else if (name.toLowerCase().includes('slug')) {
+            params[name] = 'test-slug';
+        }
+        else {
+            params[name] = 'test-value';
+        }
+    }
+    return params;
+}
+function generateExampleValue(schema) {
+    if (schema.enum && schema.enum.length > 0)
+        return schema.enum[0];
+    switch (schema.type) {
+        case 'string':
+            if (schema.format === 'email')
+                return 'test@example.com';
+            if (schema.format === 'date')
+                return '2026-01-01';
+            if (schema.format === 'date-time')
+                return '2026-01-01T00:00:00Z';
+            if (schema.format === 'uri')
+                return 'https://example.com';
+            if (schema.minLength && schema.minLength > 0)
+                return 'a'.repeat(schema.minLength);
+            return 'test-value';
+        case 'number':
+        case 'integer':
+            if (schema.minimum !== undefined)
+                return schema.minimum;
+            return 1;
+        case 'boolean':
+            return true;
+        case 'array':
+            return [];
+        case 'object':
+            return {};
+        default:
+            return 'test-value';
+    }
+}
+// ─── Import prefix computation ────────────────────────────────────────────────
+function computeImportPrefix(outputFilePath, projectRoot) {
+    const outDir = path.dirname(outputFilePath);
+    const rel = path.relative(outDir, path.join(projectRoot, 'src'));
+    return rel.startsWith('.') ? rel : `./${rel}`;
+}
+function buildContext(gap, outputFilePath, discovery) {
+    var _a, _b;
+    const importPrefix = computeImportPrefix(outputFilePath, discovery.projectRoot);
+    const params = (_a = gap.parameters) !== null && _a !== void 0 ? _a : [];
+    const responses = (_b = gap.responses) !== null && _b !== void 0 ? _b : [
+        { statusCode: 200, description: 'Success' },
+        { statusCode: 401, description: 'Unauthorized' },
+        { statusCode: 422, description: 'Unprocessable Entity' },
+    ];
+    return {
+        gap: {
+            id: gap.id,
+            type: gap.type,
+            priority: gap.priority,
+            riskScore: gap.riskScore,
+        },
+        endpoint: {
+            method: gap.endpoint.method,
+            path: gap.endpoint.path,
+            pathNormalized: normalizePathParam(gap.endpoint.path),
+            operationId: gap.endpoint.operationId,
+            summary: gap.endpoint.summary,
+            tags: gap.endpoint.tags,
+            auth: gap.endpoint.auth,
+        },
+        parameters: params,
+        responses,
+        fixtures: {
+            validPayload: buildValidPayload(params),
+            invalidPayload: buildInvalidPayload(params),
+            authToken: 'Bearer <your-test-token>',
+            pathParams: buildPathParams(gap.endpoint.path),
+        },
+        project: {
+            name: discovery.name,
+            language: discovery.language,
+            framework: discovery.framework,
+            testFramework: discovery.testFramework,
+            baseUrl: discovery.baseUrl,
+            importPrefix,
+        },
+        businessRule: gap.businessRule,
+        securityControl: gap.securityControl,
+        flow: gap.flow,
+    };
+}

package/dist/src/generation/engine.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Feature 28 — TestGenerationEngine
+ * Main orchestrator for the test generation pipeline.
+ *
+ * Pipeline:
+ *   GapList → GapClassifier → ContextBuilder → TemplateRenderer → FileRouter → FileWriter
+ */
+import type { GenerationOptions, GenerationResult } from './types';
+export declare class TestGenerationEngine {
+    private opts;
+    private discovery;
+    constructor(opts: GenerationOptions);
+    run(): Promise<GenerationResult>;
+    private generateForGap;
+    private getTestTypes;
+    private writeFile;
+}
+export declare function generateTests(opts: GenerationOptions): Promise<GenerationResult>;
+//# sourceMappingURL=engine.d.ts.map

package/dist/src/generation/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/generation/engine.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,KAAK,EAGV,iBAAiB,EACjB,gBAAgB,EAKjB,MAAM,SAAS,CAAC;AA6DjB,qBAAa,oBAAoB;IAGnB,OAAO,CAAC,IAAI;IAFxB,OAAO,CAAC,SAAS,CAAuB;gBAEpB,IAAI,EAAE,iBAAiB;IAQrC,GAAG,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAsDtC,OAAO,CAAC,cAAc;IAyBtB,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,SAAS;CAUlB;AAID,wBAAsB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAGtF"}

package/dist/src/generation/engine.js

@@ -0,0 +1,204 @@
+"use strict";
+/**
+ * Feature 28 — TestGenerationEngine
+ * Main orchestrator for the test generation pipeline.
+ *
+ * Pipeline:
+ *   GapList → GapClassifier → ContextBuilder → TemplateRenderer → FileRouter → FileWriter
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TestGenerationEngine = void 0;
+exports.generateTests = generateTests;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const gap_extractor_1 = require("./gap-extractor");
+const context_builder_1 = require("./context-builder");
+const template_renderer_1 = require("./template-renderer");
+const file_router_1 = require("./file-router");
+// ─── Priority ordering ────────────────────────────────────────────────────────
+const PRIORITY_VALUES = {
+    P0: 0, P1: 1, P2: 2, P3: 3, P4: 4, P5: 5,
+};
+function priorityGte(a, b) {
+    return PRIORITY_VALUES[a] <= PRIORITY_VALUES[b];
+}
+// ─── Gap → test type mapping (Section 1.1 of spec) ───────────────────────────
+const GAP_GENERATOR_MAP = {
+    endpoint: ['unit', 'integration', 'cypress'],
+    parameter: ['unit', 'integration'],
+    error: ['unit', 'integration'],
+    business: ['unit', 'integration'],
+    integration: ['integration', 'cypress'],
+    security: ['security', 'unit'],
+    auth: ['unit', 'integration', 'security'],
+};
+// ─── Discovery info loader ────────────────────────────────────────────────────
+function loadDiscoveryInfo(reportsDir) {
+    var _a, _b, _c, _d, _e, _f, _g;
+    const summaryPath = path.join(reportsDir, 'coverage-summary.json');
+    if (fs.existsSync(summaryPath)) {
+        try {
+            const summary = JSON.parse(fs.readFileSync(summaryPath, 'utf8'));
+            const di = (_a = summary.discoveryInfo) !== null && _a !== void 0 ? _a : {};
+            return {
+                name: (_d = (_b = di.name) !== null && _b !== void 0 ? _b : (_c = summary.project) === null || _c === void 0 ? void 0 : _c.name) !== null && _d !== void 0 ? _d : 'my-api',
+                language: (_e = di.language) !== null && _e !== void 0 ? _e : 'typescript',
+                framework: (_f = di.framework) !== null && _f !== void 0 ? _f : 'express',
+                testFramework: (_g = di.testFramework) !== null && _g !== void 0 ? _g : 'jest',
+                baseUrl: 'http://localhost:3000',
+                projectRoot: process.cwd(),
+                appImportPath: di.appImportPath,
+            };
+        }
+        catch {
+            // Fall through to defaults
+        }
+    }
+    return {
+        name: 'my-api',
+        language: 'typescript',
+        framework: 'express',
+        testFramework: 'jest',
+        baseUrl: 'http://localhost:3000',
+        projectRoot: process.cwd(),
+    };
+}
+// ─── Engine ───────────────────────────────────────────────────────────────────
+class TestGenerationEngine {
+    constructor(opts) {
+        this.opts = opts;
+        this.discovery = loadDiscoveryInfo(opts.reportsDir);
+        // Override detection with CLI options
+        if (opts.language)
+            this.discovery.language = opts.language;
+        if (opts.framework)
+            this.discovery.framework = opts.framework;
+    }
+    async run() {
+        var _a, _b;
+        const result = {
+            files: [],
+            dryRun: (_a = this.opts.dryRun) !== null && _a !== void 0 ? _a : false,
+            totalGaps: 0,
+            generatedCount: 0,
+            skippedCount: 0,
+            errors: [],
+        };
+        // 1. Extract gaps from reports
+        let gaps = (0, gap_extractor_1.extractGapsFromReports)(this.opts.reportsDir);
+        // 2. Filter by specific gap ID if requested
+        if (this.opts.gapId) {
+            gaps = gaps.filter(g => g.id === this.opts.gapId);
+        }
+        // 3. Filter by priority
+        const minPriority = (_b = this.opts.priority) !== null && _b !== void 0 ? _b : 'P1';
+        gaps = gaps.filter(g => priorityGte(g.priority, minPriority));
+        // 4. Filter by type
+        if (this.opts.types && this.opts.types.length > 0) {
+            gaps = gaps.filter(g => this.opts.types.includes(g.type));
+        }
+        // 5. Sort by priority (P0 first)
+        gaps = (0, file_router_1.sortGapsByPriority)(gaps);
+        result.totalGaps = gaps.length;
+        // 6. Generate files for each gap
+        for (const gap of gaps) {
+            try {
+                const generated = this.generateForGap(gap);
+                for (const file of generated) {
+                    result.files.push(file);
+                    if (!this.opts.dryRun) {
+                        this.writeFile(file);
+                    }
+                    result.generatedCount++;
+                }
+            }
+            catch (err) {
+                result.errors.push({
+                    gapId: gap.id,
+                    message: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+        return result;
+    }
+    generateForGap(gap) {
+        const files = [];
+        const testTypes = this.getTestTypes(gap);
+        const language = this.discovery.language;
+        const convention = 'kebab';
+        for (const testType of testTypes) {
+            const outputPath = (0, file_router_1.routeOutputFile)(gap, testType, this.opts.outDir, language, convention);
+            const ctx = (0, context_builder_1.buildContext)(gap, outputPath, this.discovery);
+            const content = (0, template_renderer_1.renderTemplate)(ctx, { language, testType });
+            files.push({
+                gapId: gap.id,
+                filePath: path.resolve(outputPath),
+                relativePath: outputPath,
+                content,
+                testType,
+                language,
+                framework: this.discovery.testFramework,
+            });
+        }
+        return files;
+    }
+    getTestTypes(gap) {
+        var _a;
+        let types = (_a = GAP_GENERATOR_MAP[gap.type]) !== null && _a !== void 0 ? _a : ['unit'];
+        // Apply exclusion flags
+        if (this.opts.noSecurity) {
+            types = types.filter(t => t !== 'security');
+        }
+        if (this.opts.noCypress) {
+            types = types.filter(t => t !== 'cypress');
+        }
+        return types;
+    }
+    writeFile(file) {
+        const dir = path.dirname(file.relativePath);
+        fs.mkdirSync(dir, { recursive: true });
+        if (fs.existsSync(file.relativePath) && !this.opts.overwrite) {
+            return;
+        }
+        fs.writeFileSync(file.relativePath, file.content, 'utf8');
+    }
+}
+exports.TestGenerationEngine = TestGenerationEngine;
+// ─── Public API ───────────────────────────────────────────────────────────────
+async function generateTests(opts) {
+    const engine = new TestGenerationEngine(opts);
+    return engine.run();
+}