@yasserkhanorg/impact-gate 2.0.0

package/dist/training/types.d.ts

@@ -0,0 +1,117 @@
+import type { RouteFamily, RouteFamilyManifest } from '../knowledge/route_families.js';
+/** A source directory discovered by the scanner */
+export interface DiscoveredDir {
+    /** Absolute path to the directory */
+    path: string;
+    /** Relative path from project root */
+    relativePath: string;
+    /** Category: frontend source, backend source, or test */
+    category: 'webapp' | 'server' | 'test' | 'cypress';
+    /** Deepest meaningful directory name (e.g., 'channels' from 'src/channels/') */
+    familyHint: string;
+}
+/** A family proposed by the deterministic scanner */
+export interface ScannedFamily {
+    id: string;
+    routes: string[];
+    webappPaths: string[];
+    serverPaths: string[];
+    specDirs: string[];
+    cypressSpecDirs: string[];
+    tags: string[];
+    features: ScannedFeature[];
+    /** True if routes are guesses (directory-name-based) */
+    routesGuessed: boolean;
+}
+/** A nested feature proposed by the scanner */
+export interface ScannedFeature {
+    id: string;
+    webappPaths: string[];
+    serverPaths: string[];
+    specDirs: string[];
+}
+/** Output of the deterministic scanner */
+export interface ScanResult {
+    families: ScannedFamily[];
+    unmatchedSourceDirs: DiscoveredDir[];
+    unmatchedTestDirs: DiscoveredDir[];
+    stats: {
+        totalSourceFiles: number;
+        totalTestFiles: number;
+        familyCount: number;
+    };
+}
+/** Output of LLM enrichment */
+export interface EnrichmentResult {
+    enrichedFamilies: RouteFamily[];
+    tokensUsed: number;
+    costUSD: number;
+    skippedFamilies: string[];
+    /** Number of LLM requests made */
+    requestCount?: number;
+    /** Average response time per LLM request in ms */
+    avgResponseMs?: number;
+}
+/** A single commit's validation result */
+export interface CommitValidation {
+    hash: string;
+    message: string;
+    changedFiles: string[];
+    boundFiles: number;
+    unboundFiles: string[];
+    familiesHit: string[];
+}
+/** Output of validation mode */
+export interface ValidationReport {
+    totalCommits: number;
+    totalFiles: number;
+    boundFiles: number;
+    unboundFiles: number;
+    coveragePercent: number;
+    commits: CommitValidation[];
+    familyHits: Record<string, number>;
+    neverHitFamilies: string[];
+    unboundFileClusters: Array<{
+        pattern: string;
+        count: number;
+        suggestedFamily: string;
+    }>;
+}
+/** Output of smart merge */
+export interface MergeResult {
+    manifest: RouteFamilyManifest;
+    newFamilies: string[];
+    updatedFamilies: string[];
+    staleFamilies: string[];
+    summary: string;
+}
+/** Options for the train command */
+export interface TrainOptions {
+    /** Path to the application root */
+    appPath: string;
+    /** Path to tests root (may differ from appPath) */
+    testsRoot: string;
+    /** Path to server/backend root (may differ from appPath) */
+    serverRoot?: string;
+    /** Git repo root for monorepo-aware validation */
+    gitRepoRoot?: string;
+    /** Enable LLM enrichment (default: true) */
+    enrich: boolean;
+    /** Run validation against git history */
+    validate: boolean;
+    /** Git ref for validation (e.g., 'HEAD~20') */
+    since: string;
+    /** GitHub PR number for validation */
+    pr?: number;
+    /** Output path for route-families.json */
+    outputPath: string;
+    /** Dry run — print without writing */
+    dryRun: boolean;
+    /** Non-interactive mode */
+    yes: boolean;
+    /** Max LLM spend in USD */
+    budgetUSD: number;
+}
+/** Routes that look like bare "/<id>" are scanner-generated guesses */
+export declare function isGuessedRoute(routes: string[]): boolean;
+//# sourceMappingURL=types.d.ts.map

