@yasserkhanorg/impact-gate 2.0.0

package/dist/cli/commands/impact.js

@@ -0,0 +1,33 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runImpactCommand = runImpactCommand;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const git_js_1 = require("../../agent/git.js");
+const impact_engine_js_1 = require("../../engine/impact_engine.js");
+function runImpactCommand(args, config) {
+    const reportRoot = config.testsRoot || config.path;
+    const gitResult = (0, git_js_1.getChangedFiles)(config.path, config.git.since, { includeUncommitted: config.git.includeUncommitted });
+    const impactResult = (0, impact_engine_js_1.analyzeImpact)(gitResult.files, {
+        testsRoot: reportRoot,
+        routeFamilies: config.routeFamilies,
+    });
+    console.log(`Impact: ${impactResult.changedFiles.length} changed files → ${impactResult.impactedFeatures.length} features impacted`);
+    console.log(`Unbound files: ${impactResult.unboundFiles.length}`);
+    for (const f of impactResult.impactedFeatures) {
+        const label = f.featureId || f.familyId;
+        console.log(`  [${f.priority}] ${label}: ${f.coverageStatus} (PW=${f.playwrightSpecs.length}, Cy=${f.cypressSpecs.length})`);
+    }
+    if (impactResult.warnings.length > 0) {
+        for (const w of impactResult.warnings) {
+            console.warn(`  Warning: ${w}`);
+        }
+    }
+    const outputDir = (0, path_1.join)(reportRoot, '.e2e-ai-agents');
+    (0, fs_1.mkdirSync)(outputDir, { recursive: true });
+    const planPath = (0, path_1.join)(outputDir, 'plan.json');
+    (0, fs_1.writeFileSync)(planPath, JSON.stringify(impactResult, null, 2));
+    console.log(`Wrote ${planPath}`);
+}

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

@@ -0,0 +1,2 @@
+export declare function runInitCommand(yes?: boolean): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AA0EA,wBAAsB,cAAc,CAAC,GAAG,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAgG/D"}

package/dist/cli/commands/init.js

