api-tests-coverage 1.0.13 → 1.0.15

package/dist/src/pipeline/stages/ast/astStage.js

@@ -0,0 +1,238 @@
+"use strict";
+/**
+ * AST Stage — Stage 2 of the coverage pipeline.
+ *
+ * Wraps the existing AST analysis orchestrator and extends it with:
+ * - Multi-file analysis: parses all discovered files and builds a cross-file symbol table
+ * - Abstract layer traversal: resolves inherited assertions, helpers, fixtures
+ * - Graph building: converts analysis results into GraphNode[] and GraphEdge[]
+ *
+ * The AST stage reads the SCA output (from context.stageOutputs) to determine
+ * which languages and frameworks are present, enabling targeted analysis heuristics.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AstStage = void 0;
+const astAnalysisOrchestrator_1 = require("../../../ast/astAnalysisOrchestrator");
+const crossFileResolver_1 = require("./crossFileResolver");
+const abstractLayerTraversal_1 = require("./abstractLayerTraversal");
+const graphBuilder_1 = require("./graphBuilder");
+const fileClassifier_1 = require("../../../discovery/fileClassifier");
+const projectDiscovery_1 = require("../../../discovery/projectDiscovery");
+const parserRegistry_1 = require("../../../ast/parserRegistry");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+class AstStage {
+    constructor() {
+        this.name = 'ast';
+        this.optional = false;
+    }
+    async execute(context) {
+        var _a;
+        const startTime = Date.now();
+        const filesScanned = [];
+        const filesSkipped = [];
+        // Ensure all language analyzers are registered
+        (0, astAnalysisOrchestrator_1.registerAllAnalyzers)();
+        // Get SCA output for language/framework context
+        const scaOutput = context.stageOutputs.get('sca');
+        // Build analysis context
+        const analysisContext = (0, astAnalysisOrchestrator_1.buildAnalysisContext)(context.config.astConfig);
+        // Discover all files
+        const artifacts = (0, projectDiscovery_1.discoverProject)({ rootDir: context.projectRoot });
+        const allSourceFiles = [
+            ...artifacts.testFiles,
+            ...artifacts.serviceFiles,
+        ];
+        // Phase 1: Parse all files and build semantic models
+        const models = new Map();
+        const interactionsMap = new Map();
+        for (const filePath of allSourceFiles) {
+            // Enforce per-file timeout (RULE-16)
+            const fileStart = Date.now();
+            let content;
+            try {
+                content = fs.readFileSync(filePath, 'utf-8');
+            }
+            catch (err) {
+                filesSkipped.push({ file: filePath, reason: 'read-error' });
+                continue;
+            }
+            // Detect language from file extension
+            const language = detectLanguage(filePath, scaOutput);
+            if (!language) {
+                filesSkipped.push({ file: filePath, reason: 'unsupported-language' });
+                continue;
+            }
+            // Check timeout
+            if (Date.now() - fileStart > context.config.fileTimeoutMs) {
+                filesSkipped.push({ file: filePath, reason: 'timeout' });
+                continue;
+            }
+            try {
+                // Use existing AST analysis
+                const result = (0, astAnalysisOrchestrator_1.analyzeFileDetailed)(content, filePath, language, analysisContext);
+                interactionsMap.set(filePath, result.interactions);
+                // Build semantic model if we have an analyzer
+                const analyzer = (0, parserRegistry_1.getAnalyzer)(language, analysisContext.astConfig);
+                if (analyzer) {
+                    const parsed = analyzer.parse(filePath, content);
+                    if (!parsed.parseError) {
+                        const model = analyzer.buildSemanticModel(parsed, analysisContext);
+                        models.set(filePath, model);
+                    }
+                    else {
+                        // RULE-02: File not skipped on parse error — we already have fallback interactions
+                        filesSkipped.push({ file: filePath, reason: 'parse-error' });
+                    }
+                }
+                filesScanned.push(filePath);
+            }
+            catch (err) {
+                // RULE-02: Never skip a file entirely on error
+                filesSkipped.push({
+                    file: filePath,
+                    reason: `analysis-error: ${err instanceof Error ? err.message : String(err)}`,
+                });
+            }
+        }
+        // Phase 2: Build cross-file symbol table
+        const crossFileTable = (0, crossFileResolver_1.buildCrossFileSymbolTable)(models, context.projectRoot);
+        // Phase 3: Run abstract layer traversal for test files
+        const traversalResults = new Map();
+        const depthCap = context.config.traversalDepthCap;
+        for (const [filePath] of models) {
+            const basename = path.basename(filePath);
+            if (!(0, fileClassifier_1.isTestFile)(basename))
+                continue;
+            // Try inheritance chain traversal for classes in this test file
+            for (const [className, classDecl] of crossFileTable.classes) {
+                if (classDecl.filePath === filePath && classDecl.extendsClass) {
+                    const result = (0, abstractLayerTraversal_1.traverseInheritanceChain)(className, crossFileTable, depthCap);
+                    traversalResults.set(filePath, result);
+                    break; // One traversal result per test file
+                }
+            }
+            // If no inheritance found, try resolving imported helpers
+            if (!traversalResults.has(filePath)) {
+                const model = models.get(filePath);
+                if (model) {
+                    for (const [funcName, func] of model.functions) {
+                        for (const calledFunc of func.calledFunctions) {
+                            // Check if this is an imported function
+                            const importedFiles = (_a = crossFileTable.importGraph.get(filePath)) !== null && _a !== void 0 ? _a : [];
+                            for (const importedFile of importedFiles) {
+                                const importedModel = models.get(importedFile);
+                                if (importedModel === null || importedModel === void 0 ? void 0 : importedModel.functions.has(calledFunc)) {
+                                    const result = (0, abstractLayerTraversal_1.resolveImportedHelper)(calledFunc, importedFile, crossFileTable, depthCap);
+                                    if (result.resolvedAssertions.length > 0 || result.resolvedHttpCalls.length > 0) {
+                                        traversalResults.set(filePath, result);
+                                    }
+                                    break;
+                                }
+                            }
+                            if (traversalResults.has(filePath))
+                                break;
+                        }
+                        if (traversalResults.has(filePath))
+                            break;
+                    }
+                }
+            }
+        }
+        // Phase 4: Build graph nodes and edges
+        const { nodes, edges } = (0, graphBuilder_1.buildAstGraph)(models, crossFileTable, traversalResults, interactionsMap);
+        // Add nodes and edges to the context graph
+        for (const node of nodes) {
+            if (!context.graph.hasNode(node.id)) {
+                context.graph.addNode(node);
+            }
+        }
+        for (const edge of edges) {
+            if (!context.graph.hasEdge(edge.id)) {
+                context.graph.addEdge(edge);
+            }
+        }
+        // Record diagnostics (RULE-12)
+        const diagnostics = {
+            stageName: 'ast',
+            filesScanned,
+            filesSkipped,
+            durationMs: Date.now() - startTime,
+            metadata: {
+                totalModels: models.size,
+                totalInteractions: Array.from(interactionsMap.values()).reduce((sum, arr) => sum + arr.length, 0),
+                totalClasses: crossFileTable.classes.size,
+                totalExportedSymbols: crossFileTable.exportedSymbols.size,
+                traversalResultCount: traversalResults.size,
+                graphNodesAdded: nodes.length,
+                graphEdgesAdded: edges.length,
+            },
+        };
+        context.diagnostics.set('ast', diagnostics);
+        // Build output
+        const output = {
+            models,
+            crossFileTable,
+            traversalResults,
+            analyzedFiles: filesScanned,
+            skippedFiles: filesSkipped,
+        };
+        context.stageOutputs.set('ast', output);
+        return output;
+    }
+}
+exports.AstStage = AstStage;
+/**
+ * Detect the language of a file from its extension.
+ */
+function detectLanguage(filePath, scaOutput) {
+    const ext = path.extname(filePath).toLowerCase();
+    const extensionMap = {
+        '.ts': 'typescript',
+        '.tsx': 'typescript',
+        '.js': 'javascript',
+        '.jsx': 'javascript',
+        '.mjs': 'javascript',
+        '.cjs': 'javascript',
+        '.java': 'java',
+        '.kt': 'kotlin',
+        '.kts': 'kotlin',
+        '.py': 'python',
+        '.rb': 'ruby',
+        '.feature': 'cucumber',
+    };
+    return extensionMap[ext];
+}

