@mono-agent/memory 0.4.1

package/dist/bujo/reconcile.js

@@ -0,0 +1,190 @@
+import { relative } from "node:path";
+import { appendBullet, dailyFilePath, rewriteBullet } from "./daily.js";
+import { parseJsonLoose } from "./json.js";
+import { MemoryModelError } from "./model-error.js";
+const VALID_ACTIONS = new Set(["add", "update", "supersede", "noop"]);
+/**
+ * Reconcile distilled candidates against the existing memory index, writing to BOTH the
+ * canonical markdown daily files and the SQLite index. Each candidate is handled independently
+ * (an LLM/IO failure on one does not abort the others). The LLM is consulted only for candidates
+ * that are close to an existing memory; clearly-novel candidates are added without an LLM call.
+ */
+export async function reconcile(candidates, deps) {
+    const threadThreshold = deps.threadThreshold ?? 0.35;
+    const dupThreshold = deps.dupThreshold ?? 0.5;
+    const actions = [];
+    for (const candidate of candidates) {
+        try {
+            // findSimilar embeds the query, so a down embedding model throws here for EVERY candidate —
+            // a systemic outage, not a per-item data problem. Tag it so the catch below surfaces it.
+            let similar;
+            try {
+                similar = await deps.db.findSimilar(candidate.text, 5);
+            }
+            catch (cause) {
+                throw new MemoryModelError("embedding", "findSimilar", cause);
+            }
+            // Clearly novel (nothing close enough) → ADD outright, no LLM.
+            if (similar.length === 0 || (similar[0]?.distance ?? Infinity) > dupThreshold) {
+                actions.push(await add(candidate, similar, deps, threadThreshold));
+                continue;
+            }
+            const decision = await classify(candidate, similar, deps);
+            actions.push(await apply(candidate, decision, similar, deps, threadThreshold));
+        }
+        catch (err) {
+            // A model outage (embedding or classify LLM) is systemic and must surface — every candidate
+            // would hit it, so swallowing it would make a dead model look like a no-op capture.
+            if (err instanceof MemoryModelError)
+                throw err;
+            // Per-candidate isolation: a genuine per-item *data* failure (e.g. a missing daily file during
+            // UPDATE/SUPERSEDE) must not abort the rest of the batch. Skip it.
+            continue;
+        }
+    }
+    return actions;
+}
+/**
+ * Ask the LLM to classify the candidate against its nearest neighbours. A malformed *reply* is
+ * tolerated (→ undefined → caller falls back to ADD), but a model *failure* is rethrown as a
+ * {@link MemoryModelError} so a dead model surfaces instead of silently degrading to ADD.
+ */
+async function classify(candidate, similar, deps) {
+    let raw;
+    try {
+        raw = await deps.llm.complete(classifyPrompt(candidate, similar), { label: "capture:reconcile" });
+    }
+    catch (cause) {
+        throw new MemoryModelError("llm", "classify", cause);
+    }
+    const parsed = parseJsonLoose(raw);
+    if (parsed === undefined || typeof parsed !== "object")
+        return undefined;
+    const action = typeof parsed.action === "string" ? parsed.action : "";
+    if (!VALID_ACTIONS.has(action))
+        return undefined;
+    const targetId = typeof parsed.targetId === "string" ? parsed.targetId : undefined;
+    // The target must be one of the neighbours we offered the LLM. "add" needs no target.
+    if (action !== "add") {
+        if (targetId === undefined || !similar.some((h) => h.record.id === targetId))
+            return undefined;
+    }
+    return {
+        action,
+        ...(targetId !== undefined && { targetId }),
+        ...(typeof parsed.text === "string" && { text: parsed.text }),
+    };
+}
+const classifyPrompt = (candidate, similar) => {
+    const neighbours = similar
+        .map((h) => `- id=${h.record.id} distance=${h.distance.toFixed(3)} text="${h.record.text}"`)
+        .join("\n");
+    return `CLASSIFY a new candidate memory against existing memories. Decide whether it is novel,
+a duplicate, a refinement, or a contradiction. Return ONLY JSON:
+{"action":"add|update|supersede|noop","targetId":"<existing id, omit for add>","text":"<merged/new text for update|supersede>"}.
+- add: genuinely new information.
+- noop: an exact duplicate of an existing memory (no change needed).
+- update: refines/merges an existing memory; set targetId and text to the merged sentence.
+- supersede: contradicts/replaces an existing memory; set targetId and text to the new sentence.
+
+CANDIDATE: type=${candidate.type} text="${candidate.text}"
+
+EXISTING:
+${neighbours}`;
+};
+/** Dispatch a parsed classification (or fall back to ADD when it is missing/invalid). */
+async function apply(candidate, decision, similar, deps, threadThreshold) {
+    if (decision === undefined)
+        return add(candidate, similar, deps, threadThreshold);
+    switch (decision.action) {
+        case "noop":
+            // targetId is guaranteed present for non-add by classify().
+            return { kind: "noop", id: decision.targetId ?? "" };
+        case "update":
+            return update(candidate, decision, similar, deps, threadThreshold);
+        case "supersede":
+            return supersede(candidate, decision, similar, deps, threadThreshold);
+        default:
+            return add(candidate, similar, deps, threadThreshold);
+    }
+}
+/** ADD: append a new bullet, index it, and thread edges to near neighbours. */
+async function add(candidate, similar, deps, threadThreshold) {
+    const now = deps.now();
+    const id = deps.nextId();
+    const bullet = {
+        id,
+        type: candidate.type,
+        status: "open",
+        text: candidate.text,
+        salience: candidate.salience,
+        isInsight: candidate.isInsight,
+        createdAt: now.toISOString(),
+        refs: [],
+    };
+    appendBullet(deps.root, bullet, now);
+    await deps.db.upsert(recordFor(bullet, deps.root, now));
+    for (const hit of similar) {
+        if (hit.distance <= threadThreshold) {
+            deps.db.addEdge(id, hit.record.id, "thread", 1 - hit.distance);
+        }
+    }
+    return { kind: "add", id };
+}
+/** UPDATE: merge text into an existing memory (markdown + re-embedded index), keeping its id. */
+async function update(candidate, decision, similar, deps, threadThreshold) {
+    const targetId = decision.targetId ?? "";
+    const target = deps.db.get(targetId);
+    if (target === undefined || target.source.file === undefined) {
+        return add(candidate, similar, deps, threadThreshold);
+    }
+    const mergedText = decision.text ?? candidate.text;
+    rewriteBullet(deps.root, target.source.file, targetId, { text: mergedText });
+    await deps.db.upsert({ ...target, text: mergedText });
+    return { kind: "update", id: targetId };
+}
+/** SUPERSEDE: invalidate the old memory (markdown + index) and add the new one in its place. */
+async function supersede(candidate, decision, similar, deps, threadThreshold) {
+    const targetId = decision.targetId ?? "";
+    const old = deps.db.get(targetId);
+    if (old === undefined) {
+        return add(candidate, similar, deps, threadThreshold);
+    }
+    const now = deps.now();
+    const id = deps.nextId();
+    const newText = decision.text ?? candidate.text;
+    const bullet = {
+        id,
+        type: candidate.type,
+        status: "open",
+        text: newText,
+        salience: candidate.salience,
+        isInsight: candidate.isInsight,
+        createdAt: now.toISOString(),
+        refs: [],
+    };
+    // Canonical-markdown first (strike old, append new), then mirror to the index. If the index step
+    // throws, a rebuild from markdown still reproduces the correct state (old invalidated, new present).
+    if (old.source.file !== undefined) {
+        rewriteBullet(deps.root, old.source.file, targetId, { status: "invalidated" });
+    }
+    appendBullet(deps.root, bullet, now);
+    await deps.db.supersede(targetId, recordFor(bullet, deps.root, now));
+    return { kind: "supersede", oldId: targetId, newId: id };
+}
+/** Build an index record mirroring a freshly-appended bullet (source.file is the daily file, relative to root). */
+function recordFor(bullet, root, now) {
+    return {
+        id: bullet.id,
+        type: bullet.type,
+        status: bullet.status,
+        text: bullet.text,
+        salience: bullet.salience,
+        isInsight: bullet.isInsight,
+        createdAt: bullet.createdAt,
+        accessCount: 0,
+        tags: [],
+        source: { file: relative(root, dailyFilePath(root, now)) },
+    };
+}
+//# sourceMappingURL=reconcile.js.map

