ricord 1.0.0

package/dist/cli/commands/watch.js

@@ -0,0 +1,87 @@
+/**
+ * `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.
+ */
+import { watch } from "node:fs";
+import { resolve } from "node:path";
+import { existsSync } from "node:fs";
+import kleur from "kleur";
+import { pushCommand } from "./push.js";
+const DEBOUNCE_MS = 1500;
+export async function watchCommand(opts) {
+    const dir = resolve(opts.repoRoot, opts.from);
+    if (!existsSync(dir)) {
+        console.error(kleur.red(`watch dir not found: ${dir}`));
+        return 1;
+    }
+    console.log(kleur.green("ricord watch"), kleur.dim(`watching ${opts.from} (debounce ${DEBOUNCE_MS}ms)`));
+    console.log(kleur.dim("ctrl-c to stop"));
+    let pending = null;
+    let inflight = false;
+    let queued = false;
+    const fire = async () => {
+        if (inflight) {
+            queued = true;
+            return;
+        }
+        inflight = true;
+        try {
+            await pushCommand({
+                repoRoot: opts.repoRoot,
+                from: opts.from,
+                projectId: opts.projectId,
+                dryRun: false,
+                all: false,
+            });
+        }
+        catch (e) {
+            console.error(kleur.red(`push failed: ${e.message}`));
+        }
+        finally {
+            inflight = false;
+            if (queued) {
+                queued = false;
+                schedule();
+            }
+        }
+    };
+    function schedule() {
+        if (pending)
+            clearTimeout(pending);
+        pending = setTimeout(() => {
+            pending = null;
+            void fire();
+        }, DEBOUNCE_MS);
+    }
+    let watcher;
+    try {
+        watcher = watch(dir, { persistent: true }, (event, filename) => {
+            if (!filename || !filename.endsWith(".md"))
+                return;
+            console.log(kleur.dim(`  ${event} ${filename} — scheduling push`));
+            schedule();
+        });
+    }
+    catch (e) {
+        console.error(kleur.red(`watch failed: ${e.message}`));
+        return 1;
+    }
+    return await new Promise((res) => {
+        const onSig = () => {
+            watcher.close();
+            if (pending)
+                clearTimeout(pending);
+            console.log(kleur.dim("\nwatch stopped."));
+            res(0);
+        };
+        process.once("SIGINT", onSig);
+        process.once("SIGTERM", onSig);
+    });
+}
+//# sourceMappingURL=watch.js.map

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

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

package/dist/cli/config.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Config + auth resolution for the ricord CLI.
+ *
+ * Lookup order for the API key:
+ *   1. RICORD_API_KEY env var
+ *   2. ~/.ricord/config.json {"api_key": "rc_live_..."}
+ *
+ * Lookup order for the API base URL:
+ *   1. RICORD_API_URL env var
+ *   2. ~/.ricord/config.json {"api_url": "..."}
+ *   3. https://api.ricord.ai
+ *
+ * Config dir is gitignored by convention (top-level .gitignore in
+ * ricord-ai already covers `.ricord/`).
+ */
+export interface RicordConfig {
+    api_key?: string;
+    api_url?: string;
+    default_project_id?: string;
+}
+export declare function configDir(): string;
+export declare function configPath(): string;
+export declare function readConfig(): Promise<RicordConfig>;
+export declare function writeConfig(next: RicordConfig): Promise<void>;
+export interface ResolvedAuth {
+    apiKey: string;
+    apiUrl: string;
+}
+export declare function resolveAuth(): Promise<ResolvedAuth>;

package/dist/cli/config.js

