@vortex-os/memory-extended 0.5.1 → 0.5.3

package/dist/sqlite/fts.d.ts

@@ -0,0 +1,38 @@
+import type Database from "better-sqlite3";
+/**
+ * Keyword (FTS5) lane over memories — P3 hybrid search.
+ *
+ * A REGULAR stored-content FTS5 table (NOT contentless — see design §11 R4):
+ * it keeps its own copy of name/description/body so an upsert (the `memories`
+ * table uses INSERT OR REPLACE, which reassigns the integer rowid on every
+ * edit — verified) can be mirrored by a plain DELETE+INSERT on the stored
+ * `mid` without the rowid-desync an external-content+trigger table would hit.
+ * `mid` is the `memories.id` (TEXT), UNINDEXED, returned by MATCH for join-back.
+ *
+ * `trigram` gives Korean substring matching + ASCII case-folding; sub-3-codepoint
+ * terms (which trigram cannot match) fall back to LIKE over the source `memories`
+ * table. The table lives in the gitignored memory.sqlite and is a pure function
+ * of `memories` (rebuilt from data/_memory/*.md) — no new source of truth.
+ */
+export declare const MEMORY_FTS_SCHEMA = "\nCREATE VIRTUAL TABLE IF NOT EXISTS memory_fts USING fts5(\n  mid UNINDEXED,\n  name,\n  description,\n  body,\n  tokenize = 'trigram'\n);\n";
+export interface MemoryFtsOptions {
+    readonly limit: number;
+    /** Optional memory-id allowlist (hard-filter parity with the vector lane). */
+    readonly ids?: ReadonlySet<string>;
+}
+/**
+ * Keyword search over memories. Returns memory ids best-first — the order IS
+ * the keyword lane's rank for RRF fusion. bm25 column weights name>description>
+ * body. For any sub-3-codepoint query term, a bounded, deterministic LIKE over
+ * `memories` is merged in (trigram cannot match <3 codepoints — verified). The
+ * `ids` allowlist (when given) is applied in JS; the corpus is small.
+ */
+export declare function searchMemoryFts(db: Database.Database, query: string, options: MemoryFtsOptions): string[];
+/**
+ * Backfill memory_fts from `memories` when the FTS table is empty but memories
+ * is not — i.e. the memory.sqlite pre-dates this feature. Idempotent and guarded
+ * (a no-op once memory_fts has any row); cheap at memory-corpus scale. Run once
+ * at store open so the keyword lane goes live with no manual rebuild.
+ */
+export declare function backfillMemoryFts(db: Database.Database): void;
+//# sourceMappingURL=fts.d.ts.map

package/dist/sqlite/fts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fts.d.ts","sourceRoot":"","sources":["../../src/sqlite/fts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAG3C;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,iBAAiB,kJAQ7B,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,8EAA8E;IAC9E,QAAQ,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACpC;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,gBAAgB,GACxB,MAAM,EAAE,CAiDV;AAOD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAY7D"}

package/dist/sqlite/fts.js

