@oddessentials/odd-repo-mapper 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Odd Essentials
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,45 @@
+# odd-repo-mapper
+
+Deterministic code intelligence tool producing evidence-backed architecture diagrams and feature-test traceability matrices.
+
+## Quick Start
+
+```bash
+npm install
+npm run build
+
+# Scan a repository
+npx repo-mapper scan --root . --out ./out
+
+# Verify outputs
+npx repo-mapper verify ./out
+```
+
+## Philosophy
+
+> The mapper does not explain the codebase.
+> It produces evidence that allows humans (and tools) to explain it safely.
+
+- **Evidence-first**: Every claim is backed by file/symbol/edge proof
+- **Deterministic**: Same inputs → same outputs, byte-for-byte
+- **Fail-closed**: Missing evidence → failure, not silent degradation
+
+## Commands
+
+| Command  | Description                                                   |
+| -------- | ------------------------------------------------------------- |
+| `scan`   | Produce `repo_profile.json`, `toolchain.json`, `graph.sqlite` |
+| `verify` | Validate artifacts against schemas and invariants             |
+
+## Artifacts
+
+| File                | Description                                        |
+| ------------------- | -------------------------------------------------- |
+| `repo_profile.json` | File classification, language stats, build systems |
+| `toolchain.json`    | Node version, lockfile hash, dependencies          |
+| `graph.sqlite`      | SQLite knowledge graph (canonical)                 |
+| `graph.json`        | Portable JSON export with contentHash              |
+
+## License
+
+MIT

package/dist/cli/commands/mcp.d.ts

@@ -0,0 +1,6 @@
+/**
+ * MCP server CLI command.
+ */
+import { Command } from 'commander';
+export declare const mcpCommand: Command;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/cli/commands/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/mcp.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,eAAO,MAAM,UAAU,SAIjB,CAAC"}

package/dist/cli/commands/mcp.js

@@ -0,0 +1,11 @@
+/**
+ * MCP server CLI command.
+ */
+import { Command } from 'commander';
+import { startMcpServer } from '../../mcp/server.js';
+export const mcpCommand = new Command('mcp')
+    .description('Start the MCP (Model Context Protocol) server')
+    .action(async () => {
+    await startMcpServer();
+});
+//# sourceMappingURL=mcp.js.map

package/dist/cli/commands/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../../src/cli/commands/mcp.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC;KACvC,WAAW,CAAC,+CAA+C,CAAC;KAC5D,MAAM,CAAC,KAAK,IAAI,EAAE;IACf,MAAM,cAAc,EAAE,CAAC;AAC3B,CAAC,CAAC,CAAC"}

package/dist/cli/commands/report.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Report command: generates diagrams and traceability reports.
+ */
+import { Command } from 'commander';
+export declare const reportCommand: Command;
+//# sourceMappingURL=report.d.ts.map

package/dist/cli/commands/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/report.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,eAAO,MAAM,aAAa,SA2GpB,CAAC"}

package/dist/cli/commands/report.js

