@equationalapplications/core-llm-wiki 4.14.0 → 4.15.0

package/dist/index.js

@@ -34,7 +34,8 @@ async function setupDatabase(db, prefix) {
       access_count INTEGER NOT NULL DEFAULT 0,
       deleted_at INTEGER,
       embedding TEXT,
-      embedding_blob BLOB
+      embedding_blob BLOB,
+      okf_type TEXT
     );
 
     CREATE INDEX IF NOT EXISTS ${prefix}entries_entity_idx ON ${prefix}entries(entity_id);
@@ -51,11 +52,24 @@ async function setupDatabase(db, prefix) {
       created_at INTEGER NOT NULL,
       updated_at INTEGER NOT NULL,
       resolved_at INTEGER,
-      deleted_at INTEGER
+      deleted_at INTEGER,
+      okf_type TEXT
     );
 
     CREATE INDEX IF NOT EXISTS ${prefix}tasks_entity_idx ON ${prefix}tasks(entity_id, status);
 
+    CREATE TABLE IF NOT EXISTS ${prefix}edges (
+      id TEXT PRIMARY KEY,
+      entity_id TEXT NOT NULL,
+      source_id TEXT NOT NULL,
+      target_id TEXT NOT NULL,
+      edge_type TEXT NOT NULL,
+      created_at INTEGER NOT NULL,
+      UNIQUE(entity_id, source_id, target_id, edge_type)
+    );
+
+    CREATE INDEX IF NOT EXISTS ${prefix}edges_entity_idx ON ${prefix}edges(entity_id);
+
     CREATE TABLE IF NOT EXISTS ${prefix}events (
       id TEXT PRIMARY KEY,
       entity_id TEXT NOT NULL,
@@ -156,6 +170,32 @@ var MIGRATIONS = [
           ON ${prefix}outbox (entity_id, created_at);
       `);
     }
+  },
+  {
+    version: 5,
+    description: "Add okf_type to entries/tasks for OKF type fidelity; create edges table for OKF graph import",
+    run: async (db, prefix) => {
+      for (const table of ["entries", "tasks"]) {
+        const cols = await db.getAllAsync(
+          `PRAGMA table_info(${prefix}${table})`
+        );
+        if (!cols.some((c) => c.name === "okf_type")) {
+          await db.execAsync(`ALTER TABLE ${prefix}${table} ADD COLUMN okf_type TEXT`);
+        }
+      }
+      await db.execAsync(`
+        CREATE TABLE IF NOT EXISTS ${prefix}edges (
+          id TEXT PRIMARY KEY,
+          entity_id TEXT NOT NULL,
+          source_id TEXT NOT NULL,
+          target_id TEXT NOT NULL,
+          edge_type TEXT NOT NULL,
+          created_at INTEGER NOT NULL,
+          UNIQUE(entity_id, source_id, target_id, edge_type)
+        );
+        CREATE INDEX IF NOT EXISTS ${prefix}edges_entity_idx ON ${prefix}edges (entity_id);
+      `);
+    }
   }
 ];
 for (let i = 1; i < MIGRATIONS.length; i++) {
@@ -207,7 +247,8 @@ function mapRowToFact(row) {
     updated_at: Number(row.updated_at),
     last_accessed_at: row.last_accessed_at === null || row.last_accessed_at === void 0 ? null : Number(row.last_accessed_at),
     deleted_at: row.deleted_at != null ? Number(row.deleted_at) : null,
-    access_count: Number(row.access_count ?? 0)
+    access_count: Number(row.access_count ?? 0),
+    okf_type: row.okf_type ?? null
   };
 }
 function normalizeEmbeddingBlobValue(blob) {
@@ -380,8 +421,8 @@ var EntryRepository = class extends BaseRepository {
       `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, embedding_blob, embedding
-      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+        deleted_at, embedding_blob, embedding, okf_type
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
       ON CONFLICT(id) DO UPDATE SET
         entity_id = excluded.entity_id,
         title = excluded.title,
@@ -397,7 +438,8 @@ var EntryRepository = class extends BaseRepository {
         access_count = excluded.access_count,
         deleted_at = excluded.deleted_at,
         embedding_blob = excluded.embedding_blob,
-        embedding = NULL`,
+        embedding = NULL,
+        okf_type = excluded.okf_type`,
       [
         fact.id,
         fact.entity_id,
@@ -414,7 +456,8 @@ var EntryRepository = class extends BaseRepository {
         fact.access_count,
         fact.deleted_at ?? null,
         embeddingBlob ?? null,
-        null
+        null,
+        fact.okf_type ?? null
       ]
     );
     return result;
@@ -926,7 +969,9 @@ function generateId(prefix = "") {
     crypto.getRandomValues(bytes);
     return prefix + Array.from(bytes).map((b) => b.toString(16).padStart(2, "0")).join("").substring(0, 24);
   }
-  return prefix + Math.random().toString(36).substring(2, 15) + Math.random().toString(36).substring(2, 15);
+  throw new Error(
+    "generateId: no cryptographically secure random source available (crypto.randomUUID and crypto.getRandomValues are both missing)."
+  );
 }
 
 // src/repositories/OutboxRepository.ts
@@ -992,7 +1037,8 @@ function mapRowToTask(row) {
     created_at: Number(row.created_at),
     updated_at: Number(row.updated_at),
     resolved_at: row.resolved_at != null ? Number(row.resolved_at) : null,
-    deleted_at: row.deleted_at != null ? Number(row.deleted_at) : null
+    deleted_at: row.deleted_at != null ? Number(row.deleted_at) : null,
+    okf_type: row.okf_type ?? null
   };
 }
 var TaskRepository = class extends BaseRepository {
@@ -1094,8 +1140,8 @@ var TaskRepository = class extends BaseRepository {
     await executor.runAsync(
       `INSERT INTO ${this.prefix}tasks (
         id, entity_id, description, status, priority,
-        created_at, updated_at, resolved_at, deleted_at
-      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+        created_at, updated_at, resolved_at, deleted_at, okf_type
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
       ON CONFLICT(id) DO UPDATE SET
         entity_id = excluded.entity_id,
         description = excluded.description,
@@ -1103,7 +1149,8 @@ var TaskRepository = class extends BaseRepository {
         priority = excluded.priority,
         updated_at = excluded.updated_at,
         resolved_at = excluded.resolved_at,
-        deleted_at = excluded.deleted_at`,
+        deleted_at = excluded.deleted_at,
+        okf_type = excluded.okf_type`,
       [
         task.id,
         task.entity_id,
@@ -1113,7 +1160,8 @@ var TaskRepository = class extends BaseRepository {
         task.created_at,
         now,
         task.resolved_at ?? null,
-        task.deleted_at ?? null
+        task.deleted_at ?? null,
+        task.okf_type ?? null
       ]
     );
   }
@@ -1335,6 +1383,53 @@ var EventRepository = class extends BaseRepository {
   }
 };
 
+// src/repositories/EdgeRepository.ts
+var EdgeRepository = class extends BaseRepository {
+  /**
+   * Insert an edge, silently skipping on primary-key or uniqueness conflicts.
+   * Throws when the insert was skipped due to an id collision with a different edge tuple.
+   */
+  async addIgnoreDuplicate(edge, tx) {
+    const executor = this.getExecutor(tx);
+    const result = await executor.runAsync(
+      `INSERT OR IGNORE INTO ${this.prefix}edges (id, entity_id, source_id, target_id, edge_type, created_at)
+       VALUES (?, ?, ?, ?, ?, ?)`,
+      [edge.id, edge.entity_id, edge.source_id, edge.target_id, edge.edge_type, edge.created_at]
+    );
+    if (result.changes > 0) return;
+    const existing = await executor.getFirstAsync(
+      `SELECT entity_id, source_id, target_id, edge_type FROM ${this.prefix}edges WHERE id = ?`,
+      [edge.id]
+    );
+    if (!existing) return;
+    if (String(existing.entity_id) !== edge.entity_id || String(existing.source_id) !== edge.source_id || String(existing.target_id) !== edge.target_id || String(existing.edge_type) !== edge.edge_type) {
+      throw new Error(
+        `Edge id collision: ${JSON.stringify(edge.id)} already exists with a different (entity_id, source_id, target_id, edge_type) tuple`
+      );
+    }
+  }
+  async getByEntityId(entityId, tx) {
+    const executor = this.getExecutor(tx);
+    const rows = await executor.getAllAsync(
+      `SELECT * FROM ${this.prefix}edges WHERE entity_id = ? ORDER BY created_at ASC`,
+      [entityId]
+    );
+    return rows.map((row) => ({
+      id: String(row.id),
+      entity_id: String(row.entity_id),
+      source_id: String(row.source_id),
+      target_id: String(row.target_id),
+      edge_type: String(row.edge_type),
+      created_at: Number(row.created_at)
+    }));
+  }
+  /** Hard delete — edges have no soft-delete concept, only presence/absence. `tx` is REQUIRED. */
+  async bulkDeleteByEntityId(entityId, tx) {
+    const executor = this.getExecutor(tx);
+    await executor.runAsync(`DELETE FROM ${this.prefix}edges WHERE entity_id = ?`, [entityId]);
+  }
+};
+
 // src/repositories/MetadataRepository.ts
 var MetadataRepository = class extends BaseRepository {
   // CHECKPOINTS TABLE METHODS
@@ -1711,6 +1806,20 @@ var JobManager = class {
     this.activeMaintenanceJobs = /* @__PURE__ */ new Set();
     this.activeIngestJobs = /* @__PURE__ */ new Map();
     this.statusSubscribers = /* @__PURE__ */ new Map();
+    /**
+     * Lookup table for acquireLock/releaseLock's dynamic-dispatch branch.
+     * Excludes 'ingest' | 'global_reembed' | 'global_import', which those
+     * methods already handle via explicit if/else branches before reaching
+     * this table.
+     */
+    this.lockKeyFns = {
+      prune: (id) => this._pruneKey(id),
+      librarian: (id) => this._librarianKey(id),
+      heal: (id) => this._healKey(id),
+      reembed: (id) => this._reembedKey(id),
+      import: (id) => this._importKey(id),
+      forget: (id) => this._forgetKey(id)
+    };
   }
   _pruneKey(entityId) {
     return `${this.prefix}:${entityId}:prune`;
@@ -1860,9 +1969,7 @@ var JobManager = class {
     } else if (operation === "global_import") {
       this.activeMaintenanceJobs.add(this._globalImportKey());
     } else {
-      const keyFnName = `_${operation}Key`;
-      const keyFn = this[keyFnName];
-      this.activeMaintenanceJobs.add(keyFn.call(this, entityId));
+      this.activeMaintenanceJobs.add(this.lockKeyFns[operation](entityId));
     }
     this._notifyStatusSubscribers(entityId);
   }
@@ -1874,9 +1981,7 @@ var JobManager = class {
     } else if (operation === "global_import") {
       this.activeMaintenanceJobs.delete(this._globalImportKey());
     } else {
-      const keyFnName = `_${operation}Key`;
-      const keyFn = this[keyFnName];
-      this.activeMaintenanceJobs.delete(keyFn.call(this, entityId));
+      this.activeMaintenanceJobs.delete(this.lockKeyFns[operation](entityId));
     }
     this._notifyStatusSubscribers(entityId);
   }
@@ -2826,12 +2931,16 @@ var MaintenanceService = class {
 };
 
 // src/services/ImportExportService.ts
+var MAX_EMBEDDING_BLOB_BYTES = 32 * 1024;
+var IMPORT_TITLE_MAX = 500;
+var IMPORT_BODY_MAX = 8e3;
 var ImportExportService = class {
-  constructor(db, entryRepo, taskRepo, eventRepo, metadataRepo, searchService, jobManager, embeddingService) {
+  constructor(db, entryRepo, taskRepo, eventRepo, edgeRepo, metadataRepo, searchService, jobManager, embeddingService) {
     this.db = db;
     this.entryRepo = entryRepo;
     this.taskRepo = taskRepo;
     this.eventRepo = eventRepo;
+    this.edgeRepo = edgeRepo;
     this.metadataRepo = metadataRepo;
     this.searchService = searchService;
     this.jobManager = jobManager;
@@ -2876,10 +2985,11 @@ var ImportExportService = class {
     }
   }
   async getFullBundle(entityId, opts) {
-    const [factsRaw, tasks, events] = await Promise.all([
+    const [factsRaw, tasks, events, edges] = await Promise.all([
       opts?.includeBlobs ? this.entryRepo.findAllByEntityIdWithBlobs(entityId) : this.entryRepo.findAllByEntityId(entityId),
       this.taskRepo.findAllByEntityId(entityId),
-      this.eventRepo.getByEntityId(entityId, opts?.maxEvents)
+      this.eventRepo.getByEntityId(entityId, opts?.maxEvents),
+      this.edgeRepo.getByEntityId(entityId)
     ]);
     const facts = factsRaw.map((f) => {
       const {
@@ -2898,7 +3008,7 @@ var ImportExportService = class {
         tags: typeof factBase.tags === "string" ? JSON.parse(factBase.tags) : factBase.tags
       };
     });
-    return { facts, tasks, events };
+    return { facts, tasks, events, edges };
   }
   /** Single-entity import transaction + post-processing; package-internal hook for tests. */
   async doImportEntity(entityId, bundle, merge) {
@@ -2907,6 +3017,7 @@ var ImportExportService = class {
     const factsWithPreservedBlob = /* @__PURE__ */ new Map();
     const preservedBlobDims = /* @__PURE__ */ new Set();
     const softDeletedFactIds = [];
+    const clippedTextByFactId = /* @__PURE__ */ new Map();
     await this.db.withTransactionAsync(async (tx) => {
       if (!merge) {
         const deletedLiveFactIds = await this.entryRepo.findIdsBySource(
@@ -2919,6 +3030,7 @@ var ImportExportService = class {
         softDeletedFactIds.push(...deletedLiveFactIds);
         await this.entryRepo.bulkSoftDeleteByEntityId(entityId, tx);
         await this.taskRepo.bulkSoftDeleteByEntityId(entityId, tx);
+        await this.edgeRepo.bulkDeleteByEntityId(entityId, tx);
         await this.metadataRepo.deleteCheckpoint(entityId, tx);
       }
       const factIds = bundle.facts.map((fact) => fact.id);
@@ -2943,21 +3055,32 @@ var ImportExportService = class {
         const rawBlobRaw = fact.embedding_blob;
         let rawBlob = null;
         if (rawBlobRaw instanceof Uint8Array) {
-          rawBlob = rawBlobRaw;
+          if (rawBlobRaw.byteLength <= MAX_EMBEDDING_BLOB_BYTES) {
+            rawBlob = rawBlobRaw;
+          }
         } else if (rawBlobRaw !== null && rawBlobRaw !== void 0 && typeof rawBlobRaw === "object") {
           const obj = rawBlobRaw;
           if (obj["type"] === "Buffer" && Array.isArray(obj["data"])) {
-            rawBlob = new Uint8Array(obj["data"]);
+            const data = obj["data"];
+            if (data.length <= MAX_EMBEDDING_BLOB_BYTES) {
+              rawBlob = new Uint8Array(data);
+            }
           } else if (!Array.isArray(rawBlobRaw)) {
             const entries = Object.keys(obj);
             if (entries.length > 0 && entries.every((k) => /^\d+$/.test(k))) {
               const len = entries.length;
-              rawBlob = new Uint8Array(len);
-              for (let i = 0; i < len; i++)
-                rawBlob[i] = obj[String(i)] ?? 0;
+              if (len <= MAX_EMBEDDING_BLOB_BYTES) {
+                rawBlob = new Uint8Array(len);
+                for (let i = 0; i < len; i++) {
+                  rawBlob[i] = obj[String(i)] ?? 0;
+                }
+              }
             }
           }
         }
+        if (rawBlob !== null && rawBlob.byteLength > MAX_EMBEDDING_BLOB_BYTES) {
+          rawBlob = null;
+        }
         let blobData = null;
         if (rawBlob !== null && rawBlob.byteLength > 0 && rawBlob.byteLength % 4 === 0) {
           const copy = new ArrayBuffer(rawBlob.byteLength);
@@ -2987,11 +3110,14 @@ var ImportExportService = class {
           }
           if (merge && safeUpdatedAt <= existing.updated_at) continue;
         }
+        const safeTitle = clip(String(fact.title ?? ""), IMPORT_TITLE_MAX);
+        const safeBody = clip(String(fact.body ?? ""), IMPORT_BODY_MAX);
+        clippedTextByFactId.set(fact.id, { title: safeTitle, body: safeBody });
         const factObj = {
           id: fact.id,
           entity_id: entityId,
-          title: fact.title,
-          body: fact.body,
+          title: safeTitle,
+          body: safeBody,
           tags: Array.isArray(fact.tags) ? fact.tags : [],
           confidence: fact.confidence,
           source_type: sourceType,
@@ -3002,7 +3128,8 @@ var ImportExportService = class {
           last_accessed_at: fact.last_accessed_at,
           access_count: fact.access_count,
           deleted_at: fact.deleted_at,
-          embedding_blob: blobData ?? void 0
+          embedding_blob: blobData ?? void 0,
+          okf_type: fact.okf_type ?? null
         };
         await this.entryRepo.upsertForImport(factObj, tx);
         if (blobData != null) {
@@ -3051,7 +3178,8 @@ var ImportExportService = class {
             created_at: task.created_at,
             updated_at: safeUpdatedAt,
             resolved_at: task.resolved_at,
-            deleted_at: task.deleted_at
+            deleted_at: task.deleted_at,
+            okf_type: task.okf_type ?? null
           },
           tx,
           safeUpdatedAt
@@ -3075,15 +3203,29 @@ var ImportExportService = class {
           tx
         );
       }
+      for (const edge of bundle.edges ?? []) {
+        await this.edgeRepo.addIgnoreDuplicate(
+          {
+            id: edge.id,
+            entity_id: entityId,
+            source_id: edge.source_id,
+            target_id: edge.target_id,
+            edge_type: edge.edge_type,
+            created_at: edge.created_at
+          },
+          tx
+        );
+      }
     });
     await this.searchService.sync(entityId);
     for (const fact of bundle.facts) {
       if (!fact.deleted_at && upsertedFactIds.has(fact.id) && !factsWithPreservedBlob.has(fact.id)) {
+        const clipped = clippedTextByFactId.get(fact.id);
         const embedded = await this.embeddingService.embedFact({
           id: fact.id,
           entity_id: entityId,
-          title: fact.title,
-          body: fact.body,
+          title: clipped?.title ?? fact.title,
+          body: clipped?.body ?? fact.body,
           tags: Array.isArray(fact.tags) || typeof fact.tags === "string" ? fact.tags : []
         });
         if (!embedded) {
@@ -3183,7 +3325,7 @@ var ImportExportService = class {
   }
   _warnCrossEntityCollision(type, id, existingEntityId, targetEntityId) {
     console.warn(
-      `[WikiMemory] importDump: ${type} id "${id}" already belongs to entity "${existingEntityId}"; skipping for entity "${targetEntityId}"`
+      `[WikiMemory] importDump: ${type} id ${JSON.stringify(id)} already belongs to entity ${JSON.stringify(existingEntityId)}; skipping for entity ${JSON.stringify(targetEntityId)}`
     );
   }
   _normalizeImportedSourceType(raw, ctx) {
@@ -3262,7 +3404,7 @@ var EmbeddingService = class {
         tagsStr = fact.tags;
       }
     }
-    const text = `${fact.title} ${fact.body} ${tagsStr}`.trim();
+    const text = clip(`${fact.title} ${fact.body} ${tagsStr}`.trim(), 16e3);
     try {
       const vector = await embedFn(text);
       if (vector.length === 0 || !vector.every((v) => typeof v === "number" && isFinite(v))) {
@@ -3390,7 +3532,7 @@ var RetrievalService = class {
     const sanitizedTierWeights = shouldExposeReadMetadata(entityId) ? sanitizeTierWeights(entityIds, options?.tierWeights) : void 0;
     const exposeMetadata = shouldExposeReadMetadata(entityId);
     if (entityIds.length === 0) {
-      const empty = { facts: [], tasks: [], events: [] };
+      const empty = { facts: [], tasks: [], events: [], edges: [] };
       if (exposeMetadata) {
         empty.metadata = { query, entityIds: [] };
         if (sanitizedTierWeights && Object.keys(sanitizedTierWeights).length > 0) empty.metadata.tierWeights = sanitizedTierWeights;
@@ -3780,7 +3922,7 @@ var RetrievalService = class {
     if (exposeMetadata && trimmedQuery && scoreByFactId) {
       factScores = Object.fromEntries(facts.map((fact) => [fact.id, scoreByFactId.get(fact.id) ?? 0]));
     }
-    const bundle = { facts, tasks, events: events.reverse() };
+    const bundle = { facts, tasks, events: events.reverse(), edges: [] };
     if (exposeMetadata) {
       bundle.metadata = { query, entityIds };
       if (sanitizedTierWeights && Object.keys(sanitizedTierWeights).length > 0) bundle.metadata.tierWeights = sanitizedTierWeights;
@@ -3876,15 +4018,38 @@ var RetrievalService = class {
 
 // src/services/WriteService.ts
 var WriteService = class {
-  constructor(db, options, eventRepo, metadataRepo, jobManager, maintenanceService) {
+  constructor(db, options, entryRepo, eventRepo, metadataRepo, jobManager, maintenanceService) {
     this.db = db;
     this.options = options;
+    this.entryRepo = entryRepo;
     this.eventRepo = eventRepo;
     this.metadataRepo = metadataRepo;
     this.jobManager = jobManager;
     this.maintenanceService = maintenanceService;
   }
   async write(entityId, event) {
+    if (typeof entityId !== "string" || entityId.length === 0 || entityId.length > 200 || entityId.includes("\0")) {
+      throw new TypeError(
+        `Invalid entityId: must be a non-empty string at most 200 chars with no null bytes; got ${JSON.stringify(entityId)}.`
+      );
+    }
+    if (event === null || typeof event !== "object" || Array.isArray(event)) {
+      throw new TypeError("Invalid event: must be a non-null object.");
+    }
+    if (typeof event.summary !== "string") {
+      throw new TypeError("Invalid event.summary: must be a string.");
+    }
+    const summary = clip(event.summary, 4e3);
+    let relatedEntryId = null;
+    const rawRelatedEntryId = event.related_entry_id;
+    if (rawRelatedEntryId != null && rawRelatedEntryId !== "") {
+      if (typeof rawRelatedEntryId !== "string" || rawRelatedEntryId.length > 200 || rawRelatedEntryId.includes("\0")) {
+        relatedEntryId = null;
+      } else {
+        const existing = await this.entryRepo.findByIds([rawRelatedEntryId], [entityId]);
+        relatedEntryId = existing.length > 0 ? rawRelatedEntryId : null;
+      }
+    }
     const id = generateId("evt_");
     const now = Date.now();
     let eventType = event.event_type;
@@ -3895,8 +4060,8 @@ var WriteService = class {
       id,
       entity_id: entityId,
       event_type: eventType,
-      summary: event.summary,
-      related_entry_id: event.related_entry_id || null,
+      summary,
+      related_entry_id: relatedEntryId,
       created_at: now
     };
     let shouldRunLibrarian = false;
@@ -3957,6 +4122,7 @@ var WriteService = class {
 };
 
 // src/WikiMemory.ts
+var TABLE_PREFIX_PATTERN = /^[A-Za-z][A-Za-z0-9_]{0,30}_$/;
 var _testAccessNonTestEnvWarned;
 var WikiMemory = class {
   constructor(db, options) {
@@ -3964,11 +4130,17 @@ var WikiMemory = class {
     __privateAdd(this, _testAccessNonTestEnvWarned, false);
     this.db = db;
     this.options = options;
-    this.prefix = options.config?.tablePrefix || "llm_wiki_";
+    this.prefix = options.config?.tablePrefix ?? "llm_wiki_";
+    if (!TABLE_PREFIX_PATTERN.test(this.prefix)) {
+      throw new Error(
+        `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.embeddingService = new EmbeddingService(this.db, this.options, this.entryRepo, this.metadataRepo);
     this.searchService = new SearchService(this.entryRepo);
@@ -4002,6 +4174,7 @@ var WikiMemory = class {
       this.entryRepo,
       this.taskRepo,
       this.eventRepo,
+      this.edgeRepo,
       this.metadataRepo,
       this.searchService,
       this.jobManager,
@@ -4018,6 +4191,7 @@ var WikiMemory = class {
     this.writeService = new WriteService(
       this.db,
       this.options,
+      this.entryRepo,
       this.eventRepo,
       this.metadataRepo,
       this.jobManager,
@@ -4096,7 +4270,7 @@ var WikiMemory = class {
   async hasChanged(entityId, sourceRef, sourceHash) {
     const normalizedRef = normalizeSourceRef(sourceRef);
     if (!normalizedRef) {
-      throw new Error(`Invalid sourceRef: "${sourceRef}"`);
+      throw new Error(`Invalid sourceRef: ${JSON.stringify(sourceRef)}`);
     }
     const normalizedHash = normalizeSourceHash(sourceHash);
     if (!normalizedHash) {
@@ -4461,7 +4635,7 @@ function formatMemoryDump(dump) {
 }
 function factFrontmatter(f) {
   return {
-    type: "fact",
+    type: f.okf_type ?? "fact",
     title: f.title,
     tags: f.tags,
     timestamp: new Date(f.updated_at).toISOString(),
@@ -4479,7 +4653,7 @@ function factFrontmatter(f) {
 }
 function taskFrontmatter(t) {
   return {
-    type: "task",
+    type: t.okf_type ?? "task",
     title: t.description,
     timestamp: new Date(t.updated_at).toISOString(),
     id: t.id,
@@ -4554,6 +4728,227 @@ function formatOkfBundle(dump) {
   });
   return { files };
 }
+var CONFIDENCE_VALUES = /* @__PURE__ */ new Set(["certain", "inferred", "tentative"]);
+var SOURCE_TYPES = /* @__PURE__ */ new Set([
+  "user_stated",
+  "librarian_inferred",
+  "user_confirmed",
+  "immutable_document"
+]);
+var TASK_STATUSES = /* @__PURE__ */ new Set(["pending", "in_progress", "done", "abandoned"]);
+var EVENT_TYPES = /* @__PURE__ */ new Set(["observation", "decision", "action", "outcome"]);
+function basenameMd(filePath) {
+  const name = filePath.slice(filePath.lastIndexOf("/") + 1);
+  return name.endsWith(".md") ? name.slice(0, -3) : name;
+}
+function isConceptFile(filePath) {
+  if (!filePath.endsWith(".md")) return false;
+  if (filePath.endsWith("/index.md") || filePath === "index.md") return false;
+  if (filePath.endsWith("/log.md") || filePath === "log.md") return false;
+  return true;
+}
+function isStructuralPath(filePath) {
+  return filePath.endsWith("/index.md") || filePath === "index.md" || filePath.endsWith("/log.md") || filePath === "log.md";
+}
+function posixDirname(filePath) {
+  const idx = filePath.lastIndexOf("/");
+  return idx === -1 ? "" : filePath.slice(0, idx);
+}
+function resolveRelativePath(fromFile, linkPath) {
+  const baseDir = posixDirname(fromFile);
+  const segments = [...baseDir ? baseDir.split("/") : [], ...linkPath.split("/")];
+  const resolved = [];
+  for (const seg of segments) {
+    if (seg === "" || seg === ".") continue;
+    if (seg === "..") {
+      resolved.pop();
+      continue;
+    }
+    resolved.push(seg);
+  }
+  return resolved.join("/");
+}
+function addPathAliases(map, filePath, resolvedId) {
+  map.set(filePath, resolvedId);
+  const withoutDot = filePath.replace(/^\.\//, "");
+  if (withoutDot !== filePath) map.set(withoutDot, resolvedId);
+  const entityRelative = filePath.replace(/^entities\/[^/]+\//, "");
+  if (entityRelative !== filePath) {
+    map.set(entityRelative, resolvedId);
+    map.set(`./${entityRelative}`, resolvedId);
+  }
+}
+function lookupResolvedId(map, path) {
+  const normalized = path.replace(/^\.\//, "");
+  return map.get(path) ?? map.get(normalized) ?? map.get(`./${normalized}`);
+}
+function stripLinkSuffix(linkPath) {
+  const hashIdx = linkPath.indexOf("#");
+  const queryIdx = linkPath.indexOf("?");
+  if (hashIdx === -1 && queryIdx === -1) return linkPath;
+  const cut = hashIdx === -1 ? queryIdx : queryIdx === -1 ? hashIdx : Math.min(hashIdx, queryIdx);
+  return linkPath.slice(0, cut);
+}
+function resolveRoute(filePath, frontmatterType, options) {
+  if (options?.typeMapping && Object.prototype.hasOwnProperty.call(options.typeMapping, frontmatterType)) {
+    return options.typeMapping[frontmatterType];
+  }
+  if (filePath.includes("/facts/")) return "fact";
+  if (filePath.includes("/tasks/")) return "task";
+  return options?.defaultSchema ?? "fact";
+}
+function parseFrontmatterTimestamp(value, fallback) {
+  if (typeof value === "number" && Number.isFinite(value)) return value;
+  if (typeof value === "string") {
+    const parsed = Date.parse(value);
+    if (Number.isFinite(parsed)) return parsed;
+  }
+  return fallback;
+}
+function unescapeLogSummary(summary) {
+  return summary.replace(/\\\]/g, "]").replace(/\\\[/g, "[").replace(/\\\\/g, "\\");
+}
+var LOG_LINE_PATTERN = /^\(([^)]+)\)\s*(?:\[((?:\\.|[^\]])*)\]\(([^)]+)\)|(.+))$/;
+function parseLogEntryText(text) {
+  const match = LOG_LINE_PATTERN.exec(text.trim());
+  if (!match) return null;
+  const [, rawType, linkedSummary, linkPath, plainSummary] = match;
+  const event_type = EVENT_TYPES.has(rawType) ? rawType : "observation";
+  if (linkPath) {
+    return { event_type, summary: unescapeLogSummary(linkedSummary), linkPath };
+  }
+  return { event_type, summary: (plainSummary ?? "").trim() };
+}
+function frontmatterToFact(entityId, id, frontmatter, body, now) {
+  const created_at = parseFrontmatterTimestamp(frontmatter.created_at, now);
+  const updated_at = parseFrontmatterTimestamp(
+    frontmatter.timestamp,
+    parseFrontmatterTimestamp(frontmatter.updated_at, now)
+  );
+  return {
+    id,
+    entity_id: entityId,
+    title: typeof frontmatter.title === "string" ? frontmatter.title : "",
+    body,
+    tags: Array.isArray(frontmatter.tags) ? frontmatter.tags.filter((t) => typeof t === "string") : [],
+    confidence: CONFIDENCE_VALUES.has(String(frontmatter.confidence)) ? frontmatter.confidence : "tentative",
+    source_type: SOURCE_TYPES.has(String(frontmatter.source_type)) ? frontmatter.source_type : "user_stated",
+    source_hash: typeof frontmatter.source_hash === "string" ? frontmatter.source_hash : null,
+    source_ref: typeof frontmatter.resource === "string" ? frontmatter.resource : null,
+    created_at,
+    updated_at,
+    last_accessed_at: frontmatter.last_accessed_at != null ? parseFrontmatterTimestamp(frontmatter.last_accessed_at, now) : null,
+    access_count: typeof frontmatter.access_count === "number" ? frontmatter.access_count : 0,
+    deleted_at: frontmatter.deleted_at != null ? parseFrontmatterTimestamp(frontmatter.deleted_at, 0) : null,
+    okf_type: frontmatter.type
+  };
+}
+function frontmatterToTask(entityId, id, frontmatter, now) {
+  const created_at = parseFrontmatterTimestamp(frontmatter.created_at, now);
+  const updated_at = parseFrontmatterTimestamp(
+    frontmatter.timestamp,
+    parseFrontmatterTimestamp(frontmatter.updated_at, now)
+  );
+  return {
+    id,
+    entity_id: entityId,
+    description: typeof frontmatter.title === "string" ? frontmatter.title : "",
+    status: TASK_STATUSES.has(String(frontmatter.status)) ? frontmatter.status : "pending",
+    priority: typeof frontmatter.priority === "number" ? frontmatter.priority : 0,
+    created_at,
+    updated_at,
+    resolved_at: frontmatter.resolved_at != null ? parseFrontmatterTimestamp(frontmatter.resolved_at, now) : null,
+    deleted_at: frontmatter.deleted_at != null ? parseFrontmatterTimestamp(frontmatter.deleted_at, 0) : null,
+    okf_type: frontmatter.type
+  };
+}
+function findLogMdPath(files) {
+  return files.find((f) => f.path.endsWith("/log.md") || f.path === "log.md")?.path;
+}
+function parseOkfBundle(entityId, files, options) {
+  const now = Date.now();
+  const pathToResolvedId = /* @__PURE__ */ new Map();
+  for (const file of files) {
+    if (!isConceptFile(file.path)) continue;
+    const { frontmatter } = coreOkf.parseConcept(file.content);
+    const route = resolveRoute(file.path, frontmatter.type ?? "", options);
+    if (route === "ignore") continue;
+    const resolvedId = typeof frontmatter.id === "string" && frontmatter.id ? frontmatter.id : basenameMd(file.path);
+    addPathAliases(pathToResolvedId, file.path, resolvedId);
+  }
+  const facts = [];
+  const tasks = [];
+  const edges = [];
+  let logContent = null;
+  const logMdPath = findLogMdPath(files);
+  for (const file of files) {
+    if (file.path.endsWith("/log.md") || file.path === "log.md") {
+      logContent = file.content;
+      continue;
+    }
+    if (!isConceptFile(file.path)) continue;
+    const { frontmatter, body } = coreOkf.parseConcept(file.content);
+    const route = resolveRoute(file.path, frontmatter.type ?? "", options);
+    if (route === "ignore") continue;
+    const resolvedId = typeof frontmatter.id === "string" && frontmatter.id ? frontmatter.id : basenameMd(file.path);
+    if (route === "fact") {
+      facts.push(frontmatterToFact(entityId, resolvedId, frontmatter, body, now));
+    } else {
+      tasks.push(frontmatterToTask(entityId, resolvedId, frontmatter, now));
+    }
+    const seenEdges = /* @__PURE__ */ new Set();
+    for (const link of coreOkf.extractMarkdownLinks(body)) {
+      const strippedPath = stripLinkSuffix(link.path);
+      const directTargetId = lookupResolvedId(pathToResolvedId, strippedPath);
+      const resolvedTargetPath = resolveRelativePath(file.path, strippedPath);
+      if (isStructuralPath(strippedPath) || isStructuralPath(resolvedTargetPath)) continue;
+      const targetId = directTargetId ?? lookupResolvedId(pathToResolvedId, resolvedTargetPath);
+      if (!targetId) continue;
+      const edgeKey = `${resolvedId}\0${targetId}\0${link.text}`;
+      if (seenEdges.has(edgeKey)) continue;
+      seenEdges.add(edgeKey);
+      edges.push({
+        id: generateId(),
+        entity_id: entityId,
+        source_id: resolvedId,
+        target_id: targetId,
+        edge_type: link.text,
+        created_at: now
+      });
+    }
+  }
+  const events = [];
+  if (logContent != null) {
+    const logPath = logMdPath ?? `entities/${entityId}/log.md`;
+    for (const entry of coreOkf.parseLogMd(logContent)) {
+      const parsed = parseLogEntryText(entry.text);
+      if (!parsed) continue;
+      let related_entry_id = null;
+      if (parsed.linkPath) {
+        const targetPath = resolveRelativePath(logPath, stripLinkSuffix(parsed.linkPath));
+        if (!isStructuralPath(targetPath) && targetPath.includes("/facts/")) {
+          related_entry_id = lookupResolvedId(pathToResolvedId, targetPath) ?? null;
+        }
+      }
+      const created_at = (/* @__PURE__ */ new Date(`${entry.date}T00:00:00.000Z`)).getTime();
+      if (!Number.isFinite(created_at)) continue;
+      events.push({
+        id: generateId("evt_"),
+        entity_id: entityId,
+        event_type: parsed.event_type,
+        summary: parsed.summary,
+        related_entry_id,
+        created_at
+      });
+    }
+  }
+  return {
+    generatedAt: now,
+    entities: {
+      [entityId]: { facts, tasks, events, edges }
+    }
+  };
+}
 
 // src/librarianPrompt.ts
 var DEFAULT_LIBRARIAN_SYNTHESIS_PROMPT = `You are a careful memory synthesis assistant.
@@ -4612,6 +5007,7 @@ exports.formatOkfBundle = formatOkfBundle;
 exports.hydrateLibrarianPrompt = hydrateLibrarianPrompt;
 exports.mapLibrarianOptionsToReadOptions = mapLibrarianOptionsToReadOptions;
 exports.parseEmbedding = parseEmbedding;
+exports.parseOkfBundle = parseOkfBundle;
 exports.validateLibrarianPromptTemplate = validateLibrarianPromptTemplate;
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map