git-memory 0.1.0

package/dist/chroma-index.d.ts

@@ -0,0 +1,63 @@
+import type { CommitCategory, CommitRecord } from './types.js';
+import type { IEmbeddingFunction } from './embeddings.js';
+export declare class ChromaCommitIndex {
+    private col;
+    private constructor();
+    /** Async factory — opens (or creates) the local SQLite vector store. */
+    static create(chromaDir: string, embedFn: IEmbeddingFunction): Promise<ChromaCommitIndex>;
+    /**
+     * Insert a commit if not already indexed. Returns false if duplicate.
+     * Exact port of Python upsert_commit():
+     *   1. Check existence (col.has)
+     *   2. Build document text
+     *   3. col.add() with metadata
+     */
+    upsertCommit(params: {
+        commitHash: string;
+        authorName: string;
+        authorEmail: string;
+        committedDate: string;
+        message: string;
+        category: CommitCategory;
+        files: string[];
+        statsStr: string;
+        repo: string;
+    }): Promise<boolean>;
+    /**
+     * Semantic cosine similarity search.
+     * Clamps nResults to collection count (matches Python behaviour).
+     */
+    search(params: {
+        query: string;
+        nResults?: number;
+        category?: string;
+        repo?: string;
+    }): Promise<CommitRecord[]>;
+    /**
+     * Get N most recent commits sorted by committed_date descending.
+     * Matches Python get_latest():
+     *   - Fetches min(count, max(n*3, 50)) — bounded window
+     *   - Sorts by date in JS
+     *   - Returns first n
+     */
+    getLatest(params: {
+        n?: number;
+        repo?: string;
+    }): Promise<CommitRecord[]>;
+    /**
+     * Find commits that touched a file.
+     * Matches Python search_by_file():
+     *   1. Fetch ALL docs (with optional repo filter)
+     *   2. JS-side string matching: filename in files_str
+     *   3. Sort by date, return first n_results
+     *   4. Fallback: semantic search
+     */
+    searchByFile(params: {
+        filename: string;
+        nResults?: number;
+        repo?: string;
+    }): Promise<CommitRecord[]>;
+    /** Count indexed commits, optionally filtered by repo. */
+    count(repo?: string): Promise<number>;
+}
+//# sourceMappingURL=chroma-index.d.ts.map

package/dist/chroma-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chroma-index.d.ts","sourceRoot":"","sources":["../src/chroma-index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAI1D,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,GAAG,CAAmB;IAE9B,OAAO;IAIP,wEAAwE;WAC3D,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAM/F;;;;;;OAMG;IACG,YAAY,CAAC,MAAM,EAAE;QACzB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,cAAc,CAAC;QACzB,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC,OAAO,CAAC;IA6BpB;;;OAGG;IACG,MAAM,CAAC,MAAM,EAAE;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAmB3B;;;;;;OAMG;IACG,SAAS,CAAC,MAAM,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAc/E;;;;;;;OAOG;IACG,YAAY,CAAC,MAAM,EAAE;QACzB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAuB3B,0DAA0D;IACpD,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAM5C"}

package/dist/chroma-index.js

