ricord 1.0.0

package/dist/cli/commands/pull.js

@@ -0,0 +1,104 @@
+/**
+ * `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.
+ */
+import { mkdir, writeFile, rename, stat } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { join, resolve } from "node:path";
+import kleur from "kleur";
+import { resolveAuth } from "../config.js";
+import { request } from "../client.js";
+import { readLedger, writeLedger } from "../ledger.js";
+export async function pullCommand(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)}` : "";
+    const data = await request(auth, `/v1/kb/export${qs}`);
+    const outDir = resolve(opts.repoRoot, opts.out);
+    await mkdir(outDir, { recursive: true });
+    // Index lives at the same dir level as pages — local-first default
+    // writes to `.ricord/pages/` so the README goes to .ricord/README.md
+    // instead of clobbering the per-repo README. Pull `--out wiki/` keeps
+    // the legacy index-in-out-dir behavior.
+    const indexTarget = opts.out === ".ricord/pages"
+        ? join(opts.repoRoot, ".ricord", "README.md")
+        : join(outDir, "README.md");
+    await writeFile(indexTarget, data.index ?? "", "utf8");
+    const lastPulledAt = ledger.last_pulled_at ?? 0;
+    let wrote = 0;
+    let skippedExisting = 0;
+    let conflicts = 0;
+    for (const p of data.pages ?? []) {
+        // Strip server's "pages/" prefix when --out already targets a pages dir.
+        const rel = opts.out.endsWith("/pages") || opts.out === ".ricord/pages"
+            ? p.path.replace(/^pages\//, "")
+            : p.path;
+        const target = join(outDir, rel);
+        await mkdir(resolve(target, ".."), { recursive: true });
+        if (existsSync(target)) {
+            if (opts.force) {
+                // overwrite
+            }
+            else if (opts.merge) {
+                // Conflict if local mtime is newer than the last pull (user edited
+                // since last pull) — write a sidecar instead of overwriting.
+                const st = await stat(target).catch(() => null);
+                const localChangedSinceLastPull = st && st.mtimeMs > lastPulledAt;
+                if (localChangedSinceLastPull) {
+                    const sidecar = target.replace(/\.md$/, ".cloud.md");
+                    const tmp = `${sidecar}.tmp.${process.pid}`;
+                    await writeFile(tmp, p.content, "utf8");
+                    await rename(tmp, sidecar);
+                    conflicts++;
+                    console.log(kleur.yellow(`  ⚡ conflict: ${rel} — server copy at ${rel.replace(/\.md$/, ".cloud.md")}`));
+                    continue;
+                }
+                // safe overwrite — local untouched since last pull
+            }
+            else {
+                skippedExisting++;
+                continue;
+            }
+        }
+        const tmp = `${target}.tmp.${process.pid}`;
+        await writeFile(tmp, p.content, "utf8");
+        await rename(tmp, target);
+        wrote++;
+    }
+    // topics.yaml mirror — write to .ricord/topics.yaml when --out is the
+    // canonical local-first path.
+    if (data.topics_yaml && opts.out === ".ricord/pages") {
+        const tPath = join(opts.repoRoot, ".ricord", "topics.yaml");
+        if (!existsSync(tPath) || opts.force) {
+            await writeFile(tPath, data.topics_yaml, "utf8");
+        }
+    }
+    await writeLedger(opts.repoRoot, {
+        ...ledger,
+        project_id: projectId,
+        last_pulled_at: Date.now(),
+    });
+    const parts = [`wrote ${wrote}`];
+    if (skippedExisting > 0)
+        parts.push(`skipped ${skippedExisting} existing`);
+    if (conflicts > 0)
+        parts.push(kleur.yellow(`${conflicts} conflict${conflicts === 1 ? "" : "s"}`));
+    console.log(kleur.green("✓"), parts.join(", ") + ` → ${opts.out}/`);
+    if (conflicts > 0) {
+        console.log(kleur.dim("  resolve: diff <slug>.md vs <slug>.cloud.md, keep one, delete the other."));
+    }
+    return 0;
+}
+//# sourceMappingURL=pull.js.map

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

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

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

@@ -0,0 +1,28 @@
+/**
+ * `ricord push [--from .ricord/pages/] [--all]` — local-first sync to
+ * the cloud mirror (G11 tick 25).
+ *
+ * Reads every .md under <from> whose mtime > ledger.last_pushed_at,
+ * parses YAML frontmatter, POSTs to /v1/kb/import. Server accepts
+ * `id` (preferred) or `slug` lookup. Successful runs advance the
+ * pushed-at watermark in the ledger.
+ *
+ * `--all` ignores the watermark and pushes every file (use after a
+ * clean clone or when the ledger is fresh).
+ */
+interface PushOpts {
+    repoRoot: string;
+    from: string;
+    projectId?: string;
+    /** Optional team UUID override. When set, pages land in the
+     *  (team_id, project_id) team space instead of personal. Falls back to
+     *  the team_id recorded in the ledger by `ricord init --team`. */
+    teamId?: string;
+    /** Force personal scope on this push even if the ledger has a team_id —
+     *  used to take a personal snapshot of a team-bound repo. */
+    noTeam?: boolean;
+    dryRun: boolean;
+    all?: boolean;
+}
+export declare function pushCommand(opts: PushOpts): Promise<number>;
+export {};

package/dist/cli/commands/push.js

@@ -0,0 +1,164 @@
+/**
+ * `ricord push [--from .ricord/pages/] [--all]` — local-first sync to
+ * the cloud mirror (G11 tick 25).
+ *
+ * Reads every .md under <from> whose mtime > ledger.last_pushed_at,
+ * parses YAML frontmatter, POSTs to /v1/kb/import. Server accepts
+ * `id` (preferred) or `slug` lookup. Successful runs advance the
+ * pushed-at watermark in the ledger.
+ *
+ * `--all` ignores the watermark and pushes every file (use after a
+ * clean clone or when the ledger is fresh).
+ */
+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, writeLedger } from "../ledger.js";
+function parseDoc(text) {
+    if (!text.startsWith("---")) {
+        return { body: text, frontmatter: {} };
+    }
+    const end = text.indexOf("\n---", 3);
+    if (end === -1)
+        return { body: text, frontmatter: {} };
+    const fmRaw = text.slice(3, end).trim();
+    const body = text.slice(end + 4).replace(/^\s*\n/, "");
+    const frontmatter = {};
+    const lines = fmRaw.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const m = line.match(/^([A-Za-z_][A-Za-z0-9_]*):\s*(.*)$/);
+        if (!m)
+            continue;
+        const [, k, vRaw] = m;
+        if (vRaw && vRaw.startsWith("[") && vRaw.endsWith("]")) {
+            // YAML inline array: [a, "b", c]
+            const inner = vRaw.slice(1, -1).trim();
+            if (inner.length === 0) {
+                frontmatter[k] = [];
+            }
+            else {
+                frontmatter[k] = inner.split(",").map((s) => s.trim().replace(/^["']|["']$/g, "")).filter(Boolean);
+            }
+        }
+        else if (vRaw === "" || vRaw === undefined) {
+            // YAML block list: peek ahead for `  - item` lines.
+            const items = [];
+            while (i + 1 < lines.length) {
+                const next = lines[i + 1];
+                const bm = next.match(/^\s+-\s+(.*)$/);
+                if (!bm)
+                    break;
+                items.push(bm[1].trim().replace(/^["']|["']$/g, ""));
+                i++;
+            }
+            if (items.length > 0)
+                frontmatter[k] = items;
+        }
+        else if (vRaw && (vRaw.startsWith("\"") || vRaw.startsWith("'"))) {
+            frontmatter[k] = vRaw.slice(1, -1);
+        }
+        else {
+            frontmatter[k] = vRaw;
+        }
+    }
+    const topicsRaw = frontmatter.topics;
+    const topics = Array.isArray(topicsRaw) ? topicsRaw.filter((t) => typeof t === "string") : undefined;
+    const filesRaw = frontmatter.files;
+    const files = Array.isArray(filesRaw) ? filesRaw.filter((f) => typeof f === "string") : undefined;
+    return {
+        id: typeof frontmatter.id === "string" ? frontmatter.id : undefined,
+        slug: typeof frontmatter.slug === "string" ? frontmatter.slug : undefined,
+        title: typeof frontmatter.title === "string" ? frontmatter.title : undefined,
+        summary: typeof frontmatter.summary === "string" ? frontmatter.summary : undefined,
+        type: typeof frontmatter.type === "string" ? frontmatter.type : undefined,
+        topics,
+        files,
+        body,
+        frontmatter,
+    };
+}
+export async function pushCommand(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 not recorded; run `ricord init --project <id>` first."));
+        return 1;
+    }
+    // Resolve team scope. Precedence: --no-team wins (force personal) →
+    // --team <id> flag → ledger.team_id. The server validates membership and
+    // rejects a 403 if the caller isn't in the team, so a stale ledger never
+    // silently leaks data into a team space the caller doesn't belong to.
+    const teamId = opts.noTeam ? undefined : (opts.teamId ?? ledger.team_id);
+    const dir = resolve(opts.repoRoot, opts.from);
+    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 ${opts.from}/`));
+        return 0;
+    }
+    const watermark = opts.all ? 0 : (ledger.last_pushed_at ?? 0);
+    const docs = [];
+    let totalScanned = 0;
+    let gatedOut = 0;
+    for (const f of mds) {
+        totalScanned++;
+        const fullPath = join(dir, f);
+        if (!opts.all && watermark > 0) {
+            const st = await stat(fullPath).catch(() => null);
+            if (st && st.mtimeMs <= watermark) {
+                gatedOut++;
+                continue;
+            }
+        }
+        const text = await readFile(fullPath, "utf8");
+        const d = parseDoc(text);
+        if (!d.slug)
+            d.slug = f.replace(/\.md$/, "");
+        docs.push(d);
+    }
+    if (docs.length === 0) {
+        console.log(kleur.dim(`nothing to push — ${totalScanned} files on disk, ${gatedOut} unchanged since last push` +
+            (opts.all ? "" : " (use --all to force)")));
+        return 0;
+    }
+    if (opts.dryRun) {
+        console.log(kleur.dim(`would push ${docs.length} of ${totalScanned} pages:`));
+        for (const d of docs)
+            console.log(kleur.dim(`  ${d.slug}${d.id ? ` (id ${d.id.slice(0, 8)})` : ""}`));
+        return 0;
+    }
+    const out = await request(auth, "/v1/kb/import", {
+        method: "POST",
+        body: JSON.stringify({
+            project_id: projectId,
+            ...(teamId ? { team_id: teamId } : {}),
+            pages: docs,
+        }),
+    });
+    console.log(kleur.green("✓"), `imported ${out.imported}, skipped ${out.skipped}` +
+        (gatedOut > 0 ? kleur.dim(` (gated out ${gatedOut} unchanged)`) : "") +
+        (out.errors.length > 0 ? `, ${out.errors.length} error${out.errors.length === 1 ? "" : "s"}` : ""));
+    for (const e of out.errors) {
+        console.log(kleur.red(`  ${e.slug ?? "?"}: ${e.message}`));
+    }
+    // Advance watermark even on partial success so the next push doesn't
+    // re-send files the server already accepted. Files in the error list
+    // will be retried on the next push because their mtime stays.
+    if (out.imported > 0) {
+        await writeLedger(opts.repoRoot, {
+            ...ledger,
+            project_id: projectId,
+            // Persist team_id if it was passed via flag — keeps the ledger in
+            // sync with what just shipped, so later pushes don't drift.
+            // --no-team is a one-shot override; we don't erase a persisted team_id.
+            team_id: opts.noTeam ? ledger.team_id : (teamId ?? ledger.team_id),
+            last_pushed_at: Date.now(),
+        });
+    }
+    return out.errors.length === 0 ? 0 : 2;
+}
+//# sourceMappingURL=push.js.map

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

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

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

