@yasserkhanorg/e2e-agents 1.3.1 → 1.4.0

package/README.md

@@ -24,29 +24,29 @@ Requires Node.js >= 20. Ships both CommonJS and ESM builds.
 
 ```bash
 # All-in-one: impact + plan + optional generate/heal
-npx e2e-ai-agents analyze --path /path/to/webapp [--generate] [--heal]
+npx e2e-ai-agents analyze --path /path/to/project [--generate] [--heal]
 
 # Analyze which flows are impacted by code changes
-npx e2e-ai-agents impact --path /path/to/webapp
+npx e2e-ai-agents impact --path /path/to/project
 
 # Generate a coverage plan with gap analysis
-npx e2e-ai-agents plan --path /path/to/webapp
+npx e2e-ai-agents plan --path /path/to/project
 
 # Generate tests for uncovered gaps (requires plan output)
-npx e2e-ai-agents generate --path /path/to/webapp
+npx e2e-ai-agents generate --path /path/to/project
 
 # Heal flaky/failing specs from a Playwright report
-npx e2e-ai-agents heal --path /path/to/webapp --traceability-report ./playwright-report.json
+npx e2e-ai-agents heal --path /path/to/project --traceability-report ./playwright-report.json
 
 # Stage generated tests, commit, and open a PR
-npx e2e-ai-agents finalize-generated-tests --path /path/to/webapp --create-pr
+npx e2e-ai-agents finalize-generated-tests --path /path/to/project --create-pr
 
 # Ingest test execution data for traceability
-npx e2e-ai-agents traceability-capture --path /path/to/webapp --traceability-report ./playwright-report.json
-npx e2e-ai-agents traceability-ingest --path /path/to/webapp --traceability-input ./traceability-input.json
+npx e2e-ai-agents traceability-capture --path /path/to/project --traceability-report ./playwright-report.json
+npx e2e-ai-agents traceability-ingest --path /path/to/project --traceability-input ./traceability-input.json
 
 # Ingest recommendation feedback for calibration
-npx e2e-ai-agents feedback --path /path/to/webapp --feedback-input ./feedback.json
+npx e2e-ai-agents feedback --path /path/to/project --feedback-input ./feedback.json
 
 # Test LLM provider connectivity
 npx e2e-ai-agents llm-health
@@ -54,6 +54,37 @@ npx e2e-ai-agents llm-health
 
 `plan` and `suggest` are aliases. `analyze` is a convenience wrapper that runs impact + plan and optionally generation/healing in one invocation. Use `--help` for all available flags.
 
+## Route-Families Training
+
+Route-families map your source files to features, test directories, and user flows. They are the context that powers accurate impact analysis. The `train` command bootstraps and maintains this manifest.
+
+```bash
+# Scan your codebase + LLM enrichment (default)
+npx e2e-ai-agents train --path /path/to/project
+
+# Offline mode (no LLM, no API key needed)
+npx e2e-ai-agents train --path /path/to/project --no-enrich
+
+# Validate accuracy against recent git history
+npx e2e-ai-agents train --path /path/to/project --validate --since HEAD~50
+
+# Full pipeline: scan + enrich + validate
+npx e2e-ai-agents train --path /path/to/project --validate --since HEAD~20
+```
+
+**Why LLM enrichment is on by default:** The manifest exists to give AI context for impact analysis, scenario suggestion, and bug detection. AI-generated context produces better AI reasoning downstream. Use `--no-enrich` for offline/free operation or to avoid sending code snippets to third-party LLM APIs.
+
+**Training loop:** Run `train` → review the generated `route-families.json` → run `train --validate` to check coverage % → fix gaps → repeat until 95%+.
+
+The `train` command:
+1. **Scans** your project structure (frontend `src/`, backend `server/`, test dirs)
+2. **Matches** source directories to test directories by name
+3. **Enriches** with LLM (priority, user flows, routes, components)
+4. **Merges** intelligently with any existing manifest (preserves human curation)
+5. **Validates** against git history to measure accuracy
+
+Output is written to `<testsRoot>/.e2e-ai-agents/route-families.json`.
+
 ## Configuration
 
 Create `e2e-ai-agents.config.json` in your project (auto-discovered):

package/dist/agent/git.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/agent/git.ts"],"names":[],"mappings":"AAyGA,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,YAAY,GAAG,QAAQ,CAAC;CAC1C;AAED,MAAM,WAAW,gBAAgB;IAC7B,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAChC;AA8CD,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,eAAe,CA2C3G"}
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/agent/git.ts"],"names":[],"mappings":"AAkHA,MAAM,WAAW,eAAe;IAC5B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,YAAY,GAAG,QAAQ,CAAC;CAC1C;AAED,MAAM,WAAW,gBAAgB;IAC7B,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAChC;AA8CD,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,eAAe,CA2C3G"}

package/dist/agent/git.js

@@ -16,6 +16,7 @@ const IGNORED_DIR_SEGMENTS = [
     '__tests__',
     '__mocks__',
     'testlib',
+    'scripts',
 ];
 // Exact filenames (basename) that are never relevant.
 const IGNORED_BASENAMES = new Set([
@@ -38,6 +39,11 @@ const IGNORED_BASENAMES = new Set([
     'jest.config.js',
     'jest.config.ts',
     'babel.config.js',
+    'webpack.config.js',
+    'Makefile',
+    'config.mk',
+    'go.mod',
+    'go.sum',
 ]);
 // Extensions that are never source code.
 const IGNORED_EXTENSIONS = new Set([
@@ -46,6 +52,8 @@ const IGNORED_EXTENSIONS = new Set([
     '.lock',
     '.png', '.jpg', '.jpeg', '.gif', '.svg', '.ico',
     '.woff', '.woff2', '.ttf', '.eot',
+    '.yml', '.yaml',
+    '.sh',
 ]);
 // File patterns that indicate test/spec files (not production code).
 const TEST_FILE_PATTERNS = [
@@ -53,6 +61,7 @@ const TEST_FILE_PATTERNS = [
     /\.test\.[tj]sx?$/,
     /_test\.go$/,
     /\.stories\.[tj]sx?$/,
+    /\.d\.ts$/,
 ];
 // Config file patterns that are not production source code.
 const CONFIG_FILE_PATTERNS = [

package/dist/cli/commands/train.d.ts

@@ -0,0 +1,3 @@
+import type { ParsedArgs } from '../types.js';
+export declare function runTrainCommand(args: ParsedArgs, autoConfig?: string): Promise<void>;
+//# sourceMappingURL=train.d.ts.map

package/dist/cli/commands/train.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"train.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/train.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,aAAa,CAAC;AA6H5C,wBAAsB,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA6K1F"}

package/dist/cli/commands/train.js

@@ -0,0 +1,307 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+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.runTrainCommand = runTrainCommand;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const readline = __importStar(require("readline"));
+const config_js_1 = require("../../agent/config.js");
+const route_families_js_1 = require("../../knowledge/route_families.js");
+const provider_factory_js_1 = require("../../provider_factory.js");
+const scanner_js_1 = require("../../training/scanner.js");
+const merger_js_1 = require("../../training/merger.js");
+const enricher_js_1 = require("../../training/enricher.js");
+const validator_js_1 = require("../../training/validator.js");
+class TrainError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'TrainError';
+    }
+}
+const MAX_BUDGET_USD = 10;
+/**
+ * Resolves train-specific options from CLI args.
+ * Unlike other commands (analyze, plan, heal) that use the shared resolveConfig()
+ * for full pipeline configuration, train only needs appPath and testsRoot.
+ * We call resolveConfig() solely to extract testsRoot from the config file.
+ */
+function resolveTrainOptions(args, autoConfig) {
+    const appPath = args.path || '.';
+    let testsRoot = args.testsRoot || appPath;
+    // Try to resolve testsRoot from config
+    if (autoConfig) {
+        try {
+            const { config } = (0, config_js_1.resolveConfig)(process.cwd(), autoConfig, {
+                path: appPath,
+                testsRoot: args.testsRoot,
+            });
+            testsRoot = config.testsRoot || config.path || appPath;
+        }
+        catch {
+            // use defaults
+        }
+    }
+    const outputPath = args.trainOutput ||
+        (0, path_1.join)(testsRoot, '.e2e-ai-agents', 'route-families.json');
+    // Validate --pr is a positive integer
+    if (args.trainPr !== undefined && (!Number.isInteger(args.trainPr) || args.trainPr <= 0)) {
+        throw new TrainError('--pr must be a positive integer');
+    }
+    // Validate --pr and --since are mutually exclusive
+    if (args.trainPr && args.gitSince) {
+        throw new TrainError('--pr and --since are mutually exclusive.');
+    }
+    // Validate --since format (reject leading '-' to prevent git flag injection)
+    const since = args.gitSince || 'HEAD~20';
+    if (/^-/.test(since) || !/^[a-zA-Z0-9_.~^@\/-]+$/.test(since)) {
+        throw new TrainError(`Invalid git ref: ${since}`);
+    }
+    // Validate budget bounds
+    const budget = args.budgetUSD || 0.50;
+    if (budget <= 0) {
+        throw new TrainError('--budget-usd must be a positive number');
+    }
+    if (budget > MAX_BUDGET_USD) {
+        throw new TrainError(`Budget exceeds maximum of $${MAX_BUDGET_USD}. Use a lower --budget-usd value.`);
+    }
+    const resolvedAppPath = (0, path_1.resolve)(appPath);
+    const resolvedTestsRoot = (0, path_1.resolve)(testsRoot);
+    const resolvedOutputPath = (0, path_1.resolve)(outputPath);
+    // Validate --path is a real project
+    if (!(0, fs_1.existsSync)(resolvedAppPath)) {
+        throw new TrainError(`Project root not found: ${resolvedAppPath}`);
+    }
+    // Validate --output is within project boundary (append separator to prevent prefix attacks)
+    const inApp = resolvedOutputPath === resolvedAppPath || resolvedOutputPath.startsWith(resolvedAppPath + '/');
+    const inTests = resolvedOutputPath === resolvedTestsRoot || resolvedOutputPath.startsWith(resolvedTestsRoot + '/');
+    if (!inApp && !inTests) {
+        throw new TrainError(`Output path must be within the project root or tests root: ${resolvedOutputPath}`);
+    }
+    return {
+        appPath: resolvedAppPath,
+        testsRoot: resolvedTestsRoot,
+        enrich: args.trainEnrich !== false,
+        validate: args.trainValidate || false,
+        since,
+        pr: args.trainPr,
+        outputPath: resolvedOutputPath,
+        dryRun: args.dryRun || false,
+        yes: args.trainYes || false,
+        budgetUSD: budget,
+    };
+}
+function ask(rl, question, defaultValue) {
+    const suffix = defaultValue ? ` (${defaultValue})` : '';
+    return new Promise((res) => {
+        rl.question(`${question}${suffix}: `, (answer) => {
+            res(answer.trim() || defaultValue || '');
+        });
+    });
+}
+function serializeManifest(manifest) {
+    const output = {
+        families: manifest.families.map((f) => {
+            // Remove undefined/empty optional fields for clean JSON
+            const cleaned = { ...f };
+            const optionalArrays = ['pageObjects', 'components', 'webappPaths', 'serverPaths', 'specDirs', 'cypressSpecDirs', 'tags', 'userFlows', 'features'];
+            for (const key of optionalArrays) {
+                if (!cleaned[key] || (Array.isArray(cleaned[key]) && cleaned[key].length === 0)) {
+                    delete cleaned[key];
+                }
+            }
+            if (!cleaned.priority)
+                delete cleaned.priority;
+            return cleaned;
+        }),
+    };
+    return JSON.stringify(output, null, 2) + '\n';
+}
+async function runTrainCommand(args, autoConfig) {
+    const opts = resolveTrainOptions(args, autoConfig);
+    console.log('');
+    console.log('  e2e-ai-agents train');
+    console.log('  ===================');
+    console.log('');
+    // ---------- Phase 1: Deterministic scan ----------
+    console.log('  Scanning project structure...');
+    const scanResult = (0, scanner_js_1.scanProject)(opts.appPath);
+    console.log(`  Found ${scanResult.stats.totalSourceFiles} source files, ${scanResult.stats.totalTestFiles} test files`);
+    console.log(`  Discovered ${scanResult.families.length} candidate families`);
+    if (scanResult.families.length === 0) {
+        console.log('');
+        console.log('  No families discovered. Make sure your project has recognizable');
+        console.log('  source directories (src/, server/, app/) and test directories');
+        console.log('  (tests/, e2e/, specs/) with matching names.');
+        return;
+    }
+    // ---------- Phase 2: Merge with existing ----------
+    const existing = (0, route_families_js_1.loadRouteFamilyManifest)(opts.testsRoot);
+    if (existing) {
+        console.log(`  Found existing manifest with ${existing.families.length} families`);
+    }
+    let mergeResult = (0, merger_js_1.mergeFamilies)(existing, scanResult.families);
+    console.log(`  Merge: ${mergeResult.summary}`);
+    // ---------- Phase 3: Stale detection ----------
+    if (mergeResult.manifest.families.length > 0) {
+        const stale = (0, merger_js_1.detectStaleFamilies)(mergeResult.manifest, opts.appPath);
+        if (stale.length > 0) {
+            console.log('');
+            console.log(`  Stale families detected (${stale.length}):`);
+            for (const id of stale) {
+                console.log(`    ${id} — paths no longer exist`);
+            }
+            if (!opts.yes && !opts.dryRun && process.stdin.isTTY) {
+                const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+                try {
+                    const answer = await ask(rl, '  Remove stale families? [y/N]', 'N');
+                    if (answer.toLowerCase() === 'y') {
+                        const staleSet = new Set(stale);
+                        mergeResult.manifest.families = mergeResult.manifest.families.filter((f) => !staleSet.has(f.id));
+                        mergeResult.staleFamilies = stale;
+                        console.log(`  Removed ${stale.length} stale families`);
+                    }
+                }
+                finally {
+                    rl.close();
+                }
+            }
+        }
+    }
+    // ---------- Phase 4: LLM Enrichment ----------
+    if (opts.enrich) {
+        console.log('');
+        console.log('  Enriching with LLM...');
+        try {
+            const provider = await provider_factory_js_1.LLMProviderFactory.createFromEnv();
+            const enrichResult = await (0, enricher_js_1.enrichFamilies)(mergeResult.manifest.families, scanResult.families, opts.appPath, provider, opts.budgetUSD);
+            mergeResult.manifest.families = enrichResult.enrichedFamilies;
+            console.log(`  Enriched ${enrichResult.enrichedFamilies.length} families (${enrichResult.tokensUsed} tokens, ~$${enrichResult.costUSD})`);
+            if (enrichResult.skippedFamilies.length > 0) {
+                console.log(`  Skipped ${enrichResult.skippedFamilies.length} families (budget limit)`);
+            }
+        }
+        catch (error) {
+            console.warn(`  LLM enrichment failed: ${error instanceof Error ? error.message : String(error)}`);
+            console.warn('  Continuing with deterministic results. Use --no-enrich to skip LLM.');
+        }
+    }
+    // ---------- Phase 5: Write manifest ----------
+    console.log('');
+    const json = serializeManifest(mergeResult.manifest);
+    if (opts.dryRun) {
+        console.log('  Dry run — proposed manifest:');
+        console.log('');
+        console.log(json);
+    }
+    else {
+        const dir = (0, path_1.dirname)(opts.outputPath);
+        if (!(0, fs_1.existsSync)(dir)) {
+            (0, fs_1.mkdirSync)(dir, { recursive: true });
+        }
+        const tmpPath = `${opts.outputPath}.tmp`;
+        (0, fs_1.writeFileSync)(tmpPath, json, 'utf-8');
+        (0, fs_1.renameSync)(tmpPath, opts.outputPath);
+        console.log(`  Wrote ${opts.outputPath}`);
+        console.log(`  ${mergeResult.manifest.families.length} families`);
+    }
+    // ---------- Phase 6: Report unmatched ----------
+    if (scanResult.unmatchedSourceDirs.length > 0 || scanResult.unmatchedTestDirs.length > 0) {
+        console.log('');
+        console.log('  Unmatched (review manually):');
+        for (const dir of scanResult.unmatchedSourceDirs.slice(0, 10)) {
+            console.log(`    source: ${dir.relativePath}`);
+        }
+        for (const dir of scanResult.unmatchedTestDirs.slice(0, 10)) {
+            console.log(`    test:   ${dir.relativePath}`);
+        }
+        if (scanResult.unmatchedSourceDirs.length + scanResult.unmatchedTestDirs.length > 20) {
+            console.log('    ... and more');
+        }
+    }
+    // ---------- Phase 7: Validation (optional) ----------
+    if (opts.validate) {
+        if (opts.pr) {
+            console.log('');
+            console.log(`  Validating against PR #${opts.pr}...`);
+            // Check for gh CLI
+            const { execFileSync } = await import('child_process');
+            try {
+                execFileSync('gh', ['--version'], { stdio: 'pipe' });
+            }
+            catch {
+                throw new TrainError('--pr requires the GitHub CLI (gh). Install: https://cli.github.com/');
+            }
+            // Fetch PR changed files via gh CLI
+            let prFiles;
+            try {
+                const output = execFileSync('gh', ['pr', 'view', String(opts.pr), '--json', 'files', '-q', '.files[].path'], {
+                    cwd: opts.appPath,
+                    encoding: 'utf-8',
+                    stdio: ['pipe', 'pipe', 'pipe'],
+                });
+                prFiles = output.trim().split('\n').filter(Boolean);
+            }
+            catch (error) {
+                throw new TrainError(`Error fetching PR #${opts.pr}: ${error instanceof Error ? error.message : String(error)}`);
+            }
+            if (prFiles.length === 0) {
+                console.log('  No files found in PR.');
+            }
+            else {
+                const validation = (0, validator_js_1.validateCommit)(mergeResult.manifest, prFiles, `PR#${opts.pr}`, `PR #${opts.pr}`);
+                const report = (0, validator_js_1.buildValidationReport)([validation], mergeResult.manifest);
+                console.log('');
+                console.log((0, validator_js_1.formatValidationReport)(report));
+            }
+        }
+        else {
+            console.log('');
+            console.log(`  Validating against git history (${opts.since})...`);
+            const commits = (0, validator_js_1.getCommitFiles)(opts.appPath, opts.since);
+            if (commits.length === 0) {
+                console.log('  No commits found in range.');
+            }
+            else {
+                const validations = commits.map((c) => (0, validator_js_1.validateCommit)(mergeResult.manifest, c.files, c.hash, c.message));
+                const report = (0, validator_js_1.buildValidationReport)(validations, mergeResult.manifest);
+                console.log('');
+                console.log((0, validator_js_1.formatValidationReport)(report));
+            }
+        }
+    }
+    console.log('');
+}