@@ -0,0 +1,96 @@
+/**
+ * Report command: generates diagrams and traceability reports.
+ */
+import { Command } from 'commander';
+import { resolve, join } from 'node:path';
+import { existsSync } from 'node:fs';
+import Database from 'better-sqlite3';
+import { writeMermaidDiagram, importCoverage, writeTraceabilityMatrix, writeTraceabilityMarkdown, } from '../../core/reports/index.js';
+export const reportCommand = new Command('report')
+    .description('Generate architecture diagrams and traceability reports')
+    .option('-d, --dir <path>', 'Output directory containing graph.sqlite', './out')
+    .option('-o, --out <path>', 'Report output directory', './out/reports')
+    .option('-c, --coverage <path>', 'Path to coverage file (lcov or cobertura)')
+    .option('--format <format>', 'Output format: mermaid, json, markdown, all', 'all')
+    .action(async (options) => {
+    const dataDir = resolve(options.dir);
+    const outDir = resolve(options.out);
+    const dbPath = join(dataDir, 'graph.sqlite');
+    console.log(`Loading graph: ${dbPath}`);
+    console.log(`Reports output: ${outDir}`);
+    if (!existsSync(dbPath)) {
+        console.error(`✗ Graph database not found: ${dbPath}`);
+        console.error('  Run "repo-mapper scan" first to generate the graph.');
+        process.exit(1);
+    }
+    const db = new Database(dbPath, { readonly: true });
+    try {
+        const formats = options.format === 'all' ? ['mermaid', 'json', 'markdown'] : [options.format];
+        // 1. Import coverage if provided
+        let coverageData = undefined;
+        if (options.coverage && existsSync(options.coverage)) {
+            console.log(`\nImporting coverage: ${options.coverage}`);
+            const coverageResult = importCoverage(options.coverage, resolve('.'));
+            if (coverageResult.errors.length > 0) {
+                for (const err of coverageResult.errors) {
+                    console.error(`  ⚠ ${err}`);
+                }
+            }
+            if (coverageResult.data.files.length > 0) {
+                console.log(`  Files: ${coverageResult.data.files.length}`);
+                console.log(`  Coverage: ${coverageResult.data.percentage}%`);
+                coverageData = coverageResult.data;
+            }
+        }
+        // 2. Generate Mermaid diagrams
+        if (formats.includes('mermaid')) {
+            console.log('\n--- Generating Diagrams ---');
+            // Import graph
+            const importGraphPath = join(outDir, 'import-graph.mmd');
+            const importResult = writeMermaidDiagram(db, importGraphPath, {
+                nodeTypes: ['file', 'module'],
+                edgeKinds: ['import'],
+                direction: 'LR',
+                groupByDirectory: true,
+            });
+            console.log(`  Import graph: ${importResult.nodeCount} nodes, ${importResult.edgeCount} edges`);
+            if (importResult.truncated) {
+                console.log(`  ⚠ Diagram truncated (max 250 nodes)`);
+            }
+            console.log(`  Wrote: ${importGraphPath}`);
+            // Full architecture diagram
+            const fullGraphPath = join(outDir, 'architecture.mmd');
+            const fullResult = writeMermaidDiagram(db, fullGraphPath, {
+                direction: 'TB',
+                groupByDirectory: true,
+            });
+            console.log(`  Architecture: ${fullResult.nodeCount} nodes, ${fullResult.edgeCount} edges`);
+            console.log(`  Wrote: ${fullGraphPath}`);
+        }
+        // 3. Generate traceability matrix
+        console.log('\n--- Generating Traceability Matrix ---');
+        if (formats.includes('json')) {
+            const jsonPath = join(outDir, 'traceability.json');
+            const matrix = writeTraceabilityMatrix(db, jsonPath, { coverageData });
+            console.log(`  Links: ${matrix.stats.totalLinks}`);
+            console.log(`  By type: ${Object.entries(matrix.stats.byLinkType)
+                .map(([k, v]) => `${k}=${v}`)
+                .join(', ')}`);
+            console.log(`  Wrote: ${jsonPath}`);
+        }
+        if (formats.includes('markdown')) {
+            const mdPath = join(outDir, 'traceability.md');
+            writeTraceabilityMarkdown(db, mdPath, { coverageData });
+            console.log(`  Wrote: ${mdPath}`);
+        }
+        console.log('\n✓ Reports generated');
+    }
+    catch (err) {
+        console.error(`\n✗ Report generation failed: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+    finally {
+        db.close();
+    }
+});
+//# sourceMappingURL=report.js.map

package/dist/cli/commands/report.js.map

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

package/dist/cli/commands/scan.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Scan command: produces repo_profile.json + populated graph.
+ */
+import { Command } from 'commander';
+export declare const scanCommand: Command;
+//# sourceMappingURL=scan.d.ts.map

package/dist/cli/commands/scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/scan.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,eAAO,MAAM,WAAW,SAwIlB,CAAC"}

package/dist/cli/commands/scan.js

@@ -0,0 +1,118 @@
+/**
+ * Scan command: produces repo_profile.json + populated graph.
+ */
+import { Command } from 'commander';
+import { resolve, join } from 'node:path';
+import { writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { loadConfig, createDefaultConfig } from '../../core/config.js';
+import { collectToolchain } from '../../core/toolchain.js';
+import { scanDirectory } from '../../core/scanner.js';
+import { initGraphDatabase, insertNode, insertEdge, writeGraphJson } from '../../core/graph.js';
+import { indexAll } from '../../core/indexers/index.js';
+export const scanCommand = new Command('scan')
+    .description('Scan a repository and produce repo_profile.json + knowledge graph')
+    .option('-c, --config <path>', 'Path to config file', 'repo-mapper.config.json')
+    .option('-r, --root <path>', 'Repository root directory', '.')
+    .option('-o, --out <path>', 'Output directory', './out')
+    .option('--skip-index', 'Skip language indexing (M0 mode)', false)
+    .action(async (options) => {
+    const rootDir = resolve(options.root);
+    const outDir = resolve(options.out);
+    console.log(`Scanning: ${rootDir}`);
+    console.log(`Output:   ${outDir}`);
+    // Load or create config
+    const configPath = resolve(options.config);
+    let config = createDefaultConfig(rootDir);
+    const loadResult = loadConfig(configPath);
+    if (loadResult.success && loadResult.config) {
+        config = loadResult.config;
+    }
+    else if (loadResult.errors) {
+        console.log('Using default config (no config file found)');
+    }
+    // Collect toolchain
+    const toolchain = collectToolchain(rootDir);
+    console.log(`Node: ${toolchain.node}`);
+    // Scan
+    try {
+        const scanResult = scanDirectory(rootDir, toolchain, {
+            maxFiles: config.limits?.maxFiles ?? undefined,
+            testPatterns: config.indexing?.tests?.patterns ?? undefined,
+        });
+        // Write outputs
+        mkdirSync(outDir, { recursive: true });
+        // repo_profile.json (remove internal fileEntries before serialization)
+        const profilePath = join(outDir, 'repo_profile.json');
+        const { fileEntries: _fileEntries, ...profileForJson } = scanResult;
+        writeFileSync(profilePath, JSON.stringify(profileForJson, null, 2).replace(/\r\n/g, '\n'), 'utf8');
+        console.log(`Wrote: ${profilePath}`);
+        // toolchain.json
+        const toolchainPath = join(outDir, 'toolchain.json');
+        writeFileSync(toolchainPath, JSON.stringify(toolchain, null, 2).replace(/\r\n/g, '\n'), 'utf8');
+        console.log(`Wrote: ${toolchainPath}`);
+        // Initialize graph
+        const dbPath = join(outDir, 'graph.sqlite');
+        const db = initGraphDatabase(dbPath);
+        console.log(`Initialized: ${dbPath}`);
+        // Index if not skipped
+        if (!options.skipIndex) {
+            // Group files by language for indexers
+            const filesByLanguage = groupFilesByLanguage(scanResult.fileEntries ?? []);
+            console.log('\n--- Indexing ---');
+            const tsConfigPath = join(rootDir, 'tsconfig.json');
+            const indexResult = indexAll({
+                rootDir,
+                files: filesByLanguage,
+                tsConfigPath: existsSync(tsConfigPath) ? tsConfigPath : undefined,
+            });
+            // Insert nodes
+            for (const node of indexResult.nodes) {
+                insertNode(db, node);
+            }
+            // Insert edges
+            for (const edge of indexResult.edges) {
+                insertEdge(db, edge);
+            }
+            console.log(`TypeScript: ${indexResult.stats.typescript.nodes} nodes, ${indexResult.stats.typescript.edges} edges`);
+            console.log(`Python:     ${indexResult.stats.python.nodes} nodes, ${indexResult.stats.python.edges} edges`);
+            console.log(`Go:         ${indexResult.stats.go.nodes} nodes, ${indexResult.stats.go.edges} edges`);
+            console.log(`Rust:       ${indexResult.stats.rust.nodes} nodes, ${indexResult.stats.rust.edges} edges`);
+        }
+        // Export graph.json
+        const graphPath = join(outDir, 'graph.json');
+        const graphExport = await writeGraphJson(db, graphPath);
+        console.log(`\nWrote: ${graphPath} (${graphExport.meta.nodeCount} nodes, ${graphExport.meta.edgeCount} edges)`);
+        db.close();
+        // Print summary
+        console.log('\n--- Scan Summary ---');
+        console.log(`Files:     ${scanResult.files.total}`);
+        console.log(`Languages: ${scanResult.languages.map((l) => `${l.id}(${l.fileCount})`).join(', ')}`);
+        console.log(`Build sys: ${scanResult.buildSystems
+            .filter((b) => b.detected)
+            .map((b) => b.id)
+            .join(', ') || 'none'}`);
+        if (scanResult.warnings.length > 0) {
+            console.log('\nWarnings:');
+            for (const w of scanResult.warnings) {
+                console.log(`  ⚠ ${w}`);
+            }
+        }
+        console.log('\n✓ Scan complete');
+    }
+    catch (err) {
+        console.error(`\n✗ Scan failed: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+});
+function groupFilesByLanguage(files) {
+    const map = new Map();
+    for (const file of files) {
+        const lang = file.language;
+        if (!map.has(lang)) {
+            map.set(lang, []);
+        }
+        map.get(lang).push(file.path);
+    }
+    return map;
+}
+//# sourceMappingURL=scan.js.map

package/dist/cli/commands/scan.js.map

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

package/dist/cli/commands/verify.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Verify command: validates all artifacts in output directory.
+ */
+import { Command } from 'commander';
+export declare const verifyCommand: Command;
+//# sourceMappingURL=verify.d.ts.map

package/dist/cli/commands/verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/verify.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,eAAO,MAAM,aAAa,SA4CpB,CAAC"}

package/dist/cli/commands/verify.js

@@ -0,0 +1,47 @@
+/**
+ * Verify command: validates all artifacts in output directory.
+ */
+import { Command } from 'commander';
+import { resolve } from 'node:path';
+import { verifyOutputDir } from '../../core/verify.js';
+export const verifyCommand = new Command('verify')
+    .description('Verify artifacts in an output directory')
+    .argument('<outDir>', 'Output directory to verify')
+    .option('-r, --root <path>', 'Repository root directory (for toolchain alignment)', '.')
+    .action(async (outDir, options) => {
+    const resolvedOut = resolve(outDir);
+    const resolvedRoot = resolve(options.root);
+    console.log(`Verifying: ${resolvedOut}`);
+    console.log(`Root:      ${resolvedRoot}`);
+    console.log('');
+    try {
+        const result = await verifyOutputDir(resolvedOut, resolvedRoot);
+        if (result.warnings.length > 0) {
+            console.log('Warnings:');
+            for (const w of result.warnings) {
+                console.log(`  ⚠ ${w}`);
+            }
+            console.log('');
+        }
+        if (result.errors.length > 0) {
+            console.log('Errors:');
+            for (const e of result.errors) {
+                console.log(`  ✗ ${e}`);
+            }
+            console.log('');
+        }
+        if (result.passed) {
+            console.log('✓ Verification passed');
+            process.exit(0);
+        }
+        else {
+            console.log(`✗ Verification failed (${result.errors.length} errors)`);
+            process.exit(1);
+        }
+    }
+    catch (err) {
+        console.error(`\n✗ Verification error: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=verify.js.map

package/dist/cli/commands/verify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.js","sourceRoot":"","sources":["../../../src/cli/commands/verify.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC;KAC7C,WAAW,CAAC,yCAAyC,CAAC;KACtD,QAAQ,CAAC,UAAU,EAAE,4BAA4B,CAAC;KAClD,MAAM,CAAC,mBAAmB,EAAE,qDAAqD,EAAE,GAAG,CAAC;KACvF,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,OAAO,EAAE,EAAE;IACtC,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3C,OAAO,CAAC,GAAG,CAAC,cAAc,WAAW,EAAE,CAAC,CAAC;IACzC,OAAO,CAAC,GAAG,CAAC,cAAc,YAAY,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhB,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;QAEhE,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YACzB,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBAC9B,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAC5B,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpB,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACvB,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAC5B,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAC5B,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpB,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;YACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;aAAM,CAAC;YACJ,OAAO,CAAC,GAAG,CAAC,0BAA0B,MAAM,CAAC,MAAM,CAAC,MAAM,UAAU,CAAC,CAAC;YACtE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CACT,2BAA2B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAChF,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * CLI entry point for repo-mapper.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/cli/index.js

@@ -0,0 +1,20 @@
+/**
+ * CLI entry point for repo-mapper.
+ */
+import { Command } from 'commander';
+import { scanCommand } from './commands/scan.js';
+import { verifyCommand } from './commands/verify.js';
+import { reportCommand } from './commands/report.js';
+import { mcpCommand } from './commands/mcp.js';
+import { REPO_MAPPER_VERSION } from '../core/constants.js';
+const program = new Command();
+program
+    .name('repo-mapper')
+    .description('Deterministic code intelligence tool')
+    .version(REPO_MAPPER_VERSION);
+program.addCommand(scanCommand);
+program.addCommand(verifyCommand);
+program.addCommand(reportCommand);
+program.addCommand(mcpCommand);
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACF,IAAI,CAAC,aAAa,CAAC;KACnB,WAAW,CAAC,sCAAsC,CAAC;KACnD,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAElC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;AAE/B,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/core/config.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Configuration loading and validation.
+ * Uses Ajv for strict JSON Schema validation.
+ */
+export interface RepoMapperConfig {
+    version: '0.1.0';
+    project: {
+        rootDir: string;
+        name?: string;
+        repoId?: string;
+    };
+    indexing?: {
+        languages?: {
+            tier1?: ('typescript' | 'javascript' | 'python' | 'go' | 'rust')[];
+            tier2?: ('java' | 'kotlin' | 'csharp' | 'ruby' | 'php')[];
+        };
+        tests?: {
+            patterns?: string[];
+            linking?: {
+                minConfidence?: number;
+                allowBelowThreshold?: boolean;
+            };
+        };
+    };
+    output: {
+        outDir: string;
+        writeIntermediateArtifacts?: boolean;
+    };
+    determinism?: {
+        sortOrder?: 'path_then_name' | 'name_then_path';
+        stableIdMode?: 'path_hash' | 'content_hash';
+    };
+    limits?: {
+        maxFiles?: number;
+        maxEdges?: number;
+        maxSymbols?: number;
+        maxNodesPerDiagram?: number;
+    };
+}
+export interface ConfigLoadResult {
+    success: boolean;
+    config?: RepoMapperConfig;
+    errors?: string[];
+}
+/**
+ * Load and validate configuration from file.
+ */
+export declare function loadConfig(configPath: string): ConfigLoadResult;
+/**
+ * Create a minimal default config for a project.
+ */
+export declare function createDefaultConfig(rootDir: string): RepoMapperConfig;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE;QACL,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,QAAQ,CAAC,EAAE;QACP,SAAS,CAAC,EAAE;YACR,KAAK,CAAC,EAAE,CAAC,YAAY,GAAG,YAAY,GAAG,QAAQ,GAAG,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC;YACnE,KAAK,CAAC,EAAE,CAAC,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC,EAAE,CAAC;SAC7D,CAAC;QACF,KAAK,CAAC,EAAE;YACJ,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;YACpB,OAAO,CAAC,EAAE;gBACN,aAAa,CAAC,EAAE,MAAM,CAAC;gBACvB,mBAAmB,CAAC,EAAE,OAAO,CAAC;aACjC,CAAC;SACL,CAAC;KACL,CAAC;IACF,MAAM,EAAE;QACJ,MAAM,EAAE,MAAM,CAAC;QACf,0BAA0B,CAAC,EAAE,OAAO,CAAC;KACxC,CAAC;IACF,WAAW,CAAC,EAAE;QACV,SAAS,CAAC,EAAE,gBAAgB,GAAG,gBAAgB,CAAC;QAChD,YAAY,CAAC,EAAE,WAAW,GAAG,cAAc,CAAC;KAC/C,CAAC;IACF,MAAM,CAAC,EAAE;QACL,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;KAC/B,CAAC;CACL;AAKD,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,CAgC/D;AAyDD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAMrE"}

package/dist/core/config.js

@@ -0,0 +1,106 @@
+/**
+ * Configuration loading and validation.
+ * Uses Ajv for strict JSON Schema validation.
+ */
+import { readFileSync, existsSync } from 'node:fs';
+import Ajv from 'ajv';
+import { SCHEMA_VERSION, LIMITS, DEFAULT_MIN_CONFIDENCE } from './constants.js';
+// Import schema at runtime
+const configSchema = JSON.parse(readFileSync(new URL('../../schemas/config.schema.json', import.meta.url), 'utf8'));
+const ajv = new Ajv.default({ strict: false, allErrors: true, validateSchema: false });
+const validateConfig = ajv.compile(configSchema);
+/**
+ * Load and validate configuration from file.
+ */
+export function loadConfig(configPath) {
+    if (!existsSync(configPath)) {
+        return {
+            success: false,
+            errors: [`Configuration file not found: ${configPath}`],
+        };
+    }
+    let rawConfig;
+    try {
+        const content = readFileSync(configPath, 'utf8');
+        rawConfig = JSON.parse(content);
+    }
+    catch (err) {
+        return {
+            success: false,
+            errors: [
+                `Failed to parse config file: ${err instanceof Error ? err.message : String(err)}`,
+            ],
+        };
+    }
+    if (!validateConfig(rawConfig)) {
+        const errors = validateConfig.errors?.map((e) => `${e.instancePath || '/'}: ${e.message}`) ?? ['Unknown validation error'];
+        return { success: false, errors };
+    }
+    // Apply defaults
+    const config = applyDefaults(rawConfig);
+    return { success: true, config };
+}
+/**
+ * Apply default values to config.
+ */
+function applyDefaults(raw) {
+    return {
+        ...raw,
+        output: {
+            outDir: raw.output.outDir ?? './out',
+            writeIntermediateArtifacts: raw.output.writeIntermediateArtifacts ?? true,
+        },
+        determinism: {
+            sortOrder: raw.determinism?.sortOrder ?? 'path_then_name',
+            stableIdMode: raw.determinism?.stableIdMode ?? 'path_hash',
+        },
+        limits: {
+            maxFiles: raw.limits?.maxFiles ?? LIMITS.maxFiles,
+            maxEdges: raw.limits?.maxEdges ?? LIMITS.maxEdges,
+            maxSymbols: raw.limits?.maxSymbols ?? LIMITS.maxSymbols,
+            maxNodesPerDiagram: raw.limits?.maxNodesPerDiagram ?? LIMITS.maxNodesPerDiagram,
+        },
+        indexing: {
+            languages: {
+                tier1: raw.indexing?.languages?.tier1 ?? [
+                    'typescript',
+                    'javascript',
+                    'python',
+                    'go',
+                    'rust',
+                ],
+                tier2: raw.indexing?.languages?.tier2 ?? [
+                    'java',
+                    'kotlin',
+                    'csharp',
+                    'ruby',
+                    'php',
+                ],
+            },
+            tests: {
+                patterns: raw.indexing?.tests?.patterns ?? [
+                    '**/*test*.*',
+                    '**/*spec*.*',
+                    '**/test/**',
+                    '**/tests/**',
+                    '**/__tests__/**',
+                ],
+                linking: {
+                    minConfidence: raw.indexing?.tests?.linking?.minConfidence ?? DEFAULT_MIN_CONFIDENCE,
+                    allowBelowThreshold: raw.indexing?.tests?.linking?.allowBelowThreshold ?? false,
+                },
+            },
+        },
+    };
+}
+/**
+ * Create a minimal default config for a project.
+ */
+export function createDefaultConfig(rootDir) {
+    return {
+        version: SCHEMA_VERSION,
+        project: { rootDir },
+        output: { outDir: './out' },
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

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