agent-recall-core 3.4.22 → 3.4.24

package/dist/helpers/activity-feed.d.ts

@@ -0,0 +1,27 @@
+/**
+ * activity-feed — build a recent-activity timeline for a project.
+ *
+ * Merges events from:
+ *   - journal/*.md          → kind:"session_end", ts from frontmatter `created` or filename date
+ *   - corrections/*.json    → kind:"correction" (active) / "retracted" (active:false)
+ *   - corrections/_outcomes.jsonl → kind:"retrieved"|"heeded"|"recurred"
+ *   - palace/pipeline/*.md  → kind:"phase_open"/"phase_close" from status+opened/closed
+ *   - palace/skills/*.md    → kind:"skill_write", ts from frontmatter `created`
+ *
+ * Each event: { ts: ISO, kind, desc: <=120 chars }
+ * Sorted newest-first, capped at limit (default 20).
+ * Be defensive: missing dir/file → skip. Never throws.
+ */
+export interface ActivityEvent {
+    ts: string;
+    kind: "session_end" | "correction" | "retracted" | "retrieved" | "heeded" | "recurred" | "phase_open" | "phase_close" | "skill_write";
+    desc: string;
+}
+/**
+ * Build a recent-activity feed for a project.
+ *
+ * Merges events from all five sources, sorts newest-first, caps at limit.
+ * Returns [] on any error — never throws.
+ */
+export declare function buildRecentActivity(slug: string, limit?: number): ActivityEvent[];
+//# sourceMappingURL=activity-feed.d.ts.map

package/dist/helpers/activity-feed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-feed.d.ts","sourceRoot":"","sources":["../../src/helpers/activity-feed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAOH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EACA,aAAa,GACb,YAAY,GACZ,WAAW,GACX,WAAW,GACX,QAAQ,GACR,UAAU,GACV,YAAY,GACZ,aAAa,GACb,aAAa,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAiQD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,KAAK,SAAK,GACT,aAAa,EAAE,CAiBjB"}

package/dist/helpers/activity-feed.js

