@yasserkhanorg/impact-gate 2.0.0

package/dist/pipeline/stage0_preprocess.js

@@ -0,0 +1,105 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.preprocess = preprocess;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const route_families_js_1 = require("../knowledge/route_families.js");
+const api_surface_js_1 = require("../knowledge/api_surface.js");
+const spec_index_js_1 = require("../knowledge/spec_index.js");
+const context_loader_js_1 = require("../knowledge/context_loader.js");
+const MAX_SNIPPET_CHARS = 3000;
+const MAX_FILES_PER_GROUP = 30;
+function loadFileSnippet(appPath, filePath) {
+    const candidates = [
+        (0, path_1.join)(appPath, filePath),
+        filePath,
+    ];
+    for (const candidate of candidates) {
+        if ((0, fs_1.existsSync)(candidate)) {
+            try {
+                const content = (0, fs_1.readFileSync)(candidate, 'utf-8');
+                if (content.length <= MAX_SNIPPET_CHARS) {
+                    return content;
+                }
+                return content.slice(0, MAX_SNIPPET_CHARS) + '\n// ... truncated';
+            }
+            catch {
+                continue;
+            }
+        }
+    }
+    return undefined;
+}
+function preprocess(changedFiles, config) {
+    const warnings = [];
+    // Load route family manifest, fall back to heuristic families
+    let manifest = (0, route_families_js_1.loadRouteFamilyManifest)(config.testsRoot, config.routeFamilies);
+    if (!manifest) {
+        manifest = (0, route_families_js_1.buildHeuristicFamilies)(changedFiles, config.testsRoot);
+        warnings.push('Route family manifest not found. Using directory-based heuristics (lower accuracy).', 'Tip: Run `impact-gate train` to generate a proper manifest.');
+    }
+    // Load API surface catalog
+    const apiSurface = (0, api_surface_js_1.loadOrBuildApiSurface)(config.testsRoot, config.apiSurface);
+    if (apiSurface.pageObjects.length === 0) {
+        warnings.push('API surface catalog is empty. Generated test validation will be limited.');
+    }
+    // Build spec index
+    const specIndex = (0, spec_index_js_1.buildSpecIndex)(config.testsRoot, undefined, manifest);
+    // Load context documents
+    const context = (0, context_loader_js_1.loadContextDocuments)(config.testsRoot, config.appPath);
+    warnings.push(...context.warnings);
+    // Bind files to families (manifest is always non-null now — either real or heuristic)
+    const fileBindings = (0, route_families_js_1.bindFilesToFamilies)(changedFiles, manifest);
+    const unboundFiles = fileBindings
+        .filter((fb) => fb.bindings.length === 0)
+        .map((fb) => fb.file);
+    if (unboundFiles.length > 0) {
+        warnings.push(`${unboundFiles.length} changed file(s) did not match any route family: ${unboundFiles.slice(0, 5).join(', ')}${unboundFiles.length > 5 ? '...' : ''}`);
+    }
+    // Group files by family+feature
+    const groupMap = new Map();
+    for (const binding of fileBindings) {
+        if (binding.bindings.length === 0) {
+            // Unbound files go into a special "unbound" group
+            const key = '__unbound__';
+            if (!groupMap.has(key)) {
+                groupMap.set(key, { familyId: '__unbound__', files: [] });
+            }
+            const group = groupMap.get(key);
+            if (group.files.length < MAX_FILES_PER_GROUP) {
+                group.files.push({
+                    path: binding.file,
+                    snippet: loadFileSnippet(config.appPath, binding.file),
+                });
+            }
+            continue;
+        }
+        for (const b of binding.bindings) {
+            const key = b.feature ? `${b.family}::${b.feature}` : b.family;
+            if (!groupMap.has(key)) {
+                groupMap.set(key, { familyId: b.family, featureId: b.feature, files: [] });
+            }
+            const group = groupMap.get(key);
+            if (group.files.length < MAX_FILES_PER_GROUP) {
+                group.files.push({
+                    path: binding.file,
+                    snippet: loadFileSnippet(config.appPath, binding.file),
+                });
+            }
+        }
+    }
+    const familyGroups = Array.from(groupMap.values()).filter((g) => g.familyId !== '__unbound__');
+    return {
+        changedFiles,
+        fileBindings,
+        unboundFiles,
+        familyGroups,
+        manifest,
+        apiSurface,
+        specIndex,
+        context,
+        warnings,
+    };
+}

