@yasserkhanorg/e2e-agents 0.5.16 → 0.7.0

package/dist/index.d.ts

@@ -18,8 +18,11 @@ export { OpenAIProvider, checkOpenAISetup } from './openai_provider.js';
 export { CustomProvider } from './custom_provider.js';
 export { LLMProviderFactory, validateProviderSetup } from './provider_factory.js';
 export type { HybridConfig } from './provider_factory.js';
-export { analyzeImpact, findGaps, recommendTests, handoffGeneratedTests, ingestTraceability, captureTraceability } from './api.js';
-export type { AgentApiOptions, AnalyzeResult, RecommendTestsResult, TraceabilityIngestApiOptions, TraceabilityCaptureApiOptions, } from './api.js';
+export { analyzeImpactDeterministic, recommendTestsDeterministic, handoffGeneratedTests, ingestTraceability, captureTraceability } from './api.js';
+export type { AgentApiOptions, RecommendTestsV2Result, TraceabilityIngestApiOptions, TraceabilityCaptureApiOptions, } from './api.js';
+export { analyzeImpact as analyzeImpactV2, getGaps, getPartialGaps } from './engine/impact_engine.js';
+export type { ImpactResult, ImpactedFeature, CoverageStatus, ImpactEngineOptions } from './engine/impact_engine.js';
+export { buildPlanFromImpact } from './engine/plan_builder.js';
 export { appendFeedbackAndRecompute, readCalibration } from './agent/feedback.js';
 export type { RecommendationFeedbackEntry, CalibrationSummary } from './agent/feedback.js';
 export { finalizeGeneratedTests } from './agent/handoff.js';
@@ -39,10 +42,12 @@ export { runHealStage, healFromReport, resolveHealTargets, renderHealMarkdown }
 export type { HealConfig, HealTarget, HealResult } from './pipeline/stage4_heal.js';
 export { buildHealPrompt, buildQualityFixPrompt } from './prompts/heal.js';
 export type { HealPromptContext } from './prompts/heal.js';
-export { loadRouteFamilyManifest, bindFilesToFamilies } from './knowledge/route_families.js';
-export type { RouteFamily, RouteFeature, RouteFamilyManifest, FileBinding } from './knowledge/route_families.js';
+export { loadRouteFamilyManifest, bindFilesToFamilies, getCypressSpecDirsForBinding, getPriorityForBinding, getUserFlowsForBinding } from './knowledge/route_families.js';
+export type { RouteFamily, RouteFeature, RouteFamilyManifest, FileBinding, FeaturePriority } from './knowledge/route_families.js';
 export { buildApiSurface, loadOrBuildApiSurface } from './knowledge/api_surface.js';
 export type { ApiSurfaceCatalog, PageObjectSurface } from './knowledge/api_surface.js';
 export { buildSpecIndex, getSpecsForFamily } from './knowledge/spec_index.js';
 export type { SpecIndex, SpecEntry } from './knowledge/spec_index.js';
+export type { FlowImpact, FlowPriority, FlowCoverage, FlagHit, BlastRadius } from './agent/types.js';
+export type { PlanReport } from './agent/plan.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -2,7 +2,7 @@
 // Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
 // See LICENSE.txt for license information.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getSpecsForFamily = exports.buildSpecIndex = exports.loadOrBuildApiSurface = exports.buildApiSurface = 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.readCalibration = exports.appendFeedbackAndRecompute = exports.captureTraceability = exports.ingestTraceability = exports.handoffGeneratedTests = exports.recommendTests = exports.findGaps = exports.analyzeImpact = 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.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.readCalibration = exports.appendFeedbackAndRecompute = exports.buildPlanFromImpact = exports.getPartialGaps = 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;
 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; } });
