@equationalapplications/core-llm-wiki 4.14.1 → 4.15.0

package/dist/{testing-DW1qufP0.d.mts → testing-NH1_Aigh.d.mts}

@@ -123,6 +123,12 @@ interface WikiFact {
     last_accessed_at: number | null;
     access_count: number;
     deleted_at: number | null;
+    /**
+     * Verbatim OKF `type:` frontmatter value when this fact originated from (or was
+     * re-imported via) an OKF bundle. `null`/`undefined` for facts never touched by
+     * OKF import. Distinct from `source_type`, which governs immutability rules.
+     */
+    okf_type?: string | null;
 }
 interface WikiTask {
     id: string;
@@ -134,6 +140,8 @@ interface WikiTask {
     updated_at: number;
     resolved_at: number | null;
     deleted_at: number | null;
+    /** Verbatim OKF `type:` frontmatter value when this task originated from an OKF bundle. */
+    okf_type?: string | null;
 }
 interface WikiEvent {
     id: string;
@@ -143,6 +151,14 @@ interface WikiEvent {
     related_entry_id?: string | null;
     created_at: number;
 }
+interface WikiEdge {
+    id: string;
+    entity_id: string;
+    source_id: string;
+    target_id: string;
+    edge_type: string;
+    created_at: number;
+}
 interface WikiCheckpoint {
     entity_id: string;
     heal_checkpoint: number;
@@ -309,6 +325,7 @@ interface MemoryBundle {
     facts: WikiFact[];
     tasks: WikiTask[];
     events: WikiEvent[];
+    edges?: WikiEdge[];
     factScores?: Record<string, number>;
     metadata?: {
         query: string;
@@ -952,16 +969,28 @@ declare class MaintenanceService {
     private _sanitizeRankerError;
 }
 
+declare class EdgeRepository 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.
+     */
+    addIgnoreDuplicate(edge: WikiEdge, tx?: SQLiteAdapter): Promise<void>;
+    getByEntityId(entityId: string, tx?: SQLiteAdapter): Promise<WikiEdge[]>;
+    /** Hard delete — edges have no soft-delete concept, only presence/absence. `tx` is REQUIRED. */
+    bulkDeleteByEntityId(entityId: string, tx: SQLiteAdapter): Promise<void>;
+}
+
 declare class ImportExportService {
     private db;
     private entryRepo;
     private taskRepo;
     private eventRepo;
+    private edgeRepo;
     private metadataRepo;
     private searchService;
     private jobManager;
     private embeddingService;
-    constructor(db: SQLiteAdapter, entryRepo: EntryRepository, taskRepo: TaskRepository, eventRepo: EventRepository, metadataRepo: MetadataRepository, searchService: SearchService, jobManager: JobManager, embeddingService: EmbeddingService);
+    constructor(db: SQLiteAdapter, entryRepo: EntryRepository, taskRepo: TaskRepository, eventRepo: EventRepository, edgeRepo: EdgeRepository, metadataRepo: MetadataRepository, searchService: SearchService, jobManager: JobManager, embeddingService: EmbeddingService);
     exportDump(entityIds?: string[]): Promise<MemoryDump>;
     importDump(dump: MemoryDump, opts?: {
         merge?: boolean;
@@ -1050,6 +1079,7 @@ declare class WikiMemory {
     private outboxRepo;
     private taskRepo;
     private eventRepo;
+    private edgeRepo;
     private metadataRepo;
     private embeddingService;
     private searchService;
@@ -1152,4 +1182,4 @@ declare class WikiMemory {
     markOutboxEventsProcessed(eventIds: string[]): Promise<void>;
 }
 
-export { type EntityStatus as E, type FormatContextOptions as F, HOOK_TIMEOUT_MARKER as H, ImportExportService as I, JobManager as J, type LLMProvider as L, type MemoryBundle as M, type PromptOverrides as P, type ReadOptions as R, type SQLiteAdapter as S, type VectorRanker as V, type WikiOptions as W, type MemoryDump as a, type FormattedMemoryDump as b, WikiMemory as c, type ExtractedFact as d, type ExtractedTask as e, PromptService as f, PrunePartialFailureError as g, type VectorRankerFallback as h, type VectorRankerRankArgs as i, type VectorRankerSemanticResult as j, WikiBusyError as k, type WikiBusyOperation as l, type WikiCheckpoint as m, type WikiConfig as n, type WikiEvent as o, type WikiFact as p, type WikiMemoryTestAccess as q, type WikiOutboxEvent as r, type WikiTask as s, EmbeddingService as t, IngestionService as u, MaintenanceService as v, RetrievalService as w, SearchService as x, WriteService as y };
+export { type EntityStatus as E, type FormatContextOptions as F, HOOK_TIMEOUT_MARKER as H, ImportExportService as I, JobManager as J, type LLMProvider as L, type MemoryBundle as M, type PromptOverrides as P, type ReadOptions as R, type SQLiteAdapter as S, type VectorRanker as V, type WikiOptions as W, type MemoryDump as a, type FormattedMemoryDump as b, WikiMemory as c, type ExtractedFact as d, type ExtractedTask as e, PromptService as f, PrunePartialFailureError as g, type VectorRankerFallback as h, type VectorRankerRankArgs as i, type VectorRankerSemanticResult as j, WikiBusyError as k, type WikiBusyOperation as l, type WikiCheckpoint as m, type WikiConfig as n, type WikiEdge as o, type WikiEvent as p, type WikiFact as q, type WikiMemoryTestAccess as r, type WikiOutboxEvent as s, type WikiTask as t, EmbeddingService as u, IngestionService as v, MaintenanceService as w, RetrievalService as x, SearchService as y, WriteService as z };

package/dist/{testing-DW1qufP0.d.ts → testing-NH1_Aigh.d.ts}

@@ -123,6 +123,12 @@ interface WikiFact {
     last_accessed_at: number | null;
     access_count: number;
     deleted_at: number | null;
+    /**
+     * Verbatim OKF `type:` frontmatter value when this fact originated from (or was
+     * re-imported via) an OKF bundle. `null`/`undefined` for facts never touched by
+     * OKF import. Distinct from `source_type`, which governs immutability rules.
+     */
+    okf_type?: string | null;
 }
 interface WikiTask {
     id: string;
@@ -134,6 +140,8 @@ interface WikiTask {
     updated_at: number;
     resolved_at: number | null;
     deleted_at: number | null;
+    /** Verbatim OKF `type:` frontmatter value when this task originated from an OKF bundle. */
+    okf_type?: string | null;
 }
 interface WikiEvent {
     id: string;
@@ -143,6 +151,14 @@ interface WikiEvent {
     related_entry_id?: string | null;
     created_at: number;
 }
+interface WikiEdge {
+    id: string;
+    entity_id: string;
+    source_id: string;
+    target_id: string;
+    edge_type: string;
+    created_at: number;
+}
 interface WikiCheckpoint {
     entity_id: string;
     heal_checkpoint: number;
@@ -309,6 +325,7 @@ interface MemoryBundle {
     facts: WikiFact[];
     tasks: WikiTask[];
     events: WikiEvent[];
+    edges?: WikiEdge[];
     factScores?: Record<string, number>;
     metadata?: {
         query: string;
@@ -952,16 +969,28 @@ declare class MaintenanceService {
     private _sanitizeRankerError;
 }
 
+declare class EdgeRepository 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.
+     */
+    addIgnoreDuplicate(edge: WikiEdge, tx?: SQLiteAdapter): Promise<void>;
+    getByEntityId(entityId: string, tx?: SQLiteAdapter): Promise<WikiEdge[]>;
+    /** Hard delete — edges have no soft-delete concept, only presence/absence. `tx` is REQUIRED. */
+    bulkDeleteByEntityId(entityId: string, tx: SQLiteAdapter): Promise<void>;
+}
+
 declare class ImportExportService {
     private db;
     private entryRepo;
     private taskRepo;
     private eventRepo;
+    private edgeRepo;
     private metadataRepo;
     private searchService;
     private jobManager;
     private embeddingService;
-    constructor(db: SQLiteAdapter, entryRepo: EntryRepository, taskRepo: TaskRepository, eventRepo: EventRepository, metadataRepo: MetadataRepository, searchService: SearchService, jobManager: JobManager, embeddingService: EmbeddingService);
+    constructor(db: SQLiteAdapter, entryRepo: EntryRepository, taskRepo: TaskRepository, eventRepo: EventRepository, edgeRepo: EdgeRepository, metadataRepo: MetadataRepository, searchService: SearchService, jobManager: JobManager, embeddingService: EmbeddingService);
     exportDump(entityIds?: string[]): Promise<MemoryDump>;
     importDump(dump: MemoryDump, opts?: {
         merge?: boolean;
@@ -1050,6 +1079,7 @@ declare class WikiMemory {
     private outboxRepo;
     private taskRepo;
     private eventRepo;
+    private edgeRepo;
     private metadataRepo;
     private embeddingService;
     private searchService;
@@ -1152,4 +1182,4 @@ declare class WikiMemory {
     markOutboxEventsProcessed(eventIds: string[]): Promise<void>;
 }
 
-export { type EntityStatus as E, type FormatContextOptions as F, HOOK_TIMEOUT_MARKER as H, ImportExportService as I, JobManager as J, type LLMProvider as L, type MemoryBundle as M, type PromptOverrides as P, type ReadOptions as R, type SQLiteAdapter as S, type VectorRanker as V, type WikiOptions as W, type MemoryDump as a, type FormattedMemoryDump as b, WikiMemory as c, type ExtractedFact as d, type ExtractedTask as e, PromptService as f, PrunePartialFailureError as g, type VectorRankerFallback as h, type VectorRankerRankArgs as i, type VectorRankerSemanticResult as j, WikiBusyError as k, type WikiBusyOperation as l, type WikiCheckpoint as m, type WikiConfig as n, type WikiEvent as o, type WikiFact as p, type WikiMemoryTestAccess as q, type WikiOutboxEvent as r, type WikiTask as s, EmbeddingService as t, IngestionService as u, MaintenanceService as v, RetrievalService as w, SearchService as x, WriteService as y };
+export { type EntityStatus as E, type FormatContextOptions as F, HOOK_TIMEOUT_MARKER as H, ImportExportService as I, JobManager as J, type LLMProvider as L, type MemoryBundle as M, type PromptOverrides as P, type ReadOptions as R, type SQLiteAdapter as S, type VectorRanker as V, type WikiOptions as W, type MemoryDump as a, type FormattedMemoryDump as b, WikiMemory as c, type ExtractedFact as d, type ExtractedTask as e, PromptService as f, PrunePartialFailureError as g, type VectorRankerFallback as h, type VectorRankerRankArgs as i, type VectorRankerSemanticResult as j, WikiBusyError as k, type WikiBusyOperation as l, type WikiCheckpoint as m, type WikiConfig as n, type WikiEdge as o, type WikiEvent as p, type WikiFact as q, type WikiMemoryTestAccess as r, type WikiOutboxEvent as s, type WikiTask as t, EmbeddingService as u, IngestionService as v, MaintenanceService as w, RetrievalService as x, SearchService as y, WriteService as z };

package/dist/testing.d.mts

@@ -1,2 +1,2 @@
-export { t as EmbeddingService, I as ImportExportService, u as IngestionService, J as JobManager, J as JobManagerType, v as MaintenanceService, w as RetrievalService, x as SearchService, x as SearchServiceType, q as WikiMemoryTestAccess, y as WriteService } from './testing-DW1qufP0.mjs';
+export { u as EmbeddingService, I as ImportExportService, v as IngestionService, J as JobManager, J as JobManagerType, w as MaintenanceService, x as RetrievalService, y as SearchService, y as SearchServiceType, r as WikiMemoryTestAccess, z as WriteService } from './testing-NH1_Aigh.mjs';
 import 'minisearch';

package/dist/testing.d.ts

@@ -1,2 +1,2 @@
-export { t as EmbeddingService, I as ImportExportService, u as IngestionService, J as JobManager, J as JobManagerType, v as MaintenanceService, w as RetrievalService, x as SearchService, x as SearchServiceType, q as WikiMemoryTestAccess, y as WriteService } from './testing-DW1qufP0.js';
+export { u as EmbeddingService, I as ImportExportService, v as IngestionService, J as JobManager, J as JobManagerType, w as MaintenanceService, x as RetrievalService, y as SearchService, y as SearchServiceType, r as WikiMemoryTestAccess, z as WriteService } from './testing-NH1_Aigh.js';
 import 'minisearch';

package/dist/testing.js

@@ -374,11 +374,12 @@ 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;
@@ -423,10 +424,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 {
@@ -445,7 +447,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) {
@@ -467,6 +469,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);
@@ -564,7 +567,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) {
@@ -613,7 +617,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
@@ -637,6 +642,19 @@ 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) {
@@ -1493,7 +1511,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;
@@ -1883,7 +1901,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;