ricord 1.0.0

package/dist/cli/ledger.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Local ledger — per-project state the daemon and the manual sync flow
+ * both depend on. Lives at `<project>/.ricord/ledger.json`.
+ *
+ * Shape:
+ *   {
+ *     project_id: "abc-123",
+ *     repo: { remote_url, branch?, head_sha? },
+ *     transcripts: { [absPath]: { bytes_seen, last_seen_at } },
+ *     last_synced_at: number
+ *   }
+ *
+ * Mutations are atomic: write to a temp file then rename. The file is
+ * gitignored in `.ricord/.gitignore` so it never leaks into a repo.
+ */
+export interface RicordLedger {
+    project_id?: string;
+    /** Team-space binding (2026-05-23). When set, `ricord push` writes pages
+     *  into the (team_id, project_id) team space — every team member with
+     *  role >= member can read + edit them. When absent, push lands in the
+     *  caller's personal scope (team_id IS NULL). Mirrors the git-remote
+     *  model: one ledger declares one owner. */
+    team_id?: string;
+    repo?: {
+        remote_url?: string;
+        branch?: string;
+        head_sha?: string;
+    };
+    transcripts: Record<string, {
+        bytes_seen: number;
+        last_seen_at: number;
+    }>;
+    last_synced_at?: number;
+    /** Tick 25 — last successful `ricord push` (ms). Files with mtime
+     *  greater than this are sent on the next push. */
+    last_pushed_at?: number;
+    /** Tick 28 — last `ricord pull` (ms). `--merge` compares local mtime
+     *  against this to detect conflicting edits. */
+    last_pulled_at?: number;
+}
+export declare function ledgerDir(repoRoot: string): string;
+export declare function ledgerPath(repoRoot: string): string;
+export declare function readLedger(repoRoot: string): Promise<RicordLedger>;
+export declare function writeLedger(repoRoot: string, next: RicordLedger): Promise<void>;

package/dist/cli/ledger.js

@@ -0,0 +1,67 @@
+/**
+ * Local ledger — per-project state the daemon and the manual sync flow
+ * both depend on. Lives at `<project>/.ricord/ledger.json`.
+ *
+ * Shape:
+ *   {
+ *     project_id: "abc-123",
+ *     repo: { remote_url, branch?, head_sha? },
+ *     transcripts: { [absPath]: { bytes_seen, last_seen_at } },
+ *     last_synced_at: number
+ *   }
+ *
+ * Mutations are atomic: write to a temp file then rename. The file is
+ * gitignored in `.ricord/.gitignore` so it never leaks into a repo.
+ */
+import { readFile, writeFile, mkdir, rename } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { join, resolve } from "node:path";
+const DEFAULT_LEDGER = { transcripts: {} };
+export function ledgerDir(repoRoot) {
+    return join(resolve(repoRoot), ".ricord");
+}
+export function ledgerPath(repoRoot) {
+    return join(ledgerDir(repoRoot), "ledger.json");
+}
+export async function readLedger(repoRoot) {
+    const p = ledgerPath(repoRoot);
+    if (!existsSync(p))
+        return { ...DEFAULT_LEDGER };
+    try {
+        const raw = await readFile(p, "utf8");
+        const parsed = JSON.parse(raw);
+        return { ...DEFAULT_LEDGER, ...parsed, transcripts: parsed.transcripts ?? {} };
+    }
+    catch {
+        return { ...DEFAULT_LEDGER };
+    }
+}
+export async function writeLedger(repoRoot, next) {
+    const dir = ledgerDir(repoRoot);
+    await mkdir(dir, { recursive: true });
+    const path = ledgerPath(repoRoot);
+    const tmp = `${path}.tmp.${process.pid}`;
+    await writeFile(tmp, JSON.stringify(next, null, 2) + "\n", "utf8");
+    await rename(tmp, path);
+    // Local-first .gitignore (G11 pivot): only the ledger + tmp files are
+    // per-machine; pages/ stays git-tracked as source of truth. Force-update
+    // a pre-pivot `*` ignore so existing repos flip to the new layout.
+    const gi = join(dir, ".gitignore");
+    const desired = [
+        "# Ricord — local-first layout",
+        "# Pages are the source of truth and SHOULD be committed.",
+        "# Ledger is per-machine sync state and should NOT be.",
+        "ledger.json",
+        "ledger.json.tmp.*",
+        "",
+    ].join("\n");
+    if (!existsSync(gi)) {
+        await writeFile(gi, desired, "utf8");
+        return;
+    }
+    const cur = await readFile(gi, "utf8").catch(() => "");
+    if (cur.trim() === "*") {
+        await writeFile(gi, desired, "utf8");
+    }
+}
+//# sourceMappingURL=ledger.js.map

