ricord 1.0.0

package/dist/cli/run-explore.js

@@ -0,0 +1,229 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { walkRepo } from "./walker.js";
+import { buildBundle, invertUsedBy, renderBundleForPrompt } from "./bundle.js";
+import { bundleAsSummary } from "./summarize.js";
+import { SummaryCache } from "./cache.js";
+import { fetchExtractionPrompt, fetchUsage, makeLlmFn, postExtracted, resolveLlmConfig, runExtraction, } from "./extract.js";
+/**
+ * Walk a repo, summarize each meaningful directory mechanically, run client-
+ * side LLM extraction, and POST structured anchors/connections/tasks to
+ * /v1/ingest/extracted. Powers `ricord init`.
+ *
+ * Post-2026-05-12 the server runs zero generative LLM calls — extraction
+ * happens here. The caller must provide an LLM key (OPENAI_API_KEY or
+ * ANTHROPIC_API_KEY by default, or --llm-key/--llm-model overrides).
+ *
+ * Progress is streamed via the `log` callback so the CLI can write to stdout.
+ */
+export async function runExplore(opts, log) {
+    const root = path.resolve(opts.root);
+    const summariesDir = opts.summariesDir ?? path.join(root, ".ricord-cache", "summaries");
+    const result = {
+        ok: true,
+        root,
+        bundlesFound: 0,
+        meaningful: 0,
+        processed: 0,
+        cached: 0,
+        failed: 0,
+        ingested: 0,
+        totalChars: 0,
+        totalExports: 0,
+        totalImports: 0,
+        totalAnchors: 0,
+        totalConnections: 0,
+        totalTasks: 0,
+        topDirsByUsedBy: [],
+        summariesDir,
+    };
+    // Resolve LLM up front so we fail fast if the user has no key.
+    // --emit-bundles mode skips the LLM entirely: the host agent (Claude Code,
+    // Codex, etc.) reads the manifest and drives extraction itself.
+    const willIngest = !opts.dryRun && !opts.noIngest && !opts.emitBundles && !!opts.ricordToken;
+    let llmCfg = null;
+    if (willIngest) {
+        try {
+            llmCfg = resolveLlmConfig({ modelFlag: opts.llmModel, keyFlag: opts.llmKey });
+            result.llm = { provider: llmCfg.provider, model: llmCfg.model };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            result.ok = false;
+            result.errorReason = msg;
+            log(`ERROR: ${msg}`);
+            return result;
+        }
+    }
+    log("▸ Walking repo…");
+    const groups = await walkRepo(root);
+    result.bundlesFound = groups.length;
+    log(`  found ${groups.length} dirs with ingestable files`);
+    log("▸ Parsing files + building bundles…");
+    const bundles = [];
+    for (const g of groups)
+        bundles.push(await buildBundle(g, root));
+    invertUsedBy(bundles);
+    const meaningful = bundles.filter(b => b.parsedFiles.length > 0 || b.readme || b.fileTree.split("\n").length > 1);
+    result.meaningful = meaningful.length;
+    log(`  ${meaningful.length} meaningful dirs (after filtering empty)`);
+    const target = opts.limit ? meaningful.slice(0, opts.limit) : meaningful;
+    for (const b of target) {
+        result.totalChars += renderBundleForPrompt(b).length;
+        result.totalExports += b.parsedFiles.reduce((n, p) => n + p.exports.length, 0);
+        result.totalImports += b.parsedFiles.reduce((n, p) => n + p.imports.length, 0);
+    }
+    log(`  bundles: ${target.length} | total prompt chars: ${result.totalChars} | exports: ${result.totalExports} | import edges: ${result.totalImports}`);
+    result.topDirsByUsedBy = [...target]
+        .sort((a, b) => b.usedBy.length - a.usedBy.length)
+        .slice(0, 5)
+        .map(b => ({ rel: b.rel, usedByCount: b.usedBy.length }));
+    if (opts.dryRun) {
+        log("\n▸ Top 5 dirs by used-by count:");
+        for (const t of result.topDirsByUsedBy)
+            log(`  ${t.rel}  ←  ${t.usedByCount} dirs`);
+        log("\nDry run complete.");
+        return result;
+    }
+    const cache = new SummaryCache(root);
+    await cache.load();
+    await fs.mkdir(summariesDir, { recursive: true });
+    // --emit-bundles: walk + write bundles + manifest, then exit. The host agent
+    // (a slash command in Claude Code, a Codex script, etc.) reads the manifest
+    // and drives extraction. Karpathy pattern: the LLM agent IS the worker.
+    if (opts.emitBundles) {
+        log(`\n▸ Emitting bundles + manifest for ${target.length} dirs…`);
+        const bundlesDir = path.join(root, ".ricord-cache", "bundles");
+        await fs.mkdir(bundlesDir, { recursive: true });
+        const manifest = [];
+        for (const b of target) {
+            result.processed++;
+            const summary = bundleAsSummary(b);
+            const hash = cache.hashBundle(renderBundleForPrompt(b));
+            cache.set(b.rel, { bundleHash: hash, summary });
+            const slug = b.rel === "." ? "_root" : b.rel.replace(/\//g, "__");
+            const bundlePath = path.join(bundlesDir, `${slug}.md`);
+            await fs.writeFile(bundlePath, summary, "utf8");
+            manifest.push({ rel: b.rel, slug, bundlePath, chars: summary.length, hash });
+        }
+        await cache.save();
+        const manifestPath = path.join(root, ".ricord-cache", "manifest.json");
+        await fs.writeFile(manifestPath, JSON.stringify({
+            generated_at: new Date().toISOString(),
+            root,
+            repo: path.basename(root),
+            api_base: opts.apiBase,
+            bundle_count: manifest.length,
+            bundles: manifest,
+        }, null, 2), "utf8");
+        log(`\n▸ Done. ${manifest.length} bundles written to ${bundlesDir}`);
+        log(`  manifest: ${manifestPath}`);
+        log(`\n▸ Next: have your host agent (e.g. /ricord-init in Claude Code) walk`);
+        log(`  the manifest and POST extraction results to /v1/ingest/extracted.`);
+        return result;
+    }
+    const ingestCfg = willIngest
+        ? { apiBase: opts.apiBase, token: opts.ricordToken }
+        : null;
+    if (!ingestCfg && !opts.noIngest) {
+        log("  (no token — running as if --no-ingest)");
+    }
+    // Fetch the canonical extraction prompt once. The server-authored prompt
+    // drives all clients so we stay in lockstep with schema/cap changes.
+    let promptTemplate = "";
+    let schemaVersion = 1;
+    if (ingestCfg && llmCfg) {
+        log(`\n▸ Client-side extraction: ${llmCfg.provider}/${llmCfg.model}`);
+        try {
+            const p = await fetchExtractionPrompt(ingestCfg);
+            promptTemplate = p.prompt;
+            schemaVersion = p.schema_version;
+            log(`  prompt schema v${schemaVersion} fetched`);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            result.ok = false;
+            result.errorReason = msg;
+            log(`ERROR: ${msg}`);
+            return result;
+        }
+    }
+    const llmFn = ingestCfg && llmCfg ? makeLlmFn(llmCfg) : null;
+    log(`\n▸ Building summaries + extracting for ${target.length} dirs…`);
+    for (const b of target) {
+        result.processed++;
+        const bundleText = renderBundleForPrompt(b);
+        const hash = cache.hashBundle(bundleText);
+        let summary;
+        if (cache.hasFresh(b.rel, hash)) {
+            summary = cache.get(b.rel).summary;
+            result.cached++;
+        }
+        else {
+            summary = bundleAsSummary(b);
+            cache.set(b.rel, { bundleHash: hash, summary });
+        }
+        const slug = b.rel === "." ? "_root" : b.rel.replace(/\//g, "__");
+        await fs.writeFile(path.join(summariesDir, `${slug}.md`), summary, "utf8");
+        let note = "";
+        if (ingestCfg && llmFn && llmCfg) {
+            try {
+                const extracted = await runExtraction(llmFn, promptTemplate, summary);
+                const r = await postExtracted(ingestCfg, {
+                    dirRel: b.rel,
+                    bundleText: summary,
+                    extracted,
+                    repo: path.basename(root),
+                    model: llmCfg.model,
+                    schemaVersion,
+                });
+                if (r.ok) {
+                    result.ingested++;
+                    result.totalAnchors += extracted.anchors.length;
+                    result.totalConnections += extracted.connections.length;
+                    result.totalTasks += extracted.tasks.length;
+                    const e = cache.get(b.rel);
+                    e.ingestedAt = new Date().toISOString();
+                    note = ` → a:${extracted.anchors.length} c:${extracted.connections.length} t:${extracted.tasks.length}`;
+                }
+                else {
+                    const errMsg = typeof r.body === "string"
+                        ? r.body
+                        : (() => {
+                            const b = r.body;
+                            return b?.error?.message ?? JSON.stringify(r.body);
+                        })();
+                    note = ` → ingest FAILED ${r.status}: ${errMsg.slice(0, 200)}`;
+                    result.failed++;
+                }
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                note = ` → extract FAILED (${msg.slice(0, 80)})`;
+                result.failed++;
+            }
+        }
+        log(`  ✓ [${result.processed}/${target.length}] ${b.rel}  (${summary.length} chars)${note}`);
+        if (result.processed % 10 === 0)
+            await cache.save();
+    }
+    await cache.save();
+    log(`\n▸ Done. ok=${result.processed - result.failed}  cached=${result.cached}  failed=${result.failed}  ingested=${result.ingested}`);
+    log(`  summaries written to: ${summariesDir}`);
+    if (ingestCfg && result.ingested > 0) {
+        log(`  totals: ${result.totalAnchors} anchors · ${result.totalConnections} connections · ${result.totalTasks} tasks`);
+        const usage = await fetchUsage(ingestCfg);
+        if (usage) {
+            result.usage = {
+                tier: usage.tier ?? "unknown",
+                memoriesUsed: usage.memories_used ?? 0,
+                memoriesCap: usage.memories_cap ?? 0,
+            };
+            log(`\n▸ Quota: ${result.usage.memoriesUsed}/${result.usage.memoriesCap} memories used (tier: ${result.usage.tier})`);
+        }
+        log(`\n▸ Extraction ran client-side. KG, KB pages, and tasks are written.`);
+        log(`  View your graph at https://ricord.ai/dashboard.`);
+    }
+    return result;
+}
+//# sourceMappingURL=run-explore.js.map

package/dist/cli/run-explore.js.map

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

package/dist/cli/summarize.d.ts

@@ -0,0 +1,15 @@
+import { DirBundle } from "./bundle.js";
+/**
+ * Guidance prompt returned by the `ricord_walk` MCP tool so the calling agent
+ * (Claude) knows what shape of summary to write per directory before posting
+ * via `ricord_ingest`. Also documents the output that `bundleAsSummary` aims
+ * to approximate mechanically when no agent is in the loop (e.g. `ricord init`).
+ */
+export declare const SUMMARY_PROMPT = "You summarize one directory of a code repository for ingestion into a knowledge graph.\n\nYour output becomes graph nodes and edges, so be precise about relationships between modules, packages, tables, endpoints, and external dependencies.\n\nOutput STRICT MARKDOWN with these exact headings, in this order:\n\n# {dir_path}\n\n**Module:** {short name}\n**Package:** {parent package, e.g. ricord-api}\n**Path:** {dir_path}\n\n## Purpose\nONE paragraph (3-6 sentences). What this directory is responsible for. Use proper nouns liberally \u2014 class names, table names, endpoint paths, function names.\n\n## Key exports\nBulleted list. One line each. Format: `Name \u2014 what it does`. Limit to 5-15 most important.\n\n## Tables, endpoints, named artifacts\nBulleted list of specific named things this directory creates or owns.\n\n## Depends on\nPull DIRECTLY from the \"Imports from sibling dirs\" and \"External dependencies\" sections you were given. Do NOT invent.\n\n## Used by\nPull DIRECTLY from the \"This directory is imported by\" section. Do NOT invent.\n\n## Facts\nNon-obvious truths a reader would want. Each fact one line. Reference proper nouns.\n\nHard rules: no source code blocks, no speculation, ~600-1000 words total.\n";
+/**
+ * Ship the rendered bundle directly. The bundle is already structured
+ * (headings, exports, imports, used-by) and the backend entity extractor
+ * (Gemini 2.5 Flash) latches onto that structure — no client-side LLM
+ * rewrite needed.
+ */
+export declare function bundleAsSummary(bundle: DirBundle): string;

package/dist/cli/summarize.js

@@ -0,0 +1,49 @@
+import { renderBundleForPrompt } from "./bundle.js";
+/**
+ * Guidance prompt returned by the `ricord_walk` MCP tool so the calling agent
+ * (Claude) knows what shape of summary to write per directory before posting
+ * via `ricord_ingest`. Also documents the output that `bundleAsSummary` aims
+ * to approximate mechanically when no agent is in the loop (e.g. `ricord init`).
+ */
+export const SUMMARY_PROMPT = `You summarize one directory of a code repository for ingestion into a knowledge graph.
+
+Your output becomes graph nodes and edges, so be precise about relationships between modules, packages, tables, endpoints, and external dependencies.
+
+Output STRICT MARKDOWN with these exact headings, in this order:
+
+# {dir_path}
+
+**Module:** {short name}
+**Package:** {parent package, e.g. ricord-api}
+**Path:** {dir_path}
+
+## Purpose
+ONE paragraph (3-6 sentences). What this directory is responsible for. Use proper nouns liberally — class names, table names, endpoint paths, function names.
+
+## Key exports
+Bulleted list. One line each. Format: \`Name — what it does\`. Limit to 5-15 most important.
+
+## Tables, endpoints, named artifacts
+Bulleted list of specific named things this directory creates or owns.
+
+## Depends on
+Pull DIRECTLY from the "Imports from sibling dirs" and "External dependencies" sections you were given. Do NOT invent.
+
+## Used by
+Pull DIRECTLY from the "This directory is imported by" section. Do NOT invent.
+
+## Facts
+Non-obvious truths a reader would want. Each fact one line. Reference proper nouns.
+
+Hard rules: no source code blocks, no speculation, ~600-1000 words total.
+`;
+/**
+ * Ship the rendered bundle directly. The bundle is already structured
+ * (headings, exports, imports, used-by) and the backend entity extractor
+ * (Gemini 2.5 Flash) latches onto that structure — no client-side LLM
+ * rewrite needed.
+ */
+export function bundleAsSummary(bundle) {
+    return renderBundleForPrompt(bundle, { maxChars: 32_000 });
+}
+//# sourceMappingURL=summarize.js.map

package/dist/cli/summarize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarize.js","sourceRoot":"","sources":["../../src/cli/summarize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+B7B,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,OAAO,qBAAqB,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;AAC7D,CAAC"}

package/dist/cli/uninstall.d.ts

@@ -0,0 +1,6 @@
+interface UninstallOptions {
+    root: string;
+    dryRun: boolean;
+}
+export declare function runUninstall(opts: UninstallOptions): Promise<number>;
+export {};

package/dist/cli/uninstall.js

@@ -0,0 +1,277 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { spawnSync } from "node:child_process";
+function tryJson(file) {
+    try {
+        return JSON.parse(fs.readFileSync(file, "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+function writeJson(file, data, dryRun) {
+    const text = JSON.stringify(data, null, 2);
+    if (dryRun) {
+        console.log(`  [dry-run] would write ${file}`);
+    }
+    else {
+        fs.writeFileSync(file, text + "\n", "utf8");
+    }
+}
+/** Walk from startDir upward, collecting all .mcp.json and .claude/settings.json paths that exist. */
+function collectConfigFiles(startDir) {
+    const mcpJsons = [];
+    const settingsJsons = [];
+    let dir = startDir;
+    while (true) {
+        const mcp = path.join(dir, ".mcp.json");
+        if (fs.existsSync(mcp))
+            mcpJsons.push(mcp);
+        // Both settings.json (committed) and settings.local.json (per-machine,
+        // where `claude mcp add` writes permission grants) need cleaning.
+        for (const name of ["settings.json", "settings.local.json"]) {
+            const f = path.join(dir, ".claude", name);
+            if (fs.existsSync(f))
+                settingsJsons.push(f);
+        }
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    // Also check home dir (both variants)
+    for (const name of ["settings.json", "settings.local.json"]) {
+        const f = path.join(os.homedir(), ".claude", name);
+        if (fs.existsSync(f) && !settingsJsons.includes(f))
+            settingsJsons.push(f);
+    }
+    return { mcpJsons, settingsJsons };
+}
+function removeMcpEntry(file, dryRun) {
+    const data = tryJson(file);
+    if (!data)
+        return false;
+    const servers = data.mcpServers;
+    if (!servers || !("ricord" in servers))
+        return false;
+    delete servers.ricord;
+    if (Object.keys(servers).length === 0)
+        delete data.mcpServers;
+    writeJson(file, data, dryRun);
+    return true;
+}
+function isRicordHook(cmd) {
+    return typeof cmd === "string" && cmd.includes("ricord-mcp");
+}
+function removeHooksAndPerms(file, dryRun) {
+    const data = tryJson(file);
+    if (!data)
+        return false;
+    let changed = false;
+    // Remove ricord hooks
+    const hooks = data.hooks;
+    if (hooks) {
+        for (const event of Object.keys(hooks)) {
+            const entries = hooks[event];
+            const filtered = entries.filter(entry => {
+                const cmds = entry.hooks ?? [];
+                return !cmds.some(h => isRicordHook(h.command));
+            });
+            if (filtered.length !== entries.length)
+                changed = true;
+            if (filtered.length === 0) {
+                delete hooks[event];
+            }
+            else {
+                hooks[event] = filtered;
+            }
+        }
+        if (Object.keys(hooks).length === 0)
+            delete data.hooks;
+    }
+    // Remove ricord permissions from allow list
+    const perms = data.permissions;
+    if (perms?.allow) {
+        const before = perms.allow.length;
+        perms.allow = perms.allow.filter(p => !p.startsWith("mcp__ricord__"));
+        if (perms.allow.length === 0)
+            delete perms.allow;
+        if (Object.keys(perms).length === 0)
+            delete data.permissions;
+        if (perms.allow?.length !== before)
+            changed = true;
+    }
+    if (!changed)
+        return false;
+    writeJson(file, data, dryRun);
+    return true;
+}
+/**
+ * Clean ricord entries from ~/.claude.json, which is where Claude Code's
+ * `claude mcp add` writes registrations. Handles three locations:
+ *   1. Top-level `mcpServers.ricord` (user scope: `claude mcp add -s user`)
+ *   2. `projects.<cwd>.mcpServers.ricord` (default/local scope)
+ *   3. `claudeAiMcpEverConnected[]` registry entries containing "ricord"
+ */
+function removeClaudeAiMcpEntries(dryRun) {
+    const claudeJson = path.join(os.homedir(), ".claude.json");
+    const data = tryJson(claudeJson);
+    if (!data)
+        return false;
+    let changed = false;
+    // 1. Top-level user-scope mcpServers
+    const topServers = data.mcpServers;
+    if (topServers && "ricord" in topServers) {
+        delete topServers.ricord;
+        if (Object.keys(topServers).length === 0)
+            delete data.mcpServers;
+        changed = true;
+    }
+    // 2. Per-project mcpServers (project/local scope)
+    const projects = data.projects;
+    if (projects) {
+        for (const projPath of Object.keys(projects)) {
+            const proj = projects[projPath];
+            if (proj?.mcpServers && "ricord" in proj.mcpServers) {
+                delete proj.mcpServers.ricord;
+                if (Object.keys(proj.mcpServers).length === 0)
+                    delete proj.mcpServers;
+                changed = true;
+            }
+        }
+    }
+    // 3. claudeAiMcpEverConnected registry
+    const connected = data.claudeAiMcpEverConnected;
+    if (connected) {
+        const filtered = connected.filter((e) => !e.toLowerCase().includes("ricord"));
+        if (filtered.length !== connected.length) {
+            data.claudeAiMcpEverConnected = filtered;
+            changed = true;
+        }
+    }
+    if (!changed)
+        return false;
+    writeJson(claudeJson, data, dryRun);
+    return true;
+}
+function removeSlashCommands(dryRun) {
+    const commandsDir = path.join(os.homedir(), ".claude", "commands");
+    if (!fs.existsSync(commandsDir))
+        return 0;
+    const ricordFiles = fs.readdirSync(commandsDir).filter(f => f.startsWith("ricord-") && f.endsWith(".md"));
+    let removed = 0;
+    for (const f of ricordFiles) {
+        const full = path.join(commandsDir, f);
+        if (dryRun) {
+            console.log(`  [dry-run] would remove ${full}`);
+        }
+        else {
+            fs.rmSync(full);
+        }
+        removed++;
+    }
+    return removed;
+}
+function runCommand(cmd, args) {
+    const r = spawnSync(cmd, args, { encoding: "utf8" });
+    return {
+        ok: r.status === 0 && !r.error,
+        stderr: r.stderr ?? "",
+    };
+}
+/** Remove cached ricord-mcp installs from ~/.npm/_npx/<hash>/node_modules/. */
+function cleanNpxCache(dryRun) {
+    const npxDir = path.join(os.homedir(), ".npm", "_npx");
+    if (!fs.existsSync(npxDir))
+        return 0;
+    let removed = 0;
+    for (const entry of fs.readdirSync(npxDir)) {
+        const pkgDir = path.join(npxDir, entry, "node_modules", "ricord-mcp");
+        if (fs.existsSync(pkgDir)) {
+            if (dryRun) {
+                console.log(`  [dry-run] would remove ${pkgDir}`);
+            }
+            else {
+                fs.rmSync(pkgDir, { recursive: true, force: true });
+            }
+            removed++;
+        }
+    }
+    return removed;
+}
+function uninstallGlobal(dryRun) {
+    console.log("\n▸ Removing global installs");
+    const managers = [
+        { bin: "npm", args: ["uninstall", "-g", "ricord-mcp", "@ricord/mcp-server"] },
+        { bin: "bun", args: ["remove", "-g", "ricord-mcp"] },
+    ];
+    for (const { bin, args } of managers) {
+        // Check if the bin exists
+        const which = spawnSync("which", [bin], { encoding: "utf8" });
+        if (which.status !== 0)
+            continue;
+        if (dryRun) {
+            console.log(`  [dry-run] would run: ${bin} ${args.join(" ")}`);
+            continue;
+        }
+        const result = runCommand(bin, args);
+        if (result.ok) {
+            console.log(`  ✓ ${bin}: removed`);
+        }
+        else {
+            // Not installed is fine
+            console.log(`  - ${bin}: not found or already removed`);
+        }
+    }
+}
+export async function runUninstall(opts) {
+    const { root, dryRun } = opts;
+    console.log(`▸ ricord uninstall${dryRun ? " (dry-run)" : ""}`);
+    console.log(`  scanning from: ${root}`);
+    // 1. Global package managers
+    uninstallGlobal(dryRun);
+    // 2. Config files
+    const { mcpJsons, settingsJsons } = collectConfigFiles(root);
+    console.log("\n▸ Removing MCP server entries");
+    if (mcpJsons.length === 0) {
+        console.log("  - no .mcp.json files found");
+    }
+    for (const f of mcpJsons) {
+        const changed = removeMcpEntry(f, dryRun);
+        console.log(`  ${changed ? "✓" : "-"} ${f}`);
+    }
+    console.log("\n▸ Removing hooks and permissions");
+    if (settingsJsons.length === 0) {
+        console.log("  - no .claude/settings.json files found");
+    }
+    for (const f of settingsJsons) {
+        const changed = removeHooksAndPerms(f, dryRun);
+        console.log(`  ${changed ? "✓" : "-"} ${f}`);
+    }
+    // 3. ~/.claude.json (Claude Code registrations + ever-connected registry)
+    console.log("\n▸ Cleaning ~/.claude.json (Claude Code MCP registrations)");
+    const registryChanged = removeClaudeAiMcpEntries(dryRun);
+    console.log(`  ${registryChanged ? "✓" : "-"} ~/.claude.json (mcpServers + projects.*.mcpServers + claudeAiMcpEverConnected)`);
+    // 4. Slash commands
+    console.log("\n▸ Removing slash commands");
+    const removed = removeSlashCommands(dryRun);
+    if (removed === 0) {
+        console.log("  - no ricord slash commands found");
+    }
+    else {
+        console.log(`  ✓ removed ${removed} command(s) from ~/.claude/commands/`);
+    }
+    // 5. npx cache (so future `npx ricord-mcp` re-fetches a fresh version)
+    console.log("\n▸ Cleaning npx cache");
+    const npxRemoved = cleanNpxCache(dryRun);
+    if (npxRemoved === 0) {
+        console.log("  - no ricord-mcp in npx cache");
+    }
+    else {
+        console.log(`  ✓ removed ${npxRemoved} cached copy/copies from ~/.npm/_npx/`);
+    }
+    console.log("\nDone. Restart Claude Code to complete the removal.");
+    return 0;
+}
+//# sourceMappingURL=uninstall.js.map

package/dist/cli/uninstall.js.map

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

package/dist/cli/walk.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Repo walker — finds source files for `ricord ingest`. Honors a hard-coded
+ * skip list (node_modules, .git, dist, build, .next, .cache, .ricord) and
+ * an extension allow-list. Optional `paths` restricts to those subtrees.
+ *
+ * Designed to be deterministic so the same repo produces the same file
+ * order in every run — the ingest batch is order-stable for sha checks.
+ */
+export interface WalkedFile {
+    absPath: string;
+    size: number;
+}
+export declare function walkRepo(repoRoot: string, paths?: string[]): Promise<WalkedFile[]>;