@@ -0,0 +1,52 @@
+/**
+ * Config + auth resolution for the ricord CLI.
+ *
+ * Lookup order for the API key:
+ *   1. RICORD_API_KEY env var
+ *   2. ~/.ricord/config.json {"api_key": "rc_live_..."}
+ *
+ * Lookup order for the API base URL:
+ *   1. RICORD_API_URL env var
+ *   2. ~/.ricord/config.json {"api_url": "..."}
+ *   3. https://api.ricord.ai
+ *
+ * Config dir is gitignored by convention (top-level .gitignore in
+ * ricord-ai already covers `.ricord/`).
+ */
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+const DEFAULT_API_URL = "https://api.ricord.ai";
+export function configDir() {
+    return join(homedir(), ".ricord");
+}
+export function configPath() {
+    return join(configDir(), "config.json");
+}
+export async function readConfig() {
+    const p = configPath();
+    if (!existsSync(p))
+        return {};
+    try {
+        const raw = await readFile(p, "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+export async function writeConfig(next) {
+    await mkdir(configDir(), { recursive: true });
+    await writeFile(configPath(), JSON.stringify(next, null, 2) + "\n", "utf8");
+}
+export async function resolveAuth() {
+    const cfg = await readConfig();
+    const apiKey = process.env.RICORD_API_KEY ?? cfg.api_key ?? "";
+    const apiUrl = process.env.RICORD_API_URL ?? cfg.api_url ?? DEFAULT_API_URL;
+    if (!apiKey) {
+        throw new Error("No API key found. Run `ricord setup` or set RICORD_API_KEY in your shell.");
+    }
+    return { apiKey, apiUrl };
+}
+//# sourceMappingURL=config.js.map

package/dist/cli/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/cli/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAQjC,MAAM,eAAe,GAAG,uBAAuB,CAAC;AAEhD,MAAM,UAAU,SAAS;IACvB,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,IAAI,CAAC,SAAS,EAAE,EAAE,aAAa,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,MAAM,CAAC,GAAG,UAAU,EAAE,CAAC;IACvB,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAC9B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QACtC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAiB,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAkB;IAClD,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,MAAM,SAAS,CAAC,UAAU,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;AAC9E,CAAC;AAOD,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,GAAG,GAAG,MAAM,UAAU,EAAE,CAAC;IAC/B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;IAC/D,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,GAAG,CAAC,OAAO,IAAI,eAAe,CAAC;IAC5E,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,2EAA2E,CAC5E,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC5B,CAAC"}

package/dist/cli/extract.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Client-side extraction for `ricord init`.
+ *
+ * Post-2026-05-12 the Ricord server runs zero generative LLM calls — clients
+ * own anchor/connection/task extraction. This module wires the CLI into that
+ * flow: fetch the canonical extraction prompt from /v1/extraction/prompt,
+ * run it through the caller's LLM, and POST the structured result to
+ * /v1/ingest/extracted.
+ *
+ * Provider auto-detect at startup: OPENAI_API_KEY (default, gpt-4o) or
+ * ANTHROPIC_API_KEY (claude-sonnet-4-6). One key is enough.
+ */
+export interface Anchor {
+    type: "entity" | "topic" | "epoch";
+    subtype?: string;
+    value: string;
+    aliases?: string[];
+    confidence: number;
+}
+export interface Connection {
+    source: string;
+    target: string;
+    relation: "mentions" | "relates_to" | "supersedes" | "contradicts" | "caused_by" | "part_of" | "derived_from";
+    relationship?: string;
+    strength: number;
+    valid_at?: string | number | null;
+    invalid_at?: string | number | null;
+}
+export interface Task {
+    text: string;
+    priority?: "low" | "normal" | "high";
+    due_date?: string;
+    related_anchor?: string;
+}
+export interface Extracted {
+    anchors: Anchor[];
+    connections: Connection[];
+    tasks: Task[];
+}
+export interface ExtractionPromptResponse {
+    schema_version: number;
+    prompt: string;
+    output_schema: unknown;
+    submit_url: string;
+    caps: {
+        max_messages: number;
+        max_total_chars: number;
+        max_anchors: number;
+        max_connections: number;
+        max_tasks: number;
+    };
+}
+export type LlmProvider = "openai" | "anthropic";
+export interface LlmConfig {
+    provider: LlmProvider;
+    model: string;
+    apiKey: string;
+}
+export type LlmFn = (prompt: string) => Promise<string>;
+export interface ExtractIngestConfig {
+    apiBase: string;
+    token: string;
+}
+export interface ExtractedIngestResult {
+    ok: boolean;
+    status: number;
+    pagesWritten: number;
+    linksWritten: number;
+    tasksWritten: number;
+    body: unknown;
+}
+/**
+ * Resolve LLM provider + key from explicit flags or env. Throws with a clear
+ * message if no usable key is found — the CLI surfaces this at startup so the
+ * user fixes it before we walk the repo.
+ */
+export declare function resolveLlmConfig(opts: {
+    modelFlag?: string;
+    keyFlag?: string;
+}): LlmConfig;
+export declare function makeLlmFn(cfg: LlmConfig): LlmFn;
+export declare function fetchExtractionPrompt(cfg: ExtractIngestConfig): Promise<ExtractionPromptResponse>;
+export declare function runExtraction(llm: LlmFn, promptTemplate: string, text: string): Promise<Extracted>;
+/**
+ * POST extracted anchors/connections/tasks to /v1/ingest/extracted. The route
+ * embeds the raw bundle text on its end (Vertex, $0.025/1M) so the bundle is
+ * still searchable; we just don't pay for generative extraction on the server.
+ */
+export declare function postExtracted(cfg: ExtractIngestConfig, payload: {
+    dirRel: string;
+    bundleText: string;
+    extracted: Extracted;
+    repo: string;
+    model: string;
+    schemaVersion: number;
+}): Promise<ExtractedIngestResult>;
+export declare function fetchUsage(cfg: ExtractIngestConfig): Promise<{
+    memories_used?: number;
+    memories_cap?: number;
+    tier?: string;
+} | null>;

package/dist/cli/extract.js

@@ -0,0 +1,216 @@
+/**
+ * Client-side extraction for `ricord init`.
+ *
+ * Post-2026-05-12 the Ricord server runs zero generative LLM calls — clients
+ * own anchor/connection/task extraction. This module wires the CLI into that
+ * flow: fetch the canonical extraction prompt from /v1/extraction/prompt,
+ * run it through the caller's LLM, and POST the structured result to
+ * /v1/ingest/extracted.
+ *
+ * Provider auto-detect at startup: OPENAI_API_KEY (default, gpt-4o) or
+ * ANTHROPIC_API_KEY (claude-sonnet-4-6). One key is enough.
+ */
+const DEFAULT_OPENAI_MODEL = "gpt-4o";
+const DEFAULT_ANTHROPIC_MODEL = "claude-sonnet-4-6";
+/**
+ * Resolve LLM provider + key from explicit flags or env. Throws with a clear
+ * message if no usable key is found — the CLI surfaces this at startup so the
+ * user fixes it before we walk the repo.
+ */
+export function resolveLlmConfig(opts) {
+    const explicitKey = opts.keyFlag?.trim();
+    const model = opts.modelFlag?.trim();
+    const looksAnthropic = model && /^(claude|anthropic)/i.test(model);
+    const looksOpenAI = model && /^(gpt|o\d|openai)/i.test(model);
+    // If model hints at provider, honor it.
+    if (looksAnthropic) {
+        const key = explicitKey ?? process.env.ANTHROPIC_API_KEY;
+        if (!key)
+            throw new Error("ANTHROPIC_API_KEY not set (or pass --llm-key)");
+        return { provider: "anthropic", model: model, apiKey: key };
+    }
+    if (looksOpenAI) {
+        const key = explicitKey ?? process.env.OPENAI_API_KEY;
+        if (!key)
+            throw new Error("OPENAI_API_KEY not set (or pass --llm-key)");
+        return { provider: "openai", model: model, apiKey: key };
+    }
+    // No model flag — pick whichever env key exists, OpenAI first.
+    if (explicitKey || process.env.OPENAI_API_KEY) {
+        return {
+            provider: "openai",
+            model: model ?? DEFAULT_OPENAI_MODEL,
+            apiKey: explicitKey ?? process.env.OPENAI_API_KEY,
+        };
+    }
+    if (process.env.ANTHROPIC_API_KEY) {
+        return {
+            provider: "anthropic",
+            model: model ?? DEFAULT_ANTHROPIC_MODEL,
+            apiKey: process.env.ANTHROPIC_API_KEY,
+        };
+    }
+    throw new Error("no LLM key found. Set OPENAI_API_KEY (or ANTHROPIC_API_KEY), " +
+        "or pass --llm-key <key> --llm-model <model>. " +
+        "Extraction runs client-side; Ricord no longer ships generative LLM calls.");
+}
+export function makeLlmFn(cfg) {
+    if (cfg.provider === "openai")
+        return makeOpenAiFn(cfg);
+    return makeAnthropicFn(cfg);
+}
+function makeOpenAiFn(cfg) {
+    return async (prompt) => {
+        const r = await fetch("https://api.openai.com/v1/chat/completions", {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${cfg.apiKey}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({
+                model: cfg.model,
+                messages: [{ role: "user", content: prompt }],
+                temperature: 0,
+                response_format: { type: "json_object" },
+            }),
+        });
+        if (!r.ok)
+            throw new Error(`OpenAI ${r.status}: ${(await r.text()).slice(0, 300)}`);
+        const j = await r.json();
+        return j.choices?.[0]?.message?.content ?? "";
+    };
+}
+function makeAnthropicFn(cfg) {
+    return async (prompt) => {
+        const r = await fetch("https://api.anthropic.com/v1/messages", {
+            method: "POST",
+            headers: {
+                "x-api-key": cfg.apiKey,
+                "anthropic-version": "2023-06-01",
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({
+                model: cfg.model,
+                max_tokens: 3000,
+                messages: [{ role: "user", content: prompt }],
+            }),
+        });
+        if (!r.ok)
+            throw new Error(`Anthropic ${r.status}: ${(await r.text()).slice(0, 300)}`);
+        const j = await r.json();
+        return (j.content ?? []).map(c => c.text ?? "").join("");
+    };
+}
+export async function fetchExtractionPrompt(cfg) {
+    const r = await fetch(`${cfg.apiBase}/v1/extraction/prompt`, {
+        headers: { Authorization: `Bearer ${cfg.token}` },
+    });
+    if (!r.ok)
+        throw new Error(`extraction prompt fetch failed: ${r.status} ${(await r.text()).slice(0, 200)}`);
+    return r.json();
+}
+function tryParseJson(raw) {
+    const fenced = raw.match(/```(?:json)?\s*([\s\S]*?)```/);
+    const candidate = fenced ? fenced[1] : raw;
+    const start = candidate.indexOf("{");
+    const end = candidate.lastIndexOf("}");
+    if (start === -1 || end === -1 || end < start)
+        throw new Error("no JSON object in LLM output");
+    return JSON.parse(candidate.slice(start, end + 1));
+}
+/** Coarse types the server accepts; subtype values often leak into `type`. */
+const COARSE_TYPES = new Set(["entity", "topic", "epoch"]);
+const SUBTYPE_TO_COARSE = {
+    person: "entity", people: "entity", company: "entity", institution: "entity",
+    community: "entity", relationship: "entity", project: "entity",
+    product: "entity", codebase: "entity", repo: "entity", repository: "entity",
+    technology: "entity", tool: "entity", library: "entity", framework: "entity",
+    place: "entity", location: "entity",
+    decision: "topic", pattern: "topic", lesson: "topic", gotcha: "topic",
+    theme: "topic", concept: "topic", architecture: "topic", design: "topic",
+    bug: "topic", feature: "topic",
+    period: "epoch", era: "epoch", quarter: "epoch", week: "epoch", day: "epoch",
+};
+function coerceAnchorType(a) {
+    const raw = a.type?.toLowerCase?.() ?? "";
+    if (COARSE_TYPES.has(raw))
+        return { ...a, type: raw };
+    const coarse = SUBTYPE_TO_COARSE[raw] ?? "entity";
+    return {
+        ...a,
+        type: coarse,
+        subtype: a.subtype ?? raw ?? undefined,
+    };
+}
+export async function runExtraction(llm, promptTemplate, text) {
+    const filled = promptTemplate.replace("{TEXT}", text);
+    const raw = await llm(filled);
+    const parsed = tryParseJson(raw);
+    if (!Array.isArray(parsed.anchors))
+        throw new Error("LLM output missing anchors[]");
+    // Cap to 10 anchors (server limit) and coerce types into the allowed set.
+    const anchors = parsed.anchors.slice(0, 10).map(coerceAnchorType);
+    const connections = Array.isArray(parsed.connections) ? parsed.connections.slice(0, 30) : [];
+    const tasks = Array.isArray(parsed.tasks) ? parsed.tasks.slice(0, 5) : [];
+    return { anchors, connections, tasks };
+}
+/**
+ * POST extracted anchors/connections/tasks to /v1/ingest/extracted. The route
+ * embeds the raw bundle text on its end (Vertex, $0.025/1M) so the bundle is
+ * still searchable; we just don't pay for generative extraction on the server.
+ */
+export async function postExtracted(cfg, payload) {
+    // Cap text to /v1/ingest/extracted's 200KB limit (server enforces too).
+    const safeText = payload.bundleText.length > 180_000
+        ? payload.bundleText.slice(0, 180_000)
+        : payload.bundleText;
+    const body = {
+        messages: [{ role: "user", content: safeText }],
+        extracted: payload.extracted,
+        extraction_meta: {
+            model: payload.model,
+            client: "ricord-cli",
+            schema_version: payload.schemaVersion,
+        },
+        tags: [`repo:${payload.repo}`, `dir:${payload.dirRel}`, "kind:dir-summary"],
+    };
+    const r = await fetch(`${cfg.apiBase}/v1/ingest/extracted`, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${cfg.token}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify(body),
+    });
+    let parsed;
+    try {
+        parsed = await r.json();
+    }
+    catch {
+        parsed = await r.text();
+    }
+    const p = parsed;
+    return {
+        ok: r.ok,
+        status: r.status,
+        pagesWritten: p?.pages_written ?? 0,
+        linksWritten: p?.links_written ?? 0,
+        tasksWritten: p?.tasks_written ?? 0,
+        body: parsed,
+    };
+}
+export async function fetchUsage(cfg) {
+    try {
+        const r = await fetch(`${cfg.apiBase}/v1/usage`, {
+            headers: { Authorization: `Bearer ${cfg.token}` },
+        });
+        if (!r.ok)
+            return null;
+        const b = await r.json();
+        return b.quota ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=extract.js.map

package/dist/cli/extract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.js","sourceRoot":"","sources":["../../src/cli/extract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAyEH,MAAM,oBAAoB,GAAG,QAAQ,CAAC;AACtC,MAAM,uBAAuB,GAAG,mBAAmB,CAAC;AAEpD;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAGhC;IACC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC;IAErC,MAAM,cAAc,GAAG,KAAK,IAAI,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnE,MAAM,WAAW,GAAG,KAAK,IAAI,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAE9D,wCAAwC;IACxC,IAAI,cAAc,EAAE,CAAC;QACnB,MAAM,GAAG,GAAG,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;QACzD,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QAC3E,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,KAAM,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IAC/D,CAAC;IACD,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,GAAG,GAAG,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;QACtD,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QACxE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAM,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IAC5D,CAAC;IAED,+DAA+D;IAC/D,IAAI,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;QAC9C,OAAO;YACL,QAAQ,EAAE,QAAQ;YAClB,KAAK,EAAE,KAAK,IAAI,oBAAoB;YACpC,MAAM,EAAE,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,cAAe;SACnD,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC;QAClC,OAAO;YACL,QAAQ,EAAE,WAAW;YACrB,KAAK,EAAE,KAAK,IAAI,uBAAuB;YACvC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB;SACtC,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,KAAK,CACb,+DAA+D;QAC/D,+CAA+C;QAC/C,2EAA2E,CAC5E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAAc;IACtC,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC;IACxD,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,YAAY,CAAC,GAAc;IAClC,OAAO,KAAK,EAAE,MAAc,EAAmB,EAAE;QAC/C,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,4CAA4C,EAAE;YAClE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,GAAG,CAAC,MAAM,EAAE;gBACrC,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;gBAC7C,WAAW,EAAE,CAAC;gBACd,eAAe,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE;aACzC,CAAC;SACH,CAAC,CAAC;QACH,IAAI,CAAC,CAAC,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QACpF,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,EAA6D,CAAC;QACpF,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC;IAChD,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,GAAc;IACrC,OAAO,KAAK,EAAE,MAAc,EAAmB,EAAE;QAC/C,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,uCAAuC,EAAE;YAC7D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,WAAW,EAAE,GAAG,CAAC,MAAM;gBACvB,mBAAmB,EAAE,YAAY;gBACjC,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,UAAU,EAAE,IAAI;gBAChB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;aAC9C,CAAC;SACH,CAAC,CAAC;QACH,IAAI,CAAC,CAAC,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QACvF,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,EAA2D,CAAC;QAClF,OAAO,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3D,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,GAAwB;IAExB,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,GAAG,GAAG,CAAC,OAAO,uBAAuB,EAAE;QAC3D,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,GAAG,CAAC,KAAK,EAAE,EAAE;KAClD,CAAC,CAAC;IACH,IAAI,CAAC,CAAC,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5G,OAAO,CAAC,CAAC,IAAI,EAAuC,CAAC;AACvD,CAAC;AAED,SAAS,YAAY,CAAC,GAAW;IAC/B,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;IACzD,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAC3C,MAAM,KAAK,GAAG,SAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,SAAU,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,KAAK,KAAK,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,GAAG,GAAG,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAC/F,OAAO,IAAI,CAAC,KAAK,CAAC,SAAU,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,GAAG,CAAC,CAAC,CAAuB,CAAC;AAC5E,CAAC;AAED,8EAA8E;AAC9E,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAC3D,MAAM,iBAAiB,GAAiD;IACtE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ;IAC5E,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ;IAC9D,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ;IAC3E,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ;IAC5E,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ;IACnC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO;IACrE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO;IACxE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO;IAC9B,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO;CAC7E,CAAC;AAEF,SAAS,gBAAgB,CAAC,CAAS;IACjC,MAAM,GAAG,GAAI,CAAC,CAAC,IAA0B,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,CAAC;IACjE,IAAI,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,GAAqB,EAAE,CAAC;IACxE,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC;IAClD,OAAO;QACL,GAAG,CAAC;QACJ,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,GAAG,IAAI,SAAS;KACvC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,GAAU,EACV,cAAsB,EACtB,IAAY;IAEZ,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACtD,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IACpF,0EAA0E;IAC1E,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAClE,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7F,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1E,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,GAAwB,EACxB,OAOC;IAED,wEAAwE;IACxE,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,OAAO;QAClD,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC;QACtC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IAEvB,MAAM,IAAI,GAAG;QACX,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;QAC/C,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,eAAe,EAAE;YACf,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,YAAY;YACpB,cAAc,EAAE,OAAO,CAAC,aAAa;SACtC;QACD,IAAI,EAAE,CAAC,QAAQ,OAAO,CAAC,IAAI,EAAE,EAAE,OAAO,OAAO,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC;KAC5E,CAAC;IAEF,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,GAAG,GAAG,CAAC,OAAO,sBAAsB,EAAE;QAC1D,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,aAAa,EAAE,UAAU,GAAG,CAAC,KAAK,EAAE;YACpC,cAAc,EAAE,kBAAkB;SACnC;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;KAC3B,CAAC,CAAC;IAEH,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QAAC,MAAM,GAAG,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,MAAM,GAAG,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IAAC,CAAC;IACnE,MAAM,CAAC,GAAG,MAIT,CAAC;IAEF,OAAO;QACL,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,YAAY,EAAE,CAAC,EAAE,aAAa,IAAI,CAAC;QACnC,YAAY,EAAE,CAAC,EAAE,aAAa,IAAI,CAAC;QACnC,YAAY,EAAE,CAAC,EAAE,aAAa,IAAI,CAAC;QACnC,IAAI,EAAE,MAAM;KACb,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAwB;IAKvD,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,GAAG,GAAG,CAAC,OAAO,WAAW,EAAE;YAC/C,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,GAAG,CAAC,KAAK,EAAE,EAAE;SAClD,CAAC,CAAC;QACH,IAAI,CAAC,CAAC,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QACvB,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,EAAkF,CAAC;QACzG,OAAO,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/cli/ingest.d.ts

@@ -0,0 +1,48 @@
+export interface IngestConfig {
+    apiBase: string;
+    token: string;
+}
+/**
+ * `/v1/ingest/source` returns `pipeline_status` immediately — no async job_id.
+ * The synchronous stages (`turns`, `recall`) run during the request; the rest
+ * (`facts`, `kb`, `graph`, `observe`) get queued and run in the background.
+ */
+export interface PipelineStatus {
+    turns?: "success" | "queued" | "skipped" | "failed";
+    recall?: "success" | "queued" | "skipped" | "failed";
+    facts?: "success" | "queued" | "skipped" | "failed";
+    kb?: "success" | "queued" | "skipped" | "failed";
+    graph?: "success" | "queued" | "skipped" | "failed";
+    observe?: "success" | "queued" | "skipped" | "failed";
+}
+export interface IngestResult {
+    ok: boolean;
+    status: number;
+    sessionId?: string;
+    pipelineStatus?: PipelineStatus;
+    turnsSaved?: number;
+    factsExtracted?: number;
+    creditsCharged?: number;
+    body: unknown;
+}
+export declare function postSourceText(cfg: IngestConfig, payload: {
+    dirRel: string;
+    summary: string;
+    repo: string;
+}): Promise<IngestResult>;
+/**
+ * Compact one-line summary of which stages finished synchronously vs were
+ * queued for background extraction. e.g. "turns:✓ recall:✓ facts:⏳ kb:⏳"
+ */
+export declare function formatPipelineStatus(s: PipelineStatus | undefined): string;
+/**
+ * Quick post-run quota delta check. The ingest jobs queue surface (`/v1/ingest/jobs/stats`)
+ * is for a different code path than `/v1/ingest/source` — polling it during a CLI run
+ * surfaces unrelated counters and confuses the user. Use `/v1/usage` instead — it shows
+ * the user's actual memory/quota state, which moves as their ingest finishes.
+ */
+export declare function fetchUsage(cfg: IngestConfig): Promise<{
+    memories_used?: number;
+    memories_cap?: number;
+    tier?: string;
+} | null>;

package/dist/cli/ingest.js

@@ -0,0 +1,74 @@
+export async function postSourceText(cfg, payload) {
+    const body = {
+        type: "text",
+        value: payload.summary,
+        title: payload.dirRel,
+        metadata: {
+            repo: payload.repo,
+            kind: "dir-summary",
+            path: payload.dirRel,
+            source: "ricord-cli",
+        },
+    };
+    const resp = await fetch(`${cfg.apiBase}/v1/ingest/source`, {
+        method: "POST",
+        headers: {
+            "Authorization": `Bearer ${cfg.token}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify(body),
+    });
+    let parsed;
+    try {
+        parsed = await resp.json();
+    }
+    catch {
+        parsed = await resp.text();
+    }
+    const p = parsed;
+    return {
+        ok: resp.ok,
+        status: resp.status,
+        sessionId: p?.session_id,
+        pipelineStatus: p?.pipeline_status,
+        turnsSaved: p?.turns_saved,
+        factsExtracted: p?.facts_extracted,
+        creditsCharged: p?.credits_charged,
+        body: parsed,
+    };
+}
+/**
+ * Compact one-line summary of which stages finished synchronously vs were
+ * queued for background extraction. e.g. "turns:✓ recall:✓ facts:⏳ kb:⏳"
+ */
+export function formatPipelineStatus(s) {
+    if (!s)
+        return "";
+    const glyph = (v) => v === "success" ? "✓" :
+        v === "queued" ? "⏳" :
+            v === "skipped" ? "·" :
+                v === "failed" ? "✗" : "?";
+    const order = ["turns", "recall", "facts", "kb", "graph", "observe"];
+    return order.filter(k => s[k] !== undefined).map(k => `${k}:${glyph(s[k])}`).join(" ");
+}
+/**
+ * Quick post-run quota delta check. The ingest jobs queue surface (`/v1/ingest/jobs/stats`)
+ * is for a different code path than `/v1/ingest/source` — polling it during a CLI run
+ * surfaces unrelated counters and confuses the user. Use `/v1/usage` instead — it shows
+ * the user's actual memory/quota state, which moves as their ingest finishes.
+ */
+export async function fetchUsage(cfg) {
+    try {
+        const resp = await fetch(`${cfg.apiBase}/v1/usage`, {
+            headers: { "Authorization": `Bearer ${cfg.token}` },
+        });
+        if (!resp.ok)
+            return null;
+        const body = await resp.json();
+        return body.quota ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=ingest.js.map

package/dist/cli/ingest.js.map

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