ricord 1.0.0

package/dist/cli/client.js

@@ -0,0 +1,35 @@
+/**
+ * Thin HTTP client for the Ricord API. Sends the API key as a Bearer
+ * token. The CLI doesn't ship Firebase auth — keys are the surface.
+ *
+ * `request` throws on non-2xx with a structured error message.
+ */
+export async function request(auth, path, init = {}) {
+    const headers = {
+        Authorization: `Bearer ${auth.apiKey}`,
+        "Content-Type": "application/json",
+        "User-Agent": "ricord-cli",
+        ...init.headers,
+    };
+    const res = await fetch(`${auth.apiUrl}${path}`, { ...init, headers });
+    const text = await res.text();
+    let body = text;
+    if (text && res.headers.get("content-type")?.includes("application/json")) {
+        try {
+            body = JSON.parse(text);
+        }
+        catch {
+            // leave as text
+        }
+    }
+    if (!res.ok) {
+        const err = new Error(typeof body === "object" && body && "error" in body
+            ? JSON.stringify(body.error)
+            : `HTTP ${res.status}`);
+        err.status = res.status;
+        err.body = body;
+        throw err;
+    }
+    return body;
+}
+//# sourceMappingURL=client.js.map

package/dist/cli/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/cli/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,IAAkB,EAClB,IAAY,EACZ,OAAoB,EAAE;IAEtB,MAAM,OAAO,GAA2B;QACtC,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;QACtC,cAAc,EAAE,kBAAkB;QAClC,YAAY,EAAE,YAAY;QAC1B,GAAI,IAAI,CAAC,OAA8C;KACxD,CAAC;IACF,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IACvE,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,IAAI,GAAY,IAAI,CAAC;IACzB,IAAI,IAAI,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;QAC1E,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACP,gBAAgB;QAClB,CAAC;IACH,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,GAAG,GAAG,IAAI,KAAK,CACnB,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,IAAI,OAAO,IAAI,IAAI;YACjD,CAAC,CAAC,IAAI,CAAC,SAAS,CAAE,IAA2B,CAAC,KAAK,CAAC;YACpD,CAAC,CAAC,QAAQ,GAAG,CAAC,MAAM,EAAE,CACb,CAAC;QACd,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;QACxB,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;QAChB,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,OAAO,IAAS,CAAC;AACnB,CAAC"}

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

@@ -0,0 +1,44 @@
+/**
+ * `ricord build` — agentic wiki authoring via the local `claude` CLI.
+ *
+ * Spawns claude as a tool-using agent (Read/Write/Edit/Glob/Grep/Bash)
+ * with a brief mission: walk this repo, decide 10-20 page boundaries,
+ * write each as `.ricord/pages/<slug>.md`. Claude does the file
+ * walking + reading + writing itself; we only set up the workspace and
+ * scan results afterwards.
+ *
+ * Auto-initializes the workspace on first run: if `.ricord/ledger.json`
+ * is missing, derives a project_id from the git remote URL (or the
+ * directory basename as a fallback), writes the ledger, scaffolds
+ * `.ricord/pages/` + `.ricord/README.md`, then proceeds. Pass
+ * `--project <id>` to override the derivation; pass `--team <uuid>`
+ * to bind the directory to a team space at the same time.
+ *
+ * NO PAID-API FALLBACK by design. NO `--dangerously-skip-permissions`.
+ * Permission gate is `--allowedTools` — listed tools run without
+ * prompts, anything else would prompt and block, never destruct.
+ *
+ * See `_pinned_top_never_paid_api_for_heavy_work` memory.
+ */
+import { stat } from "node:fs/promises";
+interface BuildOpts {
+    repoRoot: string;
+    projectId?: string;
+    /** Optional team UUID override for the chained --push. Falls back to
+     *  ledger.team_id. Builds themselves are local-file generation only, so
+     *  team_id only matters when --push is set. */
+    teamId?: string;
+    /** Force personal scope on the chained --push even if ledger has team_id. */
+    noTeam?: boolean;
+    /** dry run — print the mission + planned spawn, don't call claude */
+    dryRun: boolean;
+    /** Drop Bash from the toolset for paranoid environments */
+    safe: boolean;
+    /** Cap on agent turns */
+    maxTurns: number;
+    /** After a successful build, automatically `ricord push --all` so the
+     *  cloud mirror catches up in one command. */
+    push: boolean;
+}
+export declare function buildCommand(opts: BuildOpts): Promise<number>;
+export { stat };

