@equationalapplications/core-llm-wiki 4.14.0 → 4.15.0

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

@@ -22,6 +22,12 @@ interface PromptOverrides {
     healSystemPrompt?: string;
 }
 interface WikiConfig {
+    /**
+     * Prefix applied to every SQL table/index/trigger name. Must match
+     * `^[A-Za-z][A-Za-z0-9_]{0,30}_$` (letter, then alphanumeric/underscore,
+     * ending in `_`, max 32 chars total) — enforced in the `WikiMemory` constructor.
+     * Default: `'llm_wiki_'`.
+     */
     tablePrefix?: string;
     maxResults?: number;
     /** @deprecated Use maxResults */
@@ -117,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;
@@ -128,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;
@@ -137,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;
@@ -303,6 +325,7 @@ interface MemoryBundle {
     facts: WikiFact[];
     tasks: WikiTask[];
     events: WikiEvent[];
+    edges?: WikiEdge[];
     factScores?: Record<string, number>;
     metadata?: {
         query: string;
@@ -696,6 +719,13 @@ declare class JobManager {
     private _forgetKey;
     private _librarianKey;
     private _healKey;
+    /**
+     * 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.
+     */
+    private readonly lockKeyFns;
     private _isReembedActive;
     private _isImportActiveFor;
     private _isForgetActiveFor;
@@ -939,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;
@@ -1004,11 +1046,12 @@ declare class RetrievalService {
 declare class WriteService {
     private db;
     private options;
+    private entryRepo;
     private eventRepo;
     private metadataRepo;
     private jobManager;
     private maintenanceService;
-    constructor(db: SQLiteAdapter, options: WikiOptions, eventRepo: EventRepository, metadataRepo: MetadataRepository, jobManager: JobManager, maintenanceService: MaintenanceService);
+    constructor(db: SQLiteAdapter, options: WikiOptions, entryRepo: EntryRepository, eventRepo: EventRepository, metadataRepo: MetadataRepository, jobManager: JobManager, maintenanceService: MaintenanceService);
     write(entityId: string, event: Omit<WikiEvent, 'id' | 'entity_id' | 'created_at'>): Promise<void>;
     private runLibrarianThenMaybeHeal;
 }
@@ -1036,6 +1079,7 @@ declare class WikiMemory {
     private outboxRepo;
     private taskRepo;
     private eventRepo;
+    private edgeRepo;
     private metadataRepo;
     private embeddingService;
     private searchService;
@@ -1138,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-CDIDE4Jd.d.ts → testing-NH1_Aigh.d.ts}

@@ -22,6 +22,12 @@ interface PromptOverrides {
     healSystemPrompt?: string;
 }
 interface WikiConfig {
+    /**
+     * Prefix applied to every SQL table/index/trigger name. Must match
+     * `^[A-Za-z][A-Za-z0-9_]{0,30}_$` (letter, then alphanumeric/underscore,
+     * ending in `_`, max 32 chars total) — enforced in the `WikiMemory` constructor.
+     * Default: `'llm_wiki_'`.
+     */
     tablePrefix?: string;
     maxResults?: number;
     /** @deprecated Use maxResults */
@@ -117,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;
@@ -128,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;
@@ -137,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;
@@ -303,6 +325,7 @@ interface MemoryBundle {
     facts: WikiFact[];
     tasks: WikiTask[];
     events: WikiEvent[];
+    edges?: WikiEdge[];
     factScores?: Record<string, number>;
     metadata?: {
         query: string;
@@ -696,6 +719,13 @@ declare class JobManager {
     private _forgetKey;
     private _librarianKey;
     private _healKey;
+    /**
+     * 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.
+     */
+    private readonly lockKeyFns;
     private _isReembedActive;
     private _isImportActiveFor;
     private _isForgetActiveFor;
@@ -939,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;
@@ -1004,11 +1046,12 @@ declare class RetrievalService {
 declare class WriteService {
     private db;
     private options;
+    private entryRepo;
     private eventRepo;
     private metadataRepo;
     private jobManager;
     private maintenanceService;
-    constructor(db: SQLiteAdapter, options: WikiOptions, eventRepo: EventRepository, metadataRepo: MetadataRepository, jobManager: JobManager, maintenanceService: MaintenanceService);
+    constructor(db: SQLiteAdapter, options: WikiOptions, entryRepo: EntryRepository, eventRepo: EventRepository, metadataRepo: MetadataRepository, jobManager: JobManager, maintenanceService: MaintenanceService);
     write(entityId: string, event: Omit<WikiEvent, 'id' | 'entity_id' | 'created_at'>): Promise<void>;
     private runLibrarianThenMaybeHeal;
 }
@@ -1036,6 +1079,7 @@ declare class WikiMemory {
     private outboxRepo;
     private taskRepo;
     private eventRepo;
+    private edgeRepo;
     private metadataRepo;
     private embeddingService;
     private searchService;
@@ -1138,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-CDIDE4Jd.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-CDIDE4Jd.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';