@yasserkhanorg/e2e-agents 1.7.6 → 1.8.0

package/dist/crew/orchestrator.d.ts

@@ -0,0 +1,36 @@
+import type { RouteFamilyConfig } from '../knowledge/route_families.js';
+import type { ApiSurfaceConfig } from '../knowledge/api_surface.js';
+import type { Agent, AgentMessage, AgentResult } from './protocol.js';
+import type { CrewContext } from './context.js';
+import type { AgentRole } from './types.js';
+import type { WorkflowName } from './workflows.js';
+export interface CrewConfig {
+    appPath: string;
+    testsRoot: string;
+    gitSince: string;
+    gitIncludeUncommitted?: boolean;
+    routeFamilies?: RouteFamilyConfig;
+    apiSurface?: ApiSurfaceConfig;
+    workflow?: WorkflowName;
+    providerOverride?: string;
+    budgetUSD?: number;
+    dryRun?: boolean;
+}
+export interface CrewResult {
+    context: CrewContext;
+    warnings: string[];
+    timings: Record<string, number>;
+}
+export declare class CrewOrchestrator {
+    private agents;
+    registerAgent(agent: Agent): void;
+    run(config: CrewConfig): Promise<CrewResult>;
+    dispatch(role: AgentRole, action: string, ctx: CrewContext): Promise<AgentResult>;
+    parallel(roles: AgentRole[], action: string, ctx: CrewContext): Promise<AgentResult[]>;
+    broadcast(msg: AgentMessage, ctx: CrewContext): Promise<void>;
+    private runBuiltInPhase;
+    private runParallel;
+    private runSequential;
+    private checkPhaseResults;
+}
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/crew/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/crew/orchestrator.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAC,KAAK,EAAE,YAAY,EAAE,WAAW,EAAY,MAAM,eAAe,CAAC;AAC/E,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,cAAc,CAAC;AAE9C,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAA6B,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAG7E,MAAM,WAAW,UAAU;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACvB,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,qBAAa,gBAAgB;IACzB,OAAO,CAAC,MAAM,CAA+B;IAE7C,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAI3B,GAAG,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAwE5C,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IA6BjF,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAKtF,SAAS,CAAC,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;YAerD,eAAe;YAwBf,WAAW;YAMX,aAAa;IAS3B,OAAO,CAAC,iBAAiB;CAM5B"}

package/dist/crew/orchestrator.js