@@ -0,0 +1,166 @@
+import { join } from 'path';
+import { VectorCollection } from './vector-store.js';
+import { buildDocument } from './filters.js';
+const DB_FILENAME = 'git_commits.db';
+export class ChromaCommitIndex {
+    col;
+    constructor(col) {
+        this.col = col;
+    }
+    /** Async factory — opens (or creates) the local SQLite vector store. */
+    static async create(chromaDir, embedFn) {
+        const dbPath = join(chromaDir, DB_FILENAME);
+        const col = VectorCollection.open(dbPath, 'git_commits', embedFn);
+        return new ChromaCommitIndex(col);
+    }
+    /**
+     * Insert a commit if not already indexed. Returns false if duplicate.
+     * Exact port of Python upsert_commit():
+     *   1. Check existence (col.has)
+     *   2. Build document text
+     *   3. col.add() with metadata
+     */
+    async upsertCommit(params) {
+        if (this.col.has(params.commitHash))
+            return false;
+        const document = buildDocument(params.message, params.authorName, params.authorEmail, params.committedDate.slice(0, 10), params.statsStr, params.files);
+        await this.col.add({
+            id: params.commitHash,
+            document,
+            metadata: {
+                short_hash: params.commitHash.slice(0, 8),
+                author_name: params.authorName,
+                author_email: params.authorEmail,
+                committed_date: params.committedDate,
+                category: params.category,
+                repo: params.repo,
+                files_str: params.files.join('|'),
+                date_str: params.committedDate.slice(0, 10),
+            },
+        });
+        return true;
+    }
+    /**
+     * Semantic cosine similarity search.
+     * Clamps nResults to collection count (matches Python behaviour).
+     */
+    async search(params) {
+        const count = this.col.count();
+        if (count === 0)
+            return [];
+        const nResults = Math.min(params.nResults ?? 10, Math.max(1, count));
+        const where = buildWhere(params.category, params.repo);
+        try {
+            const raw = await this.col.query({
+                queryTexts: [params.query],
+                nResults,
+                ...(where ? { where } : {}),
+            });
+            return formatQueryResults(raw);
+        }
+        catch (e) {
+            process.stderr.write(`VectorStore search error: ${e}\n`);
+            return [];
+        }
+    }
+    /**
+     * Get N most recent commits sorted by committed_date descending.
+     * Matches Python get_latest():
+     *   - Fetches min(count, max(n*3, 50)) — bounded window
+     *   - Sorts by date in JS
+     *   - Returns first n
+     */
+    async getLatest(params) {
+        const n = params.n ?? 10;
+        const count = this.col.count();
+        if (count === 0)
+            return [];
+        const fetchLimit = Math.min(count, Math.max(n * 3, 50));
+        const where = buildWhere(undefined, params.repo);
+        const raw = this.col.get({ limit: fetchLimit, where });
+        const records = formatGetResults(raw);
+        records.sort((a, b) => b.date.localeCompare(a.date));
+        return records.slice(0, n);
+    }
+    /**
+     * Find commits that touched a file.
+     * Matches Python search_by_file():
+     *   1. Fetch ALL docs (with optional repo filter)
+     *   2. JS-side string matching: filename in files_str
+     *   3. Sort by date, return first n_results
+     *   4. Fallback: semantic search
+     */
+    async searchByFile(params) {
+        const nResults = params.nResults ?? 20;
+        const needle = params.filename.toLowerCase();
+        const where = buildWhere(undefined, params.repo);
+        const all = this.col.get({ where });
+        const matched = [];
+        for (let i = 0; i < all.ids.length; i++) {
+            const filesStr = String(all.metadatas[i]?.files_str ?? '');
+            if (filesStr.toLowerCase().includes(needle)) {
+                matched.push(makeGetRecord(all.ids[i], all.documents[i], all.metadatas[i]));
+            }
+        }
+        if (matched.length > 0) {
+            matched.sort((a, b) => b.date.localeCompare(a.date));
+            return matched.slice(0, nResults);
+        }
+        return this.search({ query: `changes to ${params.filename}`, nResults, repo: params.repo });
+    }
+    /** Count indexed commits, optionally filtered by repo. */
+    async count(repo) {
+        if (!repo)
+            return this.col.count();
+        const where = buildWhere(undefined, repo);
+        const result = this.col.get({ where });
+        return result.ids.length;
+    }
+}
+// ── Helpers ───────────────────────────────────────────────────────────────────
+function buildWhere(category, repo) {
+    const conds = [];
+    if (category)
+        conds.push({ category: { $eq: category } });
+    if (repo)
+        conds.push({ repo: { $eq: repo } });
+    if (conds.length === 0)
+        return undefined;
+    if (conds.length === 1)
+        return conds[0];
+    return { $and: conds };
+}
+function formatQueryResults(raw) {
+    const ids = raw.ids?.[0] ?? [];
+    const docs = raw.documents?.[0] ?? [];
+    const metas = raw.metadatas?.[0] ?? [];
+    const dists = raw.distances?.[0] ?? [];
+    return ids.map((hash, i) => ({
+        commit_hash: hash,
+        short_hash: String(metas[i]?.short_hash ?? hash.slice(0, 8)),
+        author: String(metas[i]?.author_name ?? 'unknown'),
+        date: String(metas[i]?.committed_date ?? ''),
+        category: String(metas[i]?.category ?? 'general'),
+        files_changed: String(metas[i]?.files_str ?? '').split('|').filter(Boolean),
+        summary: docs[i] ?? '',
+        relevance_score: Math.round((1.0 - (dists[i] ?? 1.0)) * 10000) / 10000,
+        source: 'chroma',
+    }));
+}
+function formatGetResults(raw) {
+    return raw.ids.map((hash, i) => makeGetRecord(hash, raw.documents[i], raw.metadatas[i]));
+}
+function makeGetRecord(hash, doc, meta) {
+    return {
+        commit_hash: hash,
+        short_hash: String(meta?.short_hash ?? ''),
+        author: String(meta?.author_name ?? ''),
+        date: String(meta?.committed_date ?? ''),
+        category: String(meta?.category ?? 'general'),
+        files_changed: String(meta?.files_str ?? '').split('|').filter(Boolean),
+        summary: doc ?? '',
+        relevance_score: 0,
+        source: 'chroma',
+    };
+}
+//# sourceMappingURL=chroma-index.js.map

