codesift-mcp 0.1.0 → 0.2.1

package/dist/tools/conversation-tools.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Conversation indexing tool.
+ *
+ * Scans a directory for JSONL session files, extracts conversation turn symbols,
+ * and registers them into the CodeSift index so they are searchable via BM25.
+ */
+import { type BM25Index } from "../search/bm25.js";
+/** Get the cached BM25 index for a conversation repo (used by search tools). */
+export declare function getConversationBM25Index(repoName: string): BM25Index | null;
+export interface IndexConversationsResult {
+    /** Number of JSONL session files found and processed. */
+    sessions_found: number;
+    /** Total conversation_turn symbols indexed across all sessions. */
+    turns_indexed: number;
+    /** Number of noise records skipped (tool results, etc.). */
+    skipped_noise_records: number;
+    /** Number of sessions that contained compacted summaries. */
+    compacted_sessions: number;
+    /** Wall-clock time for the entire operation (ms). */
+    elapsed_ms: number;
+}
+/**
+ * Convert a project root path into Claude Code's per-project conversation path.
+ * Claude stores conversation JSONL files under `~/.claude/projects/<encoded-cwd>`.
+ */
+export declare function getClaudeConversationProjectPath(cwd: string, homeDir?: string): string;
+/**
+ * Index all JSONL conversation session files found in `projectPath`.
+ *
+ * - Filters to `.jsonl` files only
+ * - Skips files larger than 10 MB
+ * - Extracts conversation_turn symbols via `extractConversationSymbols`
+ * - Saves to the CodeSift index store and registers in the registry
+ * - Caches the BM25 index in module memory for search use
+ */
+export declare function indexConversations(projectPath?: string): Promise<IndexConversationsResult>;
+export interface ConversationSearchResult {
+    session_id: string;
+    timestamp: string;
+    git_branch: string;
+    user_question: string;
+    assistant_answer: string;
+    score: number;
+    file: string;
+    turn_index: number;
+    project?: string;
+}
+export interface SearchConversationsResult {
+    results: ConversationSearchResult[];
+    total_matches: number;
+}
+/**
+ * Search indexed conversation turns using hybrid BM25 + semantic search.
+ *
+ * When embeddings are available, fuses BM25 keyword results with semantic
+ * similarity via RRF (Reciprocal Rank Fusion). Falls back to BM25-only
+ * when no embedding provider is configured.
+ */
+export declare function searchConversations(query: string, projectPath?: string, limit?: number): Promise<SearchConversationsResult>;
+/**
+ * Search ALL indexed conversation projects at once.
+ * Iterates over all `conversations/*` repos in the registry,
+ * searches each, merges and re-ranks results.
+ */
+export declare function searchAllConversations(query: string, limit?: number): Promise<SearchConversationsResult & {
+    projects_searched: number;
+}>;
+export interface FindConversationsForSymbolResult {
+    symbol: {
+        name: string;
+        file: string;
+        kind: string;
+    };
+    conversations: ConversationSearchResult[];
+    session_count: number;
+}
+/**
+ * Find conversation turns that mention a given symbol name.
+ *
+ * Resolves the symbol in the code repo first, then searches the matching
+ * Claude Code conversation directory for discussions of that symbol.
+ */
+export declare function findConversationsForSymbol(symbolName: string, repo: string, limit?: number): Promise<FindConversationsForSymbolResult>;
+/**
+ * Encode a filesystem path for use as a Claude project directory name.
+ * Claude stores per-project files under `~/.claude/projects/<encoded-cwd>`,
+ * where each `/` in the path is replaced with `-`.
+ */
+export declare function encodeCwdToClaudePath(cwd: string): string;
+/**
+ * Install a session-end hook into `<projectRoot>/.claude/settings.local.json`.
+ *
+ * The hook runs `codesift index-conversations --quiet` whenever Claude stops,
+ * keeping the conversation index up-to-date automatically. Idempotent — will
+ * not add a duplicate if the codesift hook is already present.
+ */
+export declare function installSessionEndHook(projectRoot: string): Promise<void>;
+/**
+ * Auto-discover and index conversation files for the current project at startup.
+ *
+ * Looks up `~/.claude/projects/<encoded-cwd>` for JSONL session files,
+ * indexes them incrementally, then installs the session-end hook so the
+ * index stays fresh going forward. Silently does nothing when no conversation
+ * directory exists for the project.
+ */
+export declare function autoDiscoverConversations(cwd: string): Promise<void>;
+//# sourceMappingURL=conversation-tools.d.ts.map