@@ -0,0 +1,102 @@
+import { buildFtsQuery } from "../recall/ftsQuery.js";
+/**
+ * Keyword (FTS5) lane over memories — P3 hybrid search.
+ *
+ * A REGULAR stored-content FTS5 table (NOT contentless — see design §11 R4):
+ * it keeps its own copy of name/description/body so an upsert (the `memories`
+ * table uses INSERT OR REPLACE, which reassigns the integer rowid on every
+ * edit — verified) can be mirrored by a plain DELETE+INSERT on the stored
+ * `mid` without the rowid-desync an external-content+trigger table would hit.
+ * `mid` is the `memories.id` (TEXT), UNINDEXED, returned by MATCH for join-back.
+ *
+ * `trigram` gives Korean substring matching + ASCII case-folding; sub-3-codepoint
+ * terms (which trigram cannot match) fall back to LIKE over the source `memories`
+ * table. The table lives in the gitignored memory.sqlite and is a pure function
+ * of `memories` (rebuilt from data/_memory/*.md) — no new source of truth.
+ */
+export const MEMORY_FTS_SCHEMA = `
+CREATE VIRTUAL TABLE IF NOT EXISTS memory_fts USING fts5(
+  mid UNINDEXED,
+  name,
+  description,
+  body,
+  tokenize = 'trigram'
+);
+`;
+/**
+ * Keyword search over memories. Returns memory ids best-first — the order IS
+ * the keyword lane's rank for RRF fusion. bm25 column weights name>description>
+ * body. For any sub-3-codepoint query term, a bounded, deterministic LIKE over
+ * `memories` is merged in (trigram cannot match <3 codepoints — verified). The
+ * `ids` allowlist (when given) is applied in JS; the corpus is small.
+ */
+export function searchMemoryFts(db, query, options) {
+    const { match, shortTerms, hasTokens } = buildFtsQuery(query);
+    if (!hasTokens)
+        return [];
+    // The id allowlist is applied IN SQL (not after LIMIT) so a filtered memory
+    // ranked just below the unfiltered top `limit` is not dropped (Codex F4). FTS5
+    // permits constraining the UNINDEXED `mid` column alongside MATCH.
+    const idList = options.ids ? [...options.ids] : null;
+    const placeholders = idList ? idList.map(() => "?").join(",") : "";
+    const seen = new Set();
+    const out = [];
+    const take = (mid) => {
+        if (seen.has(mid))
+            return;
+        seen.add(mid);
+        out.push(mid);
+    };
+    if (match) {
+        const where = idList ? `memory_fts MATCH ? AND mid IN (${placeholders})` : `memory_fts MATCH ?`;
+        const rows = db
+            .prepare(`SELECT mid, bm25(memory_fts, 3.0, 2.0, 1.0) AS rank
+         FROM memory_fts
+         WHERE ${where}
+         ORDER BY rank
+         LIMIT ?`)
+            .all(match, ...(idList ?? []), options.limit);
+        for (const r of rows)
+            take(r.mid);
+    }
+    // Sub-3-codepoint terms: LIKE over the source memories table (the trigram
+    // index cannot match them). Deterministic ORDER BY before LIMIT (design §14);
+    // `updated DESC` puts NULLs last in SQLite, matching "null sorts after real".
+    for (const term of shortTerms) {
+        const like = `%${escapeLike(term)}%`;
+        const idFilter = idList ? ` AND id IN (${placeholders})` : "";
+        const rows = db
+            .prepare(`SELECT id AS mid FROM memories
+         WHERE (name LIKE ? ESCAPE '\\' OR description LIKE ? ESCAPE '\\' OR body LIKE ? ESCAPE '\\')${idFilter}
+         ORDER BY updated DESC, id ASC
+         LIMIT ?`)
+            .all(like, like, like, ...(idList ?? []), options.limit);
+        for (const r of rows)
+            take(r.mid);
+    }
+    return out.slice(0, options.limit);
+}
+/** Escape LIKE metacharacters so a literal %, _, or \ in a term is matched verbatim. */
+function escapeLike(s) {
+    return s.replace(/[\\%_]/g, (c) => `\\${c}`);
+}
+/**
+ * Backfill memory_fts from `memories` when the FTS table is empty but memories
+ * is not — i.e. the memory.sqlite pre-dates this feature. Idempotent and guarded
+ * (a no-op once memory_fts has any row); cheap at memory-corpus scale. Run once
+ * at store open so the keyword lane goes live with no manual rebuild.
+ */
+export function backfillMemoryFts(db) {
+    const ftsCount = db.prepare(`SELECT count(*) AS c FROM memory_fts`).get().c;
+    if (ftsCount > 0)
+        return;
+    const memCount = db.prepare(`SELECT count(*) AS c FROM memories`).get().c;
+    if (memCount === 0)
+        return;
+    const tx = db.transaction(() => {
+        db.exec(`INSERT INTO memory_fts(mid, name, description, body)
+       SELECT id, name, description, body FROM memories`);
+    });
+    tx();
+}
+//# sourceMappingURL=fts.js.map

package/dist/sqlite/fts.js.map

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

package/dist/sqlite/index.d.ts

@@ -19,4 +19,6 @@ export { MemorySqliteStore } from "./store.js";
 export { rebuildFromMemoryDir, readRowFromFile } from "./rebuild.js";
 export type { RebuildResult } from "./rebuild.js";
 export { driftCheck } from "./drift.js";
+export { MEMORY_FTS_SCHEMA, searchMemoryFts, backfillMemoryFts } from "./fts.js";
+export type { MemoryFtsOptions } from "./fts.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/sqlite/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sqlite/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,YAAY,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,SAAS,GACV,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACrE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sqlite/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,YAAY,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,SAAS,GACV,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACrE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACjF,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC"}