package/dist/chroma-index.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,311 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { readFileSync, writeFileSync, existsSync, mkdirSync, cpSync } from 'fs';
+import { resolve, basename, dirname } from 'path';
+import { homedir } from 'os';
+import { execSync } from 'child_process';
+import { simpleGit } from 'simple-git';
+import { GitMemoryIndexer } from './indexer.js';
+import { ChromaCommitIndex } from './chroma-index.js';
+import { createEmbeddingFunction } from './embeddings.js';
+import { configFromEnv } from './types.js';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// ── CLAUDE.md template ────────────────────────────────────────────────────────
+const MARKER_START = '<!-- git-memory:start -->';
+const MARKER_END = '<!-- git-memory:end -->';
+const CLAUDE_MD_BLOCK = `${MARKER_START}
+
+# Git Memory System
+
+This project uses **git-memory** — a semantic index over Git commit history for Claude Code.
+
+## Always Start Here
+
+When beginning any task in this repository:
+
+1. Call \`latest_commits(5)\` to understand what changed recently
+2. Call \`search_git_history(<relevant topic>)\` before touching any module with history
+3. After fixing a bug, call \`bug_fix_history(<component>)\` to check for prior regressions
+
+## Available Skills
+
+| Task | Skill |
+|------|-------|
+| Search commit history for a topic | \`/git-memory-search\` |
+| Index a new repository | \`/git-memory-index\` |
+| Debug why a component behaves a certain way | \`/git-memory-debug\` |
+| Check what's currently indexed | \`/git-memory-status\` |
+
+## MCP Tools Reference
+
+| Tool | What it gives you | When to use |
+|------|-------------------|-------------|
+| \`search_git_history(query, limit, category)\` | Commits semantically related to a topic | Before editing any significant module |
+| \`latest_commits(limit)\` | N most-recent indexed commits | Session start, before investigating regressions |
+| \`commits_touching_file(filename, limit)\` | All commits that modified a file | Before editing a file |
+| \`bug_fix_history(component, include_security)\` | Bug/security fixes for a component | Before adding new code near known bug areas |
+| \`architecture_decisions(topic, limit)\` | Refactors, migrations, design decisions | Understanding why code is structured a certain way |
+
+## Proactive Usage Rules
+
+**Always call before editing:**
+\`\`\`
+commits_touching_file("PaymentService.ts")  # know what's changed here before
+bug_fix_history("auth")                      # avoid re-introducing fixed bugs
+\`\`\`
+
+**Always call at session start:**
+\`\`\`
+latest_commits(10)   # what changed while you were away?
+\`\`\`
+
+## Category Filter Values
+
+Use \`category=\` in \`search_git_history()\` to narrow results:
+
+| Category | Matches |
+|----------|---------|
+| \`fix\`    | Bug fixes, hotfixes, patches |
+| \`feat\`   | New features |
+| \`security\` | Security-related changes |
+| \`refactor\` | Code refactors |
+| \`migration\` | Database/schema migrations |
+| \`arch\`   | Architecture decisions |
+| \`perf\`   | Performance improvements |
+
+${MARKER_END}`;
+// ── Helpers ───────────────────────────────────────────────────────────────────
+function installClaudeMd(repoPath) {
+    const mdPath = resolve(repoPath, 'CLAUDE.md');
+    if (existsSync(mdPath)) {
+        const existing = readFileSync(mdPath, 'utf-8');
+        if (existing.includes(MARKER_START) && existing.includes(MARKER_END)) {
+            // Replace existing block in-place
+            const pattern = new RegExp(escapeRegex(MARKER_START) + '[\\s\\S]*?' + escapeRegex(MARKER_END));
+            const updated = existing.replace(pattern, CLAUDE_MD_BLOCK);
+            writeFileSync(mdPath, updated, 'utf-8');
+            console.log(`✓ Updated git-memory block in ${mdPath}`);
+        }
+        else {
+            // Prepend block to existing file
+            writeFileSync(mdPath, CLAUDE_MD_BLOCK + '\n\n' + existing, 'utf-8');
+            console.log(`✓ Prepended git-memory block to ${mdPath}`);
+        }
+    }
+    else {
+        writeFileSync(mdPath, CLAUDE_MD_BLOCK + '\n', 'utf-8');
+        console.log(`✓ Created ${mdPath}`);
+    }
+}
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/** Locate the bundled skills directory. */
+function findSkillsDir() {
+    // When running from dist/cli.js, skills/ is two levels up (project root)
+    const fromDist = resolve(__dirname, '..', 'skills');
+    if (existsSync(fromDist))
+        return fromDist;
+    // When running via tsx src/cli.ts
+    const fromSrc = resolve(__dirname, '..', 'skills');
+    if (existsSync(fromSrc))
+        return fromSrc;
+    throw new Error('Skills directory not found. Reinstall git-memory.');
+}
+/** Find the git-memory binary path. */
+function findBin() {
+    try {
+        return execSync('which git-memory').toString().trim();
+    }
+    catch {
+        return 'npx git-memory';
+    }
+}
+// ── Commands ──────────────────────────────────────────────────────────────────
+async function indexCmd(opts) {
+    const config = configFromEnv();
+    config.repoPath = resolve(opts.repoPath);
+    if (opts.userId)
+        config.userId = opts.userId;
+    const indexer = await GitMemoryIndexer.create(config);
+    const stats = await indexer.indexAll({
+        branch: opts.branch,
+        limit: opts.limit,
+        dryRun: opts.dryRun,
+    });
+    console.log('\n── Indexing Summary ─────────────────────────────');
+    for (const [k, v] of Object.entries(stats)) {
+        console.log(`  ${k.padEnd(25)} ${v}`);
+    }
+    console.log();
+}
+async function serveCmd() {
+    // Import and run mcp-server.ts — it has its own main()
+    await import('./mcp-server.js');
+}
+async function storeCmd(commitRef, opts) {
+    const { storeCommit } = await import('./store.js');
+    const stored = await storeCommit(commitRef ?? 'HEAD', {
+        repoPath: resolve(opts.repoPath),
+        userId: opts.userId,
+        force: opts.force,
+    });
+    process.exit(stored ? 0 : 1);
+}
+async function statusCmd(opts) {
+    const repoPath = resolve(opts.repoPath);
+    const config = configFromEnv();
+    config.repoPath = repoPath;
+    const embedFn = await createEmbeddingFunction(config.embedProvider, config.embedModel, config.ollamaUrl, config.openaiApiKey);
+    const chroma = await ChromaCommitIndex.create(config.chromaDir, embedFn);
+    const git = simpleGit(repoPath);
+    let totalCommits = '?';
+    let repoName = basename(repoPath);
+    try {
+        const root = await git.revparse(['--show-toplevel']);
+        repoName = basename(root.trim());
+        const log = await git.log();
+        totalCommits = log.total;
+    }
+    catch { /* use fallbacks */ }
+    const count = await chroma.count(repoName);
+    const countAll = await chroma.count();
+    console.log('\n── git-memory status ──────────────────────────');
+    console.log(`  Repo          : ${repoName}`);
+    console.log(`  Chroma docs   : ${count} (this repo) / ${countAll} (all repos)`);
+    console.log(`  Total commits : ${totalCommits}`);
+    if (typeof totalCommits === 'number' && totalCommits > 0) {
+        console.log(`  Coverage      : ${Math.round(count / totalCommits * 100)}%`);
+    }
+    console.log(`  Embed provider: ${config.embedProvider}`);
+    console.log();
+}
+async function installCmd(opts) {
+    const repoPath = resolve(opts.repoPath);
+    // 1. Validate git repo
+    const git = simpleGit(repoPath);
+    let repoRoot;
+    try {
+        repoRoot = (await git.revparse(['--show-toplevel'])).trim();
+    }
+    catch {
+        console.error(`Error: ${repoPath} is not inside a Git repository.`);
+        process.exit(1);
+    }
+    const repoName = basename(repoRoot);
+    const userId = opts.userId ?? repoName;
+    // 2. Install skills
+    if (!opts.mcpOnly) {
+        try {
+            const skillsSrc = findSkillsDir();
+            const skillsDst = resolve(homedir(), '.claude', 'skills');
+            mkdirSync(skillsDst, { recursive: true });
+            const { readdirSync, statSync } = await import('fs');
+            const installed = [];
+            for (const entry of readdirSync(skillsSrc)) {
+                const srcDir = resolve(skillsSrc, entry);
+                if (statSync(srcDir).isDirectory()) {
+                    const dstDir = resolve(skillsDst, entry);
+                    cpSync(srcDir, dstDir, { recursive: true });
+                    installed.push(entry);
+                }
+            }
+            console.log(`\n✓ Installed ${installed.length} skills to ${skillsDst}:`);
+            for (const s of installed)
+                console.log(`    /${s}`);
+        }
+        catch (e) {
+            console.warn(`Warning: Could not install skills: ${e}`);
+        }
+    }
+    // 3. Configure MCP server in .claude.json
+    if (!opts.skillsOnly) {
+        const claudeJsonPath = resolve(repoRoot, '.claude.json');
+        let existing = {};
+        if (existsSync(claudeJsonPath)) {
+            try {
+                existing = JSON.parse(readFileSync(claudeJsonPath, 'utf-8'));
+            }
+            catch { /* start fresh */ }
+        }
+        const mcpServers = (existing.mcpServers ?? {});
+        mcpServers['git-memory'] = {
+            command: 'git-memory',
+            args: ['serve'],
+            env: {
+                GIT_MEMORY_REPO_PATH: repoRoot,
+                GIT_MEMORY_USER_ID: userId,
+            },
+        };
+        existing.mcpServers = mcpServers;
+        writeFileSync(claudeJsonPath, JSON.stringify(existing, null, 2) + '\n', 'utf-8');
+        console.log(`\n── MCP Server Config ──────────────────────────────`);
+        console.log(`✓ Configured MCP server in ${claudeJsonPath}`);
+        console.log(`\n  Repo path : ${repoRoot}`);
+        console.log(`  User ID   : ${userId}`);
+    }
+    // 4. Update CLAUDE.md
+    console.log(`\n── CLAUDE.md ──────────────────────────────────────`);
+    installClaudeMd(repoRoot);
+    // 5. Auto-index (unless --no-index)
+    const shouldIndex = opts.index !== false;
+    if (shouldIndex) {
+        console.log(`\n── Indexing repository ─────────────────────────────`);
+        try {
+            const config = configFromEnv();
+            config.repoPath = repoRoot;
+            config.userId = userId;
+            const indexer = await GitMemoryIndexer.create(config);
+            const stats = await indexer.indexAll({});
+            console.log(`✓ Indexed ${stats.stored} commits ` +
+                `(${stats.skipped_duplicate} duplicates, ${stats.skipped_irrelevant} irrelevant)`);
+        }
+        catch (e) {
+            console.warn(`Warning: Auto-indexing failed: ${e}`);
+            console.warn(`  You can index manually later with: git-memory index`);
+        }
+    }
+    console.log(`\n  Restart Claude Code to pick up the new MCP server.\n`);
+}
+// ── Program definition ────────────────────────────────────────────────────────
+const program = new Command();
+program
+    .name('git-memory')
+    .description('Semantic Git history index for Claude Code')
+    .version('0.1.0');
+program.command('index')
+    .description('Bulk-index a repository commit history into ChromaDB')
+    .option('--repo-path <path>', 'Path to git repository', process.cwd())
+    .option('--user-id <id>', 'Namespace identifier for this repo')
+    .option('--branch <branch>', 'Branch to index', 'HEAD')
+    .option('--limit <n>', 'Max commits to index', (v) => parseInt(v, 10))
+    .option('--dry-run', 'Preview without writing')
+    .action(indexCmd);
+program.command('serve')
+    .description('Start MCP server (stdio)')
+    .action(serveCmd);
+program.command('store [commit-ref]')
+    .description('Store a single commit (for post-commit hook). Defaults to HEAD.')
+    .option('--repo-path <path>', 'Path to git repository', process.cwd())
+    .option('--user-id <id>', 'Namespace identifier')
+    .option('--force', 'Store even if commit message has no signal keywords')
+    .action(storeCmd);
+program.command('status')
+    .description('Show index statistics for a repository')
+    .option('--repo-path <path>', 'Path to git repository', process.cwd())
+    .action(statusCmd);
+program.command('install')
+    .description('Install Claude Code skills + configure MCP server')
+    .option('--repo-path <path>', 'Path to git repository', process.cwd())
+    .option('--user-id <id>', 'Namespace identifier for this repo')
+    .option('--skills-only', 'Only install skill files, skip MCP config')
+    .option('--mcp-only', 'Only configure MCP server, skip skills')
+    .option('--no-index', 'Skip auto-indexing after install')
+    .action(installCmd);
+program.parseAsync(process.argv).catch(e => {
+    console.error(e);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAChF,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAI,OAAO,CAAC,UAAU,CAAC,CAAC;AAEvC,iFAAiF;AACjF,MAAM,YAAY,GAAG,2BAA2B,CAAC;AACjD,MAAM,UAAU,GAAK,yBAAyB,CAAC;AAE/C,MAAM,eAAe,GAAG,GAAG,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4DrC,UAAU,EAAE,CAAC;AAEf,iFAAiF;AAEjF,SAAS,eAAe,CAAC,QAAgB;IACvC,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAE9C,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAE/C,IAAI,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YACrE,kCAAkC;YAClC,MAAM,OAAO,GAAG,IAAI,MAAM,CACxB,WAAW,CAAC,YAAY,CAAC,GAAG,YAAY,GAAG,WAAW,CAAC,UAAU,CAAC,CACnE,CAAC;YACF,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;YAC3D,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YACxC,OAAO,CAAC,GAAG,CAAC,iCAAiC,MAAM,EAAE,CAAC,CAAC;QACzD,CAAC;aAAM,CAAC;YACN,iCAAiC;YACjC,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,GAAG,QAAQ,EAAE,OAAO,CAAC,CAAC;YACpE,OAAO,CAAC,GAAG,CAAC,mCAAmC,MAAM,EAAE,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;SAAM,CAAC;QACN,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;QACvD,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,EAAE,CAAC,CAAC;IACrC,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,GAAW;IAC9B,OAAO,GAAG,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC;AAED,2CAA2C;AAC3C,SAAS,aAAa;IACpB,yEAAyE;IACzE,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IACpD,IAAI,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC1C,kCAAkC;IAClC,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IACnD,IAAI,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IACxC,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;AACvE,CAAC;AAED,uCAAuC;AACvC,SAAS,OAAO;IACd,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,kBAAkB,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,gBAAgB,CAAC;IAC1B,CAAC;AACH,CAAC;AAED,iFAAiF;AAEjF,KAAK,UAAU,QAAQ,CAAC,IAMvB;IACC,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;IAC/B,MAAM,CAAC,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzC,IAAI,IAAI,CAAC,MAAM;QAAE,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAE7C,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC;QACnC,MAAM,EAAG,IAAI,CAAC,MAAM;QACpB,KAAK,EAAI,IAAI,CAAC,KAAK;QACnB,MAAM,EAAG,IAAI,CAAC,MAAM;KACrB,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;IACnE,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,CAAC,GAAG,EAAE,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,QAAQ;IACrB,uDAAuD;IACvD,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAClC,CAAC;AAED,KAAK,UAAU,QAAQ,CACrB,SAAiB,EACjB,IAA4D;IAE5D,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,SAAS,IAAI,MAAM,EAAE;QACpD,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;QAChC,MAAM,EAAI,IAAI,CAAC,MAAM;QACrB,KAAK,EAAK,IAAI,CAAC,KAAK;KACrB,CAAC,CAAC;IACH,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/B,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,IAA0B;IACjD,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;IAC/B,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAE3B,MAAM,OAAO,GAAG,MAAM,uBAAuB,CAC3C,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,YAAY,CAC/E,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAEzE,MAAM,GAAG,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAChC,IAAI,YAAY,GAAoB,GAAG,CAAC;IACxC,IAAI,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC;QACrD,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACjC,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC;QAC5B,YAAY,GAAG,GAAG,CAAC,KAAK,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC,CAAC,mBAAmB,CAAC,CAAC;IAE/B,MAAM,KAAK,GAAM,MAAM,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IAEtC,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;IACjE,OAAO,CAAC,GAAG,CAAC,qBAAqB,QAAQ,EAAE,CAAC,CAAC;IAC7C,OAAO,CAAC,GAAG,CAAC,qBAAqB,KAAK,kBAAkB,QAAQ,cAAc,CAAC,CAAC;IAChF,OAAO,CAAC,GAAG,CAAC,qBAAqB,YAAY,EAAE,CAAC,CAAC;IACjD,IAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;QACzD,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,YAAY,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,qBAAqB,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC;IACzD,OAAO,CAAC,GAAG,EAAE,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,IAMzB;IACC,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAExC,uBAAuB;IACvB,MAAM,GAAG,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAChC,IAAI,QAAgB,CAAC;IACrB,IAAI,CAAC;QACH,QAAQ,GAAG,CAAC,MAAM,GAAG,CAAC,QAAQ,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,KAAK,CAAC,UAAU,QAAQ,kCAAkC,CAAC,CAAC;QACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACpC,MAAM,MAAM,GAAK,IAAI,CAAC,MAAM,IAAI,QAAQ,CAAC;IAEzC,oBAAoB;IACpB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAClB,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,aAAa,EAAE,CAAC;YAClC,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;YAC1D,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAE1C,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;YACrD,MAAM,SAAS,GAAa,EAAE,CAAC;YAC/B,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC3C,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;gBACzC,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;oBACnC,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;oBACzC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;oBAC5C,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACxB,CAAC;YACH,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,iBAAiB,SAAS,CAAC,MAAM,cAAc,SAAS,GAAG,CAAC,CAAC;YACzE,KAAK,MAAM,CAAC,IAAI,SAAS;gBAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACtD,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,sCAAsC,CAAC,EAAE,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,0CAA0C;IAC1C,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QACrB,MAAM,cAAc,GAAG,OAAO,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;QACzD,IAAI,QAAQ,GAA4B,EAAE,CAAC;QAC3C,IAAI,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC;gBACH,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,cAAc,EAAE,OAAO,CAAC,CAA4B,CAAC;YAC1F,CAAC;YAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;QAC/B,CAAC;QAED,MAAM,UAAU,GAAG,CAAC,QAAQ,CAAC,UAAU,IAAI,EAAE,CAA4B,CAAC;QAC1E,UAAU,CAAC,YAAY,CAAC,GAAG;YACzB,OAAO,EAAE,YAAY;YACrB,IAAI,EAAE,CAAC,OAAO,CAAC;YACf,GAAG,EAAE;gBACH,oBAAoB,EAAE,QAAQ;gBAC9B,kBAAkB,EAAI,MAAM;aAC7B;SACF,CAAC;QACF,QAAQ,CAAC,UAAU,GAAG,UAAU,CAAC;QAEjC,aAAa,CAAC,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;QACjF,OAAO,CAAC,GAAG,CAAC,uDAAuD,CAAC,CAAC;QACrE,OAAO,CAAC,GAAG,CAAC,8BAA8B,cAAc,EAAE,CAAC,CAAC;QAC5D,OAAO,CAAC,GAAG,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,iBAAiB,MAAM,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,sBAAsB;IACtB,OAAO,CAAC,GAAG,CAAC,uDAAuD,CAAC,CAAC;IACrE,eAAe,CAAC,QAAQ,CAAC,CAAC;IAE1B,oCAAoC;IACpC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC;IACzC,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,wDAAwD,CAAC,CAAC;QACtE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;YAC/B,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;YAC3B,MAAM,CAAC,MAAM,GAAK,MAAM,CAAC;YACzB,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACtD,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YACzC,OAAO,CAAC,GAAG,CACT,aAAa,KAAK,CAAC,MAAM,WAAW;gBACpC,IAAI,KAAK,CAAC,iBAAiB,gBAAgB,KAAK,CAAC,kBAAkB,cAAc,CAClF,CAAC;QACJ,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,kCAAkC,CAAC,EAAE,CAAC,CAAC;YACpD,OAAO,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,0DAA0D,CAAC,CAAC;AAC1E,CAAC;AAED,iFAAiF;AAEjF,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,YAAY,CAAC;KAClB,WAAW,CAAC,4CAA4C,CAAC;KACzD,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;KACrB,WAAW,CAAC,sDAAsD,CAAC;KACnE,MAAM,CAAC,oBAAoB,EAAE,wBAAwB,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;KACrE,MAAM,CAAC,gBAAgB,EAAE,oCAAoC,CAAC;KAC9D,MAAM,CAAC,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,CAAC;KACtD,MAAM,CAAC,aAAa,EAAE,sBAAsB,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;KAC7E,MAAM,CAAC,WAAW,EAAE,yBAAyB,CAAC;KAC9C,MAAM,CAAC,QAAQ,CAAC,CAAC;AAEpB,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC;KACrB,WAAW,CAAC,0BAA0B,CAAC;KACvC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAEpB,OAAO,CAAC,OAAO,CAAC,oBAAoB,CAAC;KAClC,WAAW,CAAC,iEAAiE,CAAC;KAC9E,MAAM,CAAC,oBAAoB,EAAE,wBAAwB,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;KACrE,MAAM,CAAC,gBAAgB,EAAE,sBAAsB,CAAC;KAChD,MAAM,CAAC,SAAS,EAAE,qDAAqD,CAAC;KACxE,MAAM,CAAC,QAAQ,CAAC,CAAC;AAEpB,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC;KACtB,WAAW,CAAC,wCAAwC,CAAC;KACrD,MAAM,CAAC,oBAAoB,EAAE,wBAAwB,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;KACrE,MAAM,CAAC,SAAS,CAAC,CAAC;AAErB,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC;KACvB,WAAW,CAAC,mDAAmD,CAAC;KAChE,MAAM,CAAC,oBAAoB,EAAE,wBAAwB,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;KACrE,MAAM,CAAC,gBAAgB,EAAE,oCAAoC,CAAC;KAC9D,MAAM,CAAC,eAAe,EAAE,2CAA2C,CAAC;KACpE,MAAM,CAAC,YAAY,EAAE,wCAAwC,CAAC;KAC9D,MAAM,CAAC,YAAY,EAAE,kCAAkC,CAAC;KACxD,MAAM,CAAC,UAAU,CAAC,CAAC;AAEtB,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;IACzC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACjB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/context-store.d.ts

@@ -0,0 +1,54 @@
+import type { CommitRecord, CommitMetadata, GitMemoryConfig } from './types.js';
+import type { IEmbeddingFunction } from './embeddings.js';
+export declare class ContextStore {
+    private col;
+    private llm;
+    private llmModel;
+    private constructor();
+    /**
+     * Async factory — opens (or creates) the local SQLite context store and detects LLM availability.
+     * LLM detection order (matches Python _default_mem0_config() priority):
+     *   1. OPENAI_API_KEY set → use OpenAI gpt-4o-mini
+     *   2. otherwise → attempt Ollama at OLLAMA_URL
+     *   3. Ollama fails → llm = null (graceful degradation)
+     */
+    static create(config: GitMemoryConfig, embedFn: IEmbeddingFunction): Promise<ContextStore>;
+    /**
+     * Extract LLM interpretation and store it.
+     * Mirrors Python: memory.add(messages=[{"role":"user","content":summary}], metadata)
+     *
+     * Flow:
+     *   1. If llm is null → no-op (graceful degradation)
+     *   2. Dedup check — skip if hash already stored
+     *   3. Extract 1–2 sentence interpretation via LLM
+     *   4. Store extracted text + metadata in collection
+     */
+    addCommit(params: {
+        hash: string;
+        summary: string;
+        metadata: CommitMetadata;
+        userId: string;
+    }): Promise<void>;
+    /**
+     * Semantic search on extracted context collection.
+     * Returns CommitRecord[] with the LLM interpretation as the summary field.
+     */
+    search(params: {
+        query: string;
+        userId: string;
+        limit: number;
+    }): Promise<CommitRecord[]>;
+    /**
+     * Get all stored context entries (for latest_commits enrichment map).
+     * Matches Python: mem.get_all(user_id=USER_ID)
+     */
+    getAll(_userId: string): Promise<CommitRecord[]>;
+    /** Whether LLM context extraction is available. */
+    get isActive(): boolean;
+    /**
+     * Call LLM to extract a concise interpretation of a commit.
+     * Prompt matches spirit of mem0's extraction: brief, why-focused.
+     */
+    private extractContext;
+}
+//# sourceMappingURL=context-store.d.ts.map

package/dist/context-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-store.d.ts","sourceRoot":"","sources":["../src/context-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAkB,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAChG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAQ1D,qBAAa,YAAY;IACvB,OAAO,CAAC,GAAG,CAAmB;IAC9B,OAAO,CAAC,GAAG,CAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAS;IAEzB,OAAO;IAMP;;;;;;OAMG;WACU,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;IA8BhG;;;;;;;;;OASG;IACG,SAAS,CAAC,MAAM,EAAE;QACtB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,cAAc,CAAC;QACzB,MAAM,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BjB;;;OAGG;IACG,MAAM,CAAC,MAAM,EAAE;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAiB3B;;;OAGG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAStD,mDAAmD;IACnD,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAID;;;OAGG;YACW,cAAc;CA6B7B"}