package/dist/cli/ledger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger.js","sourceRoot":"","sources":["../../src/cli/ledger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyB1C,MAAM,cAAc,GAAiB,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;AAEzD,MAAM,UAAU,SAAS,CAAC,QAAgB;IACxC,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,QAAgB;IAC/C,MAAM,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC/B,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,GAAG,cAAc,EAAE,CAAC;IACjD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QACtC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA0B,CAAC;QACxD,OAAO,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC;IACjF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,GAAG,cAAc,EAAE,CAAC;IAC/B,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAgB,EAAE,IAAkB;IACpE,MAAM,GAAG,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAChC,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAClC,MAAM,GAAG,GAAG,GAAG,IAAI,QAAQ,OAAO,CAAC,GAAG,EAAE,CAAC;IACzC,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;IACnE,MAAM,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACxB,sEAAsE;IACtE,yEAAyE;IACzE,mEAAmE;IACnE,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG;QACd,+BAA+B;QAC/B,0DAA0D;QAC1D,uDAAuD;QACvD,aAAa;QACb,mBAAmB;QACnB,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC;QACpB,MAAM,SAAS,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QACrC,OAAO;IACT,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IACvD,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;QACvB,MAAM,SAAS,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC;AACH,CAAC"}

package/dist/cli/llm.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Host-LLM helper — local `claude` CLI ONLY.
+ *
+ * Why no Gemini/OpenAI fallback: the user took an $8K paid-API bill
+ * last month from a script that did this exact pattern. The Max
+ * subscription covers Claude Code at flat rate, so any heavy work
+ * (whole-repo authoring, batch rollup, large-context calls) MUST
+ * run through the local CLI. There is no fallback path that hits a
+ * paid API — if `claude` isn't installed, the CLI errors out and the
+ * user fixes their setup. We do not silently bill them.
+ *
+ * See `_pinned_top_never_paid_api_for_heavy_work` memory note.
+ */
+type JsonSchema = Record<string, unknown>;
+/**
+ * The ONLY LLM path. No fallbacks — Gemini/OpenAI calls would cost
+ * money, the user runs Claude Max, so heavy work always goes through
+ * the local CLI.
+ */
+export declare function callHostLLM(prompt: string, schema: JsonSchema): Promise<unknown>;
+export {};

package/dist/cli/llm.js

