@mono-agent/memory 0.4.1

package/README.md

@@ -0,0 +1,61 @@
+# @mono-agent/memory
+
+## Category
+
+Category: `context`
+
+## Responsibility
+
+Local memory building blocks published as one package with explicit subpaths. `@mono-agent/memory/store` owns the SQLite substrate, schema, FTS5/sqlite-vec hybrid recall, and rebuildable record database. `@mono-agent/memory/search` owns embedding providers, circuit-breaking, chunk gathering, and the in-memory cosine vector index. `@mono-agent/memory/bujo` owns the Bullet-Journal memory engine: markdown grammar, canonical daily files, tier-aware capture/recall, entity graph projection, reflection, migration, and the `memory-bujo` maintenance CLI.
+
+The shared `MemoryBlock`, `MemoryStore`, and `MemoryWriteResult` contracts live in `@mono-agent/agent-contracts`. The store subpath re-exports them for local-store consumers, but `@mono-agent/agent-contracts` is the source of truth.
+
+## Install / Usage
+
+```bash
+pnpm --filter @mono-agent/memory run build
+```
+
+```ts
+import { createBujoMemoryStore } from "@mono-agent/memory/bujo";
+import { createEmbeddingProvider } from "@mono-agent/memory/search";
+import { openMemoryDb } from "@mono-agent/memory/store";
+import type { MemoryStore } from "@mono-agent/agent-contracts";
+
+const embeddings = createEmbeddingProvider({ provider: "ollama", model: "nomic-embed-text:v1.5" });
+const store: MemoryStore = createBujoMemoryStore({
+  root: "./memory",
+  embeddings,
+  dim: 768,
+});
+
+await store.appendHostSummary("conv-1", "User prefers concise answers.");
+```
+
+```bash
+memory-bujo rebuild ./memory
+memory-bujo recall ./memory "what did we decide about releases?"
+```
+
+## Public API
+
+- `@mono-agent/memory/store`: `openMemoryDb`, `MemoryDb`, `DEFAULT_VEC_DIM`, `MEMORY_TYPES`, `MEMORY_STATUSES`, local record/entity/recall/stats types, and re-exported `MemoryBlock`, `MemoryStore`, `MemoryWriteResult`
+- `@mono-agent/memory/search`: `createEmbeddingProvider`, `createCircuitBreakerEmbeddingProvider`, `createVectorMemoryIndex`, `gatherMemoryChunks`, embedding/search provider classes and types
+- `@mono-agent/memory/bujo`: `createBujoMemoryStore`, `BujoMemoryStore`, `composeRecallBlock`, markdown grammar helpers, daily-file helpers, capture/reconcile/reflection/migration helpers, `createOllamaLlm`, and related BuJo/LLM types
+- CLI: `memory-bujo`
+
+## Dependency Boundary
+
+This package may depend on core contracts and local persistence/search dependencies (`better-sqlite3`, `sqlite-vec`). It does not depend on hosts, harnesses, communication adapters, observability, provider runtimes, or external memory services. Internal subpaths use relative imports so the package has no package-to-self workspace dependency.
+
+## What This Package Does Not Own
+
+It does not own host configuration, backend selection, automatic `memory_recall` MCP wiring, external Supermemory storage, model runtime execution, communication channels, or run artifact persistence. `@mono-agent/agent-app` chooses which memory backend to build and wires the recall tool, while `@mono-agent/memory-supermemory` owns the external Supermemory backend.
+
+## Verification
+
+```bash
+pnpm --filter @mono-agent/memory run build
+pnpm --filter @mono-agent/memory run typecheck
+pnpm --filter @mono-agent/memory run test
+```

package/dist/bujo/capture.d.ts