package/dist/sqlite/index.js

@@ -1,4 +1,5 @@
 export { MemorySqliteStore } from "./store.js";
 export { rebuildFromMemoryDir, readRowFromFile } from "./rebuild.js";
 export { driftCheck } from "./drift.js";
+export { MEMORY_FTS_SCHEMA, searchMemoryFts, backfillMemoryFts } from "./fts.js";
 //# sourceMappingURL=index.js.map

package/dist/sqlite/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sqlite/index.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAErE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sqlite/index.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAErE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC"}

package/dist/sqlite/store.d.ts

@@ -1,3 +1,4 @@
+import type { MemoryFtsOptions } from "./fts.js";
 import type { MemoryQuery, MemoryRow } from "./types.js";
 /**
  * SQLite-backed store mirroring `data/_memory/*.md`. The store is a
@@ -23,12 +24,18 @@ export declare class MemorySqliteStore {
     close(): void;
     /** Upsert a row + its tags. Atomic via SQLite transaction. */
     upsert(row: MemoryRow): void;
-    /** Delete a row + its tags (cascade). */
+    /** Delete a row + its tags (cascade) + its keyword-lane (memory_fts) row. */
     deleteById(id: string): boolean;
     /** Return all rows. Use sparingly — primarily for rebuild + drift scans. */
     listAll(): readonly MemoryRow[];
     /** Read a single row by id (or null if absent). */
     getById(id: string): MemoryRow | null;
+    /**
+     * Keyword (FTS5) search over memories — P3 hybrid search. Returns memory ids
+     * best-first (the order is the keyword lane's rank for fusion). Thin wrapper
+     * so callers never touch the raw db handle.
+     */
+    keywordSearch(query: string, options: MemoryFtsOptions): string[];
     byType(type: string): readonly MemoryRow[];
     byTag(tag: string): readonly MemoryRow[];
     byPrivacy(privacy: string): readonly MemoryRow[];

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

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/sqlite/store.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEzD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,iBAAiB;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,CAAoB;gBAElB,MAAM,EAAE,MAAM;IAa1B,KAAK,IAAI,IAAI;IAIb,8DAA8D;IAC9D,MAAM,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI;IA+B5B,yCAAyC;IACzC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAO/B,4EAA4E;IAC5E,OAAO,IAAI,SAAS,SAAS,EAAE;IAO/B,mDAAmD;IACnD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAOrC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,SAAS,EAAE;IAI1C,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,SAAS,EAAE;IAIxC,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,SAAS,EAAE;IAIhD;;;;OAIG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,SAAS,EAAE;IAO1D;;;;OAIG;IACH,KAAK,CAAC,CAAC,EAAE,WAAW,GAAG,SAAS,SAAS,EAAE;IAoC3C,OAAO,CAAC,OAAO;CAkBhB"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/sqlite/store.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEzD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,iBAAiB;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,CAAoB;gBAElB,MAAM,EAAE,MAAM;IAiB1B,KAAK,IAAI,IAAI;IAIb,8DAA8D;IAC9D,MAAM,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI;IAsC5B,6EAA6E;IAC7E,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAS/B,4EAA4E;IAC5E,OAAO,IAAI,SAAS,SAAS,EAAE;IAO/B,mDAAmD;IACnD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAOrC;;;;OAIG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,MAAM,EAAE;IAIjE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,SAAS,EAAE;IAI1C,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,SAAS,EAAE;IAIxC,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,SAAS,EAAE;IAIhD;;;;OAIG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,SAAS,EAAE;IAO1D;;;;OAIG;IACH,KAAK,CAAC,CAAC,EAAE,WAAW,GAAG,SAAS,SAAS,EAAE;IAoC3C,OAAO,CAAC,OAAO;CAkBhB"}

package/dist/sqlite/store.js

@@ -2,6 +2,7 @@ import { chmodSync, mkdirSync } from "node:fs";
 import { dirname } from "node:path";
 import Database from "better-sqlite3";
 import { SCHEMA } from "./schema.js";