@@ -0,0 +1,138 @@
+/**
+ * Host-LLM helper — local `claude` CLI ONLY.
+ *
+ * Why no Gemini/OpenAI fallback: the user took an $8K paid-API bill
+ * last month from a script that did this exact pattern. The Max
+ * subscription covers Claude Code at flat rate, so any heavy work
+ * (whole-repo authoring, batch rollup, large-context calls) MUST
+ * run through the local CLI. There is no fallback path that hits a
+ * paid API — if `claude` isn't installed, the CLI errors out and the
+ * user fixes their setup. We do not silently bill them.
+ *
+ * See `_pinned_top_never_paid_api_for_heavy_work` memory note.
+ */
+import { spawn } from "node:child_process";
+/**
+ * Spawn the local `claude` CLI and feed it the prompt on stdin. Auth
+ * is whatever the user has configured (Max subscription via OAuth).
+ *
+ * `--output-format json` wraps the response as
+ *   { type: "result", result: "<llm-text>", ... }
+ * so we extract `.result` then JSON.parse to satisfy the schema.
+ */
+async function callClaudeCli(prompt, schema) {
+    return await new Promise((resolveOk, reject) => {
+        // The prompt itself instructs the model to reply with JSON only;
+        // we extract via regex so we don't need --json-schema (which puts
+        // the CLI into an agentic validate/retry loop). Empty allow-list
+        // forces chat-only behavior (no Write, no Bash) so we get a single
+        // text turn with the JSON inline. Observed: this returns a clean
+        // {"pages":[…]} in 1 turn vs num_turns=2 with empty result when
+        // schema validation is enabled.
+        void schema;
+        const args = [
+            "-p",
+            "--output-format", "json",
+            "--dangerously-skip-permissions",
+            "--allowedTools", "",
+        ];
+        const child = spawn("claude", args, { stdio: ["pipe", "pipe", "pipe"] });
+        let stdout = "";
+        let stderr = "";
+        child.stdout.on("data", (b) => { stdout += b.toString("utf8"); });
+        child.stderr.on("data", (b) => { stderr += b.toString("utf8"); });
+        child.on("error", (e) => {
+            const err = new Error(`claude cli spawn failed: ${e.message}. ` +
+                `Install Claude Code (https://claude.com/claude-code) — this CLI does not bill paid APIs as a fallback.`);
+            err.status = -1;
+            reject(err);
+        });
+        child.on("close", (code) => {
+            if (code !== 0) {
+                const err = new Error(`claude → exit ${code}: ${(stderr || stdout).slice(0, 300)}`);
+                err.status = code ?? -1;
+                return reject(err);
+            }
+            try {
+                const wrapper = JSON.parse(stdout);
+                if (wrapper.is_error || wrapper.subtype !== "success") {
+                    return reject(new Error(`claude returned error: ${stdout.slice(0, 300)}`));
+                }
+                const inner = wrapper.result ?? "";
+                // Claude in -p mode sometimes prepends a chatty preamble or wraps
+                // the JSON in ```json … ```. Extract the JSON object robustly:
+                // 1) fenced block first, 2) first balanced {...} otherwise.
+                const fenced = inner.match(/```(?:json)?\s*([\s\S]*?)```/);
+                const jsonText = fenced ? fenced[1] : extractJsonObject(inner);
+                if (!jsonText) {
+                    return reject(new Error(`claude returned no JSON object. raw head=${inner.slice(0, 300)}`));
+                }
+                resolveOk(JSON.parse(jsonText.trim()));
+            }
+            catch (e) {
+                reject(new Error(`claude output parse failed: ${e.message}; raw head=${stdout.slice(0, 200)}`));
+            }
+        });
+        child.stdin.write(prompt, "utf8");
+        child.stdin.end();
+    });
+}
+/** Extract the first balanced top-level JSON object from a string. The
+ *  scanner walks character-by-character tracking string state + brace
+ *  depth so trivial preamble like "Here is the JSON: {...}" round-trips
+ *  cleanly. Returns null if no balanced object found. */
+function extractJsonObject(s) {
+    const start = s.indexOf("{");
+    if (start === -1)
+        return null;
+    let depth = 0;
+    let inStr = false;
+    let escape = false;
+    for (let i = start; i < s.length; i++) {
+        const c = s[i];
+        if (escape) {
+            escape = false;
+            continue;
+        }
+        if (c === "\\") {
+            escape = true;
+            continue;
+        }
+        if (c === '"') {
+            inStr = !inStr;
+            continue;
+        }
+        if (inStr)
+            continue;
+        if (c === "{")
+            depth++;
+        else if (c === "}") {
+            depth--;
+            if (depth === 0)
+                return s.slice(start, i + 1);
+        }
+    }
+    return null;
+}
+/** Detect whether the `claude` CLI is on PATH. If not, fail loudly. */
+async function haveClaudeCli() {
+    return await new Promise((res) => {
+        const c = spawn("claude", ["--version"], { stdio: "ignore" });
+        c.on("error", () => res(false));
+        c.on("close", (code) => res(code === 0));
+    });
+}
+/**
+ * The ONLY LLM path. No fallbacks — Gemini/OpenAI calls would cost
+ * money, the user runs Claude Max, so heavy work always goes through
+ * the local CLI.
+ */
+export async function callHostLLM(prompt, schema) {
+    const haveClaude = await haveClaudeCli();
+    if (!haveClaude) {
+        throw new Error("ricord requires the local `claude` CLI (Claude Code). Install: https://claude.com/claude-code. " +
+            "No paid-API fallback by design — we don't bill you to fill a wiki.");
+    }
+    return callClaudeCli(prompt, schema);
+}
+//# sourceMappingURL=llm.js.map

package/dist/cli/llm.js.map

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

package/dist/cli/parse.d.ts

@@ -0,0 +1,13 @@
+import { RepoFile } from "./walker.js";
+export interface ParsedFile {
+    rel: string;
+    imports: string[];
+    exports: ExportSym[];
+    topComment: string;
+}
+export interface ExportSym {
+    name: string;
+    kind: "function" | "class" | "interface" | "type" | "const" | "var" | "let" | "enum" | "default" | "reexport";
+    signature?: string;
+}
+export declare function parseFile(file: RepoFile): Promise<ParsedFile | null>;

package/dist/cli/parse.js