@@ -0,0 +1,20 @@
+import { type ReconcileAction, type ReconcileDeps } from "./reconcile.js";
+export interface CaptureTurnResult {
+    readonly actions: ReconcileAction[];
+    readonly entities: number;
+    readonly relations: number;
+}
+/**
+ * Full capture pipeline for a single conversation turn:
+ *  1. distill(text) → candidate memories
+ *  2. reconcile(candidates) → ADD / UPDATE / SUPERSEDE / NOOP actions (writes markdown + index)
+ *  3. extractEntities(text) → typed entities + relations
+ *  4. Persist each entity canonical-first: graph.jsonl, THEN mirror to the db index
+ *  5. Persist each relation canonical-first: graph.jsonl, THEN mirror to the db index
+ *  6. Link this turn's ADDed memories to extracted entities via `about` edges (coarse co-occurrence)
+ *
+ * Never throws on a single bad entity/relation item — each write is wrapped defensively.
+ * Returns a summary: actions list, entity count, relation count.
+ */
+export declare function captureTurn(text: string, deps: ReconcileDeps): Promise<CaptureTurnResult>;
+//# sourceMappingURL=capture.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/bujo/capture.ts"],"names":[],"mappings":"AAGA,OAAO,EAAa,KAAK,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAErF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,eAAe,EAAE,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA8D/F"}

package/dist/bujo/capture.js

@@ -0,0 +1,77 @@
+import { distill } from "./distill.js";
+import { extractEntities } from "./entities.js";
+import { appendEntity, appendRelation } from "./graph.js";
+import { reconcile } from "./reconcile.js";
+/**
+ * Full capture pipeline for a single conversation turn:
+ *  1. distill(text) → candidate memories
+ *  2. reconcile(candidates) → ADD / UPDATE / SUPERSEDE / NOOP actions (writes markdown + index)
+ *  3. extractEntities(text) → typed entities + relations
+ *  4. Persist each entity canonical-first: graph.jsonl, THEN mirror to the db index
+ *  5. Persist each relation canonical-first: graph.jsonl, THEN mirror to the db index
+ *  6. Link this turn's ADDed memories to extracted entities via `about` edges (coarse co-occurrence)
+ *
+ * Never throws on a single bad entity/relation item — each write is wrapped defensively.
+ * Returns a summary: actions list, entity count, relation count.
+ */
+export async function captureTurn(text, deps) {
+    // Step 1+2: distill candidates and reconcile against existing index
+    const candidates = await distill(text, deps.llm);
+    const actions = await reconcile(candidates, deps);
+    // Step 3: extract entities and relations from the turn text
+    const extraction = await extractEntities(text, deps.llm);
+    const now = deps.now();
+    const createdAt = now.toISOString();
+    // Step 4: persist each entity canonical-first (graph.jsonl), then mirror to the rebuildable db
+    // index. graph.jsonl is the canonical source rebuildFromMarkdown reads; writing it first means a
+    // crash between the two writes still recovers the entity on the next rebuild.
+    for (const entity of extraction.entities) {
+        try {
+            const record = {
+                id: entity.id,
+                name: entity.name,
+                ...(entity.type !== undefined ? { type: entity.type } : {}),
+                createdAt,
+            };
+            appendEntity(deps.root, record);
+            deps.db.upsertEntity(record);
+        }
+        catch {
+            // Per-item isolation: a single bad entity must not abort the turn
+        }
+    }
+    // Step 5: persist each relation canonical-first (graph.jsonl), then mirror to the db index.
+    for (const relation of extraction.relations) {
+        try {
+            appendRelation(deps.root, {
+                src: relation.src,
+                dst: relation.dst,
+                relation: relation.relation,
+                createdAt,
+            });
+            deps.db.addEntityRelation(relation.src, relation.dst, relation.relation);
+        }
+        catch {
+            // Per-item isolation: a single bad relation must not abort the turn
+        }
+    }
+    // Step 6: link ADDed memories to extracted entities via `about` edges
+    const addedIds = actions.flatMap((a) => (a.kind === "add" ? [a.id] : []));
+    const entityIds = extraction.entities.map((e) => e.id);
+    for (const memoryId of addedIds) {
+        for (const entityId of entityIds) {
+            try {
+                deps.db.addEdge(memoryId, entityId, "about");
+            }
+            catch {
+                // Per-item isolation
+            }
+        }
+    }
+    return {
+        actions,
+        entities: extraction.entities.length,
+        relations: extraction.relations.length,
+    };
+}
+//# sourceMappingURL=capture.js.map