package/dist/bujo/reconcile.js.map

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

package/dist/bujo/reflect.d.ts

@@ -0,0 +1,30 @@
+import type { MemoryDb } from "../store/index.js";
+import type { LlmComplete } from "./llm.js";
+export interface ReflectDeps {
+    readonly db: MemoryDb;
+    readonly root: string;
+    readonly llm: LlmComplete;
+    readonly nextId: () => string;
+    readonly now: () => Date;
+    readonly halfLifeDays?: number;
+    readonly floor?: number;
+    readonly maxInsights?: number;
+}
+export interface ReflectResult {
+    readonly decayed: number;
+    readonly insights: number;
+    readonly due: number;
+}
+export declare function reflect(deps: ReflectDeps): Promise<ReflectResult>;
+/**
+ * Synthesize higher-level insights from the top-salient non-insight memories.
+ * Asks the LLM for up to `maxInsights ?? 3` insights as JSON, appends each as a
+ * note bullet with isInsight=true, upserts the index record, and adds `supports`
+ * edges from the insight to valid source memory ids.
+ *
+ * A malformed/parse-failed *reply* returns 0, but a model *failure* is rethrown as a
+ * {@link MemoryModelError} so a dead model surfaces (the ritual scheduler logs it) instead of
+ * looking like a reflection that simply found no insights.
+ */
+export declare function synthesizeInsights(deps: ReflectDeps, now: Date): Promise<number>;
+//# sourceMappingURL=reflect.d.ts.map

