@yasserkhanorg/e2e-agents 1.8.5 → 1.9.5

package/dist/training/scanner.js

@@ -11,6 +11,7 @@ exports.discoverNameMatchedPaths = discoverNameMatchedPaths;
 exports.scanProject = scanProject;
 const fs_1 = require("fs");
 const path_1 = require("path");
+const cluster_utils_js_1 = require("../knowledge/cluster_utils.js");
 const SOURCE_MAX_DEPTH = 3;
 // One deeper than source to account for test framework wrapper dirs (e2e/, integration/)
 const TEST_MAX_DEPTH = 5;
@@ -44,10 +45,11 @@ const STRUCTURAL_DIRS = new Set([
     'middleware', 'contexts', 'providers', 'layouts', 'templates',
 ]);
 /**
- * Server Go files that are infrastructure / cross-cutting concerns,
+ * Default server Go files that are infrastructure / cross-cutting concerns,
  * not feature-specific domains.  Matched after stripping _local/_store suffixes.
+ * Override via ScannerConfig.serverInfraFiles.
  */
-const SERVER_INFRA_FILES = new Set([
+const DEFAULT_SERVER_INFRA_FILES = new Set([
     'api', 'apitestlib', 'context', 'helpers', 'params', 'swagger',
     'app', 'server', 'enterprise', 'product_service', 'security_update_check',
     'store', 'adapters', 'errors', 'integrity', 'migrate', 'doc',
@@ -57,10 +59,11 @@ const SERVER_INFRA_FILES = new Set([
     'manifest', 'permission', 'log', 'utils',
 ]);
 /**
- * Server tier directories to scan for Go domain files.
+ * Default server tier directories to scan for Go domain files.
  * Each tier represents a layer of the backend architecture.
+ * Override via ScannerConfig.serverTiers.
  */
-const SERVER_TIERS = [
+const DEFAULT_SERVER_TIERS = [
     'channels/api4',
     'channels/app',
     'channels/store/sqlstore',
@@ -73,13 +76,7 @@ const includes = (arr, v) => arr.includes(v);
 function isSkipped(name) {
     return name.startsWith('.') || SKIP_DIRS.has(name);
 }
-function normalizeId(name) {
-    return name
-        .replace(/[A-Z]/g, (c, idx) => (idx > 0 ? `_${c.toLowerCase()}` : c.toLowerCase()))
-        .replace(/[^a-z0-9_]/g, '_')
-        .replace(/_+/g, '_')
-        .replace(/^_|_$/g, '');
-}
+const normalizeId = cluster_utils_js_1.normalizeToClusterId;
 function extractFamilyHint(dirPath, projectRoot) {
     const rel = (0, path_1.relative)(projectRoot, dirPath).replace(/\\/g, '/');
     const parts = rel.split('/').filter(Boolean);
@@ -97,32 +94,25 @@ function walkDirs(root, projectRoot, category, maxDepth, results, depth = 0) {
     if (depth > maxDepth || !(0, fs_1.existsSync)(root)) {
         return;
     }
-    let entries;
+    let dirents;
     try {
-        entries = (0, fs_1.readdirSync)(root);
+        dirents = (0, fs_1.readdirSync)(root, { withFileTypes: true });
     }
     catch {
         // ENOENT or EACCES — skip inaccessible entries
         return;
     }
-    const hasSourceFiles = entries.some((e) => {
-        const ext = e.slice(e.lastIndexOf('.'));
+    const hasSourceFiles = dirents.some((d) => {
+        if (!d.isFile())
+            return false;
+        const ext = d.name.slice(d.name.lastIndexOf('.'));
         return ['.ts', '.tsx', '.js', '.jsx', '.go', '.py', '.rs'].includes(ext);
     });
-    const subdirs = entries.filter((e) => {
-        if (isSkipped(e))
+    const subdirs = dirents.filter((d) => {
+        if (!d.isDirectory() || d.isSymbolicLink())
             return false;
-        try {
-            const stat = (0, fs_1.lstatSync)((0, path_1.join)(root, e));
-            if (stat.isSymbolicLink())
-                return false;
-            return stat.isDirectory();
-        }
-        catch {
-            // ENOENT or EACCES — skip inaccessible entries
-            return false;
-        }
-    });
+        return !isSkipped(d.name);
+    }).map((d) => d.name);
     if (hasSourceFiles && depth >= 1) {
         results.push({
             path: (0, path_1.resolve)(root),
@@ -419,7 +409,7 @@ function findParentDomain(name, allDomains) {
  *
  * Each domain becomes a candidate family with precise serverPaths.
  */
-function discoverServerDerivedFamilies(serverRoot) {
+function discoverServerDerivedFamilies(serverRoot, infraFiles = DEFAULT_SERVER_INFRA_FILES, tiers = DEFAULT_SERVER_TIERS) {
     const resolved = (0, path_1.resolve)(serverRoot);
     // First pass: collect all raw domain names across tiers
     const allRawDomains = new Set();
@@ -430,7 +420,7 @@ function discoverServerDerivedFamilies(serverRoot) {
             return;
         const baseName = entry.replace('.go', '');
         const domain = normalizeServerDomain(baseName);
-        if (!domain || SERVER_INFRA_FILES.has(domain))
+        if (!domain || infraFiles.has(domain))
             return;
         allRawDomains.add(domain);
         if (!domainTierFiles.has(domain))
@@ -440,7 +430,7 @@ function discoverServerDerivedFamilies(serverRoot) {
             tierMap.set(tierRelPath, new Set());
         tierMap.get(tierRelPath).add(baseName);
     }
-    for (const tier of SERVER_TIERS) {
+    for (const tier of tiers) {
         const tierPath = (0, path_1.join)(resolved, tier);
         if (!(0, fs_1.existsSync)(tierPath))
             continue;
@@ -477,7 +467,7 @@ function discoverServerDerivedFamilies(serverRoot) {
                     if (!(0, fs_1.lstatSync)(jobPath).isDirectory() || isSkipped(entry))
                         continue;
                     const domain = normalizeId(entry);
-                    if (SERVER_INFRA_FILES.has(domain))
+                    if (infraFiles.has(domain))
                         continue;
                     allRawDomains.add(domain);
                     const jobFiles = (0, fs_1.readdirSync)(jobPath);
@@ -764,7 +754,10 @@ function discoverNameMatchedPaths(appPath, gitRepoRoot) {
     }
     return result;
 }
-function scanProject(projectRoot, testsRoot, serverRoot, gitRepoRoot) {
+function scanProject(projectRoot, testsRoot, serverRoot, gitRepoRoot, config) {
+    // Resolve scanner config for this run (passed to functions, no module-level mutation)
+    const resolvedInfraFiles = config?.serverInfraFiles || DEFAULT_SERVER_INFRA_FILES;
+    const resolvedTiers = config?.serverTiers || DEFAULT_SERVER_TIERS;
     const resolved = (0, path_1.resolve)(projectRoot);
     const resolvedTestsRoot = testsRoot ? (0, path_1.resolve)(testsRoot) : resolved;
     const sourceDirs = discoverSourceDirs(resolved);
@@ -827,7 +820,7 @@ function scanProject(projectRoot, testsRoot, serverRoot, gitRepoRoot) {
     // When a separate serverRoot is provided, discover families from Go source
     // filenames across the three-tier backend (api4, app, store).
     if (serverRoot) {
-        const { multiTierFamilies: serverMulti, singleTierFamilies: serverSingle } = discoverServerDerivedFamilies((0, path_1.resolve)(serverRoot));
+        const { multiTierFamilies: serverMulti, singleTierFamilies: serverSingle } = discoverServerDerivedFamilies((0, path_1.resolve)(serverRoot), resolvedInfraFiles, resolvedTiers);
         const existingIds = new Set(families.map((f) => f.id));
         // Merge ALL server families (multi + single tier) into existing families,
         // but only add NEW families if they span ≥2 tiers.

package/dist/version.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Returns the package version by reading the nearest package.json.
+ * Cached after first call.
+ */
+export declare function getVersion(): string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAoBnC"}

package/dist/version.js

@@ -0,0 +1,36 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getVersion = getVersion;
+const fs_1 = require("fs");
+const path_1 = require("path");
+let _version;
+/**
+ * Returns the package version by reading the nearest package.json.
+ * Cached after first call.
+ */
+function getVersion() {
+    if (_version)
+        return _version;
+    try {
+        // Walk up from this file's compiled location to find package.json
+        for (let d = __dirname, prev = ''; d !== prev; prev = d, d = (0, path_1.dirname)(d)) {
+            try {
+                const pkg = JSON.parse((0, fs_1.readFileSync)((0, path_1.join)(d, 'package.json'), 'utf-8'));
+                if (pkg.name === '@yasserkhanorg/e2e-agents' && pkg.version) {
+                    _version = pkg.version;
+                    return _version;
+                }
+            }
+            catch {
+                // keep walking up
+            }
+        }
+    }
+    catch {
+        // fallback
+    }
+    _version = 'unknown';
+    return _version;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yasserkhanorg/e2e-agents",
-  "version": "1.8.5",
+  "version": "1.9.5",
   "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",
@@ -56,6 +56,7 @@
   "dependencies": {
     "@anthropic-ai/sdk": "^0.73.0",
     "glob": "^11.0.0",
+    "minimatch": "^10.0.0",
     "marked": "^15.0.6",
     "openai": "^4.73.0"
   },
@@ -103,7 +104,11 @@
     "vision-analysis",
     "screenshot-analysis",
     "test-discovery",
-    "test-healing"
+    "test-healing",
+    "impact-analysis",
+    "coverage",
+    "qa",
+    "ci-cd"
   ],
   "engines": {
     "node": ">=20.0.0"

package/schemas/route-families.schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "title": "Route Families Manifest",
-  "description": "Maps Mattermost route families to file patterns, page objects, components, and nested features.",
+  "description": "Maps route families to file patterns, page objects, components, and nested features.",
   "type": "object",
   "required": ["families"],
   "properties": {
@@ -65,6 +65,36 @@
             "$ref": "#/$defs/RouteFeature"
           },
           "description": "Nested features within this family for finer-grained binding"
+        },
+        "apiEndpoints": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/ApiEndpoint"
+          },
+          "description": "API endpoints this family covers (for backend/API testing)"
+        },
+        "testType": {
+          "type": "string",
+          "enum": ["ui", "api", "both"],
+          "description": "Type of tests to generate: UI (browser), API, or both. Defaults to 'ui' for backward compatibility."
+        }
+      }
+    },
+    "ApiEndpoint": {
+      "type": "object",
+      "required": ["method", "path"],
+      "properties": {
+        "method": {
+          "type": "string",
+          "description": "HTTP method (GET, POST, PUT, DELETE, PATCH)"
+        },
+        "path": {
+          "type": "string",
+          "description": "API endpoint path, e.g. '/api/v4/users'"
+        },
+        "description": {
+          "type": "string",
+          "description": "Human-readable description of the endpoint"
         }
       }
     },