package/dist/bujo/capture.js.map

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

package/dist/bujo/cli-env.d.ts

@@ -0,0 +1,11 @@
+import type { EmbeddingProvider } from "../search/index.js";
+/**
+ * Resolve the embeddings provider from the same `MONO_AGENT_MEMORY_EMBEDDINGS_*` env vars the agent
+ * and the MCP server use. Returns undefined when no provider is configured — embeddings are opt-in,
+ * so lite-tier (FTS-only) recall/rebuild works without any embedding service (e.g. no Ollama running).
+ */
+export declare function readEmbeddings(env?: NodeJS.ProcessEnv): {
+    provider: EmbeddingProvider;
+    dim: number;
+} | undefined;
+//# sourceMappingURL=cli-env.d.ts.map

package/dist/bujo/cli-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-env.d.ts","sourceRoot":"","sources":["../../src/bujo/cli-env.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC;IAAE,QAAQ,EAAE,iBAAiB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAqB1D"}

package/dist/bujo/cli-env.js

@@ -0,0 +1,30 @@
+import { createEmbeddingProvider } from "../search/index.js";
+/**
+ * Resolve the embeddings provider from the same `MONO_AGENT_MEMORY_EMBEDDINGS_*` env vars the agent
+ * and the MCP server use. Returns undefined when no provider is configured — embeddings are opt-in,
+ * so lite-tier (FTS-only) recall/rebuild works without any embedding service (e.g. no Ollama running).
+ */
+export function readEmbeddings(env = process.env) {
+    const providerKind = env.MONO_AGENT_MEMORY_EMBEDDINGS_PROVIDER?.trim();
+    if (!providerKind)
+        return undefined;
+    if (providerKind !== "ollama" && providerKind !== "openai") {
+        throw new Error(`unsupported MONO_AGENT_MEMORY_EMBEDDINGS_PROVIDER "${providerKind}" (expected "ollama" or "openai")`);
+    }
+    const model = env.MONO_AGENT_MEMORY_EMBEDDINGS_MODEL?.trim() || "nomic-embed-text:v1.5";
+    const endpoint = env.MONO_AGENT_MEMORY_EMBEDDINGS_ENDPOINT?.trim();
+    const apiKey = env.MONO_AGENT_MEMORY_EMBEDDINGS_API_KEY?.trim();
+    const dimStr = env.MONO_AGENT_MEMORY_EMBEDDINGS_DIM?.trim();
+    const dim = dimStr ? Number(dimStr) : 768;
+    if (!Number.isInteger(dim) || dim <= 0) {
+        throw new Error(`invalid MONO_AGENT_MEMORY_EMBEDDINGS_DIM "${dimStr ?? ""}" (expected a positive integer)`);
+    }
+    const provider = createEmbeddingProvider({
+        provider: providerKind,
+        model,
+        ...(endpoint ? { endpoint } : {}),
+        ...(apiKey ? { apiKey } : {}),
+    });
+    return { provider, dim };
+}
+//# sourceMappingURL=cli-env.js.map

