@yasserkhanorg/e2e-agents 1.8.4 → 1.9.5

package/dist/esm/cli/commands/init.js

@@ -1,9 +1,9 @@
 // Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
 // See LICENSE.txt for license information.
-import { existsSync, writeFileSync, readFileSync } from 'fs';
-import { execFileSync } from 'child_process';
-import { join, resolve } from 'path';
+import { existsSync, writeFileSync } from 'fs';
+import { join } from 'path';
 import * as readline from 'readline';
+import { detectFramework, detectTestsRoot, detectGitDefaultBranch } from '../defaults.js';
 const CONFIG_FILENAME = 'e2e-ai-agents.config.json';
 function createInterface() {
     return readline.createInterface({
@@ -19,61 +19,6 @@ function ask(rl, question, defaultValue) {
         });
     });
 }
-function detectFramework(appPath) {
-    const resolvedPath = resolve(appPath);
-    const pkgPath = join(resolvedPath, 'package.json');
-    if (!existsSync(pkgPath)) {
-        return 'auto';
-    }
-    try {
-        const pkg = JSON.parse(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
-    }
-    return 'auto';
-}
-function detectGitDefaultBranch(appPath) {
-    try {
-        const result = execFileSync('git', ['rev-parse', '--abbrev-ref', 'HEAD'], {
-            cwd: resolve(appPath),
-            encoding: 'utf-8',
-            stdio: ['pipe', 'pipe', 'pipe'],
-        }).trim();
-        return `origin/${result}`;
-    }
-    catch {
-        return 'origin/main';
-    }
-}
-function detectTestsRoot(appPath) {
-    const resolvedPath = resolve(appPath);
-    const candidates = [
-        'e2e-tests/playwright',
-        'e2e-tests',
-        'e2e',
-        'tests/e2e',
-        'test/e2e',
-        'tests',
-        'test',
-    ];
-    for (const candidate of candidates) {
-        if (existsSync(join(resolvedPath, candidate))) {
-            return candidate;
-        }
-    }
-    return undefined;
-}
 function buildConfig(answers) {
     const config = {
         path: answers.path,

package/dist/esm/cli/commands/plan_crew.js

@@ -88,11 +88,11 @@ export 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
@@ -177,37 +177,48 @@ export 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
@@ -242,9 +253,10 @@ export 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);
@@ -252,8 +264,8 @@ export 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) {
@@ -273,9 +285,9 @@ export 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/esm/cli/commands/train.js

@@ -5,13 +5,16 @@ import { existsSync, mkdirSync, renameSync, writeFileSync } from 'fs';
 import { dirname, join, resolve } from 'path';
 import * as readline from 'readline';
 import { resolveConfig } from '../../agent/config.js';
-import { loadRouteFamilyManifest } from '../../knowledge/route_families.js';
+import { loadRouteFamilyManifest, serializeManifest } from '../../knowledge/route_families.js';
 import { LLMProviderFactory } from '../../provider_factory.js';
 import { logger, LogLevel } from '../../logger.js';
+import { getVersion } from '../../version.js';
 import { scanProject } from '../../training/scanner.js';
+import { scanFromKnowledgeGraph } from '../../training/kg_scanner.js';
 import { mergeFamilies, detectStaleFamilies } from '../../training/merger.js';
 import { enrichFamilies } from '../../training/enricher.js';
 import { getCommitFiles, validateCommit, buildValidationReport, formatValidationReport } from '../../training/validator.js';
+import { loadKnowledgeGraph } from '../../knowledge/kg_bridge.js';
 class TrainError extends Error {
     constructor(message) {
         super(message);
@@ -121,24 +124,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';
-}
 export async function runTrainCommand(args, autoConfig) {
     const opts = resolveTrainOptions(args, autoConfig);
     const totalTimer = logger.timer('train-total');
@@ -151,12 +136,22 @@ export async function runTrainCommand(args, autoConfig) {
     logger.info('e2e-ai-agents train');
     logger.info('===================');
     // ---------- Phase 1: Deterministic scan ----------
+    // Prefer knowledge graph when available
+    const kg = loadKnowledgeGraph(opts.appPath);
     logger.info('Scanning project structure...');
     if (opts.serverRoot) {
         logger.info(`Server root: ${opts.serverRoot}`);
     }
     const scanTimer = logger.timer('scan');
-    const scanResult = scanProject(opts.appPath, opts.testsRoot !== opts.appPath ? opts.testsRoot : undefined, opts.serverRoot, opts.gitRepoRoot);
+    let scanResult;
+    if (kg) {
+        logger.info('Using knowledge graph for scanning (found .understand-anything/knowledge-graph.json)');
+        scanResult = scanFromKnowledgeGraph(kg);
+        logger.info(`KG: ${kg.nodes.length} nodes, ${kg.edges.length} edges`);
+    }
+    else {
+        scanResult = scanProject(opts.appPath, opts.testsRoot !== opts.appPath ? opts.testsRoot : undefined, opts.serverRoot, opts.gitRepoRoot);
+    }
     timings.scan = scanTimer.end();
     logger.info(`Found ${scanResult.stats.totalSourceFiles} source files, ${scanResult.stats.totalTestFiles} test files`);
     logger.info(`Discovered ${scanResult.families.length} candidate families`);
@@ -332,7 +327,7 @@ export async function runTrainCommand(args, autoConfig) {
         const reportDir = dirname(opts.outputPath);
         const trainReport = {
             timestamp: new Date().toISOString(),
-            version: '1.7.0',
+            version: getVersion(),
             timings,
             families: {
                 total: mergeResult.manifest.families.length,

package/dist/esm/cli/defaults.js

@@ -0,0 +1,118 @@
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+import { existsSync, readFileSync } from 'fs';
+import { execFileSync } from 'child_process';
+import { join, resolve } from 'path';
+/**
+ * Detect the test framework from package.json dependencies.
+ */
+export function detectFramework(appPath) {
+    const resolvedPath = resolve(appPath);
+    const pkgPath = join(resolvedPath, 'package.json');
+    if (!existsSync(pkgPath)) {
+        return 'auto';
+    }
+    try {
+        const pkg = JSON.parse(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.
+ */
+export function detectTestsRoot(appPath) {
+    const resolvedPath = 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 (existsSync(join(resolvedPath, candidate))) {
+            return candidate;
+        }
+    }
+    return undefined;
+}
+/**
+ * Detect the git default branch for diffing.
+ * Returns origin/<branch> format.
+ */
+export function detectGitDefaultBranch(appPath) {
+    try {
+        // Try to find the remote HEAD branch first
+        const remoteInfo = execFileSync('git', ['remote', 'show', 'origin'], {
+            cwd: 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 = execFileSync('git', ['rev-parse', '--abbrev-ref', 'HEAD'], {
+            cwd: 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.
+ */
+export function detectProjectRoot(startDir) {
+    let current = resolve(startDir);
+    while (true) {
+        if (existsSync(join(current, 'package.json')) || existsSync(join(current, '.git'))) {
+            return current;
+        }
+        const parent = 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.
+ */
+export 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/esm/cli/errors.js

@@ -0,0 +1,52 @@
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+/**
+ * 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 const EXIT_CODES = {
+    SUCCESS: 0,
+    GENERAL_ERROR: 1,
+    BUDGET_EXCEEDED: 2,
+    PROVIDER_UNAVAILABLE: 3,
+    INVALID_CONFIG: 4,
+};
+export class CliError extends Error {
+    constructor(message, exitCode = EXIT_CODES.GENERAL_ERROR) {
+        super(message);
+        this.exitCode = exitCode;
+        this.name = 'CliError';
+    }
+}
+/**
+ * Classify an unknown error into the appropriate exit code.
+ */
+export 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 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 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 EXIT_CODES.INVALID_CONFIG;
+    }
+    return EXIT_CODES.GENERAL_ERROR;
+}

package/dist/esm/cli/parse_args.js

@@ -2,6 +2,7 @@
 // See LICENSE.txt for license information.
 import { existsSync } from 'fs';
 import { dirname, join, resolve } from 'path';
+import { logger } from '../logger.js';
 export const CONFIG_CANDIDATES = ['e2e-ai-agents.config.json', '.e2e-ai-agents.config.json'];
 export function findConfigUpwards(startDir) {
     if (!startDir) {
@@ -62,6 +63,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' },
@@ -131,6 +133,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 = {};
@@ -146,7 +155,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
@@ -168,6 +178,9 @@ export function parseArgs(argv) {
         const arg = argv[i];
         const canonical = ALIAS_MAP[arg];
         if (!canonical) {
+            if (arg.startsWith('--')) {
+                logger.warn(`Unknown flag "${arg}" (ignored)`);
+            }
             continue;
         }
         const def = FLAGS[canonical];
@@ -196,7 +209,16 @@ export 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/esm/cli.js

@@ -3,6 +3,7 @@
 // See LICENSE.txt for license information.
 import { resolveConfig } from './agent/config.js';
 import { parseArgs, resolveAutoConfig } from './cli/parse_args.js';
+import { resolveDefaults } from './cli/defaults.js';
 import { printUsage } from './cli/usage.js';
 import { runLlmHealth } from './cli/commands/llm_health.js';
 import { runAnalyzeCommand } from './cli/commands/analyze.js';
@@ -16,14 +17,42 @@ import { runGenerateCommand } from './cli/commands/generate.js';
 import { runInitCommand } from './cli/commands/init.js';
 import { runTrainCommand } from './cli/commands/train.js';
 import { runCrewCommand } from './cli/commands/crew.js';
+import { runCostReportCommand } from './cli/commands/cost_report.js';
+import { runGateCommand } from './cli/commands/gate.js';
+import { runBootstrapCommand } from './cli/commands/bootstrap.js';
+import { classifyError, EXIT_CODES } from './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 = parseArgs(process.argv.slice(2));
     const autoConfig = 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 = 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 runInitCommand(hasYes);
         return;
     }
+    if (args.command === 'bootstrap') {
+        await runBootstrapCommand(args);
+        return;
+    }
     if (args.command === 'train') {
         await runTrainCommand(args, autoConfig);
         return;
@@ -64,6 +93,14 @@ async function main() {
         await runCrewCommand(args, autoConfig);
         return;
     }
+    if (args.command === 'cost-report') {
+        runCostReportCommand(args);
+        return;
+    }
+    if (args.command === 'gate') {
+        await runGateCommand(args, autoConfig);
+        return;
+    }
     if (!args.path && !autoConfig) {
         console.error('Error: --path is required (or provide a config file with path set)');
         printUsage();
@@ -138,6 +175,14 @@ async function main() {
     process.exit(1);
 }
 main().catch((error) => {
-    console.error(error instanceof Error ? error.message : String(error));
-    process.exit(1);
+    const exitCode = classifyError(error);
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(message);
+    if (exitCode === EXIT_CODES.BUDGET_EXCEEDED) {
+        console.error('Hint: Increase --budget or use --degraded-mode to skip AI features.');
+    }
+    else if (exitCode === EXIT_CODES.PROVIDER_UNAVAILABLE) {
+        console.error('Hint: Check API key or use --degraded-mode for deterministic analysis only.');
+    }
+    process.exit(exitCode);
 });