@equationalapplications/core-llm-wiki 4.18.1 → 4.20.0

package/dist/index.mjs

@@ -1,5 +1,5 @@
-import { __privateAdd, EmbeddingService, SearchService, JobManager, PromptService, IngestionService, MaintenanceService, ImportExportService, RetrievalService, WriteService, __privateGet, __privateSet, normalizeSourceRef, normalizeSourceHash, generateId, validateManifest, emptyManifest, mergeOntologyUpdates, resolveNodeType, validateInlineEdges, resolveEdgeDefinition, normalizeTitleKey } from './chunk-V7QNRQFK.mjs';
-export { HOOK_TIMEOUT_MARKER, PromptService, PrunePartialFailureError, WikiBusyError, configureRandomSource, parseEmbedding } from './chunk-V7QNRQFK.mjs';
+import { __privateAdd, MetadataRepository, EmbeddingService, SearchService, JobManager, PromptService, IngestionService, MaintenanceService, ImportExportService, RetrievalService, WriteService, __privateGet, __privateSet, normalizeSourceRef, normalizeSourceHash, entitySummaryMetaKey, generateId, BaseRepository, emptyManifest, resolveNodeType, validateInlineEdges, resolveEdgeDefinition, normalizeTitleKey, WikiTransactionError, extractSqliteCode } from './chunk-HKB5FEJG.mjs';
+export { HOOK_TIMEOUT_MARKER, PromptService, PrunePartialFailureError, WikiBusyError, WikiTransactionError, configureRandomSource, parseEmbedding } from './chunk-HKB5FEJG.mjs';
 import { appendRelatedSection, buildConceptDocument, buildLogMd, buildEntityIndexMd, buildRootIndexMd, isAllowedOkfPath, parseRootIndexMd, parseEntityIndexMd, parseConcept, splitRelatedSection, extractMarkdownLinks, parseLogMd, parseEventIdComment, appendEventIdComment } from '@equationalapplications/core-okf';
 
 // src/db/schema.ts
