@yasserkhanorg/impact-gate 2.0.0

package/dist/training/merger.js

@@ -0,0 +1,208 @@
+"use strict";
+// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved.
+// See LICENSE.txt for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergeFamilies = mergeFamilies;
+exports.detectStaleFamilies = detectStaleFamilies;
+const child_process_1 = require("child_process");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const types_js_1 = require("./types.js");
+function unionArrays(existing, incoming) {
+    const set = new Set(existing || []);
+    for (const item of incoming) {
+        set.add(item);
+    }
+    return Array.from(set);
+}
+function mergeFamily(existing, scanned) {
+    const merged = { ...existing };
+    // Structural fields: union arrays
+    merged.webappPaths = unionArrays(existing.webappPaths, scanned.webappPaths);
+    merged.serverPaths = unionArrays(existing.serverPaths, scanned.serverPaths);
+    merged.specDirs = unionArrays(existing.specDirs, scanned.specDirs);
+    merged.cypressSpecDirs = unionArrays(existing.cypressSpecDirs, scanned.cypressSpecDirs);
+    merged.tags = unionArrays(existing.tags, scanned.tags);
+    // Routes: only update if existing looks like a guess
+    if ((0, types_js_1.isGuessedRoute)(existing.routes) && !(0, types_js_1.isGuessedRoute)(scanned.routes)) {
+        merged.routes = scanned.routes;
+    }
+    // Human-curated fields: never overwrite (priority, userFlows, pageObjects, components)
+    // Merge features
+    if (scanned.features.length > 0) {
+        const existingFeatures = existing.features || [];
+        const existingIds = new Set(existingFeatures.map((f) => f.id));
+        const newFeatures = scanned.features.filter((f) => !existingIds.has(f.id));
+        if (newFeatures.length > 0) {
+            merged.features = [
+                ...existingFeatures,
+                ...newFeatures.map((f) => ({
+                    id: f.id,
+                    webappPaths: f.webappPaths,
+                    serverPaths: f.serverPaths,
+                    specDirs: f.specDirs,
+                })),
+            ];
+        }
+    }
+    return merged;
+}
+function scannedToRouteFamily(scanned) {
+    const family = {
+        id: scanned.id,
+        routes: scanned.routes,
+    };
+    if (scanned.webappPaths.length > 0)
+        family.webappPaths = scanned.webappPaths;
+    if (scanned.serverPaths.length > 0)
+        family.serverPaths = scanned.serverPaths;
+    if (scanned.specDirs.length > 0)
+        family.specDirs = scanned.specDirs;
+    if (scanned.cypressSpecDirs.length > 0)
+        family.cypressSpecDirs = scanned.cypressSpecDirs;
+    if (scanned.tags.length > 0)
+        family.tags = scanned.tags;
+    if (scanned.features.length > 0) {
+        family.features = scanned.features.map((f) => ({
+            id: f.id,
+            webappPaths: f.webappPaths.length > 0 ? f.webappPaths : undefined,
+            serverPaths: f.serverPaths.length > 0 ? f.serverPaths : undefined,
+            specDirs: f.specDirs.length > 0 ? f.specDirs : undefined,
+        }));
+    }
+    return family;
+}
+/**
+ * Try to find a matching family ID with singular/plural normalization.
+ * "team" matches "teams", "emoji" matches "emoji", etc.
+ */
+function findFuzzyMatch(id, idMap) {
+    if (idMap.has(id))
+        return id;
+    // Try adding 's'
+    if (!id.endsWith('s') && idMap.has(id + 's'))
+        return id + 's';
+    // Try removing 's'
+    if (id.endsWith('s') && idMap.has(id.slice(0, -1)))
+        return id.slice(0, -1);
+    return undefined;
+}
+function mergeFamilies(existing, scanned) {
+    const existingFamilies = existing?.families || [];
+    const existingMap = new Map(existingFamilies.map((f) => [f.id, f]));
+    const scannedMap = new Map(scanned.map((f) => [f.id, f]));
+    const newFamilies = [];
+    const updatedFamilies = [];
+    const mergedFamilies = [];
+    // Process existing families — match scanned by exact or fuzzy ID
+    for (const ef of existingFamilies) {
+        let sf = scannedMap.get(ef.id);
+        // Try singular/plural match if exact match failed
+        if (!sf) {
+            const fuzzyId = findFuzzyMatch(ef.id, scannedMap);
+            if (fuzzyId)
+                sf = scannedMap.get(fuzzyId);
+        }
+        if (sf) {
+            mergedFamilies.push(mergeFamily(ef, sf));
+            updatedFamilies.push(ef.id);
+        }
+        else {
+            // Keep untouched
+            mergedFamilies.push({ ...ef });
+        }
+    }
+    // Add new families from scanner (if no existing family matched)
+    for (const sf of scanned) {
+        const matchedExisting = findFuzzyMatch(sf.id, existingMap);
+        if (!matchedExisting) {
+            mergedFamilies.push(scannedToRouteFamily(sf));
+            newFamilies.push(sf.id);
+        }
+    }
+    const parts = [];
+    if (updatedFamilies.length > 0)
+        parts.push(`${updatedFamilies.length} families updated`);
+    if (newFamilies.length > 0)
+        parts.push(`${newFamilies.length} new families added`);
+    if (parts.length === 0)
+        parts.push('no changes');
+    return {
+        manifest: { families: mergedFamilies, source: existing?.source || 'train-scan' },
+        newFamilies,
+        updatedFamilies,
+        staleFamilies: [],
+        summary: parts.join(', '),
+    };
+}
+/**
+ * Detect families whose paths no longer exist on disk.
+ *
+ * Paths in the manifest may be relative to different roots:
+ * - webappPaths / serverPaths are typically relative to the repo root
+ * - specDirs may be relative to the tests root
+ *
+ * We try each pattern against all provided roots (and the git repo root
+ * if discoverable) to avoid false positives from path-prefix mismatches.
+ */
+function detectStaleFamilies(manifest, projectRoot, testsRoot) {
+    const roots = new Set([(0, path_1.resolve)(projectRoot)]);
+    if (testsRoot)
+        roots.add((0, path_1.resolve)(testsRoot));
+    // Also try to discover the git repo root — manifest paths may be repo-relative
+    try {
+        const gitRoot = (0, child_process_1.execFileSync)('git', ['rev-parse', '--show-toplevel'], {
+            cwd: projectRoot,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        if (gitRoot)
+            roots.add((0, path_1.resolve)(gitRoot));
+    }
+    catch {
+        // Not a git repo or git not available — that's fine
+    }
+    const stale = [];
+    for (const family of manifest.families) {
+        const allPatterns = [
+            ...(family.webappPaths || []),
+            ...(family.serverPaths || []),
+            ...(family.specDirs || []),
+        ];
+        if (allPatterns.length === 0)
+            continue;
+        // Check if any pattern resolves to existing files/dirs in any root
+        let hasAny = false;
+        for (const pattern of allPatterns) {
+            // Strip trailing glob (* or **) to get the directory
+            const dirPart = pattern.replace(/\/?\*.*$/, '');
+            if (!dirPart)
+                continue;
+            // For file-level patterns like "server/channels/api4/draft*.go",
+            // dirPart is "server/channels/api4/draft" — check the parent dir instead
+            const isFileGlob = /\.\w+$/.test(pattern);
+            const pathsToCheck = [dirPart];
+            if (isFileGlob) {
+                const parentDir = dirPart.split('/').slice(0, -1).join('/');
+                if (parentDir)
+                    pathsToCheck.push(parentDir);
+            }
+            for (const checkPath of pathsToCheck) {
+                for (const root of roots) {
+                    if ((0, fs_1.existsSync)((0, path_1.join)(root, checkPath))) {
+                        hasAny = true;
+                        break;
+                    }
+                }
+                if (hasAny)
+                    break;
+            }
+            if (hasAny)
+                break;
+        }
+        if (!hasAny) {
+            stale.push(family.id);
+        }
+    }
+    return stale;
+}

package/dist/training/scanner.d.ts

@@ -0,0 +1,36 @@
+import type { DiscoveredDir, ScannedFamily, ScanResult } from './types.js';
+/** Configurable scanner options. All fields optional — defaults to Mattermost conventions. */
+export interface ScannerConfig {
+    serverInfraFiles?: Set<string>;
+    serverTiers?: readonly string[];
+}
+export declare function discoverSourceDirs(projectRoot: string): DiscoveredDir[];
+export declare function discoverTestDirs(projectRoot: string): DiscoveredDir[];
+/**
+ * Discover families by scanning server Go source files.
+ *
+ * The backend follows a three-tier pattern:
+ *   api4/draft.go + app/draft.go + store/sqlstore/draft_store.go
+ *
+ * Related files are grouped under parent domains:
+ *   channel.go, channel_bookmark.go, channel_category.go → "channel" family
+ *
+ * Each domain becomes a candidate family with precise serverPaths.
+ */
+export declare function discoverServerDerivedFamilies(serverRoot: string, infraFiles?: Set<string>, tiers?: readonly string[]): {
+    multiTierFamilies: ScannedFamily[];
+    singleTierFamilies: ScannedFamily[];
+};
+export declare function discoverTestDerivedFamilies(testsRoot: string): ScannedFamily[];
+/**
+ * Discover test library paths (page objects, helpers) organized by feature.
+ * Walks well-known test lib directories and maps subdirectories and files to family IDs.
+ */
+export declare function discoverTestLibPaths(testsRoot: string): Map<string, string[]>;
+/**
+ * Discover files in well-known directories (types, utils) whose basename
+ * maps directly to a family ID.
+ */
+export declare function discoverNameMatchedPaths(appPath: string, gitRepoRoot?: string): Map<string, string[]>;
+export declare function scanProject(projectRoot: string, testsRoot?: string, serverRoot?: string, gitRepoRoot?: string, config?: ScannerConfig): ScanResult;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/training/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../src/training/scanner.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAC,aAAa,EAAE,aAAa,EAAkB,UAAU,EAAC,MAAM,YAAY,CAAC;AAoEzF,8FAA8F;AAC9F,MAAM,WAAW,aAAa;IAC1B,gBAAgB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAqED,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,EAAE,CA+BvE;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,EAAE,CA6DrE;AAuLD;;;;;;;;;;GAUG;AACH,wBAAgB,6BAA6B,CACzC,UAAU,EAAE,MAAM,EAClB,UAAU,GAAE,GAAG,CAAC,MAAM,CAA8B,EACpD,KAAK,GAAE,SAAS,MAAM,EAAyB,GAChD;IAAC,iBAAiB,EAAE,aAAa,EAAE,CAAC;IAAC,kBAAkB,EAAE,aAAa,EAAE,CAAA;CAAC,CAgI3E;AAED,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,EAAE,CAiG9E;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CA8C7E;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACpC,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,GACrB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAyDvB;AAED,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,UAAU,CA8LlJ"}