@@ -0,0 +1,171 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CrewOrchestrator = void 0;
+/**
+ * Crew Orchestrator — executes workflow definitions by dispatching to agents.
+ */
+const git_js_1 = require("../agent/git.js");
+const stage0_preprocess_js_1 = require("../pipeline/stage0_preprocess.js");
+const logger_js_1 = require("../logger.js");
+const context_js_1 = require("./context.js");
+const workflows_js_1 = require("./workflows.js");
+class CrewOrchestrator {
+    constructor() {
+        this.agents = new Map();
+    }
+    registerAgent(agent) {
+        this.agents.set(agent.role, agent);
+    }
+    async run(config) {
+        const workflow = workflows_js_1.WORKFLOWS[config.workflow || 'full-qa'];
+        const timings = {};
+        const warnings = [];
+        // Step 1: Get changed files
+        const gitResult = (0, git_js_1.getChangedFiles)(config.appPath, config.gitSince, {
+            includeUncommitted: config.gitIncludeUncommitted,
+        });
+        if (gitResult.error) {
+            warnings.push(`Git diff warning: ${gitResult.error}`);
+        }
+        const changedFiles = gitResult.files
+            .map((f) => f.replace(/\\/g, '/'))
+            .filter((f) => !(0, git_js_1.isTestFile)(f));
+        if (changedFiles.length === 0) {
+            warnings.push('No changed application files detected.');
+        }
+        // Initialize context (will be populated during preprocess phase)
+        const ctx = {
+            changedFiles,
+            routeFamilies: [],
+            manifest: null,
+            apiSurface: { pageObjects: [], generatedAt: '' },
+            specIndex: { specs: [], indexedAt: '' },
+            context: { documents: [], warnings: [] },
+            familyGroups: [],
+            preprocessResult: null,
+            appPath: config.appPath,
+            testsRoot: config.testsRoot,
+            gitSince: config.gitSince,
+            providerOverride: config.providerOverride,
+            impactedFlows: [],
+            strategyEntries: [],
+            testDesigns: [],
+            crossImpacts: [],
+            regressionRisks: [],
+            findings: [],
+            generatedSpecs: [],
+            usage: (0, context_js_1.createEmptyUsageStats)(),
+            messages: [],
+            warnings,
+        };
+        // Execute each phase
+        for (const phase of workflow.phases) {
+            const timer = logger_js_1.logger.timer(`crew:${phase.name}`);
+            if (phase.handler === 'built-in') {
+                await this.runBuiltInPhase(phase.name, ctx, config);
+            }
+            else if (phase.parallel && phase.parallel.length > 0) {
+                await this.runParallel(phase.parallel, phase.name, ctx);
+            }
+            else if (phase.sequential && phase.sequential.length > 0) {
+                await this.runSequential(phase.sequential, phase.name, ctx);
+            }
+            else {
+                warnings.push(`Phase '${phase.name}' has no handler, parallel, or sequential agents — skipped.`);
+            }
+            timings[phase.name] = timer.end();
+            // Budget check
+            if (config.budgetUSD && ctx.usage.totalCost >= config.budgetUSD) {
+                warnings.push(`Budget limit reached ($${ctx.usage.totalCost.toFixed(4)} >= $${config.budgetUSD}). Stopping workflow.`);
+                break;
+            }
+        }
+        return { context: ctx, warnings, timings };
+    }
+    async dispatch(role, action, ctx) {
+        const agent = this.agents.get(role);
+        if (!agent) {
+            return {
+                role,
+                status: 'failed',
+                output: null,
+                warnings: [`Agent '${role}' is not registered.`],
+            };
+        }
+        const task = { role, action, input: null };
+        try {
+            const result = await agent.execute(task, ctx);
+            if (result.usage) {
+                (0, context_js_1.mergeUsageStats)(ctx.usage, result.usage);
+            }
+            if (result.warnings && result.warnings.length > 0) {
+                ctx.warnings.push(...result.warnings);
+            }
+            return result;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            ctx.warnings.push(`Agent '${role}' failed: ${message}`);
+            return { role, status: 'failed', output: null, warnings: [message] };
+        }
+    }
+    async parallel(roles, action, ctx) {
+        const promises = roles.map((role) => this.dispatch(role, action, ctx));
+        return Promise.all(promises);
+    }
+    async broadcast(msg, ctx) {
+        ctx.messages.push(msg);
+        const promises = [];
+        for (const agent of this.agents.values()) {
+            if (agent.onMessage && agent.role !== msg.from) {
+                promises.push(agent.onMessage(msg).catch((err) => {
+                    ctx.warnings.push(`Broadcast to ${agent.role} failed: ${err instanceof Error ? err.message : String(err)}`);
+                }));
+            }
+        }
+        await Promise.all(promises);
+    }
+    async runBuiltInPhase(name, ctx, config) {
+        if (name === 'preprocess') {
+            if (ctx.changedFiles.length === 0) {
+                return;
+            }
+            const result = (0, stage0_preprocess_js_1.preprocess)(ctx.changedFiles, {
+                appPath: config.appPath,
+                testsRoot: config.testsRoot,
+                routeFamilies: config.routeFamilies,
+                apiSurface: config.apiSurface,
+            });
+            ctx.preprocessResult = result;
+            ctx.manifest = result.manifest;
+            ctx.routeFamilies = result.manifest?.families || [];
+            ctx.apiSurface = result.apiSurface;
+            ctx.specIndex = result.specIndex;
+            ctx.context = result.context;
+            ctx.familyGroups = result.familyGroups;
+            ctx.warnings.push(...result.warnings);
+        }
+    }
+    async runParallel(roles, phaseName, ctx) {
+        logger_js_1.logger.info(`Crew phase '${phaseName}': running ${roles.join(', ')} in parallel`);
+        const results = await this.parallel(roles, phaseName, ctx);
+        this.checkPhaseResults(phaseName, results, ctx);
+    }
+    async runSequential(roles, phaseName, ctx) {
+        logger_js_1.logger.info(`Crew phase '${phaseName}': running ${roles.join(' → ')} sequentially`);
+        const results = [];
+        for (const role of roles) {
+            results.push(await this.dispatch(role, phaseName, ctx));
+        }
+        this.checkPhaseResults(phaseName, results, ctx);
+    }
+    checkPhaseResults(phaseName, results, ctx) {
+        const allFailed = results.length > 0 && results.every((r) => r.status === 'failed');
+        if (allFailed) {
+            ctx.warnings.push(`Phase '${phaseName}': all ${results.length} agent(s) failed. Downstream phases may produce empty results.`);
+        }
+    }
+}
+exports.CrewOrchestrator = CrewOrchestrator;