@@ -0,0 +1,169 @@
+"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.runInitCommand = runInitCommand;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const readline = __importStar(require("readline"));
+const defaults_js_1 = require("../defaults.js");
+const CONFIG_FILENAME = 'impact-gate.config.json';
+const LEGACY_CONFIG_FILENAMES = ['e2e-ai-agents.config.json', '.e2e-ai-agents.config.json'];
+function createInterface() {
+    return readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+}
+function ask(rl, question, defaultValue) {
+    const suffix = defaultValue ? ` (${defaultValue})` : '';
+    return new Promise((resolve) => {
+        rl.question(`${question}${suffix}: `, (answer) => {
+            resolve(answer.trim() || defaultValue || '');
+        });
+    });
+}
+function buildConfig(answers) {
+    const config = {
+        path: answers.path,
+        framework: answers.framework,
+        git: { since: answers.gitSince },
+        impact: {
+            dependencyGraph: { enabled: true, maxDepth: 3 },
+            traceability: { enabled: true },
+            aiFlow: {
+                enabled: answers.enableAi,
+                provider: answers.enableAi ? answers.provider : undefined,
+            },
+        },
+        policy: {
+            enforcementMode: answers.enforcementMode,
+            blockOnActions: ['must-add-tests'],
+        },
+    };
+    if (answers.testsRoot && answers.testsRoot !== '.' && answers.testsRoot !== answers.path) {
+        config.testsRoot = answers.testsRoot;
+    }
+    return config;
+}
+function printNextSteps() {
+    console.log('');
+    console.log('  Next steps:');
+    console.log('    1. Start with impact analysis:  npx impact-gate impact --path .');
+    console.log('    2. Build a coverage plan:      npx impact-gate plan --path .');
+    console.log('    3. Optional AI setup:          export ANTHROPIC_API_KEY=sk-ant-...');
+    console.log('    4. Verify provider health:     npx impact-gate llm-health');
+    console.log('');
+}
+async function runInitCommand(yes = false) {
+    const targetDir = process.cwd();
+    const configPath = (0, path_1.join)(targetDir, CONFIG_FILENAME);
+    const existingLegacyConfig = LEGACY_CONFIG_FILENAMES.find((filename) => (0, fs_1.existsSync)((0, path_1.join)(targetDir, filename)));
+    if ((0, fs_1.existsSync)(configPath) || existingLegacyConfig) {
+        const existingName = (0, fs_1.existsSync)(configPath) ? CONFIG_FILENAME : existingLegacyConfig;
+        console.error(`${existingName} already exists in this directory.`);
+        console.error('Remove it first if you want to re-initialize.');
+        process.exit(1);
+    }
+    // Non-interactive mode: auto-detect everything and write immediately
+    if (yes) {
+        const appPath = '.';
+        const answers = {
+            path: appPath,
+            testsRoot: (0, defaults_js_1.detectTestsRoot)(appPath) || '.',
+            framework: (0, defaults_js_1.detectFramework)(appPath),
+            gitSince: (0, defaults_js_1.detectGitDefaultBranch)(appPath),
+            provider: 'auto',
+            enableAi: true,
+            enforcementMode: 'advisory',
+        };
+        const config = buildConfig(answers);
+        const json = JSON.stringify(config, null, 2) + '\n';
+        (0, fs_1.writeFileSync)(configPath, json, 'utf-8');
+        console.log(`Created ${CONFIG_FILENAME}`);
+        printNextSteps();
+        return;
+    }
+    console.log('');
+    console.log('  impact-gate init');
+    console.log('  ==================');
+    console.log('');
+    console.log('  This will create an impact-gate.config.json in the current directory.');
+    console.log('  Legacy e2e-ai-agents config filenames are still supported during migration.');
+    console.log('');
+    const rl = createInterface();
+    try {
+        const appPath = await ask(rl, '  Path to your web app root', '.');
+        const detectedFramework = (0, defaults_js_1.detectFramework)(appPath);
+        const framework = await ask(rl, '  Test framework (auto | playwright | cypress | pytest | supertest | selenium)', detectedFramework);
+        const detectedTestsRoot = (0, defaults_js_1.detectTestsRoot)(appPath);
+        const testsRoot = await ask(rl, '  Path to tests root (relative to app root, "." if same)', detectedTestsRoot || '.');
+        const detectedBranch = (0, defaults_js_1.detectGitDefaultBranch)(appPath);
+        const gitSince = await ask(rl, '  Git ref to diff against', detectedBranch);
+        const providerAnswer = await ask(rl, '  LLM provider for AI features (anthropic | openai | ollama | auto)', 'auto');
+        const enableAi = providerAnswer !== 'none';
+        const enforcementMode = await ask(rl, '  Policy enforcement mode (advisory | warn | block)', 'advisory');
+        const answers = {
+            path: appPath,
+            testsRoot,
+            framework,
+            gitSince,
+            provider: providerAnswer,
+            enableAi,
+            enforcementMode,
+        };
+        const config = buildConfig(answers);
+        const json = JSON.stringify(config, null, 2) + '\n';
+        console.log('');
+        console.log('  Generated config:');
+        console.log('');
+        for (const line of json.split('\n')) {
+            console.log(`    ${line}`);
+        }
+        const confirm = await ask(rl, '  Write this config? (Y/n)', 'Y');
+        if (confirm.toLowerCase() !== 'y' && confirm !== '') {
+            console.log('  Aborted.');
+            process.exit(0);
+        }
+        (0, fs_1.writeFileSync)(configPath, json, 'utf-8');
+        console.log('');
+        console.log(`  Created ${CONFIG_FILENAME}`);
+        printNextSteps();
+    }
+    finally {
+        rl.close();
+    }
+}

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

@@ -0,0 +1,2 @@
+export declare function runLlmHealth(): Promise<void>;
+//# sourceMappingURL=llm_health.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"llm_health.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/llm_health.ts"],"names":[],"mappings":"AAKA,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAclD"}

package/dist/cli/commands/llm_health.js

@@ -0,0 +1,22 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runLlmHealth = runLlmHealth;
+const provider_factory_js_1 = require("../../provider_factory.js");
+async function runLlmHealth() {
+    try {
+        const provider = await provider_factory_js_1.LLMProviderFactory.createFromEnv();
+        const health = await provider.checkHealth();
+        if (!health.healthy) {
+            console.error(`${provider.name} failed: ${health.message}`);
+            process.exit(1);
+        }
+        console.log(`${provider.name} OK -> ${health.message}`);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`LLM health check failed: ${message}`);
+        process.exit(1);
+    }
+}

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

@@ -0,0 +1,4 @@
+import type { resolveConfig } from '../../agent/config.js';
+import type { ParsedArgs } from '../types.js';
+export declare function runPlanCommand(args: ParsedArgs, autoConfig: string | undefined, config: ReturnType<typeof resolveConfig>['config']): Promise<void>;
+//# sourceMappingURL=plan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/plan.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,uBAAuB,CAAC;AAMzD,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,aAAa,CAAC;AAE5C,wBAAsB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CA+GxJ"}

package/dist/cli/commands/plan.js

