git-memory 0.1.0

package/dist/indexer.js

@@ -0,0 +1,242 @@
+import { simpleGit } from 'simple-git';
+import { basename } from 'path';
+import { ChromaCommitIndex } from './chroma-index.js';
+import { ContextStore } from './context-store.js';
+import { createEmbeddingFunction } from './embeddings.js';
+import { isRelevant, buildMetadata, summarizeCommit, buildStatsStr } from './filters.js';
+import { configFromEnv } from './types.js';
+export class GitMemoryIndexer {
+    git;
+    repoName;
+    chromaIndex;
+    contextStore;
+    userId;
+    constructor(git, repoName, chromaIndex, contextStore, userId) {
+        this.git = git;
+        this.repoName = repoName;
+        this.chromaIndex = chromaIndex;
+        this.contextStore = contextStore;
+        this.userId = userId;
+    }
+    /** Async factory — initialises git, ChromaDB (Layer 1), and ContextStore (Layer 2). */
+    static async create(config) {
+        const git = simpleGit(config.repoPath);
+        let repoName;
+        try {
+            const root = await git.revparse(['--show-toplevel']);
+            repoName = basename(root.trim());
+        }
+        catch {
+            repoName = basename(config.repoPath);
+        }
+        const embedFn = await createEmbeddingFunction(config.embedProvider, config.embedModel, config.ollamaUrl, config.openaiApiKey);
+        const chromaIndex = await ChromaCommitIndex.create(config.chromaDir, embedFn);
+        const contextStore = await ContextStore.create(config, embedFn);
+        return new GitMemoryIndexer(git, repoName, chromaIndex, contextStore, config.userId);
+    }
+    /** Convenience factory using environment variables. */
+    static async fromEnv() {
+        return GitMemoryIndexer.create(configFromEnv());
+    }
+    /**
+     * Index a single commit by hash.
+     * Matches Python index_commit() exactly:
+     *   1. Get commit details
+     *   2. isRelevant() check — skip if false (unless force)
+     *   3. Build metadata + document
+     *   4. Layer 1: chromaIndex.upsertCommit() — returns false if duplicate
+     *   5. If Layer 1 returned false and !force → return false
+     *   6. Layer 2: contextStore.addCommit() — no-throw
+     *   7. Return true
+     */
+    async indexCommit(hash, force = false) {
+        let details;
+        try {
+            details = await this.getCommitDetails(hash);
+        }
+        catch (e) {
+            process.stderr.write(`indexCommit: failed to get details for ${hash.slice(0, 8)}: ${e}\n`);
+            return false;
+        }
+        if (!isRelevant(details.message) && !force)
+            return false;
+        const meta = buildMetadata({
+            hash: details.hash,
+            authorName: details.authorName,
+            authorEmail: details.authorEmail,
+            date: details.date,
+            message: details.message,
+            files: details.files,
+            repoName: this.repoName,
+        });
+        const statsStr = buildStatsStr(details.insertions, details.deletions);
+        let inserted;
+        try {
+            inserted = await this.chromaIndex.upsertCommit({
+                commitHash: details.hash,
+                authorName: meta.author_name,
+                authorEmail: meta.author_email,
+                committedDate: meta.committed_date,
+                message: details.message,
+                category: meta.category,
+                files: meta.files_changed,
+                statsStr,
+                repo: this.repoName,
+            });
+        }
+        catch (e) {
+            process.stderr.write(`Chroma insert failed ${details.hash.slice(0, 8)}: ${e}\n`);
+            inserted = false;
+        }
+        if (!inserted && !force)
+            return false;
+        // Layer 2 — fire-and-forget, no-throw
+        const summary = summarizeCommit({
+            hash: details.hash,
+            authorName: details.authorName,
+            authorEmail: details.authorEmail,
+            date: details.date,
+            message: details.message,
+            insertions: details.insertions,
+            deletions: details.deletions,
+            fileCount: details.fileCount,
+            files: details.files,
+        });
+        this.contextStore.addCommit({
+            hash: details.hash,
+            summary,
+            metadata: meta,
+            userId: this.userId,
+        }).catch((e) => {
+            process.stderr.write(`Mem0-equiv failed for ${details.hash.slice(0, 8)} (Chroma OK): ${e}\n`);
+        });
+        return true;
+    }
+    /**
+     * Index all commits on a branch.
+     * Matches Python index_all() exactly:
+     *   - Iterates commits, skips irrelevant, logs progress every 100
+     *   - Returns IndexStats
+     */
+    async indexAll(params = {}) {
+        const branch = params.branch ?? 'HEAD';
+        const stats = {
+            total_evaluated: 0,
+            stored: 0,
+            skipped_irrelevant: 0,
+            skipped_duplicate: 0,
+            errors: 0,
+        };
+        const logOptions = {
+            format: { hash: '%H', message: '%s' },
+        };
+        if (params.limit)
+            logOptions.maxCount = params.limit;
+        if (branch !== 'HEAD')
+            logOptions.from = branch;
+        let commits;
+        try {
+            const log = await this.git.log(logOptions);
+            commits = log.all;
+        }
+        catch (e) {
+            process.stderr.write(`indexAll: git log failed: ${e}\n`);
+            return stats;
+        }
+        process.stderr.write(`Found ${commits.length} commits to evaluate\n`);
+        stats.total_evaluated = commits.length;
+        for (let i = 0; i < commits.length; i++) {
+            if ((i + 1) % 100 === 0) {
+                process.stderr.write(`Progress: ${i + 1} / ${commits.length}\n`);
+            }
+            const { hash, message } = commits[i];
+            if (!isRelevant(message)) {
+                stats.skipped_irrelevant++;
+                continue;
+            }
+            if (params.dryRun) {
+                process.stderr.write(`[DRY-RUN] ${hash.slice(0, 8)}  ${message.slice(0, 72)}\n`);
+                stats.stored++;
+                continue;
+            }
+            try {
+                const stored = await this.indexCommit(hash);
+                if (stored) {
+                    stats.stored++;
+                }
+                else {
+                    stats.skipped_duplicate++;
+                }
+            }
+            catch (e) {
+                process.stderr.write(`Error ${hash.slice(0, 8)}: ${e}\n`);
+                stats.errors++;
+            }
+        }
+        process.stderr.write(`Done. ${JSON.stringify(stats)}\n`);
+        return stats;
+    }
+    /**
+     * Get full commit details via git show + diff-tree.
+     * Uses git show for author/date/message, diff-tree for exact file list.
+     */
+    async getCommitDetails(hash) {
+        // Get author, date, message
+        const showRaw = await this.git.raw([
+            'show',
+            '--no-patch',
+            '--format=%H%n%an%n%ae%n%aI%n%s',
+            hash,
+        ]);
+        const lines = showRaw.trim().split('\n');
+        const authorName = lines[1]?.trim() ?? 'Unknown';
+        const authorEmail = lines[2]?.trim() ?? '';
+        const dateStr = lines[3]?.trim() ?? new Date().toISOString();
+        const message = lines[4]?.trim() ?? '';
+        // Get file list
+        let files = [];
+        try {
+            const filesRaw = await this.git.raw([
+                'diff-tree', '--no-commit-id', '-r', '--name-only', hash,
+            ]);
+            files = filesRaw.trim().split('\n').filter(Boolean);
+        }
+        catch { /* root commit or shallow clone — leave empty */ }
+        // Get stat numbers
+        let insertions = 0;
+        let deletions = 0;
+        let fileCount = files.length;
+        try {
+            const statRaw = await this.git.raw([
+                'show', '--stat', '--format=', hash,
+            ]);
+            // Last line: "N files changed, N insertions(+), N deletions(-)"
+            const statLines = statRaw.trim().split('\n');
+            const summaryLine = statLines[statLines.length - 1] ?? '';
+            const insMatch = summaryLine.match(/(\d+) insertion/);
+            const delMatch = summaryLine.match(/(\d+) deletion/);
+            const fileMatch = summaryLine.match(/(\d+) file/);
+            if (insMatch)
+                insertions = parseInt(insMatch[1], 10);
+            if (delMatch)
+                deletions = parseInt(delMatch[1], 10);
+            if (fileMatch)
+                fileCount = parseInt(fileMatch[1], 10);
+        }
+        catch { /* leave zeros */ }
+        return {
+            hash,
+            authorName,
+            authorEmail,
+            date: new Date(dateStr),
+            message,
+            files,
+            insertions,
+            deletions,
+            fileCount,
+        };
+    }
+    get name() { return this.repoName; }
+    get chroma() { return this.chromaIndex; }
+}
+//# sourceMappingURL=indexer.js.map