package/dist/crew/protocol.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Agent Crew Protocol — core interfaces for inter-agent communication and execution.
+ */
+import type { ProviderUsageStats } from '../provider_interface.js';
+import type { AgentRole } from './types.js';
+import type { CrewContext } from './context.js';
+export interface AgentMessage {
+    id: string;
+    from: AgentRole;
+    to: AgentRole | 'broadcast';
+    type: 'task' | 'result' | 'escalation' | 'finding';
+    payload: unknown;
+    correlationId: string;
+    timestamp: number;
+}
+export interface AgentTask {
+    role: AgentRole;
+    action: string;
+    input: unknown;
+}
+export interface AgentResult {
+    role: AgentRole;
+    status: 'success' | 'partial' | 'failed';
+    output: unknown;
+    usage?: ProviderUsageStats;
+    warnings: string[];
+}
+export interface Agent {
+    role: AgentRole;
+    execute(task: AgentTask, ctx: CrewContext): Promise<AgentResult>;
+    onMessage?(msg: AgentMessage): Promise<void>;
+}
+//# sourceMappingURL=protocol.d.ts.map

package/dist/crew/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/crew/protocol.ts"],"names":[],"mappings":"AAGA;;GAEG;AAEH,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,cAAc,CAAC;AAE9C,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,CAAC;IAChB,EAAE,EAAE,SAAS,GAAG,WAAW,CAAC;IAC5B,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,YAAY,GAAG,SAAS,CAAC;IACnD,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACtB,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IACzC,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,KAAK;IAClB,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACjE,SAAS,CAAC,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD"}

package/dist/crew/protocol.js

@@ -0,0 +1,4 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/crew/provider.d.ts

@@ -0,0 +1,3 @@
+import type { LLMProvider } from '../provider_interface.js';
+export declare function getCrewProvider(providerOverride?: string): Promise<LLMProvider>;
+//# sourceMappingURL=provider.d.ts.map

package/dist/crew/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/crew/provider.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,0BAA0B,CAAC;AAE1D,wBAAsB,eAAe,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAKrF"}

package/dist/crew/provider.js

@@ -0,0 +1,16 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCrewProvider = getCrewProvider;
+/**
+ * Shared provider creation for crew agents — ensures consistent provider
+ * instantiation and prevents usage stats fragmentation.
+ */
+const provider_factory_js_1 = require("../provider_factory.js");
+async function getCrewProvider(providerOverride) {
+    if (providerOverride) {
+        return provider_factory_js_1.LLMProviderFactory.createFromString(providerOverride);
+    }
+    return provider_factory_js_1.LLMProviderFactory.createFromEnv();
+}

package/dist/crew/sanitize.d.ts

@@ -0,0 +1,3 @@
+export declare function sanitizeForPrompt(value: string): string;
+export declare function sanitizeArray(values: string[]): string[];
+//# sourceMappingURL=sanitize.d.ts.map

package/dist/crew/sanitize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../src/crew/sanitize.ts"],"names":[],"mappings":"AAqBA,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMvD;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAExD"}

package/dist/crew/sanitize.js

