ricord 1.0.0

package/dist/cli/commands/curate.js

@@ -0,0 +1,154 @@
+/**
+ * `ricord curate [--apply]` — wiki curation pass (F3 / S8).
+ *
+ * Default behavior (no flag) is a dry-run preview: fetches the server's
+ * curation suggestions and prints them.  `--apply` posts the approved
+ * operations back to the server. Operations are server-defined:
+ *
+ *   - move:      retag / re-anchor a page
+ *   - merge:     fold two pages into one (keeps the better title)
+ *   - archive:   mark a page archived (kb_pages.archived_at)
+ *   - supersede: B replaces A (kb_pages.superseded_by)
+ *
+ * The CLI does not run an LLM. The server invokes the CURATION_PROMPT
+ * inside /v1/kb/curate/preview; the CLI only orchestrates approval.
+ */
+import { readdir, readFile, stat } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import kleur from "kleur";
+import { resolveAuth } from "../config.js";
+import { request } from "../client.js";
+import { readLedger, ledgerDir } from "../ledger.js";
+export async function curateCommand(opts) {
+    if (opts.local)
+        return curateLocal(opts);
+    const auth = await resolveAuth();
+    const ledger = await readLedger(opts.repoRoot);
+    const projectId = opts.projectId ?? ledger.project_id;
+    const qs = projectId ? `?project_id=${encodeURIComponent(projectId)}` : "";
+    if (opts.prepare) {
+        if (!projectId) {
+            console.error(kleur.red("--prepare needs --project <id> or a recorded ledger project."));
+            return 1;
+        }
+        const p = await request(auth, `/v1/kb/curate/prompt${qs}`);
+        console.log(p.prompt);
+        console.log();
+        console.log(kleur.dim("--- Batch ---"));
+        console.log(JSON.stringify({ existing_topics: p.batch.existing_topics, pages: p.batch.pages }, null, 2));
+        console.log();
+        console.log(kleur.dim(`POST result back to: ${p.submit_url}`));
+        return 0;
+    }
+    const preview = await request(auth, `/v1/kb/curate/preview${qs}`);
+    if (preview.operations.length === 0) {
+        console.log(kleur.green("✓"), `${preview.pages_examined} pages examined — nothing to curate.`);
+        return 0;
+    }
+    console.log(kleur.bold(`${preview.operations.length} suggested operation${preview.operations.length === 1 ? "" : "s"} across ${preview.pages_examined} pages`));
+    for (const o of preview.operations.slice(0, 50)) {
+        const tag = o.op === "merge" ? kleur.magenta("merge") :
+            o.op === "move" ? kleur.cyan("move") :
+                o.op === "archive" ? kleur.yellow("archive") :
+                    kleur.blue("supersede");
+        console.log(`  ${tag} ${o.page_id}${o.target_page_id ? ` → ${o.target_page_id}` : ""}  ${kleur.dim(o.reason)}`);
+    }
+    if (preview.operations.length > 50) {
+        console.log(kleur.dim(`  …${preview.operations.length - 50} more`));
+    }
+    if (!opts.apply) {
+        console.log();
+        console.log(kleur.dim("re-run with --apply to commit the operations."));
+        return 0;
+    }
+    const out = await request(auth, `/v1/kb/curate/apply${qs}`, {
+        method: "POST",
+        body: JSON.stringify({ operations: preview.operations }),
+    });
+    console.log(kleur.green("✓"), `${out.applied} applied, ${out.skipped} skipped.`);
+    return 0;
+}
+/** G11 tick 27 — local-first curation report. Scans .ricord/pages/, flags
+ *  empty bodies (stubs that never got rolled up), duplicate titles
+ *  (case-insensitive), missing frontmatter ids (manually-created files
+ *  that haven't been pushed yet), and stale files. No mutations. */
+async function curateLocal(opts) {
+    const dir = resolve(opts.repoRoot, join(ledgerDir(opts.repoRoot), "pages"));
+    const entries = await readdir(dir).catch(() => []);
+    const mds = entries.filter((e) => e.endsWith(".md"));
+    if (mds.length === 0) {
+        console.log(kleur.yellow(`no markdown files under .ricord/pages/ — run \`ricord init --pull\` first.`));
+        return 0;
+    }
+    const scans = [];
+    for (const f of mds) {
+        const full = join(dir, f);
+        const text = await readFile(full, "utf8").catch(() => "");
+        const st = await stat(full).catch(() => null);
+        const fmEnd = text.startsWith("---") ? text.indexOf("\n---", 3) : -1;
+        const fm = fmEnd > 0 ? text.slice(3, fmEnd) : "";
+        const body = fmEnd > 0 ? text.slice(fmEnd + 4).replace(/^\s*\n/, "").trim() : text.trim();
+        const idMatch = fm.match(/^id:\s*(\S+)/m);
+        const titleMatch = fm.match(/^title:\s*(.+)$/m);
+        scans.push({
+            file: f,
+            title: titleMatch?.[1]?.trim().replace(/^"|"$/g, "") ?? f.replace(/\.md$/, ""),
+            hasId: Boolean(idMatch?.[1]),
+            hasBody: body.length > 0 && body !== "(no body)",
+            mtimeMs: st?.mtimeMs ?? 0,
+        });
+    }
+    const now = Date.now();
+    const staleCutoff = now - opts.staleDays * 24 * 60 * 60 * 1000;
+    const empties = scans.filter((s) => !s.hasBody);
+    const noIds = scans.filter((s) => !s.hasId);
+    const stales = scans.filter((s) => s.hasBody && s.mtimeMs > 0 && s.mtimeMs < staleCutoff);
+    const titleGroups = new Map();
+    for (const s of scans) {
+        const k = s.title.toLowerCase();
+        const arr = titleGroups.get(k) ?? [];
+        arr.push(s);
+        titleGroups.set(k, arr);
+    }
+    const dupes = [...titleGroups.values()].filter((g) => g.length > 1);
+    console.log(kleur.bold(`ricord curate --local`), kleur.dim(`(${scans.length} pages in .ricord/pages/)`));
+    if (empties.length === 0 && noIds.length === 0 && stales.length === 0 && dupes.length === 0) {
+        console.log(kleur.green("✓ nothing to curate."));
+        return 0;
+    }
+    if (empties.length > 0) {
+        console.log("");
+        console.log(kleur.yellow(`empty bodies (${empties.length})`), kleur.dim("— run `ricord rollup` or fill manually"));
+        for (const s of empties.slice(0, 15))
+            console.log(kleur.dim(`  ${s.file} — ${s.title}`));
+        if (empties.length > 15)
+            console.log(kleur.dim(`  …${empties.length - 15} more`));
+    }
+    if (noIds.length > 0) {
+        console.log("");
+        console.log(kleur.cyan(`missing frontmatter id (${noIds.length})`), kleur.dim("— manually-created files, push will skip them"));
+        for (const s of noIds.slice(0, 15))
+            console.log(kleur.dim(`  ${s.file}`));
+        if (noIds.length > 15)
+            console.log(kleur.dim(`  …${noIds.length - 15} more`));
+    }
+    if (dupes.length > 0) {
+        console.log("");
+        console.log(kleur.magenta(`duplicate titles (${dupes.length})`), kleur.dim("— consider merging"));
+        for (const g of dupes.slice(0, 10)) {
+            console.log(kleur.dim(`  "${g[0].title}":`));
+            for (const s of g)
+                console.log(kleur.dim(`    ${s.file}`));
+        }
+    }
+    if (stales.length > 0) {
+        console.log("");
+        console.log(kleur.gray(`stale (>${opts.staleDays}d old) (${stales.length})`));
+        for (const s of stales.slice(0, 10)) {
+            const days = Math.floor((now - s.mtimeMs) / (1000 * 60 * 60 * 24));
+            console.log(kleur.dim(`  ${s.file} — ${days}d`));
+        }
+    }
+    return 0;
+}
+//# sourceMappingURL=curate.js.map

