@oddessentials/odd-repo-mapper 1.0.0

package/dist/mcp/server.js

@@ -0,0 +1,421 @@
+/**
+ * MCP Server for odd-repo-mapper.
+ * Per D1: Standalone CLI exposing MCP stdio server.
+ * Per D2: Artifact references, small inline summaries, 64KB fixed chunks.
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { resolve, join } from 'node:path';
+import { existsSync, readFileSync } from 'node:fs';
+import Database from 'better-sqlite3';
+import { REPO_MAPPER_VERSION, MCP_CHUNK_SIZE_BYTES } from '../core/constants.js';
+import { scanDirectory } from '../core/scanner.js';
+import { collectToolchain } from '../core/toolchain.js';
+import { createDefaultConfig } from '../core/config.js';
+import { initGraphDatabase, insertNode, insertEdge, exportGraph } from '../core/graph.js';
+import { indexAll } from '../core/indexers/index.js';
+import { generateMermaidDiagram, buildTraceabilityMatrix } from '../core/reports/index.js';
+const server = new Server({
+    name: 'odd-repo-mapper',
+    version: REPO_MAPPER_VERSION,
+}, {
+    capabilities: {
+        tools: {},
+        resources: {},
+    },
+});
+// State
+let currentRootDir = process.cwd();
+let currentOutDir = join(currentRootDir, 'out');
+/**
+ * List available tools.
+ */
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: 'scan',
+                description: 'Scan a repository and build the knowledge graph',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        rootDir: {
+                            type: 'string',
+                            description: 'Repository root directory (default: current directory)',
+                        },
+                        outDir: {
+                            type: 'string',
+                            description: 'Output directory for artifacts (default: ./out)',
+                        },
+                    },
+                },
+            },
+            {
+                name: 'query',
+                description: 'Query the knowledge graph',
+                inputSchema: {
+                    type: 'object',
+                    required: ['query'],
+                    properties: {
+                        query: {
+                            type: 'string',
+                            description: 'SQL query to run against the graph database',
+                        },
+                    },
+                },
+            },
+            {
+                name: 'get_imports',
+                description: 'Get all imports for a specific file',
+                inputSchema: {
+                    type: 'object',
+                    required: ['path'],
+                    properties: {
+                        path: {
+                            type: 'string',
+                            description: 'Relative path to the file',
+                        },
+                    },
+                },
+            },
+            {
+                name: 'get_diagram',
+                description: 'Generate a Mermaid architecture diagram',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        nodeTypes: {
+                            type: 'array',
+                            items: { type: 'string' },
+                            description: 'Filter to specific node types (file, module, test, entrypoint)',
+                        },
+                        edgeKinds: {
+                            type: 'array',
+                            items: { type: 'string' },
+                            description: 'Include only specific edge kinds (import, contains, tests, entrypoint)',
+                        },
+                        maxNodes: {
+                            type: 'number',
+                            description: 'Maximum nodes in diagram (default: 250)',
+                        },
+                    },
+                },
+            },
+            {
+                name: 'get_traceability',
+                description: 'Get module-test traceability matrix',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        minConfidence: {
+                            type: 'number',
+                            description: 'Minimum confidence threshold (default: 50)',
+                        },
+                    },
+                },
+            },
+        ],
+    };
+});
+/**
+ * Handle tool calls.
+ */
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        switch (name) {
+            case 'scan':
+                return await handleScan(args);
+            case 'query':
+                return await handleQuery(args);
+            case 'get_imports':
+                return await handleGetImports(args);
+            case 'get_diagram':
+                return await handleGetDiagram(args);
+            case 'get_traceability':
+                return await handleGetTraceability(args);
+            default:
+                return {
+                    content: [{ type: 'text', text: `Unknown tool: ${name}` }],
+                    isError: true,
+                };
+        }
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error: ${error instanceof Error ? error.message : String(error)}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+/**
+ * List available resources.
+ */
+server.setRequestHandler(ListResourcesRequestSchema, async () => {
+    const resources = [];
+    // Check if graph exists
+    const dbPath = join(currentOutDir, 'graph.sqlite');
+    if (existsSync(dbPath)) {
+        resources.push({
+            uri: 'repo-mapper://graph.json',
+            name: 'Knowledge Graph',
+            description: 'The full knowledge graph as canonical JSON',
+            mimeType: 'application/json',
+        }, {
+            uri: 'repo-mapper://repo_profile.json',
+            name: 'Repository Profile',
+            description: 'Repository scan summary',
+            mimeType: 'application/json',
+        }, {
+            uri: 'repo-mapper://architecture.mmd',
+            name: 'Architecture Diagram',
+            description: 'Mermaid diagram of the codebase architecture',
+            mimeType: 'text/plain',
+        });
+    }
+    return { resources };
+});
+/**
+ * Read resources.
+ */
+server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+    const { uri } = request.params;
+    if (uri === 'repo-mapper://graph.json') {
+        const graphPath = join(currentOutDir, 'graph.json');
+        if (!existsSync(graphPath)) {
+            throw new Error('Graph not found. Run scan first.');
+        }
+        const content = readFileSync(graphPath, 'utf8');
+        return {
+            contents: [
+                {
+                    uri,
+                    mimeType: 'application/json',
+                    text: chunkContent(content),
+                },
+            ],
+        };
+    }
+    if (uri === 'repo-mapper://repo_profile.json') {
+        const profilePath = join(currentOutDir, 'repo_profile.json');
+        if (!existsSync(profilePath)) {
+            throw new Error('Profile not found. Run scan first.');
+        }
+        const content = readFileSync(profilePath, 'utf8');
+        return {
+            contents: [
+                {
+                    uri,
+                    mimeType: 'application/json',
+                    text: content,
+                },
+            ],
+        };
+    }
+    if (uri === 'repo-mapper://architecture.mmd') {
+        const dbPath = join(currentOutDir, 'graph.sqlite');
+        if (!existsSync(dbPath)) {
+            throw new Error('Graph not found. Run scan first.');
+        }
+        const db = new Database(dbPath, { readonly: true });
+        try {
+            const result = generateMermaidDiagram(db);
+            return {
+                contents: [
+                    {
+                        uri,
+                        mimeType: 'text/plain',
+                        text: result.mermaid,
+                    },
+                ],
+            };
+        }
+        finally {
+            db.close();
+        }
+    }
+    throw new Error(`Unknown resource: ${uri}`);
+});
+// Tool handlers
+async function handleScan(args) {
+    currentRootDir = args.rootDir ? resolve(args.rootDir) : process.cwd();
+    currentOutDir = args.outDir ? resolve(args.outDir) : join(currentRootDir, 'out');
+    const toolchain = collectToolchain(currentRootDir);
+    const config = createDefaultConfig(currentRootDir);
+    const scanResult = scanDirectory(currentRootDir, toolchain, {
+        maxFiles: config.limits?.maxFiles,
+        testPatterns: config.indexing?.tests?.patterns,
+    });
+    // Index files
+    const filesByLanguage = new Map();
+    for (const file of scanResult.fileEntries ?? []) {
+        if (!filesByLanguage.has(file.language)) {
+            filesByLanguage.set(file.language, []);
+        }
+        filesByLanguage.get(file.language).push(file.path);
+    }
+    const indexResult = indexAll({
+        rootDir: currentRootDir,
+        files: filesByLanguage,
+    });
+    // Build graph
+    const dbPath = join(currentOutDir, 'graph.sqlite');
+    const db = initGraphDatabase(dbPath);
+    for (const node of indexResult.nodes) {
+        insertNode(db, node);
+    }
+    for (const edge of indexResult.edges) {
+        insertEdge(db, edge);
+    }
+    const graphExport = await exportGraph(db);
+    db.close();
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({
+                    success: true,
+                    files: scanResult.files.total,
+                    nodes: graphExport.meta.nodeCount,
+                    edges: graphExport.meta.edgeCount,
+                    languages: scanResult.languages.map((l) => `${l.id}(${l.fileCount})`),
+                }, null, 2),
+            },
+        ],
+    };
+}
+async function handleQuery(args) {
+    const dbPath = join(currentOutDir, 'graph.sqlite');
+    if (!existsSync(dbPath)) {
+        throw new Error('Graph not found. Run scan first.');
+    }
+    const db = new Database(dbPath, { readonly: true });
+    try {
+        // Only allow SELECT queries for safety
+        const query = args.query.trim();
+        if (!query.toLowerCase().startsWith('select')) {
+            throw new Error('Only SELECT queries are allowed');
+        }
+        const results = db.prepare(query).all();
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(results, null, 2),
+                },
+            ],
+        };
+    }
+    finally {
+        db.close();
+    }
+}
+async function handleGetImports(args) {
+    const dbPath = join(currentOutDir, 'graph.sqlite');
+    if (!existsSync(dbPath)) {
+        throw new Error('Graph not found. Run scan first.');
+    }
+    const db = new Database(dbPath, { readonly: true });
+    try {
+        const results = db
+            .prepare(`
+      SELECT 
+        n2.path as imports,
+        e.proof_type,
+        e.proof_line
+      FROM edges e
+      JOIN nodes n1 ON e.source = n1.id
+      JOIN nodes n2 ON e.target = n2.id
+      WHERE n1.path = ? AND e.kind = 'import'
+      ORDER BY n2.path
+    `)
+            .all(args.path);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(results, null, 2),
+                },
+            ],
+        };
+    }
+    finally {
+        db.close();
+    }
+}
+async function handleGetDiagram(args) {
+    const dbPath = join(currentOutDir, 'graph.sqlite');
+    if (!existsSync(dbPath)) {
+        throw new Error('Graph not found. Run scan first.');
+    }
+    const db = new Database(dbPath, { readonly: true });
+    try {
+        const result = generateMermaidDiagram(db, {
+            nodeTypes: args.nodeTypes,
+            edgeKinds: args.edgeKinds,
+            maxNodes: args.maxNodes,
+        });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: result.mermaid,
+                },
+            ],
+        };
+    }
+    finally {
+        db.close();
+    }
+}
+async function handleGetTraceability(args) {
+    const dbPath = join(currentOutDir, 'graph.sqlite');
+    if (!existsSync(dbPath)) {
+        throw new Error('Graph not found. Run scan first.');
+    }
+    const db = new Database(dbPath, { readonly: true });
+    try {
+        const matrix = buildTraceabilityMatrix(db, {
+            minConfidence: args.minConfidence,
+        });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(matrix, null, 2),
+                },
+            ],
+        };
+    }
+    finally {
+        db.close();
+    }
+}
+/**
+ * Chunk large content per D2 (64KB chunks).
+ */
+function chunkContent(content) {
+    if (content.length <= MCP_CHUNK_SIZE_BYTES) {
+        return content;
+    }
+    // For now, return truncated with note
+    return (content.slice(0, MCP_CHUNK_SIZE_BYTES) +
+        '\n\n[Content truncated. Use query tool for specific data.]');
+}
+/**
+ * Start the MCP server.
+ */
+export async function startMcpServer() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('odd-repo-mapper MCP server started');
+}
+// Export for direct use
+export { server };
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/package.json

