@yasserkhanorg/e2e-agents 0.5.16 → 0.6.0

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) {
@@ -202,6 +223,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.6.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"}