@bubstack/moe-memory 0.1.0

package/dist/journal/search.js

@@ -0,0 +1,203 @@
+/**
+ * Journal retrieval.
+ *
+ * Reconciled from private-journal-mcp's `SearchService`. The storage half lost:
+ * its `search()` loaded every `.embedding` sidecar under both roots into memory
+ * on every query and cosine-scored them in JS — O(n) I/O and O(n) memory per
+ * call, with no cache. That is replaced by the same sqlite-vec KNN the
+ * conversation half uses, over `vec_journal_entries`.
+ *
+ * Two things were carried FORWARD unchanged in substance, because they are the
+ * best-engineered code in that source and the conversation half has no
+ * equivalent:
+ *
+ *   - `readEntry`'s two-stage containment guard: resolve, require `.md`, require
+ *     containment in the journal roots, realpath, then require containment in
+ *     the REALPATH'd roots. The second stage blocks a symlink escape, and the
+ *     two stages exist precisely because macOS `/tmp` and `/var` are symlinks —
+ *     do not "simplify" it to one check.
+ *   - `generateExcerpt`, in ./markdown.ts.
+ *
+ * `SearchResult` and `SearchOptions` were exported by BOTH upstream `search.ts`
+ * files with different shapes. The conversation names keep their meaning; these
+ * are `JournalSearchResult` and `JournalSearchOptions`, so the barrel can export
+ * all four.
+ */
+import fs from "node:fs/promises";
+import path from "node:path";
+import { JOURNAL_SELECT_COLUMNS, journalEntryFromRow } from "../db.js";
+import { generateQueryEmbedding } from "../embeddings.js";
+import { l2DistanceToCosineSimilarity } from "../search.js";
+import { generateExcerpt, sectionsMatch } from "./markdown.js";
+function buildFilters(options, roots) {
+    const parts = [];
+    const params = [];
+    // Confine retrieval to the roots this service was constructed with.
+    //
+    // The service has always been handed them and never used them for filtering,
+    // so a `scope: "project"` entry written in one repo was returned in every
+    // other repo on the machine — they all share one database. The roots are the
+    // current project's journal directory plus the shared user directory, so user
+    // entries, which deliberately follow the person between projects, still match.
+    if (roots.length > 0) {
+        parts.push(`j.root IN (${roots.map(() => "?").join(", ")})`);
+        params.push(...roots);
+    }
+    if (options.scope && options.scope !== "both") {
+        parts.push("j.scope = ?");
+        params.push(options.scope);
+    }
+    if (options.dateRange?.start) {
+        parts.push("j.timestamp >= ?");
+        params.push(options.dateRange.start.getTime());
+    }
+    if (options.dateRange?.end) {
+        parts.push("j.timestamp <= ?");
+        params.push(options.dateRange.end.getTime());
+    }
+    return { sql: parts.length ? `AND ${parts.join(" AND ")}` : "", params };
+}
+export class JournalSearchService {
+    db;
+    roots;
+    embedQuery;
+    /**
+     * @param db    an open database from `initDatabase()`
+     * @param roots the journal roots, already de-duplicated (see `JournalStore.roots`)
+     */
+    constructor(db, roots, options = {}) {
+        this.db = db;
+        this.roots = roots.map((root) => path.resolve(root));
+        this.embedQuery = options.embedQuery ?? generateQueryEmbedding;
+    }
+    async search(query, options = {}) {
+        const limit = options.limit ?? 10;
+        const minScore = options.minScore ?? 0.1;
+        const sections = options.sections ?? [];
+        const queryEmbedding = await this.embedQuery(query);
+        const { sql: filterClause, params: filterParams } = buildFilters(options, this.roots);
+        // vec0 applies KNN before WHERE, so ask for more candidates than `limit`
+        // whenever a filter is active and trim afterwards — the same correction the
+        // conversation search makes for its metadata filters.
+        const overfetch = filterClause || sections.length > 0 ? 5 : 1;
+        const rows = this.db
+            .prepare(`
+      SELECT
+        ${JOURNAL_SELECT_COLUMNS},
+        vec.distance
+      FROM vec_journal_entries AS vec
+      JOIN journal_entries AS j ON vec.id = j.id
+      WHERE vec.embedding MATCH ?
+        AND k = ?
+        ${filterClause}
+      ORDER BY vec.distance ASC
+    `)
+            .all(Buffer.from(new Float32Array(queryEmbedding).buffer), limit * overfetch, ...filterParams);
+        const results = [];
+        for (const row of rows) {
+            const entry = journalEntryFromRow(row);
+            if (!sectionsMatch(entry.sections, sections))
+                continue;
+            const score = l2DistanceToCosineSimilarity(row.distance);
+            if (score < minScore)
+                continue;
+            results.push({ entry, score, excerpt: generateExcerpt(entry.text, query) });
+            if (results.length >= limit)
+                break;
+        }
+        return results;
+    }
+    listRecent(options = {}) {
+        const limit = options.limit ?? 10;
+        const { sql: filterClause, params: filterParams } = buildFilters(options, this.roots);
+        const rows = this.db
+            .prepare(`
+      SELECT ${JOURNAL_SELECT_COLUMNS}
+      FROM journal_entries AS j
+      WHERE 1 = 1
+        ${filterClause}
+      ORDER BY j.timestamp DESC
+      LIMIT ?
+    `)
+            .all(...filterParams, limit);
+        return rows.map((row) => {
+            const entry = journalEntryFromRow(row);
+            // No similarity score for a chronological listing — upstream reported 1.
+            return { entry, score: 1, excerpt: generateExcerpt(entry.text, "", 150) };
+        });
+    }
+    async readRecentEntries(options = {}) {
+        const recent = this.listRecent({ limit: options.limit ?? 5, scope: options.scope });
+        const results = [];
+        for (const hit of recent) {
+            const content = await this.readEntry(hit.entry.path);
+            if (content !== null) {
+                results.push({
+                    path: hit.entry.path,
+                    content,
+                    sections: hit.entry.sections,
+                    timestamp: hit.entry.timestamp,
+                    scope: hit.entry.scope,
+                });
+            }
+        }
+        return results;
+    }
+    /**
+     * Read one entry off disk.
+     *
+     * Carried over from private-journal-mcp with its guard intact. The error text
+     * is treated as API by three assertions, so it is preserved verbatim.
+     */
+    async readEntry(filePath) {
+        const resolvedPath = path.resolve(filePath);
+        // Only Markdown entries under the journal directories are readable; reject
+        // anything else with a clear error.
+        if (path.extname(resolvedPath).toLowerCase() !== ".md") {
+            throw new Error(`${resolvedPath} is not a readable journal entry`);
+        }
+        if (!isUnderRoot(resolvedPath, this.roots)) {
+            throw new Error(`${resolvedPath} is not a readable journal entry`);
+        }
+        let realPath;
+        try {
+            realPath = await fs.realpath(resolvedPath);
+        }
+        catch (error) {
+            if (error?.code === "ENOENT") {
+                return null;
+            }
+            throw error;
+        }
+        // Resolve symlinks and confirm the real file is still under a journal
+        // directory before reading.
+        if (!isUnderRoot(realPath, await this.realRoots())) {
+            throw new Error(`${resolvedPath} is not a readable journal entry`);
+        }
+        try {
+            return await fs.readFile(realPath, "utf8");
+        }
+        catch (error) {
+            if (error?.code === "ENOENT") {
+                return null;
+            }
+            throw error;
+        }
+    }
+    async realRoots() {
+        const roots = [];
+        for (const root of this.roots) {
+            try {
+                roots.push(await fs.realpath(root));
+            }
+            catch {
+                // A journal root that doesn't exist on disk can't contain anything.
+            }
+        }
+        return roots;
+    }
+}
+function isUnderRoot(candidate, roots) {
+    return roots.some((root) => candidate === root || candidate.startsWith(root + path.sep));
+}
+//# sourceMappingURL=search.js.map