package/dist/bujo/cli-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-env.js","sourceRoot":"","sources":["../../src/bujo/cli-env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAG7D;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAyB,OAAO,CAAC,GAAG;IAEpC,MAAM,YAAY,GAAG,GAAG,CAAC,qCAAqC,EAAE,IAAI,EAAE,CAAC;IACvE,IAAI,CAAC,YAAY;QAAE,OAAO,SAAS,CAAC;IACpC,IAAI,YAAY,KAAK,QAAQ,IAAI,YAAY,KAAK,QAAQ,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,sDAAsD,YAAY,mCAAmC,CAAC,CAAC;IACzH,CAAC;IACD,MAAM,KAAK,GAAG,GAAG,CAAC,kCAAkC,EAAE,IAAI,EAAE,IAAI,uBAAuB,CAAC;IACxF,MAAM,QAAQ,GAAG,GAAG,CAAC,qCAAqC,EAAE,IAAI,EAAE,CAAC;IACnE,MAAM,MAAM,GAAG,GAAG,CAAC,oCAAoC,EAAE,IAAI,EAAE,CAAC;IAChE,MAAM,MAAM,GAAG,GAAG,CAAC,gCAAgC,EAAE,IAAI,EAAE,CAAC;IAC5D,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAC1C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,6CAA6C,MAAM,IAAI,EAAE,iCAAiC,CAAC,CAAC;IAC9G,CAAC;IACD,MAAM,QAAQ,GAAG,uBAAuB,CAAC;QACvC,QAAQ,EAAE,YAAY;QACtB,KAAK;QACL,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9B,CAAC,CAAC;IACH,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;AAC3B,CAAC"}

package/dist/bujo/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/bujo/cli.ts"],"names":[],"mappings":""}

package/dist/bujo/cli.js

