@yasserkhanorg/e2e-agents 1.7.7 → 1.8.1

package/dist/agents/impact-analyst.js

@@ -0,0 +1,38 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ImpactAnalystAgent = void 0;
+/**
+ * Impact Analyst Agent — wraps pipeline stage1 (impact analysis) in the Agent interface.
+ */
+const stage1_impact_js_1 = require("../pipeline/stage1_impact.js");
+class ImpactAnalystAgent {
+    constructor() {
+        this.role = 'impact-analyst';
+    }
+    async execute(_task, ctx) {
+        const warnings = [];
+        if (ctx.familyGroups.length === 0) {
+            warnings.push('Impact analyst: no family groups to analyze.');
+            return { role: this.role, status: 'partial', output: [], warnings };
+        }
+        try {
+            const result = await (0, stage1_impact_js_1.runImpactStage)(ctx.familyGroups, ctx.manifest, ctx.specIndex, ctx.apiSurface, ctx.context, { provider: ctx.providerOverride });
+            ctx.impactedFlows.push(...result.decisions);
+            warnings.push(...result.warnings);
+            return {
+                role: this.role,
+                status: result.decisions.length > 0 ? 'success' : 'partial',
+                output: result.decisions,
+                warnings,
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            warnings.push(`Impact analyst failed: ${message}`);
+            return { role: this.role, status: 'failed', output: null, warnings };
+        }
+    }
+}
+exports.ImpactAnalystAgent = ImpactAnalystAgent;

package/dist/agents/regression-advisor.d.ts

@@ -0,0 +1,8 @@
+import type { Agent, AgentTask, AgentResult } from '../crew/protocol.js';
+import type { CrewContext } from '../crew/context.js';
+import type { AgentRole } from '../crew/types.js';
+export declare class RegressionAdvisorAgent implements Agent {
+    readonly role: AgentRole;
+    execute(_task: AgentTask, ctx: CrewContext): Promise<AgentResult>;
+}
+//# sourceMappingURL=regression-advisor.d.ts.map

package/dist/agents/regression-advisor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"regression-advisor.d.ts","sourceRoot":"","sources":["../../src/agents/regression-advisor.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAC,KAAK,EAAE,SAAS,EAAE,WAAW,EAAC,MAAM,qBAAqB,CAAC;AACvE,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAC,SAAS,EAAiB,MAAM,kBAAkB,CAAC;AAUhE,qBAAa,sBAAuB,YAAW,KAAK;IAChD,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAwB;IAE1C,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;CA0G1E"}

package/dist/agents/regression-advisor.js

@@ -0,0 +1,116 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RegressionAdvisorAgent = void 0;
+/**
+ * Regression Advisor Agent — identifies historically regression-prone areas
+ * using traceability data and advises the Strategist on risk scores.
+ * Mostly deterministic (traceability data analysis), with optional LLM enrichment.
+ */
+const feedback_js_1 = require("../agent/feedback.js");
+const FLAKY_RISK_MULTIPLIER = 15;
+const LOW_PRECISION_RISK_MULTIPLIER = 30;
+const PATTERN_RISK_SCORE = 30;
+const PATTERN_RISK_ADDITIVE = 20;
+const MAX_RISK_SCORE = 100;
+const MIN_PRECISION_THRESHOLD = 0.5;
+const MIN_CALIBRATION_SAMPLES = 3;
+class RegressionAdvisorAgent {
+    constructor() {
+        this.role = 'regression-advisor';
+    }
+    async execute(_task, ctx) {
+        const warnings = [];
+        const risks = [];
+        // Analyze calibration data for historical failure patterns
+        const calibration = (0, feedback_js_1.readCalibration)(ctx.testsRoot);
+        const flakyData = (0, feedback_js_1.readFlakyTests)(ctx.testsRoot);
+        // Build risk from flaky test data
+        if (flakyData && flakyData.tests.length > 0) {
+            const flakyByFamily = new Map();
+            for (const test of flakyData.tests) {
+                // Use subsystem field as family identifier
+                if (test.subsystem) {
+                    flakyByFamily.set(test.subsystem, (flakyByFamily.get(test.subsystem) || 0) + 1);
+                }
+            }
+            for (const [familyId, count] of flakyByFamily) {
+                const isImpacted = ctx.familyGroups.some((g) => g.familyId === familyId);
+                if (isImpacted) {
+                    risks.push({
+                        familyId,
+                        filePattern: '*',
+                        riskScore: Math.min(MAX_RISK_SCORE, count * FLAKY_RISK_MULTIPLIER),
+                        reason: `${count} flaky test(s) historically in this family`,
+                        historicalFailures: count,
+                    });
+                }
+            }
+        }
+        // Build risk from calibration data (subsystem-level precision/recall)
+        if (calibration && calibration.bySubsystem) {
+            for (const [subsystem, metrics] of Object.entries(calibration.bySubsystem)) {
+                const isImpacted = ctx.familyGroups.some((g) => g.familyId === subsystem);
+                if (!isImpacted)
+                    continue;
+                // Low precision means many false positives — the subsystem is noisy
+                if (metrics.precision < MIN_PRECISION_THRESHOLD && metrics.samples >= MIN_CALIBRATION_SAMPLES) {
+                    const existing = risks.find((r) => r.familyId === subsystem);
+                    const lowPrecisionScore = Math.round((1 - metrics.precision) * LOW_PRECISION_RISK_MULTIPLIER);
+                    if (existing) {
+                        existing.riskScore = Math.min(MAX_RISK_SCORE, existing.riskScore + lowPrecisionScore);
+                        existing.reason += `; low calibration precision (${(metrics.precision * 100).toFixed(0)}%)`;
+                    }
+                    else {
+                        risks.push({
+                            familyId: subsystem,
+                            filePattern: '*',
+                            riskScore: lowPrecisionScore,
+                            reason: `Low calibration precision (${(metrics.precision * 100).toFixed(0)}%) — historically noisy subsystem`,
+                            historicalFailures: metrics.samples,
+                        });
+                    }
+                }
+            }
+        }
+        // Analyze changed files for known regression-prone patterns
+        for (const group of ctx.familyGroups) {
+            const hasApiChange = group.files.some((f) => f.path.includes('/api/') || f.path.includes('/actions/') || f.path.includes('/reducers/'));
+            const hasAuthChange = group.files.some((f) => f.path.includes('auth') || f.path.includes('login') || f.path.includes('session'));
+            const hasDBChange = group.files.some((f) => f.path.includes('/store/') || f.path.includes('/model/') || f.path.includes('migration'));
+            if (hasApiChange || hasAuthChange || hasDBChange) {
+                const existing = risks.find((r) => r.familyId === group.familyId);
+                const patterns = [
+                    hasApiChange && 'API changes',
+                    hasAuthChange && 'auth changes',
+                    hasDBChange && 'data model changes',
+                ].filter(Boolean).join(', ');
+                if (existing) {
+                    existing.riskScore = Math.min(MAX_RISK_SCORE, existing.riskScore + PATTERN_RISK_ADDITIVE);
+                    existing.reason += `; regression-prone patterns: ${patterns}`;
+                }
+                else {
+                    risks.push({
+                        familyId: group.familyId,
+                        filePattern: group.files.map((f) => f.path).join(', '),
+                        riskScore: PATTERN_RISK_SCORE,
+                        reason: `Regression-prone file patterns detected: ${patterns}`,
+                        historicalFailures: 0,
+                    });
+                }
+            }
+        }
+        ctx.regressionRisks.push(...risks);
+        if (risks.length === 0) {
+            warnings.push('Regression advisor: no historical risk data found.');
+        }
+        return {
+            role: this.role,
+            status: risks.length > 0 ? 'success' : 'partial',
+            output: risks,
+            warnings,
+        };
+    }
+}
+exports.RegressionAdvisorAgent = RegressionAdvisorAgent;

package/dist/agents/strategist.d.ts

@@ -0,0 +1,9 @@
+import type { Agent, AgentTask, AgentResult } from '../crew/protocol.js';
+import type { CrewContext } from '../crew/context.js';
+import type { AgentRole } from '../crew/types.js';
+export declare class StrategistAgent implements Agent {
+    readonly role: AgentRole;
+    execute(_task: AgentTask, ctx: CrewContext): Promise<AgentResult>;
+    private buildDefaultStrategy;
+}
+//# sourceMappingURL=strategist.d.ts.map

package/dist/agents/strategist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategist.d.ts","sourceRoot":"","sources":["../../src/agents/strategist.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAC,KAAK,EAAE,SAAS,EAAE,WAAW,EAAC,MAAM,qBAAqB,CAAC;AACvE,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAC,SAAS,EAA8B,MAAM,kBAAkB,CAAC;AAS7E,qBAAa,eAAgB,YAAW,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAgB;IAElC,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IA6DvE,OAAO,CAAC,oBAAoB;CAa/B"}

package/dist/agents/strategist.js

@@ -0,0 +1,87 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StrategistAgent = void 0;
+/**
+ * Strategist Agent — designs overall test strategy from impact analysis,
+ * cross-impact data, and regression risk.
+ */
+const provider_js_1 = require("../crew/provider.js");
+const strategist_js_1 = require("../prompts/strategist.js");
+const VALID_APPROACHES = new Set(['full-test', 'smoke-test', 'skip', 'manual-review']);
+const VALID_CATEGORIES = new Set([
+    'happy-path', 'edge-case', 'boundary', 'negative',
+    'state-transition', 'race-condition', 'permission', 'accessibility', 'performance',
+]);
+const VALID_RISK = new Set(['high', 'medium', 'low', 'none']);
+class StrategistAgent {
+    constructor() {
+        this.role = 'strategist';
+    }
+    async execute(_task, ctx) {
+        const warnings = [];
+        if (ctx.impactedFlows.length === 0) {
+            warnings.push('Strategist: no impacted flows to strategize.');
+            return { role: this.role, status: 'partial', output: [], warnings };
+        }
+        const prompt = (0, strategist_js_1.buildStrategistPrompt)({
+            impactedFlows: ctx.impactedFlows,
+            crossImpacts: ctx.crossImpacts,
+            regressionRisks: ctx.regressionRisks,
+        });
+        try {
+            const provider = await (0, provider_js_1.getCrewProvider)(ctx.providerOverride);
+            const response = await provider.generateText(prompt, {
+                maxTokens: 4000,
+                temperature: 0,
+                timeout: 45000,
+                systemPrompt: 'Return only valid JSON. Do not include markdown fences unless necessary.',
+            });
+            const parsed = (0, strategist_js_1.parseStrategistResponse)(response.text);
+            if (!parsed || parsed.strategy.length === 0) {
+                warnings.push('Strategist: LLM returned no strategy.');
+                // Fall back to default strategy
+                ctx.strategyEntries.push(...this.buildDefaultStrategy(ctx));
+                return { role: this.role, status: 'partial', output: ctx.strategyEntries, warnings };
+            }
+            const entries = parsed.strategy.map((s) => ({
+                flowId: s.flowId,
+                flowName: s.flowName,
+                priority: (['P0', 'P1', 'P2'].includes(s.priority) ? s.priority : 'P2'),
+                approach: VALID_APPROACHES.has(s.approach) ? s.approach : 'full-test',
+                rationale: s.rationale || '',
+                testCategories: (s.testCategories || []).filter((c) => VALID_CATEGORIES.has(c)),
+                crossImpactRisk: VALID_RISK.has(s.crossImpactRisk) ? s.crossImpactRisk : 'none',
+            }));
+            ctx.strategyEntries.push(...entries);
+            return {
+                role: this.role,
+                status: 'success',
+                output: entries,
+                usage: provider.getUsageStats(),
+                warnings,
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            warnings.push(`Strategist LLM failed: ${message}. Using default strategy.`);
+            ctx.strategyEntries.push(...this.buildDefaultStrategy(ctx));
+            return { role: this.role, status: 'partial', output: ctx.strategyEntries, warnings };
+        }
+    }
+    buildDefaultStrategy(ctx) {
+        return ctx.impactedFlows
+            .filter((f) => f.action !== 'cannot_determine')
+            .map((f) => ({
+            flowId: f.flowId,
+            flowName: f.flowName,
+            priority: f.priority,
+            approach: (f.action === 'create_spec' || f.action === 'add_scenarios' ? 'full-test' : 'smoke-test'),
+            rationale: 'Default strategy based on impact action.',
+            testCategories: ['happy-path', 'edge-case'],
+            crossImpactRisk: 'none',
+        }));
+    }
+}
+exports.StrategistAgent = StrategistAgent;

package/dist/agents/test-designer.d.ts

@@ -0,0 +1,8 @@
+import type { Agent, AgentTask, AgentResult } from '../crew/protocol.js';
+import type { CrewContext } from '../crew/context.js';
+import type { AgentRole } from '../crew/types.js';
+export declare class TestDesignerAgent implements Agent {
+    readonly role: AgentRole;
+    execute(_task: AgentTask, ctx: CrewContext): Promise<AgentResult>;
+}
+//# sourceMappingURL=test-designer.d.ts.map

package/dist/agents/test-designer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-designer.d.ts","sourceRoot":"","sources":["../../src/agents/test-designer.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAC,KAAK,EAAE,SAAS,EAAE,WAAW,EAAC,MAAM,qBAAqB,CAAC;AACvE,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAC,SAAS,EAAoD,MAAM,kBAAkB,CAAC;AASnG,qBAAa,iBAAkB,YAAW,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAmB;IAErC,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;CAmG1E"}

package/dist/agents/test-designer.js

@@ -0,0 +1,106 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TestDesignerAgent = void 0;
+/**
+ * Test Designer Agent — designs structured test cases across 9 categories.
+ * Takes strategist output + API surface + existing specs and produces TestDesign[].
+ */
+const provider_js_1 = require("../crew/provider.js");
+const spec_index_js_1 = require("../knowledge/spec_index.js");
+const test_designer_js_1 = require("../prompts/test-designer.js");
+const MAX_TEST_CASES_PER_FLOW = 15;
+const VALID_TYPES = new Set([
+    'happy-path', 'edge-case', 'boundary', 'negative',
+    'state-transition', 'race-condition', 'permission', 'accessibility', 'performance',
+]);
+class TestDesignerAgent {
+    constructor() {
+        this.role = 'test-designer';
+    }
+    async execute(_task, ctx) {
+        const warnings = [];
+        if (ctx.strategyEntries.length === 0) {
+            warnings.push('Test designer: no strategy entries to design tests for.');
+            return { role: this.role, status: 'partial', output: [], warnings };
+        }
+        // Only design tests for flows with full-test or smoke-test approach
+        const designable = ctx.strategyEntries.filter((s) => s.approach === 'full-test' || s.approach === 'smoke-test');
+        if (designable.length === 0) {
+            warnings.push('Test designer: all flows are skip or manual-review.');
+            return { role: this.role, status: 'partial', output: [], warnings };
+        }
+        let provider;
+        try {
+            provider = await (0, provider_js_1.getCrewProvider)(ctx.providerOverride);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            warnings.push(`Test designer provider unavailable: ${message}`);
+            return { role: this.role, status: 'failed', output: [], warnings };
+        }
+        const designs = [];
+        for (const strategy of designable) {
+            const flow = ctx.impactedFlows.find((f) => f.flowId === strategy.flowId);
+            if (!flow) {
+                warnings.push(`Test designer: strategy entry '${strategy.flowId}' has no matching flow.`);
+                continue;
+            }
+            const familySpecs = (0, spec_index_js_1.getSpecsForFamily)(ctx.specIndex, flow.routeFamily, flow.featureId);
+            const relevantCrossImpacts = ctx.crossImpacts.filter((ci) => ci.sourceFamily === flow.routeFamily || ci.affectedFamily === flow.routeFamily);
+            const prompt = (0, test_designer_js_1.buildTestDesignerPrompt)({
+                flow,
+                strategy,
+                apiSurface: ctx.apiSurface,
+                existingSpecs: familySpecs,
+                crossImpacts: relevantCrossImpacts,
+            });
+            try {
+                const response = await provider.generateText(prompt, {
+                    maxTokens: 4000,
+                    temperature: 0.1,
+                    timeout: 60000,
+                    systemPrompt: 'Return only valid JSON. Do not include markdown fences unless necessary.',
+                });
+                const parsed = (0, test_designer_js_1.parseTestDesignerResponse)(response.text);
+                if (!parsed || parsed.testDesign.testCases.length === 0) {
+                    warnings.push(`Test designer: no test cases returned for flow ${strategy.flowId}.`);
+                    continue;
+                }
+                const validatedCases = parsed.testDesign.testCases
+                    .filter((tc) => tc.name && tc.steps && tc.steps.length > 0)
+                    .map((tc) => ({
+                    name: tc.name,
+                    type: VALID_TYPES.has(tc.type) ? tc.type : 'happy-path',
+                    preconditions: Array.isArray(tc.preconditions) ? tc.preconditions : [],
+                    steps: Array.isArray(tc.steps) ? tc.steps : [],
+                    expectedOutcome: tc.expectedOutcome || '',
+                    priority: (['P0', 'P1', 'P2'].includes(tc.priority) ? tc.priority : 'P2'),
+                    rationale: tc.rationale || '',
+                }))
+                    .slice(0, MAX_TEST_CASES_PER_FLOW);
+                if (validatedCases.length > 0) {
+                    designs.push({
+                        flowId: strategy.flowId,
+                        flowName: strategy.flowName,
+                        testCases: validatedCases,
+                    });
+                }
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                warnings.push(`Test designer failed for flow ${strategy.flowId}: ${message}`);
+            }
+        }
+        ctx.testDesigns.push(...designs);
+        return {
+            role: this.role,
+            status: designs.length > 0 ? 'success' : 'partial',
+            output: designs,
+            usage: provider.getUsageStats(),
+            warnings,
+        };
+    }
+}
+exports.TestDesignerAgent = TestDesignerAgent;

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"crew.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/crew.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,aAAa,CAAC;AAI5C,wBAAsB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAgIpG"}

package/dist/cli/commands/crew.js

@@ -0,0 +1,137 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runCrewCommand = runCrewCommand;
+/**
+ * CLI command: crew — runs multi-agent QA analysis workflows.
+ */
+const config_js_1 = require("../../agent/config.js");
+const orchestrator_js_1 = require("../../crew/orchestrator.js");
+const impact_analyst_js_1 = require("../../agents/impact-analyst.js");
+const generator_js_1 = require("../../agents/generator.js");
+const executor_js_1 = require("../../agents/executor.js");
+const healer_js_1 = require("../../agents/healer.js");
+const strategist_js_1 = require("../../agents/strategist.js");
+const test_designer_js_1 = require("../../agents/test-designer.js");
+const cross_impact_js_1 = require("../../agents/cross-impact.js");
+const regression_advisor_js_1 = require("../../agents/regression-advisor.js");
+const VALID_WORKFLOWS = ['full-qa', 'quick-check', 'design-only'];
+async function runCrewCommand(args, autoConfig) {
+    if (!args.path && !autoConfig) {
+        console.error('Error: --path is required for crew command');
+        process.exit(1);
+    }
+    const { config } = (0, config_js_1.resolveConfig)(process.cwd(), autoConfig, {
+        path: args.path,
+        profile: args.profile,
+        testsRoot: args.testsRoot,
+        mode: 'impact',
+        gitSince: args.gitSince,
+        llmProvider: args.llmProvider,
+    });
+    const testsRoot = config.testsRoot || config.path;
+    const rawWorkflow = args.crewWorkflow || 'full-qa';
+    if (!VALID_WORKFLOWS.includes(rawWorkflow)) {
+        console.error(`Error: invalid workflow '${rawWorkflow}'. Valid: ${VALID_WORKFLOWS.join(', ')}`);
+        process.exit(1);
+    }
+    const workflowName = rawWorkflow;
+    const crewConfig = {
+        appPath: config.path,
+        testsRoot,
+        gitSince: args.gitSince || config.git.since,
+        routeFamilies: config.routeFamilies,
+        apiSurface: config.apiSurface,
+        workflow: workflowName,
+        providerOverride: args.llmProvider,
+        budgetUSD: args.budgetUSD,
+        dryRun: args.dryRun,
+    };
+    // Create orchestrator and register all agents
+    const orchestrator = new orchestrator_js_1.CrewOrchestrator();
+    orchestrator.registerAgent(new impact_analyst_js_1.ImpactAnalystAgent());
+    orchestrator.registerAgent(new generator_js_1.GeneratorAgent());
+    orchestrator.registerAgent(new executor_js_1.ExecutorAgent());
+    orchestrator.registerAgent(new healer_js_1.HealerAgent());
+    orchestrator.registerAgent(new strategist_js_1.StrategistAgent());
+    orchestrator.registerAgent(new test_designer_js_1.TestDesignerAgent());
+    orchestrator.registerAgent(new cross_impact_js_1.CrossImpactAgent());
+    orchestrator.registerAgent(new regression_advisor_js_1.RegressionAdvisorAgent());
+    let result;
+    try {
+        result = await orchestrator.run(crewConfig);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`Crew workflow failed: ${message}`);
+        process.exit(1);
+    }
+    const ctx = result.context;
+    // JSON output mode
+    if (args.jsonOutput) {
+        const jsonReport = {
+            workflow: workflowName,
+            changedFiles: ctx.changedFiles.length,
+            impactedFlows: ctx.impactedFlows,
+            strategyEntries: ctx.strategyEntries,
+            testDesigns: ctx.testDesigns,
+            crossImpacts: ctx.crossImpacts,
+            regressionRisks: ctx.regressionRisks,
+            findings: ctx.findings,
+            generatedSpecs: ctx.generatedSpecs.map((s) => ({ flowId: s.flowId, specPath: s.specPath, mode: s.mode, written: s.written })),
+            usage: { cost: ctx.usage.totalCost, requests: ctx.usage.requestCount, tokens: ctx.usage.totalTokens },
+            timings: result.timings,
+            warnings: result.warnings,
+        };
+        console.log(JSON.stringify(jsonReport, null, 2));
+        return;
+    }
+    // Human-readable output
+    console.log(`Crew workflow: ${workflowName}`);
+    console.log(`Changed files: ${ctx.changedFiles.length}`);
+    console.log(`Impacted flows: ${ctx.impactedFlows.length}`);
+    console.log(`Strategy entries: ${ctx.strategyEntries.length}`);
+    console.log(`Test designs: ${ctx.testDesigns.length} (${ctx.testDesigns.reduce((sum, td) => sum + td.testCases.length, 0)} test cases)`);
+    console.log(`Cross-impacts: ${ctx.crossImpacts.length}`);
+    console.log(`Regression risks: ${ctx.regressionRisks.length}`);
+    console.log(`Findings: ${ctx.findings.length}`);
+    console.log(`Generated specs: ${ctx.generatedSpecs.length}`);
+    console.log(`Cost: $${ctx.usage.totalCost.toFixed(4)}`);
+    if (ctx.strategyEntries.length > 0) {
+        console.log('\nTest Strategy:');
+        for (const entry of ctx.strategyEntries) {
+            console.log(`  ${entry.priority} ${entry.flowName} → ${entry.approach} [${entry.testCategories.join(', ')}]`);
+        }
+    }
+    if (ctx.testDesigns.length > 0) {
+        console.log('\nTest Designs:');
+        for (const design of ctx.testDesigns) {
+            console.log(`  ${design.flowName}: ${design.testCases.length} test cases`);
+            for (const tc of design.testCases) {
+                console.log(`    [${tc.type}] ${tc.name} (${tc.priority})`);
+            }
+        }
+    }
+    if (ctx.crossImpacts.length > 0) {
+        console.log('\nCross-Family Impacts:');
+        for (const ci of ctx.crossImpacts) {
+            console.log(`  ${ci.sourceFamily} → ${ci.affectedFamily} (${ci.riskLevel}): ${ci.sharedDependency}`);
+        }
+    }
+    if (result.timings && Object.keys(result.timings).length > 0) {
+        console.log('\nPhase timings:');
+        for (const [phase, ms] of Object.entries(result.timings)) {
+            console.log(`  ${phase}: ${ms}ms`);
+        }
+    }
+    if (result.warnings.length > 0) {
+        console.log(`\nWarnings: ${result.warnings.length}`);
+        for (const w of result.warnings.slice(0, 10)) {
+            console.log(`  - ${w}`);
+        }
+        if (result.warnings.length > 10) {
+            console.log(`  ... and ${result.warnings.length - 10} more`);
+        }
+    }
+}

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;AA8ID,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;AA+ID,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CA4EpD"}