package/dist/journal/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/journal/search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AACvE,OAAO,EAAgB,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AAE5D,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AA2C/D,SAAS,YAAY,CACnB,OAGC,EACD,KAAwB;IAExB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAc,EAAE,CAAC;IAC7B,oEAAoE;IACpE,EAAE;IACF,6EAA6E;IAC7E,0EAA0E;IAC1E,6EAA6E;IAC7E,8EAA8E;IAC9E,+EAA+E;IAC/E,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,cAAc,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7D,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;IACxB,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;QAC9C,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC1B,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IACD,IAAI,OAAO,CAAC,SAAS,EAAE,KAAK,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC/B,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,OAAO,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC/B,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC;AAC3E,CAAC;AAaD,MAAM,OAAO,oBAAoB;IASZ;IARF,KAAK,CAAW;IAChB,UAAU,CAAU;IAErC;;;OAGG;IACH,YACmB,EAAqB,EACtC,KAAe,EACf,UAAuC,EAAE;QAFxB,OAAE,GAAF,EAAE,CAAmB;QAItC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACrD,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,sBAAsB,CAAC;IACjE,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,UAAgC,EAAE;QAC5D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,GAAG,CAAC;QACzC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;QAExC,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACpD,MAAM,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAEtF,yEAAyE;QACzE,4EAA4E;QAC5E,sDAAsD;QACtD,MAAM,SAAS,GAAG,YAAY,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAE9D,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE;aACjB,OAAO,CAAC;;UAEL,sBAAsB;;;;;;UAMtB,YAAY;;KAEjB,CAAC;aACC,GAAG,CACF,MAAM,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,EACpD,KAAK,GAAG,SAAS,EACjB,GAAG,YAAY,CAC2D,CAAC;QAE/E,MAAM,OAAO,GAA0B,EAAE,CAAC;QAC1C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;YACvC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC;gBAAE,SAAS;YACvD,MAAM,KAAK,GAAG,4BAA4B,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACzD,IAAI,KAAK,GAAG,QAAQ;gBAAE,SAAS;YAC/B,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,eAAe,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;YAC5E,IAAI,OAAO,CAAC,MAAM,IAAI,KAAK;gBAAE,MAAM;QACrC,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,UAAU,CAAC,UAAgC,EAAE;QAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;QAClC,MAAM,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAEtF,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE;aACjB,OAAO,CAAC;eACA,sBAAsB;;;UAG3B,YAAY;;;KAGjB,CAAC;aACC,GAAG,CAAC,GAAG,YAAY,EAAE,KAAK,CAAqD,CAAC;QAEnF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YACtB,MAAM,KAAK,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;YACvC,yEAAyE;YACzE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,eAAe,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC;QAC5E,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,iBAAiB,CACrB,UAAkF,EAAE;QAEpF,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QAEpF,MAAM,OAAO,GAA0B,EAAE,CAAC;QAC1C,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACrD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrB,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI;oBACpB,OAAO;oBACP,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,QAAQ;oBAC5B,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,SAAS;oBAC9B,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK;iBACvB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,SAAS,CAAC,QAAgB;QAC9B,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAE5C,2EAA2E;QAC3E,oCAAoC;QACpC,IAAI,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,KAAK,KAAK,EAAE,CAAC;YACvD,MAAM,IAAI,KAAK,CAAC,GAAG,YAAY,kCAAkC,CAAC,CAAC;QACrE,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CAAC,GAAG,YAAY,kCAAkC,CAAC,CAAC;QACrE,CAAC;QAED,IAAI,QAAgB,CAAC;QACrB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QAC7C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA+B,EAAE,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACxD,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;QAED,sEAAsE;QACtE,4BAA4B;QAC5B,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC;YACnD,MAAM,IAAI,KAAK,CAAC,GAAG,YAAY,kCAAkC,CAAC,CAAC;QACrE,CAAC;QAED,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC7C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA+B,EAAE,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACxD,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,SAAS;QACrB,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,IAAI,CAAC;gBACH,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;YACtC,CAAC;YAAC,MAAM,CAAC;gBACP,oEAAoE;YACtE,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAED,SAAS,WAAW,CAAC,SAAiB,EAAE,KAAe;IACrD,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,KAAK,IAAI,IAAI,SAAS,CAAC,UAAU,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC3F,CAAC"}