@@ -0,0 +1,21 @@
+/**
+ * `ricord rollup [--limit N] [--min-sources N] [--push]` — local-first
+ * page authoring. Drains the cloud's stub backlog by running a host LLM
+ * (Gemini → OpenAI fallback) over each empty page's sources, then writes
+ * the rolled-up markdown directly to `.ricord/pages/<slug>.md`.
+ *
+ * With `--push` (not implemented this tick; tick 25): also POSTs to
+ * `/v1/kb/pages/:id/body` so the server mirror updates in the same run.
+ *
+ * Why: local files are now the source of truth (G11 pivot). This is
+ * how an existing cloud account gets bootstrapped into the local layout
+ * for ongoing edits.
+ */
+interface RollupOpts {
+    repoRoot: string;
+    limit: number;
+    minSources: number;
+    push: boolean;
+}
+export declare function rollupCommand(opts: RollupOpts): Promise<number>;
+export {};

package/dist/cli/commands/rollup.js

@@ -0,0 +1,118 @@
+/**
+ * `ricord rollup [--limit N] [--min-sources N] [--push]` — local-first
+ * page authoring. Drains the cloud's stub backlog by running a host LLM
+ * (Gemini → OpenAI fallback) over each empty page's sources, then writes
+ * the rolled-up markdown directly to `.ricord/pages/<slug>.md`.
+ *
+ * With `--push` (not implemented this tick; tick 25): also POSTs to
+ * `/v1/kb/pages/:id/body` so the server mirror updates in the same run.
+ *
+ * Why: local files are now the source of truth (G11 pivot). This is
+ * how an existing cloud account gets bootstrapped into the local layout
+ * for ongoing edits.
+ */
+import { existsSync } from "node:fs";
+import { mkdir, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import kleur from "kleur";
+import { resolveAuth } from "../config.js";
+import { request } from "../client.js";
+import { readLedger, ledgerDir } from "../ledger.js";
+import { callHostLLM } from "../llm.js";
+// Slim schema — the full PAGE_ROLLUP schema blows past Gemini's effective
+// generation budget at 16k tokens. Body is the only field we need for
+// search recall + the local markdown file.
+const SLIM_SCHEMA = {
+    type: "object",
+    required: ["title", "summary", "body"],
+    properties: {
+        title: { type: "string" },
+        summary: { type: "string" },
+        body: { type: "string" },
+        insufficient_sources: { type: "boolean" },
+        reason: { type: "string" },
+    },
+};
+function slugify(s) {
+    return s.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") || "page";
+}
+function frontmatter(stub, out, slug) {
+    const title = (out.title ?? stub.title ?? stub.anchor_value).replace(/"/g, '\\"');
+    const summary = JSON.stringify(out.summary ?? "");
+    return [
+        "---",
+        `id: ${stub.id}`,
+        `slug: ${slug}`,
+        `title: ${title}`,
+        `summary: ${summary}`,
+        `type: ${stub.anchor_type}`,
+        `anchor: ${stub.anchor_value.replace(/"/g, '\\"')}`,
+        `source_count: ${stub.source_count}`,
+        "tags: []",
+        "topics: []",
+        "files: []",
+        "---",
+        "",
+        `# ${out.title ?? stub.title ?? stub.anchor_value}`,
+        "",
+        out.body ?? "",
+        "",
+    ].join("\n");
+}
+export async function rollupCommand(opts) {
+    const ledger = await readLedger(opts.repoRoot);
+    if (!ledger.project_id) {
+        console.error(kleur.red("project_id not recorded — run `ricord init --project <id>` first."));
+        return 1;
+    }
+    const pagesDir = join(ledgerDir(opts.repoRoot), "pages");
+    await mkdir(pagesDir, { recursive: true });
+    const auth = await resolveAuth();
+    const stubsPath = `/v1/kb/pages/stubs?limit=${opts.limit}&min_sources=${opts.minSources}`;
+    const stubs = await request(auth, stubsPath);
+    console.log(kleur.dim(`[rollup] ${stubs.count} stub${stubs.count === 1 ? "" : "s"} found (limit=${opts.limit}, min_sources=${opts.minSources})`));
+    if (stubs.count === 0)
+        return 0;
+    let wrote = 0;
+    let failed = 0;
+    let skippedExisting = 0;
+    for (const stub of stubs.stubs) {
+        const label = `[${stub.anchor_type}] ${stub.title || stub.anchor_value} (${stub.source_count} src)`;
+        try {
+            const prompt = await request(auth, `/v1/kb/pages/${stub.id}/rollup-prompt`);
+            const out = await callHostLLM(prompt.prompt, SLIM_SCHEMA);
+            if (out.insufficient_sources || !out.body) {
+                console.log(`  SKIP ${label} — model said insufficient sources`);
+                continue;
+            }
+            const slug = slugify(out.title ?? stub.title ?? stub.anchor_value);
+            const target = join(pagesDir, `${slug}.md`);
+            if (existsSync(target)) {
+                skippedExisting++;
+                console.log(`  SKIP ${label} — ${slug}.md already on disk (use \`ricord pull --force\` to overwrite)`);
+                continue;
+            }
+            // Clamp lengths to server schema caps so a future --push lands cleanly.
+            if (out.title)
+                out.title = out.title.slice(0, 200);
+            if (out.summary)
+                out.summary = out.summary.slice(0, 2000);
+            if (out.body)
+                out.body = out.body.slice(0, 16000);
+            await writeFile(target, frontmatter(stub, out, slug), "utf8");
+            console.log(`  OK   ${label} → .ricord/pages/${slug}.md (${(out.body ?? "").length} chars)`);
+            wrote++;
+            // tick 25 will use this to also POST the body.
+            if (opts.push) {
+                // placeholder hook so the --push flag parses today; tick 25 wires it.
+            }
+        }
+        catch (e) {
+            console.log(`  FAIL ${label} — ${e.message}`);
+            failed++;
+        }
+    }
+    console.log(kleur.green(`[rollup] done. wrote=${wrote} skipped=${skippedExisting} failed=${failed}`));
+    return failed > 0 && wrote === 0 ? 1 : 0;
+}
+//# sourceMappingURL=rollup.js.map

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

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

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

@@ -0,0 +1,7 @@
+/**
+ * `ricord setup` — interactive (TTY) or env-driven (non-TTY) auth setup.
+ *
+ * Writes ~/.ricord/config.json with api_key + api_url. Non-interactive
+ * if both RICORD_API_KEY and (optionally) RICORD_API_URL are set.
+ */
+export declare function setupCommand(): Promise<number>;

package/dist/cli/commands/setup.js

@@ -0,0 +1,43 @@
+/**
+ * `ricord setup` — interactive (TTY) or env-driven (non-TTY) auth setup.
+ *
+ * Writes ~/.ricord/config.json with api_key + api_url. Non-interactive
+ * if both RICORD_API_KEY and (optionally) RICORD_API_URL are set.
+ */
+import { createInterface } from "node:readline/promises";
+import { stdin, stdout } from "node:process";
+import kleur from "kleur";
+import { readConfig, writeConfig } from "../config.js";
+async function prompt(label, fallback) {
+    const rl = createInterface({ input: stdin, output: stdout });
+    try {
+        const ans = await rl.question(`${label}${fallback ? ` (${fallback})` : ""}: `);
+        return ans.trim() || (fallback ?? "");
+    }
+    finally {
+        rl.close();
+    }
+}
+export async function setupCommand() {
+    const existing = await readConfig();
+    let apiKey = process.env.RICORD_API_KEY ?? "";
+    let apiUrl = process.env.RICORD_API_URL ?? existing.api_url ?? "https://api.ricord.ai";
+    if (!apiKey) {
+        if (!stdin.isTTY) {
+            console.error(kleur.red("Non-interactive setup needs RICORD_API_KEY in the environment."));
+            return 1;
+        }
+        console.log(kleur.bold("ricord setup"));
+        console.log(kleur.dim("Find your API key at https://ricord.ai/dashboard/api-keys"));
+        apiKey = await prompt("API key (rc_live_…)", existing.api_key);
+    }
+    if (!apiKey || !apiKey.startsWith("rc_live_")) {
+        console.error(kleur.red(`API key looks wrong — expected prefix "rc_live_".`));
+        return 1;
+    }
+    await writeConfig({ ...existing, api_key: apiKey, api_url: apiUrl });
+    console.log(kleur.green("✓ saved"), kleur.dim(`~/.ricord/config.json`));
+    console.log(kleur.dim(`api_url: ${apiUrl}`));
+    return 0;
+}
+//# sourceMappingURL=setup.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../../src/cli/commands/setup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEvD,KAAK,UAAU,MAAM,CAAC,KAAa,EAAE,QAAiB;IACpD,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,GAAG,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QAC/E,OAAO,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,MAAM,QAAQ,GAAG,MAAM,UAAU,EAAE,CAAC;IACpC,IAAI,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC;IAC9C,IAAI,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,QAAQ,CAAC,OAAO,IAAI,uBAAuB,CAAC;IAEvF,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACjB,OAAO,CAAC,KAAK,CACX,KAAK,CAAC,GAAG,CAAC,gEAAgE,CAAC,CAC5E,CAAC;YACF,OAAO,CAAC,CAAC;QACX,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAC,CAAC;QACpF,MAAM,GAAG,MAAM,MAAM,CAAC,qBAAqB,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IACjE,CAAC;IAED,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9C,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC,CAAC;QAC9E,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,WAAW,CAAC,EAAE,GAAG,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IACrE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC,CAAC;IACxE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,MAAM,EAAE,CAAC,CAAC,CAAC;IAC7C,OAAO,CAAC,CAAC;AACX,CAAC"}

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

@@ -0,0 +1,15 @@
+/**
+ * `ricord sync` — incremental sync that picks up where the daemon (F1)
+ * normally would. Idempotent; safe to run repeatedly.
+ *
+ * Phase 1 (this slice): wraps `ingest` with the ledger's last_synced_at
+ * gate. Only re-ingests files whose mtime > last_synced_at.
+ *
+ * Phase 2 (S6 daemon): becomes the work loop the launchd plist fires.
+ */
+interface SyncOpts {
+    repoRoot: string;
+    projectId?: string;
+}
+export declare function syncCommand(opts: SyncOpts): Promise<number>;
+export {};

package/dist/cli/commands/sync.js

@@ -0,0 +1,63 @@
+/**
+ * `ricord sync` — incremental sync that picks up where the daemon (F1)
+ * normally would. Idempotent; safe to run repeatedly.
+ *
+ * Phase 1 (this slice): wraps `ingest` with the ledger's last_synced_at
+ * gate. Only re-ingests files whose mtime > last_synced_at.
+ *
+ * Phase 2 (S6 daemon): becomes the work loop the launchd plist fires.
+ */
+import { 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 syncCommand(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 not recorded — run `ricord ingest --project <id>` once first."));
+        return 1;
+    }
+    const since = ledger.last_synced_at ?? 0;
+    const all = await walkRepo(opts.repoRoot);
+    const changed = [];
+    for (const f of all) {
+        try {
+            const s = await stat(f.absPath);
+            if (s.mtimeMs > since)
+                changed.push(f.absPath);
+        }
+        catch {
+            // skip
+        }
+    }
+    if (changed.length === 0) {
+        console.log(kleur.dim("nothing changed since last sync."));
+        return 0;
+    }
+    console.log(kleur.bold(`syncing ${changed.length} changed file${changed.length === 1 ? "" : "s"}…`));
+    const body = {
+        project_id: projectId,
+        repo: { remote_url: `file://${resolve(opts.repoRoot)}` },
+        batches: [
+            {
+                cluster_name: "sync",
+                files: changed.slice(0, 500).map((p) => ({ path: relative(opts.repoRoot, p) })),
+                extracted: { anchors: [] },
+                extraction_meta: { client: "ricord-cli/sync" },
+            },
+        ],
+    };
+    const out = await request(auth, "/v1/ingest/repo", {
+        method: "POST",
+        body: JSON.stringify(body),
+    });
+    await writeLedger(opts.repoRoot, { ...ledger, project_id: projectId, last_synced_at: Date.now() });
+    console.log(kleur.green("✓"), `${out.files_indexed} file refs synced (repo ${out.repo_id}).`);
+    return 0;
+}
+//# sourceMappingURL=sync.js.map

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

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

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

@@ -0,0 +1,17 @@
+/**
+ * `ricord watch [--from .ricord/pages/]` — file watcher that auto-pushes
+ * markdown edits to the cloud mirror (G11 tick 26).
+ *
+ * Uses node:fs.watch (no chokidar dep). Edits are coalesced with a 1.5s
+ * debounce so a save burst from an editor doesn't trigger N pushes.
+ * Each fire calls pushCommand which mtime-gates against the ledger.
+ *
+ * Ctrl-C exits cleanly.
+ */
+interface WatchOpts {
+    repoRoot: string;
+    from: string;
+    projectId?: string;
+}
+export declare function watchCommand(opts: WatchOpts): Promise<number>;
+export {};