package/dist/bujo/reflect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflect.d.ts","sourceRoot":"","sources":["../../src/bujo/reflect.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAgB,MAAM,mBAAmB,CAAC;AAIhE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAI5C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,MAAM,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,IAAI,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CASvE;AAuBD;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAqDtF"}

package/dist/bujo/reflect.js

@@ -0,0 +1,100 @@
+import { relative } from "node:path";
+import { appendBullet, dailyFilePath } from "./daily.js";
+import { parseJsonLoose } from "./json.js";
+import { MemoryModelError } from "./model-error.js";
+export async function reflect(deps) {
+    const now = deps.now();
+    const { decayed } = deps.db.applyDecay(now, {
+        ...(deps.halfLifeDays !== undefined && { halfLifeDays: deps.halfLifeDays }),
+        ...(deps.floor !== undefined && { floor: deps.floor }),
+    });
+    const insights = await synthesizeInsights(deps, now);
+    const due = deps.db.dueItems(now).length;
+    return { decayed, insights, due };
+}
+/** Build an index record for a freshly-appended insight bullet (source.file relative to root). */
+function insightRecordFor(bullet, root, now) {
+    return {
+        id: bullet.id,
+        type: bullet.type,
+        status: bullet.status,
+        text: bullet.text,
+        salience: bullet.salience,
+        isInsight: bullet.isInsight,
+        createdAt: bullet.createdAt,
+        accessCount: 0,
+        tags: [],
+        source: { file: relative(root, dailyFilePath(root, now)) },
+    };
+}
+/**
+ * Synthesize higher-level insights from the top-salient non-insight memories.
+ * Asks the LLM for up to `maxInsights ?? 3` insights as JSON, appends each as a
+ * note bullet with isInsight=true, upserts the index record, and adds `supports`
+ * edges from the insight to valid source memory ids.
+ *
+ * A malformed/parse-failed *reply* returns 0, but a model *failure* is rethrown as a
+ * {@link MemoryModelError} so a dead model surfaces (the ritual scheduler logs it) instead of
+ * looking like a reflection that simply found no insights.
+ */
+export async function synthesizeInsights(deps, now) {
+    const candidates = deps.db.topSalient(20).filter((m) => !m.isInsight);
+    if (candidates.length < 3)
+        return 0;
+    const prompt = buildInsightPrompt(candidates, deps.maxInsights ?? 3);
+    let raw;
+    try {
+        raw = await deps.llm.complete(prompt, { label: "reflect" });
+    }
+    catch (cause) {
+        throw new MemoryModelError("llm", "insights", cause);
+    }
+    const parsed = parseJsonLoose(raw);
+    if (!Array.isArray(parsed))
+        return 0;
+    const candidateIds = new Set(candidates.map((m) => m.id));
+    const maxInsights = deps.maxInsights ?? 3;
+    let created = 0;
+    for (const item of parsed) {
+        if (created >= maxInsights)
+            break;
+        if (typeof item !== "object" || item === null)
+            continue;
+        const text = typeof item.text === "string" ? item.text.trim() : "";
+        if (text.length === 0)
+            continue;
+        const id = deps.nextId();
+        const bullet = {
+            id,
+            type: "note",
+            status: "open",
+            text,
+            salience: 0.7,
+            isInsight: true,
+            createdAt: now.toISOString(),
+            refs: [],
+        };
+        appendBullet(deps.root, bullet, now);
+        await deps.db.upsert(insightRecordFor(bullet, deps.root, now));
+        // Add "supports" edges from this insight to each referenced source that is in our candidate set.
+        const sourceIds = Array.isArray(item.sourceIds) ? item.sourceIds : [];
+        for (const sourceId of sourceIds) {
+            if (typeof sourceId === "string" && candidateIds.has(sourceId)) {
+                deps.db.addEdge(id, sourceId, "supports");
+            }
+        }
+        created += 1;
+    }
+    return created;
+}
+function buildInsightPrompt(memories, maxInsights) {
+    const memoryList = memories.map((m) => `- id=${m.id} text="${m.text}"`).join("\n");
+    return `You are a reflective memory assistant. Given the following memories, synthesize up to ${maxInsights} higher-level insight(s) that reveal patterns, principles, or connections not obvious from any single memory.
+
+Return ONLY a JSON array (no prose, no code fences):
+[{"text":"<insight sentence>","sourceIds":["<id1>","<id2>"]}]
+
+MEMORIES:
+${memoryList}`;
+}
+//# sourceMappingURL=reflect.js.map

