@yasserkhanorg/e2e-agents 1.8.4 → 1.9.5

package/dist/cli/commands/plan_crew.js

@@ -95,11 +95,11 @@ function buildCrewMarkdown(crew, plan) {
     const totalCases = crew.testDesigns.reduce((n, td) => n + td.testCases.length, 0);
     const gapFamilies = new Set((plan?.gapDetails ?? []).map((g) => g.id));
     const lines = [
-        '### Crew Insights',
+        '### Crew Analysis — What to Test',
         '',
-        `Workflow: \`${crew.workflow}\``,
-        `Impacted flows: **${crew.summary.impactedFlows}**`,
-        `Strategy entries: **${crew.summary.strategyEntries}**`,
+        `Crew analyzed the diff and recommends what to verify before merging.`,
+        '',
+        `Impacted flows: **${crew.summary.impactedFlows}** | Strategy entries: **${crew.summary.strategyEntries}**`,
     ];
     if (totalCases > 0) {
         const gapDesigns = gapFamilies.size > 0
@@ -184,37 +184,48 @@ function buildCrewTestPlan(crew, plan) {
     const gapCases = gapDesigns.reduce((n, td) => n + td.testCases.length, 0);
     const coveredCases = coveredDesigns.reduce((n, td) => n + td.testCases.length, 0);
     const lines = [
-        '# Crew Test Plan',
+        '# Crew Test Plan — What to Verify',
+        '',
+        '> **This is a test recommendation, not a test execution report.**',
+        '> Crew analyzed the code diff and identified what needs to be tested.',
+        '> Use this plan to guide manual QA or write automated E2E tests.',
         '',
-        `> Auto-generated by e2e-agents crew (\`${crew.workflow}\` workflow)`,
+        `_Auto-generated by e2e-agents crew (\`${crew.workflow}\` workflow)_`,
         '',
         '## Summary',
         '',
         `| Metric | Count |`,
         `|--------|-------|`,
-        `| Gap flows (missing tests) | ${gapStrategies.length} flows${hasTestDesigns ? `, **${gapCases} test cases**` : ''} |`,
-        `| Covered flows (expansion) | ${coveredStrategies.length} flows${hasTestDesigns ? `, ${coveredCases} test cases` : ''} |`,
-        `| Total strategy entries | ${crew.strategyEntries.length} flows${hasTestDesigns ? `, ${totalCases} test cases` : ''} |`,
+        `| Gap flows — **no existing tests, must verify** | ${gapStrategies.length} flows${hasTestDesigns ? `, **${gapCases} test cases**` : ''} |`,
+        `| Covered flows — **has tests, verify no regressions** | ${coveredStrategies.length} flows${hasTestDesigns ? `, ${coveredCases} test cases` : ''} |`,
+        `| Total | ${crew.strategyEntries.length} flows${hasTestDesigns ? `, ${totalCases} test cases` : ''} |`,
         `| High-risk cross-impacts | ${crew.summary.highRiskCrossImpacts} |`,
         `| AI cost | $${crew.summary.totalCostUSD.toFixed(4)} |`,
         '',
     ];
     // ── Gap flows ──
     if (gapStrategies.length > 0) {
-        lines.push('## Priority: Gap Flows (Missing Tests)');
+        lines.push('## Action Required: Gap Flows (No Existing Tests)');
         lines.push('');
-        lines.push('These flows have **no existing E2E coverage** and should be addressed first.');
+        lines.push('These flows have **no automated E2E coverage**. Before merging, either:');
+        lines.push('1. **Write E2E tests** for the critical scenarios below, or');
+        lines.push('2. **Manually verify** each flow works as expected');
         lines.push('');
         for (const strategy of gapStrategies) {
             const td = crew.testDesigns.find((d) => d.flowId === strategy.flowId);
             lines.push(`### ${strategy.flowName}`);
             lines.push('');
-            lines.push(`Strategy: **${strategy.approach}** | Priority: **${strategy.priority}** | Cross-impact risk: **${strategy.crossImpactRisk}**`);
-            if (strategy.rationale) {
-                lines.push(`> ${strategy.rationale}`);
+            const actionVerb = strategy.approach === 'full-test' ? 'Write full E2E test or verify manually'
+                : strategy.approach === 'smoke-test' ? 'Smoke-test manually or add basic E2E coverage'
+                    : strategy.approach === 'manual-review' ? 'Manual review required'
+                        : 'Can skip — low risk';
+            lines.push(`**${strategy.priority}** | Recommended: **${strategy.approach}** | Cross-impact risk: **${strategy.crossImpactRisk}**`);
+            lines.push(`> ${actionVerb}`);
+            if (strategy.rationale && !strategy.rationale.includes('Default strategy')) {
+                lines.push(`> Rationale: ${strategy.rationale}`);
             }
             if (strategy.testCategories.length > 0) {
-                lines.push(`Test categories: ${strategy.testCategories.join(', ')}`);
+                lines.push(`> Test types to cover: ${strategy.testCategories.join(', ')}`);
             }
             lines.push('');
             // If test designs exist, show P0/P1 cases
@@ -249,9 +260,10 @@ function buildCrewTestPlan(crew, plan) {
     }
     // ── Covered flows ──
     if (coveredStrategies.length > 0) {
-        lines.push('## Covered Flows (Regression / Expansion)');
+        lines.push('## Regression Check: Covered Flows (Already Have Tests)');
         lines.push('');
-        lines.push('These flows already have specs. Verify changes haven\'t introduced regressions.');
+        lines.push('These flows have existing E2E specs. The existing tests should catch regressions automatically.');
+        lines.push('**No manual action required** unless CI tests fail on these flows.');
         lines.push('');
         for (const strategy of coveredStrategies) {
             const td = crew.testDesigns.find((d) => d.flowId === strategy.flowId);
@@ -259,8 +271,8 @@ function buildCrewTestPlan(crew, plan) {
             const detail = caseCount > 0 ? ` | ${caseCount} cases` : '';
             lines.push(`<details><summary><strong>${strategy.flowName}</strong> — ${strategy.approach}${detail} (${strategy.priority})</summary>`);
             lines.push('');
-            lines.push(`Cross-impact risk: ${strategy.crossImpactRisk}`);
-            if (strategy.rationale) {
+            lines.push(`Existing tests should cover this. Cross-impact risk: ${strategy.crossImpactRisk}`);
+            if (strategy.rationale && !strategy.rationale.includes('Default strategy')) {
                 lines.push(`> ${strategy.rationale}`);
             }
             if (strategy.testCategories.length > 0) {
@@ -280,9 +292,9 @@ function buildCrewTestPlan(crew, plan) {
     // ── Cross-impacts ──
     const highRisk = crew.crossImpacts.filter((ci) => ci.riskLevel === 'high');
     if (highRisk.length > 0) {
-        lines.push('## High-Risk Cross-Impacts');
+        lines.push('## High-Risk Cross-Impacts — Verify Before Release');
         lines.push('');
-        lines.push('These cross-family dependencies should be verified during release testing:');
+        lines.push('Changes in one area may break these related areas. Manually verify or ensure E2E tests cover both sides:');
         lines.push('');
         for (const ci of highRisk) {
             lines.push(`- **${ci.sourceFamily}** → **${ci.affectedFamily}**: ${ci.sharedDependency}`);

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

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

package/dist/cli/commands/train.js

@@ -44,10 +44,13 @@ 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 logger_js_1 = require("../../logger.js");
+const version_js_1 = require("../../version.js");
 const scanner_js_1 = require("../../training/scanner.js");
+const kg_scanner_js_1 = require("../../training/kg_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");
+const kg_bridge_js_1 = require("../../knowledge/kg_bridge.js");
 class TrainError extends Error {
     constructor(message) {
         super(message);
@@ -157,24 +160,6 @@ function ask(rl, question, 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);
     const totalTimer = logger_js_1.logger.timer('train-total');
@@ -187,12 +172,22 @@ async function runTrainCommand(args, autoConfig) {
     logger_js_1.logger.info('e2e-ai-agents train');
     logger_js_1.logger.info('===================');
     // ---------- Phase 1: Deterministic scan ----------
+    // Prefer knowledge graph when available
+    const kg = (0, kg_bridge_js_1.loadKnowledgeGraph)(opts.appPath);
     logger_js_1.logger.info('Scanning project structure...');
     if (opts.serverRoot) {
         logger_js_1.logger.info(`Server root: ${opts.serverRoot}`);
     }
     const scanTimer = logger_js_1.logger.timer('scan');
-    const scanResult = (0, scanner_js_1.scanProject)(opts.appPath, opts.testsRoot !== opts.appPath ? opts.testsRoot : undefined, opts.serverRoot, opts.gitRepoRoot);
+    let scanResult;
+    if (kg) {
+        logger_js_1.logger.info('Using knowledge graph for scanning (found .understand-anything/knowledge-graph.json)');
+        scanResult = (0, kg_scanner_js_1.scanFromKnowledgeGraph)(kg);
+        logger_js_1.logger.info(`KG: ${kg.nodes.length} nodes, ${kg.edges.length} edges`);
+    }
+    else {
+        scanResult = (0, scanner_js_1.scanProject)(opts.appPath, opts.testsRoot !== opts.appPath ? opts.testsRoot : undefined, opts.serverRoot, opts.gitRepoRoot);
+    }
     timings.scan = scanTimer.end();
     logger_js_1.logger.info(`Found ${scanResult.stats.totalSourceFiles} source files, ${scanResult.stats.totalTestFiles} test files`);
     logger_js_1.logger.info(`Discovered ${scanResult.families.length} candidate families`);
@@ -269,7 +264,7 @@ async function runTrainCommand(args, autoConfig) {
         timings.enrich = enrichTimer.end();
     }
     // ---------- Phase 5: Write manifest ----------
-    const json = serializeManifest(mergeResult.manifest);
+    const json = (0, route_families_js_1.serializeManifest)(mergeResult.manifest);
     if (opts.dryRun) {
         logger_js_1.logger.info('Dry run — proposed manifest:');
         console.log(json);
@@ -368,7 +363,7 @@ async function runTrainCommand(args, autoConfig) {
         const reportDir = (0, path_1.dirname)(opts.outputPath);
         const trainReport = {
             timestamp: new Date().toISOString(),
-            version: '1.7.0',
+            version: (0, version_js_1.getVersion)(),
             timings,
             families: {
                 total: mergeResult.manifest.families.length,

package/dist/cli/defaults.d.ts

@@ -0,0 +1,35 @@
+import type { FrameworkType } from '../agent/config.js';
+export interface ResolvedDefaults {
+    path: string;
+    testsRoot: string;
+    framework: FrameworkType;
+    since: string;
+}
+/**
+ * Detect the test framework from package.json dependencies.
+ */
+export declare function detectFramework(appPath: string): FrameworkType;
+/**
+ * Detect the tests root directory by scanning common conventions.
+ */
+export declare function detectTestsRoot(appPath: string): string | undefined;
+/**
+ * Detect the git default branch for diffing.
+ * Returns origin/<branch> format.
+ */
+export declare function detectGitDefaultBranch(appPath: string): string;
+/**
+ * Detect the project root by walking up to find package.json or .git.
+ */
+export declare function detectProjectRoot(startDir: string): string;
+/**
+ * Resolve defaults for CLI commands that need path/testsRoot/framework/since.
+ * Explicit values from CLI flags take precedence over detected values.
+ */
+export declare function resolveDefaults(explicit: {
+    path?: string;
+    testsRoot?: string;
+    framework?: FrameworkType;
+    gitSince?: string;
+}): ResolvedDefaults;
+//# sourceMappingURL=defaults.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/cli/defaults.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,oBAAoB,CAAC;AAEtD,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,aAAa,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAsB9D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAoBnE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA4B9D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAa1D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,gBAAgB,CAOnB"}

package/dist/cli/defaults.js

@@ -0,0 +1,125 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectFramework = detectFramework;
+exports.detectTestsRoot = detectTestsRoot;
+exports.detectGitDefaultBranch = detectGitDefaultBranch;
+exports.detectProjectRoot = detectProjectRoot;
+exports.resolveDefaults = resolveDefaults;
+const fs_1 = require("fs");
+const child_process_1 = require("child_process");
+const path_1 = require("path");
+/**
+ * Detect the test framework from package.json dependencies.
+ */
+function detectFramework(appPath) {
+    const resolvedPath = (0, path_1.resolve)(appPath);
+    const pkgPath = (0, path_1.join)(resolvedPath, 'package.json');
+    if (!(0, fs_1.existsSync)(pkgPath)) {
+        return 'auto';
+    }
+    try {
+        const pkg = JSON.parse((0, fs_1.readFileSync)(pkgPath, 'utf-8'));
+        const allDeps = { ...(pkg.dependencies || {}), ...(pkg.devDependencies || {}) };
+        if (allDeps['@playwright/test'] || allDeps.playwright) {
+            return 'playwright';
+        }
+        if (allDeps.cypress) {
+            return 'cypress';
+        }
+        if (allDeps['selenium-webdriver'] || allDeps.webdriverio) {
+            return 'selenium';
+        }
+    }
+    catch {
+        // ignore malformed package.json
+    }
+    return 'auto';
+}
+/**
+ * Detect the tests root directory by scanning common conventions.
+ */
+function detectTestsRoot(appPath) {
+    const resolvedPath = (0, path_1.resolve)(appPath);
+    const candidates = [
+        'e2e-tests/playwright',
+        'e2e-tests',
+        'e2e',
+        'tests/e2e',
+        'test/e2e',
+        'tests',
+        'test',
+        'specs',
+        'playwright',
+        'cypress',
+    ];
+    for (const candidate of candidates) {
+        if ((0, fs_1.existsSync)((0, path_1.join)(resolvedPath, candidate))) {
+            return candidate;
+        }
+    }
+    return undefined;
+}
+/**
+ * Detect the git default branch for diffing.
+ * Returns origin/<branch> format.
+ */
+function detectGitDefaultBranch(appPath) {
+    try {
+        // Try to find the remote HEAD branch first
+        const remoteInfo = (0, child_process_1.execFileSync)('git', ['remote', 'show', 'origin'], {
+            cwd: (0, path_1.resolve)(appPath),
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+            timeout: 5000,
+        });
+        const headMatch = remoteInfo.match(/HEAD branch:\s*(.+)/);
+        if (headMatch) {
+            return `origin/${headMatch[1].trim()}`;
+        }
+    }
+    catch {
+        // fallback to current branch
+    }
+    try {
+        const result = (0, child_process_1.execFileSync)('git', ['rev-parse', '--abbrev-ref', 'HEAD'], {
+            cwd: (0, path_1.resolve)(appPath),
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+            timeout: 5000,
+        }).trim();
+        return `origin/${result}`;
+    }
+    catch {
+        return 'origin/main';
+    }
+}
+/**
+ * Detect the project root by walking up to find package.json or .git.
+ */
+function detectProjectRoot(startDir) {
+    let current = (0, path_1.resolve)(startDir);
+    while (true) {
+        if ((0, fs_1.existsSync)((0, path_1.join)(current, 'package.json')) || (0, fs_1.existsSync)((0, path_1.join)(current, '.git'))) {
+            return current;
+        }
+        const parent = (0, path_1.resolve)(current, '..');
+        if (parent === current) {
+            break;
+        }
+        current = parent;
+    }
+    return startDir;
+}
+/**
+ * Resolve defaults for CLI commands that need path/testsRoot/framework/since.
+ * Explicit values from CLI flags take precedence over detected values.
+ */
+function resolveDefaults(explicit) {
+    const path = explicit.path || detectProjectRoot(process.cwd());
+    const testsRoot = explicit.testsRoot || detectTestsRoot(path) || '.';
+    const framework = explicit.framework || detectFramework(path);
+    const since = explicit.gitSince || detectGitDefaultBranch(path);
+    return { path, testsRoot, framework, since };
+}

package/dist/cli/errors.d.ts

@@ -0,0 +1,27 @@
+/**
+ * CLI Error types with structured exit codes.
+ *
+ * Exit codes:
+ *   0 = success
+ *   1 = general/user error (bad args, missing config, invalid input)
+ *   2 = budget exceeded
+ *   3 = LLM provider unavailable (API down, auth failure)
+ *   4 = invalid manifest or config file
+ */
+export declare const EXIT_CODES: {
+    readonly SUCCESS: 0;
+    readonly GENERAL_ERROR: 1;
+    readonly BUDGET_EXCEEDED: 2;
+    readonly PROVIDER_UNAVAILABLE: 3;
+    readonly INVALID_CONFIG: 4;
+};
+export type ExitCode = typeof EXIT_CODES[keyof typeof EXIT_CODES];
+export declare class CliError extends Error {
+    readonly exitCode: ExitCode;
+    constructor(message: string, exitCode?: ExitCode);
+}
+/**
+ * Classify an unknown error into the appropriate exit code.
+ */
+export declare function classifyError(error: unknown): ExitCode;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/cli/errors.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AAEH,eAAO,MAAM,UAAU;;;;;;CAMb,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,OAAO,UAAU,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAElE,qBAAa,QAAS,SAAQ,KAAK;aAGX,QAAQ,EAAE,QAAQ;gBADlC,OAAO,EAAE,MAAM,EACC,QAAQ,GAAE,QAAmC;CAKpE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CA0BtD"}

package/dist/cli/errors.js

@@ -0,0 +1,57 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CliError = exports.EXIT_CODES = void 0;
+exports.classifyError = classifyError;
+/**
+ * CLI Error types with structured exit codes.
+ *
+ * Exit codes:
+ *   0 = success
+ *   1 = general/user error (bad args, missing config, invalid input)
+ *   2 = budget exceeded
+ *   3 = LLM provider unavailable (API down, auth failure)
+ *   4 = invalid manifest or config file
+ */
+exports.EXIT_CODES = {
+    SUCCESS: 0,
+    GENERAL_ERROR: 1,
+    BUDGET_EXCEEDED: 2,
+    PROVIDER_UNAVAILABLE: 3,
+    INVALID_CONFIG: 4,
+};
+class CliError extends Error {
+    constructor(message, exitCode = exports.EXIT_CODES.GENERAL_ERROR) {
+        super(message);
+        this.exitCode = exitCode;
+        this.name = 'CliError';
+    }
+}
+exports.CliError = CliError;
+/**
+ * Classify an unknown error into the appropriate exit code.
+ */
+function classifyError(error) {
+    if (error instanceof CliError)
+        return error.exitCode;
+    const msg = error instanceof Error ? error.message.toLowerCase() : String(error).toLowerCase();
+    // Budget errors
+    if (msg.includes('budget exceeded') || msg.includes('budget limit')) {
+        return exports.EXIT_CODES.BUDGET_EXCEEDED;
+    }
+    // Provider/auth errors
+    if (msg.includes('api key') || msg.includes('authentication') ||
+        msg.includes('unauthorized') || msg.includes('403') ||
+        (msg.includes('provider') && msg.includes('unavailable')) ||
+        msg.includes('econnrefused') || msg.includes('econnreset')) {
+        return exports.EXIT_CODES.PROVIDER_UNAVAILABLE;
+    }
+    // Config/manifest errors
+    if ((msg.includes('manifest') && (msg.includes('invalid') || msg.includes('not found') || msg.includes('parse'))) ||
+        (msg.includes('config') && msg.includes('invalid')) ||
+        (msg.includes('route-families') && msg.includes('invalid'))) {
+        return exports.EXIT_CODES.INVALID_CONFIG;
+    }
+    return exports.EXIT_CODES.GENERAL_ERROR;
+}

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;AAiJD,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":"AASA,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;AA4JD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAuFpD"}

package/dist/cli/parse_args.js

@@ -8,6 +8,7 @@ exports.resolveAutoConfig = resolveAutoConfig;
 exports.parseArgs = parseArgs;
 const fs_1 = require("fs");
 const path_1 = require("path");
+const logger_js_1 = require("../logger.js");
 exports.CONFIG_CANDIDATES = ['e2e-ai-agents.config.json', '.e2e-ai-agents.config.json'];
 function findConfigUpwards(startDir) {
     if (!startDir) {
@@ -68,6 +69,7 @@ const FLAGS = {
     '--generate': { key: 'analyzeGenerate', type: 'boolean' },
     '--heal': { key: 'analyzeHeal', type: 'boolean' },
     '--no-ai': { key: 'noAi', type: 'boolean' },
+    '--degraded-mode': { key: 'degradedMode', type: 'boolean' },
     '--enrich': { key: 'trainEnrich', type: 'boolean' },
     '--no-enrich': { key: 'trainEnrich', type: 'boolean-false' },
     '--validate': { key: 'trainValidate', type: 'boolean' },
@@ -137,6 +139,13 @@ const FLAGS = {
         type: 'csv',
         transform: (v) => csvSplit(v).filter((s) => s === 'run-now' || s === 'must-add-tests' || s === 'safe-to-merge'),
     },
+    // -- gate command --
+    '--threshold': { key: 'gateThreshold', type: 'number' },
+    // -- bootstrap command --
+    '--kg-path': { key: 'bootstrapKgPath', type: 'string' },
+    '--scaffold-framework': { key: 'bootstrapScaffoldFramework', type: 'boolean' },
+    '--test-mode': { key: 'bootstrapTestMode', type: 'enum', enumValues: ['ui', 'api', 'both'] },
+    '--max-families': { key: 'bootstrapMaxFamilies', type: 'number' },
 };
 // Build a lookup from alias -> canonical flag name
 const ALIAS_MAP = {};
@@ -152,7 +161,8 @@ const COMMANDS = new Set([
     'init', 'impact', 'plan', 'heal', 'suggest', 'generate',
     'finalize-generated-tests', 'feedback',
     'traceability-capture', 'traceability-ingest',
-    'analyze', 'llm-health', 'train', 'crew',
+    'analyze', 'llm-health', 'train', 'crew', 'cost-report', 'gate',
+    'bootstrap',
 ]);
 // ---------------------------------------------------------------------------
 // Parser
@@ -174,6 +184,9 @@ function parseArgs(argv) {
         const arg = argv[i];
         const canonical = ALIAS_MAP[arg];
         if (!canonical) {
+            if (arg.startsWith('--')) {
+                logger_js_1.logger.warn(`Unknown flag "${arg}" (ignored)`);
+            }
             continue;
         }
         const def = FLAGS[canonical];
@@ -202,7 +215,16 @@ function parseArgs(argv) {
                 break;
             case 'number-raw':
                 if (next) {
-                    setField(parsed, def.key, def.transform ? def.transform(next) : Number(next));
+                    const rawValue = def.transform ? def.transform(next) : Number(next);
+                    // Allow non-number transforms through; reject NaN/Infinity for numbers
+                    if (typeof rawValue === 'number') {
+                        if (Number.isFinite(rawValue)) {
+                            setField(parsed, def.key, rawValue);
+                        }
+                    }
+                    else {
+                        setField(parsed, def.key, rawValue);
+                    }
                     i += 1;
                 }
                 break;

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' | 'train' | 'crew';
+export type Command = 'init' | 'impact' | 'plan' | 'heal' | 'suggest' | 'generate' | 'finalize-generated-tests' | 'feedback' | 'traceability-capture' | 'traceability-ingest' | 'analyze' | 'llm-health' | 'train' | 'crew' | 'cost-report' | 'gate' | 'bootstrap';
 export interface ParsedArgs {
     command?: Command;
     configPath?: string;
@@ -74,6 +74,12 @@ export interface ParsedArgs {
     trainYes?: boolean;
     serverPath?: string;
     crewWorkflow?: string;
+    gateThreshold?: number;
+    bootstrapKgPath?: string;
+    bootstrapScaffoldFramework?: boolean;
+    bootstrapTestMode?: 'ui' | 'api' | 'both';
+    bootstrapMaxFamilies?: number;
+    degradedMode?: boolean;
     verbose?: boolean;
     jsonOutput?: boolean;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,eAAe,EAAE,aAAa,EAAC,MAAM,oBAAoB,CAAC;AAEvE,MAAM,MAAM,OAAO,GACf,MAAM,GACJ,QAAQ,GACR,MAAM,GACN,MAAM,GACN,SAAS,GACT,UAAU,GACV,0BAA0B,GAC1B,UAAU,GACV,sBAAsB,GACtB,qBAAqB,GACrB,SAAS,GACT,YAAY,GACZ,OAAO,GACP,MAAM,CAAC;AAEb,MAAM,WAAW,UAAU;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC/D,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,qBAAqB,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC;IACtD,kBAAkB,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,gBAAgB,GAAG,eAAe,CAAC,CAAC;IAC3E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,6BAA6B,CAAC,EAAE,MAAM,CAAC;IACvC,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAG3B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;CACxB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,eAAe,EAAE,aAAa,EAAC,MAAM,oBAAoB,CAAC;AAEvE,MAAM,MAAM,OAAO,GACf,MAAM,GACJ,QAAQ,GACR,MAAM,GACN,MAAM,GACN,SAAS,GACT,UAAU,GACV,0BAA0B,GAC1B,UAAU,GACV,sBAAsB,GACtB,qBAAqB,GACrB,SAAS,GACT,YAAY,GACZ,OAAO,GACP,MAAM,GACN,aAAa,GACb,MAAM,GACN,WAAW,CAAC;AAElB,MAAM,WAAW,UAAU;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC/D,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,qBAAqB,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC;IACtD,kBAAkB,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,gBAAgB,GAAG,eAAe,CAAC,CAAC;IAC3E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,6BAA6B,CAAC,EAAE,MAAM,CAAC;IACvC,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAG3B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,aAAa,CAAC,EAAE,MAAM,CAAC;IAGvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,iBAAiB,CAAC,EAAE,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC;IAC1C,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAG9B,YAAY,CAAC,EAAE,OAAO,CAAC;IAGvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;CACxB"}

package/dist/cli.js

@@ -5,6 +5,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const config_js_1 = require("./agent/config.js");
 const parse_args_js_1 = require("./cli/parse_args.js");
+const defaults_js_1 = require("./cli/defaults.js");
 const usage_js_1 = require("./cli/usage.js");
 const llm_health_js_1 = require("./cli/commands/llm_health.js");
 const analyze_js_1 = require("./cli/commands/analyze.js");
@@ -18,14 +19,42 @@ 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");
 const crew_js_1 = require("./cli/commands/crew.js");
+const cost_report_js_1 = require("./cli/commands/cost_report.js");
+const gate_js_1 = require("./cli/commands/gate.js");
+const bootstrap_js_1 = require("./cli/commands/bootstrap.js");
+const errors_js_1 = require("./cli/errors.js");
+// Commands that skip default resolution (they handle their own setup)
+const SKIP_DEFAULTS_COMMANDS = new Set(['init', 'llm-health', 'cost-report', 'bootstrap']);
+// Commands that need path/testsRoot/framework/since
+const NEEDS_DEFAULTS_COMMANDS = new Set([
+    'impact', 'plan', 'suggest', 'crew', 'generate', 'heal', 'analyze', 'train',
+    'feedback', 'traceability-capture', 'traceability-ingest', 'finalize-generated-tests',
+]);
 async function main() {
     const args = (0, parse_args_js_1.parseArgs)(process.argv.slice(2));
     const autoConfig = (0, parse_args_js_1.resolveAutoConfig)(args);
+    // Auto-detect defaults for commands that need them (when no config file found)
+    if (args.command && NEEDS_DEFAULTS_COMMANDS.has(args.command) && !SKIP_DEFAULTS_COMMANDS.has(args.command)) {
+        const defaults = (0, defaults_js_1.resolveDefaults)({
+            path: args.path,
+            testsRoot: args.testsRoot,
+            framework: args.framework,
+            gitSince: args.gitSince,
+        });
+        args.path = args.path || defaults.path;
+        args.testsRoot = args.testsRoot || defaults.testsRoot;
+        args.framework = args.framework || defaults.framework;
+        args.gitSince = args.gitSince || defaults.since;
+    }
     if (args.command === 'init') {
         const hasYes = process.argv.includes('--yes') || process.argv.includes('-y');
         await (0, init_js_1.runInitCommand)(hasYes);
         return;
     }
+    if (args.command === 'bootstrap') {
+        await (0, bootstrap_js_1.runBootstrapCommand)(args);
+        return;
+    }
     if (args.command === 'train') {
         await (0, train_js_1.runTrainCommand)(args, autoConfig);
         return;
@@ -66,6 +95,14 @@ async function main() {
         await (0, crew_js_1.runCrewCommand)(args, autoConfig);
         return;
     }
+    if (args.command === 'cost-report') {
+        (0, cost_report_js_1.runCostReportCommand)(args);
+        return;
+    }
+    if (args.command === 'gate') {
+        await (0, gate_js_1.runGateCommand)(args, autoConfig);
+        return;
+    }
     if (!args.path && !autoConfig) {
         console.error('Error: --path is required (or provide a config file with path set)');
         (0, usage_js_1.printUsage)();
@@ -140,6 +177,14 @@ async function main() {
     process.exit(1);
 }
 main().catch((error) => {
-    console.error(error instanceof Error ? error.message : String(error));
-    process.exit(1);
+    const exitCode = (0, errors_js_1.classifyError)(error);
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(message);
+    if (exitCode === errors_js_1.EXIT_CODES.BUDGET_EXCEEDED) {
+        console.error('Hint: Increase --budget or use --degraded-mode to skip AI features.');
+    }
+    else if (exitCode === errors_js_1.EXIT_CODES.PROVIDER_UNAVAILABLE) {
+        console.error('Hint: Check API key or use --degraded-mode for deterministic analysis only.');
+    }
+    process.exit(exitCode);
 });