ricord 1.0.0

package/dist/scripts/flush.js

@@ -0,0 +1,230 @@
+#!/usr/bin/env node
+/**
+ * Memory flush — saves the residual session conversation to Ricord.
+ *
+ * Spawned by session-end.ts or pre-compact.ts as a background process.
+ * Reads the conversation context from a temp .md file (markdown turns),
+ * parses it into a messages[] array, and POSTs to /v1/ingest/extracted
+ * with empty anchors (embed-only mode):
+ *   - 1 row written to `memories` (full session, embedded)
+ *   - N rows written to `episodes` (per-turn embedding)
+ *   - Zero server-side LLM calls (post 2026-04-30 client-extraction migration)
+ * Also appends a human-readable summary to today's daily log.
+ *
+ * For full graph extraction (anchors / connections / tasks), the host LLM
+ * runs ricord_extract action="fetch_prompt" + "submit". This script does
+ * NOT do that — keeps the cost predictable (zero server LLM).
+ *
+ * After flushing, if it's past 6 PM local time, auto-triggers compilation.
+ *
+ * Usage:
+ *   node dist/scripts/flush.js <context_file.md> <session_id>
+ */
+import { readFileSync, existsSync, unlinkSync } from "node:fs";
+import { spawn } from "node:child_process";
+import { join } from "node:path";
+// Recursion guard: if spawned by another flush/compile, exit
+if (process.env.CLAUDE_INVOKED_BY) {
+    process.exit(0);
+}
+process.env.CLAUDE_INVOKED_BY = "ricord_flush";
+import { loadCredentials, api, COMPILE_AFTER_HOUR, ROOT_DIR, } from "./config.js";
+import { loadFlushState, saveFlushState, loadState, fileHash, appendToDailyLog, todayLogPath, scrubCredentials, detectProject, detectGitRepo, detectGitBranch, logToFile, } from "./utils.js";
+const DEDUP_COOLDOWN_MS = 60_000; // 60s — same session can't flush twice within this window
+// Convert markdown context (`**User:** ... \n\n**Assistant:** ... \n\n...`)
+// back to a messages[] array for /v1/ingest/extracted. Lines that don't
+// start with a known role marker are appended to the previous message.
+function parseContextToMessages(context) {
+    const messages = [];
+    const blocks = context.split(/\n\n+/);
+    for (const raw of blocks) {
+        const block = raw.trim();
+        if (!block)
+            continue;
+        if (block.startsWith("**User:**")) {
+            messages.push({ role: "user", content: block.replace(/^\*\*User:\*\*\s*/, "").trim() });
+        }
+        else if (block.startsWith("**Assistant:**")) {
+            messages.push({ role: "assistant", content: block.replace(/^\*\*Assistant:\*\*\s*/, "").trim() });
+        }
+        else if (messages.length > 0) {
+            // Continuation of the previous message
+            messages[messages.length - 1].content += "\n\n" + block;
+        }
+    }
+    return messages.filter(m => m.content.length > 0);
+}
+async function extractAndSave(context, apiKey, apiBase, project, sessionId) {
+    const gitRepo = detectGitRepo();
+    const gitBranch = detectGitBranch();
+    const messages = parseContextToMessages(context);
+    let ingested = null;
+    if (messages.length > 0) {
+        const tags = ["auto-flush", "session-log"];
+        if (gitRepo)
+            tags.push(`repo:${gitRepo}`);
+        if (gitBranch)
+            tags.push(`branch:${gitBranch}`);
+        const body = {
+            session_id: sessionId,
+            messages,
+            extracted: { anchors: [] },
+            extraction_meta: {
+                model: "embed-only",
+                client: "ricord-mcp/flush",
+                schema_version: 1,
+            },
+            tags,
+        };
+        if (project)
+            body.project_id = project;
+        try {
+            const result = await api("POST", "/v1/ingest/extracted", body, apiKey, apiBase);
+            ingested = {
+                memory_id: result.memory_id,
+                messages: messages.length,
+            };
+        }
+        catch (e) {
+            logToFile(`ERROR ingest failed for session ${sessionId}: ${e.message}`);
+        }
+    }
+    // Build daily log entry
+    const lines = [];
+    lines.push(`**Context:** Auto-flushed from conversation`);
+    if (project)
+        lines.push(`**Project:** ${project}`);
+    if (ingested) {
+        lines.push("");
+        lines.push(`**Ingested:** 1 memory + ${ingested.messages} episode(s) (embed-only, no graph extraction)${ingested.memory_id ? ` — memory_id ${ingested.memory_id}` : ""}`);
+    }
+    else if (messages.length === 0) {
+        lines.push("", "**Ingested:** (none — context had no parseable turns)");
+    }
+    else {
+        lines.push("", "**Ingested:** (failed — see hook log)");
+    }
+    // Include abbreviated user topics for human-readable daily log
+    const userLines = messages
+        .filter(m => m.role === "user")
+        .map(m => m.content.split("\n")[0].slice(0, 120))
+        .slice(-5);
+    if (userLines.length > 0) {
+        lines.push("");
+        lines.push("**Session Topics:**");
+        for (const topic of userLines) {
+            lines.push(`- ${topic}`);
+        }
+    }
+    return { ingested, dailyEntry: lines.join("\n") };
+}
+function maybeTriggerCompilation() {
+    const now = new Date();
+    const localHour = now.getHours();
+    if (localHour < COMPILE_AFTER_HOUR)
+        return;
+    // Check if today's log has changed since last compile
+    const logPath = todayLogPath();
+    if (!existsSync(logPath))
+        return;
+    const state = loadState();
+    const today = now.toLocaleDateString("en-CA") + ".md";
+    const prev = state.ingested[today];
+    if (prev && prev.hash === fileHash(logPath)) {
+        logToFile("INFO skip compilation — daily log unchanged since last compile");
+        return;
+    }
+    // Spawn compile.ts as background process
+    const compileScript = join(ROOT_DIR, "dist", "scripts", "compile.js");
+    if (!existsSync(compileScript)) {
+        logToFile("WARN compile.js not found, skipping auto-compilation");
+        return;
+    }
+    logToFile(`INFO triggering end-of-day compilation (after ${COMPILE_AFTER_HOUR}:00)`);
+    try {
+        // REL-02: Use "ignore" for child stdio — piping stdout/stderr without reading
+        // can cause the child to block when the pipe buffer fills.
+        const child = spawn("node", [compileScript], {
+            cwd: ROOT_DIR,
+            detached: true,
+            stdio: "ignore",
+            env: { ...process.env, CLAUDE_INVOKED_BY: "ricord_compile" },
+        });
+        child.unref();
+    }
+    catch (e) {
+        logToFile(`ERROR failed to spawn compile: ${e.message}`);
+    }
+}
+async function main() {
+    if (process.argv.length < 4) {
+        logToFile("ERROR usage: flush.js <context_file.md> <session_id>");
+        process.exit(1);
+    }
+    const contextFile = process.argv[2];
+    const sessionId = process.argv[3];
+    logToFile(`INFO flush started: session=${sessionId}`);
+    // SEC-08: Validate contextFile is within the expected temp directory to prevent
+    // path traversal if flush.js is invoked with a crafted argument.
+    const { resolve: resolvePath } = await import("node:path");
+    const { tmpdir: _tmpdir } = await import("node:os");
+    const EXPECTED_CONTEXT_DIR = resolvePath(_tmpdir(), "ricord-contexts");
+    const resolvedContextFile = resolvePath(contextFile);
+    if (!resolvedContextFile.startsWith(EXPECTED_CONTEXT_DIR + "/")) {
+        logToFile(`ERROR context file is outside expected directory: ${resolvedContextFile}`);
+        return;
+    }
+    // Deduplication: same session can't flush twice within cooldown
+    const lastFlush = loadFlushState();
+    if (lastFlush && lastFlush.session_id === sessionId) {
+        const elapsed = Date.now() - lastFlush.timestamp;
+        if (elapsed < DEDUP_COOLDOWN_MS) {
+            logToFile(`INFO skip — session ${sessionId} flushed ${Math.round(elapsed / 1000)}s ago`);
+            return;
+        }
+    }
+    // Read context from temp file
+    if (!existsSync(contextFile)) {
+        logToFile(`ERROR context file not found: ${contextFile}`);
+        return;
+    }
+    let context = readFileSync(contextFile, "utf8");
+    if (!context.trim()) {
+        logToFile("INFO skip — empty context");
+        return;
+    }
+    // Scrub credentials before sending to API
+    context = scrubCredentials(context);
+    // Load credentials
+    const creds = loadCredentials();
+    if (!creds) {
+        logToFile("ERROR no Ricord credentials found");
+        return;
+    }
+    const apiBase = creds.api_base || "https://api.ricord.ai";
+    const project = detectProject();
+    // Extract and save
+    try {
+        const { ingested, dailyEntry } = await extractAndSave(context, creds.api_key, apiBase, project, sessionId);
+        logToFile(`INFO flushed session ${sessionId} — ${ingested ? `1 memory + ${ingested.messages} episodes` : "no rows ingested"}`);
+        // Append to daily log
+        appendToDailyLog(dailyEntry, `Flush (session ${sessionId.slice(0, 8)})`);
+        // Update flush state for dedup
+        saveFlushState({ session_id: sessionId, timestamp: Date.now() });
+        // Maybe trigger compilation
+        maybeTriggerCompilation();
+    }
+    catch (e) {
+        logToFile(`ERROR flush failed: ${e.message}`);
+    }
+    // Clean up temp context file
+    try {
+        unlinkSync(contextFile);
+    }
+    catch { }
+}
+main().catch(e => {
+    logToFile(`FATAL ${e.message}`);
+    process.exit(1);
+});
+//# sourceMappingURL=flush.js.map

