ricord 1.0.0

package/dist/cli/walk.js

@@ -0,0 +1,62 @@
+/**
+ * Repo walker — finds source files for `ricord ingest`. Honors a hard-coded
+ * skip list (node_modules, .git, dist, build, .next, .cache, .ricord) and
+ * an extension allow-list. Optional `paths` restricts to those subtrees.
+ *
+ * Designed to be deterministic so the same repo produces the same file
+ * order in every run — the ingest batch is order-stable for sha checks.
+ */
+import { readdir } from "node:fs/promises";
+import { join, resolve } from "node:path";
+const SKIP_DIRS = new Set([
+    "node_modules", ".git", ".ricord", ".almanac",
+    "dist", "build", ".next", ".cache", "coverage",
+    ".turbo", ".vercel", "out", "tmp", ".pnp", ".yarn",
+    // Build / generated artifact dirs we've seen in real repos
+    "graphify-out", ".ricord-cache",
+]);
+const ALLOWED_EXT = new Set([
+    ".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs", ".py", ".go", ".rs",
+    ".rb", ".java", ".kt", ".swift", ".cpp", ".c", ".h", ".hpp", ".cs",
+    ".sql", ".graphql", ".proto", ".md", ".mdx", ".toml", ".yaml", ".yml",
+    ".json", ".sh", ".bash",
+]);
+export async function walkRepo(repoRoot, paths) {
+    const root = resolve(repoRoot);
+    const starts = paths && paths.length > 0 ? paths.map((p) => resolve(root, p)) : [root];
+    const out = [];
+    const queue = [...starts];
+    while (queue.length > 0) {
+        const dir = queue.shift();
+        let entries;
+        try {
+            entries = await readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        entries.sort((a, b) => a.name.localeCompare(b.name));
+        for (const e of entries) {
+            if (e.name.startsWith(".") && e.name !== ".env.example") {
+                if (e.isDirectory() && !SKIP_DIRS.has(e.name)) {
+                    queue.push(join(dir, e.name));
+                    continue;
+                }
+                continue;
+            }
+            if (e.isDirectory()) {
+                if (SKIP_DIRS.has(e.name))
+                    continue;
+                queue.push(join(dir, e.name));
+                continue;
+            }
+            const dot = e.name.lastIndexOf(".");
+            const ext = dot >= 0 ? e.name.slice(dot) : "";
+            if (!ALLOWED_EXT.has(ext))
+                continue;
+            out.push({ absPath: join(dir, e.name), size: 0 });
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=walk.js.map

package/dist/cli/walk.js.map

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

package/dist/cli/walker.d.ts

@@ -0,0 +1,14 @@
+export interface RepoFile {
+    abs: string;
+    rel: string;
+    ext: string;
+    size: number;
+}
+export interface DirGroup {
+    rel: string;
+    files: RepoFile[];
+}
+export declare function walkRepo(root: string, opts?: {
+    respectConfidential?: boolean;
+}): Promise<DirGroup[]>;
+export declare function isCode(file: RepoFile): boolean;

package/dist/cli/walker.js

@@ -0,0 +1,120 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import ignoreModule from "ignore";
+// `ignore` ships as `module.exports = factory; factory.default = factory`.
+// Under NodeNext + esModuleInterop the default import resolves to the
+// namespace object on some Node versions, so normalize it to the callable.
+const ignore = typeof ignoreModule === "function"
+    ? ignoreModule
+    : ignoreModule.default;
+const CODE_EXT = new Set([".ts", ".tsx", ".js", ".jsx", ".py", ".sql"]);
+const DOC_EXT = new Set([".md", ".yaml", ".yml", ".toml"]);
+const ALL_EXT = new Set([...CODE_EXT, ...DOC_EXT]);
+const HARD_EXCLUDE_DIRS = new Set([
+    "node_modules", ".venv", ".next", "dist", "build", ".git",
+    "__pycache__", ".turbo", ".cache", "coverage", ".pytest_cache",
+]);
+const CONFIDENTIAL_DIRS = new Set(["research", "benchmarks", "marketing"]);
+const CONFIDENTIAL_FILES = (name) => /^(CPO_AUDIT_LOG|MEMORY)\.md$/i.test(name) ||
+    /AUDIT.*\.md$/i.test(name);
+const HARD_EXCLUDE_FILES = new Set([
+    "package-lock.json", "yarn.lock", "pnpm-lock.yaml", "uv.lock", "poetry.lock",
+]);
+async function isBinary(absPath) {
+    try {
+        const fd = await fs.open(absPath, "r");
+        try {
+            const buf = Buffer.alloc(8192);
+            const { bytesRead } = await fd.read(buf, 0, 8192, 0);
+            for (let i = 0; i < bytesRead; i++)
+                if (buf[i] === 0)
+                    return true;
+            return false;
+        }
+        finally {
+            await fd.close();
+        }
+    }
+    catch {
+        return true;
+    }
+}
+async function loadGitignore(root) {
+    const ig = ignore();
+    try {
+        const txt = await fs.readFile(path.join(root, ".gitignore"), "utf8");
+        ig.add(txt);
+    }
+    catch { /* no gitignore — fine */ }
+    // Always add our hard-exclude patterns as belt-and-suspenders.
+    ig.add([...HARD_EXCLUDE_DIRS].map(d => `${d}/`).join("\n"));
+    return ig;
+}
+export async function walkRepo(root, opts = {}) {
+    const respectConfidential = opts.respectConfidential ?? true;
+    const ig = await loadGitignore(root);
+    const groups = new Map();
+    async function visit(dir) {
+        const rel = path.relative(root, dir) || ".";
+        if (rel !== ".") {
+            const segs = rel.split(path.sep);
+            if (segs.some(s => HARD_EXCLUDE_DIRS.has(s)))
+                return;
+            if (respectConfidential && segs.some(s => CONFIDENTIAL_DIRS.has(s)))
+                return;
+            // gitignore expects forward slashes + trailing slash for dirs
+            if (ig.ignores(rel.split(path.sep).join("/") + "/"))
+                return;
+        }
+        let entries;
+        try {
+            entries = await fs.readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            const abs = path.join(dir, e.name);
+            const childRel = path.relative(root, abs).split(path.sep).join("/");
+            if (e.isDirectory()) {
+                await visit(abs);
+                continue;
+            }
+            if (!e.isFile())
+                continue;
+            if (HARD_EXCLUDE_FILES.has(e.name))
+                continue;
+            if (respectConfidential && CONFIDENTIAL_FILES(e.name))
+                continue;
+            if (ig.ignores(childRel))
+                continue;
+            const ext = path.extname(e.name).toLowerCase();
+            if (!ALL_EXT.has(ext))
+                continue;
+            const stat = await fs.stat(abs);
+            // Skip absurdly large files — likely generated / data.
+            if (stat.size > 512 * 1024)
+                continue;
+            if (await isBinary(abs))
+                continue;
+            const dirRel = path.relative(root, dir).split(path.sep).join("/") || ".";
+            const file = {
+                abs,
+                rel: childRel,
+                ext,
+                size: stat.size,
+            };
+            if (!groups.has(dirRel))
+                groups.set(dirRel, []);
+            groups.get(dirRel).push(file);
+        }
+    }
+    await visit(root);
+    return [...groups.entries()]
+        .map(([rel, files]) => ({ rel, files }))
+        .sort((a, b) => a.rel.localeCompare(b.rel));
+}
+export function isCode(file) {
+    return CODE_EXT.has(file.ext);
+}
+//# sourceMappingURL=walker.js.map

package/dist/cli/walker.js.map

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

package/dist/hooks/pre-compact.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * PreCompact hook — captures context before Claude Code auto-compacts.
+ *
+ * When Claude Code's context window fills up, it auto-compacts (summarizes
+ * and discards detail). This hook fires BEFORE that, spawning a background
+ * flush process to capture the current conversation context.
+ *
+ * Without this hook, long sessions lose intermediate context to summarization
+ * before SessionEnd ever fires.
+ *
+ * Same architecture as session-end.ts but with a higher MIN_TURNS threshold
+ * to avoid saving trivial compactions.
+ */
+export {};

package/dist/hooks/pre-compact.js

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+/**
+ * PreCompact hook — captures context before Claude Code auto-compacts.
+ *
+ * When Claude Code's context window fills up, it auto-compacts (summarizes
+ * and discards detail). This hook fires BEFORE that, spawning a background
+ * flush process to capture the current conversation context.
+ *
+ * Without this hook, long sessions lose intermediate context to summarization
+ * before SessionEnd ever fires.
+ *
+ * Same architecture as session-end.ts but with a higher MIN_TURNS threshold
+ * to avoid saving trivial compactions.
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { spawn } from "node:child_process";
+// Recursion guard
+if (process.env.CLAUDE_INVOKED_BY) {
+    process.exit(0);
+}
+const ROOT_DIR = join(import.meta.dirname, "..", "..");
+const DIST_SCRIPTS = join(ROOT_DIR, "dist", "scripts");
+const FLUSH_SCRIPT = join(DIST_SCRIPTS, "flush.js");
+const CONTEXT_DIR = join(tmpdir(), "ricord-contexts");
+const MAX_TURNS = 30;
+const MAX_CONTEXT_CHARS = 15_000;
+const MIN_TURNS = 5; // Higher than session-end (3)
+// ── Credential scrubbing ─────────────────────────────────────────────
+const SCRUB_PATTERNS = [
+    /sk-[a-zA-Z0-9]{20,}/g,
+    /AKIA[A-Z0-9]{16}/g,
+    /ghp_[a-zA-Z0-9]{36,}/g,
+    /rc_(?:live|test)_[a-zA-Z0-9_]{10,}/g,
+    /Bearer\s+[a-zA-Z0-9._\-]{20,}/gi,
+    /(?:api[_-]?key|password|secret|token)\s*[:=]\s*["']?[^\s"']{8,}/gi,
+];
+function scrub(text) {
+    let result = text;
+    for (const p of SCRUB_PATTERNS) {
+        result = result.replace(p, "[REDACTED]");
+    }
+    return result;
+}
+// ── Transcript extraction ────────────────────────────────────────────
+function extractConversation(transcriptPath) {
+    const turns = [];
+    const content = readFileSync(transcriptPath, "utf8");
+    for (const line of content.split("\n")) {
+        if (!line.trim())
+            continue;
+        try {
+            const entry = JSON.parse(line);
+            const msg = entry.message || entry;
+            const role = msg.role || "";
+            let text = msg.content || "";
+            if (!["user", "assistant"].includes(role))
+                continue;
+            if (Array.isArray(text)) {
+                text = text
+                    .filter((b) => typeof b === "string" || (b.type === "text" && b.text))
+                    .map((b) => (typeof b === "string" ? b : b.text))
+                    .join("\n");
+            }
+            if (typeof text === "string" && text.trim()) {
+                const label = role === "user" ? "User" : "Assistant";
+                turns.push(`**${label}:** ${text.trim()}`);
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    let recent = turns.slice(-MAX_TURNS);
+    let context = recent.join("\n\n");
+    if (context.length > MAX_CONTEXT_CHARS) {
+        context = context.slice(-MAX_CONTEXT_CHARS);
+        const boundary = context.indexOf("\n**");
+        if (boundary > 0)
+            context = context.slice(boundary + 1);
+    }
+    return { context: scrub(context), turnCount: recent.length };
+}
+// ── Main ─────────────────────────────────────────────────────────────
+async function main() {
+    let hookInput = {};
+    try {
+        const raw = readFileSync(0, "utf8");
+        hookInput = JSON.parse(raw);
+    }
+    catch {
+        return;
+    }
+    const sessionId = hookInput.session_id || "unknown";
+    const transcriptPath = hookInput.transcript_path;
+    // Guard against empty transcript_path (known Claude Code bug #13668)
+    if (!transcriptPath || !existsSync(transcriptPath))
+        return;
+    const { context, turnCount } = extractConversation(transcriptPath);
+    if (!context.trim() || turnCount < MIN_TURNS)
+        return;
+    // Write context to temp file
+    if (!existsSync(CONTEXT_DIR))
+        mkdirSync(CONTEXT_DIR, { recursive: true });
+    const timestamp = new Date().toISOString().replace(/[:.]/g, "-").slice(0, 19);
+    const contextFile = join(CONTEXT_DIR, `context-compact-${sessionId}-${timestamp}.md`);
+    // SEC-07: Use mode 0o600 so only the owning user can read the context file.
+    writeFileSync(contextFile, context, { encoding: "utf8", mode: 0o600 });
+    // Spawn flush.js as background process
+    if (!existsSync(FLUSH_SCRIPT))
+        return;
+    try {
+        const child = spawn("node", [FLUSH_SCRIPT, contextFile, `${sessionId}-compact`], {
+            cwd: ROOT_DIR,
+            detached: true,
+            stdio: "ignore",
+            env: { ...process.env, CLAUDE_INVOKED_BY: "ricord_flush" },
+        });
+        child.unref();
+    }
+    catch {
+        // Silent failure
+    }
+}
+main().catch(() => { });
+//# sourceMappingURL=pre-compact.js.map

package/dist/hooks/pre-compact.js.map

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

package/dist/hooks/pre-tool-use.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * PreToolUse hook — observes Write/Edit/MultiEdit calls to memory paths.
+ *
+ * Claude Code fires this hook BEFORE executing any tool call. The hook reads
+ * the tool name and input from stdin (JSON).
+ *
+ * Design principle: Ricord is a LAYER ON TOP of Claude Code, not a replacement.
+ * We do NOT block Claude's native memory writes. Claude writes to local .md
+ * files normally; the turn-end hook syncs changed files to Ricord in background.
+ *
+ * This hook currently passes all calls through. It remains in place as an
+ * observation point — future use: logging, metrics, or tagging writes for sync.
+ */
+export {};

package/dist/hooks/pre-tool-use.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+/**
+ * PreToolUse hook — observes Write/Edit/MultiEdit calls to memory paths.
+ *
+ * Claude Code fires this hook BEFORE executing any tool call. The hook reads
+ * the tool name and input from stdin (JSON).
+ *
+ * Design principle: Ricord is a LAYER ON TOP of Claude Code, not a replacement.
+ * We do NOT block Claude's native memory writes. Claude writes to local .md
+ * files normally; the turn-end hook syncs changed files to Ricord in background.
+ *
+ * This hook currently passes all calls through. It remains in place as an
+ * observation point — future use: logging, metrics, or tagging writes for sync.
+ */
+import { readFileSync } from "node:fs";
+function main() {
+    try {
+        readFileSync(0, "utf8");
+    }
+    catch { /* ignore */ }
+    // Allow everything — do not block Claude's native tooling.
+    process.exit(0);
+}
+main();
+//# sourceMappingURL=pre-tool-use.js.map

package/dist/hooks/pre-tool-use.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-tool-use.js","sourceRoot":"","sources":["../../src/hooks/pre-tool-use.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,SAAS,IAAI;IACX,IAAI,CAAC;QAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;IACvD,2DAA2D;IAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/hooks/session-end.d.ts

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+/**
+ * SessionEnd hook — captures conversation and spawns background flush.
+ *
+ * When a Claude Code session ends, this hook:
+ *   1. Reads the JSONL transcript path from stdin
+ *   2. Extracts the last N conversation turns
+ *   3. Writes context to a temp file
+ *   4. Spawns flush.js as a detached background process
+ *   5. flush.js extracts knowledge → saves to Ricord + daily log
+ *
+ * The hook itself does NO API calls and NO LLM calls — just local file I/O
+ * + spawning a background process. Runs in <2 seconds.
+ *
+ * Architecture borrowed from claude-memory-compiler:
+ *   - Fast hook (<10s) → spawns slow background process
+ *   - Recursion guard via CLAUDE_INVOKED_BY env var
+ *   - Deduplication via last-flush.json
+ *   - Dual hooks (SessionEnd + PreCompact) for full coverage
+ */
+export {};

package/dist/hooks/session-end.js

@@ -0,0 +1,186 @@
+#!/usr/bin/env node
+/**
+ * SessionEnd hook — captures conversation and spawns background flush.
+ *
+ * When a Claude Code session ends, this hook:
+ *   1. Reads the JSONL transcript path from stdin
+ *   2. Extracts the last N conversation turns
+ *   3. Writes context to a temp file
+ *   4. Spawns flush.js as a detached background process
+ *   5. flush.js extracts knowledge → saves to Ricord + daily log
+ *
+ * The hook itself does NO API calls and NO LLM calls — just local file I/O
+ * + spawning a background process. Runs in <2 seconds.
+ *
+ * Architecture borrowed from claude-memory-compiler:
+ *   - Fast hook (<10s) → spawns slow background process
+ *   - Recursion guard via CLAUDE_INVOKED_BY env var
+ *   - Deduplication via last-flush.json
+ *   - Dual hooks (SessionEnd + PreCompact) for full coverage
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
+import { join, basename } from "node:path";
+import { tmpdir } from "node:os";
+import { spawn, execSync } from "node:child_process";
+import { createHash } from "node:crypto";
+import { readBufferedTurns, clearBuffer, turnsToMessages } from "../lib/buffer.js";
+import { getActiveProject, clearActiveProject } from "../lib/active-project.js";
+function detectProject(cwd) {
+    try {
+        const remote = execSync("git remote get-url origin 2>/dev/null", { cwd, encoding: "utf8", timeout: 2000 }).trim();
+        const match = remote.match(/\/([^/]+?)(?:\.git)?$/);
+        if (match?.[1])
+            return match[1];
+    }
+    catch { }
+    return process.env.RICORD_PROJECT || basename(cwd) || "";
+}
+// Recursion guard: if spawned by flush/compile, exit immediately
+if (process.env.CLAUDE_INVOKED_BY) {
+    process.exit(0);
+}
+const ROOT_DIR = join(import.meta.dirname, "..", "..");
+const DIST_SCRIPTS = join(ROOT_DIR, "dist", "scripts");
+const FLUSH_SCRIPT = join(DIST_SCRIPTS, "flush.js");
+const CONTEXT_DIR = join(tmpdir(), "ricord-contexts");
+const MAX_TURNS = 30;
+const MAX_CONTEXT_CHARS = 15_000;
+const MIN_TURNS = 3;
+// ── Credential scrubbing (inline to avoid import overhead) ───────────
+const SCRUB_PATTERNS = [
+    /sk-[a-zA-Z0-9]{20,}/g,
+    /AKIA[A-Z0-9]{16}/g,
+    /ghp_[a-zA-Z0-9]{36,}/g,
+    /rc_(?:live|test)_[a-zA-Z0-9_]{10,}/g,
+    /Bearer\s+[a-zA-Z0-9._\-]{20,}/gi,
+    /(?:api[_-]?key|password|secret|token)\s*[:=]\s*["']?[^\s"']{8,}/gi,
+];
+function scrub(text) {
+    let result = text;
+    for (const p of SCRUB_PATTERNS) {
+        result = result.replace(p, "[REDACTED]");
+    }
+    return result;
+}
+// ── Transcript extraction ────────────────────────────────────────────
+function extractConversation(transcriptPath) {
+    const turns = [];
+    const content = readFileSync(transcriptPath, "utf8");
+    for (const line of content.split("\n")) {
+        if (!line.trim())
+            continue;
+        try {
+            const entry = JSON.parse(line);
+            const msg = entry.message || entry;
+            const role = msg.role || "";
+            let text = msg.content || "";
+            if (!["user", "assistant"].includes(role))
+                continue;
+            if (Array.isArray(text)) {
+                text = text
+                    .filter((b) => typeof b === "string" || (b.type === "text" && b.text))
+                    .map((b) => (typeof b === "string" ? b : b.text))
+                    .join("\n");
+            }
+            if (typeof text === "string" && text.trim()) {
+                const label = role === "user" ? "User" : "Assistant";
+                turns.push(`**${label}:** ${text.trim()}`);
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    let recent = turns.slice(-MAX_TURNS);
+    let context = recent.join("\n\n");
+    if (context.length > MAX_CONTEXT_CHARS) {
+        context = context.slice(-MAX_CONTEXT_CHARS);
+        const boundary = context.indexOf("\n**");
+        if (boundary > 0)
+            context = context.slice(boundary + 1);
+    }
+    return { context: scrub(context), turnCount: recent.length };
+}
+// ── Main ─────────────────────────────────────────────────────────────
+async function main() {
+    // Read hook input from stdin
+    let hookInput = {};
+    try {
+        const raw = readFileSync(0, "utf8");
+        hookInput = JSON.parse(raw);
+    }
+    catch {
+        return; // Can't parse stdin
+    }
+    const sessionId = hookInput.session_id || "unknown";
+    const transcriptPath = hookInput.transcript_path;
+    if (!transcriptPath || !existsSync(transcriptPath))
+        return;
+    // Flush any remaining buffered turns (< BATCH_SIZE) that haven't been sent yet.
+    const POSTER = join(ROOT_DIR, "dist", "hooks", "turn-end-post.js");
+    if (existsSync(POSTER)) {
+        const pending = readBufferedTurns(sessionId);
+        if (pending.length > 0) {
+            clearBuffer(sessionId);
+            const child = spawn("node", [POSTER], {
+                cwd: ROOT_DIR,
+                detached: true,
+                stdio: ["pipe", "ignore", "ignore"],
+                env: { ...process.env, CLAUDE_INVOKED_BY: "ricord_turn_end" },
+            });
+            const pinned = getActiveProject(sessionId);
+            const project = pinned !== null ? pinned : detectProject(process.env.CLAUDE_PROJECT_DIR || process.cwd());
+            child.stdin?.end(JSON.stringify({
+                messages: turnsToMessages(pending),
+                session_id: sessionId,
+                customId: createHash("sha256").update(`session-end:${sessionId}:${pending.length}`).digest("hex").slice(0, 32),
+                async_mode: true,
+                queueing: true,
+                priority: "background",
+                extracted: { anchors: [] },
+                extraction_meta: {
+                    model: "embed-only",
+                    client: "ricord-mcp-hook/session-end",
+                    schema_version: 1,
+                },
+                tags: ["source:claude-code", "session-end-hook", `batch_size:${pending.length}`],
+                ...(project ? { project_id: project } : {}),
+                metadata: { source: "claude-code", batch: true, session_end: true, turn_count: pending.length, ...(project ? { project_id: project } : {}) },
+            }));
+            child.unref();
+        }
+    }
+    // Extract conversation
+    const { context, turnCount } = extractConversation(transcriptPath);
+    if (!context.trim() || turnCount < MIN_TURNS)
+        return;
+    // Write context to temp file for the background flush process
+    if (!existsSync(CONTEXT_DIR))
+        mkdirSync(CONTEXT_DIR, { recursive: true });
+    const timestamp = new Date().toISOString().replace(/[:.]/g, "-").slice(0, 19);
+    const contextFile = join(CONTEXT_DIR, `context-${sessionId}-${timestamp}.md`);
+    // SEC-07: Use mode 0o600 so only the owning user can read the context file.
+    writeFileSync(contextFile, context, { encoding: "utf8", mode: 0o600 });
+    // Spawn flush.js as a detached background process
+    if (!existsSync(FLUSH_SCRIPT)) {
+        // Fallback: flush not built yet, skip silently
+        return;
+    }
+    try {
+        const child = spawn("node", [FLUSH_SCRIPT, contextFile, sessionId], {
+            cwd: ROOT_DIR,
+            detached: true,
+            stdio: "ignore",
+            env: { ...process.env, CLAUDE_INVOKED_BY: "ricord_flush" },
+        });
+        child.unref();
+    }
+    catch {
+        // Silent failure — don't break Claude Code session teardown
+    }
+    clearActiveProject(sessionId);
+}
+main().catch(() => {
+    // Silent failure
+});
+//# sourceMappingURL=session-end.js.map

package/dist/hooks/session-end.js.map

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

package/dist/hooks/session-start.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * SessionStart hook — injects Ricord knowledge context into every Claude Code session.
+ *
+ * Single API call: GET /v1/user/boot-context returns the full session-start
+ * digest (instructions, preferences, top procedures, open tasks, active
+ * projects, counts). Plus the most recent daily log from disk if any.
+ *
+ * 2026-05-01 simplification: dropped the previous 3-call sequence (search +
+ * boot-context + pages). boot-context already covers what the agent needs;
+ * the agent can call ricord_search / ricord_kb on demand.
+ *
+ * No LLM calls — just one Ricord API read + local file I/O. Runs in <1s.
+ */
+export {};