+import { MEMORY_FTS_SCHEMA, backfillMemoryFts, searchMemoryFts } from "./fts.js";
 /**
  * SQLite-backed store mirroring `data/_memory/*.md`. The store is a
  * derived index — markdown remains the source of truth (see
@@ -33,6 +34,10 @@ export class MemorySqliteStore {
         this.db.pragma("journal_mode = WAL");
         this.db.pragma("foreign_keys = ON");
         this.db.exec(SCHEMA);
+        // Keyword (FTS5) lane for P3 hybrid search. Additive + idempotent; the
+        // backfill lights it up on an instance whose memory.sqlite pre-dates it.
+        this.db.exec(MEMORY_FTS_SCHEMA);
+        backfillMemoryFts(this.db);
     }
     close() {
         this.db.close();
@@ -41,8 +46,8 @@ export class MemorySqliteStore {
     upsert(row) {
         const tx = this.db.transaction(() => {
             this.db
-                .prepare(`INSERT OR REPLACE INTO memories
-           (id, name, description, type, privacy, created, updated, body, body_hash, frontmatter_json)
+                .prepare(`INSERT OR REPLACE INTO memories
+           (id, name, description, type, privacy, created, updated, body, body_hash, frontmatter_json)
            VALUES (@id, @name, @description, @type, @privacy, @created, @updated, @body, @bodyHash, @frontmatterJson)`)
                 .run({
                 id: row.id,
@@ -62,15 +67,24 @@ export class MemorySqliteStore {
             const tagInsert = this.db.prepare(`INSERT INTO memory_tags (memory_id, tag) VALUES (?, ?)`);
             for (const tag of row.tags)
                 tagInsert.run(row.id, tag);
+            // Keyword (FTS5) lane — keep memory_fts in lockstep within the same tx so
+            // it can never drift. memories uses INSERT OR REPLACE (reassigns rowid),
+            // so we DELETE+INSERT by the stored `mid`, not an external-content link.
+            this.db.prepare(`DELETE FROM memory_fts WHERE mid = ?`).run(row.id);
+            this.db
+                .prepare(`INSERT INTO memory_fts(mid, name, description, body) VALUES (?, ?, ?, ?)`)
+                .run(row.id, row.name, row.description, row.body);
         });
         tx();
     }
-    /** Delete a row + its tags (cascade). */
+    /** Delete a row + its tags (cascade) + its keyword-lane (memory_fts) row. */
     deleteById(id) {
-        const res = this.db
-            .prepare(`DELETE FROM memories WHERE id = ?`)
-            .run(id);
-        return res.changes > 0;
+        const tx = this.db.transaction(() => {
+            // memory_fts is a virtual table (no FK cascade), so clear it explicitly.
+            this.db.prepare(`DELETE FROM memory_fts WHERE mid = ?`).run(id);
+            return this.db.prepare(`DELETE FROM memories WHERE id = ?`).run(id);
+        });
+        return tx().changes > 0;
     }
     /** Return all rows. Use sparingly — primarily for rebuild + drift scans. */
     listAll() {
@@ -86,6 +100,14 @@ export class MemorySqliteStore {
             .get(id);
         return row ? this.hydrate(row) : null;
     }
+    /**
+     * Keyword (FTS5) search over memories — P3 hybrid search. Returns memory ids
+     * best-first (the order is the keyword lane's rank for fusion). Thin wrapper
+     * so callers never touch the raw db handle.
+     */
+    keywordSearch(query, options) {
+        return searchMemoryFts(this.db, query, options);
+    }
     byType(type) {
         return this.query({ type: [type] });
     }

package/dist/sqlite/store.js.map

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

package/dist/vector/embedder.d.ts

@@ -48,6 +48,17 @@ export interface LocalEmbedderOptions {
         readonly query: string;
         readonly passage: string;
     } | null;
+    /**
+     * Load only from the local model cache — never hit the network. When the
+     * model is not yet cached this makes the **first embed fail fast (no
+     * download)** instead of blocking on a ~470 MB fetch. Use it for
+     * automatic/background paths (e.g. session-start vectorization) so they can
+     * never trigger an unprompted download: if the model is absent they error
+     * immediately and the caller skips. The explicit, user-consented `/recall`
+     * setup uses the default (`false`) and is what brings the model into the
+     * cache in the first place.
+     */
+    readonly localFilesOnly?: boolean;
 }
 /**
  * Build an {@link EmbedFn} backed by a local transformers pipeline. The

package/dist/vector/embedder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"embedder.d.ts","sourceRoot":"","sources":["../../src/vector/embedder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAa,MAAM,YAAY,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,WAAW,oBAAoB;IACnC,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACjF;AAKD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CA2C3E"}
+{"version":3,"file":"embedder.d.ts","sourceRoot":"","sources":["../../src/vector/embedder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAa,MAAM,YAAY,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,WAAW,oBAAoB;IACnC,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAChF;;;;;;;;;OASG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;CACnC;AAKD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CA+C3E"}

package/dist/vector/embedder.js

@@ -11,6 +11,7 @@ export function createLocalEmbedder(options) {
     const pooling = options?.pooling ?? "mean";
     // undefined → e5 defaults; null → disabled (symmetric models).
     const prefixes = options?.prefixes === undefined ? E5_PREFIXES : options.prefixes;
+    const localFilesOnly = options?.localFilesOnly ?? false;
     // Lazily-created, memoized pipeline promise. Typed loosely because the
     // dependency is optional-at-build-time and resolved at runtime.
     let pipePromise = null;
@@ -32,7 +33,9 @@ export function createLocalEmbedder(options) {
                     `to avoid the local model entirely. Original error: ${e.message}`);
             }
             const pipeline = mod.pipeline;
-            const extractor = (await pipeline("feature-extraction", model));
+            // `local_files_only` keeps transformers.js from reaching the network: a
+            // cache miss throws immediately instead of downloading ~470 MB.
+            const extractor = (await pipeline("feature-extraction", model, localFilesOnly ? { local_files_only: true } : undefined));
             return extractor;
         })();
         return pipePromise;

package/dist/vector/embedder.js.map

@@ -1 +1 @@
-{"version":3,"file":"embedder.js","sourceRoot":"","sources":["../../src/vector/embedder.ts"],"names":[],"mappings":"AAkDA,MAAM,aAAa,GAAG,8BAA8B,CAAC;AACrD,MAAM,WAAW,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAW,CAAC;AAExE;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAA8B;IAChE,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,aAAa,CAAC;IAC9C,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,MAAM,CAAC;IAC3C,+DAA+D;IAC/D,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IAElF,uEAAuE;IACvE,gEAAgE;IAChE,IAAI,WAAW,GAA0F,IAAI,CAAC;IAE9G,KAAK,UAAU,OAAO;QACpB,IAAI,WAAW;YAAE,OAAO,WAAW,CAAC;QACpC,WAAW,GAAG,CAAC,KAAK,IAAI,EAAE;YACxB,oEAAoE;YACpE,4DAA4D;YAC5D,MAAM,SAAS,GAAG,2BAA2B,CAAC;YAC9C,IAAI,GAAoE,CAAC;YACzE,IAAI,CAAC;gBACH,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,CAAe,CAAC;YAChD,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,IAAI,KAAK,CACb,mEAAmE;oBACjE,4EAA4E;oBAC5E,yEAAyE;oBACzE,sDAAuD,CAAW,CAAC,OAAO,EAAE,CAC/E,CAAC;YACJ,CAAC;YACD,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;YAC9B,MAAM,SAAS,GAAG,CAAC,MAAM,QAAQ,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAGrB,CAAC;YAC1C,OAAO,SAAS,CAAC;QACnB,CAAC,CAAC,EAAE,CAAC;QACL,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,OAAO,KAAK,EAAE,IAAY,EAAE,IAAgB,EAAE,EAAE;QAC9C,MAAM,SAAS,GAAG,MAAM,OAAO,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACtF,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,GAAG,IAAI,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5E,OAAO,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"embedder.js","sourceRoot":"","sources":["../../src/vector/embedder.ts"],"names":[],"mappings":"AA6DA,MAAM,aAAa,GAAG,8BAA8B,CAAC;AACrD,MAAM,WAAW,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAW,CAAC;AAExE;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAA8B;IAChE,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,aAAa,CAAC;IAC9C,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,MAAM,CAAC;IAC3C,+DAA+D;IAC/D,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IAClF,MAAM,cAAc,GAAG,OAAO,EAAE,cAAc,IAAI,KAAK,CAAC;IAExD,uEAAuE;IACvE,gEAAgE;IAChE,IAAI,WAAW,GAA0F,IAAI,CAAC;IAE9G,KAAK,UAAU,OAAO;QACpB,IAAI,WAAW;YAAE,OAAO,WAAW,CAAC;QACpC,WAAW,GAAG,CAAC,KAAK,IAAI,EAAE;YACxB,oEAAoE;YACpE,4DAA4D;YAC5D,MAAM,SAAS,GAAG,2BAA2B,CAAC;YAC9C,IAAI,GAAoF,CAAC;YACzF,IAAI,CAAC;gBACH,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,CAAe,CAAC;YAChD,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,IAAI,KAAK,CACb,mEAAmE;oBACjE,4EAA4E;oBAC5E,yEAAyE;oBACzE,sDAAuD,CAAW,CAAC,OAAO,EAAE,CAC/E,CAAC;YACJ,CAAC;YACD,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;YAC9B,wEAAwE;YACxE,gEAAgE;YAChE,MAAM,SAAS,GAAG,CAAC,MAAM,QAAQ,CAC/B,oBAAoB,EACpB,KAAK,EACL,cAAc,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CACxD,CAA0E,CAAC;YAC5E,OAAO,SAAS,CAAC;QACnB,CAAC,CAAC,EAAE,CAAC;QACL,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,OAAO,KAAK,EAAE,IAAY,EAAE,IAAgB,EAAE,EAAE;QAC9C,MAAM,SAAS,GAAG,MAAM,OAAO,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACtF,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,GAAG,IAAI,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5E,OAAO,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC,CAAC;AACJ,CAAC"}

package/dist/vector/segment.d.ts

@@ -7,7 +7,7 @@ import type { EmbedFn } from "./types.js";
  * running centroid tracks "the current topic so far"; when a new turn's
  * cosine similarity to that centroid drops below `threshold` (and the chunk
  * already has at least `minUnits` turns), a boundary is cut. Min/max guards
- * keep chunks from being a single "응" or growing unbounded.
+ * keep chunks from being a single "yeah" or growing unbounded.
  *
  * Boundary detection uses the per-turn embeddings (running centroid). The
  * stored chunk vector, however, is a fresh embedding of the chunk's *joined

package/dist/vector/store.d.ts

@@ -38,14 +38,24 @@ export declare class MemoryVectorStore {
      */
     upsert(row: MemoryRow, embed: EmbedFn): Promise<boolean>;
     /**
-     * Rebuild the `memory` source from the sqlite store: embed every memory,
+     * Rebuild the `memory` source from the sqlite store: embed each memory,
      * upsert it, and prune vectors whose memory no longer exists. Idempotent.
      *
      * `embed` is called once per memory; pass a memoized embedder (the
      * default `createLocalEmbedder()` memoizes its pipeline) so the model
      * loads once.
+     *
+     * With `{ onlyMissing: true }` a memory that already has a vector is left
+     * untouched (not re-embedded) — the incremental mode used by the automatic
+     * session-start pass so it embeds only newly-added memories and stays cheap.
+     * Pruning of deleted memories still runs. Caveat: a memory *edited* in place
+     * keeps its prior vector until a full rebuild (`onlyMissing` omitted, e.g.
+     * `npx rebuild-memory-vector`), since presence — not content — is the skip
+     * test; its sqlite hard-filter row is always current.
      */