package/dist/indexer.js.map

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

package/dist/mcp-server.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * git-memory MCP server
+ * Exposes 5 tools to Claude Code via stdio transport.
+ * All logging goes to stderr — stdout is reserved for JSON-RPC protocol.
+ */
+export {};
+//# sourceMappingURL=mcp-server.d.ts.map

package/dist/mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":";AACA;;;;GAIG"}

package/dist/mcp-server.js

@@ -0,0 +1,373 @@
+#!/usr/bin/env node
+/**
+ * git-memory MCP server
+ * Exposes 5 tools to Claude Code via stdio transport.
+ * All logging goes to stderr — stdout is reserved for JSON-RPC protocol.
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { basename } from 'path';
+import { simpleGit } from 'simple-git';
+import { ChromaCommitIndex } from './chroma-index.js';
+import { ContextStore } from './context-store.js';
+import { createEmbeddingFunction } from './embeddings.js';
+import { configFromEnv } from './types.js';
+// ── Logging (stderr only — stdout is the MCP channel) ────────────────────────
+function log(...args) {
+    process.stderr.write(args.map(String).join(' ') + '\n');
+}
+// ── Lazy-initialised singletons ───────────────────────────────────────────────
+const config = configFromEnv();
+let _chroma = null;
+let _context = null;
+let _git;
+let _repoName = basename(config.repoPath);
+async function getChroma() {
+    if (!_chroma) {
+        const embedFn = await createEmbeddingFunction(config.embedProvider, config.embedModel, config.ollamaUrl, config.openaiApiKey);
+        _chroma = await ChromaCommitIndex.create(config.chromaDir, embedFn);
+        try {
+            const git = simpleGit(config.repoPath);
+            _repoName = basename((await git.revparse(['--show-toplevel'])).trim());
+        }
+        catch { /* keep basename fallback */ }
+    }
+    return _chroma;
+}
+async function getContext() {
+    if (_context === null) {
+        try {
+            const embedFn = await createEmbeddingFunction(config.embedProvider, config.embedModel, config.ollamaUrl, config.openaiApiKey);
+            _context = await ContextStore.create(config, embedFn);
+        }
+        catch (e) {
+            log('ContextStore init failed (Layer 2 disabled):', e);
+        }
+    }
+    return _context;
+}
+function getGit() {
+    if (!_git)
+        _git = simpleGit(config.repoPath);
+    return _git;
+}
+// ── Shared helpers ────────────────────────────────────────────────────────────
+/** Deduplicate by commit_hash, keep highest relevance_score. Matches Python _dedupe(). */
+function dedup(records) {
+    const seen = new Map();
+    for (const r of records) {
+        const h = r.commit_hash ?? 'unknown';
+        const existing = seen.get(h);
+        if (!existing || (r.relevance_score ?? 0) > (existing.relevance_score ?? 0)) {
+            seen.set(h, r);
+        }
+    }
+    return [...seen.values()];
+}
+/**
+ * Merge ChromaDB facts with ContextStore learned context.
+ * Matches Python _merge_results() exactly.
+ */
+function mergeResults(chromaRecords, contextRecords) {
+    const merged = new Map();
+    for (const r of chromaRecords) {
+        merged.set(r.commit_hash ?? 'unknown', { ...r, learned_context: [] });
+    }
+    for (const r of contextRecords) {
+        const h = r.commit_hash ?? 'unknown';
+        const contextText = r.summary ?? '';
+        const existing = merged.get(h);
+        if (existing) {
+            existing.learned_context = existing.learned_context ?? [];
+            existing.learned_context.push(contextText);
+        }
+        else {
+            merged.set(h, { ...r, learned_context: [contextText], source: 'context_only' });
+        }
+    }
+    const results = [...merged.values()];
+    results.sort((a, b) => (b.relevance_score ?? 0) - (a.relevance_score ?? 0));
+    return results;
+}
+/** commitRow helper for commits_touching_file — matches Python _commit_row(). */
+function commitRow(c) {
+    return {
+        commit_hash: c.hash,
+        short_hash: c.hash.slice(0, 8),
+        author: c.author_name,
+        date: c.date,
+        category: 'general',
+        files_changed: [],
+        summary: c.message.trim(),
+        relevance_score: 0,
+    };
+}
+function ok(data) {
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+}
+// ── Tool schemas ──────────────────────────────────────────────────────────────
+const tools = [
+    {
+        name: 'search_git_history',
+        description: 'Semantically search the indexed Git history for commits related to a topic.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: { type: 'string', description: 'Natural-language description of what you are looking for' },
+                limit: { type: 'number', description: 'Max results (default 10, max 50)', default: 10 },
+                category: { type: 'string', description: 'Optional filter: fix|feat|refactor|arch|perf|security|migration|general' },
+            },
+            required: ['query'],
+        },
+    },
+    {
+        name: 'latest_commits',
+        description: 'Retrieve the most-recently indexed commits from memory.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                limit: { type: 'number', description: 'Number of recent commits (default 10, max 100)', default: 10 },
+            },
+        },
+    },
+    {
+        name: 'commits_touching_file',
+        description: 'Find commits that modified a specific file. Partial path match supported.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                filename: { type: 'string', description: 'File path relative to repo root (partial match supported)' },
+                limit: { type: 'number', description: 'Max results (default 20, max 100)', default: 20 },
+            },
+            required: ['filename'],
+        },
+    },
+    {
+        name: 'bug_fix_history',
+        description: 'Retrieve bug-fix and security commits related to a component or topic.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                component: { type: 'string', description: 'Component name, module path, or topic keyword' },
+                limit: { type: 'number', description: 'Max commits (default 15, max 100)', default: 15 },
+                include_security: { type: 'boolean', description: 'Include security-category commits (default true)', default: true },
+            },
+            required: ['component'],
+        },
+    },
+    {
+        name: 'architecture_decisions',
+        description: 'Surface architectural decision commits — refactors, migrations, design changes.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                topic: { type: 'string', description: 'Optional topic to narrow the search', default: '' },
+                limit: { type: 'number', description: 'Max commits (default 10, max 50)', default: 10 },
+            },
+        },
+    },
+];
+// ── MCP Server ────────────────────────────────────────────────────────────────
+const server = new Server({ name: 'git-memory', version: '0.1.0' }, { capabilities: { tools: {} } });
+server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools }));
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args = {} } = request.params;
+    switch (name) {
+        // ── Tool 1: search_git_history ────────────────────────────────────────────
+        case 'search_git_history': {
+            const { query, limit: rawLimit = 10, category } = args;
+            const limit = Math.min(Math.max(1, rawLimit), 50);
+            const chroma = await getChroma();
+            const chromaResults = await chroma.search({ query, nResults: limit, category, repo: _repoName });
+            let contextResults = [];
+            const ctx = await getContext();
+            if (ctx) {
+                try {
+                    contextResults = dedup(await ctx.search({ query, userId: config.userId, limit }));
+                }
+                catch (e) {
+                    log('ContextStore search failed:', e);
+                }
+            }
+            let results = mergeResults(chromaResults, contextResults);
+            if (category)
+                results = results.filter(r => r.category === category);
+            if (results.length === 0) {
+                return ok([{ message: `No commits found matching '${query}'` }]);
+            }
+            return ok(results.slice(0, limit));
+        }
+        // ── Tool 2: latest_commits ────────────────────────────────────────────────
+        case 'latest_commits': {
+            const { limit: rawLimit = 10 } = args;
+            const limit = Math.min(Math.max(1, rawLimit), 100);
+            const chroma = await getChroma();
+            const records = await chroma.getLatest({ n: limit, repo: _repoName });
+            const contextMap = new Map();
+            const ctx = await getContext();
+            if (ctx) {
+                try {
+                    for (const r of dedup(await ctx.getAll(config.userId))) {
+                        if (r.commit_hash) {
+                            const arr = contextMap.get(r.commit_hash) ?? [];
+                            arr.push(r.summary ?? '');
+                            contextMap.set(r.commit_hash, arr);
+                        }
+                    }
+                }
+                catch { /* ignore */ }
+            }
+            for (const r of records) {
+                r.learned_context = contextMap.get(r.commit_hash) ?? [];
+            }
+            return ok(records);
+        }
+        // ── Tool 3: commits_touching_file ─────────────────────────────────────────
+        case 'commits_touching_file': {
+            const { filename, limit: rawLimit = 20 } = args;
+            const limit = Math.min(Math.max(1, rawLimit), 100);
+            const git = getGit();
+            let gitCommits = [];
+            // 1. Exact path match (fast)
+            try {
+                const log = await git.log({ file: filename, maxCount: limit * 3 });
+                gitCommits = log.all.map(commitRow);
+            }
+            catch { /* ignore */ }
+            // 2. Fallback: basename scan across 500 recent commits
+            if (gitCommits.length === 0) {
+                const needle = filename.toLowerCase();
+                try {
+                    const allLog = await git.log({ maxCount: 500 });
+                    for (const c of allLog.all) {
+                        const filesRaw = await git.raw(['diff-tree', '--no-commit-id', '-r', '--name-only', c.hash]);
+                        if (filesRaw.toLowerCase().includes(needle)) {
+                            gitCommits.push(commitRow(c));
+                            if (gitCommits.length >= limit * 3)
+                                break;
+                        }
+                    }
+                }
+                catch (e) {
+                    return ok([{ error: String(e) }]);
+                }
+            }
+            if (gitCommits.length === 0) {
+                return ok([{ message: `No commits found touching '${filename}'` }]);
+            }
+            // 3. ChromaDB: category enrichment
+            const chroma = await getChroma();
+            const chromaMap = new Map((await chroma.searchByFile({ filename, nResults: limit * 2, repo: _repoName }))
+                .map(r => [r.commit_hash, r]));
+            // 4. ContextStore: learned_context enrichment
+            const contextMap = new Map();
+            const ctx = await getContext();
+            if (ctx) {
+                try {
+                    for (const r of dedup(await ctx.search({ query: `changes to ${filename}`, userId: config.userId, limit: 50 }))) {
+                        if (r.commit_hash) {
+                            const arr = contextMap.get(r.commit_hash) ?? [];
+                            arr.push(r.summary ?? '');
+                            contextMap.set(r.commit_hash, arr);
+                        }
+                    }
+                }
+                catch { /* ignore */ }
+            }
+            // 5. Enrich and return
+            const enriched = gitCommits.slice(0, limit).map(gc => ({
+                ...gc,
+                category: chromaMap.get(gc.commit_hash)?.category ?? 'general',
+                in_chroma_index: chromaMap.has(gc.commit_hash),
+                learned_context: contextMap.get(gc.commit_hash) ?? [],
+            }));
+            return ok(enriched);
+        }
+        // ── Tool 4: bug_fix_history ───────────────────────────────────────────────
+        case 'bug_fix_history': {
+            const { component, limit: rawLimit = 15, include_security = true } = args;
+            const limit = Math.min(Math.max(1, rawLimit), 100);
+            const targetCategories = new Set(['fix', 'bug', 'hotfix', 'patch', 'revert']);
+            if (include_security)
+                targetCategories.add('security');
+            const chroma = await getChroma();
+            const chromaResults = [];
+            for (const cat of targetCategories) {
+                chromaResults.push(...await chroma.search({ query: `${component} ${cat}`, nResults: limit, category: cat, repo: _repoName }));
+            }
+            let contextResults = [];
+            const ctx = await getContext();
+            if (ctx) {
+                try {
+                    for (const q of [`bug fix ${component}`, `security ${component}`]) {
+                        contextResults.push(...await ctx.search({ query: q, userId: config.userId, limit: 20 }));
+                    }
+                }
+                catch (e) {
+                    log('ContextStore bug_fix search failed:', e);
+                }
+            }
+            const merged = mergeResults(chromaResults, dedup(contextResults));
+            let filtered = merged.filter(r => targetCategories.has(r.category));
+            if (filtered.length < 3)
+                filtered = merged;
+            if (filtered.length === 0) {
+                return ok([{ message: `No bug-fix history found for component '${component}'` }]);
+            }
+            return ok(filtered.slice(0, limit));
+        }
+        // ── Tool 5: architecture_decisions ───────────────────────────────────────
+        case 'architecture_decisions': {
+            const { topic = '', limit: rawLimit = 10 } = args;
+            const limit = Math.min(Math.max(1, rawLimit), 50);
+            // Python uses 5 categories: arch, architecture, refactor, migration, redesign
+            const archCategories = new Set(['arch', 'architecture', 'refactor', 'migration', 'redesign']);
+            const query = `architecture design decision ${topic}`.trim();
+            const chroma = await getChroma();
+            // Pass 1: category-filtered
+            const chromaArch = [];
+            for (const cat of archCategories) {
+                chromaArch.push(...await chroma.search({ query, nResults: limit, category: cat, repo: _repoName }));
+            }
+            // Pass 2: broad semantic (catches significant feat commits)
+            const chromaBroad = await chroma.search({ query, nResults: limit, repo: _repoName });
+            const archHashes = new Set(chromaArch.map(r => r.commit_hash));
+            const chromaResults = [
+                ...chromaArch,
+                ...chromaBroad.filter(r => !archHashes.has(r.commit_hash)),
+            ];
+            let contextResults = [];
+            const ctx = await getContext();
+            if (ctx) {
+                try {
+                    contextResults = dedup(await ctx.search({ query, userId: config.userId, limit: limit * 2 }));
+                }
+                catch (e) {
+                    log('ContextStore arch search failed:', e);
+                }
+            }
+            const merged = mergeResults(chromaResults, contextResults);
+            const archFirst = merged.filter(r => archCategories.has(r.category));
+            const others = merged.filter(r => !archCategories.has(r.category));
+            const combined = [...archFirst, ...others].slice(0, limit);
+            if (combined.length === 0) {
+                return ok([{ message: 'No architectural commits found' }]);
+            }
+            return ok(combined);
+        }
+        default:
+            return ok([{ error: `Unknown tool: ${name}` }]);
+    }
+});
+// ── Entry point ───────────────────────────────────────────────────────────────
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    log(`git-memory MCP server started (repo: ${config.repoPath}, user: ${config.userId})`);
+}
+main().catch(e => {
+    process.stderr.write(`Fatal: ${e}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=mcp-server.js.map