@@ -0,0 +1,31 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sanitizeForPrompt = sanitizeForPrompt;
+exports.sanitizeArray = sanitizeArray;
+/**
+ * Sanitize strings before interpolating into LLM prompts.
+ * Strips common prompt injection patterns while preserving useful content.
+ */
+const INJECTION_PATTERNS = [
+    /ignore\s+(all\s+)?previous\s+instructions/gi,
+    /disregard\s+(all\s+)?(above|prior|previous)/gi,
+    /system\s*:\s*/gi,
+    /\[INST\]/gi,
+    /<<SYS>>/gi,
+    /<\|im_start\|>/gi,
+    /\bHuman\s*:\s*/gi,
+    /\bAssistant\s*:\s*/gi,
+];
+const MAX_FIELD_LENGTH = 2000;
+function sanitizeForPrompt(value) {
+    let sanitized = value.slice(0, MAX_FIELD_LENGTH);
+    for (const pattern of INJECTION_PATTERNS) {
+        sanitized = sanitized.replace(pattern, '[filtered]');
+    }
+    return sanitized;
+}
+function sanitizeArray(values) {
+    return values.map((v) => sanitizeForPrompt(v));
+}

package/dist/crew/types.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Crew data types — structured test design, cross-impact analysis, and findings.
+ */
+export type TestCaseType = 'happy-path' | 'edge-case' | 'boundary' | 'negative' | 'state-transition' | 'race-condition' | 'permission' | 'accessibility' | 'performance';
+export interface TestCase {
+    name: string;
+    type: TestCaseType;
+    preconditions: string[];
+    steps: string[];
+    expectedOutcome: string;
+    priority: 'P0' | 'P1' | 'P2';
+    rationale: string;
+}
+export interface TestDesign {
+    flowId: string;
+    flowName: string;
+    testCases: TestCase[];
+}
+export interface CrossImpact {
+    sourceFamily: string;
+    affectedFamily: string;
+    sharedDependency: string;
+    riskLevel: 'high' | 'medium' | 'low';
+    evidence: string;
+}
+export interface Finding {
+    id: string;
+    type: 'bug' | 'gap' | 'risk' | 'flaky';
+    severity: 'critical' | 'high' | 'medium' | 'low';
+    source: AgentRole;
+    summary: string;
+    details: string;
+    relatedFlows: string[];
+}
+export interface RegressionRisk {
+    familyId: string;
+    filePattern: string;
+    riskScore: number;
+    reason: string;
+    historicalFailures: number;
+}
+export interface StrategyEntry {
+    flowId: string;
+    flowName: string;
+    priority: 'P0' | 'P1' | 'P2';
+    approach: 'full-test' | 'smoke-test' | 'skip' | 'manual-review';
+    rationale: string;
+    testCategories: TestCaseType[];
+    crossImpactRisk: 'high' | 'medium' | 'low' | 'none';
+}
+export type AgentRole = 'strategist' | 'test-designer' | 'cross-impact' | 'regression-advisor' | 'impact-analyst' | 'coverage-evaluator' | 'generator' | 'executor' | 'healer' | 'explorer';
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/crew/types.ts"],"names":[],"mappings":"AAGA;;GAEG;AAEH,MAAM,MAAM,YAAY,GAClB,YAAY,GACZ,WAAW,GACX,UAAU,GACV,UAAU,GACV,kBAAkB,GAClB,gBAAgB,GAChB,YAAY,GACZ,eAAe,GACf,aAAa,CAAC;AAEpB,MAAM,WAAW,QAAQ;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,YAAY,CAAC;IACnB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,QAAQ,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACrC,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;IACvC,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACjD,MAAM,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC7B,QAAQ,EAAE,WAAW,GAAG,YAAY,GAAG,MAAM,GAAG,eAAe,CAAC;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,YAAY,EAAE,CAAC;IAC/B,eAAe,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;CACvD;AAED,MAAM,MAAM,SAAS,GACf,YAAY,GACZ,eAAe,GACf,cAAc,GACd,oBAAoB,GACpB,gBAAgB,GAChB,oBAAoB,GACpB,WAAW,GACX,UAAU,GACV,QAAQ,GACR,UAAU,CAAC"}

package/dist/crew/types.js