package/dist/pipeline/stage1_impact.d.ts

@@ -0,0 +1,19 @@
+import { type RouteFamilyManifest } from '../knowledge/route_families.js';
+import { type SpecIndex } from '../knowledge/spec_index.js';
+import type { ApiSurfaceCatalog } from '../knowledge/api_surface.js';
+import type { LoadedContext } from '../knowledge/context_loader.js';
+import type { FamilyGroup } from './stage0_preprocess.js';
+import type { FlowDecision } from '../validation/output_schema.js';
+export interface ImpactConfig {
+    provider?: string;
+    maxTokens?: number;
+    temperature?: number;
+    timeout?: number;
+}
+export interface ImpactResult {
+    decisions: FlowDecision[];
+    warnings: string[];
+    providerName: string;
+}
+export declare function runImpactStage(familyGroups: FamilyGroup[], manifest: RouteFamilyManifest | null, specIndex: SpecIndex, apiSurface: ApiSurfaceCatalog, context: LoadedContext, config: ImpactConfig, testsRoot?: string): Promise<ImpactResult>;
+//# sourceMappingURL=stage1_impact.d.ts.map

package/dist/pipeline/stage1_impact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage1_impact.d.ts","sourceRoot":"","sources":["../../src/pipeline/stage1_impact.ts"],"names":[],"mappings":"AAOA,OAAO,EAAgD,KAAK,mBAAmB,EAAC,MAAM,gCAAgC,CAAC;AAEvH,OAAO,EAAoB,KAAK,SAAS,EAAC,MAAM,4BAA4B,CAAC;AAC7E,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAC,YAAY,EAA+B,MAAM,gCAAgC,CAAC;AAG/F,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IACzB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACxB;AAgBD,wBAAsB,cAAc,CAChC,YAAY,EAAE,WAAW,EAAE,EAC3B,QAAQ,EAAE,mBAAmB,GAAG,IAAI,EACpC,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,iBAAiB,EAC7B,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,YAAY,EACpB,SAAS,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,YAAY,CAAC,CAqIvB"}

package/dist/pipeline/stage1_impact.js