package/dist/scripts/flush.js.map

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

package/dist/scripts/lint.d.ts

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+/**
+ * Lint the Ricord knowledge base for health issues.
+ *
+ * Runs health checks against both the local daily logs and the remote
+ * Ricord KB layer. Generates a markdown report in reports/.
+ *
+ * Checks:
+ *   1. Orphan sources  — daily logs that haven't been compiled
+ *   2. Stale articles  — daily logs changed since last compilation
+ *   3. KB lint         — server-side orphans, stale pages, oversize bodies
+ *   4. Sparse items    — knowledge items with very short content
+ *   5. Duplicate titles — items with identical or near-identical titles
+ *   6. Untagged items  — items with no tags (harder to find later)
+ *   7. Empty daily logs — log files with no actual content
+ *
+ * Usage:
+ *   node dist/scripts/lint.js                    # all checks
+ *   node dist/scripts/lint.js --structural-only  # skip API checks (offline)
+ */
+export {};

package/dist/scripts/lint.js

@@ -0,0 +1,242 @@
+#!/usr/bin/env node
+/**
+ * Lint the Ricord knowledge base for health issues.
+ *
+ * Runs health checks against both the local daily logs and the remote
+ * Ricord KB layer. Generates a markdown report in reports/.
+ *
+ * Checks:
+ *   1. Orphan sources  — daily logs that haven't been compiled
+ *   2. Stale articles  — daily logs changed since last compilation
+ *   3. KB lint         — server-side orphans, stale pages, oversize bodies
+ *   4. Sparse items    — knowledge items with very short content
+ *   5. Duplicate titles — items with identical or near-identical titles
+ *   6. Untagged items  — items with no tags (harder to find later)
+ *   7. Empty daily logs — log files with no actual content
+ *
+ * Usage:
+ *   node dist/scripts/lint.js                    # all checks
+ *   node dist/scripts/lint.js --structural-only  # skip API checks (offline)
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { loadCredentials, api, DAILY_DIR, REPORTS_DIR, todayISO, nowISO, } from "./config.js";
+import { loadState, saveState, fileHash, listDailyLogs, detectProject, logToFile, } from "./utils.js";
+// ── Check 1: Orphan sources (daily logs not compiled) ────────────────
+function checkOrphanSources() {
+    const state = loadState();
+    const issues = [];
+    for (const logName of listDailyLogs()) {
+        if (!state.ingested[logName]) {
+            issues.push({
+                severity: "warning",
+                check: "orphan_source",
+                file: `daily/${logName}`,
+                detail: `Uncompiled daily log: ${logName} has not been ingested`,
+            });
+        }
+    }
+    return issues;
+}
+// ── Check 2: Stale articles (source changed since compilation) ───────
+function checkStaleArticles() {
+    const state = loadState();
+    const issues = [];
+    for (const logName of listDailyLogs()) {
+        const prev = state.ingested[logName];
+        if (prev) {
+            const logPath = join(DAILY_DIR, logName);
+            const currentHash = fileHash(logPath);
+            if (prev.hash !== currentHash) {
+                issues.push({
+                    severity: "warning",
+                    check: "stale_article",
+                    file: `daily/${logName}`,
+                    detail: `Stale: ${logName} has changed since last compilation at ${prev.compiled_at}`,
+                });
+            }
+        }
+    }
+    return issues;
+}
+// ── Check 3: KB lint (server-side) ───────────────────────────────────
+async function checkKBLint(apiKey, apiBase, project) {
+    const issues = [];
+    try {
+        const body = {};
+        if (project)
+            body.project_id = project;
+        const result = await api("POST", "/v1/kb/lint", body, apiKey, apiBase);
+        for (const issue of result.issues || []) {
+            issues.push({
+                severity: issue.severity === "error" ? "error" : "warning",
+                check: `kb_${issue.type}`,
+                file: issue.page_id || "(kb)",
+                detail: issue.message,
+            });
+        }
+    }
+    catch (e) {
+        issues.push({
+            severity: "error",
+            check: "kb_lint",
+            file: "(system)",
+            detail: `KB lint API call failed: ${e.message}`,
+        });
+    }
+    return issues;
+}
+// ── Check 4: Sparse items ────────────────────────────────────────────
+async function checkSparseItems(apiKey, apiBase, project) {
+    const issues = [];
+    try {
+        const params = project ? `?project_id=${project}&limit=100` : "?limit=100";
+        const result = await api("GET", `/v1/memories${params}`, undefined, apiKey, apiBase);
+        for (const item of result.memories || []) {
+            const wordCount = (item.content || "").split(/\s+/).filter(Boolean).length;
+            if (wordCount < 10) {
+                issues.push({
+                    severity: "suggestion",
+                    check: "sparse_item",
+                    file: item.id,
+                    detail: `Sparse: "${item.title}" has only ${wordCount} words`,
+                });
+            }
+        }
+    }
+    catch (e) {
+        logToFile(`WARN sparse check failed: ${e.message}`);
+    }
+    return issues;
+}
+// ── Check 5: Duplicate titles ────────────────────────────────────────
+async function checkDuplicateTitles(apiKey, apiBase, project) {
+    const issues = [];
+    try {
+        const params = project ? `?project_id=${project}&limit=200` : "?limit=200";
+        const result = await api("GET", `/v1/memories${params}`, undefined, apiKey, apiBase);
+        const titleMap = new Map();
+        for (const item of result.memories || []) {
+            const normalized = item.title.toLowerCase().trim();
+            const ids = titleMap.get(normalized) || [];
+            ids.push(item.id);
+            titleMap.set(normalized, ids);
+        }
+        for (const [title, ids] of titleMap) {
+            if (ids.length > 1) {
+                issues.push({
+                    severity: "warning",
+                    check: "duplicate_title",
+                    file: ids.join(", "),
+                    detail: `Duplicate title: "${title}" appears ${ids.length} times`,
+                });
+            }
+        }
+    }
+    catch (e) {
+        logToFile(`WARN duplicate check failed: ${e.message}`);
+    }
+    return issues;
+}
+// ── Check 6: Empty daily logs ────────────────────────────────────────
+function checkEmptyDailyLogs() {
+    const issues = [];
+    for (const logName of listDailyLogs()) {
+        const logPath = join(DAILY_DIR, logName);
+        const content = readFileSync(logPath, "utf8");
+        // A "template only" log has the header but no session content
+        const stripped = content
+            .replace(/^#.*$/gm, "")
+            .replace(/^##.*$/gm, "")
+            .trim();
+        if (stripped.length < 50) {
+            issues.push({
+                severity: "suggestion",
+                check: "empty_log",
+                file: `daily/${logName}`,
+                detail: `Empty or near-empty daily log: ${logName}`,
+            });
+        }
+    }
+    return issues;
+}
+// ── Report generation ────────────────────────────────────────────────
+function generateReport(issues) {
+    const errors = issues.filter(i => i.severity === "error");
+    const warnings = issues.filter(i => i.severity === "warning");
+    const suggestions = issues.filter(i => i.severity === "suggestion");
+    const lines = [
+        `# Ricord Lint Report — ${todayISO()}`,
+        "",
+        `**Total issues:** ${issues.length}`,
+        `- Errors: ${errors.length}`,
+        `- Warnings: ${warnings.length}`,
+        `- Suggestions: ${suggestions.length}`,
+        "",
+    ];
+    const sections = [
+        ["Errors", errors, "x"],
+        ["Warnings", warnings, "!"],
+        ["Suggestions", suggestions, "?"],
+    ];
+    for (const [label, items, marker] of sections) {
+        if (items.length > 0) {
+            lines.push(`## ${label}`);
+            lines.push("");
+            for (const issue of items) {
+                lines.push(`- **[${marker}]** \`${issue.file}\` — ${issue.detail}`);
+            }
+            lines.push("");
+        }
+    }
+    if (issues.length === 0) {
+        lines.push("All checks passed. Knowledge base is healthy.");
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+async function main() {
+    const args = process.argv.slice(2);
+    const structuralOnly = args.includes("--structural-only");
+    console.log(`Ricord KB Lint — ${todayISO()}`);
+    console.log("=".repeat(40));
+    const allIssues = [];
+    // Structural checks (no API needed)
+    console.log("\nRunning structural checks...");
+    allIssues.push(...checkOrphanSources());
+    allIssues.push(...checkStaleArticles());
+    allIssues.push(...checkEmptyDailyLogs());
+    // API-backed checks
+    if (!structuralOnly) {
+        const creds = loadCredentials();
+        if (!creds) {
+            console.error("No Ricord credentials — skipping API checks. Use --structural-only for offline mode.");
+        }
+        else {
+            const apiBase = creds.api_base || "https://api.ricord.ai";
+            const project = detectProject();
+            console.log("Running API-backed checks...");
+            allIssues.push(...await checkKBLint(creds.api_key, apiBase, project));
+            allIssues.push(...await checkSparseItems(creds.api_key, apiBase, project));
+            allIssues.push(...await checkDuplicateTitles(creds.api_key, apiBase, project));
+        }
+    }
+    // Generate report
+    const report = generateReport(allIssues);
+    console.log("\n" + report);
+    // Save report to file
+    if (!existsSync(REPORTS_DIR))
+        mkdirSync(REPORTS_DIR, { recursive: true });
+    const reportPath = join(REPORTS_DIR, `lint-${todayISO()}.md`);
+    writeFileSync(reportPath, report, "utf8");
+    console.log(`Report saved to: ${reportPath}`);
+    // Update state
+    const state = loadState();
+    state.last_lint = nowISO();
+    saveState(state);
+}
+main().catch(e => {
+    console.error(`Fatal: ${e.message}`);
+    process.exit(1);
+});
+//# sourceMappingURL=lint.js.map

package/dist/scripts/lint.js.map

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

package/dist/scripts/utils.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Shared utilities for Ricord scripts.
+ *
+ * Helpers for state tracking, file hashing, daily log manipulation,
+ * credential scrubbing, and JSONL transcript parsing.
+ */
+export interface CompileState {
+    ingested: Record<string, {
+        hash: string;
+        compiled_at: string;
+        cost_usd?: number;
+    }>;
+    total_cost: number;
+    query_count: number;
+    last_lint: string;
+}
+export declare function loadState(): CompileState;
+export declare function saveState(state: CompileState): void;
+export interface FlushState {
+    session_id: string;
+    timestamp: number;
+}
+export declare function loadFlushState(): FlushState | null;
+export declare function saveFlushState(state: FlushState): void;
+export declare function fileHash(path: string): string;
+export declare function ensureDailyDir(): void;
+export declare function todayLogPath(): string;
+export declare function appendToDailyLog(content: string, section?: string): void;
+export declare function listDailyLogs(): string[];
+export interface ConversationTurn {
+    role: "user" | "assistant";
+    text: string;
+}
+export declare function extractConversation(transcriptPath: string, maxTurns?: number, maxChars?: number): {
+    turns: ConversationTurn[];
+    context: string;
+    turnCount: number;
+};
+export declare function scrubCredentials(text: string): string;
+export declare function detectProject(): string;
+export declare function detectGitRepo(): string;
+export declare function detectGitBranch(): string;
+export declare function logToFile(message: string, file?: string): void;