@@ -0,0 +1,4 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/crew/workflows.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Predefined workflow definitions — playbooks that compose agents into phases.
+ *
+ * Data flow through full-qa workflow:
+ *
+ *   preprocess (built-in)
+ *     → populates: familyGroups, routeFamilies, manifest, apiSurface, specIndex, context
+ *
+ *   understand (parallel):
+ *     impact-analyst      → writes: impactedFlows
+ *     cross-impact        → writes: crossImpacts
+ *     regression-advisor  → writes: regressionRisks
+ *
+ *   strategize (sequential):
+ *     strategist           → reads: impactedFlows, crossImpacts, regressionRisks
+ *                          → writes: strategyEntries
+ *     test-designer        → reads: strategyEntries, impactedFlows, crossImpacts, apiSurface, specIndex
+ *                          → writes: testDesigns
+ *
+ *   execute (parallel):
+ *     generator            → reads: impactedFlows, testDesigns, apiSurface
+ *                          → writes: generatedSpecs
+ *
+ *   validate (sequential):
+ *     executor             → reads: generatedSpecs, impactedFlows
+ *     healer               → reads: generatedSpecs, impactedFlows
+ */
+import type { AgentRole } from './types.js';
+export type WorkflowPhase = {
+    name: string;
+    handler: 'built-in';
+    parallel?: never;
+    sequential?: never;
+} | {
+    name: string;
+    handler?: never;
+    parallel: AgentRole[];
+    sequential?: never;
+} | {
+    name: string;
+    handler?: never;
+    parallel?: never;
+    sequential: AgentRole[];
+};
+export interface WorkflowDef {
+    name: string;
+    description: string;
+    phases: WorkflowPhase[];
+}
+export type WorkflowName = 'full-qa' | 'quick-check' | 'design-only';
+export declare const WORKFLOWS: Record<WorkflowName, WorkflowDef>;
+//# sourceMappingURL=workflows.d.ts.map

package/dist/crew/workflows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflows.d.ts","sourceRoot":"","sources":["../../src/crew/workflows.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,YAAY,CAAC;AAE1C,MAAM,MAAM,aAAa,GACnB;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,EAAE,KAAK,CAAC;IAAC,UAAU,CAAC,EAAE,KAAK,CAAA;CAAC,GACzE;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,SAAS,EAAE,CAAC;IAAC,UAAU,CAAC,EAAE,KAAK,CAAA;CAAC,GAC1E;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,EAAE,KAAK,CAAC;IAAC,UAAU,EAAE,SAAS,EAAE,CAAA;CAAC,CAAC;AAEjF,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,aAAa,GAAG,aAAa,CAAC;AAErE,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,YAAY,EAAE,WAAW,CA8BvD,CAAC"}

package/dist/crew/workflows.js

@@ -0,0 +1,36 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WORKFLOWS = void 0;
+exports.WORKFLOWS = {
+    'full-qa': {
+        name: 'full-qa',
+        description: 'Full multi-agent QA analysis: understand → strategize → execute → validate',
+        phases: [
+            { name: 'preprocess', handler: 'built-in' },
+            { name: 'understand', parallel: ['impact-analyst', 'cross-impact', 'regression-advisor'] },
+            { name: 'strategize', sequential: ['strategist', 'test-designer'] },
+            { name: 'execute', parallel: ['generator'] },
+            { name: 'validate', sequential: ['executor', 'healer'] },
+        ],
+    },
+    'quick-check': {
+        name: 'quick-check',
+        description: 'Quick impact analysis with strategy recommendations',
+        phases: [
+            { name: 'preprocess', handler: 'built-in' },
+            { name: 'understand', parallel: ['impact-analyst'] },
+            { name: 'strategize', sequential: ['strategist'] },
+        ],
+    },
+    'design-only': {
+        name: 'design-only',
+        description: 'Impact analysis through test design — no generation or execution',
+        phases: [
+            { name: 'preprocess', handler: 'built-in' },
+            { name: 'understand', parallel: ['impact-analyst', 'cross-impact'] },
+            { name: 'strategize', sequential: ['strategist', 'test-designer'] },
+        ],
+    },
+};

package/dist/esm/agent/git.js

@@ -143,6 +143,50 @@ function parseStatusLines(lines) {
     }
     return files;
 }