@@ -0,0 +1,120 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPlanCommand = runPlanCommand;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const plan_builder_js_1 = require("../../engine/plan_builder.js");
+const api_js_1 = require("../../api.js");
+const plan_crew_js_1 = require("./plan_crew.js");
+async function runPlanCommand(args, autoConfig, config) {
+    const reportRoot = config.testsRoot || config.path;
+    const apiOptions = {
+        cwd: process.cwd(),
+        configPath: autoConfig,
+        path: args.path,
+        profile: args.profile,
+        testsRoot: args.testsRoot,
+        gitSince: args.gitSince,
+        llmProvider: args.llmProvider,
+        policy: args.policyMinConfidence !== undefined ||
+            args.policySafeMergeConfidence !== undefined ||
+            args.policyWarningsThreshold !== undefined ||
+            (args.policyRiskyPatterns && args.policyRiskyPatterns.length > 0) ||
+            args.policyEnforcementMode !== undefined ||
+            (args.policyBlockActions && args.policyBlockActions.length > 0)
+            ? {
+                minConfidenceForTargeted: args.policyMinConfidence,
+                safeMergeMinConfidence: args.policySafeMergeConfidence,
+                forceFullOnWarningsAtOrAbove: args.policyWarningsThreshold,
+                riskyFilePatterns: args.policyRiskyPatterns,
+                enforcementMode: args.policyEnforcementMode,
+                blockOnActions: args.policyBlockActions,
+            }
+            : undefined,
+    };
+    let result;
+    if (args.noAi) {
+        result = (0, api_js_1.recommendTestsDeterministic)(apiOptions);
+    }
+    else {
+        result = await (0, api_js_1.recommendTestsAI)(apiOptions);
+        if (result.aiEnrichment) {
+            const { aiEnrichment } = result;
+            console.log(`AI enrichment: ${aiEnrichment.enrichedFeatures.length} features enriched (${aiEnrichment.tokenUsage.input + aiEnrichment.tokenUsage.output} tokens)`);
+        }
+        else if (!process.env.ANTHROPIC_API_KEY && !process.env.OPENAI_API_KEY && !process.env.LLM_PROVIDER) {
+            console.log('Tip: configure ANTHROPIC_API_KEY, OPENAI_API_KEY, or LLM_PROVIDER to enable AI-powered enrichment');
+        }
+    }
+    const { plan, planPath, ciSummaryMarkdown, ciSummaryPath } = result;
+    let planReport = plan;
+    let combinedSummaryMarkdown = ciSummaryMarkdown;
+    let crewSummaryPath = '';
+    let crewMarkdownPath = '';
+    let crewTestPlanPath = '';
+    if (args.crew) {
+        try {
+            const crew = await (0, plan_crew_js_1.runPlanCrewAnalysis)(plan, config, args);
+            planReport = {
+                ...plan,
+                crew,
+            };
+            combinedSummaryMarkdown = (0, plan_crew_js_1.appendCrewToSummary)(ciSummaryMarkdown, crew, plan);
+            const artifacts = (0, plan_crew_js_1.writeCrewArtifacts)(reportRoot, crew, plan);
+            crewSummaryPath = artifacts.crewSummaryPath;
+            crewMarkdownPath = artifacts.crewMarkdownPath;
+            crewTestPlanPath = artifacts.crewTestPlanPath;
+            (0, fs_1.writeFileSync)(planPath, JSON.stringify(planReport, null, 2), 'utf-8');
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.warn(`Crew analysis unavailable: ${message}`);
+        }
+    }
+    (0, plan_builder_js_1.writeCiSummary)(reportRoot, combinedSummaryMarkdown);
+    const summaryPath = args.ciCommentPath
+        ? (0, plan_builder_js_1.writeCiSummary)(reportRoot, combinedSummaryMarkdown, args.ciCommentPath)
+        : ciSummaryPath;
+    // Compute metrics paths (api already wrote metrics; derive paths for GHA output)
+    const metricsEventsPath = (0, path_1.join)(reportRoot, '.e2e-ai-agents/metrics.jsonl');
+    const metricsSummaryPath = (0, path_1.join)(reportRoot, '.e2e-ai-agents/metrics-summary.json');
+    const ghaOutput = args.githubOutputPath || process.env.GITHUB_OUTPUT;
+    if (ghaOutput) {
+        (0, fs_1.appendFileSync)(ghaOutput, `run_set=${planReport.runSet}\n`);
+        (0, fs_1.appendFileSync)(ghaOutput, `action=${planReport.decision.action}\n`);
+        (0, fs_1.appendFileSync)(ghaOutput, `confidence=${planReport.confidence}\n`);
+        (0, fs_1.appendFileSync)(ghaOutput, `enforcement_mode=${planReport.enforcement.mode}\n`);
+        (0, fs_1.appendFileSync)(ghaOutput, `enforcement_should_fail=${planReport.enforcement.shouldFail}\n`);
+        (0, fs_1.appendFileSync)(ghaOutput, `recommended_tests_count=${planReport.recommendedTests.length}\n`);
+        (0, fs_1.appendFileSync)(ghaOutput, `required_new_tests_count=${planReport.requiredNewTests.length}\n`);
+        (0, fs_1.appendFileSync)(ghaOutput, `plan_path=${planPath}\n`);
+        (0, fs_1.appendFileSync)(ghaOutput, `summary_path=${summaryPath}\n`);
+        (0, fs_1.appendFileSync)(ghaOutput, `metrics_events_path=${metricsEventsPath}\n`);
+        (0, fs_1.appendFileSync)(ghaOutput, `metrics_summary_path=${metricsSummaryPath}\n`);
+        (0, fs_1.appendFileSync)(ghaOutput, `crew_enabled=${planReport.crew ? 'true' : 'false'}\n`);
+        (0, fs_1.appendFileSync)(ghaOutput, `crew_workflow=${planReport.crew?.workflow || ''}\n`);
+        (0, fs_1.appendFileSync)(ghaOutput, `crew_summary_path=${crewSummaryPath}\n`);
+        (0, fs_1.appendFileSync)(ghaOutput, `crew_markdown_path=${crewMarkdownPath}\n`);
+        (0, fs_1.appendFileSync)(ghaOutput, `crew_test_plan_path=${crewTestPlanPath}\n`);
+        (0, fs_1.appendFileSync)(ghaOutput, `crew_impacted_flows=${planReport.crew?.summary.impactedFlows || 0}\n`);
+        (0, fs_1.appendFileSync)(ghaOutput, `crew_strategy_entries=${planReport.crew?.summary.strategyEntries || 0}\n`);
+        (0, fs_1.appendFileSync)(ghaOutput, `crew_test_designs=${planReport.crew?.summary.testDesigns || 0}\n`);
+    }
+    console.log(`Suggested run set: ${planReport.runSet} (confidence ${planReport.confidence})`);
+    console.log(`Decision: ${planReport.decision.action} - ${planReport.decision.summary}`);
+    console.log(`Enforcement: ${planReport.enforcement.mode} (shouldFail=${planReport.enforcement.shouldFail})`);
+    console.log(`Plan data: ${planPath}`);
+    console.log(`CI summary: ${summaryPath}`);
+    if (planReport.crew) {
+        console.log(`Crew workflow: ${planReport.crew.workflow} (impactedFlows=${planReport.crew.summary.impactedFlows}, strategyEntries=${planReport.crew.summary.strategyEntries}, testDesigns=${planReport.crew.summary.testDesigns})`);
+        console.log(`Crew summary: ${crewSummaryPath}`);
+        console.log(`Crew test plan: ${crewTestPlanPath}`);
+    }
+    console.log(`Plan metrics: ${metricsSummaryPath}`);
+    const failOnLegacyFlag = args.failOnMustAddTests && planReport.decision.action === 'must-add-tests';
+    if (failOnLegacyFlag || planReport.enforcement.shouldFail) {
+        process.exit(2);
+    }
+}

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