package/dist/src/pipeline/stages/ast/crossFileResolver.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Cross-file resolver — builds a multi-file symbol table from all parsed semantic models.
+ *
+ * Aggregates per-file symbol tables, export declarations, class declarations,
+ * and import graphs into a unified `CrossFileSymbolTable` that enables
+ * cross-file constant resolution, inheritance chain traversal, and
+ * import-based helper resolution.
+ */
+import type { SemanticModel } from '../../../ast/astTypes';
+import type { CrossFileSymbolTable } from './types';
+/**
+ * Build a cross-file symbol table from all parsed semantic models.
+ *
+ * @param models - Map of filePath → SemanticModel
+ * @param projectRoot - The project root directory
+ */
+export declare function buildCrossFileSymbolTable(models: Map<string, SemanticModel>, projectRoot: string): CrossFileSymbolTable;
+/**
+ * Resolve a symbol name using the cross-file symbol table.
+ * Tries: direct lookup, qualified lookup (filePath::name), and import-chain following.
+ */
+export declare function resolveSymbolCrossFile(symbolName: string, fromFile: string, table: CrossFileSymbolTable): string | undefined;
+//# sourceMappingURL=crossFileResolver.d.ts.map

package/dist/src/pipeline/stages/ast/crossFileResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crossFileResolver.d.ts","sourceRoot":"","sources":["../../../../../src/pipeline/stages/ast/crossFileResolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAuC,MAAM,uBAAuB,CAAC;AAChG,OAAO,KAAK,EAAE,oBAAoB,EAAuC,MAAM,SAAS,CAAC;AAGzF;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,EAClC,WAAW,EAAE,MAAM,GAClB,oBAAoB,CAuDtB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,oBAAoB,GAC1B,MAAM,GAAG,SAAS,CA4BpB"}