package/dist/cli/commands/build.js

@@ -0,0 +1,437 @@
+/**
+ * `ricord build` — agentic wiki authoring via the local `claude` CLI.
+ *
+ * Spawns claude as a tool-using agent (Read/Write/Edit/Glob/Grep/Bash)
+ * with a brief mission: walk this repo, decide 10-20 page boundaries,
+ * write each as `.ricord/pages/<slug>.md`. Claude does the file
+ * walking + reading + writing itself; we only set up the workspace and
+ * scan results afterwards.
+ *
+ * Auto-initializes the workspace on first run: if `.ricord/ledger.json`
+ * is missing, derives a project_id from the git remote URL (or the
+ * directory basename as a fallback), writes the ledger, scaffolds
+ * `.ricord/pages/` + `.ricord/README.md`, then proceeds. Pass
+ * `--project <id>` to override the derivation; pass `--team <uuid>`
+ * to bind the directory to a team space at the same time.
+ *
+ * NO PAID-API FALLBACK by design. NO `--dangerously-skip-permissions`.
+ * Permission gate is `--allowedTools` — listed tools run without
+ * prompts, anything else would prompt and block, never destruct.
+ *
+ * See `_pinned_top_never_paid_api_for_heavy_work` memory.
+ */
+import { mkdir, readdir, readFile, stat, writeFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { basename, join, resolve } from "node:path";
+import { spawn } from "node:child_process";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import kleur from "kleur";
+import { readLedger, writeLedger, ledgerDir } from "../ledger.js";
+import { pushCommand } from "./push.js";
+const execFileP = promisify(execFile);
+// Matches Almanac's BASE_OPERATION_TOOLS spec (read/write/edit/search/shell)
+// mapped to Claude Code's tool names. `--safe` strips Bash.
+const FULL_TOOLS = ["Read", "Write", "Edit", "Glob", "Grep", "Bash"];
+const SAFE_TOOLS = ["Read", "Write", "Edit", "Glob", "Grep"];
+function buildMission(repoRoot, pagesDir, transcriptsDir) {
+    const repoName = resolve(repoRoot).split("/").pop() ?? "repo";
+    const transcriptsBlock = transcriptsDir
+        ? `\n## Conversation transcripts (extra signal)\n\nClaude Code transcripts for this repo live at \`${transcriptsDir}\` (JSONL — one record per line). Skim recent ones with Glob + Read for **decisions, gotchas, failed attempts, and reasoning** that the code alone doesn't capture. Treat them as supplementary sources — a page about "${repoName} deploy pipeline" gets richer if you also find the conversation where the deploy method was decided.\n\nSignal rules:\n- type:"user" → intent, requirements, reversals — high value\n- type:"assistant" text → analysis, decisions, root-cause writeups — high value\n- tool_use / tool_result → SKIP (operational noise)\n- Long files >50KB → almost always tool dumps, skip\n`
+        : "";
+    return `You are authoring a thorough wiki for the codebase \`${repoName}\` at \`${repoRoot}\`. Output goes to \`${pagesDir}/<slug>.md\`.
+
+## Purpose
+
+This wiki is **cultivated project memory** — a deep-research cache that preserves understanding that an expert would build after reading, tracing, and connecting raw inputs. Future readers (humans + AI agents) should start from this distilled understanding instead of reorienting from raw files.
+
+The codebase is the anchor, not the boundary. Pages may cover things OUTSIDE the repo when they materially shape work on it (\`stripe.md\`, \`postgres.md\`, \`claude-agent-sdk.md\` are all valid pages if the project leans on them). For external things, describe their **role in this project**: what we use, what we don't use, what versions matter, what conclusions we reached, what they connect to.
+
+A wiki change is valuable when it preserves **durable, reusable understanding that would be costly, useful, or risky to reconstruct later**. Conversely:
+
+**Do NOT write a page that is only:**
+- a file-by-file summary
+- a folder tree in prose
+- generic API documentation copied from external docs
+- "this file contains…" style content
+- a roadmap, task log, or progress diary
+- a guess about intent the code doesn't support
+- a one-off fact obvious from one nearby file
+- a page whose only claim is that something exists
+
+If the useful part can be folded into a parent page, do that instead of creating a new page.
+
+## Page genres (vocabulary, not enforcement)
+
+Use these as a thinking tool. Create a different shape when material genuinely needs it:
+
+- **Entity** — a named thing the project reasons about (\`provider\`, \`stripe\`, \`postgres\`, \`claude-agent-sdk\`). First-class. Use the natural name as the slug.
+- **Subsystem** — an internal area with clear responsibility and boundaries
+- **Flow** — behavior that crosses files, commands, or systems end-to-end
+- **Contract** — obligations between callers, providers, schemas, APIs, file formats
+- **Data model** — records, schemas, storage formats, indexes whose shape affects behavior
+- **Operation** — a recurring action with inputs, outputs, side effects, verification
+- **Decision / rationale** — why the project chose one path over alternatives. Pull from CLAUDE.md, READMEs, commits, transcripts.
+- **Risk / invariant** — a rule, coupling, or fragile behavior future work must preserve
+- **Dependency** — external runtime/service/SDK/framework as used by this project
+- **Influence** — external idea/paper/prior-art that shaped this project
+- **Research synthesis** — conclusions from docs, papers, design exploration
+- **Incident / postmortem** — what happened, what was learned, what changed
+- **Hub** — a standalone page that EXPLAINS a dense cluster (auth, deploy, knowledge-graph, embedding, etc.) in one place. **Required** whenever ≥3 specialty pages share a topic. The hub is not a nav stub — it has its own body explaining the concept and how the cluster fits together. The specialty pages drill into individual decisions/flows; the hub gives the reader the unified picture. Slug = the unprefixed concept name (\`auth.md\`, not \`auth-overview.md\` or \`auth-hub.md\`).
+- **Person / team** — the user, contributors, or teams the project reasons about. **Always create at least ONE \`type: person\` page for the repo owner/user** (mine name + role from \`git config user.name\`, \`git log\`, CLAUDE.md "user role" / "ceo" / "engineer" hints, and \`~/.claude/projects/*/memory/user_*.md\`). Slug = kebab-case of the person's name, e.g. \`ravindra\` or \`me\`.
+${transcriptsBlock}
+## Algorithm (8-step deep first construction pass)
+
+Do not stop after the first 10-15 pages. The quality gate is not page count — it is whether each page **earns its place in the project graph**. Be thorough. Create many pages when many are justified. **Target 25-60 pages for a real-world project.**
+
+1. **Orient to the corpus** — repo layout, package/config files, commands, entrypoints, docs, tests, schemas, data files, external dependencies. **Read these instruction/memory files FIRST** before anything else:
+   - \`CLAUDE.md\`, \`AGENTS.md\`, \`README.md\`, \`CONTRIBUTING.md\` at repo root
+   - \`~/.claude/projects/<repo-hash>/memory/MEMORY.md\` and \`~/.claude/projects/<repo-hash>/memory/*.md\` (the agent's per-project memory — contains user identity, preferences, decisions, gotchas, project facts that the code alone won't show). \`<repo-hash>\` is the abs repo path with \`/\` replaced by \`-\`. Use \`Bash ls ~/.claude/projects/\` to discover it.
+   - \`~/.claude/CLAUDE.md\` (the user's global instructions — coding style, deploy rules, decisions about tooling)
+   - \`package.json\` / \`Cargo.toml\` / equivalent for stack identification
+   These files contain the **most important durable knowledge** about the project — decisions, gotchas, conventions, user identity, team — that the code itself doesn't surface. Mine them aggressively.
+2. **Build a working map from multiple angles** — entities, subsystems, flows, contracts, data models, operations, external systems, product/project concepts, dense clusters.
+3. **Investigate important areas deeply** — explain how they work and how they connect. **Tests are often the clearest source of intended behavior.**
+4. **Compare code against existing docs and research** — preserve the applied conclusions and project-specific meaning. Do not copy docs.
+5. **Identify page candidates by future value** — for each, ask: would reconstructing this understanding later be costly, useful, or risky?
+6. **Design the initial graph** — pages, topics, links, **and one hub per dense cluster**. Topics are reading neighborhoods (\`provider-harness\`, \`prompt-system\`, \`wiki-indexing\`) — NOT bookkeeping labels (\`misc\`, \`notes\`, \`external\`). **Hub rule:** whenever you plan ≥3 specialty pages in the same area (e.g. \`decision-cloud-run-only\`, \`deploy-script-cloudbuild\`, \`gotcha-website-deploy\`) you MUST also plan ONE hub page (e.g. \`deploy.md\`) that explains the area as a whole and links the specialty pages. The hub is a real page with its own 800-2500 char body — not a stub or link list. Common required hubs: \`auth.md\`, \`deploy.md\`, \`knowledge-graph.md\`, \`memory.md\`, \`provider.md\` — create whichever apply to this codebase.
+7. **Write detailed, grounded pages** directly to \`${pagesDir}/\`.
+8. **Re-read the wiki as a future agent** — fix weak leads, duplicate pages, unsupported claims, missing links, thin placeholders. **For each page, count backticks: \`grep -oE '\\\`[^\\\`]+\\\`' <page> | wc -l\`. If under 25, revise: convert vague prose into named symbols/paths/types/commands. Target ≥ 40 per page.**
+
+## getting-started.md — required navigation page
+
+Write \`${pagesDir}/getting-started.md\` LAST, once the rest of the graph exists. It is the canonical front door — orient a fresh reader, name the dense clusters, point at which pages to read first for common work areas. Link directly to the most important pages with \`[[wikilinks]]\`. Not a setup guide; a reading-order guide.
+
+## Page shape
+
+Start with a **lead paragraph** that stands alone — a future reader should know what the page is about, why it exists, and whether to keep reading after just the first 2-3 sentences.
+
+After the lead, use **5-8 \`## H2 sections\`** drawn from this menu as fits the page:
+
+- What it is in this project
+- Where it lives
+- How it works
+- What we use
+- What we don't use
+- Contracts and assumptions
+- Sequence (numbered, for flows)
+- Failure modes / Gotchas
+- Decisions and rationale
+- Related flows
+- Current synthesis
+- Open questions
+- Verification (how to know it works)
+- Related pages
+
+Prose for explanation. Bullets only for real lists. Tables only for structured comparison.
+
+## Frontmatter
+
+\`\`\`
+---
+slug: <kebab-case>
+title: "<short human title>"
+summary: "<ONE direct sentence — used as the search-result snippet>"
+type: <person|team|company|community|mentorship|relationship|
+       system|component|service|library|tool|module|
+       decision|policy|rationale|flow|pipeline|process|
+       gotcha|bug|constraint|limitation|task|
+       concept|overview|architecture>
+topics: [<reading-neighborhood-1>, <reading-neighborhood-2>]
+files:
+  - "<repo-relative path>"
+sources:
+  - <URL or absolute path to external doc/research/transcript that supports this page>
+status: fresh
+built_at: <ISO8601>
+---
+\`\`\`
+
+\`summary:\` is one factual sentence, not a paragraph — it's literally the search-result snippet. \`sources:\` is for external docs/URLs/transcripts that ground the page (separate from \`files:\` which is repo-internal).
+
+## Body — depth requirements
+
+**Target 800-2500 chars per body** (aim for the upper end on important concepts). A page with under 800 chars is suspect — fold into a parent or skip it.
+
+**Code references everywhere — hard floor: 40 backtick refs per page (warning under 25).** Every symbol, function, file path, type, env var, schema name, table, command, route, or constant must appear in \`backticks\`. Reference real exports — \`signInWithEmailAndPassword\`, \`POST /api/session\`, \`src/lib/auth-context.tsx\`, \`AuthProvider\`, \`process.env.FIREBASE_KEY\`, \`users.id\`, \`pnpm run build\`. **Before saving any page, count the backtick refs.** If a 1000-word page has under 25 backticks, it is prose-heavy — revise: replace prose like "the auth context" with \`AuthContext\`, "the signin function" with \`signIn()\`, "the session cookie" with the actual cookie name in backticks. Concrete > generic. **A page with zero backticks is broken; a page with fewer than 25 is half-broken.**
+
+**Numbered sequences for flows.** Multi-step processes get numbered lists with concrete arrows: \`1. User submits form → \\\`signIn(...)\\\` returns promise → onAuthStateChanged fires → ...\`
+
+**\`[[wikilinks]]\` for related concepts** — link the first meaningful mention of each related page. Liberal linking is good, but the page must STAND ALONE: a reader should learn the concept from this page, not just see a list of links to other pages.
+
+## Grounding (non-negotiable)
+
+Ground non-obvious claims in code, tests, docs, sources, commits, prior pages, or explicit user context. **Do not pretend uncertainty is fact.** If a claim matters and cannot be grounded, omit it or mark it as an open question. Inspect tests when you need to confirm behavior.
+
+## Style
+
+Direct, factual, dense. Write for future coding agents and engineers picking up the project.
+
+**Avoid:**
+- generic library tutorials
+- vague claims ("uses modern tech")
+- marketing prose
+- unsupported rationale ("for performance" with no measurement)
+- transcript language ("we discussed and decided…")
+- "this file contains…" summaries
+- conclusions that don't connect to future work
+- chips-only index pages with no real content
+
+## How to work
+
+Use Glob/Grep/Read to survey. Use Bash for \`git log\`, \`find\`, \`grep\` when faster than the dedicated tools. Use Write to create pages under \`${pagesDir}/\`. Skip if a slug already exists — don't clobber prior work. **Re-read your own pages after writing the first batch** and improve them; the agent's first draft is rarely the best draft.
+
+## Required minimum coverage
+
+Before printing the final count, verify the wiki has at least:
+- **≥1 \`type: person\` page** — the repo owner / user (mine from \`git config\`, CLAUDE.md, \`~/.claude\` memory). Title = their human name. The "People" bucket in the dashboard depends on this.
+- **≥3 \`type: decision\` pages** — design choices the project made (e.g. "why postgres not sqlite", "why claude CLI not paid API"). Mine from CLAUDE.md, commit messages with words like "decided / chose / instead of", ADR docs, transcript moments where alternatives were rejected.
+- **≥3 \`type: gotcha\` pages** — known issues, footguns, "don't do X" rules. Mine from CLAUDE.md sections labeled "Don't", "Never", "Watch out", from comments containing TODO/FIXME/HACK, from commits with "fix:", and from transcripts where something broke.
+
+If a real repo genuinely has none of these (rare), document the absence in \`getting-started.md\` so future agents know to look elsewhere.
+
+When done, print ONE line: \`WROTE N PAGES\` where N is the count.
+
+## Out of scope
+
+- Do not run \`git push\`, \`rm -rf\`, install packages, or modify files outside \`${pagesDir}\`.
+- Do not include large file dumps in pages — pages document *what the code MEANS*, not what each file contains.
+
+Begin. Be thorough; the user wants a wiki rich enough to navigate as a graph AND deep enough to read as standalone essays.`;
+}
+/** Locate Claude Code transcripts for this repo (~/.claude/projects/<hash>).
+ *  The hash is the absolute repo path with slashes replaced by dashes. */
+async function findTranscriptsDir(repoRoot) {
+    const { existsSync: e } = await import("node:fs");
+    const { homedir } = await import("node:os");
+    const abs = resolve(repoRoot);
+    const hash = abs.replace(/\//g, "-"); // /Users/a/b → -Users-a-b
+    const dir = join(homedir(), ".claude", "projects", hash);
+    return e(dir) ? dir : null;
+}
+/** Derive a project_id from `git remote get-url origin` basename. Falls
+ *  back to the directory basename when no git remote is configured. */
+async function deriveProjectId(repoRoot) {
+    try {
+        const { stdout } = await execFileP("git", ["-C", repoRoot, "remote", "get-url", "origin"]);
+        const url = stdout.trim();
+        // git@github.com:foo/bar.git → bar; https://github.com/foo/bar(.git) → bar
+        const match = url.match(/[/:]([^/:]+?)(?:\.git)?$/);
+        if (match)
+            return match[1];
+    }
+    catch {
+        // no remote → fall through
+    }
+    return basename(resolve(repoRoot));
+}
+/** Initialize the workspace on first run (or refresh team binding on
+ *  subsequent runs). Writes ledger.json + scaffolds .ricord/README.md
+ *  if missing. Returns the resolved project_id, or null on failure. */
+async function ensureWorkspace(opts) {
+    const dir = ledgerDir(opts.repoRoot);
+    const ledger = await readLedger(opts.repoRoot);
+    const projectId = opts.projectId ?? ledger.project_id ?? (await deriveProjectId(opts.repoRoot));
+    if (!projectId) {
+        console.error(kleur.red("could not resolve project_id — pass --project <id>"));
+        return null;
+    }
+    const teamId = opts.noTeam ? undefined : (opts.teamId ?? ledger.team_id);
+    const isFirstRun = !ledger.project_id;
+    const projectChanged = ledger.project_id && ledger.project_id !== projectId;
+    const teamChanged = ledger.team_id !== teamId;
+    if (isFirstRun || projectChanged || teamChanged) {
+        await writeLedger(opts.repoRoot, {
+            ...ledger,
+            project_id: projectId,
+            team_id: teamId,
+            repo: ledger.repo ?? { remote_url: `file://${resolve(opts.repoRoot)}` },
+        });
+    }
+    // First-run scaffolding: pages dir + README explaining the layout.
+    await mkdir(join(dir, "pages"), { recursive: true });
+    const readme = join(dir, "README.md");
+    if (!existsSync(readme)) {
+        await writeFile(readme, [
+            "# .ricord/",
+            "",
+            "Local-first Ricord wiki for this repo. **`pages/` is the source of truth** —",
+            "commit it. The hosted ricord.ai dashboard mirrors what you push.",
+            "",
+            "- `pages/*.md` — wiki pages (git-tracked)",
+            "- `ledger.json` — per-machine sync state (gitignored)",
+            "- `.gitignore` — only ignores ledger + tmp files",
+            "",
+            "Run `ricord build` to (re)author pages with claude. `ricord push` to sync",
+            "local edits up. `ricord pull` to pull cloud edits down.",
+            "",
+        ].join("\n"), "utf8");
+    }
+    if (isFirstRun) {
+        const teamSuffix = teamId ? kleur.dim(` (team ${teamId.slice(0, 8)}…)`) : "";
+        console.log(kleur.green("✓"), `bound to project ${projectId}${teamSuffix}`);
+    }
+    return projectId;
+}
+export async function buildCommand(opts) {
+    const projectId = await ensureWorkspace(opts);
+    if (!projectId)
+        return 1;
+    const pagesDir = join(ledgerDir(opts.repoRoot), "pages");
+    await mkdir(pagesDir, { recursive: true });
+    const tools = opts.safe ? SAFE_TOOLS : FULL_TOOLS;
+    const transcriptsDir = await findTranscriptsDir(opts.repoRoot);
+    const mission = buildMission(opts.repoRoot, pagesDir, transcriptsDir);
+    console.log(kleur.bold("ricord build"), kleur.dim(`(repo: ${resolve(opts.repoRoot).split("/").pop()}, tools: ${tools.join(",")}, max_turns: ${opts.maxTurns})`));
+    if (transcriptsDir) {
+        console.log(kleur.dim(`  + transcripts: ${transcriptsDir}`));
+    }
+    if (opts.dryRun) {
+        console.log(kleur.dim("\n--- mission ---"));
+        console.log(mission);
+        console.log(kleur.dim("\n--- spawn ---"));
+        console.log(`claude -p --output-format json --allowedTools "${tools.join(",")}" --add-dir ${pagesDir} --max-turns ${opts.maxTurns}`);
+        return 0;
+    }
+    const before = await pageSlugsOnDisk(pagesDir);
+    const extraDirs = transcriptsDir ? [transcriptsDir] : [];
+    const exit = await spawnClaude(opts.repoRoot, mission, tools, opts.maxTurns, extraDirs);
+    const after = await pageSlugsOnDisk(pagesDir);
+    const wrote = after.filter((s) => !before.includes(s));
+    if (wrote.length > 0) {
+        console.log(kleur.green(`\n✓ built ${wrote.length} new pages → ${pagesDir.replace(opts.repoRoot, ".")}/`));
+        for (const s of wrote.slice(0, 30))
+            console.log(kleur.dim(`  ${s}`));
+        if (wrote.length > 30)
+            console.log(kleur.dim(`  …${wrote.length - 30} more`));
+    }
+    else {
+        console.log(kleur.yellow(`\nbuilt 0 new pages (claude exit ${exit}). agent may have decided existing pages already cover this repo.`));
+    }
+    // G19 — derive .ricord/topics.yaml from the local pages' frontmatter
+    // so the topic surface is populated even before a `ricord push`. Same
+    // list-of-objects shape the cloud export uses so the file is
+    // round-trip stable.
+    if (after.length > 0) {
+        const yamlPath = join(ledgerDir(opts.repoRoot), "topics.yaml");
+        const yaml = await deriveTopicsYaml(pagesDir, after);
+        await writeFile(yamlPath, yaml, "utf8");
+    }
+    if (opts.push && wrote.length > 0) {
+        console.log(kleur.dim("\n→ pushing to cloud mirror…"));
+        const pushExit = await pushCommand({
+            repoRoot: opts.repoRoot,
+            from: ".ricord/pages",
+            projectId,
+            teamId: opts.teamId,
+            noTeam: opts.noTeam,
+            dryRun: false,
+            all: true,
+        });
+        return pushExit;
+    }
+    console.log(kleur.dim("next: review with `ricord curate --local`, then `ricord push` (or rerun with --push)."));
+    return wrote.length > 0 ? 0 : exit;
+}
+/** G19 — walk every .md in pagesDir, collect unique topic slugs from
+ *  frontmatter `topics: [a, b, c]`, and emit `.ricord/topics.yaml` in
+ *  the same list-of-objects shape the cloud export uses. */
+async function deriveTopicsYaml(pagesDir, slugs) {
+    const counts = new Map();
+    for (const f of slugs) {
+        const text = await readFile(join(pagesDir, f), "utf8").catch(() => "");
+        if (!text.startsWith("---"))
+            continue;
+        const end = text.indexOf("\n---", 3);
+        if (end < 0)
+            continue;
+        const fm = text.slice(3, end);
+        const m = fm.match(/^topics:\s*\[(.*)\]/m);
+        if (!m)
+            continue;
+        for (const raw of m[1].split(",")) {
+            const t = raw.trim().replace(/^["']|["']$/g, "").toLowerCase();
+            if (!t)
+                continue;
+            counts.set(t, (counts.get(t) ?? 0) + 1);
+        }
+    }
+    const lines = [
+        "# Ricord topics — local mirror, derived from .ricord/pages/*.md.",
+        "# Edit the page frontmatter to change topics; this file is regenerated",
+        "# on every `ricord build`.",
+        "topics:",
+    ];
+    if (counts.size === 0) {
+        lines.push("  []");
+        return lines.join("\n") + "\n";
+    }
+    const sorted = [...counts.entries()].sort(([a], [b]) => a.localeCompare(b));
+    for (const [slug, n] of sorted) {
+        const title = slug.replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+        lines.push(`  - slug: ${slug}`);
+        lines.push(`    title: ${JSON.stringify(title)}`);
+        lines.push(`    page_count: ${n}`);
+    }
+    return lines.join("\n") + "\n";
+}
+async function pageSlugsOnDisk(pagesDir) {
+    if (!existsSync(pagesDir))
+        return [];
+    const entries = await readdir(pagesDir);
+    return entries.filter((e) => e.endsWith(".md")).sort();
+}
+async function spawnClaude(cwd, prompt, tools, maxTurns, extraDirs = []) {
+    return await new Promise((res) => {
+        const args = [
+            "-p",
+            "--output-format", "json",
+            "--allowedTools", tools.join(","),
+            "--add-dir", cwd,
+            ...extraDirs.flatMap((d) => ["--add-dir", d]),
+            "--max-turns", String(maxTurns),
+        ];
+        const child = spawn("claude", args, { stdio: ["pipe", "pipe", "pipe"], cwd });
+        let stdout = "";
+        let stderr = "";
+        child.stdout.on("data", (b) => {
+            const chunk = b.toString("utf8");
+            stdout += chunk;
+            // Stream a single live "claude working…" dot so the user knows
+            // the agent is alive without dumping its full chatter.
+            process.stdout.write(".");
+        });
+        child.stderr.on("data", (b) => { stderr += b.toString("utf8"); });
+        child.on("error", (e) => {
+            console.error(kleur.red(`\nclaude spawn failed: ${e.message}. Install Claude Code: https://claude.com/claude-code`));
+            res(1);
+        });
+        child.on("close", (code) => {
+            process.stdout.write("\n");
+            if (code !== 0) {
+                const tail = (stderr || stdout).slice(-400);
+                console.error(kleur.red(`claude exit ${code}: ${tail}`));
+                res(code ?? 1);
+                return;
+            }
+            // Surface claude's final one-liner (per the mission, "WROTE N PAGES").
+            try {
+                const wrapper = JSON.parse(stdout);
+                const final = (wrapper.result ?? "").trim();
+                if (final)
+                    console.log(kleur.dim(`  agent: ${final.slice(0, 200)}`));
+                if (wrapper.num_turns !== undefined)
+                    console.log(kleur.dim(`  turns: ${wrapper.num_turns}`));
+            }
+            catch {
+                /* ignore parse errors — file scan tells us what actually landed */
+            }
+            res(0);
+        });
+        child.stdin.write(prompt, "utf8");
+        child.stdin.end();
+    });
+}
+// Re-export stat for ergonomics if a caller wants to introspect later
+export { stat };
+//# sourceMappingURL=build.js.map

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

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

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

@@ -0,0 +1,32 @@
+/**
+ * `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.
+ */
+interface CurateOpts {
+    repoRoot: string;
+    projectId?: string;
+    apply: boolean;
+    /** --prepare prints the CURATION_PROMPT + a page batch the user can
+     *  pipe into a host LLM. The LLM's JSON output is then POST'd back
+     *  via `ricord curate --apply-from <file>`. Mirrors `ricord ingest
+     *  --prepare`. */
+    prepare: boolean;
+    /** --local scans .ricord/pages/ on disk and reports issues without
+     *  hitting the cloud. G11 tick 27 — local-first curation surface. */
+    local: boolean;
+    /** --local + --stale-days N: warn on pages older than N days. */
+    staleDays: number;
+}
+export declare function curateCommand(opts: CurateOpts): Promise<number>;
+export {};