package/dist/training/types.d.ts.map

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

package/dist/training/types.js

@@ -0,0 +1,9 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isGuessedRoute = isGuessedRoute;
+/** Routes that look like bare "/<id>" are scanner-generated guesses */
+function isGuessedRoute(routes) {
+    return routes.every((r) => /^\/[a-z][a-z0-9_]*$/.test(r));
+}

package/dist/training/validator.d.ts

@@ -0,0 +1,21 @@
+import type { RouteFamilyManifest } from '../knowledge/route_families.js';
+import type { CommitValidation, ValidationReport } from './types.js';
+/**
+ * Check if a file path matches any infrastructure glob pattern.
+ * Uses simple string matching — no external glob library needed.
+ */
+export declare function isInfraFile(filePath: string): boolean;
+export declare function parseGitLog(log: string): Array<{
+    hash: string;
+    message: string;
+    files: string[];
+}>;
+export declare function getCommitFiles(projectRoot: string, since: string): Array<{
+    hash: string;
+    message: string;
+    files: string[];
+}>;
+export declare function validateCommit(manifest: RouteFamilyManifest, files: string[], hash: string, message: string, pathPrefixes?: string[]): CommitValidation;
+export declare function buildValidationReport(commits: CommitValidation[], manifest: RouteFamilyManifest): ValidationReport;
+export declare function formatValidationReport(report: ValidationReport): string;
+//# sourceMappingURL=validator.d.ts.map

package/dist/training/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/training/validator.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAC,mBAAmB,EAAC,MAAM,gCAAgC,CAAC;AAExE,OAAO,KAAK,EAAC,gBAAgB,EAAE,gBAAgB,EAAC,MAAM,YAAY,CAAC;AAoBnE;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CA6BrD;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAC,CAAC,CA6BhG;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAC,CAAC,CAgB1H;AA+CD,wBAAgB,cAAc,CAC1B,QAAQ,EAAE,mBAAmB,EAC7B,KAAK,EAAE,MAAM,EAAE,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,EAAE,GACxB,gBAAgB,CA+BlB;AAED,wBAAgB,qBAAqB,CACjC,OAAO,EAAE,gBAAgB,EAAE,EAC3B,QAAQ,EAAE,mBAAmB,GAC9B,gBAAgB,CAkDlB;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAgCvE"}

package/dist/training/validator.js