@@ -0,0 +1,86 @@
+{
+    "name": "@oddessentials/odd-repo-mapper",
+    "version": "1.0.0",
+    "description": "Deterministic code intelligence tool producing evidence-backed architecture diagrams and feature-test traceability matrices",
+    "type": "module",
+    "engines": {
+        "node": ">=22.0.0"
+    },
+    "bin": {
+        "repo-mapper": "./dist/cli/index.js"
+    },
+    "scripts": {
+        "build": "tsc",
+        "dev": "tsc --watch",
+        "test": "vitest run",
+        "test:watch": "vitest",
+        "test:coverage": "vitest run --coverage",
+        "test:golden": "vitest run --project golden",
+        "lint": "eslint src",
+        "lint:fix": "eslint src --fix",
+        "format": "prettier --write .",
+        "format:check": "prettier --check .",
+        "typecheck": "tsc --noEmit",
+        "clean": "rimraf dist out",
+        "prepare": "husky",
+        "ci": "npm run lint && npm run format:check && npm run typecheck && npm run test -- --passWithNoTests && npm run build",
+        "release:dry-run": "semantic-release --dry-run"
+    },
+    "dependencies": {
+        "@modelcontextprotocol/sdk": "^1.25.1",
+        "ajv": "^8.17.1",
+        "better-sqlite3": "^11.7.0",
+        "commander": "^12.1.0",
+        "json-canonicalize": "^1.0.6",
+        "ts-morph": "^27.0.2"
+    },
+    "devDependencies": {
+        "@commitlint/cli": "^20.2.0",
+        "@commitlint/config-conventional": "^20.2.0",
+        "@eslint/js": "^9.39.2",
+        "@semantic-release/changelog": "^6.0.3",
+        "@semantic-release/git": "^10.0.1",
+        "@semantic-release/github": "^12.0.2",
+        "@semantic-release/npm": "^13.1.3",
+        "@types/better-sqlite3": "^7.6.12",
+        "@types/node": "^22.10.2",
+        "@vitest/coverage-v8": "^2.1.9",
+        "eslint": "^9.17.0",
+        "husky": "^9.1.7",
+        "lint-staged": "^16.2.7",
+        "prettier": "^3.7.4",
+        "rimraf": "^6.0.1",
+        "semantic-release": "^25.0.2",
+        "typescript": "^5.7.2",
+        "typescript-eslint": "^8.51.0",
+        "vitest": "^2.1.8"
+    },
+    "files": [
+        "dist",
+        "schemas"
+    ],
+    "keywords": [
+        "code-intelligence",
+        "architecture",
+        "traceability",
+        "mermaid",
+        "evidence"
+    ],
+    "license": "MIT",
+    "publishConfig": {
+        "access": "public"
+    },
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/oddessentials/odd-repo-mapper.git"
+    },
+    "lint-staged": {
+        "*.{ts,js}": [
+            "eslint --fix",
+            "prettier --write"
+        ],
+        "*.{json,md}": [
+            "prettier --write"
+        ]
+    }
+}