package/dist/journal/store.d.ts

@@ -0,0 +1,96 @@
+/**
+ * The journal write path and its index.
+ *
+ * Reconciled from private-journal-mcp's `JournalManager`. The markdown-writing
+ * half is carried over essentially unchanged — it is a data contract with files
+ * already on disk. The persistence half changed completely: entries are indexed
+ * into the shared SQLite store instead of a `.embedding` JSON sidecar per file.
+ *
+ * That swap fixes a real defect. Upstream, `generateEmbeddingForEntry` caught and
+ * logged every embedding error so "embedding failure shouldn't prevent journal
+ * writing" — but the sidecar index was the ONLY enumeration path in the package,
+ * so a failed encode wrote an entry that no read path could ever see again, with
+ * no doctor or verify command to notice. Here the markdown files are the source
+ * of truth: `indexJournal()` walks them, and anything missing from the index or
+ * behind the current EMBEDDING_VERSION is picked up on the next run.
+ */
+import type Database from "better-sqlite3";
+import { type EmbedFn } from "../embeddings.js";
+import type { JournalScope, JournalThoughts } from "../types.js";
+export interface JournalStoreOptions {
+    projectPath?: string | undefined;
+    userPath?: string | undefined;
+    /**
+     * Injected encoder. Defaults to the real bge pipeline; the offline test
+     * project passes a deterministic stub so the write path and the index can be
+     * exercised without a 35 MB model download.
+     */
+    embed?: EmbedFn | undefined;
+}
+export interface JournalIndexResult {
+    indexed: number;
+    pruned: number;
+    failed: number;
+    total: number;
+}
+interface JournalRoot {
+    scope: JournalScope;
+    path: string;
+}
+export declare class JournalStore {
+    private readonly projectPath;
+    private readonly userPath;
+    private readonly embed;
+    constructor(options?: JournalStoreOptions);
+    /**
+     * The roots to walk, de-duplicated.
+     *
+     * When `MOE_MEMORY_JOURNAL_PATH` is set both resolve to the same directory.
+     * Upstream loaded such a directory twice — once labelled `project`, once
+     * `user` — so every entry appeared twice with contradictory labels and
+     * `limit: 10` yielded 5 unique entries. That is the documented containerised
+     * configuration, i.e. the one most likely to be used in infra.
+     */
+    roots(): JournalRoot[];
+    private get collapsed();
+    /**
+     * Which journal an entry belongs to.
+     *
+     * Normally the directory decides. When the roots are collapsed there is no
+     * directory to decide, so the entry's own sections do: `writeThoughts` routes
+     * `project_notes` to the project journal and nothing else, so the presence of
+     * a `## Project Notes` heading is a faithful discriminator either way.
+     */
+    private scopeFor;
+    /**
+     * Write one set of thoughts. `project_notes` lands in the project journal, the
+     * other five in the user journal, and each side is skipped when empty — so a
+     * `process_thoughts` call carrying only reflections creates no project
+     * directory at all.
+     *
+     * `db` is optional: pass it to index the new entries immediately (what the MCP
+     * server does), omit it to write markdown only.
+     */
+    writeThoughts(thoughts: JournalThoughts, db?: Database.Database): Promise<string[]>;
+    private writeToLocation;
+    private ensureDirectoryExists;
+    /**
+     * Index one markdown file by absolute path. Used straight after a write.
+     */
+    private indexOne;
+    private indexContent;
+    /**
+     * Walk both journal roots and bring the index up to date.
+     *
+     * Replaces private-journal-mcp's `generateMissingEmbeddings()`, which keyed
+     * purely on the absence of a `.embedding` sidecar. This one re-indexes when
+     * the file's mtime moved or its row is behind EMBEDDING_VERSION, and prunes
+     * rows whose file is gone — so an edited entry, a bumped encoder and a deleted
+     * file are all handled.
+     */
+    indexJournal(db: Database.Database): Promise<JournalIndexResult>;
+    /** Count indexed entries, optionally for one scope. */
+    count(db: Database.Database, scope?: JournalScope): number;
+}
+export {};
+//# sourceMappingURL=store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/journal/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAQ3C,OAAO,EAAE,KAAK,OAAO,EAA0B,MAAM,kBAAkB,CAAC;AAExE,OAAO,KAAK,EAAgB,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAY/E,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,WAAW;IACnB,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AA4BD,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;gBAEpB,OAAO,GAAE,mBAAwB;IAM7C;;;;;;;;OAQG;IACH,KAAK,IAAI,WAAW,EAAE;IAUtB,OAAO,KAAK,SAAS,GAEpB;IAED;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ;IAQhB;;;;;;;;OAQG;IACG,aAAa,CAAC,QAAQ,EAAE,eAAe,EAAE,EAAE,CAAC,EAAE,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YA+B3E,eAAe;YAaf,qBAAqB;IAgBnC;;OAEG;YACW,QAAQ;YAYR,YAAY;IA8B1B;;;;;;;;OAQG;IACG,YAAY,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAuFtE,uDAAuD;IACvD,KAAK,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,YAAY,GAAG,MAAM;CAG3D"}

