@equationalapplications/expo-llm-wiki 2.0.2 → 2.2.0

package/README.md

@@ -13,6 +13,7 @@ Offline-first, SQLite-backed memory for LLM apps built with Expo. Handles FTS5 s
 - **Namespace Safe:** All tables are prefixed (default: `llm_wiki_`) — no collisions with your existing database.
 - **Multi-Entity:** Multiple independent "brains" in one database via `entityId`.
 - **Offline First:** Reads are fully local via SQLite FTS5, typically under 50ms.
+- **Morphological Matching:** Porter stemming enables recall across word forms — queries for `running` match facts about `run`, `runs`, etc., without manual synonym configuration.
 - **Full Unicode Support:** UTF-8 and UTF-16 (including surrogate pairs for emoji) are fully supported. Chunks are split safely at sentence boundaries; surrogate pairs are never fragmented.
 
 ## How It Works
@@ -94,6 +95,8 @@ const wiki = createWiki(db, {
     maxFtsResults: 10,              // optional, default: 10
     autoLibrarianThreshold: 20,     // optional, default: 20
     maxChunkLength: 6000,           // optional, default: 6000 (char count, not bytes)
+    chunkOverlap: 400,              // optional, default: 400 (overlap between chunks in characters)
+    chunkConcurrency: 1,            // optional, default: 1 (parallel LLM calls per ingestDocument)
   },
 });
 
@@ -142,6 +145,7 @@ const result = await wiki.ingestDocument('entity-123', {
   documentChunk: content,
   maxChunkLength: 12000,              // optional, character count
   chunkOverlap: 400,                  // optional, overlap in characters
+  chunkConcurrency: 1,                // optional, parallel LLM calls per ingest (default: 1)
 });
 // result: { truncated: boolean; chunks: number }
 // truncated: true if at least one hard-split was required (no sentence boundary)

package/dist/{WikiMemory-B54Gaa-K.d.mts → WikiMemory-CjlQ68X0.d.mts}