@@ -0,0 +1,17 @@
+import type { AgentConfig } from '../../agent/config.js';
+import type { CrewPlanInsights, PlanReport } from '../../agent/plan.js';
+import type { ParsedArgs } from '../types.js';
+export declare function runPlanCrewAnalysis(plan: PlanReport, config: AgentConfig, args: ParsedArgs): Promise<CrewPlanInsights>;
+export declare function buildCrewMarkdown(crew: CrewPlanInsights, plan?: PlanReport): string;
+export declare function appendCrewToSummary(baseMarkdown: string, crew: CrewPlanInsights, plan?: PlanReport): string;
+/**
+ * Build a full structured test plan as a Markdown document.
+ * Sections: gap flows first (P0 cases expanded), then covered-flow smoke tests.
+ */
+export declare function buildCrewTestPlan(crew: CrewPlanInsights, plan?: PlanReport): string;
+export declare function writeCrewArtifacts(reportRoot: string, crew: CrewPlanInsights, plan?: PlanReport): {
+    crewSummaryPath: string;
+    crewMarkdownPath: string;
+    crewTestPlanPath: string;
+};
+//# sourceMappingURL=plan_crew.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan_crew.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/plan_crew.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAC,gBAAgB,EAAE,UAAU,EAAC,MAAM,qBAAqB,CAAC;AAUtE,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,aAAa,CAAC;AAgC5C,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAkD5H;AAWD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,MAAM,CAwEnF;AAED,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,MAAM,CAE3G;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,MAAM,CAsJnF;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAC,CAa/K"}