package/dist/bujo/reflect.js.map

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

package/dist/bujo/store.d.ts

@@ -0,0 +1,77 @@
+import type { MemoryBlock, MemoryStore, MemoryWriteResult } from "@mono-agent/agent-contracts";
+import type { RecallHit } from "../store/index.js";
+import { type ReflectResult } from "./reflect.js";
+import { type MigrateResult } from "./migrate.js";
+import { type ConsolidateResult } from "./consolidate.js";
+import type { BujoOptions, BujoTier } from "./types.js";
+export declare class BujoMemoryStore implements MemoryStore {
+    private readonly root;
+    private readonly db;
+    private readonly maxBytes;
+    private readonly clock;
+    private readonly nextId;
+    private readonly llm?;
+    private readonly _tier;
+    private readonly logger;
+    private captureChain;
+    constructor(options: BujoOptions);
+    /** The effective tier of this store (lite / journal / bujo). */
+    tier(): BujoTier;
+    load(conversationId: string, query?: string): Promise<MemoryBlock | undefined>;
+    /** Query-based hybrid recall (text + score). Used by the MCP and any deliberate recall surface. */
+    recall(query: string, options?: {
+        topK?: number;
+        trackAccess?: boolean;
+    }): Promise<RecallHit[]>;
+    appendHostSummary(conversationId: string, summary: string): Promise<MemoryWriteResult>;
+    /**
+     * Run the nightly reflection ritual: decay salience, synthesize insights from top memories,
+     * and surface due intentions. Also writes future-log.md + index.md.
+     *
+     * Returns `undefined` when no `llm` was configured (matches `capture()` pattern).
+     */
+    reflect(): Promise<ReflectResult | undefined>;
+    /**
+     * Run the monthly BuJo migration ritual: review aging open memories and apply LLM decisions
+     * (promote / reschedule / cluster / forget). Also writes future-log.md.
+     *
+     * Returns `undefined` when no `llm` was configured (matches `capture()` pattern).
+     */
+    migrate(): Promise<MigrateResult | undefined>;
+    /**
+     * Enqueue a best-effort intelligent capture. Returns immediately. Captures run strictly
+     * one-at-a-time (serialized across all channels sharing this store), and a failure is caught +
+     * logged so it never breaks the chain, the reply, or the process. No-op without an llm.
+     */
+    scheduleCapture(conversationId: string, text: string): void;
+    /** Await all captures queued before this call (graceful shutdown / one-shot exit). */
+    flush(): Promise<void>;
+    /**
+     * LLM-backed intelligent capture: distills the turn text into atomic candidate memories,
+     * reconciles them against the existing index (ADD / UPDATE / SUPERSEDE / NOOP), and extracts
+     * typed entities into the canonical graph.
+     *
+     * Returns `undefined` when no `llm` was configured — use `appendHostSummary` as the always-on
+     * deterministic rapid-log (P1 path). `capture()` is the intelligent path invoked by P3
+     * reflection/cron and future session hooks; it is safe to call on every turn when an LLM is
+     * present, and a no-op when one is not.
+     */
+    capture(conversationId: string, text: string): Promise<{
+        actions: number;
+        entities: number;
+    } | undefined>;
+    /**
+     * Apply salience decay to all memories in the store.
+     *
+     * Usable in all tiers (lite, journal, bujo) — no LLM required. In the `journal` and `bujo`
+     * tiers this is the primary maintenance call; in the `lite` tier it still runs harmlessly.
+     */
+    decay(): Promise<{
+        decayed: number;
+    }>;
+    /** Run deterministic, no-LLM BuJo consolidation in every tier. */
+    consolidate(): Promise<ConsolidateResult>;
+    close(): Promise<void>;
+}
+export declare function createBujoMemoryStore(options: BujoOptions): BujoMemoryStore;
+//# sourceMappingURL=store.d.ts.map