package/dist/src/pipeline/stages/ast/crossFileResolver.js

@@ -0,0 +1,183 @@
+"use strict";
+/**
+ * Cross-file resolver — builds a multi-file symbol table from all parsed semantic models.
+ *
+ * Aggregates per-file symbol tables, export declarations, class declarations,
+ * and import graphs into a unified `CrossFileSymbolTable` that enables
+ * cross-file constant resolution, inheritance chain traversal, and
+ * import-based helper resolution.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildCrossFileSymbolTable = buildCrossFileSymbolTable;
+exports.resolveSymbolCrossFile = resolveSymbolCrossFile;
+const importResolver_1 = require("./importResolver");
+/**
+ * Build a cross-file symbol table from all parsed semantic models.
+ *
+ * @param models - Map of filePath → SemanticModel
+ * @param projectRoot - The project root directory
+ */
+function buildCrossFileSymbolTable(models, projectRoot) {
+    const exportedSymbols = new Map();
+    const classes = new Map();
+    const importGraph = new Map();
+    // Pass 1: Collect all exported symbols and class declarations
+    for (const [filePath, model] of models) {
+        // Collect constants as exported symbols
+        for (const [name, symbol] of model.constants) {
+            if (symbol.value !== undefined) {
+                exportedSymbols.set(`${filePath}::${name}`, { filePath, value: symbol.value });
+                // Also register as global name for simple lookups
+                if (!exportedSymbols.has(name)) {
+                    exportedSymbols.set(name, { filePath, value: symbol.value });
+                }
+            }
+        }
+        // Collect local variables that are const-like with string values
+        for (const [name, symbol] of model.localVariables) {
+            if (symbol.kind === 'const' && symbol.value !== undefined) {
+                exportedSymbols.set(`${filePath}::${name}`, { filePath, value: symbol.value });
+            }
+        }
+        // Collect enum members as exported symbols
+        for (const [enumName, members] of model.enums) {
+            for (const [memberName, value] of members) {
+                const qualifiedName = `${enumName}.${memberName}`;
+                exportedSymbols.set(`${filePath}::${qualifiedName}`, { filePath, value });
+                if (!exportedSymbols.has(qualifiedName)) {
+                    exportedSymbols.set(qualifiedName, { filePath, value });
+                }
+            }
+        }
+        // Extract class declarations from functions (heuristic: capitalize name + has methods)
+        extractClassDeclarations(filePath, model, classes);
+    }
+    // Pass 2: Build import graph
+    for (const [filePath, model] of models) {
+        const imports = extractImportsFromModel(filePath, model, projectRoot);
+        const resolvedPaths = [];
+        for (const imp of imports) {
+            if (imp.resolvedPath) {
+                resolvedPaths.push(imp.resolvedPath);
+            }
+        }
+        importGraph.set(filePath, resolvedPaths);
+    }
+    return { models, exportedSymbols, classes, importGraph };
+}
+/**
+ * Resolve a symbol name using the cross-file symbol table.
+ * Tries: direct lookup, qualified lookup (filePath::name), and import-chain following.
+ */
+function resolveSymbolCrossFile(symbolName, fromFile, table) {
+    var _a;
+    // Try qualified lookup for the current file
+    const qualified = table.exportedSymbols.get(`${fromFile}::${symbolName}`);
+    if (qualified)
+        return qualified.value;
+    // Try global lookup
+    const global = table.exportedSymbols.get(symbolName);
+    if (global)
+        return global.value;
+    // Try following imports from the current file
+    const importedFiles = (_a = table.importGraph.get(fromFile)) !== null && _a !== void 0 ? _a : [];
+    for (const importedFile of importedFiles) {
+        const fromImported = table.exportedSymbols.get(`${importedFile}::${symbolName}`);
+        if (fromImported)
+            return fromImported.value;
+    }
+    // Try dotted name resolution (e.g. "Config.BASE_URL")
+    const dotParts = symbolName.split('.');
+    if (dotParts.length >= 2) {
+        // Try each possible combination
+        for (const [key, entry] of table.exportedSymbols) {
+            if (key.endsWith(`::${symbolName}`) || key === symbolName) {
+                return entry.value;
+            }
+        }
+    }
+    return undefined;
+}
+/**
+ * Extract import declarations from a semantic model.
+ * This is a heuristic extraction — real import extraction would come from the AST.
+ */
+function extractImportsFromModel(filePath, model, projectRoot) {
+    const imports = [];
+    // Use functions' calledFunctions to infer cross-file references
+    for (const [, func] of model.functions) {
+        for (const calledName of func.calledFunctions) {
+            // If the function name contains a dot, it might be an import reference
+            const dotIndex = calledName.indexOf('.');
+            if (dotIndex > 0) {
+                const modulePart = calledName.substring(0, dotIndex);
+                const resolvedPath = (0, importResolver_1.resolveImportPath)(`./${modulePart}`, filePath, projectRoot, model.language);
+                if (resolvedPath) {
+                    imports.push({
+                        source: modulePart,
+                        resolvedPath,
+                        importedNames: [calledName.substring(dotIndex + 1)],
+                        isDefault: false,
+                    });
+                }
+            }
+        }
+    }
+    return imports;
+}
+/**
+ * Extract class declarations from a semantic model (heuristic).
+ *
+ * Looks for functions that follow class patterns:
+ * - Capitalized names
+ * - Constructor patterns
+ * - Extends/implements annotations
+ */
+function extractClassDeclarations(filePath, model, classes) {
+    const classMethods = new Map();
+    for (const [name, func] of model.functions) {
+        // Look for constructor patterns to detect class names
+        if (name === 'constructor' || name.startsWith('__init__'))
+            continue;
+        // Methods prefixed with "ClassName." or "ClassName#"
+        const dotIndex = name.indexOf('.');
+        const hashIndex = name.indexOf('#');
+        const separator = dotIndex >= 0 ? dotIndex : hashIndex;
+        if (separator > 0) {
+            const className = name.substring(0, separator);
+            const methodName = name.substring(separator + 1);
+            if (!classMethods.has(className)) {
+                classMethods.set(className, []);
+            }
+            classMethods.get(className).push(methodName);
+        }
+        // Check annotations for class membership
+        if (func.annotations) {
+            for (const ann of func.annotations) {
+                // Spring/Java annotations like @Controller, @Service, @RestController
+                if (ann.match(/^@(Controller|Service|Repository|Component|RestController|SpringBootTest)/)) {
+                    const className = extractClassNameFromAnnotation(name, func);
+                    if (className && !classMethods.has(className)) {
+                        classMethods.set(className, []);
+                    }
+                }
+            }
+        }
+    }
+    // Convert to ClassDeclaration objects
+    for (const [className, methods] of classMethods) {
+        if (!classes.has(className)) {
+            classes.set(className, {
+                name: className,
+                methods,
+                filePath,
+            });
+        }
+    }
+}
+function extractClassNameFromAnnotation(functionName, _func) {
+    const dotIndex = functionName.indexOf('.');
+    if (dotIndex > 0)
+        return functionName.substring(0, dotIndex);
+    return undefined;
+}