package/dist/cli/parse_args.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse_args.d.ts","sourceRoot":"","sources":["../../src/cli/parse_args.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAU,UAAU,EAAC,MAAM,YAAY,CAAC;AAEpD,eAAO,MAAM,iBAAiB,UAA8D,CAAC;AAE7F,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAmBlF;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAmBtE;AAqID,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CA4EpD"}
+{"version":3,"file":"parse_args.d.ts","sourceRoot":"","sources":["../../src/cli/parse_args.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAU,UAAU,EAAC,MAAM,YAAY,CAAC;AAEpD,eAAO,MAAM,iBAAiB,UAA8D,CAAC;AAE7F,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAmBlF;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAmBtE;AA2ID,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CA4EpD"}

package/dist/cli/parse_args.js

@@ -67,6 +67,10 @@ const FLAGS = {
     '--generate': { key: 'analyzeGenerate', type: 'boolean' },
     '--heal': { key: 'analyzeHeal', type: 'boolean' },
     '--no-ai': { key: 'noAi', type: 'boolean' },
+    '--enrich': { key: 'trainEnrich', type: 'boolean' },
+    '--no-enrich': { key: 'trainEnrich', type: 'boolean-false' },
+    '--validate': { key: 'trainValidate', type: 'boolean' },
+    '--yes': { key: 'trainYes', type: 'boolean', aliases: ['-y'] },
     '--mattermost': { key: 'profile', type: 'boolean', transform: () => 'mattermost' },
     // -- string flags --
     '--config': { key: 'configPath', type: 'string' },
@@ -96,6 +100,7 @@ const FLAGS = {
     '--generate-output': { key: 'analyzeGenerateOutputDir', type: 'string' },
     '--heal-report': { key: 'analyzeHealReport', type: 'string' },
     '--flow-catalog': { key: 'flowCatalogPath', type: 'string' },
+    '--output': { key: 'trainOutput', type: 'string' },
     // -- number flags (with isFinite guard) --
     '--pipeline-scenarios': { key: 'pipelineScenarios', type: 'number' },
     '--time': { key: 'timeLimitMinutes', type: 'number' },
@@ -107,6 +112,7 @@ const FLAGS = {
     '--traceability-min-hits': { key: 'traceabilityMinHits', type: 'number' },
     '--traceability-max-files-per-test': { key: 'traceabilityMaxFilesPerTest', type: 'number' },
     '--traceability-max-age-days': { key: 'traceabilityMaxAgeDays', type: 'number' },
+    '--pr': { key: 'trainPr', type: 'number' },
     // -- number-raw flags (no isFinite guard, assigned directly via Number()) --
     '--max-attempts': { key: 'maxAttempts', type: 'number-raw', transform: (v) => parseInt(v, 10) },
     '--pipeline-mcp-timeout-ms': { key: 'pipelineMcpTimeoutMs', type: 'number-raw' },
@@ -140,7 +146,7 @@ const COMMANDS = new Set([
     'init', 'impact', 'plan', 'heal', 'suggest', 'generate',
     'finalize-generated-tests', 'feedback',
     'traceability-capture', 'traceability-ingest',
-    'analyze', 'llm-health',
+    'analyze', 'llm-health', 'train',
 ]);
 // ---------------------------------------------------------------------------
 // Parser

package/dist/cli/types.d.ts

@@ -1,5 +1,5 @@
 import type { AnalysisProfile, FrameworkType } from '../agent/config.js';
-export type Command = 'init' | 'impact' | 'plan' | 'heal' | 'suggest' | 'generate' | 'finalize-generated-tests' | 'feedback' | 'traceability-capture' | 'traceability-ingest' | 'analyze' | 'llm-health';
+export type Command = 'init' | 'impact' | 'plan' | 'heal' | 'suggest' | 'generate' | 'finalize-generated-tests' | 'feedback' | 'traceability-capture' | 'traceability-ingest' | 'analyze' | 'llm-health' | 'train';
 export interface ParsedArgs {
     command?: Command;
     configPath?: string;
@@ -66,5 +66,10 @@ export interface ParsedArgs {
     noAi?: boolean;
     maxAttempts?: number;
     generateScenarios?: string;
+    trainEnrich?: boolean;
+    trainValidate?: boolean;
+    trainPr?: number;
+    trainOutput?: string;
+    trainYes?: boolean;
 }
 //# sourceMappingURL=types.d.ts.map

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

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

package/dist/cli/usage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/cli/usage.ts"],"names":[],"mappings":"AAGA,wBAAgB,UAAU,IAAI,IAAI,CAmFjC"}
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/cli/usage.ts"],"names":[],"mappings":"AAGA,wBAAgB,UAAU,IAAI,IAAI,CAyFjC"}

package/dist/cli/usage.js

@@ -17,11 +17,12 @@ function printUsage() {
         '  e2e-ai-agents traceability-ingest --path <app-root> --traceability-input <json>',
         '  e2e-ai-agents generate [--scenarios <path|json>] [--max-attempts <n>] [--dry-run]',
         '  e2e-ai-agents analyze --path <app-root> [--tests-root <path>] [--since <ref>] [--generate] [--generate-output <dir>] [--heal] [--heal-report <json>]',
+        '  e2e-ai-agents train --path <project-root> [--no-enrich] [--validate] [--since <ref>] [--pr <num>]',
         '  e2e-ai-agents llm-health',
         '',
         'Options:',
         '  --config <path>       Path to e2e-ai-agents.config.json (auto-discovered if present)',
-        '  --path <app-root>     Path to the web app (required)',
+        '  --path <project-root> Path to the project root (scans both frontend and backend)',
         '  --profile <name>     default | mattermost',
         '  --mattermost         Shortcut for --profile mattermost',
         '  --tests-root <path>   Path to tests root (optional)',
@@ -82,6 +83,11 @@ function printUsage() {
         '  --scenarios <path|json>  Scenarios file/JSON for generate command',
         '  --apply               Apply data-testid patches and generate tests',
         '                        (legacy shortcut; prefer approve-and-generate)',
+        '  --no-enrich              Disable LLM enrichment (offline mode, train command)',
+        '  --validate               Validate manifest against git history (train command)',
+        '  --pr <number>            GitHub PR number for validation (requires gh CLI)',
+        '  --yes, -y                Non-interactive mode (train command)',
+        '  --output <path>          Output path for route-families.json (train command)',
         '  --help                Show help',
     ].join('\n'));
 }

package/dist/cli.js

@@ -16,6 +16,7 @@ const impact_js_1 = require("./cli/commands/impact.js");
 const plan_js_1 = require("./cli/commands/plan.js");
 const generate_js_1 = require("./cli/commands/generate.js");
 const init_js_1 = require("./cli/commands/init.js");
+const train_js_1 = require("./cli/commands/train.js");
 async function main() {
     const args = (0, parse_args_js_1.parseArgs)(process.argv.slice(2));
     const autoConfig = (0, parse_args_js_1.resolveAutoConfig)(args);
@@ -24,6 +25,10 @@ async function main() {
         await (0, init_js_1.runInitCommand)(hasYes);
         return;
     }
+    if (args.command === 'train') {
+        await (0, train_js_1.runTrainCommand)(args, autoConfig);
+        return;
+    }
     if (args.help || !args.command) {
         (0, usage_js_1.printUsage)();
         process.exit(args.command ? 0 : 1);

package/dist/esm/agent/git.js

@@ -13,6 +13,7 @@ const IGNORED_DIR_SEGMENTS = [
     '__tests__',
     '__mocks__',
     'testlib',
+    'scripts',
 ];
 // Exact filenames (basename) that are never relevant.
 const IGNORED_BASENAMES = new Set([
@@ -35,6 +36,11 @@ const IGNORED_BASENAMES = new Set([
     'jest.config.js',
     'jest.config.ts',
     'babel.config.js',
+    'webpack.config.js',
+    'Makefile',
+    'config.mk',
+    'go.mod',
+    'go.sum',
 ]);
 // Extensions that are never source code.
 const IGNORED_EXTENSIONS = new Set([
@@ -43,6 +49,8 @@ const IGNORED_EXTENSIONS = new Set([
     '.lock',
     '.png', '.jpg', '.jpeg', '.gif', '.svg', '.ico',
     '.woff', '.woff2', '.ttf', '.eot',
+    '.yml', '.yaml',
+    '.sh',
 ]);
 // File patterns that indicate test/spec files (not production code).
 const TEST_FILE_PATTERNS = [
@@ -50,6 +58,7 @@ const TEST_FILE_PATTERNS = [
     /\.test\.[tj]sx?$/,
     /_test\.go$/,
     /\.stories\.[tj]sx?$/,
+    /\.d\.ts$/,
 ];
 // Config file patterns that are not production source code.
 const CONFIG_FILE_PATTERNS = [