@@ -0,0 +1,98 @@
+#!/usr/bin/env node
+import { join } from "node:path";
+import { openMemoryDb } from "../store/index.js";
+import { readEmbeddings } from "./cli-env.js";
+import { createIdFactory } from "./ids.js";
+import { migrate } from "./migrate.js";
+import { createOllamaLlm } from "./ollama-llm.js";
+import { writeFutureLog, writeIndex } from "./projections.js";
+import { rebuildFromMarkdown } from "./rebuild.js";
+import { reflect } from "./reflect.js";
+/** Optional per-call LLM timeout override (ms). Invalid values fall back to the client default. */
+function llmTimeoutMsFromEnv() {
+    const raw = process.env.MONO_AGENT_MEMORY_LLM_TIMEOUT_MS?.trim();
+    if (!raw)
+        return undefined;
+    const parsed = Number(raw);
+    return Number.isInteger(parsed) && parsed > 0 ? parsed : undefined;
+}
+async function main() {
+    const [command, root, ...rest] = process.argv.slice(2);
+    if (command !== "rebuild" && command !== "recall" && command !== "index" && command !== "reflect" && command !== "migrate") {
+        process.stderr.write("usage: memory-bujo <rebuild|recall|index|reflect|migrate> <root> [query]\n");
+        process.exit(2);
+    }
+    if (root === undefined) {
+        process.stderr.write("error: <root> is required\n");
+        process.exit(2);
+    }
+    const query = rest.join(" ").trim();
+    if (command === "recall" && query.length === 0) {
+        process.stderr.write("error: recall requires a non-empty <query>\n");
+        process.exit(2);
+    }
+    if (command === "reflect" || command === "migrate") {
+        const chatModel = process.env.MONO_AGENT_MEMORY_LLM_MODEL;
+        if (chatModel === undefined) {
+            process.stderr.write("error: set MONO_AGENT_MEMORY_LLM_MODEL to a local Ollama chat model (e.g. qwen3.6:latest)\n");
+            process.exit(2);
+        }
+    }
+    // Embeddings are opt-in (matching the agent/MCP): only enabled when an embeddings provider is
+    // configured. A lite-tier (FTS-only) recall/rebuild then needs no embedding service running.
+    const embeddingsConfig = readEmbeddings();
+    const db = openMemoryDb({
+        path: join(root, "memory.db"),
+        ...(embeddingsConfig !== undefined ? { embeddings: embeddingsConfig.provider, dim: embeddingsConfig.dim } : {}),
+    });
+    try {
+        if (command === "rebuild") {
+            const result = await rebuildFromMarkdown(root, db);
+            process.stdout.write(`rebuilt: indexed ${result.indexed} memories into ${join(root, "memory.db")}\n`);
+        }
+        else if (command === "index") {
+            writeIndex(root, db, new Date());
+            process.stdout.write(`wrote ${join(root, "index.md")}\n`);
+        }
+        else if (command === "reflect") {
+            // MONO_AGENT_MEMORY_LLM_MODEL is guaranteed non-undefined here (guard above)
+            const chatModel = process.env.MONO_AGENT_MEMORY_LLM_MODEL;
+            const timeoutMs = llmTimeoutMsFromEnv();
+            const llm = createOllamaLlm({
+                model: chatModel,
+                ...(process.env.MONO_AGENT_MEMORY_LLM_ENDPOINT ? { endpoint: process.env.MONO_AGENT_MEMORY_LLM_ENDPOINT } : {}),
+                ...(timeoutMs !== undefined ? { timeoutMs } : {}),
+            });
+            const r = await reflect({ db, root, llm, nextId: createIdFactory(), now: () => new Date() });
+            writeFutureLog(root, db, new Date());
+            writeIndex(root, db, new Date());
+            process.stdout.write(`reflected: decayed ${r.decayed}, insights ${r.insights}, due ${r.due}\n`);
+        }
+        else if (command === "migrate") {
+            // MONO_AGENT_MEMORY_LLM_MODEL is guaranteed non-undefined here (guard above)
+            const chatModel = process.env.MONO_AGENT_MEMORY_LLM_MODEL;
+            const timeoutMs = llmTimeoutMsFromEnv();
+            const llm = createOllamaLlm({
+                model: chatModel,
+                ...(process.env.MONO_AGENT_MEMORY_LLM_ENDPOINT ? { endpoint: process.env.MONO_AGENT_MEMORY_LLM_ENDPOINT } : {}),
+                ...(timeoutMs !== undefined ? { timeoutMs } : {}),
+            });
+            const m = await migrate({ db, root, llm, nextId: createIdFactory(), now: () => new Date() });
+            writeFutureLog(root, db, new Date());
+            process.stdout.write(`migrated: promoted ${m.promoted}, rescheduled ${m.rescheduled}, clustered ${m.clustered}, forgotten ${m.forgotten}, reviewed ${m.reviewed}\n`);
+        }
+        else {
+            const hits = await db.recall(query, { topK: 8 });
+            for (const hit of hits)
+                process.stdout.write(`${hit.score.toFixed(3)}  ${hit.record.text}\n`);
+        }
+    }
+    finally {
+        db.close();
+    }
+}
+main().catch((error) => {
+    process.stderr.write(`memory-bujo failed: ${error instanceof Error ? error.message : String(error)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/bujo/cli.js.map

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

package/dist/bujo/consolidate.d.ts

@@ -0,0 +1,15 @@
+import type { MemoryDb } from "../store/index.js";
+export interface ConsolidateDeps {
+    readonly root: string;
+    readonly db: MemoryDb;
+    readonly now: Date;
+}
+export interface ConsolidateResult {
+    readonly decayed: number;
+    readonly duplicateGroups: number;
+    readonly superseded: number;
+    readonly markdownInvalidated: number;
+}
+/** Deterministic, no-LLM maintenance: decay, exact-normalized duplicate folding, projections. */
+export declare function consolidateBujoMemory(deps: ConsolidateDeps): Promise<ConsolidateResult>;
+//# sourceMappingURL=consolidate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"consolidate.d.ts","sourceRoot":"","sources":["../../src/bujo/consolidate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAgB,MAAM,mBAAmB,CAAC;AAKhE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC;AAED,iGAAiG;AACjG,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA0B7F"}

package/dist/bujo/consolidate.js

@@ -0,0 +1,61 @@
+import { rewriteBullet } from "./daily.js";
+import { writeEmptyFutureLog, writeIndex } from "./projections.js";
+/** Deterministic, no-LLM maintenance: decay, exact-normalized duplicate folding, projections. */
+export async function consolidateBujoMemory(deps) {
+    const { decayed } = deps.db.applyDecay(deps.now);
+    const liveRecords = deps.db.topSalient(Math.max(deps.db.count(), 1));
+    const groups = groupByNormalizedText(liveRecords);
+    let duplicateGroups = 0;
+    let superseded = 0;
+    let markdownInvalidated = 0;
+    for (const group of groups.values()) {
+        if (group.length < 2)
+            continue;
+        duplicateGroups += 1;
+        const [keeper, ...duplicates] = [...group].sort(compareNewestFirst);
+        if (keeper === undefined)
+            continue;
+        for (const duplicate of duplicates) {
+            deps.db.markSuperseded(duplicate.id, keeper.id, deps.now.toISOString());
+            superseded += 1;
+            if (duplicate.source.file !== undefined) {
+                const rewritten = rewriteBullet(deps.root, duplicate.source.file, duplicate.id, { status: "invalidated" });
+                if (rewritten)
+                    markdownInvalidated += 1;
+            }
+        }
+    }
+    writeIndex(deps.root, deps.db, deps.now);
+    writeEmptyFutureLog(deps.root);
+    return { decayed, duplicateGroups, superseded, markdownInvalidated };
+}
+function groupByNormalizedText(records) {
+    const groups = new Map();
+    for (const record of records) {
+        const key = normalizeFactText(record.text);
+        if (key.length === 0)
+            continue;
+        const existing = groups.get(key);
+        if (existing === undefined) {
+            groups.set(key, [record]);
+        }
+        else {
+            existing.push(record);
+        }
+    }
+    return groups;
+}
+function normalizeFactText(text) {
+    return text
+        .normalize("NFKC")
+        .toLocaleLowerCase("en-US")
+        .replace(/[^\p{Letter}\p{Number}]+/gu, " ")
+        .trim();
+}
+function compareNewestFirst(a, b) {
+    const byCreated = Date.parse(b.createdAt) - Date.parse(a.createdAt);
+    if (byCreated !== 0)
+        return byCreated;
+    return b.id.localeCompare(a.id);
+}
+//# sourceMappingURL=consolidate.js.map

package/dist/bujo/consolidate.js.map

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

package/dist/bujo/daily.d.ts

@@ -0,0 +1,17 @@
+import type { Bullet } from "./types.js";
+export declare function dailyFilePath(root: string, when: Date): string;
+/** Append a bullet to today's daily file (creating it with a heading if absent). Returns the bullet. */
+export declare function appendBullet(root: string, bullet: Bullet, when: Date): Bullet;
+/**
+ * Rewrite a single bullet inside an existing daily file.
+ *
+ * Reads `<root>/<file>`, parses it, finds the line whose `bullet.id === id`,
+ * applies `patch` onto that Bullet (object spread), serializes and writes back.
+ *
+ * Returns `true` if the bullet was found and the file was rewritten, `false` if
+ * no bullet with `id` was found (file is not modified in that case).
+ *
+ * Non-bullet lines (prose, headings, blank lines) are preserved verbatim.
+ */
+export declare function rewriteBullet(root: string, file: string, id: string, patch: Partial<Pick<Bullet, "text" | "status" | "salience" | "isInsight" | "dueAt" | "refs">>): boolean;
+//# sourceMappingURL=daily.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"daily.d.ts","sourceRoot":"","sources":["../../src/bujo/daily.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,CAG9D;AAED,wGAAwG;AACxG,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,CAO7E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,WAAW,GAAG,OAAO,GAAG,MAAM,CAAC,CAAC,GAC5F,OAAO,CAmBT"}

package/dist/bujo/daily.js

@@ -0,0 +1,47 @@
+import { appendFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { parseDailyFile, serializeBullet, serializeDailyFile } from "./grammar.js";
+export function dailyFilePath(root, when) {
+    const day = when.toISOString().slice(0, 10);
+    return join(root, "daily", `${day}.md`);
+}
+/** Append a bullet to today's daily file (creating it with a heading if absent). Returns the bullet. */
+export function appendBullet(root, bullet, when) {
+    const path = dailyFilePath(root, when);
+    mkdirSync(dirname(path), { recursive: true });
+    // existsSync (not read-and-catch) so a permission/IO error surfaces instead of being mistaken for a new file.
+    const header = existsSync(path) ? "" : `# ${when.toISOString().slice(0, 10)}\n\n`;
+    appendFileSync(path, `${header}${serializeBullet(bullet)}\n`, "utf8");
+    return bullet;
+}
+/**
+ * Rewrite a single bullet inside an existing daily file.
+ *
+ * Reads `<root>/<file>`, parses it, finds the line whose `bullet.id === id`,
+ * applies `patch` onto that Bullet (object spread), serializes and writes back.
+ *
+ * Returns `true` if the bullet was found and the file was rewritten, `false` if
+ * no bullet with `id` was found (file is not modified in that case).
+ *
+ * Non-bullet lines (prose, headings, blank lines) are preserved verbatim.
+ */
+export function rewriteBullet(root, file, id, patch) {
+    const path = join(root, file);
+    const content = readFileSync(path, "utf8");
+    const parsed = parseDailyFile(content);
+    let found = false;
+    const newLines = parsed.lines.map((line) => {
+        if (line.bullet === undefined || line.bullet.id !== id)
+            return line;
+        found = true;
+        // Build the merged bullet by applying only the defined patch keys so that
+        // exactOptionalPropertyTypes is satisfied (no undefined values injected).
+        const merged = { ...line.bullet, ...patch };
+        return { raw: line.raw, lineNumber: line.lineNumber, bullet: merged };
+    });
+    if (!found)
+        return false;
+    writeFileSync(path, serializeDailyFile({ lines: newLines }), "utf8");
+    return true;
+}
+//# sourceMappingURL=daily.js.map

package/dist/bujo/daily.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daily.js","sourceRoot":"","sources":["../../src/bujo/daily.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7F,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGnF,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,IAAU;IACpD,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC5C,OAAO,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,GAAG,KAAK,CAAC,CAAC;AAC1C,CAAC;AAED,wGAAwG;AACxG,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,MAAc,EAAE,IAAU;IACnE,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACvC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,8GAA8G;IAC9G,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC;IAClF,cAAc,CAAC,IAAI,EAAE,GAAG,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAY,EACZ,IAAY,EACZ,EAAU,EACV,KAA6F;IAE7F,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC9B,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IAEvC,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACzC,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE;YAAE,OAAO,IAAI,CAAC;QACpE,KAAK,GAAG,IAAI,CAAC;QACb,0EAA0E;QAC1E,0EAA0E;QAC1E,MAAM,MAAM,GAAW,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;QACpD,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IACxE,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAEzB,aAAa,CAAC,IAAI,EAAE,kBAAkB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;IACrE,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/bujo/distill.d.ts

@@ -0,0 +1,10 @@
+import type { MemoryType } from "../store/index.js";
+import type { LlmComplete } from "./llm.js";
+export interface CandidateMemory {
+    readonly type: MemoryType;
+    readonly text: string;
+    readonly salience: number;
+    readonly isInsight: boolean;
+}
+export declare function distill(text: string, llm: LlmComplete): Promise<CandidateMemory[]>;
+//# sourceMappingURL=distill.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"distill.d.ts","sourceRoot":"","sources":["../../src/bujo/distill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAI5C,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AASD,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAaxF"}

package/dist/bujo/distill.js

@@ -0,0 +1,50 @@
+import { parseJsonLoose } from "./json.js";
+import { MemoryModelError } from "./model-error.js";
+const PROMPT = (text) => `Extract durable memories from the text below as a JSON array.
+Each item: {"type":"task|event|note","text":"<one atomic sentence>","salience":0..1,"isInsight":true|false}.
+Rules: one fact per item; <=160 chars; omit chit-chat; salience reflects long-term importance; isInsight=true only for synthesized higher-level conclusions. Return ONLY the JSON array.
+
+TEXT:
+${text}`;
+export async function distill(text, llm) {
+    if (text.trim().length === 0)
+        return [];
+    let raw;
+    try {
+        raw = await llm.complete(PROMPT(text), { label: "capture:distill" });
+    }
+    catch (cause) {
+        // Surface model outages (Ollama down, timeout, 5xx) instead of returning [] — an empty result is
+        // indistinguishable from "nothing worth remembering", which is exactly how a dead model hides.
+        throw new MemoryModelError("llm", "distill", cause);
+    }
+    const parsed = parseJsonLoose(raw);
+    if (!Array.isArray(parsed))
+        return [];
+    return parsed.flatMap((it) => normalizeCandidate(it));
+}
+const VALID_TYPES = new Set(["task", "event", "note"]);
+function normalizeCandidate(it) {
+    if (it === null || typeof it !== "object")
+        return [];
+    const obj = it;
+    // Require non-empty text, then normalize to a bullet-safe single line so it round-trips through
+    // serializeBullet (which rejects newlines and the `<!--mem` delimiter) instead of being silently
+    // dropped by reconcile's per-candidate isolation. Collapse whitespace, strip the delimiter, cap ~280.
+    const rawText = typeof obj["text"] === "string" ? obj["text"] : "";
+    const text = rawText.replace(/\s+/gu, " ").replace(/<!--mem/gu, "").trim().slice(0, 280);
+    if (text.length === 0)
+        return [];
+    // Coerce type to one of task/event/note (default "note")
+    const rawType = typeof obj["type"] === "string" ? obj["type"] : "";
+    const type = VALID_TYPES.has(rawType) ? rawType : "note";
+    // Clamp salience to [0,1] (default 0.5 when missing/non-finite)
+    const rawSalience = typeof obj["salience"] === "number" ? obj["salience"] : NaN;
+    const salience = Number.isFinite(rawSalience)
+        ? Math.min(1, Math.max(0, rawSalience))
+        : 0.5;
+    // Coerce isInsight to boolean (default false)
+    const isInsight = typeof obj["isInsight"] === "boolean" ? obj["isInsight"] : false;
+    return [{ type, text, salience, isInsight }];
+}
+//# sourceMappingURL=distill.js.map

package/dist/bujo/distill.js.map

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

package/dist/bujo/entities.d.ts

@@ -0,0 +1,24 @@
+import type { LlmComplete } from "./llm.js";
+export interface ExtractedEntity {
+    readonly id: string;
+    readonly name: string;
+    readonly type?: string;
+}
+export interface ExtractedRelation {
+    readonly src: string;
+    readonly dst: string;
+    readonly relation: string;
+}
+export interface Extraction {
+    readonly entities: ExtractedEntity[];
+    readonly relations: ExtractedRelation[];
+}
+/**
+ * Use the LLM to extract named entities and their relations from `text`.
+ * Empty/whitespace text → `{entities:[], relations:[]}`.
+ * Malformed LLM *output* is handled defensively (→ EMPTY), but a model *failure* (Ollama down,
+ * timeout, 5xx) is rethrown as a {@link MemoryModelError} so it surfaces rather than looking like
+ * "no entities found".
+ */
+export declare function extractEntities(text: string, llm: LlmComplete): Promise<Extraction>;
+//# sourceMappingURL=entities.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../src/bujo/entities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAI5C,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,eAAe,EAAE,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,EAAE,CAAC;CACzC;AA2DD;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA6BzF"}