@@ -104,6 +104,50 @@ async function setupDatabase(db, prefix) {
   `);
 }
 
+// src/db/serializedAdapter.ts
+function isDriverError(err) {
+  return extractSqliteCode(err) !== void 0;
+}
+function withOverrides(target, overrides) {
+  return new Proxy(target, {
+    get(obj, prop, receiver) {
+      if (prop in overrides) return Reflect.get(overrides, prop, receiver);
+      const value = Reflect.get(obj, prop, obj);
+      return typeof value === "function" ? value.bind(obj) : value;
+    }
+  });
+}
+function guardReentrancy(tx) {
+  return withOverrides(tx, {
+    withTransactionAsync() {
+      throw new Error(
+        "Nested withTransactionAsync is not supported: you are already inside a transaction. Pass the current `tx` down instead of opening a new transaction."
+      );
+    }
+  });
+}
+var DEADLOCK_WARN_MS = 1e4;
+function withSerializedTransactions(db) {
+  let queue = Promise.resolve();
+  return withOverrides(db, {
+    withTransactionAsync(fn) {
+      const warn = setTimeout(() => {
+        console.warn(
+          "[core-llm-wiki] Transaction queued >10s \u2014 possible deadlock. Inside a transaction callback, use the `tx` parameter, never the outer database handle."
+        );
+      }, DEADLOCK_WARN_MS);
+      const run = queue.catch(() => void 0).then(() => {
+        clearTimeout(warn);
+        return db.withTransactionAsync((tx) => fn(guardReentrancy(tx ?? db)));
+      }).catch((e) => {
+        throw isDriverError(e) ? new WikiTransactionError("Transaction failed", { cause: e }) : e;
+      });
+      queue = run;
+      return run;
+    }
+  });
+}
+
 // src/db/migrations.ts
 var MIGRATIONS = [
   {
@@ -215,21 +259,6 @@ for (let i = 1; i < MIGRATIONS.length; i++) {
 }
 var CURRENT_SCHEMA_VERSION = MIGRATIONS.length > 0 ? MIGRATIONS[MIGRATIONS.length - 1].version : 0;
 
-// src/repositories/BaseRepository.ts
-var BaseRepository = class {
-  constructor(db, prefix) {
-    this.db = db;
-    this.prefix = prefix;
-  }
-  /**
-   * Return the DB executor for a given transaction handle.
-   * If tx is provided, use it; otherwise fall back to this.db.
-   */
-  getExecutor(tx) {
-    return tx ?? this.db;
-  }
-};
-
 // src/repositories/EntryRepository.ts
 function mapRowToFact(row) {
   const tags = (() => {
@@ -1520,144 +1549,6 @@ function mapRowToEdge(row) {
   };
 }
 
-// src/repositories/MetadataRepository.ts
-var MetadataRepository = class extends BaseRepository {
-  // CHECKPOINTS TABLE METHODS
-  async getCheckpoint(entityId, tx) {
-    const executor = this.getExecutor(tx);
-    const row = await executor.getFirstAsync(
-      `SELECT memory_checkpoint, heal_checkpoint FROM ${this.prefix}checkpoints WHERE entity_id = ?`,
-      [entityId]
-    );
-    if (!row) return {};
-    return {
-      memory: row.memory_checkpoint ?? void 0,
-      heal: row.heal_checkpoint ?? void 0
-    };
-  }
-  async updateCheckpoint(entityId, updates, tx) {
-    const fields = [];
-    const values = [];
-    if (updates.memory !== void 0) {
-      fields.push("memory_checkpoint = ?");
-      values.push(updates.memory);
-    }
-    if (updates.heal !== void 0) {
-      fields.push("heal_checkpoint = ?");
-      values.push(updates.heal);
-    }
-    if (fields.length === 0) return;
-    const executor = this.getExecutor(tx);
-    await executor.runAsync(
-      `INSERT INTO ${this.prefix}checkpoints (entity_id, memory_checkpoint, heal_checkpoint)
-       VALUES (?, ?, ?)
-       ON CONFLICT(entity_id) DO UPDATE SET ${fields.join(", ")}`,
-      [entityId, updates.memory ?? 0, updates.heal ?? 0, ...values]
-    );
-  }
-  async deleteCheckpoint(entityId, tx) {
-    const executor = this.getExecutor(tx);
-    await executor.runAsync(
-      `DELETE FROM ${this.prefix}checkpoints WHERE entity_id = ?`,
-      [entityId]
-    );
-  }
-  // META TABLE METHODS
-  async getMeta(key, tx) {
-    const executor = this.getExecutor(tx);
-    const row = await executor.getFirstAsync(
-      `SELECT value FROM ${this.prefix}meta WHERE key = ?`,
-      [key]
-    );
-    return row ? row.value : null;
-  }
-  async setMeta(key, value, tx) {
-    const executor = this.getExecutor(tx);
-    await executor.runAsync(
-      `INSERT INTO ${this.prefix}meta (key, value) VALUES (?, ?)
-       ON CONFLICT(key) DO UPDATE SET value = excluded.value`,
-      [key, value]
-    );
-  }
-  async clearDimensionMismatch(tx) {
-    const executor = this.getExecutor(tx);
-    await executor.runAsync(
-      `DELETE FROM ${this.prefix}meta WHERE key = 'embedding_dimension_mismatch'`
-    );
-  }
-  async tableExists(tableName, tx) {
-    const executor = this.getExecutor(tx);
-    const row = await executor.getFirstAsync(
-      `SELECT name FROM sqlite_master WHERE type='table' AND name=?`,
-      [tableName]
-    );
-    return row != null;
-  }
-  async getTableDdl(tableName, tx) {
-    const executor = this.getExecutor(tx);
-    const row = await executor.getFirstAsync(
-      `SELECT sql FROM sqlite_master WHERE type='table' AND name=?`,
-      [tableName]
-    );
-    return row?.sql ?? null;
-  }
-  async vacuum() {
-    await this.db.execAsync(`PRAGMA wal_checkpoint(TRUNCATE)`);
-    await this.db.execAsync(`VACUUM`);
-  }
-  async getDistinctEntityIds(tx) {
-    const executor = this.getExecutor(tx);
-    const rows = await executor.getAllAsync(
-      `SELECT DISTINCT entity_id FROM (
-         SELECT entity_id FROM ${this.prefix}entries WHERE deleted_at IS NULL
-         UNION
-         SELECT entity_id FROM ${this.prefix}tasks WHERE deleted_at IS NULL
-         UNION
-         SELECT entity_id FROM ${this.prefix}events
-       ) ORDER BY entity_id`
-    );
-    return rows.map((r) => r.entity_id);
-  }
-  async getManifest(entityId, tx) {
-    const executor = this.getExecutor(tx);
-    const row = await executor.getFirstAsync(`SELECT mode, manifest_json FROM ${this.prefix}entity_manifests WHERE entity_id = ?`, [entityId]);
-    if (!row) return null;
-    if (row.mode !== "off" && row.mode !== "strict" && row.mode !== "emergent") {
-      throw new Error(`Invalid ontology mode for entity ${entityId}: ${JSON.stringify(row.mode)}`);
-    }
-    let manifest;
-    try {
-      manifest = JSON.parse(row.manifest_json);
-    } catch (error) {
-      throw new Error(`Invalid manifest_json for entity ${entityId}: ${error.message}`);
-    }
-    validateManifest(manifest);
-    return {
-      mode: row.mode,
-      manifest
-    };
-  }
-  async setManifest(entityId, data, tx) {
-    validateManifest(data.manifest);
-    const executor = this.getExecutor(tx);
-    await executor.runAsync(
-      `INSERT INTO ${this.prefix}entity_manifests (entity_id, mode, manifest_json, updated_at)
-       VALUES (?, ?, ?, ?)
-       ON CONFLICT(entity_id) DO UPDATE SET mode = excluded.mode, manifest_json = excluded.manifest_json, updated_at = excluded.updated_at`,
-      [entityId, data.mode, JSON.stringify(data.manifest), Date.now()]
-    );
-  }
-  async mergeManifestUpdates(entityId, updates, tx) {
-    const current = await this.getManifest(entityId, tx) ?? {
-      mode: "emergent",
-      manifest: emptyManifest()
-    };
-    const merged = mergeOntologyUpdates(current.manifest, updates);
-    await this.setManifest(entityId, { mode: current.mode, manifest: merged }, tx);
-    return merged;
-  }
-};
-
 // src/prompts/ontology.ts
 var FACT_ONTOLOGY_FIELDS = `
 Each fact may optionally include:
@@ -1804,7 +1695,7 @@ var WikiMemory = class {
   constructor(db, options) {
     /** Emits `__testAccess` console warning at most once per instance when NODE_ENV ≠ "test". */
     __privateAdd(this, _testAccessNonTestEnvWarned, false);
-    this.db = db;
+    this.db = withSerializedTransactions(db);
     this.options = options;
     this.prefix = options.config?.tablePrefix ?? "llm_wiki_";
     if (!TABLE_PREFIX_PATTERN.test(this.prefix)) {
@@ -1812,12 +1703,12 @@ var WikiMemory = class {
         `Invalid tablePrefix: ${JSON.stringify(this.prefix)}. Must match ${TABLE_PREFIX_PATTERN} (letter, then alphanumeric/underscore, ending in "_", max 32 chars total).`
       );
     }
-    this.outboxRepo = new OutboxRepository(db, this.prefix, !!options.config?.enableOutbox);
-    this.entryRepo = new EntryRepository(db, this.prefix, this.outboxRepo);
-    this.taskRepo = new TaskRepository(db, this.prefix, this.outboxRepo);
-    this.eventRepo = new EventRepository(db, this.prefix);
-    this.edgeRepo = new EdgeRepository(db, this.prefix);
-    this.metadataRepo = new MetadataRepository(db, this.prefix);
+    this.outboxRepo = new OutboxRepository(this.db, this.prefix, !!options.config?.enableOutbox);
+    this.entryRepo = new EntryRepository(this.db, this.prefix, this.outboxRepo);
+    this.taskRepo = new TaskRepository(this.db, this.prefix, this.outboxRepo);
+    this.eventRepo = new EventRepository(this.db, this.prefix);
+    this.edgeRepo = new EdgeRepository(this.db, this.prefix);
+    this.metadataRepo = new MetadataRepository(this.db, this.prefix);
     this.ontologyService = new OntologyService(
       this.metadataRepo,
       this.edgeRepo,
@@ -2016,6 +1907,10 @@ var WikiMemory = class {
   async exportDump(entityIds) {
     return this.importExportService.exportDump(entityIds);
   }
+  /** Entity summary prose persisted from an OKF profile ≥ 1 import; null when none stored. */
+  async getEntitySummary(entityId) {
+    return this.metadataRepo.getMeta(entitySummaryMetaKey(entityId));
+  }
   async importDump(dump, opts) {
     return this.importExportService.importDump(dump, opts);
   }