package/schemas/config.schema.json

@@ -0,0 +1,140 @@
+{
+    "$schema": "https://json-schema.org/draft-07/schema",
+    "$id": "https://oddessentials.dev/schemas/repo-mapper/config.schema.json",
+    "title": "Repo Mapper Config (v0.1)",
+    "type": "object",
+    "additionalProperties": false,
+    "required": ["version", "project", "output", "determinism"],
+    "properties": {
+        "version": {
+            "type": "string",
+            "const": "0.1.0"
+        },
+        "project": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["rootDir"],
+            "properties": {
+                "rootDir": {
+                    "type": "string"
+                },
+                "name": {
+                    "type": "string"
+                },
+                "repoId": {
+                    "type": "string"
+                }
+            }
+        },
+        "indexing": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+                "languages": {
+                    "type": "object",
+                    "properties": {
+                        "tier1": {
+                            "type": "array",
+                            "items": {
+                                "enum": ["typescript", "javascript", "python", "go", "rust"]
+                            },
+                            "default": ["typescript", "javascript", "python", "go", "rust"]
+                        },
+                        "tier2": {
+                            "type": "array",
+                            "items": {
+                                "enum": ["java", "kotlin", "csharp", "ruby", "php"]
+                            },
+                            "default": ["java", "kotlin", "csharp", "ruby", "php"]
+                        }
+                    }
+                },
+                "tests": {
+                    "type": "object",
+                    "properties": {
+                        "patterns": {
+                            "type": "array",
+                            "items": {
+                                "type": "string"
+                            },
+                            "default": [
+                                "**/*test*.*",
+                                "**/*spec*.*",
+                                "**/test/**",
+                                "**/tests/**",
+                                "**/__tests__/**"
+                            ]
+                        },
+                        "linking": {
+                            "type": "object",
+                            "properties": {
+                                "minConfidence": {
+                                    "type": "integer",
+                                    "minimum": 0,
+                                    "maximum": 100,
+                                    "default": 50
+                                },
+                                "allowBelowThreshold": {
+                                    "type": "boolean",
+                                    "default": false
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        },
+        "output": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["outDir"],
+            "properties": {
+                "outDir": {
+                    "type": "string",
+                    "default": "./out"
+                },
+                "writeIntermediateArtifacts": {
+                    "type": "boolean",
+                    "default": true
+                }
+            }
+        },
+        "determinism": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+                "sortOrder": {
+                    "type": "string",
+                    "enum": ["path_then_name", "name_then_path"],
+                    "default": "path_then_name"
+                },
+                "stableIdMode": {
+                    "type": "string",
+                    "enum": ["path_hash", "content_hash"],
+                    "default": "path_hash"
+                }
+            }
+        },
+        "limits": {
+            "type": "object",
+            "properties": {
+                "maxFiles": {
+                    "type": "integer",
+                    "default": 50000
+                },
+                "maxEdges": {
+                    "type": "integer",
+                    "default": 500000
+                },
+                "maxSymbols": {
+                    "type": "integer",
+                    "default": 1000000
+                },
+                "maxNodesPerDiagram": {
+                    "type": "integer",
+                    "default": 250
+                }
+            }
+        }
+    }
+}