package/dist/tools/conversation-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-tools.d.ts","sourceRoot":"","sources":["../../src/tools/conversation-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,EAA2C,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAe5F,gFAAgF;AAChF,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAE3E;AAED,MAAM,WAAW,wBAAwB;IACvC,yDAAyD;IACzD,cAAc,EAAE,MAAM,CAAC;IACvB,mEAAmE;IACnE,aAAa,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,qBAAqB,EAAE,MAAM,CAAC;IAC9B,6DAA6D;IAC7D,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,CAC9C,GAAG,EAAE,MAAM,EACX,OAAO,SAAsB,GAC5B,MAAM,CAER;AAMD;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,wBAAwB,CAAC,CAsGnC;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,wBAAwB,EAAE,CAAC;IACpC,aAAa,EAAE,MAAM,CAAC;CACvB;AAuED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,MAAM,EACpB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,yBAAyB,CAAC,CAmEpC;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,yBAAyB,GAAG;IAAE,iBAAiB,EAAE,MAAM,CAAA;CAAE,CAAC,CAgCpE;AAED,MAAM,WAAW,gCAAgC;IAC/C,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,aAAa,EAAE,wBAAwB,EAAE,CAAC;IAC1C,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAC9C,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,gCAAgC,CAAC,CA+C3C;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA8C9E;AAED;;;;;;;GAOG;AACH,wBAAsB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAe1E"}

package/dist/tools/conversation-tools.js

