@oddessentials/odd-repo-mapper 1.0.0

package/dist/core/reports/mermaid.js

@@ -0,0 +1,171 @@
+/**
+ * Mermaid diagram generator.
+ * Produces architecture diagrams from the knowledge graph.
+ */
+import { writeFileSync, mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { LIMITS } from '../constants.js';
+/**
+ * Generate a Mermaid flowchart from the graph database.
+ */
+export function generateMermaidDiagram(db, options = {}) {
+    const { maxNodes = LIMITS.maxNodesPerDiagram, direction = 'TB', nodeTypes, edgeKinds, groupByDirectory = true, } = options;
+    // Query nodes
+    let nodeQuery = 'SELECT id, type, path, name, language FROM nodes';
+    if (nodeTypes && nodeTypes.length > 0) {
+        const types = nodeTypes.map((t) => `'${t}'`).join(',');
+        nodeQuery += ` WHERE type IN (${types})`;
+    }
+    nodeQuery += ' ORDER BY path ASC, type ASC';
+    const allNodes = db.prepare(nodeQuery).all();
+    // Query edges
+    let edgeQuery = 'SELECT source, target, kind FROM edges';
+    if (edgeKinds && edgeKinds.length > 0) {
+        const kinds = edgeKinds.map((k) => `'${k}'`).join(',');
+        edgeQuery += ` WHERE kind IN (${kinds})`;
+    }
+    const allEdges = db.prepare(edgeQuery).all();
+    // Check if we need to truncate
+    const truncated = allNodes.length > maxNodes;
+    const nodes = allNodes.slice(0, maxNodes);
+    const nodeIds = new Set(nodes.map((n) => n.id));
+    // Filter edges to only include nodes we're showing
+    const edges = allEdges.filter((e) => nodeIds.has(e.source) && nodeIds.has(e.target));
+    // Build Mermaid output
+    const lines = [];
+    lines.push(`flowchart ${direction}`);
+    lines.push('');
+    // Group nodes by directory if requested
+    if (groupByDirectory) {
+        const groups = groupNodesByDirectory(nodes);
+        for (const [dir, groupNodes] of groups) {
+            if (dir) {
+                lines.push(`  subgraph ${sanitizeId(dir)}["${escapeLabel(dir)}"]`);
+                for (const node of groupNodes) {
+                    lines.push(`    ${formatNode(node)}`);
+                }
+                lines.push('  end');
+                lines.push('');
+            }
+            else {
+                // Root-level nodes
+                for (const node of groupNodes) {
+                    lines.push(`  ${formatNode(node)}`);
+                }
+            }
+        }
+    }
+    else {
+        for (const node of nodes) {
+            lines.push(`  ${formatNode(node)}`);
+        }
+    }
+    lines.push('');
+    // Add edges
+    for (const edge of edges) {
+        lines.push(`  ${formatEdge(edge)}`);
+    }
+    // Add styling
+    lines.push('');
+    lines.push('  %% Styling');
+    lines.push('  classDef file fill:#e1f5fe,stroke:#01579b');
+    lines.push('  classDef test fill:#fff3e0,stroke:#e65100');
+    lines.push('  classDef module fill:#e8f5e9,stroke:#1b5e20');
+    lines.push('  classDef entrypoint fill:#fce4ec,stroke:#880e4f');
+    return {
+        mermaid: lines.join('\n'),
+        nodeCount: nodes.length,
+        edgeCount: edges.length,
+        truncated,
+    };
+}
+function groupNodesByDirectory(nodes) {
+    const groups = new Map();
+    for (const node of nodes) {
+        const parts = node.path.split('/');
+        const dir = parts.length > 1 ? parts.slice(0, -1).join('/') : '';
+        if (!groups.has(dir)) {
+            groups.set(dir, []);
+        }
+        groups.get(dir).push(node);
+    }
+    return groups;
+}
+function formatNode(node) {
+    const id = sanitizeId(node.id);
+    const label = node.name || node.path.split('/').pop() || node.path;
+    const shape = getNodeShape(node.type);
+    const className = node.type;
+    return `${id}${shape[0]}"${escapeLabel(label)}"${shape[1]}:::${className}`;
+}
+function formatEdge(edge) {
+    const source = sanitizeId(edge.source);
+    const target = sanitizeId(edge.target);
+    const style = getEdgeStyle(edge.kind);
+    return `${source} ${style} ${target}`;
+}
+function getNodeShape(type) {
+    switch (type) {
+        case 'module':
+            return ['[[', ']]']; // Stadium shape
+        case 'entrypoint':
+            return ['([', '])']; // Stadium shape
+        case 'test':
+            return ['{{', '}}']; // Hexagon
+        default:
+            return ['[', ']']; // Rectangle
+    }
+}
+function getEdgeStyle(kind) {
+    switch (kind) {
+        case 'import':
+            return '-->';
+        case 'contains':
+            return '-.->';
+        case 'entrypoint':
+            return '==>';
+        case 'tests':
+            return '-.->';
+        default:
+            return '-->';
+    }
+}
+function sanitizeId(id) {
+    // Mermaid IDs must be alphanumeric or underscores
+    return 'n_' + id.replace(/[^a-zA-Z0-9]/g, '_').slice(0, 32);
+}
+function escapeLabel(label) {
+    return label.replace(/"/g, "'").replace(/[<>]/g, '');
+}
+/**
+ * Write Mermaid diagram to file.
+ */
+export function writeMermaidDiagram(db, outPath, options = {}) {
+    const result = generateMermaidDiagram(db, options);
+    mkdirSync(dirname(outPath), { recursive: true });
+    writeFileSync(outPath, result.mermaid, 'utf8');
+    return result;
+}
+/**
+ * Generate an import graph focusing on module dependencies.
+ */
+export function generateImportGraph(db) {
+    return generateMermaidDiagram(db, {
+        nodeTypes: ['file', 'module'],
+        edgeKinds: ['import'],
+        direction: 'LR',
+        groupByDirectory: true,
+    });
+}
+/**
+ * Generate a test coverage diagram.
+ */
+export function generateTestGraph(db) {
+    return generateMermaidDiagram(db, {
+        nodeTypes: ['file', 'test'],
+        edgeKinds: ['tests', 'import'],
+        direction: 'TB',
+        groupByDirectory: true,
+    });
+}
+//# sourceMappingURL=mermaid.js.map

package/dist/core/reports/mermaid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mermaid.js","sourceRoot":"","sources":["../../../src/core/reports/mermaid.ts"],"names":[],"mappings":"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"}

package/dist/core/reports/traceability.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Module-Test Traceability Matrix.
+ * Per D7: Fixed confidence precedence model.
+ */
+import Database from 'better-sqlite3';
+import type { CoverageData } from './coverage.js';
+export interface TraceabilityEntry {
+    sourceFile: string;
+    testFile: string;
+    confidence: number;
+    linkType: 'coverage' | 'direct_import' | 'symbol_reference' | 'path_heuristic';
+}
+export interface TraceabilityMatrix {
+    entries: TraceabilityEntry[];
+    sourceFiles: string[];
+    testFiles: string[];
+    /** Minimum confidence threshold used */
+    minConfidence: number;
+    /** Summary statistics */
+    stats: {
+        totalLinks: number;
+        byLinkType: Record<string, number>;
+        averageConfidence: number;
+    };
+}
+export interface TraceabilityOptions {
+    minConfidence?: number;
+    includeBelowThreshold?: boolean;
+    coverageData?: CoverageData;
+}
+/**
+ * Build module-test traceability matrix from graph and coverage.
+ * Per D7: Confidence precedence - Coverage (100) > Direct Import (90) >
+ * Symbol Reference (70) > Path Heuristic (50)
+ */
+export declare function buildTraceabilityMatrix(db: Database.Database, options?: TraceabilityOptions): TraceabilityMatrix;
+/**
+ * Export traceability matrix to JSON.
+ */
+export declare function writeTraceabilityMatrix(db: Database.Database, outPath: string, options?: TraceabilityOptions): TraceabilityMatrix;
+/**
+ * Export traceability matrix to Markdown table.
+ */
+export declare function writeTraceabilityMarkdown(db: Database.Database, outPath: string, options?: TraceabilityOptions): TraceabilityMatrix;
+//# sourceMappingURL=traceability.d.ts.map

package/dist/core/reports/traceability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceability.d.ts","sourceRoot":"","sources":["../../../src/core/reports/traceability.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAItC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,MAAM,WAAW,iBAAiB;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,UAAU,GAAG,eAAe,GAAG,kBAAkB,GAAG,gBAAgB,CAAC;CAClF;AAED,MAAM,WAAW,kBAAkB;IAC/B,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,wCAAwC;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,yBAAyB;IACzB,KAAK,EAAE;QACH,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACnC,iBAAiB,EAAE,MAAM,CAAC;KAC7B,CAAC;CACL;AAED,MAAM,WAAW,mBAAmB;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,YAAY,CAAC,EAAE,YAAY,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACnC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,GAAE,mBAAwB,GAClC,kBAAkB,CAqKpB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACnC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,mBAAwB,GAClC,kBAAkB,CAQpB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACrC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,mBAAwB,GAClC,kBAAkB,CAuCpB"}

package/dist/core/reports/traceability.js

@@ -0,0 +1,190 @@
+/**
+ * Module-Test Traceability Matrix.
+ * Per D7: Fixed confidence precedence model.
+ */
+import { writeFileSync, mkdirSync } from 'node:fs';
+import { dirname, basename } from 'node:path';
+import { LINK_CONFIDENCE, DEFAULT_MIN_CONFIDENCE } from '../constants.js';
+/**
+ * Build module-test traceability matrix from graph and coverage.
+ * Per D7: Confidence precedence - Coverage (100) > Direct Import (90) >
+ * Symbol Reference (70) > Path Heuristic (50)
+ */
+export function buildTraceabilityMatrix(db, options = {}) {
+    const { minConfidence = DEFAULT_MIN_CONFIDENCE, includeBelowThreshold = false, coverageData, } = options;
+    const entries = [];
+    const sourceFilesSet = new Set();
+    const testFilesSet = new Set();
+    // 1. Get all source files
+    const sourceFiles = db
+        .prepare(`
+    SELECT path FROM nodes 
+    WHERE type = 'file' AND path NOT LIKE '%test%'
+    ORDER BY path
+  `)
+        .all();
+    // 2. Get all test files
+    const testFiles = db
+        .prepare(`
+    SELECT path FROM nodes 
+    WHERE type = 'test'
+    ORDER BY path
+  `)
+        .all();
+    for (const source of sourceFiles) {
+        sourceFilesSet.add(source.path);
+    }
+    for (const test of testFiles) {
+        testFilesSet.add(test.path);
+    }
+    // 3. Link via coverage (highest confidence: 100)
+    if (coverageData) {
+        for (const covFile of coverageData.files) {
+            if (covFile.covered > 0) {
+                // Find tests that could have produced this coverage
+                // For now, we link to all tests in the same directory
+                const covDir = dirname(covFile.path);
+                for (const test of testFiles) {
+                    const testDir = dirname(test.path);
+                    if (testDir === covDir ||
+                        test.path.includes(basename(covFile.path).replace(/\.[^.]+$/, ''))) {
+                        entries.push({
+                            sourceFile: covFile.path,
+                            testFile: test.path,
+                            confidence: LINK_CONFIDENCE.coverage,
+                            linkType: 'coverage',
+                        });
+                    }
+                }
+            }
+        }
+    }
+    // 4. Link via direct import (confidence: 90)
+    const importEdges = db
+        .prepare(`
+    SELECT n1.path as testPath, n2.path as sourcePath
+    FROM edges e
+    JOIN nodes n1 ON e.source = n1.id
+    JOIN nodes n2 ON e.target = n2.id
+    WHERE e.kind = 'import' AND n1.type = 'test' AND n2.type = 'file'
+  `)
+        .all();
+    for (const edge of importEdges) {
+        // Don't duplicate if we already have a higher-confidence link
+        const existingEntry = entries.find((e) => e.sourceFile === edge.sourcePath && e.testFile === edge.testPath);
+        if (!existingEntry || existingEntry.confidence < LINK_CONFIDENCE.directImport) {
+            if (existingEntry) {
+                existingEntry.confidence = LINK_CONFIDENCE.directImport;
+                existingEntry.linkType = 'direct_import';
+            }
+            else {
+                entries.push({
+                    sourceFile: edge.sourcePath,
+                    testFile: edge.testPath,
+                    confidence: LINK_CONFIDENCE.directImport,
+                    linkType: 'direct_import',
+                });
+            }
+        }
+    }
+    // 5. Link via path heuristic (confidence: 50)
+    // Match test files to source files by name pattern
+    for (const source of sourceFiles) {
+        const sourceName = basename(source.path).replace(/\.[^.]+$/, '');
+        for (const test of testFiles) {
+            const testName = basename(test.path).replace(/\.[^.]+$/, '');
+            // Check if test name contains source name
+            const normalizedTestName = testName.toLowerCase().replace(/[._-]/g, '');
+            const normalizedSourceName = sourceName.toLowerCase().replace(/[._-]/g, '');
+            if (normalizedTestName.includes(normalizedSourceName) ||
+                normalizedSourceName.includes(normalizedTestName.replace('test', '').replace('spec', ''))) {
+                const existingEntry = entries.find((e) => e.sourceFile === source.path && e.testFile === test.path);
+                if (!existingEntry) {
+                    entries.push({
+                        sourceFile: source.path,
+                        testFile: test.path,
+                        confidence: LINK_CONFIDENCE.pathHeuristic,
+                        linkType: 'path_heuristic',
+                    });
+                }
+            }
+        }
+    }
+    // Filter by minimum confidence
+    const filteredEntries = includeBelowThreshold
+        ? entries
+        : entries.filter((e) => e.confidence >= minConfidence);
+    // Sort by confidence descending, then by source file
+    filteredEntries.sort((a, b) => {
+        if (b.confidence !== a.confidence)
+            return b.confidence - a.confidence;
+        return a.sourceFile.localeCompare(b.sourceFile);
+    });
+    // Calculate stats
+    const byLinkType = {};
+    for (const entry of filteredEntries) {
+        byLinkType[entry.linkType] = (byLinkType[entry.linkType] || 0) + 1;
+    }
+    const averageConfidence = filteredEntries.length > 0
+        ? Math.round(filteredEntries.reduce((sum, e) => sum + e.confidence, 0) / filteredEntries.length)
+        : 0;
+    return {
+        entries: filteredEntries,
+        sourceFiles: Array.from(sourceFilesSet),
+        testFiles: Array.from(testFilesSet),
+        minConfidence,
+        stats: {
+            totalLinks: filteredEntries.length,
+            byLinkType,
+            averageConfidence,
+        },
+    };
+}
+/**
+ * Export traceability matrix to JSON.
+ */
+export function writeTraceabilityMatrix(db, outPath, options = {}) {
+    const matrix = buildTraceabilityMatrix(db, options);
+    mkdirSync(dirname(outPath), { recursive: true });
+    const json = JSON.stringify(matrix, null, 2).replace(/\r\n/g, '\n');
+    writeFileSync(outPath, json, 'utf8');
+    return matrix;
+}
+/**
+ * Export traceability matrix to Markdown table.
+ */
+export function writeTraceabilityMarkdown(db, outPath, options = {}) {
+    const matrix = buildTraceabilityMatrix(db, options);
+    const lines = [];
+    lines.push('# Module-Test Traceability Matrix');
+    lines.push('');
+    lines.push(`> Generated with minimum confidence threshold: ${matrix.minConfidence}%`);
+    lines.push('');
+    lines.push('## Summary');
+    lines.push('');
+    lines.push(`- **Total Links**: ${matrix.stats.totalLinks}`);
+    lines.push(`- **Average Confidence**: ${matrix.stats.averageConfidence}%`);
+    lines.push(`- **Source Files**: ${matrix.sourceFiles.length}`);
+    lines.push(`- **Test Files**: ${matrix.testFiles.length}`);
+    lines.push('');
+    lines.push('### Links by Type');
+    lines.push('');
+    lines.push('| Type | Count | Confidence |');
+    lines.push('|------|-------|------------|');
+    lines.push(`| Coverage | ${matrix.stats.byLinkType['coverage'] || 0} | 100 |`);
+    lines.push(`| Direct Import | ${matrix.stats.byLinkType['direct_import'] || 0} | 90 |`);
+    lines.push(`| Symbol Reference | ${matrix.stats.byLinkType['symbol_reference'] || 0} | 70 |`);
+    lines.push(`| Path Heuristic | ${matrix.stats.byLinkType['path_heuristic'] || 0} | 50 |`);
+    lines.push('');
+    lines.push('## Matrix');
+    lines.push('');
+    lines.push('| Source File | Test File | Confidence | Link Type |');
+    lines.push('|-------------|-----------|------------|-----------|');
+    for (const entry of matrix.entries) {
+        lines.push(`| ${entry.sourceFile} | ${entry.testFile} | ${entry.confidence}% | ${entry.linkType} |`);
+    }
+    mkdirSync(dirname(outPath), { recursive: true });
+    writeFileSync(outPath, lines.join('\n'), 'utf8');
+    return matrix;
+}
+//# sourceMappingURL=traceability.js.map

package/dist/core/reports/traceability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceability.js","sourceRoot":"","sources":["../../../src/core/reports/traceability.ts"],"names":[],"mappings":"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"}

package/dist/core/scanner.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Deterministic file scanner.
+ * Per D10: Lexicographic sorting, path normalization, hard limits.
+ */
+import type { Toolchain } from './toolchain.js';
+export interface FileEntry {
+    id: string;
+    path: string;
+    relativePath: string;
+    language: string;
+    tier: 1 | 2 | 3;
+    category: 'source' | 'test' | 'config' | 'other';
+    sizeBytes: number;
+}
+export interface ScanResult {
+    schemaVersion: string;
+    scanId: string;
+    rootDir: string;
+    files: {
+        total: number;
+        byLanguage: Record<string, number>;
+        byCategory: Record<string, number>;
+    };
+    languages: {
+        id: string;
+        tier: 1 | 2 | 3;
+        fileCount: number;
+        extensions: string[];
+    }[];
+    buildSystems: {
+        id: string;
+        detected: boolean;
+        manifests: string[];
+    }[];
+    toolchain: Toolchain;
+    warnings: string[];
+    /** Internal: file entries for indexers (not serialized to JSON) */
+    fileEntries?: FileEntry[];
+}
+export interface ScanOptions {
+    maxFiles?: number;
+    testPatterns?: string[];
+}
+/**
+ * Scan a directory and produce repo_profile.json content.
+ */
+export declare function scanDirectory(rootDir: string, toolchain: Toolchain, options?: ScanOptions): ScanResult;
+//# sourceMappingURL=scanner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../src/core/scanner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,WAAW,SAAS;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChB,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACjD,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE;QACH,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACnC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACtC,CAAC;IACF,SAAS,EAAE;QACP,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,EAAE,CAAC;KACxB,EAAE,CAAC;IACJ,YAAY,EAAE;QACV,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,EAAE,OAAO,CAAC;QAClB,SAAS,EAAE,MAAM,EAAE,CAAC;KACvB,EAAE,CAAC;IACJ,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,mEAAmE;IACnE,WAAW,CAAC,EAAE,SAAS,EAAE,CAAC;CAC7B;AAyDD,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,aAAa,CACzB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,EACpB,OAAO,GAAE,WAAgB,GAC1B,UAAU,CA2JZ"}