@@ -0,0 +1,262 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isInfraFile = isInfraFile;
+exports.parseGitLog = parseGitLog;
+exports.getCommitFiles = getCommitFiles;
+exports.validateCommit = validateCommit;
+exports.buildValidationReport = buildValidationReport;
+exports.formatValidationReport = formatValidationReport;
+const child_process_1 = require("child_process");
+const path_1 = require("path");
+const logger_js_1 = require("../logger.js");
+const route_families_js_1 = require("../knowledge/route_families.js");
+/**
+ * Glob-style patterns for infrastructure / cross-cutting files that will never
+ * belong to a single route family.  Excluded from coverage calculations.
+ */
+const INFRA_GLOBS = [
+    'Makefile', 'go.mod', 'go.sum',
+    '*.lock',
+    '**/mocks/*', '**/storetest/*', '**/testlib/*',
+    '**/i18n/*',
+    '**/.github/*', '**/.ci/*', '**/scripts/*',
+    '**/docker-compose*',
+    '**/__fixtures__/*', '**/test_templates/*',
+    '**/__snapshots__/*', '**/retrylayer/*', '**/timerlayer/*',
+    '**/cmd/mmctl/*',
+    '**/mattermost-redux/src/reducers/*',
+    'playwright.config.ts', 'global-setup.ts',
+];
+/**
+ * Check if a file path matches any infrastructure glob pattern.
+ * Uses simple string matching — no external glob library needed.
+ */
+function isInfraFile(filePath) {
+    const normalized = filePath.replace(/\\/g, '/');
+    for (const pattern of INFRA_GLOBS) {
+        if (pattern.startsWith('**/')) {
+            // Match anywhere in the path
+            const suffix = pattern.slice(3);
+            if (suffix.endsWith('/*')) {
+                // Directory match: **/mocks/* → any segment named "mocks" with a child
+                const dirName = suffix.slice(0, -2);
+                if (normalized.includes(`/${dirName}/`) || normalized.startsWith(`${dirName}/`))
+                    return true;
+            }
+            else if (suffix.endsWith('*')) {
+                // Prefix match: **/docker-compose* → file starting with docker-compose
+                const prefix = suffix.slice(0, -1);
+                const base = normalized.split('/').pop() || '';
+                if (base.startsWith(prefix))
+                    return true;
+            }
+            else {
+                if (normalized.endsWith(`/${suffix}`) || normalized === suffix)
+                    return true;
+            }
+        }
+        else if (pattern.startsWith('*.')) {
+            // Extension match: *.lock
+            const ext = pattern.slice(1);
+            if (normalized.endsWith(ext))
+                return true;
+        }
+        else {
+            // Exact basename match: Makefile, go.mod, go.sum
+            const base = normalized.split('/').pop() || '';
+            if (base === pattern)
+                return true;
+        }
+    }
+    return false;
+}
+function parseGitLog(log) {
+    const commits = [];
+    let current = null;
+    for (const line of log.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed) {
+            if (current) {
+                commits.push(current);
+                current = null;
+            }
+            continue;
+        }
+        if (trimmed.includes('|') && /^[0-9a-f]{7,40}\|/.test(trimmed)) {
+            if (current) {
+                commits.push(current);
+            }
+            const [hash, ...rest] = trimmed.split('|');
+            current = { hash, message: rest.join('|'), files: [] };
+        }
+        else if (current) {
+            current.files.push(trimmed);
+        }
+    }
+    if (current) {
+        commits.push(current);
+    }
+    return commits;
+}
+function getCommitFiles(projectRoot, since) {
+    const resolved = (0, path_1.resolve)(projectRoot);
+    let log;
+    try {
+        log = (0, child_process_1.execFileSync)('git', ['log', '--name-only', '--pretty=format:%H|%s', `${since}..HEAD`], {
+            cwd: resolved,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+            maxBuffer: 10 * 1024 * 1024,
+        });
+    }
+    catch (error) {
+        logger_js_1.logger.warn(`[train] git log failed: ${error instanceof Error ? error.message : String(error)}`);
+        return [];
+    }
+    return parseGitLog(log);
+}
+/**
+ * For each file, try matching both the original path and any prefix-stripped
+ * variant against the manifest.  Returns one FileBinding per original file.
+ */
+function bindWithPrefixes(files, manifest, prefixes) {
+    if (prefixes.length === 0) {
+        return (0, route_families_js_1.bindFilesToFamilies)(files, manifest);
+    }
+    // Build candidate variants for each file
+    const variants = files.map((f) => {
+        const normalized = f.replace(/\\/g, '/');
+        const candidates = [normalized];
+        for (const prefix of prefixes) {
+            if (normalized.startsWith(prefix)) {
+                candidates.push(normalized.slice(prefix.length));
+                break;
+            }
+        }
+        return candidates;
+    });
+    // Bind all variants and merge results per original file
+    return files.map((f, i) => {
+        const normalized = f.replace(/\\/g, '/');
+        const allBindings = [];
+        const seen = new Set();
+        for (const variant of variants[i]) {
+            const [result] = (0, route_families_js_1.bindFilesToFamilies)([variant], manifest);
+            for (const b of result.bindings) {
+                const key = `${b.family}:${b.feature || ''}`;
+                if (!seen.has(key)) {
+                    seen.add(key);
+                    allBindings.push(b);
+                }
+            }
+        }
+        return { file: normalized, bindings: allBindings };
+    });
+}
+function validateCommit(manifest, files, hash, message, pathPrefixes) {
+    // Filter out non-source files and infrastructure files
+    const sourceFiles = files.filter((f) => {
+        return !f.endsWith('.md') && !f.endsWith('.json') && !f.endsWith('.yml') && !f.endsWith('.yaml') &&
+            !f.startsWith('.') && !f.includes('node_modules/') && !isInfraFile(f);
+    });
+    if (sourceFiles.length === 0) {
+        return { hash, message, changedFiles: [], boundFiles: 0, unboundFiles: [], familiesHit: [] };
+    }
+    const bindings = pathPrefixes
+        ? bindWithPrefixes(sourceFiles, manifest, pathPrefixes)
+        : (0, route_families_js_1.bindFilesToFamilies)(sourceFiles, manifest);
+    const bound = bindings.filter((b) => b.bindings.length > 0);
+    const unbound = bindings.filter((b) => b.bindings.length === 0);
+    const familiesHit = new Set();
+    for (const b of bound) {
+        for (const binding of b.bindings) {
+            familiesHit.add(binding.family);
+        }
+    }
+    return {
+        hash,
+        message,
+        changedFiles: sourceFiles,
+        boundFiles: bound.length,
+        unboundFiles: unbound.map((b) => b.file),
+        familiesHit: Array.from(familiesHit),
+    };
+}
+function buildValidationReport(commits, manifest) {
+    let totalFiles = 0;
+    let boundFiles = 0;
+    let unboundFiles = 0;
+    const familyHits = {};
+    const unboundCounts = {};
+    for (const commit of commits) {
+        totalFiles += commit.changedFiles.length;
+        boundFiles += commit.boundFiles;
+        unboundFiles += commit.unboundFiles.length;
+        for (const fam of commit.familiesHit) {
+            familyHits[fam] = (familyHits[fam] || 0) + 1;
+        }
+        for (const uf of commit.unboundFiles) {
+            unboundCounts[uf] = (unboundCounts[uf] || 0) + 1;
+        }
+    }
+    const allFamilyIds = manifest.families.map((f) => f.id);
+    const hitFamilyIds = new Set(Object.keys(familyHits));
+    const neverHitFamilies = allFamilyIds.filter((id) => !hitFamilyIds.has(id));
+    // Cluster unbound files by directory
+    const dirCounts = {};
+    for (const [file, count] of Object.entries(unboundCounts)) {
+        const dir = file.split('/').slice(0, -1).join('/');
+        dirCounts[dir] = (dirCounts[dir] || 0) + count;
+    }
+    const unboundFileClusters = Object.entries(dirCounts)
+        .sort(([, a], [, b]) => b - a)
+        .slice(0, 20)
+        .map(([pattern, count]) => ({
+        pattern: `${pattern}/*`,
+        count,
+        suggestedFamily: pattern.split('/').pop() || 'unknown',
+    }));
+    return {
+        totalCommits: commits.length,
+        totalFiles,
+        boundFiles,
+        unboundFiles,
+        coveragePercent: totalFiles > 0 ? Math.round((boundFiles / totalFiles) * 100) : 100,
+        commits,
+        familyHits,
+        neverHitFamilies,
+        unboundFileClusters,
+    };
+}
+function formatValidationReport(report) {
+    const lines = [];
+    lines.push(`Validated against ${report.totalCommits} commits`);
+    lines.push('');
+    lines.push(`Coverage: ${report.coveragePercent}% of files bound (${report.boundFiles}/${report.totalFiles})`);
+    lines.push('');
+    // Family hit distribution
+    const sorted = Object.entries(report.familyHits).sort(([, a], [, b]) => b - a);
+    if (sorted.length > 0) {
+        lines.push('Family hit distribution:');
+        const maxHits = sorted[0][1];
+        for (const [family, hits] of sorted) {
+            const bar = '\u2588'.repeat(Math.max(1, Math.round((hits / maxHits) * 12)));
+            lines.push(`  ${family.padEnd(20)} ${bar} ${hits} commits`);
+        }
+        if (report.neverHitFamilies.length > 0) {
+            lines.push(`  (never hit)${' '.repeat(8)}${report.neverHitFamilies.join(', ')}`);
+        }
+        lines.push('');
+    }
+    // Unbound file clusters
+    if (report.unboundFileClusters.length > 0) {
+        lines.push(`Unbound files (${report.unboundFiles} files across ${report.totalCommits} commits):`);
+        for (const cluster of report.unboundFileClusters.slice(0, 10)) {
+            lines.push(`  ${cluster.pattern.padEnd(50)} — ${cluster.count} commits (suggest: ${cluster.suggestedFamily})`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}

package/dist/validation/guardrails.d.ts

@@ -0,0 +1,31 @@
+import type { RouteFamilyManifest } from '../knowledge/route_families.js';
+export interface EvidenceCheck {
+    hasRouteFamily: boolean;
+    hasSpecificRoute: boolean;
+    hasPageObject: boolean;
+    hasUserAction: boolean;
+    hasExistingSpecCited: boolean;
+    /** Historical failure correlation boost (0-20) from failure_history */
+    historyBoost?: number;
+}
+export type ConfidenceClass = 'high' | 'medium' | 'low';
+export declare const EVIDENCE_THRESHOLDS: {
+    readonly minConfidenceForAction: 40;
+    readonly minConfidenceForGeneration: 60;
+    readonly cannotDetermineBelow: 30;
+    readonly highConfidenceAbove: 75;
+};
+export declare function computeConfidence(check: EvidenceCheck): number;
+export declare function classifyConfidence(confidence: number): ConfidenceClass;
+export declare function shouldForceCannotDetermine(confidence: number): boolean;
+export declare function validateRouteAgainstManifest(route: string, familyId: string, manifest: RouteFamilyManifest): boolean;
+export declare function computeCannotDetermineRatio(decisions: Array<{
+    action: string;
+}>): number;
+export declare function computeOverallConfidence(decisions: Array<{
+    confidence: number;
+    action: string;
+}>): ConfidenceClass;
+export type { CompileCheckResult, SmokeRunResult } from '../pipeline/spec_verifier.js';
+export { compileCheckSpec, smokeRunSpec } from '../pipeline/spec_verifier.js';
+//# sourceMappingURL=guardrails.d.ts.map

package/dist/validation/guardrails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardrails.d.ts","sourceRoot":"","sources":["../../src/validation/guardrails.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,mBAAmB,EAAC,MAAM,gCAAgC,CAAC;AAExE,MAAM,WAAW,aAAa;IAC1B,cAAc,EAAE,OAAO,CAAC;IACxB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,OAAO,CAAC;IACvB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAExD,eAAO,MAAM,mBAAmB;;;;;CAKtB,CAAC;AAEX,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAuB9D;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,CAQtE;AAED,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAEtE;AAED,wBAAgB,4BAA4B,CACxC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,mBAAmB,GAC9B,OAAO,CAwBT;AAeD,wBAAgB,2BAA2B,CACvC,SAAS,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,CAAC,GACnC,MAAM,CAMR;AAED,wBAAgB,wBAAwB,CACpC,SAAS,EAAE,KAAK,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,CAAC,GACvD,eAAe,CAUjB;AAGD,YAAY,EAAC,kBAAkB,EAAE,cAAc,EAAC,MAAM,8BAA8B,CAAC;AACrF,OAAO,EAAC,gBAAgB,EAAE,YAAY,EAAC,MAAM,8BAA8B,CAAC"}

package/dist/validation/guardrails.js

@@ -0,0 +1,112 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.smokeRunSpec = exports.compileCheckSpec = exports.EVIDENCE_THRESHOLDS = void 0;
+exports.computeConfidence = computeConfidence;
+exports.classifyConfidence = classifyConfidence;
+exports.shouldForceCannotDetermine = shouldForceCannotDetermine;
+exports.validateRouteAgainstManifest = validateRouteAgainstManifest;
+exports.computeCannotDetermineRatio = computeCannotDetermineRatio;
+exports.computeOverallConfidence = computeOverallConfidence;
+exports.EVIDENCE_THRESHOLDS = {
+    minConfidenceForAction: 40,
+    minConfidenceForGeneration: 60,
+    cannotDetermineBelow: 30,
+    highConfidenceAbove: 75,
+};
+function computeConfidence(check) {
+    let score = 0;
+    if (check.hasRouteFamily) {
+        score += 25;
+    }
+    if (check.hasSpecificRoute) {
+        score += 15;
+    }
+    if (check.hasPageObject) {
+        score += 20;
+    }
+    if (check.hasUserAction) {
+        score += 25;
+    }
+    if (check.hasExistingSpecCited) {
+        score += 15;
+    }
+    // Historical failure correlation: if this file historically causes test failures,
+    // we're more confident it needs testing now
+    if (check.historyBoost) {
+        score += check.historyBoost;
+    }
+    return Math.min(100, score);
+}
+function classifyConfidence(confidence) {
+    if (confidence >= exports.EVIDENCE_THRESHOLDS.highConfidenceAbove) {
+        return 'high';
+    }
+    if (confidence >= exports.EVIDENCE_THRESHOLDS.minConfidenceForAction) {
+        return 'medium';
+    }
+    return 'low';
+}
+function shouldForceCannotDetermine(confidence) {
+    return confidence < exports.EVIDENCE_THRESHOLDS.cannotDetermineBelow;
+}
+function validateRouteAgainstManifest(route, familyId, manifest) {
+    const family = manifest.families.find((f) => f.id === familyId);
+    if (!family) {
+        return false;
+    }
+    // Check family-level routes
+    for (const pattern of family.routes) {
+        if (routeMatchesPattern(route, pattern)) {
+            return true;
+        }
+    }
+    // Check feature-level routes
+    if (family.features) {
+        for (const feature of family.features) {
+            if (feature.routes) {
+                for (const pattern of feature.routes) {
+                    if (routeMatchesPattern(route, pattern)) {
+                        return true;
+                    }
+                }
+            }
+        }
+    }
+    return false;
+}
+function routeMatchesPattern(route, pattern) {
+    // Convert route pattern like /{team}/channels/{channel} to regex
+    const regexStr = pattern
+        .replace(/\{[^}]+\}/g, '[^/]+')
+        .replace(/\//g, '\\/');
+    try {
+        const regex = new RegExp(`^${regexStr}$`);
+        return regex.test(route);
+    }
+    catch {
+        return route === pattern || route.startsWith(pattern);
+    }
+}
+function computeCannotDetermineRatio(decisions) {
+    if (decisions.length === 0) {
+        return 0;
+    }
+    const cannotDetermineCount = decisions.filter((d) => d.action === 'cannot_determine').length;
+    return cannotDetermineCount / decisions.length;
+}
+function computeOverallConfidence(decisions) {
+    if (decisions.length === 0) {
+        return 'low';
+    }
+    const actionable = decisions.filter((d) => d.action !== 'cannot_determine');
+    if (actionable.length === 0) {
+        return 'low';
+    }
+    const avgConfidence = actionable.reduce((sum, d) => sum + d.confidence, 0) / actionable.length;
+    return classifyConfidence(avgConfidence);
+}
+var spec_verifier_js_1 = require("../pipeline/spec_verifier.js");
+Object.defineProperty(exports, "compileCheckSpec", { enumerable: true, get: function () { return spec_verifier_js_1.compileCheckSpec; } });
+Object.defineProperty(exports, "smokeRunSpec", { enumerable: true, get: function () { return spec_verifier_js_1.smokeRunSpec; } });

package/dist/validation/output_schema.d.ts

@@ -0,0 +1,67 @@
+export type FlowAction = 'run_existing' | 'add_scenarios' | 'create_spec' | 'cannot_determine';
+export type EvidenceSource = 'ai' | 'catalog' | 'traceability' | 'deterministic';
+export type FlowPriority = 'P0' | 'P1' | 'P2';
+export type ConfidenceClass = 'high' | 'medium' | 'low';
+export type CoverageLevel = 'full' | 'partial' | 'none';
+export interface ExistingSpecCoverage {
+    path: string;
+    testTitles: string[];
+    coverageLevel: CoverageLevel;
+    missingScenarios?: string[];
+}
+export type { AssertionPattern } from '../knowledge/route_families.js';
+import type { AssertionPattern } from '../knowledge/route_families.js';
+export interface FlowDecision {
+    flowId: string;
+    flowName: string;
+    routeFamily: string;
+    featureId?: string;
+    specificRoute?: string;
+    changedFiles: string[];
+    evidence: string;
+    evidenceSource: EvidenceSource;
+    confidence: number;
+    existingSpecs: ExistingSpecCoverage[];
+    action: FlowAction;
+    targetSpec?: string;
+    newSpecPath?: string;
+    scenariosToAdd?: string[];
+    blockingReason?: string;
+    priority: FlowPriority;
+    userActions: string[];
+    assertionPatterns?: AssertionPattern[];
+}
+export interface FlowDecisionSummary {
+    changedFiles: number;
+    routeFamiliesImpacted: string[];
+    flowsIdentified: number;
+    flowsCovered: number;
+    flowsPartial: number;
+    flowsUncovered: number;
+    actionsRequired: {
+        run_existing: number;
+        add_scenarios: number;
+        create_spec: number;
+        cannot_determine: number;
+    };
+    overallConfidence: ConfidenceClass;
+}
+export interface FlowDecisionReport {
+    runId: string;
+    timestamp: string;
+    gitRef: string;
+    summary: FlowDecisionSummary;
+    decisions: FlowDecision[];
+    warnings: string[];
+    model: {
+        impactAgent?: string;
+        coverageAgent?: string;
+        generationAgent?: string;
+    };
+}
+export declare function validateFlowDecision(decision: unknown): {
+    valid: boolean;
+    errors: string[];
+};
+export declare function buildSummary(decisions: FlowDecision[]): FlowDecisionSummary;
+//# sourceMappingURL=output_schema.d.ts.map

package/dist/validation/output_schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output_schema.d.ts","sourceRoot":"","sources":["../../src/validation/output_schema.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,UAAU,GAAG,cAAc,GAAG,eAAe,GAAG,aAAa,GAAG,kBAAkB,CAAC;AAC/F,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,SAAS,GAAG,cAAc,GAAG,eAAe,CAAC;AACjF,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAC9C,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AACxD,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAExD,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,EAAE,aAAa,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,YAAY,EAAC,gBAAgB,EAAC,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,gCAAgC,CAAC;AAErE,MAAM,WAAW,YAAY;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,cAAc,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,oBAAoB,EAAE,CAAC;IACtC,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,YAAY,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,iBAAiB,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,mBAAmB;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE;QACb,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;QACpB,gBAAgB,EAAE,MAAM,CAAC;KAC5B,CAAC;IACF,iBAAiB,EAAE,eAAe,CAAC;CACtC;AAED,MAAM,WAAW,kBAAkB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,mBAAmB,CAAC;IAC7B,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE;QACH,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;CACL;AAMD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,GAAG;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAC,CA0C1F;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,YAAY,EAAE,GAAG,mBAAmB,CAmC3E"}