+// Comment-line patterns by file extension.
+// A diff that ONLY touches these lines is a comment-only change (typo fix, doc update).
+const COMMENT_PATTERNS = [
+    { extensions: ['.go'], pattern: /^\s*(\/\/|\/\*|\*)/ },
+    { extensions: ['.ts', '.tsx', '.js', '.jsx'], pattern: /^\s*(\/\/|\/\*|\*|\*\/)/ },
+    { extensions: ['.py'], pattern: /^\s*#/ },
+    { extensions: ['.css', '.scss'], pattern: /^\s*(\/\*|\*|\*\/)/ },
+];
+/**
+ * Check if a file's diff only changes comment lines (no code changes).
+ * Returns true if the diff is comment-only and can be safely excluded.
+ */
+function isCommentOnlyDiff(file, repoRoot, baseRef) {
+    const diff = runGitRaw(['diff', `${baseRef}..HEAD`, '-U0', '--', file], repoRoot);
+    if (!diff)
+        return false;
+    const ext = file.slice(file.lastIndexOf('.'));
+    const commentEntry = COMMENT_PATTERNS.find((cp) => cp.extensions.includes(ext));
+    if (!commentEntry)
+        return false;
+    // Extract only added/removed content lines (skip diff headers)
+    const contentLines = diff
+        .split('\n')
+        .filter((line) => (line.startsWith('+') || line.startsWith('-')) && !line.startsWith('+++') && !line.startsWith('---'));
+    if (contentLines.length === 0)
+        return false;
+    // Every changed line must be a comment line
+    return contentLines.every((line) => {
+        const content = line.slice(1).trim(); // Remove +/- prefix
+        return content === '' || commentEntry.pattern.test(content);
+    });
+}
+/**
+ * Check if a file path is a test file (spec, test, or in test directories).
+ * Shared across pipeline and crew orchestrators.
+ */
+export function isTestFile(file) {
+    const normalized = file.replace(/\\/g, '/');
+    return /\.(spec|test)\.(ts|tsx|js|jsx)$/.test(normalized) ||
+        /_test\.go$/.test(normalized) ||
+        normalized.includes('__tests__/') ||
+        normalized.includes('/tests/') ||
+        normalized.includes('/test/');
+}
 export function getChangedFiles(appRoot, since, options) {
     try {
         const files = new Set();
@@ -183,6 +227,10 @@ export function getChangedFiles(appRoot, since, options) {
         const filteredTestFiles = [];
         for (const f of allFiles) {
             if (isRelevantFile(f)) {
+                // Skip files where the diff only touches comments (typo fixes, doc updates)
+                if (isCommentOnlyDiff(f, repoRoot, baseRef)) {
+                    continue;
+                }
                 relevant.push(f);
             }
             else {

package/dist/esm/agents/coverage-evaluator.js

@@ -0,0 +1,37 @@
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+/**
+ * Coverage Evaluator Agent — wraps pipeline stage2 (coverage evaluation) in the Agent interface.
+ */
+import { runCoverageStage } from '../pipeline/stage2_coverage.js';
+export class CoverageEvaluatorAgent {
+    constructor() {
+        this.role = 'coverage-evaluator';
+    }
+    async execute(_task, ctx) {
+        const warnings = [];
+        if (ctx.impactedFlows.length === 0) {
+            warnings.push('Coverage evaluator: no impacted flows to evaluate.');
+            return { role: this.role, status: 'partial', output: [], warnings };
+        }
+        try {
+            const result = await runCoverageStage(ctx.impactedFlows, ctx.specIndex, ctx.context, ctx.testsRoot, { provider: ctx.providerOverride });
+            // Replace impacted flows with coverage-enriched versions.
+            // This is intentionally a full replace (not push) because coverage evaluation
+            // returns the same flow IDs with updated coverage fields.
+            ctx.impactedFlows = result.decisions;
+            warnings.push(...result.warnings);
+            return {
+                role: this.role,
+                status: 'success',
+                output: result.decisions,
+                warnings,
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            warnings.push(`Coverage evaluator failed: ${message}`);
+            return { role: this.role, status: 'failed', output: null, warnings };
+        }
+    }
+}