@@ -0,0 +1,276 @@
+/**
+ * activity-feed — build a recent-activity timeline for a project.
+ *
+ * Merges events from:
+ *   - journal/*.md          → kind:"session_end", ts from frontmatter `created` or filename date
+ *   - corrections/*.json    → kind:"correction" (active) / "retracted" (active:false)
+ *   - corrections/_outcomes.jsonl → kind:"retrieved"|"heeded"|"recurred"
+ *   - palace/pipeline/*.md  → kind:"phase_open"/"phase_close" from status+opened/closed
+ *   - palace/skills/*.md    → kind:"skill_write", ts from frontmatter `created`
+ *
+ * Each event: { ts: ISO, kind, desc: <=120 chars }
+ * Sorted newest-first, capped at limit (default 20).
+ * Be defensive: missing dir/file → skip. Never throws.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { palaceDir } from "../storage/paths.js";
+import { getRoot } from "../types.js";
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/**
+ * Safely read a file to string. Returns null on any error.
+ */
+function safeRead(p) {
+    try {
+        return fs.readFileSync(p, "utf-8");
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * List files in a directory matching a filter. Returns [] if dir absent/unreadable.
+ */
+function safeReaddir(dir, filter) {
+    try {
+        if (!fs.existsSync(dir))
+            return [];
+        return fs.readdirSync(dir).filter(filter);
+    }
+    catch {
+        return [];
+    }
+}
+function trunc(s, maxLen = 120) {
+    return s.length > maxLen ? s.slice(0, maxLen - 1) + "…" : s;
+}
+/**
+ * Extract `created` ISO string from YAML-ish frontmatter.
+ * Returns null when absent or malformed.
+ */
+function extractFrontmatterCreated(content) {
+    const fm = content.match(/^---\s*\r?\n([\s\S]*?)\r?\n---\s*\r?\n/);
+    if (!fm)
+        return null;
+    const line = fm[1].split(/\r?\n/).find((l) => /^created\s*:/.test(l));
+    if (!line)
+        return null;
+    const raw = line.slice(line.indexOf(":") + 1).trim();
+    // Accept bare ISO or quoted ISO
+    const stripped = raw.replace(/^"|"$/g, "").replace(/^'|'$/g, "");
+    // Validate: must start with YYYY-MM-DD
+    if (!/^\d{4}-\d{2}-\d{2}/.test(stripped))
+        return null;
+    return stripped;
+}
+/**
+ * Convert YYYY-MM-DD date string to a midnight ISO timestamp.
+ * Used as a fallback when no precise timestamp is available.
+ */
+function dateToTs(date) {
+    return `${date}T00:00:00.000Z`;
+}
+// ---------------------------------------------------------------------------
+// Per-source event builders
+// ---------------------------------------------------------------------------
+function journalEvents(slug) {
+    const journalDir = path.join(getRoot(), "projects", slug, "journal");
+    const files = safeReaddir(journalDir, (f) => f.endsWith(".md") && f !== "index.md");
+    const events = [];
+    for (const f of files) {
+        // Skip capture/log files — not session completions
+        if (f.includes("-log.md") || f.includes("--capture--"))
+            continue;
+        const dateMatch = f.match(/^(\d{4}-\d{2}-\d{2})/);
+        if (!dateMatch)
+            continue;
+        const fileDate = dateMatch[1];
+        const content = safeRead(path.join(journalDir, f));
+        const created = content ? extractFrontmatterCreated(content) : null;
+        const ts = created ?? dateToTs(fileDate);
+        // Extract a brief description: first non-empty, non-header line after frontmatter
+        let desc = `Session on ${fileDate}`;
+        if (content) {
+            const lines = content.split("\n");
+            for (const line of lines) {
+                const t = line.trim();
+                if (t && !t.startsWith("#") && !t.startsWith("---") && !t.startsWith(">")) {
+                    desc = trunc(`Session ${fileDate}: ${t}`);
+                    break;
+                }
+            }
+        }
+        events.push({ ts, kind: "session_end", desc });
+    }
+    return events;
+}
+function correctionEvents(slug) {
+    const corrDir = path.join(getRoot(), "projects", slug, "corrections");
+    const files = safeReaddir(corrDir, (f) => f.endsWith(".json") && !f.startsWith("_"));
+    const events = [];
+    for (const f of files) {
+        const raw = safeRead(path.join(corrDir, f));
+        if (!raw)
+            continue;
+        let rec;
+        try {
+            rec = JSON.parse(raw);
+        }
+        catch {
+            continue;
+        }
+        const dateStr = typeof rec.date === "string" ? rec.date : "";
+        const rule = typeof rec.rule === "string" ? rec.rule : "";
+        const isActive = rec.active !== false;
+        // Use retracted_at for retracted items, else fall back to date
+        let ts;
+        if (!isActive && typeof rec.retracted_at === "string") {
+            ts = rec.retracted_at;
+        }
+        else {
+            ts = dateToTs(dateStr);
+        }
+        const kind = isActive ? "correction" : "retracted";
+        const prefix = isActive ? "Correction" : "Retracted";
+        const desc = trunc(`${prefix}: ${rule}`);
+        events.push({ ts, kind, desc });
+    }
+    return events;
+}
+function outcomeEvents(slug) {
+    const outcomesPath = path.join(getRoot(), "projects", slug, "corrections", "_outcomes.jsonl");
+    const raw = safeRead(outcomesPath);
+    if (!raw)
+        return [];
+    const events = [];
+    for (const line of raw.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        let obj;
+        try {
+            obj = JSON.parse(trimmed);
+        }
+        catch {
+            continue;
+        }
+        const kind = obj.kind;
+        if (kind !== "retrieved" && kind !== "heeded" && kind !== "recurred")
+            continue;
+        const ts = typeof obj.at === "string" ? obj.at : "";
+        if (!ts)
+            continue;
+        const corrId = typeof obj.correction_id === "string" ? obj.correction_id : "?";
+        const evidence = typeof obj.evidence === "string" ? ` (${obj.evidence})` : "";
+        const desc = trunc(`${kind.charAt(0).toUpperCase() + kind.slice(1)}: ${corrId}${evidence}`);
+        events.push({
+            ts,
+            kind: kind,
+            desc,
+        });
+    }
+    return events;
+}
+function pipelineEvents(slug) {
+    const pDir = path.join(palaceDir(slug), "pipeline");
+    const files = safeReaddir(pDir, (f) => f.endsWith(".md") && /^\d+-/.test(f));
+    const events = [];
+    for (const f of files) {
+        const content = safeRead(path.join(pDir, f));
+        if (!content)
+            continue;
+        // Parse frontmatter minimally
+        const fm = content.match(/^---\s*\r?\n([\s\S]*?)\r?\n---\s*\r?\n/);
+        if (!fm)
+            continue;
+        const lines = fm[1].split(/\r?\n/);
+        const meta = {};
+        for (const l of lines) {
+            const idx = l.indexOf(":");
+            if (idx < 0)
+                continue;
+            const key = l.slice(0, idx).trim();
+            meta[key] = l.slice(idx + 1).trim().replace(/^"|"$/g, "");
+        }
+        const phase = meta.phase ?? path.basename(f, ".md");
+        const status = meta.status ?? "active";
+        const opened = meta.opened ?? "";
+        const closed = meta.closed ?? "";
+        if (opened) {
+            events.push({
+                ts: /^\d{4}-\d{2}-\d{2}/.test(opened) ? dateToTs(opened) : opened,
+                kind: "phase_open",
+                desc: trunc(`Phase opened: ${phase}`),
+            });
+        }
+        if ((status === "closed" || status === "abandoned") && closed) {
+            events.push({
+                ts: /^\d{4}-\d{2}-\d{2}/.test(closed) ? dateToTs(closed) : closed,
+                kind: "phase_close",
+                desc: trunc(`Phase ${status}: ${phase}`),
+            });
+        }
+    }
+    return events;
+}
+function skillEvents(slug) {
+    const sDir = path.join(palaceDir(slug), "skills");
+    const files = safeReaddir(sDir, (f) => f.endsWith(".md") && /^\d+-/.test(f));
+    const events = [];
+    for (const f of files) {
+        const content = safeRead(path.join(sDir, f));
+        const created = content ? extractFrontmatterCreated(content) : null;
+        if (!created) {
+            // Fallback: file mtime
+            try {
+                const stat = fs.statSync(path.join(sDir, f));
+                const name = path.basename(f, ".md").replace(/^\d+-/, "");
+                events.push({
+                    ts: stat.mtime.toISOString(),
+                    kind: "skill_write",
+                    desc: trunc(`Skill written: ${name}`),
+                });
+            }
+            catch {
+                // Skip entirely
+            }
+            continue;
+        }
+        const name = path.basename(f, ".md").replace(/^\d+-/, "");
+        events.push({
+            ts: created,
+            kind: "skill_write",
+            desc: trunc(`Skill written: ${name}`),
+        });
+    }
+    return events;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Build a recent-activity feed for a project.
+ *
+ * Merges events from all five sources, sorts newest-first, caps at limit.
+ * Returns [] on any error — never throws.
+ */
+export function buildRecentActivity(slug, limit = 20) {
+    try {
+        const all = [
+            ...journalEvents(slug),
+            ...correctionEvents(slug),
+            ...outcomeEvents(slug),
+            ...pipelineEvents(slug),
+            ...skillEvents(slug),
+        ];
+        // Sort descending by ts (ISO strings sort lexicographically)
+        all.sort((a, b) => b.ts.localeCompare(a.ts));
+        return all.slice(0, limit);
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=activity-feed.js.map

package/dist/helpers/activity-feed.js.map

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

package/dist/helpers/handoff.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Handoff artifact — portable cross-agent briefing written at session_end.
+ *
+ * Automaticity Law: the file appears at projects/<slug>/handoff.md automatically
+ * every session_end; no new MCP tool, no agent prompt needed.
+ *
+ * Budget: HARD LIMIT 2200 chars (~500 tokens). Content is truncated at word
+ * boundaries and sections are omitted when empty.
+ */
+export interface HandoffResult {
+    path: string;
+    tokens_estimate: number;
+}
+/**
+ * Generate the handoff markdown for a project.
+ * Pure function — reads stores, returns a string.
+ * Never throws: missing stores produce empty sections which are omitted.
+ */
+export declare function generateHandoff(slug: string): string;
+/**
+ * Write the handoff file for a project atomically.
+ * Returns path and rough token estimate (chars / 4).
+ * Never throws — errors are propagated to caller for fire-and-forget swallowing.
+ */
+export declare function writeHandoff(slug: string): HandoffResult;
+//# sourceMappingURL=handoff.d.ts.map

package/dist/helpers/handoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handoff.d.ts","sourceRoot":"","sources":["../../src/helpers/handoff.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA+CH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAmJpD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAuBxD"}

package/dist/helpers/handoff.js

@@ -0,0 +1,225 @@
+/**
+ * Handoff artifact — portable cross-agent briefing written at session_end.
+ *
+ * Automaticity Law: the file appears at projects/<slug>/handoff.md automatically
+ * every session_end; no new MCP tool, no agent prompt needed.
+ *
+ * Budget: HARD LIMIT 2200 chars (~500 tokens). Content is truncated at word
+ * boundaries and sections are omitted when empty.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { getRoot } from "../types.js";
+import { readP0Corrections } from "../storage/corrections.js";
+import { readBehaviorPolicies } from "../storage/behavior-policies.js";
+import { readInsightsIndex } from "../palace/insights-index.js";
+import { readIdentity } from "../palace/identity.js";
+import { ensureDir } from "../storage/fs-utils.js";
+import { listJournalFiles } from "./journal-files.js";
+const HARD_BUDGET = 2200;
+/**
+ * Truncate a string at word boundary, appending "…" if truncated.
+ */
+function truncateAt(text, maxChars) {
+    if (text.length <= maxChars)
+        return text;
+    const cut = text.lastIndexOf(" ", maxChars - 1);
+    const boundary = cut > 0 ? cut : maxChars;
+    return text.slice(0, boundary) + "…";
+}
+/**
+ * Extract the first meaningful (non-heading, non-blank) line from a markdown string.
+ * Returns empty string when nothing is found.
+ */
+function firstMeaningfulLine(md) {
+    for (const line of md.split("\n")) {
+        const t = line.trim();
+        if (t && !t.startsWith("#") && !t.startsWith(">") && !t.startsWith("---")) {
+            return t;
+        }
+    }
+    return "";
+}
+/**
+ * Local-date string in YYYY-MM-DD format (system TZ).
+ */
+function localDate() {
+    return new Date().toLocaleDateString("sv"); // 'sv' locale gives YYYY-MM-DD
+}
+/**
+ * Generate the handoff markdown for a project.
+ * Pure function — reads stores, returns a string.
+ * Never throws: missing stores produce empty sections which are omitted.
+ */
+export function generateHandoff(slug) {
+    const date = localDate();
+    const lines = [];
+    // ── Header ────────────────────────────────────────────────────────────────
+    lines.push(`# Handoff — ${slug} (${date})`);
+    lines.push("");
+    // ── Intention ─────────────────────────────────────────────────────────────
+    try {
+        const identity = readIdentity(slug);
+        let intention = firstMeaningfulLine(identity);
+        // identity.md often already starts with "**Intention:** ..." — strip the
+        // prefix so the template's own label doesn't double it.
+        if (intention)
+            intention = intention.replace(/^\*{0,2}Intention:?\*{0,2}\s*/i, "");
+        if (intention) {
+            lines.push(`**Intention:** ${intention}`);
+            lines.push("");
+        }
+    }
+    catch { /* omit */ }
+    // ── Binding rules (P0 corrections, ≤5) ───────────────────────────────────
+    try {
+        const p0 = readP0Corrections(slug).slice(0, 5);
+        if (p0.length > 0) {
+            lines.push("## Binding rules");
+            for (const c of p0) {
+                lines.push(`- ${c.rule}`);
+            }
+            lines.push("");
+        }
+    }
+    catch { /* omit */ }
+    // ── Behavior policies (≤3) ────────────────────────────────────────────────
+    try {
+        const { rules } = readBehaviorPolicies(slug);
+        const top = rules.slice(0, 3);
+        if (top.length > 0) {
+            lines.push("## Behavior policies");
+            for (const r of top) {
+                lines.push(`- **${r.name}**: ${r.do}`);
+            }
+            lines.push("");
+        }
+    }
+    catch { /* omit */ }
+    // ── Active blockers (from latest journal "## Blockers" section) ───────────
+    try {
+        const entries = listJournalFiles(slug);
+        if (entries.length > 0) {
+            const latest = entries[0];
+            const content = fs.readFileSync(path.join(latest.dir, latest.file), "utf-8");
+            // extractSection expects the SECTION_HEADERS map key; check if a
+            // "## Blockers" heading is present by scanning directly (no SECTION_HEADERS key).
+            const blockerIdx = content.indexOf("## Blockers");
+            if (blockerIdx !== -1) {
+                const section = content.slice(blockerIdx);
+                const sectionLines = section.split("\n");
+                const body = [];
+                for (let i = 1; i < sectionLines.length; i++) {
+                    if (sectionLines[i].startsWith("## "))
+                        break;
+                    const t = sectionLines[i].trim();
+                    if (t)
+                        body.push(t);
+                }
+                if (body.length > 0) {
+                    lines.push("## Active blockers");
+                    lines.push(body.slice(0, 5).join("\n"));
+                    lines.push("");
+                }
+            }
+        }
+    }
+    catch { /* omit */ }
+    // ── Top insights (≤3, highest confirmed_count for this project) ───────────
+    try {
+        const index = readInsightsIndex();
+        const projectInsights = index.insights
+            .filter((i) => !i.projects || i.projects.length === 0 || i.projects.includes(slug))
+            .sort((a, b) => b.confirmed_count - a.confirmed_count)
+            .slice(0, 3);
+        if (projectInsights.length > 0) {
+            lines.push("## Top insights");
+            for (const ins of projectInsights) {
+                lines.push(`- ${ins.title} (confirmed ×${ins.confirmed_count})`);
+            }
+            lines.push("");
+        }
+    }
+    catch { /* omit */ }
+    // ── Trajectory (## Next from newest journal) ──────────────────────────────
+    try {
+        const entries = listJournalFiles(slug);
+        if (entries.length > 0) {
+            const latest = entries[0];
+            const content = fs.readFileSync(path.join(latest.dir, latest.file), "utf-8");
+            // Use extractSection for the "next" key if available; fall back to raw scan.
+            let nextText = null;
+            const nextIdx = content.indexOf("## Next");
+            if (nextIdx !== -1) {
+                const section = content.slice(nextIdx);
+                const sectionLines = section.split("\n");
+                const body = [];
+                for (let i = 1; i < sectionLines.length; i++) {
+                    if (sectionLines[i].startsWith("## "))
+                        break;
+                    const t = sectionLines[i].trim();
+                    if (t)
+                        body.push(t);
+                }
+                if (body.length > 0) {
+                    nextText = body.join(" ");
+                }
+            }
+            if (nextText) {
+                lines.push("## Trajectory");
+                lines.push(truncateAt(nextText, 300));
+                lines.push("");
+            }
+        }
+    }
+    catch { /* omit */ }
+    // ── Footer ────────────────────────────────────────────────────────────────
+    lines.push("---");
+    lines.push("*Generated by AgentRecall session_end · paste into any agent*");
+    // ── Budget enforcement ─────────────────────────────────────────────────────
+    // HARD LIMIT: output MUST NOT exceed HARD_BUDGET characters.
+    // Truncate at word boundary, preserving the footer.
+    const footer = "\n---\n*Generated by AgentRecall session_end · paste into any agent*";
+    let body = lines.join("\n");
+    // Remove the footer from body before budget check, re-append after.
+    const bodyWithoutFooter = body.endsWith(footer)
+        ? body.slice(0, body.length - footer.length)
+        : body.slice(0, body.lastIndexOf("\n---\n"));
+    if (body.length > HARD_BUDGET) {
+        const budgetForBody = HARD_BUDGET - footer.length - 1;
+        const truncated = truncateAt(bodyWithoutFooter.trimEnd(), budgetForBody);
+        body = truncated + "\n" + footer;
+    }
+    // Assertion: enforce hard budget (catches regressions in section growth).
+    if (body.length > HARD_BUDGET) {
+        // Last-resort hard slice at word boundary.
+        body = truncateAt(body, HARD_BUDGET);
+    }
+    return body;
+}
+/**
+ * Write the handoff file for a project atomically.
+ * Returns path and rough token estimate (chars / 4).
+ * Never throws — errors are propagated to caller for fire-and-forget swallowing.
+ */
+export function writeHandoff(slug) {
+    const root = getRoot();
+    // Sanitize slug for path safety (same pattern as sanitizeProject).
+    const safe = (slug || "unnamed")
+        .replace(/[^a-zA-Z0-9_\-]/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 100) || "unnamed";
+    const projectDir = path.join(root, "projects", safe);
+    ensureDir(projectDir);
+    const handoffPath = path.join(projectDir, "handoff.md");
+    const content = generateHandoff(slug);
+    // Atomic write: tmp + rename (POSIX-atomic).
+    const tmp = `${handoffPath}.tmp.${process.pid}.${Date.now()}`;
+    fs.writeFileSync(tmp, content, { encoding: "utf-8", mode: 0o600 });
+    fs.renameSync(tmp, handoffPath);
+    return {
+        path: handoffPath,
+        tokens_estimate: Math.ceil(content.length / 4),
+    };
+}
+//# sourceMappingURL=handoff.js.map

package/dist/helpers/handoff.js.map

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

package/dist/index.d.ts

@@ -13,7 +13,7 @@ export type { FanOutResult } from "./palace/fan-out.js";
 export { readAwareness, writeAwareness, readAwarenessState, writeAwarenessState, initAwareness, addInsight, detectCompoundInsights, renderAwareness, readAwarenessArchive, writeAwarenessArchive, resurrectFromArchive, } from "./palace/awareness.js";
 export type { Insight, CompoundInsight, AwarenessState, } from "./palace/awareness.js";
 export { computeSalience, ARCHIVE_THRESHOLD, AUTO_ARCHIVE_THRESHOLD, CATEGORY_DECAY, URGENCY_WEIGHTS, } from "./palace/salience.js";
-export { readInsightsIndex, writeInsightsIndex, addIndexedInsight, recallInsights, } from "./palace/insights-index.js";
+export { readInsightsIndex, writeInsightsIndex, addIndexedInsight, recallInsights, findSimilarInsight, normalizeTitle, tokenOverlap, } from "./palace/insights-index.js";
 export type { IndexedInsight, InsightsIndex, } from "./palace/insights-index.js";
 export { readIdentity, writeIdentity } from "./palace/identity.js";
 export { readPalaceIndex, updatePalaceIndex } from "./palace/index-manager.js";
@@ -37,8 +37,8 @@ export type { CheckActionInput, CheckActionResult, RuleMatch, CorrectionMatch, I
 export { getSessionId, journalFileName, captureLogFileName, resetOwnedFiles, resetSessionState } from "./storage/session.js";
 export type { SaveType, SmartNameOpts } from "./storage/session.js";
 export { acquireLock, withLock } from "./storage/filelock.js";
-export { writeCorrection, readCorrections, readActiveCorrections, readP0Corrections } from "./storage/corrections.js";
-export type { CorrectionRecord } from "./storage/corrections.js";
+export { writeCorrection, readCorrections, readActiveCorrections, readP0Corrections, retractCorrection, isLikelyRealCorrection, } from "./storage/corrections.js";
+export type { CorrectionRecord, WriteCorrectionResult, RetractCorrectionResult, } from "./storage/corrections.js";
 export { listJournalFiles, readJournalFile, extractTitle, extractMomentum, countLogEntries, updateIndex, } from "./helpers/journal-files.js";
 export { extractSection, appendToSection } from "./helpers/sections.js";
 export { isoWeek, weekKey, groupByWeek, synthesizeWeek } from "./helpers/rollup.js";
@@ -55,6 +55,8 @@ export { stem, getSynonyms, expandQuery } from "./helpers/normalize.js";
 export { isJournalFile } from "./helpers/journal-filter.js";
 export { readAlignmentLog, extractWatchPatterns } from "./helpers/alignment-patterns.js";
 export type { WatchForPattern } from "./helpers/alignment-patterns.js";
+export { generateHandoff, writeHandoff } from "./helpers/handoff.js";
+export type { HandoffResult } from "./helpers/handoff.js";
 export { journalRead, type JournalReadInput, type JournalReadResult } from "./tools-logic/journal-read.js";
 export { journalWrite, type JournalWriteInput, type JournalWriteResult } from "./tools-logic/journal-write.js";
 export { journalCapture, type JournalCaptureInput, type JournalCaptureResult } from "./tools-logic/journal-capture.js";
@@ -81,7 +83,7 @@ export { recallInsight, type RecallInsightInput, type RecallInsightResult } from
 export { journalMerge, type JournalMergeInput, type MergeReceipt } from "./tools-logic/journal-merge.js";
 export { smartRemember, type SmartRememberInput, type SmartRememberResult } from "./tools-logic/smart-remember.js";
 export { smartRemember as remember } from "./tools-logic/smart-remember.js";
-export { smartRecall, type SmartRecallInput, type SmartRecallResult, type SmartRecallResultItem } from "./tools-logic/smart-recall.js";
+export { smartRecall, type SmartRecallInput, type SmartRecallResult, type SmartRecallResultItem, type SmartRecallDegraded } from "./tools-logic/smart-recall.js";
 export { sessionStart, type SessionStartInput, type SessionStartResult } from "./tools-logic/session-start.js";
 export { sessionEnd, checkInsightQuality, type SessionEndInput, type SessionEndResult, type InsightQualityWarning, type MergeSuggestion } from "./tools-logic/session-end.js";
 export { promoteConfirmedInsights, type PromotionResult } from "./tools-logic/insight-promotion.js";
@@ -103,7 +105,7 @@ export { OpenAIEmbedding, VoyageEmbedding, zeroPad, createEmbeddingProvider } fr
 export type { EmbeddingProvider } from "./supabase/embedding.js";
 export { syncToSupabase, backfill, contentHash, parseMemoryFile, deriveSlug, logSyncError } from "./supabase/sync.js";
 export type { ParsedMemoryFile } from "./supabase/sync.js";
-export { LocalRecallBackend, getRecallBackend, resetRecallBackend } from "./tools-logic/recall-backend.js";
+export { LocalRecallBackend, getRecallBackend, resetRecallBackend, recordRemoteFailure, recordRemoteSuccess } from "./tools-logic/recall-backend.js";
 export type { RecallBackend } from "./tools-logic/recall-backend.js";
 export { SupabaseRecallBackend } from "./supabase/recall-backend.js";
 export { LocalVectorRecallBackend } from "./vector/local-vector-backend.js";
@@ -143,5 +145,7 @@ export type { SessionStartLiteInput, SessionStartLiteResult } from "./tools-logi
 export { sessionEndReflect } from "./tools-logic/session-end-reflect.js";
 export type { ReflectInput, ReflectResult, ReflectInputBundle } from "./tools-logic/session-end-reflect.js";
 export { dashboardExport } from "./tools-logic/dashboard-export.js";
-export type { DashboardExportInput, DashboardExportResult, DashboardSnapshot, DashboardProjectSnapshot, } from "./tools-logic/dashboard-export.js";
+export type { DashboardExportInput, DashboardExportResult, DashboardSnapshot, DashboardProjectSnapshot, DashboardDreamHealth, DreamHealthCell, } from "./tools-logic/dashboard-export.js";
+export { buildRecentActivity } from "./helpers/activity-feed.js";
+export type { ActivityEvent } from "./helpers/activity-feed.js";
 //# sourceMappingURL=index.d.ts.map