@equationalapplications/core-llm-wiki 4.18.0 → 4.19.0

package/README.md

@@ -590,6 +590,14 @@ A `WikiEdge` represents a directed link between two concepts (`source_id`, `targ
 
 See [`docs/okf-profile.md`](https://github.com/equationalapplications/expo-llm-wiki/blob/main/docs/okf-profile.md) for the full normative spec and [`packages/okf/fixtures/`](https://github.com/equationalapplications/expo-llm-wiki/tree/main/packages/okf/fixtures) for conformance bundles.
 
+`importDump` persists an imported entity summary (profile ≥ 1 bundles) and
+`exportDump` re-emits it, so the profile §4 round-trip holds across storage.
+Read it directly with `wiki.getEntitySummary(entityId)`. The value lives in the
+`{prefix}meta` table under `entity_summary:{entity_id}` and is removed by
+`forget(entityId, { clearAll: true })`. See the
+[design spec](../../docs/superpowers/specs/2026-07-05-okf-summary-persistence-design.md)
+for import/merge semantics and wipe-path cleanup.
+
 ### The `okf_type` Field
 
 Facts and tasks include a nullable `okf_type` column. This preserves the literal OKF `type` string from an imported bundle frontmatter, independent of whether the item was routed to the `entries` or `tasks` table. When `formatOkfBundle` runs, it restores this specific string, falling back to `'fact'` or `'task'` if the field is null (ensuring non-imported rows export cleanly).

package/dist/{chunk-V7QNRQFK.mjs → chunk-3GMXRLKU.mjs}

@@ -1156,6 +1156,169 @@ var IngestionService = class {
   }
 };
 
+// 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/MetadataRepository.ts
+function entitySummaryMetaKey(entityId) {
+  return `entity_summary:${entityId}`;
+}
+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 deleteMeta(key, tx) {
+    const executor = this.getExecutor(tx);
+    await executor.runAsync(
+      `DELETE FROM ${this.prefix}meta WHERE key = ?`,
+      [key]
+    );
+  }
+  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/services/MaintenanceService.ts
 var FUZZY_THRESHOLD = 0.5;
 var MIN_TOKENS_TO_QUALIFY = 3;
@@ -1331,6 +1494,7 @@ var MaintenanceService = class {
           deletedEntries = await this.entryRepo.bulkSoftDeleteByEntityId(entityId, tx);
           deletedTasks = await this.taskRepo.bulkSoftDeleteByEntityId(entityId, tx);
           await this.metadataRepo.updateCheckpoint(entityId, { memory: 0, heal: 0 }, tx);
+          await this.metadataRepo.deleteMeta(entitySummaryMetaKey(entityId), tx);
         } else {
           const hasIdSelectors = params.entryId !== void 0 || params.taskId !== void 0;
           const hasSourceSelectors = params.sourceRef !== void 0 || params.sourceHash !== void 0;
@@ -1679,11 +1843,12 @@ var ImportExportService = class {
     }
   }
   async getFullBundle(entityId, opts) {
-    const [factsRaw, tasks, events, edges] = await Promise.all([
+    const [factsRaw, tasks, events, edges, summaryValue] = await Promise.all([
       opts?.includeBlobs ? this.entryRepo.findAllByEntityIdWithBlobs(entityId) : this.entryRepo.findAllByEntityId(entityId),
       this.taskRepo.findAllByEntityId(entityId),
       this.eventRepo.getByEntityId(entityId, opts?.maxEvents),
-      this.edgeRepo.getByEntityId(entityId)
+      this.edgeRepo.getByEntityId(entityId),
+      this.metadataRepo.getMeta(entitySummaryMetaKey(entityId))
     ]);
     const facts = factsRaw.map((f) => {
       const {
@@ -1702,7 +1867,13 @@ var ImportExportService = class {
         tags: typeof factBase.tags === "string" ? JSON.parse(factBase.tags) : factBase.tags
       };
     });
-    return { facts, tasks, events, edges };
+    return {
+      facts,
+      tasks,
+      events,
+      edges,
+      ...summaryValue != null ? { summary: summaryValue } : {}
+    };
   }
   /** Single-entity import transaction + post-processing; package-internal hook for tests. */
   async doImportEntity(entityId, bundle, merge) {
@@ -1727,6 +1898,11 @@ var ImportExportService = class {
         await this.edgeRepo.bulkDeleteByEntityId(entityId, tx);
         await this.metadataRepo.deleteCheckpoint(entityId, tx);
       }
+      if (bundle.summary !== void 0) {
+        await this.metadataRepo.setMeta(entitySummaryMetaKey(entityId), bundle.summary, tx);
+      } else if (!merge) {
+        await this.metadataRepo.deleteMeta(entitySummaryMetaKey(entityId), tx);
+      }
       const factIds = bundle.facts.map((fact) => fact.id);
       const existingFactsById = /* @__PURE__ */ new Map();
       const existingFacts = await this.entryRepo.findExistingMetadataByIds(
@@ -2815,6 +2991,6 @@ var WriteService = class {
   }
 };
 
-export { EmbeddingService, HOOK_TIMEOUT_MARKER, ImportExportService, IngestionService, JobManager, MaintenanceService, PromptService, PrunePartialFailureError, RetrievalService, SearchService, WikiBusyError, WriteService, __privateAdd, __privateGet, __privateSet, configureRandomSource, emptyManifest, generateId, mergeOntologyUpdates, normalizeSourceHash, normalizeSourceRef, normalizeTitleKey, parseEmbedding, resolveEdgeDefinition, resolveNodeType, validateInlineEdges, validateManifest };
-//# sourceMappingURL=chunk-V7QNRQFK.mjs.map
-//# sourceMappingURL=chunk-V7QNRQFK.mjs.map
+export { BaseRepository, EmbeddingService, HOOK_TIMEOUT_MARKER, ImportExportService, IngestionService, JobManager, MaintenanceService, MetadataRepository, PromptService, PrunePartialFailureError, RetrievalService, SearchService, WikiBusyError, WriteService, __privateAdd, __privateGet, __privateSet, configureRandomSource, emptyManifest, entitySummaryMetaKey, generateId, normalizeSourceHash, normalizeSourceRef, normalizeTitleKey, parseEmbedding, resolveEdgeDefinition, resolveNodeType, validateInlineEdges };
+//# sourceMappingURL=chunk-3GMXRLKU.mjs.map
+//# sourceMappingURL=chunk-3GMXRLKU.mjs.map