-    rebuild(sqlite: MemorySqliteStore, embed: EmbedFn): Promise<VectorRebuildResult>;
+    rebuild(sqlite: MemorySqliteStore, embed: EmbedFn, options?: {
+        readonly onlyMissing?: boolean;
+    }): Promise<VectorRebuildResult>;
     /**
      * Rebuild the `session-archive` source: segment each archived session into
      * topic chunks (embedding-similarity), embed each chunk, store the vector

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

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/vector/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGtE,OAAO,EAGL,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EAC1B,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EACV,OAAO,EACP,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,6CAA6C;AAC7C,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;CAClC;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,2EAA2E;IAC3E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;gBAErB,OAAO,GAAE,wBAA6B;IAclD,8DAA8D;IAC9D,IAAI,aAAa,IAAI,aAAa,CAEjC;IAED;;;OAGG;IACG,MAAM,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ9D;;;;;;;OAOG;IACG,OAAO,CAAC,MAAM,EAAE,iBAAiB,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAuBtF;;;;;;OAMG;IACG,eAAe,CACnB,QAAQ,EAAE,mBAAmB,EAC7B,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,oBAAoB,CAAC;IAchC;;;;;OAKG;IACG,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC;IAKtC,uEAAuE;IACvE,YAAY,CACV,WAAW,EAAE,YAAY,EACzB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,SAAS,eAAe,EAAE;IAI7B,KAAK,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM;IAIpC,KAAK,IAAI,IAAI;CAGd"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/vector/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGtE,OAAO,EAGL,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EAC1B,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EACV,OAAO,EACP,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,6CAA6C;AAC7C,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;CAClC;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,2EAA2E;IAC3E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;gBAErB,OAAO,GAAE,wBAA6B;IAclD,8DAA8D;IAC9D,IAAI,aAAa,IAAI,aAAa,CAEjC;IAED;;;OAGG;IACG,MAAM,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ9D;;;;;;;;;;;;;;;OAeG;IACG,OAAO,CACX,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GAC3C,OAAO,CAAC,mBAAmB,CAAC;IA8B/B;;;;;;OAMG;IACG,eAAe,CACnB,QAAQ,EAAE,mBAAmB,EAC7B,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,oBAAoB,CAAC;IAchC;;;;;OAKG;IACG,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC;IAKtC,uEAAuE;IACvE,YAAY,CACV,WAAW,EAAE,YAAY,EACzB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,SAAS,eAAe,EAAE;IAI7B,KAAK,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM;IAIpC,KAAK,IAAI,IAAI;CAGd"}

package/dist/vector/store.js

@@ -49,19 +49,34 @@ export class MemoryVectorStore {
         return true;
     }
     /**
-     * Rebuild the `memory` source from the sqlite store: embed every memory,
+     * Rebuild the `memory` source from the sqlite store: embed each memory,
      * upsert it, and prune vectors whose memory no longer exists. Idempotent.
      *
      * `embed` is called once per memory; pass a memoized embedder (the
      * default `createLocalEmbedder()` memoizes its pipeline) so the model
      * loads once.
+     *
+     * With `{ onlyMissing: true }` a memory that already has a vector is left
+     * untouched (not re-embedded) — the incremental mode used by the automatic
+     * session-start pass so it embeds only newly-added memories and stays cheap.
+     * Pruning of deleted memories still runs. Caveat: a memory *edited* in place
+     * keeps its prior vector until a full rebuild (`onlyMissing` omitted, e.g.
+     * `npx rebuild-memory-vector`), since presence — not content — is the skip
+     * test; its sqlite hard-filter row is always current.
      */