package/dist/cli/commands/curate.js.map

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

package/dist/cli/commands/doctor.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `ricord doctor` — readiness check for the local-first setup (G11).
+ *
+ * Verifies (and reports clearly) the four things that block real use:
+ *   1. API key present (~/.ricord/config.json)
+ *   2. Project bound (.ricord/ledger.json has project_id)
+ *   3. Local `claude` CLI installed (Claude Code) for rollup + build
+ *   4. Cloud reachable (auth-gated /v1/health-like ping)
+ *
+ * Exit 0 if everything green; exit 1 if anything fails.
+ */
+interface DoctorOpts {
+    repoRoot: string;
+}
+export declare function doctorCommand(opts: DoctorOpts): Promise<number>;
+export {};

package/dist/cli/commands/doctor.js

@@ -0,0 +1,92 @@
+/**
+ * `ricord doctor` — readiness check for the local-first setup (G11).
+ *
+ * Verifies (and reports clearly) the four things that block real use:
+ *   1. API key present (~/.ricord/config.json)
+ *   2. Project bound (.ricord/ledger.json has project_id)
+ *   3. Local `claude` CLI installed (Claude Code) for rollup + build
+ *   4. Cloud reachable (auth-gated /v1/health-like ping)
+ *
+ * Exit 0 if everything green; exit 1 if anything fails.
+ */
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import kleur from "kleur";
+import { readLedger, ledgerDir } from "../ledger.js";
+async function checkApiKey() {
+    const cfg = join(homedir(), ".ricord", "config.json");
+    if (!existsSync(cfg)) {
+        return { name: "api key", ok: false, detail: `missing — run \`ricord setup\` (~/.ricord/config.json)` };
+    }
+    return { name: "api key", ok: true, detail: `~/.ricord/config.json` };
+}
+async function checkProject(repoRoot) {
+    const ledger = await readLedger(repoRoot);
+    if (!ledger.project_id) {
+        return { name: "project", ok: false, detail: `no project_id — run \`ricord init --project <id>\`` };
+    }
+    return { name: "project", ok: true, detail: `bound to ${ledger.project_id}` };
+}
+async function checkLlm() {
+    // ONLY path is the local `claude` CLI. No paid-API fallback by
+    // design (see _pinned_top_never_paid_api_for_heavy_work memory).
+    const { spawn } = await import("node:child_process");
+    const haveClaude = await new Promise((res) => {
+        const c = spawn("claude", ["--version"], { stdio: "ignore" });
+        c.on("error", () => res(false));
+        c.on("close", (code) => res(code === 0));
+    });
+    if (haveClaude) {
+        return { name: "llm", ok: true, detail: `claude cli (Max subscription, no per-call billing)` };
+    }
+    return {
+        name: "llm",
+        ok: false,
+        detail: `install Claude Code CLI: https://claude.com/claude-code`,
+    };
+}
+async function checkCloud() {
+    try {
+        const base = process.env.RICORD_API_BASE ?? "https://api.ricord.ai";
+        const r = await fetch(`${base}/health`);
+        if (!r.ok)
+            return { name: "cloud", ok: false, detail: `GET ${base}/health → ${r.status}` };
+        return { name: "cloud", ok: true, detail: `api reachable` };
+    }
+    catch (e) {
+        return { name: "cloud", ok: false, detail: e.message };
+    }
+}
+function checkLayout(repoRoot) {
+    const dir = ledgerDir(repoRoot);
+    const pages = join(dir, "pages");
+    if (!existsSync(pages)) {
+        return { name: "layout", ok: false, detail: `.ricord/pages/ missing — \`ricord init\` to create it` };
+    }
+    return { name: "layout", ok: true, detail: `.ricord/{pages,ledger.json} present` };
+}
+export async function doctorCommand(opts) {
+    const checks = [
+        await checkApiKey(),
+        await checkProject(opts.repoRoot),
+        checkLayout(opts.repoRoot),
+        await checkLlm(),
+        await checkCloud(),
+    ];
+    console.log(kleur.bold("ricord doctor"));
+    let allOk = true;
+    for (const c of checks) {
+        const tick = c.ok ? kleur.green("✓") : kleur.red("✗");
+        console.log(`  ${tick} ${c.name.padEnd(10)} ${kleur.dim(c.detail)}`);
+        if (!c.ok)
+            allOk = false;
+    }
+    if (allOk) {
+        console.log(kleur.green("\nall green."));
+        return 0;
+    }
+    console.log(kleur.yellow("\nfix the ✗ rows above before running ricord rollup / push."));
+    return 1;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/cli/commands/doctor.js.map

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

package/dist/cli/commands/ingest.d.ts

@@ -0,0 +1,25 @@
+/**
+ * `ricord ingest [--mode initial|sync] [--project <id>] [--paths a,b,c]`
+ *
+ * Walks the repo, packages the working set into per-cluster batches, and
+ * POSTs them to /v1/ingest/repo. The server does no LLM work; the client
+ * is responsible for running its host LLM against the CODE_ANCHOR_PROMPT
+ * fetched from /v1/extraction/prompt?mode=code (server-injects existing
+ * topics when ?project_id= is supplied).
+ *
+ * This S5 slice ships the *transport* — file discovery, batching, server
+ * upload, ledger update. The host-LLM extraction step is exposed via a
+ * `--prepare` flag that prints the prompt + a JSON envelope template so
+ * the user can pipe it into their LLM of choice. Future slices wire a
+ * built-in extractor for opinionated default flows.
+ */
+interface IngestOpts {
+    mode: "initial" | "sync";
+    projectId?: string;
+    paths?: string[];
+    prepare: boolean;
+    dryRun: boolean;
+    repoRoot: string;
+}
+export declare function ingestCommand(opts: IngestOpts): Promise<number>;
+export {};

package/dist/cli/commands/ingest.js

@@ -0,0 +1,121 @@
+/**
+ * `ricord ingest [--mode initial|sync] [--project <id>] [--paths a,b,c]`
+ *
+ * Walks the repo, packages the working set into per-cluster batches, and
+ * POSTs them to /v1/ingest/repo. The server does no LLM work; the client
+ * is responsible for running its host LLM against the CODE_ANCHOR_PROMPT
+ * fetched from /v1/extraction/prompt?mode=code (server-injects existing
+ * topics when ?project_id= is supplied).
+ *
+ * This S5 slice ships the *transport* — file discovery, batching, server
+ * upload, ledger update. The host-LLM extraction step is exposed via a
+ * `--prepare` flag that prints the prompt + a JSON envelope template so
+ * the user can pipe it into their LLM of choice. Future slices wire a
+ * built-in extractor for opinionated default flows.
+ */
+import { readFile, stat } from "node:fs/promises";
+import { resolve, relative } from "node:path";
+import kleur from "kleur";
+import { resolveAuth } from "../config.js";
+import { request } from "../client.js";
+import { readLedger, writeLedger } from "../ledger.js";
+import { walkRepo } from "../walk.js";
+export async function ingestCommand(opts) {
+    const auth = await resolveAuth();
+    const ledger = await readLedger(opts.repoRoot);
+    const projectId = opts.projectId ?? ledger.project_id;
+    if (!projectId) {
+        console.error(kleur.red("project_id is required — pass --project <id> or run `ricord ingest --project <id>` once to record it."));
+        return 1;
+    }
+    const files = await walkRepo(opts.repoRoot, opts.paths);
+    if (files.length === 0) {
+        console.log(kleur.yellow("Nothing to ingest — repo walk produced 0 files."));
+        return 0;
+    }
+    if (opts.prepare) {
+        const prompt = await request(auth, `/v1/extraction/prompt?mode=code&project_id=${encodeURIComponent(projectId)}`);
+        console.log(prompt.prompt);
+        console.log();
+        console.log(kleur.dim(`--- Files (${files.length}) ---`));
+        for (const f of files.slice(0, 50)) {
+            console.log(kleur.dim(`  ${relative(opts.repoRoot, f.absPath)}`));
+        }
+        if (files.length > 50)
+            console.log(kleur.dim(`  …${files.length - 50} more`));
+        return 0;
+    }
+    if (opts.dryRun) {
+        console.log(kleur.bold(`Would ingest ${files.length} files into project ${projectId}.`));
+        return 0;
+    }
+    // Single batch for now; clustering by directory is a follow-up. The
+    // server caps batches at 40 and files-per-batch at 500.
+    const batchFiles = [];
+    for (const f of files.slice(0, 500)) {
+        try {
+            const s = await stat(f.absPath);
+            if (s.size > 200_000)
+                continue; // skip very large files
+            const content = await readFile(f.absPath, "utf8");
+            batchFiles.push({ path: relative(opts.repoRoot, f.absPath), content });
+        }
+        catch {
+            // unreadable — skip
+        }
+    }
+    const repoMeta = await detectRepoMeta(opts.repoRoot);
+    const body = {
+        project_id: projectId,
+        repo: repoMeta,
+        batches: [
+            {
+                cluster_name: "default",
+                files: batchFiles,
+                extracted: {
+                    // Pre-LLM ingest mode lands the *files* without anchors. The user
+                    // can then run a separate extraction step pointing at this repo.
+                    // Anchor-emitting flows piping a host-LLM output go through
+                    // /v1/ingest/extracted directly.
+                    anchors: [],
+                },
+                extraction_meta: { client: "ricord-cli", mode: "code" },
+            },
+        ],
+    };
+    const out = await request(auth, "/v1/ingest/repo", {
+        method: "POST",
+        body: JSON.stringify(body),
+    });
+    // Update ledger
+    await writeLedger(opts.repoRoot, {
+        ...ledger,
+        project_id: projectId,
+        repo: repoMeta,
+        last_synced_at: Date.now(),
+    });
+    console.log(kleur.green("✓"), `repo ${out.repo_id} — ${out.pages_written} pages, ${out.links_written} links, ${out.files_indexed} file refs.`);
+    return 0;
+}
+async function detectRepoMeta(repoRoot) {
+    // Best-effort git introspection without shelling out — read .git/config
+    // and .git/HEAD. If anything fails, fall back to root path as remote_url.
+    try {
+        const cfg = await readFile(resolve(repoRoot, ".git/config"), "utf8");
+        const m = cfg.match(/url\s*=\s*([^\s]+)/);
+        const head = await readFile(resolve(repoRoot, ".git/HEAD"), "utf8");
+        const branch = head.startsWith("ref:") ? head.slice(5).trim().split("/").pop() : undefined;
+        return {
+            remote_url: m?.[1] ?? `file://${resolve(repoRoot)}`,
+            branch,
+            root_name: resolve(repoRoot).split("/").pop(),
+        };
+    }
+    catch {
+        return {
+            remote_url: `file://${resolve(repoRoot)}`,
+            root_name: resolve(repoRoot).split("/").pop(),
+        };
+    }
+}
+//# sourceMappingURL=ingest.js.map

package/dist/cli/commands/ingest.js.map

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

package/dist/cli/commands/install.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `ricord install [--uninstall]` — manage the optional macOS launchd
+ * transcript daemon (F1 / S6).
+ *
+ * Writes a LaunchAgent plist at
+ *   ~/Library/LaunchAgents/ai.ricord.sync.plist
+ * that fires `ricord sync` every 5 minutes against the user's recorded
+ * workspaces. Idempotent.
+ *
+ * Linux is not yet supported; emit a friendly message.
+ */
+interface InstallOpts {
+    uninstall: boolean;
+}
+export declare function installCommand(opts: InstallOpts): Promise<number>;
+export {};

package/dist/cli/commands/install.js

@@ -0,0 +1,82 @@
+/**
+ * `ricord install [--uninstall]` — manage the optional macOS launchd
+ * transcript daemon (F1 / S6).
+ *
+ * Writes a LaunchAgent plist at
+ *   ~/Library/LaunchAgents/ai.ricord.sync.plist
+ * that fires `ricord sync` every 5 minutes against the user's recorded
+ * workspaces. Idempotent.
+ *
+ * Linux is not yet supported; emit a friendly message.
+ */
+import { writeFile, mkdir, unlink } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { homedir, platform } from "node:os";
+import { join, dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import kleur from "kleur";
+const PLIST_LABEL = "ai.ricord.sync";
+function plistPath() {
+    return join(homedir(), "Library", "LaunchAgents", `${PLIST_LABEL}.plist`);
+}
+function plistBody(nodePath, scriptPath) {
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key><string>${PLIST_LABEL}</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>${nodePath}</string>
+    <string>${scriptPath}</string>
+    <string>sync</string>
+  </array>
+  <key>StartInterval</key><integer>300</integer>
+  <key>RunAtLoad</key><true/>
+  <key>StandardOutPath</key><string>${join(homedir(), ".ricord", "logs", "sync.out.log")}</string>
+  <key>StandardErrorPath</key><string>${join(homedir(), ".ricord", "logs", "sync.err.log")}</string>
+</dict>
+</plist>
+`;
+}
+/** Resolve the absolute path to the `bin/ricord.js` shim shipped in this
+ *  package. Works both when installed globally (`bun install -g`) and when
+ *  consumed via `bun link` from a checkout. */
+function resolveRicordScript() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    // dist/commands/install.js → ../../bin/ricord.js
+    return resolve(here, "..", "..", "bin", "ricord.js");
+}
+export async function installCommand(opts) {
+    if (platform() !== "darwin") {
+        console.error(kleur.red("daemon install only supports macOS in this release. Use `ricord sync` from cron on Linux."));
+        return 1;
+    }
+    const target = plistPath();
+    if (opts.uninstall) {
+        if (existsSync(target)) {
+            await unlink(target);
+            console.log(kleur.green("✓"), `removed ${target}`);
+            console.log(kleur.dim("then run: launchctl unload ~/Library/LaunchAgents/ai.ricord.sync.plist"));
+        }
+        else {
+            console.log(kleur.yellow("nothing to uninstall."));
+        }
+        return 0;
+    }
+    await mkdir(join(homedir(), "Library", "LaunchAgents"), { recursive: true });
+    await mkdir(join(homedir(), ".ricord", "logs"), { recursive: true });
+    const nodePath = process.execPath;
+    const scriptPath = resolveRicordScript();
+    if (!existsSync(scriptPath)) {
+        console.error(kleur.red(`could not find ricord shim at ${scriptPath}`));
+        return 1;
+    }
+    await writeFile(target, plistBody(nodePath, scriptPath), "utf8");
+    console.log(kleur.green("✓"), `wrote ${target}`);
+    console.log(kleur.dim(`  node:   ${nodePath}`));
+    console.log(kleur.dim(`  script: ${scriptPath}`));
+    console.log(kleur.dim("then run: launchctl load ~/Library/LaunchAgents/ai.ricord.sync.plist"));
+    return 0;
+}
+//# sourceMappingURL=install.js.map

package/dist/cli/commands/install.js.map

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

package/dist/cli/commands/pull.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `ricord pull [--out .ricord/pages/] [--merge] [--force]` — pull cloud
+ * pages onto local disk (F6 / S7 / G11 tick 28).
+ *
+ * Three modes:
+ *   default — write a fresh page if absent; SKIP if already on disk
+ *   --force — overwrite local files unconditionally
+ *   --merge — for any file that exists locally AND has been edited since
+ *             ledger.last_pulled_at, write the server copy as
+ *             `<slug>.cloud.md` next to the local file so the user can
+ *             diff + reconcile manually. Otherwise overwrite (cloud wins
+ *             when there's no local change since the last pull).
+ *
+ * On success, advances ledger.last_pulled_at.
+ */
+interface PullOpts {
+    repoRoot: string;
+    out: string;
+    projectId?: string;
+    force?: boolean;
+    merge?: boolean;
+}
+export declare function pullCommand(opts: PullOpts): Promise<number>;
+export {};