@@ -0,0 +1,143 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runImpactStage = runImpactStage;
+const provider_factory_js_1 = require("../provider_factory.js");
+const impact_js_1 = require("../prompts/impact.js");
+const context_loader_js_1 = require("../knowledge/context_loader.js");
+const route_families_js_1 = require("../knowledge/route_families.js");
+const failure_history_js_1 = require("../knowledge/failure_history.js");
+const spec_index_js_1 = require("../knowledge/spec_index.js");
+const guardrails_js_1 = require("../validation/guardrails.js");
+function normalizePriority(value) {
+    if (value === 'P0' || value === 'P1' || value === 'P2') {
+        return value;
+    }
+    return 'P2';
+}
+async function getProvider(config) {
+    if (config.provider && config.provider !== 'auto') {
+        return provider_factory_js_1.LLMProviderFactory.createFromString(config.provider);
+    }
+    return provider_factory_js_1.LLMProviderFactory.createFromEnv();
+}
+async function runImpactStage(familyGroups, manifest, specIndex, apiSurface, context, config, testsRoot) {
+    const warnings = [];
+    const allDecisions = [];
+    if (familyGroups.length === 0) {
+        warnings.push('No family groups to analyze. All changed files were unbound.');
+        return { decisions: [], warnings, providerName: 'none' };
+    }
+    let provider;
+    try {
+        provider = await getProvider(config);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        warnings.push(`Impact agent unavailable: ${message}`);
+        return { decisions: [], warnings, providerName: 'none' };
+    }
+    const contextBlock = (0, context_loader_js_1.formatContextForPrompt)(context);
+    // Load historical failure correlations for confidence boosting
+    const failureHistory = testsRoot ? (0, failure_history_js_1.loadFailureHistory)(testsRoot) : null;
+    for (const group of familyGroups) {
+        const family = manifest ? (0, route_families_js_1.getFamilyById)(manifest, group.familyId) : null;
+        if (!family) {
+            // For unbound groups, create cannot_determine decisions
+            for (const file of group.files) {
+                allDecisions.push({
+                    flowId: `unbound_${file.path.replace(/[^a-zA-Z0-9]/g, '_')}`,
+                    flowName: `Unbound file: ${file.path}`,
+                    routeFamily: '__unbound__',
+                    changedFiles: [file.path],
+                    evidence: 'File does not match any known route family in the manifest.',
+                    evidenceSource: 'deterministic',
+                    confidence: 0,
+                    existingSpecs: [],
+                    action: 'cannot_determine',
+                    blockingReason: 'File not mapped to any route family. Update route-families.json to include this file path.',
+                    priority: 'P2',
+                    userActions: [],
+                });
+            }
+            continue;
+        }
+        const specs = (0, spec_index_js_1.getSpecsForFamily)(specIndex, group.familyId, group.featureId);
+        const promptCtx = {
+            family,
+            featureId: group.featureId,
+            changedFiles: group.files,
+            existingSpecs: specs,
+            apiSurface,
+            contextBlock,
+        };
+        const prompt = (0, impact_js_1.buildImpactPrompt)(promptCtx);
+        try {
+            const response = await provider.generateText(prompt, {
+                maxTokens: config.maxTokens || 4000,
+                temperature: config.temperature ?? 0,
+                timeout: config.timeout || 45000,
+                systemPrompt: 'Return only valid JSON. Do not include markdown fences unless necessary.',
+            });
+            const parsed = (0, impact_js_1.parseImpactResponse)(response.text);
+            if (!parsed || parsed.flows.length === 0) {
+                warnings.push(`Impact agent returned no flows for family ${group.familyId}.`);
+                continue;
+            }
+            for (const flow of parsed.flows) {
+                if (!flow.id || !flow.changedFiles || !Array.isArray(flow.changedFiles)) {
+                    continue;
+                }
+                // Compute confidence with optional historical failure boost
+                const changedFilesList = Array.isArray(flow.changedFiles)
+                    ? flow.changedFiles.filter((f) => typeof f === 'string')
+                    : [];
+                const historyBoost = failureHistory
+                    ? Math.max(...changedFilesList.map((f) => (0, failure_history_js_1.getConfidenceBoost)(failureHistory, f)), 0)
+                    : 0;
+                const confidence = typeof flow.confidence === 'number'
+                    ? Math.min(100, Math.max(0, flow.confidence) + historyBoost)
+                    : (0, guardrails_js_1.computeConfidence)({
+                        hasRouteFamily: true,
+                        hasSpecificRoute: Boolean(flow.route),
+                        hasPageObject: Boolean(flow.pageObjects && flow.pageObjects.length > 0),
+                        hasUserAction: Boolean(flow.userActions && flow.userActions.length > 0),
+                        hasExistingSpecCited: false,
+                        historyBoost,
+                    });
+                // Resolve assertion patterns from manifest for this flow's family/feature
+                const assertionPatterns = manifest
+                    ? (0, route_families_js_1.getAssertionPatternsForBinding)(manifest, { family: group.familyId, feature: group.featureId })
+                    : [];
+                const decision = {
+                    flowId: flow.id,
+                    flowName: flow.name || flow.id,
+                    routeFamily: group.familyId,
+                    featureId: group.featureId,
+                    specificRoute: flow.route,
+                    changedFiles: flow.changedFiles.filter((f) => typeof f === 'string'),
+                    evidence: flow.evidence || 'AI identified this flow as impacted.',
+                    evidenceSource: 'ai',
+                    confidence,
+                    existingSpecs: [],
+                    action: (0, guardrails_js_1.shouldForceCannotDetermine)(confidence) ? 'cannot_determine' : 'run_existing',
+                    blockingReason: (0, guardrails_js_1.shouldForceCannotDetermine)(confidence) ? 'Confidence too low to determine action.' : undefined,
+                    priority: normalizePriority(flow.priority),
+                    userActions: Array.isArray(flow.userActions) ? flow.userActions.filter((a) => typeof a === 'string') : [],
+                    assertionPatterns: assertionPatterns.length > 0 ? assertionPatterns : undefined,
+                };
+                allDecisions.push(decision);
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            warnings.push(`Impact agent failed for family ${group.familyId}: ${message}`);
+        }
+    }
+    return {
+        decisions: allDecisions,
+        warnings,
+        providerName: provider.name,
+    };
+}

package/dist/pipeline/stage2_coverage.d.ts

@@ -0,0 +1,19 @@
+import { type LoadedContext } from '../knowledge/context_loader.js';
+import { type SpecIndex } from '../knowledge/spec_index.js';
+import type { FlowDecision } from '../validation/output_schema.js';
+import type { GenerationProfile } from '../prompts/generation_profile.js';
+export interface CoverageConfig {
+    provider?: string;
+    maxTokens?: number;
+    temperature?: number;
+    timeout?: number;
+    maxSpecContentChars?: number;
+    profile?: GenerationProfile;
+}
+export interface CoverageResult {
+    decisions: FlowDecision[];
+    warnings: string[];
+    providerName: string;
+}
+export declare function runCoverageStage(decisions: FlowDecision[], specIndex: SpecIndex, context: LoadedContext, testsRoot: string, config: CoverageConfig): Promise<CoverageResult>;
+//# sourceMappingURL=stage2_coverage.d.ts.map

package/dist/pipeline/stage2_coverage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage2_coverage.d.ts","sourceRoot":"","sources":["../../src/pipeline/stage2_coverage.ts"],"names":[],"mappings":"AAMA,OAAO,EAA8C,KAAK,aAAa,EAAC,MAAM,gCAAgC,CAAC;AAC/G,OAAO,EAAoB,KAAK,SAAS,EAAC,MAAM,4BAA4B,CAAC;AAC7E,OAAO,KAAK,EAAC,YAAY,EAA4B,MAAM,gCAAgC,CAAC;AAC5F,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,kCAAkC,CAAC;AAExE,MAAM,WAAW,cAAc;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC3B,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACxB;AAYD,wBAAsB,gBAAgB,CAClC,SAAS,EAAE,YAAY,EAAE,EACzB,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,cAAc,GACvB,OAAO,CAAC,cAAc,CAAC,CAyJzB"}

package/dist/pipeline/stage2_coverage.js

@@ -0,0 +1,156 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runCoverageStage = runCoverageStage;
+const provider_factory_js_1 = require("../provider_factory.js");
+const coverage_js_1 = require("../prompts/coverage.js");
+const context_loader_js_1 = require("../knowledge/context_loader.js");
+const spec_index_js_1 = require("../knowledge/spec_index.js");
+const VALID_ACTIONS = ['run_existing', 'add_scenarios', 'create_spec', 'cannot_determine'];
+const VALID_COVERAGE = ['full', 'partial', 'none'];
+async function getProvider(config) {
+    if (config.provider && config.provider !== 'auto') {
+        return provider_factory_js_1.LLMProviderFactory.createFromString(config.provider);
+    }
+    return provider_factory_js_1.LLMProviderFactory.createFromEnv();
+}
+async function runCoverageStage(decisions, specIndex, context, testsRoot, config) {
+    const warnings = [];
+    // Filter to only actionable decisions (not cannot_determine)
+    const actionable = decisions.filter((d) => d.action !== 'cannot_determine');
+    if (actionable.length === 0) {
+        return { decisions, warnings, providerName: 'none' };
+    }
+    let provider;
+    try {
+        provider = await getProvider(config);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        warnings.push(`Coverage agent unavailable: ${message}. Decisions will not have coverage evaluation.`);
+        return { decisions, warnings, providerName: 'none' };
+    }
+    // Group decisions by route family for efficient prompting
+    const byFamily = new Map();
+    for (const d of actionable) {
+        const key = d.routeFamily;
+        if (!byFamily.has(key)) {
+            byFamily.set(key, []);
+        }
+        byFamily.get(key).push(d);
+    }
+    const updatedDecisions = new Map();
+    const contextBlock = (0, context_loader_js_1.formatContextForPrompt)(context);
+    const maxSpecChars = config.maxSpecContentChars || 15000;
+    for (const [familyId, familyDecisions] of byFamily) {
+        // Gather relevant specs
+        const specs = (0, spec_index_js_1.getSpecsForFamily)(specIndex, familyId);
+        // Two-tier approach: send all spec titles (compact), full content for top matches only
+        const allSpecSummaries = specs.map((s) => ({
+            relativePath: s.relativePath,
+            testTitles: s.testTitles,
+        }));
+        // Load full content with a total budget of 200K chars (~50K tokens) to avoid blowing context windows
+        const MAX_TOTAL_SPEC_CHARS = 200000;
+        let totalSpecChars = 0;
+        const specsWithContent = [];
+        for (const s of specs) {
+            if (specsWithContent.length >= 30)
+                break;
+            const content = (0, context_loader_js_1.loadSpecFileContent)(testsRoot, s.relativePath, maxSpecChars);
+            if (!content)
+                continue;
+            if (totalSpecChars + content.length > MAX_TOTAL_SPEC_CHARS)
+                break;
+            totalSpecChars += content.length;
+            specsWithContent.push({ relativePath: s.relativePath, content, testTitles: s.testTitles });
+        }
+        if (specsWithContent.length === 0) {
+            // No specs to evaluate — mark all as create_spec
+            for (const d of familyDecisions) {
+                updatedDecisions.set(d.flowId, {
+                    ...d,
+                    action: 'create_spec',
+                    existingSpecs: [],
+                    evidence: d.evidence + ' No existing specs found for this route family.',
+                });
+            }
+            continue;
+        }
+        const flows = familyDecisions.map((d) => ({
+            flowId: d.flowId,
+            flowName: d.flowName,
+            route: d.specificRoute || d.routeFamily,
+            userActions: d.userActions,
+            evidence: d.evidence,
+            priority: d.priority,
+        }));
+        // Include titles-only summaries for specs beyond the content limit
+        const extraSummaries = allSpecSummaries
+            .slice(specsWithContent.length)
+            .map((s) => `  - ${s.relativePath}: ${s.testTitles.join(', ')}`)
+            .join('\n');
+        const extraContext = extraSummaries
+            ? `\nADDITIONAL SPECS (titles only, no content loaded):\n${extraSummaries}\n`
+            : '';
+        const prompt = (0, coverage_js_1.buildCoveragePrompt)({
+            flows,
+            specs: specsWithContent,
+            contextBlock: contextBlock + extraContext,
+            profile: config.profile,
+        });
+        try {
+            const response = await provider.generateText(prompt, {
+                maxTokens: config.maxTokens || 4000,
+                temperature: config.temperature ?? 0,
+                timeout: config.timeout || 60000,
+                systemPrompt: 'Return only valid JSON. Do not include markdown fences unless necessary.',
+            });
+            const parsed = (0, coverage_js_1.parseCoverageResponse)(response.text);
+            if (!parsed || parsed.coverage.length === 0) {
+                warnings.push(`Coverage agent returned no results for family ${familyId}.`);
+                continue;
+            }
+            for (const entry of parsed.coverage) {
+                const original = familyDecisions.find((d) => d.flowId === entry.flowId);
+                if (!original) {
+                    continue;
+                }
+                const action = VALID_ACTIONS.includes(entry.action)
+                    ? entry.action
+                    : 'cannot_determine';
+                const existingSpecs = (entry.existingSpecs || []).map((s) => ({
+                    path: s.path || '',
+                    testTitles: Array.isArray(s.testTitles) ? s.testTitles.filter((t) => typeof t === 'string') : [],
+                    coverageLevel: (VALID_COVERAGE.includes(s.coverageLevel) ? s.coverageLevel : 'none'),
+                    missingScenarios: Array.isArray(s.missingScenarios) ? s.missingScenarios.filter((t) => typeof t === 'string') : undefined,
+                }));
+                const confidence = typeof entry.confidence === 'number'
+                    ? Math.max(0, Math.min(100, entry.confidence))
+                    : original.confidence;
+                updatedDecisions.set(original.flowId, {
+                    ...original,
+                    action,
+                    confidence,
+                    existingSpecs,
+                    targetSpec: entry.targetSpec,
+                    newSpecPath: entry.newSpecPath,
+                    scenariosToAdd: entry.scenariosToAdd?.filter((s) => typeof s === 'string'),
+                    blockingReason: entry.blockingReason,
+                });
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            warnings.push(`Coverage agent failed for family ${familyId}: ${message}`);
+        }
+    }
+    // Merge updated decisions back
+    const finalDecisions = decisions.map((d) => updatedDecisions.get(d.flowId) || d);
+    return {
+        decisions: finalDecisions,
+        warnings,
+        providerName: provider.name,
+    };
+}

package/dist/pipeline/stage3_generation.d.ts

@@ -0,0 +1,43 @@
+import { loadSpecFileContent } from '../knowledge/context_loader.js';
+import type { FlowDecision } from '../validation/output_schema.js';
+import type { ApiSurfaceCatalog } from '../knowledge/api_surface.js';
+import type { GenerationProfile } from '../prompts/generation_profile.js';
+export interface GenerationConfig {
+    provider?: string;
+    maxTokens?: number;
+    temperature?: number;
+    timeout?: number;
+    /** Directory to write generated specs into when no path is specified */
+    defaultOutputDir?: string;
+    /** Set to true to log hallucination warnings but still write the file */
+    warnOnHallucinations?: boolean;
+    /** When true, only log what would be written without actually writing files */
+    dryRun?: boolean;
+    profile?: GenerationProfile;
+}
+export interface GeneratedSpec {
+    flowId: string;
+    specPath: string;
+    mode: 'create_spec' | 'add_scenarios';
+    written: boolean;
+    hallucinationWarnings: string[];
+    /** Whether the spec passed compile + smoke-run verification */
+    verified?: boolean;
+    /** If verification failed, the reason */
+    verificationError?: string;
+}
+export interface GenerationResult {
+    generated: GeneratedSpec[];
+    skipped: string[];
+    warnings: string[];
+    providerName: string;
+    /** Total number of specs generated */
+    generatedCount: number;
+    /** Number that passed compile + smoke-run */
+    verifiedCount: number;
+    /** Number that failed verification */
+    failedCount: number;
+}
+export declare function runGenerationStage(decisions: FlowDecision[], apiSurface: ApiSurfaceCatalog, testsRoot: string, config: GenerationConfig): Promise<GenerationResult>;
+export { loadSpecFileContent };
+//# sourceMappingURL=stage3_generation.d.ts.map

package/dist/pipeline/stage3_generation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage3_generation.d.ts","sourceRoot":"","sources":["../../src/pipeline/stage3_generation.ts"],"names":[],"mappings":"AAQA,OAAO,EAAC,mBAAmB,EAAC,MAAM,gCAAgC,CAAC;AAInE,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,gCAAgC,CAAC;AACjE,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,kCAAkC,CAAC;AAExE,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yEAAyE;IACzE,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,+EAA+E;IAC/E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,aAAa,GAAG,eAAe,CAAC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yCAAyC;IACzC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC7B,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,6CAA6C;IAC7C,aAAa,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;CACvB;AAyCD,wBAAsB,kBAAkB,CACpC,SAAS,EAAE,YAAY,EAAE,EACzB,UAAU,EAAE,iBAAiB,EAC7B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,gBAAgB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CA8J3B;AAqHD,OAAO,EAAC,mBAAmB,EAAC,CAAC"}