package/dist/bujo/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/bujo/store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAC/F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AASnD,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAyB,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAEjF,OAAO,KAAK,EAAsB,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAM5E,qBAAa,eAAgB,YAAW,WAAW;IACjD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAW;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAc;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAW;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,YAAY,CAAoC;gBAE5C,OAAO,EAAE,WAAW;IAwBhC,gEAAgE;IAChE,IAAI,IAAI,QAAQ;IAIV,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAiBpF,mGAAmG;IAC7F,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAOnG,iBAAiB,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAkC5F;;;;;OAKG;IACG,OAAO,IAAI,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC;IAcnD;;;;;OAKG;IACG,OAAO,IAAI,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC;IAanD;;;;OAIG;IACH,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAe3D,sFAAsF;IAChF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;;;;;;;;OASG;IACG,OAAO,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAY/G;;;;;OAKG;IACG,KAAK,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAI3C,kEAAkE;IAC5D,WAAW,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAQzC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAM7B;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,WAAW,GAAG,eAAe,CAE3E"}

package/dist/bujo/store.js

@@ -0,0 +1,222 @@
+import { join, relative } from "node:path";
+import { openMemoryDb } from "../store/index.js";
+import { appendBullet, dailyFilePath } from "./daily.js";
+import { serializeBullet } from "./grammar.js";
+import { createIdFactory } from "./ids.js";
+import { captureTurn } from "./capture.js";
+import { composeRecallBlock } from "./recall.js";
+import { reflect as reflectFn } from "./reflect.js";
+import { migrate as migrateFn } from "./migrate.js";
+import { consolidateBujoMemory } from "./consolidate.js";
+import { writeFutureLog, writeIndex } from "./projections.js";
+// Cap the recall query so an attachment turn's inlined document text (the user message can carry
+// up to a few KB of extracted file content) cannot drown the FTS/embedding signal.
+const MAX_RECALL_QUERY_CHARS = 4_000;
+export class BujoMemoryStore {
+    root;
+    db;
+    maxBytes;
+    clock;
+    nextId;
+    llm;
+    _tier;
+    logger;
+    captureChain = Promise.resolve();
+    constructor(options) {
+        this.root = options.root;
+        this.maxBytes = options.maxBytes ?? 8_000;
+        this.clock = options.clock ?? (() => new Date());
+        this.nextId = createIdFactory({ clock: this.clock });
+        this.db = openMemoryDb({
+            path: join(options.root, "memory.db"),
+            ...(options.embeddings !== undefined && { embeddings: options.embeddings }),
+            ...(options.dim !== undefined && { dim: options.dim }),
+            clock: this.clock,
+        });
+        if (options.llm !== undefined) {
+            this.llm = options.llm;
+        }
+        this._tier =
+            options.tier ??
+                (options.embeddings === undefined
+                    ? "lite"
+                    : options.llm === undefined
+                        ? "journal"
+                        : "bujo");
+        this.logger = options.logger ?? { warn: () => { } };
+    }
+    /** The effective tier of this store (lite / journal / bujo). */
+    tier() {
+        return this._tier;
+    }
+    async load(conversationId, query) {
+        // Recall against what the user actually said. Legacy callers pass no query, so fall back to the
+        // conversation id as a coarse seed; an explicit empty query carries no usable signal, so skip
+        // recall rather than surface near-random hits.
+        let recallQuery;
+        if (query === undefined) {
+            recallQuery = conversationId;
+        }
+        else {
+            const trimmed = query.trim();
+            if (trimmed.length === 0) {
+                return undefined;
+            }
+            recallQuery = trimmed.slice(0, MAX_RECALL_QUERY_CHARS);
+        }
+        return composeRecallBlock(this.db, recallQuery, { topK: 8, maxBytes: this.maxBytes });
+    }
+    /** Query-based hybrid recall (text + score). Used by the MCP and any deliberate recall surface. */
+    async recall(query, options = {}) {
+        return this.db.recall(query, {
+            ...(options.topK !== undefined && { topK: options.topK }),
+            ...(options.trackAccess !== undefined && { trackAccess: options.trackAccess }),
+        });
+    }
+    async appendHostSummary(conversationId, summary) {
+        const now = this.clock();
+        const bullet = {
+            id: this.nextId(),
+            type: "note",
+            status: "open",
+            // Collapse whitespace/newlines to a single line: a bullet is one markdown line, and
+            // serializeBullet rejects newlines. The harness emits multi-line summaries; P2's distiller
+            // will split these into multiple atomic memories — for P1 we store one normalized line.
+            text: summary.trim().replace(/\s+/gu, " "),
+            salience: 0.5,
+            isInsight: false,
+            createdAt: now.toISOString(),
+            refs: [],
+        };
+        const path = dailyFilePath(this.root, now);
+        appendBullet(this.root, bullet, now);
+        const record = {
+            id: bullet.id,
+            type: bullet.type,
+            status: bullet.status,
+            text: bullet.text,
+            salience: bullet.salience,
+            isInsight: bullet.isInsight,
+            createdAt: bullet.createdAt,
+            accessCount: 0,
+            tags: [],
+            source: { session: conversationId, file: relative(this.root, path) },
+        };
+        await this.db.upsert(record);
+        // bytesWritten reflects the bullet line actually appended to the daily file, not the raw summary.
+        return { conversationId, source: path, bytesWritten: Buffer.byteLength(`${serializeBullet(bullet)}\n`, "utf8") };
+    }
+    /**
+     * Run the nightly reflection ritual: decay salience, synthesize insights from top memories,
+     * and surface due intentions. Also writes future-log.md + index.md.
+     *
+     * Returns `undefined` when no `llm` was configured (matches `capture()` pattern).
+     */
+    async reflect() {
+        if (this.llm === undefined)
+            return undefined;
+        const r = await reflectFn({
+            db: this.db,
+            root: this.root,
+            llm: this.llm,
+            nextId: this.nextId,
+            now: this.clock,
+        });
+        writeFutureLog(this.root, this.db, this.clock());
+        writeIndex(this.root, this.db, this.clock());
+        return r;
+    }
+    /**
+     * Run the monthly BuJo migration ritual: review aging open memories and apply LLM decisions
+     * (promote / reschedule / cluster / forget). Also writes future-log.md.
+     *
+     * Returns `undefined` when no `llm` was configured (matches `capture()` pattern).
+     */
+    async migrate() {
+        if (this.llm === undefined)
+            return undefined;
+        const m = await migrateFn({
+            db: this.db,
+            root: this.root,
+            llm: this.llm,
+            nextId: this.nextId,
+            now: this.clock,
+        });
+        writeFutureLog(this.root, this.db, this.clock());
+        return m;
+    }
+    /**
+     * Enqueue a best-effort intelligent capture. Returns immediately. Captures run strictly
+     * one-at-a-time (serialized across all channels sharing this store), and a failure is caught +
+     * logged so it never breaks the chain, the reply, or the process. No-op without an llm.
+     */
+    scheduleCapture(conversationId, text) {
+        if (this.llm === undefined)
+            return;
+        this.captureChain = this.captureChain
+            .then(async () => {
+            try {
+                await this.capture(conversationId, text);
+            }
+            catch (error) {
+                this.logger.warn(`bujo capture failed: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        })
+            // Terminal guard: if even the logging path throws, the chain must not settle rejected —
+            // otherwise every future scheduleCapture would silently stop (`.then` skips a rejected promise).
+            .catch(() => undefined);
+    }
+    /** Await all captures queued before this call (graceful shutdown / one-shot exit). */
+    async flush() {
+        await this.captureChain;
+    }
+    /**
+     * LLM-backed intelligent capture: distills the turn text into atomic candidate memories,
+     * reconciles them against the existing index (ADD / UPDATE / SUPERSEDE / NOOP), and extracts
+     * typed entities into the canonical graph.
+     *
+     * Returns `undefined` when no `llm` was configured — use `appendHostSummary` as the always-on
+     * deterministic rapid-log (P1 path). `capture()` is the intelligent path invoked by P3
+     * reflection/cron and future session hooks; it is safe to call on every turn when an LLM is
+     * present, and a no-op when one is not.
+     */
+    async capture(conversationId, text) {
+        if (this.llm === undefined)
+            return undefined;
+        const res = await captureTurn(text, {
+            db: this.db,
+            root: this.root,
+            llm: this.llm,
+            nextId: this.nextId,
+            now: this.clock,
+        });
+        return { actions: res.actions.length, entities: res.entities };
+    }
+    /**
+     * Apply salience decay to all memories in the store.
+     *
+     * Usable in all tiers (lite, journal, bujo) — no LLM required. In the `journal` and `bujo`
+     * tiers this is the primary maintenance call; in the `lite` tier it still runs harmlessly.
+     */
+    async decay() {
+        return this.db.applyDecay(this.clock());
+    }
+    /** Run deterministic, no-LLM BuJo consolidation in every tier. */
+    async consolidate() {
+        return consolidateBujoMemory({
+            root: this.root,
+            db: this.db,
+            now: this.clock(),
+        });
+    }
+    async close() {
+        // Drain any queued captures before closing the db handle, so a caller that omits flush()
+        // (e.g. the MCP's signal handler) doesn't strand an in-flight capture against a closed db.
+        await this.flush();
+        this.db.close();
+    }
+}
+export function createBujoMemoryStore(options) {
+    return new BujoMemoryStore(options);
+}
+//# sourceMappingURL=store.js.map