package/dist/cli/parse_args.js

@@ -104,6 +104,7 @@ const FLAGS = {
     '--flow-catalog': { key: 'flowCatalogPath', type: 'string' },
     '--output': { key: 'trainOutput', type: 'string' },
     '--server-path': { key: 'serverPath', type: 'string' },
+    '--workflow': { key: 'crewWorkflow', type: 'string' },
     // -- number flags (with isFinite guard) --
     '--pipeline-scenarios': { key: 'pipelineScenarios', type: 'number' },
     '--time': { key: 'timeLimitMinutes', type: 'number' },
@@ -149,7 +150,7 @@ const COMMANDS = new Set([
     'init', 'impact', 'plan', 'heal', 'suggest', 'generate',
     'finalize-generated-tests', 'feedback',
     'traceability-capture', 'traceability-ingest',
-    'analyze', 'llm-health', 'train',
+    'analyze', 'llm-health', 'train', 'crew',
 ]);
 // ---------------------------------------------------------------------------
 // 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' | 'train';
+export type Command = 'init' | 'impact' | 'plan' | 'heal' | 'suggest' | 'generate' | 'finalize-generated-tests' | 'feedback' | 'traceability-capture' | 'traceability-ingest' | 'analyze' | 'llm-health' | 'train' | 'crew';
 export interface ParsedArgs {
     command?: Command;
     configPath?: string;
@@ -72,6 +72,7 @@ export interface ParsedArgs {
     trainOutput?: string;
     trainYes?: boolean;
     serverPath?: string;
+    crewWorkflow?: string;
     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":"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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.js

@@ -17,6 +17,7 @@ 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");
+const crew_js_1 = require("./cli/commands/crew.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);
@@ -61,6 +62,10 @@ async function main() {
         (0, heal_js_1.runHealCommand)(args, autoConfig);
         return;
     }
+    if (args.command === 'crew') {
+        await (0, crew_js_1.runCrewCommand)(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)();

package/dist/crew/context.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Crew Context — shared mutable state accumulated by agents across workflow phases.
+ */
+import type { RouteFamily, RouteFamilyManifest } from '../knowledge/route_families.js';
+import type { ApiSurfaceCatalog } from '../knowledge/api_surface.js';
+import type { SpecIndex } from '../knowledge/spec_index.js';
+import type { FlowDecision } from '../validation/output_schema.js';
+import type { ProviderUsageStats } from '../provider_interface.js';
+import type { GeneratedSpec } from '../pipeline/stage3_generation.js';
+import type { LoadedContext } from '../knowledge/context_loader.js';
+import type { FamilyGroup, PreprocessResult } from '../pipeline/stage0_preprocess.js';
+import type { AgentMessage } from './protocol.js';
+import type { TestDesign, CrossImpact, Finding, StrategyEntry, RegressionRisk } from './types.js';
+export interface CrewContext {
+    changedFiles: string[];
+    routeFamilies: RouteFamily[];
+    manifest: RouteFamilyManifest | null;
+    apiSurface: ApiSurfaceCatalog;
+    specIndex: SpecIndex;
+    context: LoadedContext;
+    familyGroups: FamilyGroup[];
+    preprocessResult: PreprocessResult | null;
+    appPath: string;
+    testsRoot: string;
+    gitSince: string;
+    providerOverride?: string;
+    impactedFlows: FlowDecision[];
+    strategyEntries: StrategyEntry[];
+    testDesigns: TestDesign[];
+    crossImpacts: CrossImpact[];
+    regressionRisks: RegressionRisk[];
+    findings: Finding[];
+    generatedSpecs: GeneratedSpec[];
+    usage: ProviderUsageStats;
+    messages: AgentMessage[];
+    warnings: string[];
+}
+export declare function createEmptyUsageStats(): ProviderUsageStats;
+export declare function mergeUsageStats(target: ProviderUsageStats, source: ProviderUsageStats): void;
+//# sourceMappingURL=context.d.ts.map