Greptile Summary

This PR implements Phase 2.5 of the roadmap, adding multi-repo support to the MCP server via a global registry at ~/.codegraph/registry.json.

Key Changes

• New src/registry.js module with atomic-write CRUD operations (load, save, register, unregister, list, resolve)
• Optional repo parameter added to all 11 existing MCP tools to target registered repositories
• New list_repos MCP tool (12th tool) to enumerate registered repositories
• CLI commands codegraph registry list|add|remove for manual registry management
• Auto-registration after codegraph build (non-fatal on failure)
• Programmatic API exports all registry functions from src/index.js
• Comprehensive test coverage with 26 new tests (18 registry unit, 4 MCP unit, 4 CLI integration)

Implementation Quality

The implementation follows established patterns in the codebase:

• Atomic writes using temp file + rename to prevent corruption
• Graceful error handling with appropriate fallbacks
• Backward compatibility (omitting repo param uses local DB)
• Proper isolation in tests (temp directories, mocked HOME)
• Consistent with CLAUDE.md architecture documentation

All tests reported passing in the PR description (322 total). The code is clean, well-structured, and ready for production use.

Confidence Score: 5/5

• This PR is safe to merge with minimal risk
• Score reflects thorough implementation with comprehensive test coverage (26 new tests), atomic file operations, graceful error handling, backward compatibility, and alignment with project architecture. No logic errors, security issues, or breaking changes identified.
• No files require special attention

Important Files Changed

Sequence Diagram

sequenceDiagram
    participant AI as AI Agent
    participant MCP as MCP Server
    participant REG as Registry Module
    participant FS as File System
    participant DB as SQLite DBs

    Note over AI,DB: Multi-Repo Query Flow

    AI->>MCP: list_repos()
    MCP->>REG: listRepos()
    REG->>FS: Read ~/.codegraph/registry.json
    FS-->>REG: Registry data
    REG-->>MCP: List of repos
    MCP-->>AI: Available repositories

    AI->>MCP: query_function(name, repo="my-project")
    MCP->>REG: resolveRepoDbPath("my-project")
    REG->>FS: Check registry.json
    REG->>FS: Verify DB exists
    alt DB found
        FS-->>REG: DB path
        REG-->>MCP: Resolved path
        MCP->>DB: Query my-project DB
        DB-->>MCP: Results
        MCP-->>AI: Function data
    else DB not found
        REG-->>MCP: undefined
        MCP-->>AI: Error: repo not found
    end

    Note over AI,DB: Auto-Registration on Build

    participant CLI as CLI
    participant BLD as Builder

    CLI->>BLD: codegraph build
    BLD->>FS: Build graph.db
    BLD->>REG: registerRepo(rootDir)
    REG->>FS: Atomic write to registry.json
    REG-->>BLD: Registration complete
    BLD-->>CLI: Build complete

_{Last reviewed commit: 54ea9f6}