-    async rebuild(sqlite, embed) {
+    async rebuild(sqlite, embed, options) {
+        const existing = options?.onlyMissing ? new Set(this.backend.listIds("memory")) : null;
         const memories = sqlite.listAll();
         const liveIds = new Set();
         let indexed = 0;
         let skipped = 0;
         for (const m of memories) {
+            if (existing?.has(m.id)) {
+                // Already vectorized — keep it (so it is not pruned) and skip the embed.
+                liveIds.add(m.id);
+                skipped++;
+                continue;
+            }
             const ok = await this.upsert(m, embed);
             if (ok) {
                 liveIds.add(m.id);

package/dist/vector/store.js.map

@@ -1 +1 @@
-{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/vector/store.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/vector/store.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EACL,iBAAiB,EACjB,qBAAqB,GAGtB,MAAM,cAAc,CAAC;AAqBtB;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,iBAAiB;IACX,OAAO,CAAgB;IACxC,2EAA2E;IAC1D,MAAM,CAAU;IAEjC,YAAY,UAAoC,EAAE;QAChD,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;YAC/B,IAAI,QAAQ,IAAI,OAAO,CAAC,OAAO,IAAI,OAAQ,OAAO,CAAC,OAAgC,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACxG,IAAI,CAAC,MAAM,GAAI,OAAO,CAAC,OAA8B,CAAC,MAAM,CAAC;YAC/D,CAAC;QACH,CAAC;aAAM,IAAI,OAAO,CAAC,EAAE,EAAE,CAAC;YACtB,IAAI,CAAC,OAAO,GAAG,IAAI,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACjD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,EAAE,CAAC;QAC3B,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;IAED,8DAA8D;IAC9D,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM,CAAC,GAAc,EAAE,KAAc;QACzC,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACpC,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QACpF,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,OAAO,CACX,MAAyB,EACzB,KAAc,EACd,OAA4C;QAE5C,MAAM,QAAQ,GAAG,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACvF,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,IAAI,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;gBACxB,yEAAyE;gBACzE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAClB,OAAO,EAAE,CAAC;gBACV,SAAS;YACX,CAAC;YACD,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YACvC,IAAI,EAAE,EAAE,CAAC;gBACP,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAClB,OAAO,EAAE,CAAC;YACZ,CAAC;iBAAM,CAAC;gBACN,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;QACD,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBACrB,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC;oBAAE,MAAM,EAAE,CAAC;YAClD,CAAC;QACH,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IACtC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,eAAe,CACnB,QAA6B,EAC7B,KAAc,EACd,OAA+B;QAE/B,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,yHAAyH,CAC1H,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClD,IAAI,CAAC;YACH,OAAO,MAAM,qBAAqB,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QACrF,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAM,CACV,SAAiB,EACjB,KAAc,EACd,OAA6B;QAE7B,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,uEAAuE;IACvE,YAAY,CACV,WAAyB,EACzB,OAA6B;QAE7B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,MAAqB;QACzB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACF;AAED,uEAAuE;AACvE,SAAS,cAAc,CAAC,GAAc;IACpC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,IAAI,CAAC;SACzC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;SAC5B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;SAC3B,IAAI,CAAC,MAAM,CAAC;SACZ,IAAI,EAAE,CAAC;AACZ,CAAC"}

package/dist/vector/types.d.ts

@@ -4,7 +4,7 @@
  * Phase 11c, operator decisions (2026-05-29 afternoon):
  *
  *  - **Decision 1 (embedder)** — host-injected `EmbedFn`. A default local
- *    embedder (`createLocalEmbedder`, `@huggingface/transformers` MiniLM)
+ *    embedder (`createLocalEmbedder`, `@huggingface/transformers` multilingual e5-small)
  *    ships with this package and loads lazily on first use; operators can
  *    swap it for an API embedder by passing their own `EmbedFn`.
  *  - **Decision 2 (backend)** — default is in-process brute-force cosine

package/dist/vector/types.js

@@ -4,7 +4,7 @@
  * Phase 11c, operator decisions (2026-05-29 afternoon):
  *
  *  - **Decision 1 (embedder)** — host-injected `EmbedFn`. A default local
- *    embedder (`createLocalEmbedder`, `@huggingface/transformers` MiniLM)
+ *    embedder (`createLocalEmbedder`, `@huggingface/transformers` multilingual e5-small)
  *    ships with this package and loads lazily on first use; operators can
  *    swap it for an API embedder by passing their own `EmbedFn`.
  *  - **Decision 2 (backend)** — default is in-process brute-force cosine

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vortex-os/memory-extended",
-  "version": "0.5.1",
+  "version": "0.5.3",
   "description": "Add-on cluster — extended memory namespaces (sqlite, vector, sessionArchive, recall, consolidate) layered on @vortex-os/base.",
   "license": "MIT",
   "author": "vortex-os-project",
@@ -64,9 +64,9 @@
   "dependencies": {
     "yaml": "^2.6.0"
   },
-  "_releaseNote": "@vortex-os/base (^0.3.0 || ^0.4.0) is the only @vortex-os peer; it is published. The proactive-curator surface this add-on used is inlined (src/internal/proactive-curator-helpers.ts), so no separate @vortex-os/proactive-curator dependency is needed. better-sqlite3 / classic-level are native peers.",
+  "_releaseNote": "0.5.3: broadened the @vortex-os/base peer to '>=0.3.0 <1.0.0' (any 0.x) so an mx republish is NOT needed on every base minor. The trigger was base 0.6.0 (a minor for new features): mx 0.5.2's range topped out at ^0.5.0 and ERESOLVE-conflicted against base 0.6.0. @vortex-os/base is the only @vortex-os peer; it is published. The proactive-curator surface this add-on used is inlined (src/internal/proactive-curator-helpers.ts), so no separate @vortex-os/proactive-curator dependency is needed. better-sqlite3 / classic-level are native peers.",
   "peerDependencies": {
-    "@vortex-os/base": "^0.3.0 || ^0.4.0",
+    "@vortex-os/base": ">=0.3.0 <1.0.0",
     "better-sqlite3": "^12.0.0",
     "classic-level": "^3.0.0"
   },