@@ -0,0 +1,188 @@
+import { promises as fs } from "node:fs";
+const TS_EXTS = new Set([".ts", ".tsx", ".js", ".jsx"]);
+let _ts = null;
+async function getTs() {
+    if (_ts)
+        return _ts;
+    _ts = (await import("typescript")).default ?? (await import("typescript"));
+    return _ts;
+}
+export async function parseFile(file) {
+    if (TS_EXTS.has(file.ext))
+        return parseTs(file);
+    if (file.ext === ".py")
+        return parsePy(file);
+    return null;
+}
+async function parseTs(file) {
+    let src;
+    try {
+        src = await fs.readFile(file.abs, "utf8");
+    }
+    catch {
+        return null;
+    }
+    const ts = await getTs();
+    const sf = ts.createSourceFile(file.rel, src, ts.ScriptTarget.Latest, true, file.ext === ".tsx" ? ts.ScriptKind.TSX : ts.ScriptKind.TS);
+    const imports = [];
+    const exports = [];
+    const visit = (node) => {
+        if (ts.isImportDeclaration(node)) {
+            const spec = node.moduleSpecifier;
+            if (ts.isStringLiteral(spec))
+                imports.push(spec.text);
+        }
+        if (ts.isExportDeclaration(node) && node.moduleSpecifier && ts.isStringLiteral(node.moduleSpecifier)) {
+            imports.push(node.moduleSpecifier.text);
+        }
+        if (ts.isCallExpression(node) && ts.isIdentifier(node.expression) && node.expression.text === "require") {
+            const arg = node.arguments[0];
+            if (arg && ts.isStringLiteral(arg))
+                imports.push(arg.text);
+        }
+        if (ts.isCallExpression(node) && node.expression.kind === ts.SyntaxKind.ImportKeyword) {
+            const arg = node.arguments[0];
+            if (arg && ts.isStringLiteral(arg))
+                imports.push(arg.text);
+        }
+        const mods = ts.canHaveModifiers(node) ? ts.getModifiers(node) : undefined;
+        const isExport = !!mods?.some(m => m.kind === ts.SyntaxKind.ExportKeyword);
+        const isDefault = !!mods?.some(m => m.kind === ts.SyntaxKind.DefaultKeyword);
+        if (isExport) {
+            if (ts.isFunctionDeclaration(node) && node.name) {
+                exports.push({ name: node.name.text, kind: "function", signature: shortFnSig(ts, node) });
+            }
+            else if (ts.isClassDeclaration(node) && node.name) {
+                exports.push({ name: node.name.text, kind: "class", signature: shortClassSig(node) });
+            }
+            else if (ts.isInterfaceDeclaration(node)) {
+                exports.push({ name: node.name.text, kind: "interface" });
+            }
+            else if (ts.isTypeAliasDeclaration(node)) {
+                exports.push({ name: node.name.text, kind: "type" });
+            }
+            else if (ts.isEnumDeclaration(node)) {
+                exports.push({ name: node.name.text, kind: "enum" });
+            }
+            else if (ts.isVariableStatement(node)) {
+                const kw = node.declarationList.flags & ts.NodeFlags.Const ? "const"
+                    : node.declarationList.flags & ts.NodeFlags.Let ? "let"
+                        : "var";
+                for (const d of node.declarationList.declarations) {
+                    if (ts.isIdentifier(d.name))
+                        exports.push({ name: d.name.text, kind: kw });
+                }
+            }
+            if (isDefault)
+                exports.push({ name: "default", kind: "default" });
+        }
+        if (ts.isExportDeclaration(node) && !node.moduleSpecifier && node.exportClause && ts.isNamedExports(node.exportClause)) {
+            for (const e of node.exportClause.elements)
+                exports.push({ name: e.name.text, kind: "reexport" });
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(sf);
+    return {
+        rel: file.rel,
+        imports: dedupe(imports),
+        exports: dedupeExports(exports),
+        topComment: extractTopComment(src),
+    };
+}
+function shortFnSig(ts, node) {
+    const params = node.parameters.map(p => p.getText()).join(", ");
+    const ret = node.type ? `: ${node.type.getText()}` : "";
+    return `(${params})${ret}`;
+}
+function shortClassSig(node) {
+    const heritage = node.heritageClauses?.map(h => h.getText()).join(" ") ?? "";
+    return heritage;
+}
+async function parsePy(file) {
+    let src;
+    try {
+        src = await fs.readFile(file.abs, "utf8");
+    }
+    catch {
+        return null;
+    }
+    const imports = [];
+    const exports = [];
+    for (const lineRaw of src.split("\n")) {
+        const line = lineRaw.trim();
+        if (!line || line.startsWith("#"))
+            continue;
+        let m;
+        if ((m = line.match(/^import\s+([\w.]+)/)))
+            imports.push(m[1]);
+        else if ((m = line.match(/^from\s+([\w.]+)\s+import/)))
+            imports.push(m[1]);
+        else if ((m = line.match(/^from\s+(\.+[\w.]*)\s+import/)))
+            imports.push(m[1]);
+        if (lineRaw.startsWith("def ") && (m = line.match(/^def\s+(\w+)\s*\(([^)]*)\)/))) {
+            if (!m[1].startsWith("_"))
+                exports.push({ name: m[1], kind: "function", signature: `(${m[2]})` });
+        }
+        else if (lineRaw.startsWith("class ") && (m = line.match(/^class\s+(\w+)(?:\(([^)]*)\))?/))) {
+            if (!m[1].startsWith("_"))
+                exports.push({ name: m[1], kind: "class", signature: m[2] ? `extends ${m[2]}` : "" });
+        }
+    }
+    return {
+        rel: file.rel,
+        imports: dedupe(imports),
+        exports: dedupeExports(exports),
+        topComment: extractTopComment(src),
+    };
+}
+function dedupe(arr) { return [...new Set(arr)]; }
+function dedupeExports(arr) {
+    const seen = new Set();
+    return arr.filter(e => {
+        const k = `${e.kind}:${e.name}`;
+        if (seen.has(k))
+            return false;
+        seen.add(k);
+        return true;
+    });
+}
+function extractTopComment(src) {
+    const trimmed = src.trimStart();
+    if (trimmed.startsWith("/**") || trimmed.startsWith("/*")) {
+        const end = trimmed.indexOf("*/");
+        if (end > 0)
+            return cleanComment(trimmed.slice(0, end + 2));
+    }
+    if (trimmed.startsWith('"""') || trimmed.startsWith("'''")) {
+        const q = trimmed.slice(0, 3);
+        const end = trimmed.indexOf(q, 3);
+        if (end > 0)
+            return cleanComment(trimmed.slice(0, end + 3));
+    }
+    if (trimmed.startsWith("//") || trimmed.startsWith("#")) {
+        const lines = trimmed.split("\n");
+        const block = [];
+        for (const ln of lines) {
+            const t = ln.trim();
+            if (t.startsWith("//") || t.startsWith("#"))
+                block.push(t);
+            else
+                break;
+        }
+        return cleanComment(block.join("\n"));
+    }
+    return "";
+}
+function cleanComment(s) {
+    return s
+        .replace(/^\s*\/\*\*?/g, "").replace(/\*\/\s*$/g, "")
+        .replace(/^\s*"""/g, "").replace(/"""\s*$/g, "")
+        .replace(/^\s*'''/g, "").replace(/'''\s*$/g, "")
+        .split("\n")
+        .map(l => l.replace(/^\s*[\*#/]+\s?/, "").trimEnd())
+        .filter(l => l.length > 0)
+        .join("\n")
+        .slice(0, 800);
+}
+//# sourceMappingURL=parse.js.map

package/dist/cli/parse.js.map

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

package/dist/cli/run-explore.d.ts

@@ -0,0 +1,56 @@
+export interface ExploreOpts {
+    root: string;
+    apiBase: string;
+    ricordToken?: string;
+    dryRun?: boolean;
+    noIngest?: boolean;
+    emitBundles?: boolean;
+    summariesDir?: string;
+    limit?: number;
+    llmModel?: string;
+    llmKey?: string;
+}
+export interface ExploreResult {
+    ok: boolean;
+    errorReason?: string;
+    root: string;
+    bundlesFound: number;
+    meaningful: number;
+    processed: number;
+    cached: number;
+    failed: number;
+    ingested: number;
+    totalChars: number;
+    totalExports: number;
+    totalImports: number;
+    totalAnchors: number;
+    totalConnections: number;
+    totalTasks: number;
+    topDirsByUsedBy: Array<{
+        rel: string;
+        usedByCount: number;
+    }>;
+    summariesDir: string;
+    usage?: {
+        tier: string;
+        memoriesUsed: number;
+        memoriesCap: number;
+    };
+    llm?: {
+        provider: string;
+        model: string;
+    };
+}
+export type Logger = (line: string) => void;
+/**
+ * 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 declare function runExplore(opts: ExploreOpts, log: Logger): Promise<ExploreResult>;