@yasserkhanorg/e2e-agents 1.7.7 → 1.8.0

package/dist/esm/prompts/test-designer.js

@@ -0,0 +1,107 @@
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+import { formatApiSurfaceForPrompt } from '../knowledge/api_surface.js';
+import { sanitizeForPrompt } from '../crew/sanitize.js';
+export function buildTestDesignerPrompt(ctx) {
+    const relevantClasses = ctx.apiSurface.pageObjects
+        .map((po) => po.className)
+        .filter((name) => {
+        const lower = name.toLowerCase();
+        const hints = [ctx.flow.routeFamily, ctx.flow.featureId, ...ctx.flow.userActions.join(' ').split(/\s+/)]
+            .filter(Boolean)
+            .map((s) => s.toLowerCase().replace(/[^a-z]/g, ''));
+        return lower.includes('page') || hints.some((h) => h.length > 3 && lower.includes(h));
+    })
+        .slice(0, 10);
+    const apiBlock = relevantClasses.length > 0
+        ? formatApiSurfaceForPrompt(ctx.apiSurface, relevantClasses)
+        : 'No page objects available.';
+    const existingSpecsBlock = ctx.existingSpecs.length > 0
+        ? ctx.existingSpecs.map((s) => `- ${s.relativePath}: ${s.testTitles.join(', ')}`).join('\n')
+        : 'No existing specs.';
+    const crossImpactBlock = ctx.crossImpacts.length > 0
+        ? ctx.crossImpacts.map((ci) => `- ${ci.sourceFamily} → ${ci.affectedFamily}: ${ci.sharedDependency} (${ci.riskLevel})`).join('\n')
+        : 'None detected.';
+    const categories = ctx.strategy.testCategories.join(', ');
+    return [
+        'You are a senior QA engineer designing comprehensive test cases for a Mattermost user flow.',
+        '',
+        `FLOW: ${ctx.flow.flowName}`,
+        `Flow ID: ${ctx.flow.flowId}`,
+        `Route Family: ${ctx.flow.routeFamily}${ctx.flow.featureId ? ` / ${ctx.flow.featureId}` : ''}`,
+        `Route: ${ctx.flow.specificRoute || '(not specified)'}`,
+        `Priority: ${ctx.strategy.priority}`,
+        `Approach: ${ctx.strategy.approach}`,
+        `User Actions: ${sanitizeForPrompt(ctx.flow.userActions.join('; ') || 'unknown')}`,
+        `Evidence: ${sanitizeForPrompt(ctx.flow.evidence)}`,
+        '',
+        `REQUIRED TEST CATEGORIES: ${categories}`,
+        '',
+        'AVAILABLE PAGE OBJECTS:',
+        apiBlock,
+        '',
+        'EXISTING SPECS (avoid duplicating these):',
+        existingSpecsBlock,
+        '',
+        'CROSS-FAMILY IMPACTS:',
+        crossImpactBlock,
+        '',
+        'TASK: Design structured test cases for this flow.',
+        '',
+        'Return strict JSON only with this shape:',
+        '{"testDesign":{"flowId":"<id>","flowName":"<name>","testCases":[{"name":"<descriptive name>","type":"<category>","preconditions":["<state required>"],"steps":["<user action>"],"expectedOutcome":"<what should happen>","priority":"P0|P1|P2","rationale":"<why this test matters>"}]}}',
+        '',
+        'TYPE VALUES: happy-path, edge-case, boundary, negative, state-transition, race-condition, permission, accessibility, performance',
+        '',
+        'Rules:',
+        '- Every test must describe a specific USER ACTION, not an implementation detail.',
+        '- Steps must be concrete: "click Create Channel button" not "test channel creation".',
+        '- Include preconditions (logged-in role, existing data state, etc.).',
+        '- Reference only page objects and methods listed above.',
+        '- Include a mandatory rationale explaining why this specific test case matters.',
+        '- Do NOT duplicate tests already covered by existing specs.',
+        '- Maximum 15 test cases per flow.',
+        '- For accessibility: test keyboard navigation, screen reader support, ARIA labels.',
+        '- For performance: test with realistic data volumes, measure load times.',
+        '- For edge cases: test unicode input, max-length fields, empty states, concurrent edits.',
+        '',
+        'FEW-SHOT EXAMPLES:',
+        '',
+        'Edge case example:',
+        '```json',
+        '{"name":"channel creation with unicode characters and max-length name","type":"edge-case","preconditions":["logged in as team member","team has < 1000 channels"],"steps":["open create channel dialog","enter 64-character name with emoji and CJK characters","click Create"],"expectedOutcome":"channel created successfully, name renders correctly in sidebar and header","priority":"P1","rationale":"catches encoding issues in channel name storage and rendering"}',
+        '```',
+        '',
+        'Permission example:',
+        '```json',
+        '{"name":"guest user cannot archive a public channel","type":"permission","preconditions":["logged in as guest user","guest has access to public channel"],"steps":["open channel header menu","look for Archive Channel option"],"expectedOutcome":"Archive Channel option is not visible in the menu","priority":"P0","rationale":"permission escalation bug — guests archiving channels could disrupt entire teams"}',
+        '```',
+        '',
+        'Accessibility example:',
+        '```json',
+        '{"name":"keyboard navigation through channel switcher results","type":"accessibility","preconditions":["logged in","channel switcher open via Ctrl+K"],"steps":["type partial channel name","press ArrowDown to navigate results","press Enter to select"],"expectedOutcome":"focus moves visually and via aria-activedescendant, selected channel opens","priority":"P1","rationale":"screen reader users rely on keyboard navigation — broken focus management makes the app unusable"}',
+        '```',
+    ].join('\n');
+}
+export function parseTestDesignerResponse(text) {
+    const fenced = text.match(/```(?:json)?\s*([\s\S]*?)```/i);
+    const candidates = fenced ? [fenced[1], text] : [text];
+    for (const candidate of candidates) {
+        const start = candidate.indexOf('{');
+        const end = candidate.lastIndexOf('}');
+        if (start < 0 || end <= start) {
+            continue;
+        }
+        const raw = candidate.slice(start, end + 1);
+        try {
+            const parsed = JSON.parse(raw);
+            if (parsed?.testDesign?.testCases && Array.isArray(parsed.testDesign.testCases)) {
+                return parsed;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return null;
+}

package/dist/index.d.ts

@@ -54,6 +54,23 @@ export type { PlanReport } from './agent/plan.js';
 export { runAgenticGeneration } from './agentic/runner.js';
 export type { ScenarioInput, AgenticRunOptions } from './agentic/runner.js';
 export type { AgenticConfig, AgenticResult, AgenticSummary, PlaywrightRunResult, TestFailure } from './agentic/types.js';
+export { CrewOrchestrator } from './crew/orchestrator.js';
+export type { CrewConfig, CrewResult } from './crew/orchestrator.js';
+export type { CrewContext } from './crew/context.js';
+export type { Agent, AgentTask, AgentResult, AgentMessage } from './crew/protocol.js';
+export type { AgentRole, TestCaseType, TestCase, TestDesign, CrossImpact, Finding, RegressionRisk, StrategyEntry, } from './crew/types.js';
+export type { WorkflowDef, WorkflowName } from './crew/workflows.js';
+export { WORKFLOWS } from './crew/workflows.js';
+export { ImpactAnalystAgent } from './agents/impact-analyst.js';
+export { CoverageEvaluatorAgent } from './agents/coverage-evaluator.js';
+export { GeneratorAgent } from './agents/generator.js';
+export { ExecutorAgent } from './agents/executor.js';
+export { HealerAgent } from './agents/healer.js';
+export { ExplorerAgent } from './agents/explorer.js';
+export { StrategistAgent } from './agents/strategist.js';
+export { TestDesignerAgent } from './agents/test-designer.js';
+export { CrossImpactAgent } from './agents/cross-impact.js';
+export { RegressionAdvisorAgent } from './agents/regression-advisor.js';
 export { scanProject } from './training/scanner.js';
 export { mergeFamilies, detectStaleFamilies } from './training/merger.js';
 export { enrichFamilies } from './training/enricher.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AAGH,YAAY,EACR,WAAW,EACX,eAAe,EACf,UAAU,EACV,WAAW,EACX,UAAU,EACV,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,YAAY,GACf,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAC,gBAAgB,EAAE,0BAA0B,EAAC,MAAM,yBAAyB,CAAC;AAGrF,OAAO,EAAC,iBAAiB,EAAE,mBAAmB,EAAC,MAAM,yBAAyB,CAAC;AAC/E,OAAO,EAAC,cAAc,EAAE,gBAAgB,EAAC,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAC,cAAc,EAAE,gBAAgB,EAAC,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAC,cAAc,EAAC,MAAM,sBAAsB,CAAC;AAGpD,OAAO,EAAC,kBAAkB,EAAE,qBAAqB,EAAC,MAAM,uBAAuB,CAAC;AAChF,YAAY,EAAC,YAAY,EAAC,MAAM,uBAAuB,CAAC;AAGxD,OAAO,EAAC,0BAA0B,EAAE,2BAA2B,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,mBAAmB,EAAC,MAAM,UAAU,CAAC;AACjJ,YAAY,EACR,eAAe,EACf,sBAAsB,EACtB,4BAA4B,EAC5B,6BAA6B,GAChC,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAC,aAAa,IAAI,eAAe,EAAE,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAC,MAAM,2BAA2B,CAAC;AAC3H,YAAY,EAAC,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,UAAU,EAAE,cAAc,EAAE,SAAS,EAAC,MAAM,2BAA2B,CAAC;AAC5K,OAAO,EAAC,gBAAgB,EAAC,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAC,mBAAmB,EAAC,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAC,0BAA0B,EAAE,eAAe,EAAE,cAAc,EAAE,qBAAqB,EAAC,MAAM,qBAAqB,CAAC;AACvH,YAAY,EAAC,2BAA2B,EAAE,kBAAkB,EAAE,YAAY,EAAE,kBAAkB,EAAC,MAAM,qBAAqB,CAAC;AAC3H,OAAO,EAAC,sBAAsB,EAAC,MAAM,oBAAoB,CAAC;AAC1D,YAAY,EAAC,6BAA6B,EAAE,4BAA4B,EAAC,MAAM,oBAAoB,CAAC;AACpG,OAAO,EAAC,uBAAuB,EAAC,MAAM,gCAAgC,CAAC;AACvE,YAAY,EAAC,yBAAyB,EAAE,wBAAwB,EAAE,uBAAuB,EAAC,MAAM,gCAAgC,CAAC;AACjI,OAAO,EAAC,wBAAwB,EAAC,MAAM,iCAAiC,CAAC;AACzE,YAAY,EAAC,0BAA0B,EAAE,yBAAyB,EAAC,MAAM,iCAAiC,CAAC;AAG3G,OAAO,EAAC,WAAW,EAAC,MAAM,4BAA4B,CAAC;AACvD,YAAY,EAAC,cAAc,EAAE,cAAc,EAAC,MAAM,4BAA4B,CAAC;AAC/E,YAAY,EAAC,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,UAAU,EAAE,cAAc,EAAC,MAAM,+BAA+B,CAAC;AACrI,OAAO,EAAC,kBAAkB,EAAC,MAAM,iCAAiC,CAAC;AACnE,YAAY,EAAC,gBAAgB,EAAE,gBAAgB,EAAE,aAAa,EAAC,MAAM,iCAAiC,CAAC;AACvG,OAAO,EAAC,qBAAqB,EAAE,uBAAuB,EAAE,yBAAyB,EAAC,MAAM,yBAAyB,CAAC;AAClH,YAAY,EAAC,uBAAuB,EAAE,uBAAuB,EAAC,MAAM,yBAAyB,CAAC;AAC9F,OAAO,EAAC,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,kBAAkB,EAAC,MAAM,2BAA2B,CAAC;AAC/G,YAAY,EAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAC,MAAM,2BAA2B,CAAC;AAClF,OAAO,EAAC,eAAe,EAAE,qBAAqB,EAAC,MAAM,mBAAmB,CAAC;AACzE,YAAY,EAAC,iBAAiB,EAAC,MAAM,mBAAmB,CAAC;AAGzD,OAAO,EAAC,uBAAuB,EAAE,mBAAmB,EAAE,4BAA4B,EAAE,qBAAqB,EAAE,sBAAsB,EAAC,MAAM,+BAA+B,CAAC;AACxK,YAAY,EAAC,WAAW,EAAE,YAAY,EAAE,mBAAmB,EAAE,WAAW,EAAE,eAAe,EAAC,MAAM,+BAA+B,CAAC;AAChI,OAAO,EAAC,eAAe,EAAE,qBAAqB,EAAC,MAAM,4BAA4B,CAAC;AAClF,YAAY,EAAC,iBAAiB,EAAE,iBAAiB,EAAC,MAAM,4BAA4B,CAAC;AACrF,OAAO,EAAC,cAAc,EAAE,iBAAiB,EAAC,MAAM,2BAA2B,CAAC;AAC5E,YAAY,EAAC,SAAS,EAAE,SAAS,EAAC,MAAM,2BAA2B,CAAC;AAGpE,YAAY,EAAC,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAC,MAAM,kBAAkB,CAAC;AACnG,YAAY,EAAC,UAAU,EAAC,MAAM,iBAAiB,CAAC;AAGhD,OAAO,EAAC,oBAAoB,EAAC,MAAM,qBAAqB,CAAC;AACzD,YAAY,EAAC,aAAa,EAAE,iBAAiB,EAAC,MAAM,qBAAqB,CAAC;AAC1E,YAAY,EAAC,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,mBAAmB,EAAE,WAAW,EAAC,MAAM,oBAAoB,CAAC;AAGvH,OAAO,EAAC,WAAW,EAAC,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAC,aAAa,EAAE,mBAAmB,EAAC,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAC,cAAc,EAAC,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAC,cAAc,EAAE,cAAc,EAAE,qBAAqB,EAAE,sBAAsB,EAAC,MAAM,yBAAyB,CAAC;AACtH,YAAY,EACR,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EACxD,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,WAAW,EAAE,YAAY,GAClF,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -3,7 +3,7 @@
 // See LICENSE.txt for license information.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runAgenticGeneration = exports.getSpecsForFamily = exports.buildSpecIndex = exports.loadOrBuildApiSurface = exports.buildApiSurface = exports.getUserFlowsForBinding = exports.getPriorityForBinding = exports.getCypressSpecDirsForBinding = exports.bindFilesToFamilies = exports.loadRouteFamilyManifest = exports.buildQualityFixPrompt = exports.buildHealPrompt = exports.renderHealMarkdown = exports.resolveHealTargets = exports.healFromReport = exports.runHealStage = exports.detectHallucinatedMethods = exports.parseGenerationResponse = exports.buildGenerationPrompt = exports.runGenerationStage = exports.runPipeline = exports.captureTraceabilityInput = exports.ingestTraceabilityInput = exports.finalizeGeneratedTests = exports.getAdaptiveThresholds = exports.readFlakyTests = exports.readCalibration = exports.appendFeedbackAndRecompute = exports.buildPlanFromImpact = exports.extractScenarios = exports.getPartialGaps = exports.getGapsWithSuppressed = exports.getGaps = exports.analyzeImpactV2 = exports.captureTraceability = exports.ingestTraceability = exports.handoffGeneratedTests = exports.recommendTestsDeterministic = exports.analyzeImpactDeterministic = exports.validateProviderSetup = exports.LLMProviderFactory = exports.CustomProvider = exports.checkOpenAISetup = exports.OpenAIProvider = exports.checkOllamaSetup = exports.OllamaProvider = exports.checkAnthropicSetup = exports.AnthropicProvider = exports.UnsupportedCapabilityError = exports.LLMProviderError = void 0;
-exports.formatValidationReport = exports.buildValidationReport = exports.validateCommit = exports.getCommitFiles = exports.enrichFamilies = exports.detectStaleFamilies = exports.mergeFamilies = exports.scanProject = void 0;
+exports.formatValidationReport = exports.buildValidationReport = exports.validateCommit = exports.getCommitFiles = exports.enrichFamilies = exports.detectStaleFamilies = exports.mergeFamilies = exports.scanProject = exports.RegressionAdvisorAgent = exports.CrossImpactAgent = exports.TestDesignerAgent = exports.StrategistAgent = exports.ExplorerAgent = exports.HealerAgent = exports.ExecutorAgent = exports.GeneratorAgent = exports.CoverageEvaluatorAgent = exports.ImpactAnalystAgent = exports.WORKFLOWS = exports.CrewOrchestrator = void 0;
 var provider_interface_js_1 = require("./provider_interface.js");
 Object.defineProperty(exports, "LLMProviderError", { enumerable: true, get: function () { return provider_interface_js_1.LLMProviderError; } });
 Object.defineProperty(exports, "UnsupportedCapabilityError", { enumerable: true, get: function () { return provider_interface_js_1.UnsupportedCapabilityError; } });
@@ -84,6 +84,32 @@ Object.defineProperty(exports, "getSpecsForFamily", { enumerable: true, get: fun
 // Agentic generation
 var runner_js_1 = require("./agentic/runner.js");
 Object.defineProperty(exports, "runAgenticGeneration", { enumerable: true, get: function () { return runner_js_1.runAgenticGeneration; } });
+// Crew (multi-agent QA workflows)
+var orchestrator_js_2 = require("./crew/orchestrator.js");
+Object.defineProperty(exports, "CrewOrchestrator", { enumerable: true, get: function () { return orchestrator_js_2.CrewOrchestrator; } });
+var workflows_js_1 = require("./crew/workflows.js");
+Object.defineProperty(exports, "WORKFLOWS", { enumerable: true, get: function () { return workflows_js_1.WORKFLOWS; } });
+// Crew agents
+var impact_analyst_js_1 = require("./agents/impact-analyst.js");
+Object.defineProperty(exports, "ImpactAnalystAgent", { enumerable: true, get: function () { return impact_analyst_js_1.ImpactAnalystAgent; } });
+var coverage_evaluator_js_1 = require("./agents/coverage-evaluator.js");
+Object.defineProperty(exports, "CoverageEvaluatorAgent", { enumerable: true, get: function () { return coverage_evaluator_js_1.CoverageEvaluatorAgent; } });
+var generator_js_1 = require("./agents/generator.js");
+Object.defineProperty(exports, "GeneratorAgent", { enumerable: true, get: function () { return generator_js_1.GeneratorAgent; } });
+var executor_js_1 = require("./agents/executor.js");
+Object.defineProperty(exports, "ExecutorAgent", { enumerable: true, get: function () { return executor_js_1.ExecutorAgent; } });
+var healer_js_1 = require("./agents/healer.js");
+Object.defineProperty(exports, "HealerAgent", { enumerable: true, get: function () { return healer_js_1.HealerAgent; } });
+var explorer_js_1 = require("./agents/explorer.js");
+Object.defineProperty(exports, "ExplorerAgent", { enumerable: true, get: function () { return explorer_js_1.ExplorerAgent; } });
+var strategist_js_1 = require("./agents/strategist.js");
+Object.defineProperty(exports, "StrategistAgent", { enumerable: true, get: function () { return strategist_js_1.StrategistAgent; } });
+var test_designer_js_1 = require("./agents/test-designer.js");
+Object.defineProperty(exports, "TestDesignerAgent", { enumerable: true, get: function () { return test_designer_js_1.TestDesignerAgent; } });
+var cross_impact_js_1 = require("./agents/cross-impact.js");
+Object.defineProperty(exports, "CrossImpactAgent", { enumerable: true, get: function () { return cross_impact_js_1.CrossImpactAgent; } });
+var regression_advisor_js_1 = require("./agents/regression-advisor.js");
+Object.defineProperty(exports, "RegressionAdvisorAgent", { enumerable: true, get: function () { return regression_advisor_js_1.RegressionAdvisorAgent; } });
 // Training (route-families bootstrap and maintenance)
 var scanner_js_1 = require("./training/scanner.js");
 Object.defineProperty(exports, "scanProject", { enumerable: true, get: function () { return scanner_js_1.scanProject; } });

package/dist/prompts/cross-impact.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Cross-Impact Analyst prompt — finds ripple effects across route families.
+ */
+import type { RouteFamily } from '../knowledge/route_families.js';
+export interface CrossImpactPromptContext {
+    changedFiles: string[];
+    families: RouteFamily[];
+    /** The families directly impacted by changed files */
+    directlyImpactedFamilyIds: string[];
+}
+export declare function buildCrossImpactPrompt(ctx: CrossImpactPromptContext): string;
+export interface CrossImpactAgentResponse {
+    crossImpacts: Array<{
+        sourceFamily: string;
+        affectedFamily: string;
+        sharedDependency: string;
+        riskLevel: 'high' | 'medium' | 'low' | string;
+        evidence: string;
+    }>;
+}
+export declare function parseCrossImpactResponse(text: string): CrossImpactAgentResponse | null;
+//# sourceMappingURL=cross-impact.d.ts.map

package/dist/prompts/cross-impact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-impact.d.ts","sourceRoot":"","sources":["../../src/prompts/cross-impact.ts"],"names":[],"mappings":"AAGA;;GAEG;AAEH,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,gCAAgC,CAAC;AAIhE,MAAM,WAAW,wBAAwB;IACrC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,sDAAsD;IACtD,yBAAyB,EAAE,MAAM,EAAE,CAAC;CACvC;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,wBAAwB,GAAG,MAAM,CA+C5E;AAED,MAAM,WAAW,wBAAwB;IACrC,YAAY,EAAE,KAAK,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,MAAM,CAAC;QACvB,gBAAgB,EAAE,MAAM,CAAC;QACzB,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;QAC9C,QAAQ,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;CACN;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,wBAAwB,GAAG,IAAI,CAqBtF"}

package/dist/prompts/cross-impact.js

@@ -0,0 +1,75 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildCrossImpactPrompt = buildCrossImpactPrompt;
+exports.parseCrossImpactResponse = parseCrossImpactResponse;
+const sanitize_js_1 = require("../crew/sanitize.js");
+function buildCrossImpactPrompt(ctx) {
+    const familiesBlock = ctx.families
+        .map((f) => {
+        const paths = [
+            ...(f.webappPaths || []),
+            ...(f.serverPaths || []),
+            ...(f.components || []),
+        ];
+        return `- ${f.id}: routes=[${f.routes.join(', ')}] paths=[${paths.join(', ')}] pageObjects=[${(f.pageObjects || []).join(', ')}]`;
+    })
+        .join('\n');
+    const changedBlock = ctx.changedFiles.map((f) => (0, sanitize_js_1.sanitizeForPrompt)(f)).join('\n');
+    return [
+        'You are analyzing code changes in Mattermost to identify cross-family ripple effects.',
+        'When a change in one route family could affect another family through shared dependencies,',
+        'that is a cross-impact.',
+        '',
+        `CHANGED FILES (${ctx.changedFiles.length}):`,
+        changedBlock,
+        '',
+        `DIRECTLY IMPACTED FAMILIES: ${ctx.directlyImpactedFamilyIds.join(', ')}`,
+        '',
+        `ALL ROUTE FAMILIES (${ctx.families.length}):`,
+        familiesBlock,
+        '',
+        'TASK: Identify cross-family impacts. For each pair, explain the shared dependency.',
+        '',
+        'Look for:',
+        '1. Shared webapp paths (same component used by multiple families)',
+        '2. Shared page objects (same PO class referenced by multiple families)',
+        '3. Shared API endpoints (changes affecting data used by multiple families)',
+        '4. Shared components (React components imported across family boundaries)',
+        '5. Shared state management (Redux stores, contexts used across families)',
+        '',
+        'Return strict JSON only with this shape:',
+        '{"crossImpacts":[{"sourceFamily":"<directly impacted family>","affectedFamily":"<indirectly affected family>","sharedDependency":"<what connects them>","riskLevel":"high|medium|low","evidence":"<specific file/component/API that creates the dependency>"}]}',
+        '',
+        'Rules:',
+        '- Only report cross-impacts where both families are in the manifest.',
+        '- sourceFamily must be one of the directly impacted families.',
+        '- affectedFamily must be DIFFERENT from sourceFamily.',
+        '- Risk levels: high = shared data model/state, medium = shared UI component, low = shared utility.',
+        '- Evidence must cite specific files, components, or API paths.',
+        '- Return empty array if no cross-impacts are found.',
+    ].join('\n');
+}
+function parseCrossImpactResponse(text) {
+    const fenced = text.match(/```(?:json)?\s*([\s\S]*?)```/i);
+    const candidates = fenced ? [fenced[1], text] : [text];
+    for (const candidate of candidates) {
+        const start = candidate.indexOf('{');
+        const end = candidate.lastIndexOf('}');
+        if (start < 0 || end <= start) {
+            continue;
+        }
+        const raw = candidate.slice(start, end + 1);
+        try {
+            const parsed = JSON.parse(raw);
+            if (parsed && Array.isArray(parsed.crossImpacts)) {
+                return parsed;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return null;
+}

package/dist/prompts/strategist.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Strategist prompt — designs overall test strategy from impact analysis,
+ * cross-impact data, and regression risk.
+ */
+import type { FlowDecision } from '../validation/output_schema.js';
+import type { CrossImpact, RegressionRisk } from '../crew/types.js';
+export interface StrategistPromptContext {
+    impactedFlows: FlowDecision[];
+    crossImpacts: CrossImpact[];
+    regressionRisks: RegressionRisk[];
+}
+export declare function buildStrategistPrompt(ctx: StrategistPromptContext): string;
+export interface StrategistAgentResponse {
+    strategy: Array<{
+        flowId: string;
+        flowName: string;
+        priority: 'P0' | 'P1' | 'P2' | string;
+        approach: 'full-test' | 'smoke-test' | 'skip' | 'manual-review' | string;
+        rationale: string;
+        testCategories: string[];
+        crossImpactRisk: 'high' | 'medium' | 'low' | 'none' | string;
+    }>;
+}
+export declare function parseStrategistResponse(text: string): StrategistAgentResponse | null;
+//# sourceMappingURL=strategist.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"strategist.d.ts","sourceRoot":"","sources":["../../src/prompts/strategist.ts"],"names":[],"mappings":"AAGA;;;GAGG;AAEH,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,gCAAgC,CAAC;AACjE,OAAO,KAAK,EAAC,WAAW,EAAE,cAAc,EAAgB,MAAM,kBAAkB,CAAC;AAGjF,MAAM,WAAW,uBAAuB;IACpC,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,eAAe,EAAE,cAAc,EAAE,CAAC;CACrC;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,uBAAuB,GAAG,MAAM,CA4D1E;AAED,MAAM,WAAW,uBAAuB;IACpC,QAAQ,EAAE,KAAK,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;QACtC,QAAQ,EAAE,WAAW,GAAG,YAAY,GAAG,MAAM,GAAG,eAAe,GAAG,MAAM,CAAC;QACzE,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,eAAe,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;KAChE,CAAC,CAAC;CACN;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,uBAAuB,GAAG,IAAI,CAqBpF"}

package/dist/prompts/strategist.js

@@ -0,0 +1,83 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildStrategistPrompt = buildStrategistPrompt;
+exports.parseStrategistResponse = parseStrategistResponse;
+const sanitize_js_1 = require("../crew/sanitize.js");
+function buildStrategistPrompt(ctx) {
+    const flowsBlock = ctx.impactedFlows
+        .map((f) => {
+        const specs = f.existingSpecs.map((s) => `${s.path} (${s.coverageLevel})`).join(', ') || 'none';
+        return [
+            `- ${f.flowId} (${f.priority}): ${f.flowName}`,
+            `  Route Family: ${f.routeFamily}`,
+            `  Action: ${f.action}`,
+            `  Confidence: ${f.confidence}%`,
+            `  Existing Coverage: ${specs}`,
+            `  User Actions: ${(0, sanitize_js_1.sanitizeForPrompt)(f.userActions.join('; ') || 'unknown')}`,
+            `  Changed Files: ${f.changedFiles.join(', ')}`,
+        ].join('\n');
+    })
+        .join('\n\n');
+    const crossImpactBlock = ctx.crossImpacts.length > 0
+        ? ctx.crossImpacts.map((ci) => `- ${ci.sourceFamily} → ${ci.affectedFamily} (${ci.riskLevel}): ${ci.sharedDependency} — ${ci.evidence}`).join('\n')
+        : 'No cross-family impacts detected.';
+    const regressionBlock = ctx.regressionRisks.length > 0
+        ? ctx.regressionRisks.map((r) => `- ${r.familyId} (risk=${r.riskScore}): ${r.reason}`).join('\n')
+        : 'No regression risk data available.';
+    return [
+        'You are a senior QA strategist designing the overall test strategy for a code change.',
+        '',
+        `IMPACTED FLOWS (${ctx.impactedFlows.length}):`,
+        flowsBlock,
+        '',
+        'CROSS-FAMILY IMPACTS:',
+        crossImpactBlock,
+        '',
+        'REGRESSION RISK:',
+        regressionBlock,
+        '',
+        'TASK: Design a prioritized test strategy for each impacted flow.',
+        '',
+        'For each flow, decide:',
+        '1. Approach: full-test (comprehensive), smoke-test (critical path only), skip, or manual-review',
+        '2. Priority: P0 (critical path), P1 (important), P2 (nice to have)',
+        '3. Test categories to cover (from: happy-path, edge-case, boundary, negative, state-transition, race-condition, permission, accessibility, performance)',
+        '4. Cross-impact risk level based on shared dependencies',
+        '',
+        'Return strict JSON only with this shape:',
+        '{"strategy":[{"flowId":"<id>","flowName":"<name>","priority":"P0|P1|P2","approach":"full-test|smoke-test|skip|manual-review","rationale":"<why this approach>","testCategories":["happy-path","edge-case",...],"crossImpactRisk":"high|medium|low|none"}]}',
+        '',
+        'Rules:',
+        '- P0 flows with create_spec or add_scenarios action should always get full-test.',
+        '- Flows with high cross-impact risk should be promoted to at least P1.',
+        '- Flows with high regression risk should include edge-case and boundary categories.',
+        '- Skip flows only if confidence < 30 AND no cross-impact risk.',
+        '- Include accessibility category for any flow involving interactive UI elements.',
+        '- Include permission category for any flow involving role-based features.',
+        '- Keep rationale concise (1-2 sentences) explaining why this approach was chosen.',
+    ].join('\n');
+}
+function parseStrategistResponse(text) {
+    const fenced = text.match(/```(?:json)?\s*([\s\S]*?)```/i);
+    const candidates = fenced ? [fenced[1], text] : [text];
+    for (const candidate of candidates) {
+        const start = candidate.indexOf('{');
+        const end = candidate.lastIndexOf('}');
+        if (start < 0 || end <= start) {
+            continue;
+        }
+        const raw = candidate.slice(start, end + 1);
+        try {
+            const parsed = JSON.parse(raw);
+            if (parsed && Array.isArray(parsed.strategy)) {
+                return parsed;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return null;
+}

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

@@ -0,0 +1,33 @@
+/**
+ * Test Designer prompt — designs structured test cases across 9 categories.
+ * Replaces flat scenariosToAdd with rich TestCase[] that feed the Generator.
+ */
+import type { FlowDecision } from '../validation/output_schema.js';
+import { type ApiSurfaceCatalog } from '../knowledge/api_surface.js';
+import type { SpecEntry } from '../knowledge/spec_index.js';
+import type { StrategyEntry, CrossImpact } from '../crew/types.js';
+export interface TestDesignerPromptContext {
+    flow: FlowDecision;
+    strategy: StrategyEntry;
+    apiSurface: ApiSurfaceCatalog;
+    existingSpecs: SpecEntry[];
+    crossImpacts: CrossImpact[];
+}
+export declare function buildTestDesignerPrompt(ctx: TestDesignerPromptContext): string;
+export interface TestDesignerAgentResponse {
+    testDesign: {
+        flowId: string;
+        flowName: string;
+        testCases: Array<{
+            name: string;
+            type: 'happy-path' | 'edge-case' | 'boundary' | 'negative' | 'state-transition' | 'race-condition' | 'permission' | 'accessibility' | 'performance' | string;
+            preconditions: string[];
+            steps: string[];
+            expectedOutcome: string;
+            priority: 'P0' | 'P1' | 'P2' | string;
+            rationale: string;
+        }>;
+    };
+}
+export declare function parseTestDesignerResponse(text: string): TestDesignerAgentResponse | null;
+//# sourceMappingURL=test-designer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"test-designer.d.ts","sourceRoot":"","sources":["../../src/prompts/test-designer.ts"],"names":[],"mappings":"AAGA;;;GAGG;AAEH,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAA4B,KAAK,iBAAiB,EAAC,MAAM,6BAA6B,CAAC;AAC9F,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,4BAA4B,CAAC;AAC1D,OAAO,KAAK,EAAC,aAAa,EAAE,WAAW,EAAa,MAAM,kBAAkB,CAAC;AAG7E,MAAM,WAAW,yBAAyB;IACtC,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,EAAE,aAAa,CAAC;IACxB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,aAAa,EAAE,SAAS,EAAE,CAAC;IAC3B,YAAY,EAAE,WAAW,EAAE,CAAC;CAC/B;AAED,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,yBAAyB,GAAG,MAAM,CAuF9E;AAED,MAAM,WAAW,yBAAyB;IACtC,UAAU,EAAE;QACR,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,KAAK,CAAC;YACb,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,EAAE,YAAY,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,kBAAkB,GAAG,gBAAgB,GAAG,YAAY,GAAG,eAAe,GAAG,aAAa,GAAG,MAAM,CAAC;YAC7J,aAAa,EAAE,MAAM,EAAE,CAAC;YACxB,KAAK,EAAE,MAAM,EAAE,CAAC;YAChB,eAAe,EAAE,MAAM,CAAC;YACxB,QAAQ,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;YACtC,SAAS,EAAE,MAAM,CAAC;SACrB,CAAC,CAAC;KACN,CAAC;CACL;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,yBAAyB,GAAG,IAAI,CAqBxF"}

package/dist/prompts/test-designer.js

@@ -0,0 +1,111 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildTestDesignerPrompt = buildTestDesignerPrompt;
+exports.parseTestDesignerResponse = parseTestDesignerResponse;
+const api_surface_js_1 = require("../knowledge/api_surface.js");
+const sanitize_js_1 = require("../crew/sanitize.js");
+function buildTestDesignerPrompt(ctx) {
+    const relevantClasses = ctx.apiSurface.pageObjects
+        .map((po) => po.className)
+        .filter((name) => {
+        const lower = name.toLowerCase();
+        const hints = [ctx.flow.routeFamily, ctx.flow.featureId, ...ctx.flow.userActions.join(' ').split(/\s+/)]
+            .filter(Boolean)
+            .map((s) => s.toLowerCase().replace(/[^a-z]/g, ''));
+        return lower.includes('page') || hints.some((h) => h.length > 3 && lower.includes(h));
+    })
+        .slice(0, 10);
+    const apiBlock = relevantClasses.length > 0
+        ? (0, api_surface_js_1.formatApiSurfaceForPrompt)(ctx.apiSurface, relevantClasses)
+        : 'No page objects available.';
+    const existingSpecsBlock = ctx.existingSpecs.length > 0
+        ? ctx.existingSpecs.map((s) => `- ${s.relativePath}: ${s.testTitles.join(', ')}`).join('\n')
+        : 'No existing specs.';
+    const crossImpactBlock = ctx.crossImpacts.length > 0
+        ? ctx.crossImpacts.map((ci) => `- ${ci.sourceFamily} → ${ci.affectedFamily}: ${ci.sharedDependency} (${ci.riskLevel})`).join('\n')
+        : 'None detected.';
+    const categories = ctx.strategy.testCategories.join(', ');
+    return [
+        'You are a senior QA engineer designing comprehensive test cases for a Mattermost user flow.',
+        '',
+        `FLOW: ${ctx.flow.flowName}`,
+        `Flow ID: ${ctx.flow.flowId}`,
+        `Route Family: ${ctx.flow.routeFamily}${ctx.flow.featureId ? ` / ${ctx.flow.featureId}` : ''}`,
+        `Route: ${ctx.flow.specificRoute || '(not specified)'}`,
+        `Priority: ${ctx.strategy.priority}`,
+        `Approach: ${ctx.strategy.approach}`,
+        `User Actions: ${(0, sanitize_js_1.sanitizeForPrompt)(ctx.flow.userActions.join('; ') || 'unknown')}`,
+        `Evidence: ${(0, sanitize_js_1.sanitizeForPrompt)(ctx.flow.evidence)}`,
+        '',
+        `REQUIRED TEST CATEGORIES: ${categories}`,
+        '',
+        'AVAILABLE PAGE OBJECTS:',
+        apiBlock,
+        '',
+        'EXISTING SPECS (avoid duplicating these):',
+        existingSpecsBlock,
+        '',
+        'CROSS-FAMILY IMPACTS:',
+        crossImpactBlock,
+        '',
+        'TASK: Design structured test cases for this flow.',
+        '',
+        'Return strict JSON only with this shape:',
+        '{"testDesign":{"flowId":"<id>","flowName":"<name>","testCases":[{"name":"<descriptive name>","type":"<category>","preconditions":["<state required>"],"steps":["<user action>"],"expectedOutcome":"<what should happen>","priority":"P0|P1|P2","rationale":"<why this test matters>"}]}}',
+        '',
+        'TYPE VALUES: happy-path, edge-case, boundary, negative, state-transition, race-condition, permission, accessibility, performance',
+        '',
+        'Rules:',
+        '- Every test must describe a specific USER ACTION, not an implementation detail.',
+        '- Steps must be concrete: "click Create Channel button" not "test channel creation".',
+        '- Include preconditions (logged-in role, existing data state, etc.).',
+        '- Reference only page objects and methods listed above.',
+        '- Include a mandatory rationale explaining why this specific test case matters.',
+        '- Do NOT duplicate tests already covered by existing specs.',
+        '- Maximum 15 test cases per flow.',
+        '- For accessibility: test keyboard navigation, screen reader support, ARIA labels.',
+        '- For performance: test with realistic data volumes, measure load times.',
+        '- For edge cases: test unicode input, max-length fields, empty states, concurrent edits.',
+        '',
+        'FEW-SHOT EXAMPLES:',
+        '',
+        'Edge case example:',
+        '```json',
+        '{"name":"channel creation with unicode characters and max-length name","type":"edge-case","preconditions":["logged in as team member","team has < 1000 channels"],"steps":["open create channel dialog","enter 64-character name with emoji and CJK characters","click Create"],"expectedOutcome":"channel created successfully, name renders correctly in sidebar and header","priority":"P1","rationale":"catches encoding issues in channel name storage and rendering"}',
+        '```',
+        '',
+        'Permission example:',
+        '```json',
+        '{"name":"guest user cannot archive a public channel","type":"permission","preconditions":["logged in as guest user","guest has access to public channel"],"steps":["open channel header menu","look for Archive Channel option"],"expectedOutcome":"Archive Channel option is not visible in the menu","priority":"P0","rationale":"permission escalation bug — guests archiving channels could disrupt entire teams"}',
+        '```',
+        '',
+        'Accessibility example:',
+        '```json',
+        '{"name":"keyboard navigation through channel switcher results","type":"accessibility","preconditions":["logged in","channel switcher open via Ctrl+K"],"steps":["type partial channel name","press ArrowDown to navigate results","press Enter to select"],"expectedOutcome":"focus moves visually and via aria-activedescendant, selected channel opens","priority":"P1","rationale":"screen reader users rely on keyboard navigation — broken focus management makes the app unusable"}',
+        '```',
+    ].join('\n');
+}
+function parseTestDesignerResponse(text) {
+    const fenced = text.match(/```(?:json)?\s*([\s\S]*?)```/i);
+    const candidates = fenced ? [fenced[1], text] : [text];
+    for (const candidate of candidates) {
+        const start = candidate.indexOf('{');
+        const end = candidate.lastIndexOf('}');
+        if (start < 0 || end <= start) {
+            continue;
+        }
+        const raw = candidate.slice(start, end + 1);
+        try {
+            const parsed = JSON.parse(raw);
+            if (parsed?.testDesign?.testCases && Array.isArray(parsed.testDesign.testCases)) {
+                return parsed;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return null;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yasserkhanorg/e2e-agents",
-  "version": "1.7.7",
+  "version": "1.8.0",
   "description": "AI-powered E2E test impact analysis, generation, and healing. Analyzes code changes to identify affected Playwright tests, detects coverage gaps, and generates or repairs specs using pluggable LLM providers (Claude, OpenAI, Ollama). Includes MCP server, traceability, and CI/CD integration.",
   "main": "dist/index.js",
   "module": "dist/esm/index.js",