@@ -0,0 +1,419 @@
+/**
+ * Conversation indexing tool.
+ *
+ * Scans a directory for JSONL session files, extracts conversation turn symbols,
+ * and registers them into the CodeSift index so they are searchable via BM25.
+ */
+import { readdir, stat, readFile, writeFile, mkdir, rename } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join, relative, basename, resolve } from "node:path";
+import { extractConversationSymbols } from "../parser/symbol-extractor.js";
+import { saveIndex, loadIndex, getIndexPath } from "../storage/index-store.js";
+import { registerRepo } from "../storage/registry.js";
+import { buildBM25Index, searchBM25, applyCutoff } from "../search/bm25.js";
+import { loadConfig } from "../config.js";
+import { embedSymbols } from "./index-tools.js";
+// No file size limit — large sessions (40-66MB) often contain the most
+// valuable decisions. readFile + line-by-line JSON.parse handles them fine.
+function getCurrentHomeDir() {
+    return process.env.HOME ?? process.env.USERPROFILE ?? homedir();
+}
+/** Module-level BM25 cache keyed by conversation repo name. */
+const bm25Indexes = new Map();
+/** Get the cached BM25 index for a conversation repo (used by search tools). */
+export function getConversationBM25Index(repoName) {
+    return bm25Indexes.get(repoName) ?? null;
+}
+/**
+ * Convert a project root path into Claude Code's per-project conversation path.
+ * Claude stores conversation JSONL files under `~/.claude/projects/<encoded-cwd>`.
+ */
+export function getClaudeConversationProjectPath(cwd, homeDir = getCurrentHomeDir()) {
+    return join(homeDir, ".claude", "projects", encodeCwdToClaudePath(resolve(cwd)));
+}
+function resolveConversationProjectPath(projectPath) {
+    return projectPath ? resolve(projectPath) : getClaudeConversationProjectPath(process.cwd());
+}
+/**
+ * Index all JSONL conversation session files found in `projectPath`.
+ *
+ * - Filters to `.jsonl` files only
+ * - Skips files larger than 10 MB
+ * - Extracts conversation_turn symbols via `extractConversationSymbols`
+ * - Saves to the CodeSift index store and registers in the registry
+ * - Caches the BM25 index in module memory for search use
+ */
+export async function indexConversations(projectPath) {
+    const startTime = Date.now();
+    const rootPath = resolveConversationProjectPath(projectPath);
+    const config = loadConfig();
+    // Derive repo name: "conversations/<folder>"
+    const repoName = `conversations/${basename(rootPath)}`;
+    const indexPath = getIndexPath(config.dataDir, rootPath);
+    const allSymbols = [];
+    const fileEntries = [];
+    let sessionsFound = 0;
+    let turnsIndexed = 0;
+    let skippedNoiseRecords = 0;
+    let compactedSessions = 0;
+    // List directory entries — non-recursive, flat scan
+    let entries;
+    try {
+        entries = await readdir(rootPath);
+    }
+    catch {
+        entries = [];
+    }
+    const jsonlFiles = entries.filter((name) => name.endsWith(".jsonl"));
+    for (const fileName of jsonlFiles) {
+        const filePath = join(rootPath, fileName);
+        // Read and extract
+        let source;
+        try {
+            source = await readFile(filePath, "utf-8");
+        }
+        catch {
+            continue;
+        }
+        const relPath = relative(rootPath, filePath);
+        const symbols = extractConversationSymbols(source, relPath, repoName);
+        const turnSymbols = symbols.filter((s) => s.kind === "conversation_turn");
+        const summarySymbols = symbols.filter((s) => s.kind === "conversation_summary");
+        sessionsFound++;
+        turnsIndexed += turnSymbols.length;
+        if (summarySymbols.length > 0) {
+            compactedSessions++;
+        }
+        allSymbols.push(...symbols);
+        const entry = {
+            path: relPath,
+            language: "conversation",
+            symbol_count: symbols.length,
+            last_modified: Date.now(),
+        };
+        fileEntries.push(entry);
+    }
+    // Build and cache BM25 index
+    const bm25 = buildBM25Index(allSymbols);
+    bm25Indexes.set(repoName, bm25);
+    // Persist the code index
+    const codeIndex = {
+        repo: repoName,
+        root: rootPath,
+        symbols: allSymbols,
+        files: fileEntries,
+        created_at: Date.now(),
+        updated_at: Date.now(),
+        symbol_count: allSymbols.length,
+        file_count: fileEntries.length,
+    };
+    await saveIndex(indexPath, codeIndex);
+    // Embed conversation symbols in background (non-fatal, fire-and-forget)
+    embedSymbols(allSymbols, indexPath, repoName, config).catch((err) => {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(`[codesift] Conversation embedding failed for ${repoName}: ${msg}`);
+    });
+    // Register in the global registry
+    const meta = {
+        name: repoName,
+        root: rootPath,
+        index_path: indexPath,
+        symbol_count: allSymbols.length,
+        file_count: fileEntries.length,
+        updated_at: Date.now(),
+    };
+    await registerRepo(config.registryPath, meta);
+    return {
+        sessions_found: sessionsFound,
+        turns_indexed: turnsIndexed,
+        skipped_noise_records: skippedNoiseRecords,
+        compacted_sessions: compactedSessions,
+        elapsed_ms: Date.now() - startTime,
+    };
+}
+/**
+ * Map a SearchResult to a ConversationSearchResult with metadata extraction.
+ */
+function toConversationResult(r, repoName) {
+    const sym = r.symbol;
+    const source = sym.source ?? "";
+    const sepIdx = source.indexOf("\n---\n");
+    const assistantAnswer = sepIdx >= 0 ? source.slice(sepIdx + 5, sepIdx + 505) : "";
+    const turnMatch = sym.id.match(/:turn_(\d+):/);
+    const turnIndex = turnMatch ? parseInt(turnMatch[1], 10) : 0;
+    // Parse signature for metadata: "timestamp\nuser_text" or "timestamp | branch\nuser_text"
+    const sig = sym.signature ?? "";
+    const firstNewline = sig.indexOf("\n");
+    const metaLine = firstNewline >= 0 ? sig.slice(0, firstNewline) : "";
+    const metaParts = metaLine.split(" | ");
+    // Check if first part looks like a timestamp (starts with 20)
+    const timestamp = metaParts[0]?.startsWith("20") ? metaParts[0] : "";
+    const gitBranch = timestamp ? (metaParts[1] ?? "") : "";
+    return {
+        session_id: sym.parent ?? "",
+        timestamp,
+        git_branch: gitBranch,
+        user_question: sym.name,
+        assistant_answer: assistantAnswer,
+        score: r.score,
+        file: sym.file,
+        turn_index: turnIndex,
+        ...(repoName ? { project: repoName } : {}),
+    };
+}
+/**
+ * Load BM25 index + symbol map for a conversation repo (from cache or disk).
+ */
+async function loadConversationIndex(rootPath) {
+    const repoName = `conversations/${basename(rootPath)}`;
+    const config = loadConfig();
+    const indexPath = getIndexPath(config.dataDir, rootPath);
+    let bm25 = bm25Indexes.get(repoName) ?? null;
+    let codeIndex = null;
+    if (!bm25) {
+        try {
+            codeIndex = await loadIndex(indexPath);
+            if (codeIndex && codeIndex.symbols.length > 0) {
+                bm25 = buildBM25Index(codeIndex.symbols);
+                bm25Indexes.set(repoName, bm25);
+            }
+        }
+        catch {
+            return null;
+        }
+    }
+    if (!bm25)
+        return null;
+    // Build symbol map from BM25 index or loaded index
+    const symbols = bm25.symbols;
+    return { bm25, repoName, indexPath, symbols };
+}
+/**
+ * Search indexed conversation turns using hybrid BM25 + semantic search.
+ *
+ * When embeddings are available, fuses BM25 keyword results with semantic
+ * similarity via RRF (Reciprocal Rank Fusion). Falls back to BM25-only
+ * when no embedding provider is configured.
+ */
+export async function searchConversations(query, projectPath, limit) {
+    const rootPath = resolveConversationProjectPath(projectPath);
+    const loaded = await loadConversationIndex(rootPath);
+    if (!loaded)
+        return { results: [], total_matches: 0 };
+    const { bm25, repoName, indexPath, symbols } = loaded;
+    const config = loadConfig();
+    const topK = limit ?? 10;
+    // BM25 results
+    const bm25Results = searchBM25(bm25, query, topK * 2, config.bm25FieldWeights);
+    const bm25Filtered = applyCutoff(bm25Results);
+    // Try semantic search if embeddings available
+    let semanticResults = [];
+    if (config.embeddingProvider) {
+        try {
+            const { createEmbeddingProvider, searchSemantic, cosineSimilarity: _cos } = await import("../search/semantic.js");
+            const { loadEmbeddings, getEmbeddingPath } = await import("../storage/embedding-store.js");
+            const provider = createEmbeddingProvider(config.embeddingProvider, config);
+            const embeddingPath = getEmbeddingPath(indexPath);
+            const embeddings = await loadEmbeddings(embeddingPath);
+            if (embeddings.size > 0) {
+                const [queryVec] = await provider.embed([query]);
+                if (queryVec) {
+                    const qEmb = new Float32Array(queryVec);
+                    semanticResults = searchSemantic(qEmb, embeddings, symbols, topK * 2);
+                }
+            }
+        }
+        catch {
+            // Semantic search failed — fall back to BM25 only
+        }
+    }
+    // Fuse results: boost BM25 scores with semantic signal (additive, not RRF)
+    // This preserves BM25 magnitude for cross-project ranking
+    let finalResults;
+    if (semanticResults.length > 0) {
+        const semanticMap = new Map();
+        for (const r of semanticResults) {
+            semanticMap.set(r.symbol.id, r.score);
+        }
+        // Add semantic similarity as a bonus to BM25 score (scaled to ~20% of BM25 range)
+        const maxBm25 = bm25Filtered.length > 0 ? bm25Filtered[0].score : 1;
+        const boosted = bm25Filtered.map((r) => {
+            const semScore = semanticMap.get(r.symbol.id) ?? 0;
+            return { symbol: r.symbol, score: r.score + semScore * maxBm25 * 0.2 };
+        });
+        // Also add semantic-only results not in BM25 (with lower base score)
+        for (const r of semanticResults) {
+            if (!bm25Filtered.some((b) => b.symbol.id === r.symbol.id)) {
+                boosted.push({ symbol: r.symbol, score: r.score * maxBm25 * 0.15 });
+            }
+        }
+        boosted.sort((a, b) => b.score - a.score);
+        finalResults = boosted.slice(0, topK);
+    }
+    else {
+        finalResults = bm25Filtered.slice(0, topK);
+    }
+    const results = finalResults.map((r) => toConversationResult(r, repoName));
+    return { results, total_matches: results.length };
+}
+/**
+ * Search ALL indexed conversation projects at once.
+ * Iterates over all `conversations/*` repos in the registry,
+ * searches each, merges and re-ranks results.
+ */
+export async function searchAllConversations(query, limit) {
+    const { listRepos } = await import("../storage/registry.js");
+    const config = loadConfig();
+    const repos = await listRepos(config.registryPath);
+    const conversationRepos = repos.filter((r) => r.name.startsWith("conversations/") && !r.name.includes("conv-test") && !r.name.includes("conv-ret"));
+    const allResults = [];
+    for (const repo of conversationRepos) {
+        try {
+            const { results } = await searchConversations(query, repo.root, limit ?? 10);
+            for (const r of results) {
+                allResults.push({ ...r, project: repo.name });
+            }
+        }
+        catch {
+            // Skip repos that fail to load
+        }
+    }
+    // Sort by score descending, take top limit
+    allResults.sort((a, b) => b.score - a.score);
+    const topK = limit ?? 10;
+    const trimmed = allResults.slice(0, topK);
+    return {
+        results: trimmed,
+        total_matches: trimmed.length,
+        projects_searched: conversationRepos.length,
+    };
+}
+/**
+ * Find conversation turns that mention a given symbol name.
+ *
+ * Resolves the symbol in the code repo first, then searches the matching
+ * Claude Code conversation directory for discussions of that symbol.
+ */
+export async function findConversationsForSymbol(symbolName, repo, limit) {
+    let resolvedSymbol = { name: symbolName, file: "", kind: "" };
+    let projectPath;
+    try {
+        const { searchSymbols } = await import("./search-tools.js");
+        const symbolResults = await searchSymbols(repo, symbolName, {
+            include_source: false,
+            detail_level: "compact",
+            top_k: 10,
+        });
+        const bestMatch = symbolResults.find((r) => r.symbol.name === symbolName) ??
+            symbolResults.find((r) => r.symbol.name.toLowerCase() === symbolName.toLowerCase()) ??
+            symbolResults[0];
+        if (bestMatch) {
+            resolvedSymbol = {
+                name: bestMatch.symbol.name,
+                file: bestMatch.symbol.file,
+                kind: bestMatch.symbol.kind,
+            };
+        }
+    }
+    catch {
+        // Fall back to plain-text search using the provided symbol name.
+    }
+    try {
+        const { getRepo } = await import("../storage/registry.js");
+        const config = loadConfig();
+        const repoMeta = await getRepo(config.registryPath, repo);
+        if (repoMeta) {
+            projectPath = getClaudeConversationProjectPath(repoMeta.root);
+        }
+    }
+    catch {
+        // Fall back to the current project's conversations if repo lookup fails.
+    }
+    const { results } = await searchConversations(resolvedSymbol.name, projectPath, limit ?? 5);
+    const uniqueSessions = new Set(results.map((r) => r.session_id));
+    return {
+        symbol: resolvedSymbol,
+        conversations: results,
+        session_count: uniqueSessions.size,
+    };
+}
+/**
+ * Encode a filesystem path for use as a Claude project directory name.
+ * Claude stores per-project files under `~/.claude/projects/<encoded-cwd>`,
+ * where each `/` in the path is replaced with `-`.
+ */
+export function encodeCwdToClaudePath(cwd) {
+    return cwd.replace(/\//g, "-");
+}
+/**
+ * Install a session-end hook into `<projectRoot>/.claude/settings.local.json`.
+ *
+ * The hook runs `codesift index-conversations --quiet` whenever Claude stops,
+ * keeping the conversation index up-to-date automatically. Idempotent — will
+ * not add a duplicate if the codesift hook is already present.
+ */
+export async function installSessionEndHook(projectRoot) {
+    const settingsDir = join(projectRoot, ".claude");
+    const settingsPath = join(settingsDir, "settings.local.json");
+    const hookEntry = {
+        matcher: "",
+        hooks: [
+            {
+                type: "command",
+                command: "codesift index-conversations --quiet",
+            },
+        ],
+    };
+    let settings = {};
+    try {
+        const content = await readFile(settingsPath, "utf-8");
+        settings = JSON.parse(content);
+    }
+    catch {
+        // File doesn't exist or is invalid — start fresh
+    }
+    // Ensure hooks.Stop array exists
+    if (!settings.hooks || typeof settings.hooks !== "object") {
+        settings.hooks = {};
+    }
+    const hooksObj = settings.hooks;
+    if (!Array.isArray(hooksObj.Stop)) {
+        hooksObj.Stop = [];
+    }
+    // Check if codesift hook already exists (idempotent)
+    const existing = hooksObj.Stop;
+    if (existing.some((h) => h.hooks?.some((hk) => hk.command?.includes("codesift")))) {
+        return; // Already installed
+    }
+    existing.push(hookEntry);
+    // Write atomically
+    await mkdir(settingsDir, { recursive: true });
+    const tmpPath = settingsPath + ".tmp";
+    await writeFile(tmpPath, JSON.stringify(settings, null, 2));
+    await rename(tmpPath, settingsPath);
+    console.error("CodeSift: conversation index hook installed in .claude/settings.local.json");
+}
+/**
+ * Auto-discover and index conversation files for the current project at startup.
+ *
+ * Looks up `~/.claude/projects/<encoded-cwd>` for JSONL session files,
+ * indexes them incrementally, then installs the session-end hook so the
+ * index stays fresh going forward. Silently does nothing when no conversation
+ * directory exists for the project.
+ */
+export async function autoDiscoverConversations(cwd) {
+    const conversationsDir = getClaudeConversationProjectPath(cwd);
+    try {
+        const dirStat = await stat(conversationsDir);
+        if (!dirStat.isDirectory())
+            return;
+    }
+    catch {
+        return; // Directory doesn't exist — no conversations for this project
+    }
+    // Index conversations (incremental — skips unchanged files)
+    await indexConversations(conversationsDir);
+    // Install session-end hook
+    await installSessionEndHook(cwd);
+}
+//# sourceMappingURL=conversation-tools.js.map

package/dist/tools/conversation-tools.js.map

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

package/dist/tools/coordinator-tools.d.ts

@@ -0,0 +1,73 @@
+export interface ScratchpadEntry {
+    key: string;
+    value: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface AnalysisPlan {
+    id: string;
+    title: string;
+    steps: AnalysisStep[];
+    status: "pending" | "in_progress" | "completed" | "failed";
+    scratchpad_dir: string;
+    created_at: string;
+    completed_at?: string;
+}
+export interface AnalysisStep {
+    id: string;
+    description: string;
+    tool: string;
+    args: Record<string, unknown>;
+    status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
+    result_key?: string;
+    depends_on?: string[];
+    error?: string;
+}
+/**
+ * Create a new analysis plan with a scratchpad directory.
+ */
+export declare function createAnalysisPlan(title: string, steps: Array<{
+    description: string;
+    tool: string;
+    args: Record<string, unknown>;
+    result_key?: string;
+    depends_on?: string[];
+}>): Promise<AnalysisPlan>;
+/**
+ * Write a key-value entry to the plan's scratchpad.
+ * Scratchpad entries are persisted as individual files.
+ */
+export declare function writeScratchpad(planId: string, key: string, value: string): Promise<ScratchpadEntry>;
+/**
+ * Read a key from the plan's scratchpad.
+ */
+export declare function readScratchpad(planId: string, key: string): Promise<ScratchpadEntry | null>;
+/**
+ * List all entries in the plan's scratchpad.
+ */
+export declare function listScratchpad(planId: string): Promise<{
+    entries: Array<{
+        key: string;
+        size: number;
+        updated_at: string;
+    }>;
+}>;
+/**
+ * Update a step's status in the plan.
+ */
+export declare function updateStepStatus(planId: string, stepId: string, status: AnalysisStep["status"], error?: string): Promise<AnalysisPlan>;
+/**
+ * Get the current state of a plan.
+ */
+export declare function getPlan(planId: string): AnalysisPlan | null;
+/**
+ * List all active plans.
+ */
+export declare function listPlans(): Array<{
+    id: string;
+    title: string;
+    status: string;
+    steps_completed: number;
+    steps_total: number;
+}>;
+//# sourceMappingURL=coordinator-tools.d.ts.map

package/dist/tools/coordinator-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator-tools.d.ts","sourceRoot":"","sources":["../../src/tools/coordinator-tools.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC3D,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AASD;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,KAAK,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC,GACD,OAAO,CAAC,YAAY,CAAC,CAgCvB;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,eAAe,CAAC,CAsB1B;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAajC;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CA2BhF;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,EAC9B,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,YAAY,CAAC,CA+BvB;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAE3D;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,KAAK,CAAC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC,CAQD"}