@yasserkhanorg/e2e-agents 0.5.15 → 0.6.0

package/dist/agent/selectors.d.ts

@@ -1,10 +0,0 @@
-export interface DataTestIdSuggestion {
-    file: string;
-    line: number;
-    tag: string;
-    testId: string;
-    snippet: string;
-}
-export declare function findDataTestIdSuggestions(relativePath: string, content: string | null, flowId: string): DataTestIdSuggestion[];
-export declare function applyDataTestIdSuggestions(content: string, suggestions: DataTestIdSuggestion[]): string;
-//# sourceMappingURL=selectors.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"selectors.d.ts","sourceRoot":"","sources":["../../src/agent/selectors.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACnB;AAKD,wBAAgB,yBAAyB,CACrC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,MAAM,EAAE,MAAM,GACf,oBAAoB,EAAE,CA8CxB;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,oBAAoB,EAAE,GAAG,MAAM,CA6BvG"}

package/dist/agent/selectors.js

@@ -1,75 +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.findDataTestIdSuggestions = findDataTestIdSuggestions;
-exports.applyDataTestIdSuggestions = applyDataTestIdSuggestions;
-const utils_js_1 = require("./utils.js");
-const INTERACTIVE_TAGS = ['button', 'input', 'select', 'textarea', 'form', 'a'];
-const INTERACTIVE_HINT = /(onClick|onSubmit|onChange|type=['"]submit['"]|role=['"]button['"])/;
-function findDataTestIdSuggestions(relativePath, content, flowId) {
-    if (!content) {
-        return [];
-    }
-    const suggestions = [];
-    const lines = content.split('\n');
-    let counter = 1;
-    for (let i = 0; i < lines.length; i += 1) {
-        const line = lines[i];
-        const trimmed = line.trim();
-        if (!trimmed.startsWith('<')) {
-            continue;
-        }
-        if (trimmed.includes('data-testid')) {
-            continue;
-        }
-        const tagMatch = trimmed.match(/^<([a-z][a-z0-9-]*)\b/);
-        if (!tagMatch) {
-            continue;
-        }
-        const tag = tagMatch[1];
-        if (!INTERACTIVE_TAGS.includes(tag)) {
-            continue;
-        }
-        if (!INTERACTIVE_HINT.test(trimmed)) {
-            continue;
-        }
-        const testId = `${flowId}-${tag}-${counter}`;
-        counter += 1;
-        suggestions.push({
-            file: (0, utils_js_1.normalizePath)(relativePath),
-            line: i + 1,
-            tag,
-            testId,
-            snippet: trimmed.slice(0, 200),
-        });
-    }
-    return suggestions;
-}
-function applyDataTestIdSuggestions(content, suggestions) {
-    if (suggestions.length === 0) {
-        return content;
-    }
-    const lines = content.split('\n');
-    const suggestionsByLine = new Map();
-    for (const suggestion of suggestions) {
-        const bucket = suggestionsByLine.get(suggestion.line) || [];
-        bucket.push(suggestion);
-        suggestionsByLine.set(suggestion.line, bucket);
-    }
-    for (const [lineNumber, lineSuggestions] of suggestionsByLine.entries()) {
-        const index = lineNumber - 1;
-        if (index < 0 || index >= lines.length) {
-            continue;
-        }
-        let line = lines[index];
-        for (const suggestion of lineSuggestions) {
-            const pattern = new RegExp(`<${suggestion.tag}(\\s|>)`);
-            if (pattern.test(line) && !line.includes('data-testid')) {
-                line = line.replace(pattern, `<${suggestion.tag} data-testid="${suggestion.testId}"$1`);
-            }
-        }
-        lines[index] = line;
-    }
-    return lines.join('\n');
-}

package/dist/agent/subsystem_risk.d.ts

@@ -1,23 +0,0 @@
-import type { SubsystemRiskImpactConfig } from './config.js';
-export type RiskPriority = 'P0' | 'P1' | 'P2';
-export interface SubsystemRiskRuleMatch {
-    ruleId: string;
-    scoreDelta: number;
-    priorityFloor?: RiskPriority;
-    reasons: string[];
-    keywords: string[];
-}
-export interface SubsystemRiskMapInfo {
-    source: 'map';
-    enabled: boolean;
-    mapPath: string;
-    mapFound: boolean;
-    rulesLoaded: number;
-}
-export interface SubsystemRiskResolver {
-    info: SubsystemRiskMapInfo;
-    warnings: string[];
-    matchFile: (relativePath: string) => SubsystemRiskRuleMatch[];
-}
-export declare function loadSubsystemRiskResolver(config: SubsystemRiskImpactConfig): SubsystemRiskResolver;
-//# sourceMappingURL=subsystem_risk.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"subsystem_risk.d.ts","sourceRoot":"","sources":["../../src/agent/subsystem_risk.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,yBAAyB,EAAC,MAAM,aAAa,CAAC;AAG3D,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AA2B9C,MAAM,WAAW,sBAAsB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,YAAY,CAAC;IAC7B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACjC,MAAM,EAAE,KAAK,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IAClC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,sBAAsB,EAAE,CAAC;CACjE;AAyGD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,yBAAyB,GAAG,qBAAqB,CAuHlG"}

package/dist/agent/subsystem_risk.js

@@ -1,207 +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.loadSubsystemRiskResolver = loadSubsystemRiskResolver;
-const fs_1 = require("fs");
-const utils_js_1 = require("./utils.js");
-const PRIORITY_RANK = {
-    P0: 0,
-    P1: 1,
-    P2: 2,
-};
-function coerceNumber(value) {
-    if (typeof value === 'number' && Number.isFinite(value)) {
-        return value;
-    }
-    if (typeof value === 'string') {
-        const parsed = Number(value);
-        if (Number.isFinite(parsed)) {
-            return parsed;
-        }
-    }
-    return undefined;
-}
-function normalizePriority(value) {
-    if (value === 'P0' || value === 'P1' || value === 'P2') {
-        return value;
-    }
-    return undefined;
-}
-function parseStringArray(value) {
-    if (!Array.isArray(value)) {
-        return [];
-    }
-    return value
-        .filter((item) => typeof item === 'string')
-        .map((item) => item.trim())
-        .filter(Boolean);
-}
-function parsePathArray(value) {
-    return parseStringArray(value).map((item) => (0, utils_js_1.normalizePath)(item));
-}
-function parseKeywords(value) {
-    if (!Array.isArray(value)) {
-        return [];
-    }
-    return Array.from(new Set(value
-        .filter((item) => typeof item === 'string')
-        .map((item) => item.trim().toLowerCase())
-        .filter(Boolean)));
-}
-function parseRules(rawRules, warnings) {
-    if (!Array.isArray(rawRules)) {
-        warnings.push('Subsystem risk map has no "rules" array.');
-        return [];
-    }
-    const parsed = [];
-    for (let i = 0; i < rawRules.length; i += 1) {
-        const rawRule = rawRules[i];
-        if (!rawRule || typeof rawRule !== 'object') {
-            continue;
-        }
-        const patterns = parsePathArray(rawRule.patterns);
-        if (patterns.length === 0) {
-            warnings.push(`Subsystem risk rule at index ${i} has no valid patterns and was skipped.`);
-            continue;
-        }
-        const id = typeof rawRule.id === 'string' && rawRule.id.trim()
-            ? rawRule.id.trim()
-            : `rule-${i + 1}`;
-        const description = typeof rawRule.description === 'string' ? rawRule.description.trim() : undefined;
-        const reasons = parseStringArray(rawRule.reasons);
-        const keywords = parseKeywords(rawRule.keywords);
-        const scoreDelta = coerceNumber(rawRule.scoreDelta) ?? 0;
-        const priorityFloor = normalizePriority(rawRule.priorityFloor);
-        const normalizedReasons = reasons.length > 0
-            ? reasons
-            : (description ? [description] : []);
-        parsed.push({
-            id,
-            description,
-            patterns,
-            scoreDelta,
-            priorityFloor,
-            reasons: normalizedReasons,
-            keywords,
-        });
-    }
-    return parsed;
-}
-function comparePriority(a, b) {
-    return PRIORITY_RANK[a] <= PRIORITY_RANK[b] ? a : b;
-}
-function loadSubsystemRiskResolver(config) {
-    const mapPath = (0, utils_js_1.normalizePath)(config.mapPath);
-    const warnings = [];
-    if (!config.enabled) {
-        return {
-            info: {
-                source: 'map',
-                enabled: false,
-                mapPath,
-                mapFound: false,
-                rulesLoaded: 0,
-            },
-            warnings,
-            matchFile: () => [],
-        };
-    }
-    if (!(0, fs_1.existsSync)(config.mapPath)) {
-        warnings.push(`Subsystem risk map file not found: ${config.mapPath}`);
-        return {
-            info: {
-                source: 'map',
-                enabled: true,
-                mapPath,
-                mapFound: false,
-                rulesLoaded: 0,
-            },
-            warnings,
-            matchFile: () => [],
-        };
-    }
-    let raw;
-    try {
-        raw = JSON.parse((0, fs_1.readFileSync)(config.mapPath, 'utf-8'));
-    }
-    catch {
-        warnings.push(`Subsystem risk map is invalid JSON: ${config.mapPath}`);
-        return {
-            info: {
-                source: 'map',
-                enabled: true,
-                mapPath,
-                mapFound: true,
-                rulesLoaded: 0,
-            },
-            warnings,
-            matchFile: () => [],
-        };
-    }
-    const rules = parseRules(raw.rules, warnings);
-    if (rules.length === 0) {
-        warnings.push(`Subsystem risk map loaded but no valid rules were found: ${config.mapPath}`);
-    }
-    const maxRules = Math.max(1, Math.round(config.maxRulesPerFile));
-    return {
-        info: {
-            source: 'map',
-            enabled: true,
-            mapPath,
-            mapFound: true,
-            rulesLoaded: rules.length,
-        },
-        warnings,
-        matchFile: (relativePath) => {
-            const normalizedPath = (0, utils_js_1.normalizePath)(relativePath);
-            const matches = [];
-            for (const rule of rules) {
-                const matched = rule.patterns.some((pattern) => (0, utils_js_1.matchGlob)(normalizedPath, pattern));
-                if (!matched) {
-                    continue;
-                }
-                const reasons = rule.reasons.length > 0
-                    ? rule.reasons
-                    : [`Subsystem risk rule matched: ${rule.id}`];
-                matches.push({
-                    ruleId: rule.id,
-                    scoreDelta: rule.scoreDelta,
-                    priorityFloor: rule.priorityFloor,
-                    reasons,
-                    keywords: rule.keywords,
-                    priorityRank: rule.priorityFloor ? PRIORITY_RANK[rule.priorityFloor] : 99,
-                });
-            }
-            if (matches.length <= maxRules) {
-                return matches.map(({ priorityRank, ...rest }) => rest);
-            }
-            matches.sort((a, b) => {
-                const deltaDiff = Math.abs(b.scoreDelta) - Math.abs(a.scoreDelta);
-                if (deltaDiff !== 0) {
-                    return deltaDiff;
-                }
-                const priorityDiff = a.priorityRank - b.priorityRank;
-                if (priorityDiff !== 0) {
-                    return priorityDiff;
-                }
-                return a.ruleId.localeCompare(b.ruleId);
-            });
-            const capped = matches.slice(0, maxRules).map(({ priorityRank, ...rest }) => rest);
-            let floor;
-            for (const match of capped) {
-                if (match.priorityFloor) {
-                    floor = floor ? comparePriority(floor, match.priorityFloor) : match.priorityFloor;
-                }
-            }
-            if (floor) {
-                for (const match of capped) {
-                    if (!match.priorityFloor) {
-                        match.priorityFloor = floor;
-                    }
-                }
-            }
-            return capped;
-        },
-    };
-}

package/dist/agent/tests.d.ts

@@ -1,19 +0,0 @@
-import type { FlowImpact } from './analysis.js';
-export interface TestFile {
-    path: string;
-    content: string | null;
-}
-export interface FlowCoverage {
-    flowId: string;
-    flowName: string;
-    priority: string;
-    coveredBy: string[];
-    score: number;
-    expectedTests?: string[];
-    source?: 'catalog' | 'traceability' | 'heuristic' | 'ai';
-    missingScenarios?: string[];
-}
-export declare function discoverTests(appRoot: string, patterns: string[]): TestFile[];
-export declare function mapTestsToFlows(flows: FlowImpact[], tests: TestFile[]): FlowCoverage[];
-export declare function mapCatalogTestsToFlows(flows: FlowImpact[], testsRoot: string, testsByFlow: Map<string, string[]>): FlowCoverage[];
-//# sourceMappingURL=tests.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"tests.d.ts","sourceRoot":"","sources":["../../src/agent/tests.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,eAAe,CAAC;AAG9C,MAAM,WAAW,QAAQ;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,CAAC,EAAE,SAAS,GAAG,cAAc,GAAG,WAAW,GAAG,IAAI,CAAC;IACzD,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,CAkB7E;AAUD,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,YAAY,EAAE,CAgCtF;AAuBD,wBAAgB,sBAAsB,CAClC,KAAK,EAAE,UAAU,EAAE,EACnB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GACnC,YAAY,EAAE,CA8BhB"}

package/dist/agent/tests.js

@@ -1,116 +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.discoverTests = discoverTests;
-exports.mapTestsToFlows = mapTestsToFlows;
-exports.mapCatalogTestsToFlows = mapCatalogTestsToFlows;
-const fs_1 = require("fs");
-const glob_1 = require("glob");
-const path_1 = require("path");
-const utils_js_1 = require("./utils.js");
-function discoverTests(appRoot, patterns) {
-    const files = new Set();
-    for (const pattern of patterns) {
-        const matches = (0, glob_1.globSync)(pattern, {
-            cwd: appRoot,
-            ignore: ['**/node_modules/**', '**/.git/**'],
-            nodir: true,
-        });
-        for (const match of matches) {
-            files.add((0, utils_js_1.normalizePath)(match));
-        }
-    }
-    return Array.from(files).map((relativePath) => {
-        const fullPath = (0, path_1.join)(appRoot, relativePath);
-        const content = (0, utils_js_1.safeReadTextFile)(fullPath);
-        return { path: relativePath, content };
-    });
-}
-function buildFlowKeywords(flow) {
-    const tokens = [];
-    tokens.push(...(0, utils_js_1.tokenize)(flow.id));
-    tokens.push(...(0, utils_js_1.tokenize)(flow.name));
-    tokens.push(...flow.keywords);
-    return (0, utils_js_1.uniqueTokens)(tokens);
-}
-function mapTestsToFlows(flows, tests) {
-    const coverage = [];
-    for (const flow of flows) {
-        const keywords = buildFlowKeywords(flow);
-        const matched = [];
-        let score = 0;
-        for (const test of tests) {
-            const haystack = `${test.path} ${test.content || ''}`.toLowerCase();
-            let localScore = 0;
-            for (const keyword of keywords) {
-                if (keyword && haystack.includes(keyword.toLowerCase())) {
-                    localScore += 1;
-                }
-            }
-            if (localScore > 0) {
-                matched.push(test.path);
-                score += localScore;
-            }
-        }
-        coverage.push({
-            flowId: flow.id,
-            flowName: flow.name,
-            priority: flow.priority,
-            coveredBy: matched,
-            score,
-            source: 'heuristic',
-        });
-    }
-    return coverage;
-}
-function resolveExpectedTests(testsRoot, expectedTests) {
-    const resolved = [];
-    for (const entry of expectedTests) {
-        if (!entry) {
-            continue;
-        }
-        const normalized = (0, utils_js_1.normalizePath)(entry).replace(/^\.\//, '');
-        if (normalized.startsWith('e2e-tests/playwright/')) {
-            resolved.push(normalized.slice('e2e-tests/playwright/'.length));
-            continue;
-        }
-        const specsIndex = normalized.indexOf('specs/');
-        if (specsIndex >= 0) {
-            resolved.push(normalized.slice(specsIndex));
-            continue;
-        }
-        resolved.push(normalized);
-    }
-    return Array.from(new Set(resolved));
-}
-function mapCatalogTestsToFlows(flows, testsRoot, testsByFlow) {
-    return flows.map((flow) => {
-        const expectedTests = resolveExpectedTests(testsRoot, testsByFlow.get(flow.id) || []);
-        const coveredBy = [];
-        for (const expected of expectedTests) {
-            const isAbsolute = expected.startsWith('/');
-            const globTarget = isAbsolute ? expected : expected;
-            if (expected.includes('*') || expected.includes('?') || expected.includes('{')) {
-                const matches = (0, glob_1.globSync)(globTarget, { cwd: isAbsolute ? undefined : testsRoot, nodir: true });
-                if (matches.length > 0) {
-                    coveredBy.push(...matches.map((match) => (0, utils_js_1.normalizePath)(match)));
-                }
-                continue;
-            }
-            const fullPath = isAbsolute ? expected : (0, path_1.join)(testsRoot, expected);
-            if ((0, fs_1.existsSync)(fullPath)) {
-                coveredBy.push(isAbsolute ? (0, utils_js_1.normalizePath)(expected) : expected);
-            }
-        }
-        return {
-            flowId: flow.id,
-            flowName: flow.name,
-            priority: flow.priority,
-            coveredBy: Array.from(new Set(coveredBy)),
-            score: coveredBy.length,
-            expectedTests,
-            source: 'catalog',
-        };
-    });
-}

package/dist/agent/traceability.d.ts

@@ -1,22 +0,0 @@
-import type { FlowImpact } from './analysis.js';
-import type { TraceabilityImpactConfig } from './config.js';
-import type { FlowCoverage } from './tests.js';
-export interface TraceabilityStats {
-    source: 'manifest';
-    enabled: boolean;
-    manifestPath: string;
-    manifestFound: boolean;
-    manifestTests: number;
-    manifestEdges: number;
-    matchedFlows: number;
-    totalFlows: number;
-    matchedTests: number;
-    coverageRatio: number;
-}
-export interface TraceabilityMappingResult {
-    coverage: FlowCoverage[];
-    stats: TraceabilityStats;
-    warnings: string[];
-}
-export declare function mapTraceabilityToFlows(appRoot: string, config: TraceabilityImpactConfig, flows: FlowImpact[]): TraceabilityMappingResult;
-//# sourceMappingURL=traceability.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"traceability.d.ts","sourceRoot":"","sources":["../../src/agent/traceability.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAC,wBAAwB,EAAC,MAAM,aAAa,CAAC;AAC1D,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,YAAY,CAAC;AAoB7C,MAAM,WAAW,iBAAiB;IAC9B,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,yBAAyB;IACtC,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,KAAK,EAAE,iBAAiB,CAAC;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACtB;AAsFD,wBAAgB,sBAAsB,CAClC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,wBAAwB,EAChC,KAAK,EAAE,UAAU,EAAE,GACpB,yBAAyB,CAiH3B"}

package/dist/agent/traceability.js

@@ -1,183 +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.mapTraceabilityToFlows = mapTraceabilityToFlows;
-const fs_1 = require("fs");
-const path_1 = require("path");
-const utils_js_1 = require("./utils.js");
-function ratio(numerator, denominator) {
-    if (denominator <= 0) {
-        return 0;
-    }
-    return Number((numerator / denominator).toFixed(4));
-}
-function resolveManifestPath(root, configuredPath) {
-    if ((0, path_1.isAbsolute)(configuredPath)) {
-        return configuredPath;
-    }
-    return (0, path_1.join)(root, configuredPath);
-}
-function safeReadManifest(path) {
-    if (!(0, fs_1.existsSync)(path)) {
-        return null;
-    }
-    try {
-        return JSON.parse((0, fs_1.readFileSync)(path, 'utf-8'));
-    }
-    catch {
-        return null;
-    }
-}
-function normalizeFiles(files) {
-    if (!files) {
-        return [];
-    }
-    return files.map((file) => (0, utils_js_1.normalizePath)(file)).filter(Boolean);
-}
-function normalizeTests(tests) {
-    if (!tests) {
-        return [];
-    }
-    return tests.map((test) => (0, utils_js_1.normalizePath)(test)).filter(Boolean);
-}
-function buildFileToTestsMap(manifest) {
-    const fileToTests = new Map();
-    const setMapping = (file, test) => {
-        if (!file || !test) {
-            return;
-        }
-        const key = (0, utils_js_1.normalizePath)(file);
-        const value = (0, utils_js_1.normalizePath)(test);
-        if (!fileToTests.has(key)) {
-            fileToTests.set(key, new Set());
-        }
-        fileToTests.get(key)?.add(value);
-    };
-    if (manifest.tests) {
-        for (const entry of manifest.tests) {
-            const files = normalizeFiles(entry.touchedFiles);
-            for (const file of files) {
-                setMapping(file, entry.test);
-            }
-        }
-    }
-    if (manifest.fileToTests) {
-        for (const [file, tests] of Object.entries(manifest.fileToTests)) {
-            const normalizedTests = normalizeTests(tests);
-            for (const test of normalizedTests) {
-                setMapping(file, test);
-            }
-        }
-    }
-    if (manifest.mappings) {
-        for (const entry of manifest.mappings) {
-            const normalizedTests = normalizeTests(entry.tests);
-            for (const test of normalizedTests) {
-                setMapping(entry.file, test);
-            }
-        }
-    }
-    return fileToTests;
-}
-function mapTraceabilityToFlows(appRoot, config, flows) {
-    const manifestPath = resolveManifestPath(appRoot, config.manifestPath);
-    const warnings = [];
-    const fallbackStats = {
-        source: 'manifest',
-        enabled: config.enabled,
-        manifestPath,
-        manifestFound: false,
-        manifestTests: 0,
-        manifestEdges: 0,
-        matchedFlows: 0,
-        totalFlows: flows.length,
-        matchedTests: 0,
-        coverageRatio: 0,
-    };
-    if (!config.enabled) {
-        return {
-            coverage: [],
-            warnings,
-            stats: fallbackStats,
-        };
-    }
-    const manifest = safeReadManifest(manifestPath);
-    if (!manifest) {
-        warnings.push(`Traceability manifest not found or invalid: ${manifestPath}`);
-        return {
-            coverage: [],
-            warnings,
-            stats: fallbackStats,
-        };
-    }
-    const fileToTests = buildFileToTestsMap(manifest);
-    let manifestEdges = 0;
-    for (const tests of fileToTests.values()) {
-        manifestEdges += tests.size;
-    }
-    const manifestTests = new Set();
-    const coverage = [];
-    const matchedTests = new Set();
-    let matchedFlows = 0;
-    for (const tests of fileToTests.values()) {
-        for (const test of tests) {
-            manifestTests.add(test);
-        }
-    }
-    for (const flow of flows) {
-        const signalCounts = new Map();
-        const files = flow.files.map((file) => (0, utils_js_1.normalizePath)(file));
-        for (const file of files) {
-            const tests = fileToTests.get(file);
-            if (!tests) {
-                continue;
-            }
-            for (const test of tests) {
-                signalCounts.set(test, (signalCounts.get(test) || 0) + 1);
-            }
-        }
-        const coveredBy = Array.from(signalCounts.entries())
-            .filter(([, count]) => count >= Math.max(1, config.minSignalsPerTest))
-            .map(([test]) => test)
-            .sort();
-        const score = Array.from(signalCounts.values()).reduce((acc, value) => acc + value, 0);
-        if (coveredBy.length > 0) {
-            matchedFlows += 1;
-            for (const test of coveredBy) {
-                matchedTests.add(test);
-            }
-        }
-        coverage.push({
-            flowId: flow.id,
-            flowName: flow.name,
-            priority: flow.priority,
-            coveredBy,
-            score,
-            source: 'traceability',
-        });
-    }
-    const stats = {
-        source: 'manifest',
-        enabled: config.enabled,
-        manifestPath,
-        manifestFound: true,
-        manifestTests: manifestTests.size,
-        manifestEdges,
-        matchedFlows,
-        totalFlows: flows.length,
-        matchedTests: matchedTests.size,
-        coverageRatio: ratio(matchedFlows, flows.length),
-    };
-    if (manifestEdges === 0) {
-        warnings.push(`Traceability manifest has no file-to-test mappings: ${manifestPath}`);
-    }
-    else if (stats.coverageRatio < 0.4) {
-        warnings.push(`Traceability coverage is low (${stats.matchedFlows}/${stats.totalFlows} flows mapped). Recommendations may require heuristic fallback.`);
-    }
-    return {
-        coverage,
-        warnings,
-        stats,
-    };
-}