@@ -22,14 +22,20 @@ Object.defineProperty(exports, "CustomProvider", { enumerable: true, get: functi
 var provider_factory_js_1 = require("./provider_factory.js");
 Object.defineProperty(exports, "LLMProviderFactory", { enumerable: true, get: function () { return provider_factory_js_1.LLMProviderFactory; } });
 Object.defineProperty(exports, "validateProviderSetup", { enumerable: true, get: function () { return provider_factory_js_1.validateProviderSetup; } });
-// Agent API (impact, gap, suggest, traceability ingest)
+// Agent API (deterministic impact + plan, traceability)
 var api_js_1 = require("./api.js");
-Object.defineProperty(exports, "analyzeImpact", { enumerable: true, get: function () { return api_js_1.analyzeImpact; } });
-Object.defineProperty(exports, "findGaps", { enumerable: true, get: function () { return api_js_1.findGaps; } });
-Object.defineProperty(exports, "recommendTests", { enumerable: true, get: function () { return api_js_1.recommendTests; } });
+Object.defineProperty(exports, "analyzeImpactDeterministic", { enumerable: true, get: function () { return api_js_1.analyzeImpactDeterministic; } });
+Object.defineProperty(exports, "recommendTestsDeterministic", { enumerable: true, get: function () { return api_js_1.recommendTestsDeterministic; } });
 Object.defineProperty(exports, "handoffGeneratedTests", { enumerable: true, get: function () { return api_js_1.handoffGeneratedTests; } });
 Object.defineProperty(exports, "ingestTraceability", { enumerable: true, get: function () { return api_js_1.ingestTraceability; } });
 Object.defineProperty(exports, "captureTraceability", { enumerable: true, get: function () { return api_js_1.captureTraceability; } });
+// V2 Engine (deterministic impact + plan)
+var impact_engine_js_1 = require("./engine/impact_engine.js");
+Object.defineProperty(exports, "analyzeImpactV2", { enumerable: true, get: function () { return impact_engine_js_1.analyzeImpact; } });
+Object.defineProperty(exports, "getGaps", { enumerable: true, get: function () { return impact_engine_js_1.getGaps; } });
+Object.defineProperty(exports, "getPartialGaps", { enumerable: true, get: function () { return impact_engine_js_1.getPartialGaps; } });
+var plan_builder_js_1 = require("./engine/plan_builder.js");
+Object.defineProperty(exports, "buildPlanFromImpact", { enumerable: true, get: function () { return plan_builder_js_1.buildPlanFromImpact; } });
 var feedback_js_1 = require("./agent/feedback.js");
 Object.defineProperty(exports, "appendFeedbackAndRecompute", { enumerable: true, get: function () { return feedback_js_1.appendFeedbackAndRecompute; } });
 Object.defineProperty(exports, "readCalibration", { enumerable: true, get: function () { return feedback_js_1.readCalibration; } });
@@ -60,6 +66,9 @@ Object.defineProperty(exports, "buildQualityFixPrompt", { enumerable: true, get:
 var route_families_js_1 = require("./knowledge/route_families.js");
 Object.defineProperty(exports, "loadRouteFamilyManifest", { enumerable: true, get: function () { return route_families_js_1.loadRouteFamilyManifest; } });
 Object.defineProperty(exports, "bindFilesToFamilies", { enumerable: true, get: function () { return route_families_js_1.bindFilesToFamilies; } });
+Object.defineProperty(exports, "getCypressSpecDirsForBinding", { enumerable: true, get: function () { return route_families_js_1.getCypressSpecDirsForBinding; } });
+Object.defineProperty(exports, "getPriorityForBinding", { enumerable: true, get: function () { return route_families_js_1.getPriorityForBinding; } });
+Object.defineProperty(exports, "getUserFlowsForBinding", { enumerable: true, get: function () { return route_families_js_1.getUserFlowsForBinding; } });
 var api_surface_js_1 = require("./knowledge/api_surface.js");
 Object.defineProperty(exports, "buildApiSurface", { enumerable: true, get: function () { return api_surface_js_1.buildApiSurface; } });
 Object.defineProperty(exports, "loadOrBuildApiSurface", { enumerable: true, get: function () { return api_surface_js_1.loadOrBuildApiSurface; } });

package/dist/knowledge/route_families.d.ts

@@ -1,10 +1,14 @@
+export type FeaturePriority = 'P0' | 'P1' | 'P2';
 export interface RouteFeature {
     id: string;
     routes?: string[];
     webappPaths?: string[];
     serverPaths?: string[];
     specDirs?: string[];
+    cypressSpecDirs?: string[];
     tags?: string[];
+    priority?: FeaturePriority;
+    userFlows?: string[];
 }
 export interface RouteFamily {
     id: string;
@@ -14,7 +18,10 @@ export interface RouteFamily {
     webappPaths?: string[];
     serverPaths?: string[];
     specDirs?: string[];
+    cypressSpecDirs?: string[];
     tags?: string[];
+    priority?: FeaturePriority;
+    userFlows?: string[];
     features?: RouteFeature[];
 }
 export interface RouteFamilyManifest {
@@ -40,6 +47,18 @@ export declare function getSpecDirsForBinding(manifest: RouteFamilyManifest, bin
     family: string;
     feature?: string;
 }): string[];
+export declare function getCypressSpecDirsForBinding(manifest: RouteFamilyManifest, binding: {
+    family: string;
+    feature?: string;
+}): string[];
+export declare function getPriorityForBinding(manifest: RouteFamilyManifest, binding: {
+    family: string;
+    feature?: string;
+}): FeaturePriority;
+export declare function getUserFlowsForBinding(manifest: RouteFamilyManifest, binding: {
+    family: string;
+    feature?: string;
+}): string[];
 export declare function getRoutesForBinding(manifest: RouteFamilyManifest, binding: {
     family: string;
     feature?: string;

package/dist/knowledge/route_families.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"route_families.d.ts","sourceRoot":"","sources":["../../src/knowledge/route_families.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAChC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,iBAAiB;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AA6GD,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,mBAAmB,GAAG,IAAI,CAyCjH;AAED,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,mBAAmB,GAAG,WAAW,EAAE,CAsCxG;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEtG;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAE/F;AAED,wBAAgB,qBAAqB,CACjC,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,EAAE;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAC,GAC5C,MAAM,EAAE,CAYV;AAED,wBAAgB,mBAAmB,CAC/B,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,EAAE;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAC,GAC5C,MAAM,EAAE,CAYV;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}
+{"version":3,"file":"route_families.d.ts","sourceRoot":"","sources":["../../src/knowledge/route_families.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEjD,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAChC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,iBAAiB;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AA+HD,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,mBAAmB,GAAG,IAAI,CA0CjH;AAED,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,mBAAmB,GAAG,WAAW,EAAE,CAsCxG;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEtG;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAE/F;AAED,wBAAgB,qBAAqB,CACjC,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,EAAE;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAC,GAC5C,MAAM,EAAE,CAYV;AAED,wBAAgB,4BAA4B,CACxC,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,EAAE;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAC,GAC5C,MAAM,EAAE,CAYV;AAED,wBAAgB,qBAAqB,CACjC,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,EAAE;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAC,GAC5C,eAAe,CAYjB;AAED,wBAAgB,sBAAsB,CAClC,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,EAAE;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAC,GAC5C,MAAM,EAAE,CAYV;AAED,wBAAgB,mBAAmB,CAC/B,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,EAAE;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAC,GAC5C,MAAM,EAAE,CAYV;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}

package/dist/knowledge/route_families.js

@@ -7,6 +7,9 @@ exports.bindFilesToFamilies = bindFilesToFamilies;
 exports.getFamilyById = getFamilyById;
 exports.getFeatureById = getFeatureById;
 exports.getSpecDirsForBinding = getSpecDirsForBinding;
+exports.getCypressSpecDirsForBinding = getCypressSpecDirsForBinding;
+exports.getPriorityForBinding = getPriorityForBinding;
+exports.getUserFlowsForBinding = getUserFlowsForBinding;
 exports.getRoutesForBinding = getRoutesForBinding;
 exports.clearManifestCache = clearManifestCache;
 const fs_1 = require("fs");
@@ -72,9 +75,18 @@ function validateFamily(family) {
     if (Array.isArray(obj.specDirs)) {
         result.specDirs = obj.specDirs.filter((v) => typeof v === 'string');
     }
+    if (Array.isArray(obj.cypressSpecDirs)) {
+        result.cypressSpecDirs = obj.cypressSpecDirs.filter((v) => typeof v === 'string');
+    }
     if (Array.isArray(obj.tags)) {
         result.tags = obj.tags.filter((v) => typeof v === 'string');
     }
+    if (obj.priority === 'P0' || obj.priority === 'P1' || obj.priority === 'P2') {
+        result.priority = obj.priority;
+    }
+    if (Array.isArray(obj.userFlows)) {
+        result.userFlows = obj.userFlows.filter((v) => typeof v === 'string');
+    }
     if (Array.isArray(obj.features)) {
         result.features = obj.features
             .map((f) => validateFeature(f))
@@ -103,9 +115,18 @@ function validateFeature(feature) {
     if (Array.isArray(obj.specDirs)) {
         result.specDirs = obj.specDirs.filter((v) => typeof v === 'string');
     }
+    if (Array.isArray(obj.cypressSpecDirs)) {
+        result.cypressSpecDirs = obj.cypressSpecDirs.filter((v) => typeof v === 'string');
+    }
     if (Array.isArray(obj.tags)) {
         result.tags = obj.tags.filter((v) => typeof v === 'string');
     }
+    if (obj.priority === 'P0' || obj.priority === 'P1' || obj.priority === 'P2') {
+        result.priority = obj.priority;
+    }
+    if (Array.isArray(obj.userFlows)) {
+        result.userFlows = obj.userFlows.filter((v) => typeof v === 'string');
+    }
     return result;
 }
 function loadRouteFamilyManifest(testsRoot, config) {
@@ -145,7 +166,8 @@ function loadRouteFamilyManifest(testsRoot, config) {
         }
     }
     if (config?.strict) {
-        throw new Error('Route family manifest is required but not found. Create .e2e-ai-agents/route-families.json');
+        // eslint-disable-next-line no-console
+        console.warn('[e2e-agents] Route family manifest not found. The manifest is optional context for AI enrichment — create .e2e-ai-agents/route-families.json to enable family-level routing hints.');
     }
     return null;
 }
@@ -202,6 +224,45 @@ function getSpecDirsForBinding(manifest, binding) {
     }
     return family.specDirs || [];
 }
+function getCypressSpecDirsForBinding(manifest, binding) {
+    const family = getFamilyById(manifest, binding.family);
+    if (!family) {
+        return [];
+    }
+    if (binding.feature) {
+        const feature = getFeatureById(family, binding.feature);
+        if (feature?.cypressSpecDirs && feature.cypressSpecDirs.length > 0) {
+            return feature.cypressSpecDirs;
+        }
+    }
+    return family.cypressSpecDirs || [];
+}
+function getPriorityForBinding(manifest, binding) {
+    const family = getFamilyById(manifest, binding.family);
+    if (!family) {
+        return 'P2';
+    }
+    if (binding.feature) {
+        const feature = getFeatureById(family, binding.feature);
+        if (feature?.priority) {
+            return feature.priority;
+        }
+    }
+    return family.priority || 'P2';
+}
+function getUserFlowsForBinding(manifest, binding) {
+    const family = getFamilyById(manifest, binding.family);
+    if (!family) {
+        return [];
+    }
+    if (binding.feature) {
+        const feature = getFeatureById(family, binding.feature);
+        if (feature?.userFlows && feature.userFlows.length > 0) {
+            return feature.userFlows;
+        }
+    }
+    return family.userFlows || [];
+}
 function getRoutesForBinding(manifest, binding) {
     const family = getFamilyById(manifest, binding.family);
     if (!family) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yasserkhanorg/e2e-agents",
-  "version": "0.5.16",
+  "version": "0.7.0",
   "description": "Pluggable LLM provider library for AI-powered test automation. Use Claude, Ollama, or your own LLM. Integrate with Playwright, Jest, or any test framework. MCP server for test agents, cost tracking, and hybrid provider mode.",
   "main": "dist/index.js",
   "module": "dist/esm/index.js",

package/dist/agent/ai_flow_analysis.d.ts

@@ -1,13 +0,0 @@
-import type { FileAnalysis, FlowImpact } from './analysis.js';
-import type { AIFlowImpactConfig } from './config.js';
-export interface AIFlowAnalysisResult {
-    enabled: boolean;
-    used: boolean;
-    ran: boolean;
-    provider: string;
-    flowCount: number;
-    warnings: string[];
-    flows: FlowImpact[];
-}
-export declare function mapAIFlowsFromFiles(appRoot: string, testsRoot: string, config: AIFlowImpactConfig, files: FileAnalysis[], changedFiles: string[]): Promise<AIFlowAnalysisResult>;
-//# sourceMappingURL=ai_flow_analysis.d.ts.map

package/dist/agent/ai_flow_analysis.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ai_flow_analysis.d.ts","sourceRoot":"","sources":["../../src/agent/ai_flow_analysis.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAC,YAAY,EAAE,UAAU,EAAe,MAAM,eAAe,CAAC;AAC1E,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,aAAa,CAAC;AAkBpD,MAAM,WAAW,oBAAoB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,UAAU,EAAE,CAAC;CACvB;AA2JD,wBAAsB,mBAAmB,CACrC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,YAAY,EAAE,EACrB,YAAY,EAAE,MAAM,EAAE,GACvB,OAAO,CAAC,oBAAoB,CAAC,CAuM/B"}

package/dist/agent/ai_flow_analysis.js

@@ -1,334 +0,0 @@
-"use strict";
-// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
-// See LICENSE.txt for license information.
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.mapAIFlowsFromFiles = mapAIFlowsFromFiles;
-const fs_1 = require("fs");
-const path_1 = require("path");
-const provider_factory_js_1 = require("../provider_factory.js");
-const utils_js_1 = require("./utils.js");
-function extractJson(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.flows)) {
-                return parsed;
-            }
-        }
-        catch {
-            // Ignore parse failure and keep trying other candidates.
-        }
-    }
-    return null;
-}
-function resolveContextFiles(appRoot, testsRoot, files) {
-    const resolved = [];
-    const seen = new Set();
-    const maxCharsPerFile = 12000;
-    const maxTotalChars = 32000;
-    let totalChars = 0;
-    for (const file of files) {
-        const candidates = (0, path_1.isAbsolute)(file)
-            ? [file]
-            : [(0, path_1.join)(testsRoot, file), (0, path_1.join)(appRoot, file)];
-        for (const candidate of candidates) {
-            const normalized = (0, utils_js_1.normalizePath)(candidate);
-            if (seen.has(normalized) || !(0, fs_1.existsSync)(candidate)) {
-                continue;
-            }
-            const content = (0, fs_1.readFileSync)(candidate, 'utf-8');
-            const trimmed = content.trim();
-            if (!trimmed) {
-                seen.add(normalized);
-                continue;
-            }
-            const remaining = Math.max(0, maxTotalChars - totalChars);
-            if (remaining <= 0) {
-                return resolved;
-            }
-            const clipped = trimmed.slice(0, Math.min(maxCharsPerFile, remaining));
-            resolved.push({ path: normalized, content: clipped });
-            seen.add(normalized);
-            totalChars += clipped.length;
-            break;
-        }
-    }
-    return resolved;
-}
-function priorityFromEntry(entry) {
-    if (entry.priority === 'P0' || entry.priority === 'P1' || entry.priority === 'P2') {
-        return entry.priority;
-    }
-    const score = typeof entry.score === 'number' ? entry.score : 0;
-    if (score >= 8) {
-        return 'P0';
-    }
-    if (score >= 5) {
-        return 'P1';
-    }
-    return 'P2';
-}
-function normalizeFlowId(value) {
-    return (0, utils_js_1.normalizePath)(value)
-        .replace(/[^a-zA-Z0-9/_-]+/g, '_')
-        .replace(/\/{2,}/g, '/')
-        .replace(/^\/+/, '')
-        .replace(/\/+$/, '')
-        .trim();
-}
-function sanitizeReasons(reasons, fallback) {
-    if (!Array.isArray(reasons)) {
-        return [fallback];
-    }
-    const cleaned = reasons.filter((entry) => typeof entry === 'string').map((entry) => entry.trim()).filter(Boolean);
-    return cleaned.length > 0 ? cleaned : [fallback];
-}
-function sanitizeKeywords(keywords, fallbackTokens) {
-    if (!Array.isArray(keywords)) {
-        return (0, utils_js_1.uniqueTokens)(fallbackTokens).slice(0, 20);
-    }
-    const fromAI = keywords.filter((entry) => typeof entry === 'string').flatMap((entry) => (0, utils_js_1.tokenize)(entry));
-    return (0, utils_js_1.uniqueTokens)([...fromAI, ...fallbackTokens]).slice(0, 20);
-}
-function summarizeFiles(files, changedFileSet, maxFiles) {
-    const sorted = [...files].sort((a, b) => {
-        const aChanged = changedFileSet.has(a.relativePath) ? 1 : 0;
-        const bChanged = changedFileSet.has(b.relativePath) ? 1 : 0;
-        if (aChanged !== bChanged) {
-            return bChanged - aChanged;
-        }
-        const aSignals = (a.isUI ? 1 : 0) + (a.isScreen ? 1 : 0) + (a.isState ? 1 : 0) + (a.hasInteractions ? 1 : 0);
-        const bSignals = (b.isUI ? 1 : 0) + (b.isScreen ? 1 : 0) + (b.isState ? 1 : 0) + (b.hasInteractions ? 1 : 0);
-        if (aSignals !== bSignals) {
-            return bSignals - aSignals;
-        }
-        return a.relativePath.localeCompare(b.relativePath);
-    }).slice(0, Math.max(20, maxFiles));
-    return sorted.map((file) => ({
-        path: file.relativePath,
-        changed: changedFileSet.has(file.relativePath),
-        isUI: file.isUI,
-        isScreen: file.isScreen,
-        isComponent: file.isComponent,
-        isState: file.isState,
-        isStyle: file.isStyle,
-        hasInteractions: file.hasInteractions,
-        keywords: file.keywords.slice(0, 20),
-        audience: file.audience,
-        flags: file.flags?.map((flag) => ({ name: flag.name, source: flag.source, defaultState: flag.defaultState })),
-    }));
-}
-function mergeFlow(existing, candidate) {
-    if (!existing) {
-        return candidate;
-    }
-    const priorityOrder = { P0: 0, P1: 1, P2: 2 };
-    const priority = priorityOrder[candidate.priority] < priorityOrder[existing.priority]
-        ? candidate.priority
-        : existing.priority;
-    return {
-        ...existing,
-        name: existing.name || candidate.name,
-        kind: existing.kind || candidate.kind,
-        score: Math.max(existing.score, candidate.score),
-        priority,
-        reasons: (0, utils_js_1.uniqueTokens)([...(existing.reasons || []), ...(candidate.reasons || [])]),
-        keywords: (0, utils_js_1.uniqueTokens)([...(existing.keywords || []), ...(candidate.keywords || [])]),
-        files: (0, utils_js_1.uniqueTokens)([...(existing.files || []), ...(candidate.files || [])]),
-        audience: (0, utils_js_1.uniqueTokens)([...(existing.audience || []), ...(candidate.audience || [])]),
-        flags: [...(existing.flags || []), ...(candidate.flags || [])],
-    };
-}
-async function mapAIFlowsFromFiles(appRoot, testsRoot, config, files, changedFiles) {
-    const providerName = config.provider === 'auto' ? 'auto' : config.provider;
-    const warnings = [];
-    if (!config.enabled) {
-        return {
-            enabled: false,
-            used: false,
-            ran: false,
-            provider: providerName,
-            flowCount: 0,
-            warnings,
-            flows: [],
-        };
-    }
-    if (files.length === 0) {
-        warnings.push('AI flow analysis skipped: no analyzable files were found.');
-        return {
-            enabled: true,
-            used: false,
-            ran: false,
-            provider: providerName,
-            flowCount: 0,
-            warnings,
-            flows: [],
-        };
-    }
-    const changedFileSet = new Set(changedFiles.map((entry) => (0, utils_js_1.normalizePath)(entry)));
-    const summarizedFiles = summarizeFiles(files, changedFileSet, config.maxFilesPerRequest);
-    const allowedFiles = new Set(files.map((entry) => entry.relativePath));
-    const fileByPath = new Map(files.map((entry) => [entry.relativePath, entry]));
-    const contextFiles = resolveContextFiles(appRoot, testsRoot, config.contextFiles || []);
-    const contextBlock = contextFiles.length > 0
-        ? contextFiles.map((entry) => `### Context: ${entry.path}\n${entry.content}`).join('\n\n')
-        : 'No optional markdown context files were found.';
-    if (contextFiles.length === 0) {
-        warnings.push('AI flow analysis context files were not found; continuing without optional markdown context.');
-    }
-    let provider;
-    try {
-        provider = config.provider === 'auto'
-            ? await provider_factory_js_1.LLMProviderFactory.createFromEnv()
-            : provider_factory_js_1.LLMProviderFactory.createFromString(config.provider);
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        warnings.push(`AI flow analysis unavailable (${providerName}): ${message}`);
-        return {
-            enabled: true,
-            used: false,
-            ran: false,
-            provider: providerName,
-            flowCount: 0,
-            warnings,
-            flows: [],
-        };
-    }
-    const prompt = [
-        'You are an expert frontend impact analyst for Mattermost.',
-        'Build impacted user flows from changed frontend files.',
-        'This must be flow-centric, not file-centric.',
-        '',
-        'Return strict JSON only with this exact shape:',
-        '{"flows":[{"id":"<flow_id>","name":"<name>","kind":"flow|screen","priority":"P0|P1|P2","score":10,"reasons":["..."],"keywords":["..."],"files":["relative/path.tsx"]}]}',
-        '',
-        'Rules:',
-        '- Use only file paths listed in FILES.',
-        '- Every flow must have at least one file.',
-        '- Keep IDs stable and lowercase with underscores when possible.',
-        '- Prioritize true user-impacting flows; avoid low-value internal buckets.',
-        '- Keep at most 6 file paths per flow.',
-        `- Keep at most ${Math.max(1, config.maxFlowsPerRequest)} flows.`,
-        '',
-        `CHANGED_FILES (${changedFileSet.size}):`,
-        JSON.stringify(Array.from(changedFileSet), null, 2),
-        '',
-        `FILES (${summarizedFiles.length}):`,
-        JSON.stringify(summarizedFiles, null, 2),
-        '',
-        contextBlock,
-    ].join('\n');
-    let parsed = null;
-    try {
-        const response = await provider.generateText(prompt, {
-            maxTokens: Math.max(800, config.maxTokens),
-            temperature: Math.max(0, Math.min(1, config.temperature)),
-            timeout: 45000,
-            systemPrompt: 'Return only valid JSON. Do not include markdown fences unless necessary.',
-        });
-        parsed = extractJson(response.text);
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        warnings.push(`AI flow analysis request failed (${provider.name}): ${message}`);
-        return {
-            enabled: true,
-            used: false,
-            ran: false,
-            provider: provider.name,
-            flowCount: 0,
-            warnings,
-            flows: [],
-        };
-    }
-    if (!parsed) {
-        warnings.push(`AI flow analysis returned invalid JSON (${provider.name}).`);
-        return {
-            enabled: true,
-            used: false,
-            ran: false,
-            provider: provider.name,
-            flowCount: 0,
-            warnings,
-            flows: [],
-        };
-    }
-    const flowsById = new Map();
-    for (const entry of parsed.flows) {
-        if (!entry || !Array.isArray(entry.files)) {
-            continue;
-        }
-        const validFiles = Array.from(new Set(entry.files
-            .filter((value) => typeof value === 'string')
-            .map((value) => (0, utils_js_1.normalizePath)(value))
-            .filter((value) => allowedFiles.has(value)))).slice(0, 6);
-        if (validFiles.length === 0) {
-            continue;
-        }
-        const rawId = typeof entry.id === 'string' && entry.id.trim()
-            ? entry.id
-            : (typeof entry.name === 'string' && entry.name.trim() ? entry.name : validFiles[0]);
-        const id = normalizeFlowId(rawId);
-        if (!id) {
-            continue;
-        }
-        const fallbackTokens = (0, utils_js_1.uniqueTokens)([
-            ...(0, utils_js_1.tokenize)(id),
-            ...(typeof entry.name === 'string' ? (0, utils_js_1.tokenize)(entry.name) : []),
-            ...validFiles.flatMap((value) => (0, utils_js_1.tokenize)(value)),
-        ]);
-        const linkedFiles = validFiles.map((path) => fileByPath.get(path)).filter(Boolean);
-        const audience = (0, utils_js_1.uniqueTokens)(linkedFiles.flatMap((file) => file.audience || []));
-        const flags = linkedFiles.flatMap((file) => file.flags || []);
-        const score = typeof entry.score === 'number' && Number.isFinite(entry.score)
-            ? Math.max(1, Math.min(20, Math.round(entry.score)))
-            : Math.max(4, validFiles.length * 2);
-        const flow = {
-            id,
-            name: typeof entry.name === 'string' && entry.name.trim() ? entry.name.trim() : id.replace(/[_/.-]+/g, ' '),
-            kind: entry.kind === 'screen' ? 'screen' : 'flow',
-            score,
-            priority: priorityFromEntry(entry),
-            reasons: sanitizeReasons(entry.reasons, 'AI flow analysis identified impacted behavior'),
-            keywords: sanitizeKeywords(entry.keywords, fallbackTokens),
-            files: validFiles,
-            audience,
-            flags,
-        };
-        flowsById.set(id, mergeFlow(flowsById.get(id), flow));
-        if (flowsById.size >= Math.max(1, config.maxFlowsPerRequest)) {
-            break;
-        }
-    }
-    const flows = Array.from(flowsById.values());
-    if (flows.length === 0) {
-        warnings.push('AI flow analysis did not return any valid flows linked to changed files.');
-        return {
-            enabled: true,
-            used: false,
-            ran: true, // AI was called and responded — no user-facing flows impacted
-            provider: provider.name,
-            flowCount: 0,
-            warnings,
-            flows: [],
-        };
-    }
-    return {
-        enabled: true,
-        used: true,
-        ran: true,
-        provider: provider.name,
-        flowCount: flows.length,
-        warnings,
-        flows,
-    };
-}

package/dist/agent/ai_mapping.d.ts

@@ -1,14 +0,0 @@
-import type { FlowImpact } from './analysis.js';
-import type { AIMappingImpactConfig } from './config.js';
-import type { FlowCoverage, TestFile } from './tests.js';
-export interface AIMappingResult {
-    enabled: boolean;
-    used: boolean;
-    provider: string;
-    mappedFlows: number;
-    matchedTests: number;
-    coverage: FlowCoverage[];
-    warnings: string[];
-}
-export declare function mapAITestsToFlows(appRoot: string, testsRoot: string, config: AIMappingImpactConfig, flows: FlowImpact[], tests: TestFile[]): Promise<AIMappingResult>;
-//# sourceMappingURL=ai_mapping.d.ts.map

package/dist/agent/ai_mapping.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ai_mapping.d.ts","sourceRoot":"","sources":["../../src/agent/ai_mapping.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAC,qBAAqB,EAAC,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EAAC,YAAY,EAAE,QAAQ,EAAC,MAAM,YAAY,CAAC;AA4BvD,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACtB;AA4WD,wBAAsB,iBAAiB,CACnC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,qBAAqB,EAC7B,KAAK,EAAE,UAAU,EAAE,EACnB,KAAK,EAAE,QAAQ,EAAE,GAClB,OAAO,CAAC,eAAe,CAAC,CAgP1B"}