package/dist/journal/store.js

@@ -0,0 +1,270 @@
+/**
+ * The journal write path and its index.
+ *
+ * Reconciled from private-journal-mcp's `JournalManager`. The markdown-writing
+ * half is carried over essentially unchanged — it is a data contract with files
+ * already on disk. The persistence half changed completely: entries are indexed
+ * into the shared SQLite store instead of a `.embedding` JSON sidecar per file.
+ *
+ * That swap fixes a real defect. Upstream, `generateEmbeddingForEntry` caught and
+ * logged every embedding error so "embedding failure shouldn't prevent journal
+ * writing" — but the sidecar index was the ONLY enumeration path in the package,
+ * so a failed encode wrote an entry that no read path could ever see again, with
+ * no doctor or verify command to notice. Here the markdown files are the source
+ * of truth: `indexJournal()` walks them, and anything missing from the index or
+ * behind the current EMBEDDING_VERSION is picked up on the next run.
+ */
+import fs from "node:fs/promises";
+import path from "node:path";
+import { countJournalEntries, deleteJournalEntry, getJournalIndexState, upsertJournalEntry, } from "../db.js";
+import { EMBEDDING_VERSION } from "../embedding-migration.js";
+import { generateEntryEmbedding } from "../embeddings.js";
+import { resolveProjectJournalPath, resolveUserJournalPath } from "../paths.js";
+import { DAY_DIR_PATTERN, extractSearchableText, formatDayDirectory, formatEntry, formatEntryBasename, journalEntryId, timestampFromEntryPath, timestampFromFrontmatter, } from "./markdown.js";
+/**
+ * `project_notes` is the only category that belongs to the codebase. The other
+ * five belong to the person, and follow them between projects.
+ */
+const PROJECT_KEYS = ["project_notes"];
+const USER_KEYS = [
+    "reflections",
+    "observations",
+    "user_context",
+    "technical_insights",
+    "world_knowledge",
+];
+function pick(thoughts, keys) {
+    const out = {};
+    for (const key of keys) {
+        const value = thoughts[key];
+        if (value !== undefined)
+            out[key] = value;
+    }
+    return out;
+}
+function hasContent(thoughts) {
+    return Object.values(thoughts).some((value) => value !== undefined && value !== "");
+}
+export class JournalStore {
+    projectPath;
+    userPath;
+    embed;
+    constructor(options = {}) {
+        this.projectPath = path.resolve(options.projectPath ?? resolveProjectJournalPath());
+        this.userPath = path.resolve(options.userPath ?? resolveUserJournalPath());
+        this.embed = options.embed ?? generateEntryEmbedding;
+    }
+    /**
+     * The roots to walk, de-duplicated.
+     *
+     * When `MOE_MEMORY_JOURNAL_PATH` is set both resolve to the same directory.
+     * Upstream loaded such a directory twice — once labelled `project`, once
+     * `user` — so every entry appeared twice with contradictory labels and
+     * `limit: 10` yielded 5 unique entries. That is the documented containerised
+     * configuration, i.e. the one most likely to be used in infra.
+     */
+    roots() {
+        if (this.projectPath === this.userPath) {
+            return [{ scope: "user", path: this.userPath }];
+        }
+        return [
+            { scope: "project", path: this.projectPath },
+            { scope: "user", path: this.userPath },
+        ];
+    }
+    get collapsed() {
+        return this.projectPath === this.userPath;
+    }
+    /**
+     * Which journal an entry belongs to.
+     *
+     * Normally the directory decides. When the roots are collapsed there is no
+     * directory to decide, so the entry's own sections do: `writeThoughts` routes
+     * `project_notes` to the project journal and nothing else, so the presence of
+     * a `## Project Notes` heading is a faithful discriminator either way.
+     */
+    scopeFor(root, sections) {
+        if (!this.collapsed)
+            return root.scope;
+        const isProject = sections.some((section) => section.toLowerCase().replace(/[^a-z0-9]/g, "") === "projectnotes");
+        return isProject ? "project" : "user";
+    }
+    /**
+     * Write one set of thoughts. `project_notes` lands in the project journal, the
+     * other five in the user journal, and each side is skipped when empty — so a
+     * `process_thoughts` call carrying only reflections creates no project
+     * directory at all.
+     *
+     * `db` is optional: pass it to index the new entries immediately (what the MCP
+     * server does), omit it to write markdown only.
+     */
+    async writeThoughts(thoughts, db) {
+        const timestamp = new Date();
+        const written = [];
+        const projectThoughts = pick(thoughts, PROJECT_KEYS);
+        if (hasContent(projectThoughts)) {
+            written.push(await this.writeToLocation(projectThoughts, timestamp, this.projectPath));
+        }
+        const userThoughts = pick(thoughts, USER_KEYS);
+        if (hasContent(userThoughts)) {
+            written.push(await this.writeToLocation(userThoughts, timestamp, this.userPath));
+        }
+        if (db) {
+            for (const entryPath of written) {
+                await this.indexOne(db, entryPath).catch((error) => {
+                    // Not fatal, and no longer invisible: the markdown file is the source
+                    // of truth and indexJournal() will retry this entry on the next run.
+                    console.error(`moe-memory: journal entry written but not indexed (${entryPath}): ${error instanceof Error ? error.message : String(error)}`);
+                });
+            }
+        }
+        return written;
+    }
+    async writeToLocation(thoughts, timestamp, basePath) {
+        const dayDirectory = path.join(basePath, formatDayDirectory(timestamp));
+        const filePath = path.join(dayDirectory, `${formatEntryBasename(timestamp)}.md`);
+        await this.ensureDirectoryExists(dayDirectory);
+        await fs.writeFile(filePath, formatEntry(thoughts, timestamp), "utf8");
+        return filePath;
+    }
+    async ensureDirectoryExists(dirPath) {
+        try {
+            await fs.access(dirPath);
+        }
+        catch {
+            try {
+                await fs.mkdir(dirPath, { recursive: true });
+            }
+            catch (mkdirError) {
+                throw new Error(`Failed to create journal directory at ${dirPath}: ${mkdirError instanceof Error ? mkdirError.message : String(mkdirError)}`);
+            }
+        }
+    }
+    /**
+     * Index one markdown file by absolute path. Used straight after a write.
+     */
+    async indexOne(db, entryPath) {
+        const root = this.roots().find((candidate) => entryPath === candidate.path || entryPath.startsWith(candidate.path + path.sep));
+        if (!root)
+            throw new Error(`${entryPath} is not under a journal root`);
+        const content = await fs.readFile(entryPath, "utf8");
+        const stat = await fs.stat(entryPath);
+        await this.indexContent(db, root, entryPath, content, stat.mtimeMs);
+    }
+    async indexContent(db, root, entryPath, content, mtimeMs) {
+        const { text, sections } = extractSearchableText(content);
+        if (text.trim().length === 0)
+            return; // Nothing to embed
+        const scope = this.scopeFor(root, sections);
+        // Frontmatter first (epoch ms), then the filename (second resolution), then
+        // the file's mtime. See timestampFromFrontmatter for why the order matters.
+        const timestamp = timestampFromFrontmatter(content) ?? timestampFromEntryPath(entryPath)?.getTime() ?? mtimeMs;
+        const entry = {
+            id: journalEntryId(scope, root.path, entryPath),
+            path: entryPath,
+            root: path.resolve(root.path),
+            scope,
+            timestamp,
+            text,
+            sections,
+        };
+        const embedding = await this.embed(text);
+        upsertJournalEntry(db, entry, mtimeMs, embedding);
+    }
+    /**
+     * Walk both journal roots and bring the index up to date.
+     *
+     * Replaces private-journal-mcp's `generateMissingEmbeddings()`, which keyed
+     * purely on the absence of a `.embedding` sidecar. This one re-indexes when
+     * the file's mtime moved or its row is behind EMBEDDING_VERSION, and prunes
+     * rows whose file is gone — so an edited entry, a bumped encoder and a deleted
+     * file are all handled.
+     */
+    async indexJournal(db) {
+        const result = { indexed: 0, pruned: 0, failed: 0, total: 0 };
+        const state = getJournalIndexState(db);
+        const seen = new Set();
+        for (const root of this.roots()) {
+            let dayDirs;
+            try {
+                dayDirs = await fs.readdir(root.path);
+            }
+            catch (error) {
+                if (error?.code !== "ENOENT") {
+                    console.error(`moe-memory: failed to scan journal root ${root.path}: ${String(error)}`);
+                }
+                continue;
+            }
+            for (const dayDir of dayDirs) {
+                if (!DAY_DIR_PATTERN.test(dayDir))
+                    continue;
+                const dayPath = path.join(root.path, dayDir);
+                let files;
+                try {
+                    const stat = await fs.stat(dayPath);
+                    if (!stat.isDirectory())
+                        continue;
+                    files = await fs.readdir(dayPath);
+                }
+                catch {
+                    continue;
+                }
+                for (const file of files) {
+                    if (!file.endsWith(".md"))
+                        continue;
+                    const entryPath = path.join(dayPath, file);
+                    result.total++;
+                    try {
+                        const content = await fs.readFile(entryPath, "utf8");
+                        const stat = await fs.stat(entryPath);
+                        const { sections } = extractSearchableText(content);
+                        const scope = this.scopeFor(root, sections);
+                        const id = journalEntryId(scope, root.path, entryPath);
+                        seen.add(id);
+                        const existing = state.get(id);
+                        const fresh = existing !== undefined &&
+                            existing.path === entryPath &&
+                            existing.sourceMtimeMs === stat.mtimeMs &&
+                            existing.embeddingVersion === EMBEDDING_VERSION;
+                        if (fresh)
+                            continue;
+                        await this.indexContent(db, root, entryPath, content, stat.mtimeMs);
+                        result.indexed++;
+                    }
+                    catch (error) {
+                        result.failed++;
+                        console.error(`moe-memory: failed to index journal entry ${entryPath}: ${error instanceof Error ? error.message : String(error)}`);
+                    }
+                }
+            }
+        }
+        // Prune only what this walk was actually responsible for.
+        //
+        // One database holds every project's entries, and `seen` can only ever
+        // contain ids from the roots above. Deleting everything absent from it
+        // therefore deleted other repos' project notes — permanently, on every
+        // server start. A row is a candidate for pruning only if its root is one of
+        // the roots just walked; anything else belongs to a project that is not this
+        // one, and its own next index is what will prune it.
+        //
+        // Rows written before `journal_entries.root` existed carry `''` and are
+        // never pruned here. migrateJournalRoot clears them once, so the case is
+        // transitional; treating an unknown root as "not mine" is the safe default
+        // regardless.
+        const walked = new Set(this.roots().map((root) => path.resolve(root.path)));
+        for (const [id, row] of state) {
+            if (seen.has(id))
+                continue;
+            if (!row.root || !walked.has(row.root))
+                continue;
+            deleteJournalEntry(db, id);
+            result.pruned++;
+        }
+        return result;
+    }
+    /** Count indexed entries, optionally for one scope. */
+    count(db, scope) {
+        return countJournalEntries(db, scope);
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/journal/store.js.map

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

package/dist/journal-cli.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `moe-memory journal <subcommand>` — the journal half from the terminal.
+ *
+ * private-journal-mcp had no CLI beyond `--journal-path`: its single bin was the
+ * MCP server and nothing else. These subcommands are new surface, and they exist
+ * because the journal is no longer self-indexing through sidecars — if the index
+ * can be rebuilt, something has to be able to rebuild it.
+ */
+import type { JournalScopeFilter } from "./journal/search.js";
+export interface JournalArgs {
+    /** Positional arguments joined — the search query. */
+    query: string;
+    limit: number;
+    scope: JournalScopeFilter;
+    journalPath: string | undefined;
+}
+export declare function parseJournalArgs(args: string[]): JournalArgs;
+export declare function runJournal(args: string[]): Promise<number>;
+//# sourceMappingURL=journal-cli.d.ts.map

package/dist/journal-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal-cli.d.ts","sourceRoot":"","sources":["../src/journal-cli.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AA6C9D,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,kBAAkB,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,WAAW,CAiC5D;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAwFhE"}