package/dist/src/pipeline/stages/ast/graphBuilder.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Graph builder — converts SemanticModels, cross-file results, and traversal
+ * results into GraphNode[] and GraphEdge[] for the Coverage Knowledge Graph.
+ */
+import type { SemanticModel, ResolvedHttpInteraction } from '../../../ast/astTypes';
+import type { GraphNode, GraphEdge } from '../../types';
+import type { CrossFileSymbolTable, TraversalResult } from './types';
+/**
+ * Build graph nodes and edges from parsed semantic models and analysis results.
+ */
+export declare function buildAstGraph(models: Map<string, SemanticModel>, crossFileTable: CrossFileSymbolTable, traversalResults: Map<string, TraversalResult>, interactions: Map<string, ResolvedHttpInteraction[]>): {
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+};
+//# sourceMappingURL=graphBuilder.d.ts.map

package/dist/src/pipeline/stages/ast/graphBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphBuilder.d.ts","sourceRoot":"","sources":["../../../../../src/pipeline/stages/ast/graphBuilder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAoB,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACtG,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAIrE;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,EAClC,cAAc,EAAE,oBAAoB,EACpC,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,EAC9C,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,uBAAuB,EAAE,CAAC,GACnD;IAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IAAC,KAAK,EAAE,SAAS,EAAE,CAAA;CAAE,CAsN5C"}