@@ -4,6 +4,7 @@ interface WikiConfig {
     tablePrefix?: string;
     maxFtsResults?: number;
     pruneEventsAfter?: number;
+    pruneRetainSoftDeletedFor?: number;
     autoLibrarianThreshold?: number;
     autoHealThreshold?: number;
     orphanAfterDays?: number | null;
@@ -11,6 +12,15 @@ interface WikiConfig {
     maxChunkLength?: number;
     chunkOverlap?: number;
     chunkConcurrency?: number;
+    /**
+     * Static caller-supplied synonym expansions applied at query time.
+     * Keys must match the same normalization pipeline used by query formatting:
+     * the query is lowercased, stripped to `[a-z0-9 ]`, split into tokens, and
+     * only tokens with length >= 3 are considered for synonym lookup.
+     * Values are appended to the FTS5 query token list (multi-word values are
+     * split into tokens), then deduped and sliced to 12.
+     */
+    synonymMap?: Record<string, string[]>;
 }
 interface WikiFact {
     id: string;
@@ -92,15 +102,28 @@ interface FormattedMemoryDump {
         content: string;
     }>;
 }
+interface FormatContextOptions {
+    format?: 'markdown' | 'plain';
+    maxFacts?: number;
+    maxTasks?: number;
+    maxEvents?: number;
+    includeConfidence?: boolean;
+    includeTags?: boolean;
+    factWeights?: {
+        confidence?: number;
+        accessCount?: number;
+        recency?: number;
+    };
+}
 interface EntityStatus {
     ingesting: boolean;
     librarian: boolean;
     heal: boolean;
 }
 declare class WikiBusyError extends Error {
-    readonly operation: 'ingest' | 'librarian' | 'heal';
+    readonly operation: 'ingest' | 'librarian' | 'heal' | 'prune';
     readonly entityId: string;
-    constructor(operation: 'ingest' | 'librarian' | 'heal', entityId: string);
+    constructor(operation: 'ingest' | 'librarian' | 'heal' | 'prune', entityId: string);
 }
 
 declare class WikiMemory {
@@ -154,4 +177,4 @@ declare class WikiMemory {
     }>;
 }
 
-export { type EntityStatus as E, type FormattedMemoryDump as F, type LLMProvider as L, type MemoryDump as M, type WikiOptions as W, WikiMemory as a, type ExtractedFact as b, type ExtractedTask as c, type MemoryBundle as d, WikiBusyError as e, type WikiCheckpoint as f, type WikiConfig as g, type WikiEvent as h, type WikiFact as i, type WikiTask as j };
+export { type EntityStatus as E, type FormattedMemoryDump as F, type LLMProvider as L, type MemoryDump as M, type WikiOptions as W, WikiMemory as a, type ExtractedFact as b, type ExtractedTask as c, type FormatContextOptions as d, type MemoryBundle as e, WikiBusyError as f, type WikiCheckpoint as g, type WikiConfig as h, type WikiEvent as i, type WikiFact as j, type WikiTask as k };

package/dist/{WikiMemory-B54Gaa-K.d.ts → WikiMemory-CjlQ68X0.d.ts}

@@ -4,6 +4,7 @@ interface WikiConfig {
     tablePrefix?: string;
     maxFtsResults?: number;
     pruneEventsAfter?: number;
+    pruneRetainSoftDeletedFor?: number;
     autoLibrarianThreshold?: number;
     autoHealThreshold?: number;
     orphanAfterDays?: number | null;
@@ -11,6 +12,15 @@ interface WikiConfig {
     maxChunkLength?: number;
     chunkOverlap?: number;
     chunkConcurrency?: number;
+    /**
+     * Static caller-supplied synonym expansions applied at query time.
+     * Keys must match the same normalization pipeline used by query formatting:
+     * the query is lowercased, stripped to `[a-z0-9 ]`, split into tokens, and
+     * only tokens with length >= 3 are considered for synonym lookup.
+     * Values are appended to the FTS5 query token list (multi-word values are
+     * split into tokens), then deduped and sliced to 12.
+     */
+    synonymMap?: Record<string, string[]>;
 }
 interface WikiFact {
     id: string;
@@ -92,15 +102,28 @@ interface FormattedMemoryDump {
         content: string;
     }>;
 }
+interface FormatContextOptions {
+    format?: 'markdown' | 'plain';
+    maxFacts?: number;
+    maxTasks?: number;
+    maxEvents?: number;
+    includeConfidence?: boolean;
+    includeTags?: boolean;
+    factWeights?: {
+        confidence?: number;
+        accessCount?: number;
+        recency?: number;
+    };
+}
 interface EntityStatus {
     ingesting: boolean;
     librarian: boolean;
     heal: boolean;
 }
 declare class WikiBusyError extends Error {
-    readonly operation: 'ingest' | 'librarian' | 'heal';
+    readonly operation: 'ingest' | 'librarian' | 'heal' | 'prune';
     readonly entityId: string;
-    constructor(operation: 'ingest' | 'librarian' | 'heal', entityId: string);
+    constructor(operation: 'ingest' | 'librarian' | 'heal' | 'prune', entityId: string);
 }
 
 declare class WikiMemory {
@@ -154,4 +177,4 @@ declare class WikiMemory {
     }>;
 }
 
-export { type EntityStatus as E, type FormattedMemoryDump as F, type LLMProvider as L, type MemoryDump as M, type WikiOptions as W, WikiMemory as a, type ExtractedFact as b, type ExtractedTask as c, type MemoryBundle as d, WikiBusyError as e, type WikiCheckpoint as f, type WikiConfig as g, type WikiEvent as h, type WikiFact as i, type WikiTask as j };
+export { type EntityStatus as E, type FormattedMemoryDump as F, type LLMProvider as L, type MemoryDump as M, type WikiOptions as W, WikiMemory as a, type ExtractedFact as b, type ExtractedTask as c, type FormatContextOptions as d, type MemoryBundle as e, WikiBusyError as f, type WikiCheckpoint as g, type WikiConfig as h, type WikiEvent as i, type WikiFact as j, type WikiTask as k };

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import * as SQLite from 'expo-sqlite';
-import { M as MemoryDump, F as FormattedMemoryDump, W as WikiOptions, a as WikiMemory } from './WikiMemory-B54Gaa-K.mjs';
-export { E as EntityStatus, b as ExtractedFact, c as ExtractedTask, L as LLMProvider, d as MemoryBundle, e as WikiBusyError, f as WikiCheckpoint, g as WikiConfig, h as WikiEvent, i as WikiFact, j as WikiTask } from './WikiMemory-B54Gaa-K.mjs';
+import { M as MemoryDump, F as FormattedMemoryDump, W as WikiOptions, a as WikiMemory } from './WikiMemory-CjlQ68X0.mjs';
+export { E as EntityStatus, b as ExtractedFact, c as ExtractedTask, d as FormatContextOptions, L as LLMProvider, e as MemoryBundle, f as WikiBusyError, g as WikiCheckpoint, h as WikiConfig, i as WikiEvent, j as WikiFact, k as WikiTask } from './WikiMemory-CjlQ68X0.mjs';
 
 declare function formatMemoryDump(dump: MemoryDump): FormattedMemoryDump;
 

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as SQLite from 'expo-sqlite';
-import { M as MemoryDump, F as FormattedMemoryDump, W as WikiOptions, a as WikiMemory } from './WikiMemory-B54Gaa-K.js';
-export { E as EntityStatus, b as ExtractedFact, c as ExtractedTask, L as LLMProvider, d as MemoryBundle, e as WikiBusyError, f as WikiCheckpoint, g as WikiConfig, h as WikiEvent, i as WikiFact, j as WikiTask } from './WikiMemory-B54Gaa-K.js';
+import { M as MemoryDump, F as FormattedMemoryDump, W as WikiOptions, a as WikiMemory } from './WikiMemory-CjlQ68X0.js';
+export { E as EntityStatus, b as ExtractedFact, c as ExtractedTask, d as FormatContextOptions, L as LLMProvider, e as MemoryBundle, f as WikiBusyError, g as WikiCheckpoint, h as WikiConfig, i as WikiEvent, j as WikiFact, k as WikiTask } from './WikiMemory-CjlQ68X0.js';
 
 declare function formatMemoryDump(dump: MemoryDump): FormattedMemoryDump;
 

package/dist/index.js

@@ -58,7 +58,8 @@ async function setupDatabase(db, prefix) {
       body,
       tags,
       content='${prefix}entries',
-      content_rowid='rowid'
+      content_rowid='rowid',
+      tokenize='porter unicode61'
     );
 
     -- Triggers to keep FTS5 in sync with entries
@@ -373,6 +374,45 @@ var WikiMemory = class {
   }
   async setup() {
     await setupDatabase(this.db, this.prefix);
+    const ftsMeta = await this.db.getFirstAsync(
+      `SELECT sql FROM sqlite_master WHERE type='table' AND name=?`,
+      [`${this.prefix}entries_fts`]
+    );
+    const hasPorterTokenizer = /tokenize\s*=\s*['"]porter\s+unicode61['"]/i.test(ftsMeta?.sql ?? "");
+    if (ftsMeta?.sql && !hasPorterTokenizer) {
+      await this.db.withTransactionAsync(async () => {
+        await this.db.execAsync(`
+          DROP TRIGGER IF EXISTS ${this.prefix}entries_ai;
+          DROP TRIGGER IF EXISTS ${this.prefix}entries_ad;
+          DROP TRIGGER IF EXISTS ${this.prefix}entries_au;
+          DROP TABLE IF EXISTS ${this.prefix}entries_fts;
+          CREATE VIRTUAL TABLE ${this.prefix}entries_fts USING fts5(
+            title,
+            body,
+            tags,
+            content='${this.prefix}entries',
+            content_rowid='rowid',
+            tokenize='porter unicode61'
+          );
+          INSERT INTO ${this.prefix}entries_fts(rowid, title, body, tags)
+            SELECT rowid, title, body, tags FROM ${this.prefix}entries;
+          CREATE TRIGGER ${this.prefix}entries_ai AFTER INSERT ON ${this.prefix}entries BEGIN
+            INSERT INTO ${this.prefix}entries_fts(rowid, title, body, tags)
+            VALUES (new.rowid, new.title, new.body, new.tags);
+          END;
+          CREATE TRIGGER ${this.prefix}entries_ad AFTER DELETE ON ${this.prefix}entries BEGIN
+            INSERT INTO ${this.prefix}entries_fts(${this.prefix}entries_fts, rowid, title, body, tags)
+            VALUES ('delete', old.rowid, old.title, old.body, old.tags);
+          END;
+          CREATE TRIGGER ${this.prefix}entries_au AFTER UPDATE ON ${this.prefix}entries BEGIN
+            INSERT INTO ${this.prefix}entries_fts(${this.prefix}entries_fts, rowid, title, body, tags)
+            VALUES ('delete', old.rowid, old.title, old.body, old.tags);
+            INSERT INTO ${this.prefix}entries_fts(rowid, title, body, tags)
+            VALUES (new.rowid, new.title, new.body, new.tags);
+          END;
+        `);
+      });
+    }
     const rows = await this.db.getAllAsync(`
       SELECT rowid, source_ref FROM ${this.prefix}entries
       WHERE source_ref IS NOT NULL
@@ -397,9 +437,35 @@ var WikiMemory = class {
     });
   }
   formatSearchQuery(query) {
-    const tokens = query.toLowerCase().replace(/[^a-z0-9\s]/g, "").split(/\s+/).filter((t) => t.length >= 3).slice(0, 6);
-    if (tokens.length === 0) return "";
-    return tokens.map((t) => `"${t}"*`).join(" OR ");
+    const normalizeTokens = (value) => value.toLowerCase().replace(/[^a-z0-9\s]/g, "").split(/\s+/).filter((t) => t.length >= 3);
+    const baseTokens = normalizeTokens(query);
+    if (baseTokens.length === 0) return "";
+    const synonymMap = this.options.config?.synonymMap;
+    const expanded = [];
+    const seen = /* @__PURE__ */ new Set();
+    const pushNormalized = (value) => {
+      for (const token of normalizeTokens(value)) {
+        if (expanded.length >= 12) return false;
+        if (seen.has(token)) continue;
+        seen.add(token);
+        expanded.push(token);
+      }
+      return true;
+    };
+    for (const t of baseTokens) {
+      if (!pushNormalized(t)) break;
+      if (synonymMap) {
+        const synonyms = synonymMap[t];
+        if (Array.isArray(synonyms)) {
+          for (const s of synonyms) {
+            if (typeof s === "string") {
+              if (!pushNormalized(s)) break;
+            }
+          }
+        }
+      }
+    }
+    return expanded.map((t) => `"${t}"*`).join(" OR ");
   }
   async read(entityId, query) {
     const ftsQuery = this.formatSearchQuery(query);
@@ -765,7 +831,7 @@ The following document anchors are provided for contradiction detection only. Do
           if (factIdChunk.length === 0) continue;
           const placeholders = factIdChunk.map(() => "?").join(", ");
           const existingFacts = await this.db.getAllAsync(
-            `SELECT id, entity_id FROM ${this.prefix}entries WHERE id IN (${placeholders})`,
+            `SELECT id, entity_id, updated_at FROM ${this.prefix}entries WHERE id IN (${placeholders})`,
             factIdChunk
           );
           for (const existingFact of existingFacts) {
@@ -774,22 +840,27 @@ The following document anchors are provided for contradiction detection only. Do
         }
         for (const fact of bundle.facts) {
           const tagsJson = JSON.stringify(Array.isArray(fact.tags) ? fact.tags : []);
+          const safeUpdatedAt = Number.isFinite(fact.updated_at) ? fact.updated_at : 0;
           const existing = existingFactsById.get(fact.id);
           if (existing) {
             if (existing.entity_id !== entityId) {
               this._warnCrossEntityCollision("entry", fact.id, existing.entity_id, entityId);
               continue;
             }
-            if (merge) continue;
+            if (merge) {
+              if (safeUpdatedAt <= existing.updated_at) continue;
+            }
             await this.db.runAsync(
               `UPDATE ${this.prefix}entries SET entity_id = ?, title = ?, body = ?, tags = ?, confidence = ?, source_type = ?, source_hash = ?, source_ref = ?, created_at = ?, updated_at = ?, last_accessed_at = ?, access_count = ?, deleted_at = ? WHERE id = ?`,
-              [entityId, fact.title, fact.body, tagsJson, fact.confidence, fact.source_type, fact.source_hash, fact.source_ref, fact.created_at, fact.updated_at, fact.last_accessed_at, fact.access_count, fact.deleted_at, fact.id]
+              [entityId, fact.title, fact.body, tagsJson, fact.confidence, fact.source_type, fact.source_hash, fact.source_ref, fact.created_at, safeUpdatedAt, fact.last_accessed_at, fact.access_count, fact.deleted_at, fact.id]
             );
+            existingFactsById.set(fact.id, { id: fact.id, entity_id: entityId, updated_at: safeUpdatedAt });
           } else {
             await this.db.runAsync(
               `INSERT INTO ${this.prefix}entries (id, entity_id, title, body, tags, confidence, source_type, source_hash, source_ref, created_at, updated_at, last_accessed_at, access_count, deleted_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
-              [fact.id, entityId, fact.title, fact.body, tagsJson, fact.confidence, fact.source_type, fact.source_hash, fact.source_ref, fact.created_at, fact.updated_at, fact.last_accessed_at, fact.access_count, fact.deleted_at]
+              [fact.id, entityId, fact.title, fact.body, tagsJson, fact.confidence, fact.source_type, fact.source_hash, fact.source_ref, fact.created_at, safeUpdatedAt, fact.last_accessed_at, fact.access_count, fact.deleted_at]
             );
+            existingFactsById.set(fact.id, { id: fact.id, entity_id: entityId, updated_at: safeUpdatedAt });
           }
         }
         const taskIds = bundle.tasks.map((task) => task.id);
@@ -800,7 +871,7 @@ The following document anchors are provided for contradiction detection only. Do
           if (taskIdChunk.length === 0) continue;
           const placeholders = taskIdChunk.map(() => "?").join(", ");
           const existingTasks = await this.db.getAllAsync(
-            `SELECT id, entity_id FROM ${this.prefix}tasks WHERE id IN (${placeholders})`,
+            `SELECT id, entity_id, updated_at FROM ${this.prefix}tasks WHERE id IN (${placeholders})`,
             taskIdChunk
           );
           for (const existingTask of existingTasks) {
@@ -808,22 +879,27 @@ The following document anchors are provided for contradiction detection only. Do
           }
         }
         for (const task of bundle.tasks) {
+          const safeUpdatedAt = Number.isFinite(task.updated_at) ? task.updated_at : 0;
           const existing = existingTasksById.get(task.id);
           if (existing) {
             if (existing.entity_id !== entityId) {
               this._warnCrossEntityCollision("task", task.id, existing.entity_id, entityId);
               continue;
             }
-            if (merge) continue;
+            if (merge) {
+              if (safeUpdatedAt <= existing.updated_at) continue;
+            }
             await this.db.runAsync(
               `UPDATE ${this.prefix}tasks SET entity_id = ?, description = ?, status = ?, priority = ?, created_at = ?, updated_at = ?, resolved_at = ?, deleted_at = ? WHERE id = ?`,
-              [entityId, task.description, task.status, task.priority, task.created_at, task.updated_at, task.resolved_at, task.deleted_at, task.id]
+              [entityId, task.description, task.status, task.priority, task.created_at, safeUpdatedAt, task.resolved_at, task.deleted_at, task.id]
             );
+            existingTasksById.set(task.id, { id: task.id, entity_id: entityId, updated_at: safeUpdatedAt });
           } else {
             await this.db.runAsync(
               `INSERT INTO ${this.prefix}tasks (id, entity_id, description, status, priority, created_at, updated_at, resolved_at, deleted_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`,
-              [task.id, entityId, task.description, task.status, task.priority, task.created_at, task.updated_at, task.resolved_at, task.deleted_at]
+              [task.id, entityId, task.description, task.status, task.priority, task.created_at, safeUpdatedAt, task.resolved_at, task.deleted_at]
             );
+            existingTasksById.set(task.id, { id: task.id, entity_id: entityId, updated_at: safeUpdatedAt });
           }
         }
         for (const event of bundle.events) {

package/dist/index.mjs

@@ -29,7 +29,8 @@ async function setupDatabase(db, prefix) {
       body,
       tags,
       content='${prefix}entries',
-      content_rowid='rowid'
+      content_rowid='rowid',
+      tokenize='porter unicode61'
     );
 
     -- Triggers to keep FTS5 in sync with entries
@@ -344,6 +345,45 @@ var WikiMemory = class {
   }
   async setup() {
     await setupDatabase(this.db, this.prefix);
+    const ftsMeta = await this.db.getFirstAsync(
+      `SELECT sql FROM sqlite_master WHERE type='table' AND name=?`,
+      [`${this.prefix}entries_fts`]
+    );
+    const hasPorterTokenizer = /tokenize\s*=\s*['"]porter\s+unicode61['"]/i.test(ftsMeta?.sql ?? "");
+    if (ftsMeta?.sql && !hasPorterTokenizer) {
+      await this.db.withTransactionAsync(async () => {
+        await this.db.execAsync(`
+          DROP TRIGGER IF EXISTS ${this.prefix}entries_ai;
+          DROP TRIGGER IF EXISTS ${this.prefix}entries_ad;
+          DROP TRIGGER IF EXISTS ${this.prefix}entries_au;
+          DROP TABLE IF EXISTS ${this.prefix}entries_fts;
+          CREATE VIRTUAL TABLE ${this.prefix}entries_fts USING fts5(
+            title,
+            body,
+            tags,
+            content='${this.prefix}entries',
+            content_rowid='rowid',
+            tokenize='porter unicode61'
+          );
+          INSERT INTO ${this.prefix}entries_fts(rowid, title, body, tags)
+            SELECT rowid, title, body, tags FROM ${this.prefix}entries;
+          CREATE TRIGGER ${this.prefix}entries_ai AFTER INSERT ON ${this.prefix}entries BEGIN
+            INSERT INTO ${this.prefix}entries_fts(rowid, title, body, tags)
+            VALUES (new.rowid, new.title, new.body, new.tags);
+          END;
+          CREATE TRIGGER ${this.prefix}entries_ad AFTER DELETE ON ${this.prefix}entries BEGIN
+            INSERT INTO ${this.prefix}entries_fts(${this.prefix}entries_fts, rowid, title, body, tags)
+            VALUES ('delete', old.rowid, old.title, old.body, old.tags);
+          END;
+          CREATE TRIGGER ${this.prefix}entries_au AFTER UPDATE ON ${this.prefix}entries BEGIN
+            INSERT INTO ${this.prefix}entries_fts(${this.prefix}entries_fts, rowid, title, body, tags)
+            VALUES ('delete', old.rowid, old.title, old.body, old.tags);
+            INSERT INTO ${this.prefix}entries_fts(rowid, title, body, tags)
+            VALUES (new.rowid, new.title, new.body, new.tags);
+          END;
+        `);
+      });
+    }
     const rows = await this.db.getAllAsync(`
       SELECT rowid, source_ref FROM ${this.prefix}entries
       WHERE source_ref IS NOT NULL
@@ -368,9 +408,35 @@ var WikiMemory = class {
     });
   }
   formatSearchQuery(query) {
-    const tokens = query.toLowerCase().replace(/[^a-z0-9\s]/g, "").split(/\s+/).filter((t) => t.length >= 3).slice(0, 6);
-    if (tokens.length === 0) return "";
-    return tokens.map((t) => `"${t}"*`).join(" OR ");
+    const normalizeTokens = (value) => value.toLowerCase().replace(/[^a-z0-9\s]/g, "").split(/\s+/).filter((t) => t.length >= 3);
+    const baseTokens = normalizeTokens(query);
+    if (baseTokens.length === 0) return "";
+    const synonymMap = this.options.config?.synonymMap;
+    const expanded = [];
+    const seen = /* @__PURE__ */ new Set();
+    const pushNormalized = (value) => {
+      for (const token of normalizeTokens(value)) {
+        if (expanded.length >= 12) return false;
+        if (seen.has(token)) continue;
+        seen.add(token);
+        expanded.push(token);
+      }
+      return true;
+    };
+    for (const t of baseTokens) {
+      if (!pushNormalized(t)) break;
+      if (synonymMap) {
+        const synonyms = synonymMap[t];
+        if (Array.isArray(synonyms)) {
+          for (const s of synonyms) {
+            if (typeof s === "string") {
+              if (!pushNormalized(s)) break;
+            }
+          }
+        }
+      }
+    }
+    return expanded.map((t) => `"${t}"*`).join(" OR ");
   }
   async read(entityId, query) {
     const ftsQuery = this.formatSearchQuery(query);
@@ -736,7 +802,7 @@ The following document anchors are provided for contradiction detection only. Do
           if (factIdChunk.length === 0) continue;
           const placeholders = factIdChunk.map(() => "?").join(", ");
           const existingFacts = await this.db.getAllAsync(
-            `SELECT id, entity_id FROM ${this.prefix}entries WHERE id IN (${placeholders})`,
+            `SELECT id, entity_id, updated_at FROM ${this.prefix}entries WHERE id IN (${placeholders})`,
             factIdChunk
           );
           for (const existingFact of existingFacts) {
@@ -745,22 +811,27 @@ The following document anchors are provided for contradiction detection only. Do
         }
         for (const fact of bundle.facts) {
           const tagsJson = JSON.stringify(Array.isArray(fact.tags) ? fact.tags : []);
+          const safeUpdatedAt = Number.isFinite(fact.updated_at) ? fact.updated_at : 0;
           const existing = existingFactsById.get(fact.id);
           if (existing) {
             if (existing.entity_id !== entityId) {
               this._warnCrossEntityCollision("entry", fact.id, existing.entity_id, entityId);
               continue;
             }
-            if (merge) continue;
+            if (merge) {
+              if (safeUpdatedAt <= existing.updated_at) continue;
+            }
             await this.db.runAsync(
               `UPDATE ${this.prefix}entries SET entity_id = ?, title = ?, body = ?, tags = ?, confidence = ?, source_type = ?, source_hash = ?, source_ref = ?, created_at = ?, updated_at = ?, last_accessed_at = ?, access_count = ?, deleted_at = ? WHERE id = ?`,
-              [entityId, fact.title, fact.body, tagsJson, fact.confidence, fact.source_type, fact.source_hash, fact.source_ref, fact.created_at, fact.updated_at, fact.last_accessed_at, fact.access_count, fact.deleted_at, fact.id]
+              [entityId, fact.title, fact.body, tagsJson, fact.confidence, fact.source_type, fact.source_hash, fact.source_ref, fact.created_at, safeUpdatedAt, fact.last_accessed_at, fact.access_count, fact.deleted_at, fact.id]
             );
+            existingFactsById.set(fact.id, { id: fact.id, entity_id: entityId, updated_at: safeUpdatedAt });
           } else {
             await this.db.runAsync(
               `INSERT INTO ${this.prefix}entries (id, entity_id, title, body, tags, confidence, source_type, source_hash, source_ref, created_at, updated_at, last_accessed_at, access_count, deleted_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
-              [fact.id, entityId, fact.title, fact.body, tagsJson, fact.confidence, fact.source_type, fact.source_hash, fact.source_ref, fact.created_at, fact.updated_at, fact.last_accessed_at, fact.access_count, fact.deleted_at]
+              [fact.id, entityId, fact.title, fact.body, tagsJson, fact.confidence, fact.source_type, fact.source_hash, fact.source_ref, fact.created_at, safeUpdatedAt, fact.last_accessed_at, fact.access_count, fact.deleted_at]
             );
+            existingFactsById.set(fact.id, { id: fact.id, entity_id: entityId, updated_at: safeUpdatedAt });
           }
         }
         const taskIds = bundle.tasks.map((task) => task.id);
@@ -771,7 +842,7 @@ The following document anchors are provided for contradiction detection only. Do
           if (taskIdChunk.length === 0) continue;
           const placeholders = taskIdChunk.map(() => "?").join(", ");
           const existingTasks = await this.db.getAllAsync(
-            `SELECT id, entity_id FROM ${this.prefix}tasks WHERE id IN (${placeholders})`,
+            `SELECT id, entity_id, updated_at FROM ${this.prefix}tasks WHERE id IN (${placeholders})`,
             taskIdChunk
           );
           for (const existingTask of existingTasks) {
@@ -779,22 +850,27 @@ The following document anchors are provided for contradiction detection only. Do
           }
         }
         for (const task of bundle.tasks) {
+          const safeUpdatedAt = Number.isFinite(task.updated_at) ? task.updated_at : 0;
           const existing = existingTasksById.get(task.id);
           if (existing) {
             if (existing.entity_id !== entityId) {
               this._warnCrossEntityCollision("task", task.id, existing.entity_id, entityId);
               continue;
             }
-            if (merge) continue;
+            if (merge) {
+              if (safeUpdatedAt <= existing.updated_at) continue;
+            }
             await this.db.runAsync(
               `UPDATE ${this.prefix}tasks SET entity_id = ?, description = ?, status = ?, priority = ?, created_at = ?, updated_at = ?, resolved_at = ?, deleted_at = ? WHERE id = ?`,
-              [entityId, task.description, task.status, task.priority, task.created_at, task.updated_at, task.resolved_at, task.deleted_at, task.id]
+              [entityId, task.description, task.status, task.priority, task.created_at, safeUpdatedAt, task.resolved_at, task.deleted_at, task.id]
             );
+            existingTasksById.set(task.id, { id: task.id, entity_id: entityId, updated_at: safeUpdatedAt });
           } else {
             await this.db.runAsync(
               `INSERT INTO ${this.prefix}tasks (id, entity_id, description, status, priority, created_at, updated_at, resolved_at, deleted_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`,
-              [task.id, entityId, task.description, task.status, task.priority, task.created_at, task.updated_at, task.resolved_at, task.deleted_at]
+              [task.id, entityId, task.description, task.status, task.priority, task.created_at, safeUpdatedAt, task.resolved_at, task.deleted_at]
             );
+            existingTasksById.set(task.id, { id: task.id, entity_id: entityId, updated_at: safeUpdatedAt });
           }
         }
         for (const event of bundle.events) {

package/dist/react/index.d.mts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { a as WikiMemory, d as MemoryBundle, h as WikiEvent, M as MemoryDump } from '../WikiMemory-B54Gaa-K.mjs';
+import { a as WikiMemory, e as MemoryBundle, i as WikiEvent, M as MemoryDump } from '../WikiMemory-CjlQ68X0.mjs';
 import 'expo-sqlite';
 
 declare function WikiProvider({ wiki, children }: {

package/dist/react/index.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-import { a as WikiMemory, d as MemoryBundle, h as WikiEvent, M as MemoryDump } from '../WikiMemory-B54Gaa-K.js';
+import { a as WikiMemory, e as MemoryBundle, i as WikiEvent, M as MemoryDump } from '../WikiMemory-CjlQ68X0.js';
 import 'expo-sqlite';
 
 declare function WikiProvider({ wiki, children }: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@equationalapplications/expo-llm-wiki",
-  "version": "2.0.2",
+  "version": "2.2.0",
   "description": "A standalone, general-purpose React Native/Expo package for LLM Wiki Memory.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -20,6 +20,7 @@
   "scripts": {
     "build": "tsup src/index.ts src/react/index.ts --format cjs,esm --dts --external react",
     "dev": "tsup src/index.ts src/react/index.ts --format cjs,esm --dts --external react --watch",
+    "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "test:watch": "vitest"
   },
@@ -51,12 +52,17 @@
       "optional": true
     }
   },
+  "engines": {
+    "node": ">=20"
+  },
   "devDependencies": {
     "@semantic-release/changelog": "^6.0.0",
     "@semantic-release/git": "^10.0.0",
+    "@types/better-sqlite3": "^7.6.13",
     "@types/node": "^20.0.0",
     "@types/react": "^19.0.0",
     "@vitest/coverage-v8": "^4.1.5",
+    "better-sqlite3": "^12.9.0",
     "expo-sqlite": "^55.0.15",
     "react": "19.2.0",
     "semantic-release": "^24.0.0",