@equationalapplications/core-llm-wiki 7.5.0 → 7.6.0

package/dist/{testing-ClpOUiLI.d.mts → testing-d1SrpDvg.d.mts}

@@ -215,6 +215,23 @@ interface HealResult {
     /** Heal candidates inside the recheck cooldown. */
     deferred: number;
 }
+/**
+ * Opt-in evidence check for LLM-authored facts (spec §6). Default off: 7.x
+ * write behavior is unchanged. In `'draft'` mode, writers in `writers` must
+ * quote their source; a fact whose quotes are missing or not found is stored
+ * as a `draft` instead of being rejected.
+ */
+interface GroundingConfig {
+    mode: 'off' | 'draft';
+    /** Default `['ingest']`. The librarian and heal synthesize across events; measure their pass rates before opting them in. */
+    writers?: Array<'ingest' | 'librarian' | 'heal'>;
+    /** Quotes shorter than this (after whitespace normalization) count as absent. Default 20. */
+    minEvidenceChars?: number;
+    /** Quotes retained per fact. Retention only; every quote is checked. Default 3. */
+    maxEvidence?: number;
+    /** Characters retained per quote. Default 300. */
+    maxEvidenceChars?: number;
+}
 interface WikiConfig {
     /**
      * Prefix applied to every SQL table/index/trigger name. Must match
@@ -282,6 +299,8 @@ interface WikiConfig {
      * `GraphTraversalOptions.excludeDrafts`. Default false (drafts visible).
      */
     excludeDrafts?: boolean;
+    /** Evidence check for LLM-authored facts (spec §6). Default off. */
+    grounding?: GroundingConfig;
 }
 interface ReadOptions {
     maxResults?: number;
@@ -493,6 +512,8 @@ interface ExtractedFact {
     body: string;
     tags: string[];
     confidence: 'certain' | 'inferred' | 'tentative';
+    /** Quotes the model copied from its source; see `WikiConfig.grounding`. Never persisted. */
+    evidence?: string[];
 }
 interface ExtractedFactWithOntology extends ExtractedFact {
     okf_type?: string;
@@ -1227,10 +1248,14 @@ declare class EntryRepository extends BaseRepository {
      * fact, not only immutable_document rows, so the source-type restriction has
      * to be applied here, after retrieval.
      */
-    findAnchorRowsByIds(entityId: string, ids: readonly string[], tx?: SQLiteAdapter): Promise<Array<{
+    findAnchorRowsByIds(entityId: string, ids: readonly string[], tx?: SQLiteAdapter, opts?: {
+        withBody?: boolean;
+    }): Promise<Array<{
         id: string;
         title: string;
         source_ref: string | null;
+        body?: string;
+        lifecycle_status?: string;
     }>>;
     /**
      * Fetch recent non-deleted entries for an entity (limited), ordered by updated_at DESC.
@@ -1991,9 +2016,29 @@ declare class OntologyService {
     resolveAndPersistEdges(entityId: string, sourceId: string, sourceType: string | null, edges: ExtractedFactEdge[], manifest: OntologyManifest, titleIndex: Map<string, TitleIndexEntry>, tx: SQLiteAdapter, now: number, drops?: EdgeDrop[]): Promise<number>;
 }
 
+type GroundingWriter = 'ingest' | 'librarian' | 'heal';
+interface ResolvedGrounding {
+    writers: ReadonlySet<GroundingWriter>;
+    minEvidenceChars: number;
+    maxEvidence: number;
+    maxEvidenceChars: number;
+}
+/** Insert-time trust fields. Spread onto a new `WikiFact`; `EntryRepository.upsert` writes them on INSERT only. */
+interface GroundingTrust {
+    lifecycle_status: 'stable' | 'draft';
+    okf_verified?: OkfVerifiedEntry[];
+    last_verified_at?: number;
+    last_verified_by?: string;
+}
+
 declare class PromptService {
     private globalOverrides?;
-    constructor(globalOverrides?: PromptOverrides | undefined);
+    private grounding;
+    constructor(globalOverrides?: PromptOverrides | undefined, grounding?: ResolvedGrounding | null);
+    /** The resolved grounding config when `writer` is in `grounding.writers`; otherwise null (spec §6.2). */
+    groundingFor(writer: GroundingWriter): ResolvedGrounding | null;
+    /** Appended after any override and after ontology context, so it is always last. */
+    private appendGrounding;
     private hydrate;
     private hasOntologyPlaceholders;
     private buildSystemPrompt;
@@ -2005,6 +2050,7 @@ declare class PromptService {
     buildLibrarianPrompt(events: unknown[], currentFacts: unknown[], runtimeOverride?: string, ontologyContext?: OntologyPromptContext | null): {
         systemPrompt: string;
         userPrompt: string;
+        groundingCorpus?: string[];
     };
     /**
      * Heal-prompt level interpretation for the `attemptLevel` ladder.
@@ -2034,6 +2080,7 @@ declare class PromptService {
             userPrompt: string;
         };
         degraded: DegradedRecord[];
+        groundingCorpus?: string[];
     };
     buildOntologyBackfillPrompt(facts: unknown[], runtimeOverride?: string, ontologyContext?: OntologyPromptContext | null): {
         systemPrompt: string;
@@ -2140,6 +2187,8 @@ declare class IngestionService {
             buffer: DiagnosticBuffer;
             operation: 'ingest' | 'upsertGraph';
         };
+        /** Insert-time trust by node id. Ingest-only (spec §6.5); the public upsertGraph never passes it, so host nodes are never grounded. */
+        nodeTrust?: ReadonlyMap<string, GroundingTrust>;
     }): Promise<{
         nodesWritten: number;
         edgesWritten: number;
@@ -2942,4 +2991,4 @@ declare class WikiMemory {
     setGeneratedByTask(taskId: string, entityId: string, actor: string): Promise<void>;
 }
 
-export { type WikiConfig as $, type OntologyNodeType as A, type OntologyPromptContext as B, type ChunkFailure as C, type DegradedRecord as D, type EmbedFactResult as E, type FormatContextOptions as F, type GraphNeighborhood as G, HEAL_BATCH_SIZE as H, type IngestDocumentResult as I, type OntologyUpdates as J, PromptService as K, type LLMProvider as L, type MemoryBundle as M, PrunePartialFailureError as N, ONTOLOGY_BACKFILL_BATCH_SIZE as O, type PromptOverrides as P, type ReembedResult as Q, type ReadOptions as R, type SQLiteAdapter as S, type VectorRankerFallback as T, type VectorRankerRankArgs as U, type VectorRanker as V, type WikiOptions as W, type VectorRankerSemanticResult as X, WikiBusyError as Y, type WikiBusyOperation as Z, type WikiCheckpoint as _, type MemoryDump as a, type WikiDiagnostic as a0, type WikiDiagnosticCode as a1, type WikiDiagnosticDetail as a2, type WikiDiagnosticOperation as a3, type WikiDiagnosticSeverity as a4, type WikiDiagnosticTrigger as a5, WikiDraftNotFound as a6, WikiDuplicateHashError as a7, type WikiEdge as a8, type WikiEvent as a9, type WikiFact as aa, WikiGraphNodeOwnershipConflict as ab, WikiIngestEmptyError as ac, WikiInvalidReadOptions as ad, type WikiMemoryTestAccess as ae, type WikiOutboxEvent as af, WikiParseError as ag, WikiSourceRefHashCollision as ah, WikiStrictOntologyViolation as ai, type WikiTask as aj, WikiTransactionError as ak, validateManifest as al, EmbeddingService as am, ImportExportService as an, IngestionService as ao, JobManager as ap, MaintenanceService as aq, RetrievalService as ar, SearchService as as, WriteService as at, type FormattedMemoryDump as b, WikiMemory as c, type ClassifierAnswer as d, type ClassifierQuestion as e, type ClassifyRequest as f, type ClassifyResponse as g, type DraftPage as h, type EmbedFailureKind as i, type EmbeddingMarkerKind as j, type EntityStatus as k, type ExtractedFact as l, type ExtractedFactEdge as m, type ExtractedFactWithOntology as n, type ExtractedTask as o, type GraphTraversalOptions as p, HEAL_RECHECK_MS as q, HOOK_TIMEOUT_MARKER as r, type HealResult as s, ONTOLOGY_BACKFILL_MAX_PROMPT_CHARS as t, ONTOLOGY_BACKFILL_RECHECK_MS as u, type OntologyBackfillResult as v, type OntologyConfig as w, type OntologyEdgeType as x, type OntologyManifest as y, type OntologyMode as z };
+export { type WikiCheckpoint as $, type OntologyMode as A, type OntologyNodeType as B, type ChunkFailure as C, type DegradedRecord as D, type EmbedFactResult as E, type FormatContextOptions as F, type GraphNeighborhood as G, HEAL_BATCH_SIZE as H, type IngestDocumentResult as I, type OntologyPromptContext as J, type OntologyUpdates as K, type LLMProvider as L, type MemoryBundle as M, PromptService as N, ONTOLOGY_BACKFILL_BATCH_SIZE as O, type PromptOverrides as P, PrunePartialFailureError as Q, type ReadOptions as R, type SQLiteAdapter as S, type ReembedResult as T, type VectorRankerFallback as U, type VectorRanker as V, type WikiOptions as W, type VectorRankerRankArgs as X, type VectorRankerSemanticResult as Y, WikiBusyError as Z, type WikiBusyOperation as _, type MemoryDump as a, type WikiConfig as a0, type WikiDiagnostic as a1, type WikiDiagnosticCode as a2, type WikiDiagnosticDetail as a3, type WikiDiagnosticOperation as a4, type WikiDiagnosticSeverity as a5, type WikiDiagnosticTrigger as a6, WikiDraftNotFound as a7, WikiDuplicateHashError as a8, type WikiEdge as a9, type WikiEvent as aa, type WikiFact as ab, WikiGraphNodeOwnershipConflict as ac, WikiIngestEmptyError as ad, WikiInvalidReadOptions as ae, type WikiMemoryTestAccess as af, type WikiOutboxEvent as ag, WikiParseError as ah, WikiSourceRefHashCollision as ai, WikiStrictOntologyViolation as aj, type WikiTask as ak, WikiTransactionError as al, validateManifest as am, EmbeddingService as an, ImportExportService as ao, IngestionService as ap, JobManager as aq, MaintenanceService as ar, RetrievalService as as, SearchService as at, WriteService as au, type FormattedMemoryDump as b, WikiMemory as c, type ClassifierAnswer as d, type ClassifierQuestion as e, type ClassifyRequest as f, type ClassifyResponse as g, type DraftPage as h, type EmbedFailureKind as i, type EmbeddingMarkerKind as j, type EntityStatus as k, type ExtractedFact as l, type ExtractedFactEdge as m, type ExtractedFactWithOntology as n, type ExtractedTask as o, type GraphTraversalOptions as p, type GroundingConfig as q, HEAL_RECHECK_MS as r, HOOK_TIMEOUT_MARKER as s, type HealResult as t, ONTOLOGY_BACKFILL_MAX_PROMPT_CHARS as u, ONTOLOGY_BACKFILL_RECHECK_MS as v, type OntologyBackfillResult as w, type OntologyConfig as x, type OntologyEdgeType as y, type OntologyManifest as z };

package/dist/{testing-ClpOUiLI.d.ts → testing-d1SrpDvg.d.ts}

@@ -215,6 +215,23 @@ interface HealResult {
     /** Heal candidates inside the recheck cooldown. */
     deferred: number;
 }
+/**
+ * Opt-in evidence check for LLM-authored facts (spec §6). Default off: 7.x
+ * write behavior is unchanged. In `'draft'` mode, writers in `writers` must
+ * quote their source; a fact whose quotes are missing or not found is stored
+ * as a `draft` instead of being rejected.
+ */
+interface GroundingConfig {
+    mode: 'off' | 'draft';
+    /** Default `['ingest']`. The librarian and heal synthesize across events; measure their pass rates before opting them in. */
+    writers?: Array<'ingest' | 'librarian' | 'heal'>;
+    /** Quotes shorter than this (after whitespace normalization) count as absent. Default 20. */
+    minEvidenceChars?: number;
+    /** Quotes retained per fact. Retention only; every quote is checked. Default 3. */
+    maxEvidence?: number;
+    /** Characters retained per quote. Default 300. */
+    maxEvidenceChars?: number;
+}
 interface WikiConfig {
     /**
      * Prefix applied to every SQL table/index/trigger name. Must match
@@ -282,6 +299,8 @@ interface WikiConfig {
      * `GraphTraversalOptions.excludeDrafts`. Default false (drafts visible).
      */
     excludeDrafts?: boolean;
+    /** Evidence check for LLM-authored facts (spec §6). Default off. */
+    grounding?: GroundingConfig;
 }
 interface ReadOptions {
     maxResults?: number;
@@ -493,6 +512,8 @@ interface ExtractedFact {
     body: string;
     tags: string[];
     confidence: 'certain' | 'inferred' | 'tentative';
+    /** Quotes the model copied from its source; see `WikiConfig.grounding`. Never persisted. */
+    evidence?: string[];
 }
 interface ExtractedFactWithOntology extends ExtractedFact {
     okf_type?: string;
@@ -1227,10 +1248,14 @@ declare class EntryRepository extends BaseRepository {
      * fact, not only immutable_document rows, so the source-type restriction has
      * to be applied here, after retrieval.
      */
-    findAnchorRowsByIds(entityId: string, ids: readonly string[], tx?: SQLiteAdapter): Promise<Array<{
+    findAnchorRowsByIds(entityId: string, ids: readonly string[], tx?: SQLiteAdapter, opts?: {
+        withBody?: boolean;
+    }): Promise<Array<{
         id: string;
         title: string;
         source_ref: string | null;
+        body?: string;
+        lifecycle_status?: string;
     }>>;
     /**
      * Fetch recent non-deleted entries for an entity (limited), ordered by updated_at DESC.
@@ -1991,9 +2016,29 @@ declare class OntologyService {
     resolveAndPersistEdges(entityId: string, sourceId: string, sourceType: string | null, edges: ExtractedFactEdge[], manifest: OntologyManifest, titleIndex: Map<string, TitleIndexEntry>, tx: SQLiteAdapter, now: number, drops?: EdgeDrop[]): Promise<number>;
 }
 
+type GroundingWriter = 'ingest' | 'librarian' | 'heal';
+interface ResolvedGrounding {
+    writers: ReadonlySet<GroundingWriter>;
+    minEvidenceChars: number;
+    maxEvidence: number;
+    maxEvidenceChars: number;
+}
+/** Insert-time trust fields. Spread onto a new `WikiFact`; `EntryRepository.upsert` writes them on INSERT only. */
+interface GroundingTrust {
+    lifecycle_status: 'stable' | 'draft';
+    okf_verified?: OkfVerifiedEntry[];
+    last_verified_at?: number;
+    last_verified_by?: string;
+}
+
 declare class PromptService {
     private globalOverrides?;
-    constructor(globalOverrides?: PromptOverrides | undefined);
+    private grounding;
+    constructor(globalOverrides?: PromptOverrides | undefined, grounding?: ResolvedGrounding | null);
+    /** The resolved grounding config when `writer` is in `grounding.writers`; otherwise null (spec §6.2). */
+    groundingFor(writer: GroundingWriter): ResolvedGrounding | null;
+    /** Appended after any override and after ontology context, so it is always last. */
+    private appendGrounding;
     private hydrate;
     private hasOntologyPlaceholders;
     private buildSystemPrompt;
@@ -2005,6 +2050,7 @@ declare class PromptService {
     buildLibrarianPrompt(events: unknown[], currentFacts: unknown[], runtimeOverride?: string, ontologyContext?: OntologyPromptContext | null): {
         systemPrompt: string;
         userPrompt: string;
+        groundingCorpus?: string[];
     };
     /**
      * Heal-prompt level interpretation for the `attemptLevel` ladder.
@@ -2034,6 +2080,7 @@ declare class PromptService {
             userPrompt: string;
         };
         degraded: DegradedRecord[];
+        groundingCorpus?: string[];
     };
     buildOntologyBackfillPrompt(facts: unknown[], runtimeOverride?: string, ontologyContext?: OntologyPromptContext | null): {
         systemPrompt: string;
@@ -2140,6 +2187,8 @@ declare class IngestionService {
             buffer: DiagnosticBuffer;
             operation: 'ingest' | 'upsertGraph';
         };
+        /** Insert-time trust by node id. Ingest-only (spec §6.5); the public upsertGraph never passes it, so host nodes are never grounded. */
+        nodeTrust?: ReadonlyMap<string, GroundingTrust>;
     }): Promise<{
         nodesWritten: number;
         edgesWritten: number;
@@ -2942,4 +2991,4 @@ declare class WikiMemory {
     setGeneratedByTask(taskId: string, entityId: string, actor: string): Promise<void>;
 }
 
-export { type WikiConfig as $, type OntologyNodeType as A, type OntologyPromptContext as B, type ChunkFailure as C, type DegradedRecord as D, type EmbedFactResult as E, type FormatContextOptions as F, type GraphNeighborhood as G, HEAL_BATCH_SIZE as H, type IngestDocumentResult as I, type OntologyUpdates as J, PromptService as K, type LLMProvider as L, type MemoryBundle as M, PrunePartialFailureError as N, ONTOLOGY_BACKFILL_BATCH_SIZE as O, type PromptOverrides as P, type ReembedResult as Q, type ReadOptions as R, type SQLiteAdapter as S, type VectorRankerFallback as T, type VectorRankerRankArgs as U, type VectorRanker as V, type WikiOptions as W, type VectorRankerSemanticResult as X, WikiBusyError as Y, type WikiBusyOperation as Z, type WikiCheckpoint as _, type MemoryDump as a, type WikiDiagnostic as a0, type WikiDiagnosticCode as a1, type WikiDiagnosticDetail as a2, type WikiDiagnosticOperation as a3, type WikiDiagnosticSeverity as a4, type WikiDiagnosticTrigger as a5, WikiDraftNotFound as a6, WikiDuplicateHashError as a7, type WikiEdge as a8, type WikiEvent as a9, type WikiFact as aa, WikiGraphNodeOwnershipConflict as ab, WikiIngestEmptyError as ac, WikiInvalidReadOptions as ad, type WikiMemoryTestAccess as ae, type WikiOutboxEvent as af, WikiParseError as ag, WikiSourceRefHashCollision as ah, WikiStrictOntologyViolation as ai, type WikiTask as aj, WikiTransactionError as ak, validateManifest as al, EmbeddingService as am, ImportExportService as an, IngestionService as ao, JobManager as ap, MaintenanceService as aq, RetrievalService as ar, SearchService as as, WriteService as at, type FormattedMemoryDump as b, WikiMemory as c, type ClassifierAnswer as d, type ClassifierQuestion as e, type ClassifyRequest as f, type ClassifyResponse as g, type DraftPage as h, type EmbedFailureKind as i, type EmbeddingMarkerKind as j, type EntityStatus as k, type ExtractedFact as l, type ExtractedFactEdge as m, type ExtractedFactWithOntology as n, type ExtractedTask as o, type GraphTraversalOptions as p, HEAL_RECHECK_MS as q, HOOK_TIMEOUT_MARKER as r, type HealResult as s, ONTOLOGY_BACKFILL_MAX_PROMPT_CHARS as t, ONTOLOGY_BACKFILL_RECHECK_MS as u, type OntologyBackfillResult as v, type OntologyConfig as w, type OntologyEdgeType as x, type OntologyManifest as y, type OntologyMode as z };
+export { type WikiCheckpoint as $, type OntologyMode as A, type OntologyNodeType as B, type ChunkFailure as C, type DegradedRecord as D, type EmbedFactResult as E, type FormatContextOptions as F, type GraphNeighborhood as G, HEAL_BATCH_SIZE as H, type IngestDocumentResult as I, type OntologyPromptContext as J, type OntologyUpdates as K, type LLMProvider as L, type MemoryBundle as M, PromptService as N, ONTOLOGY_BACKFILL_BATCH_SIZE as O, type PromptOverrides as P, PrunePartialFailureError as Q, type ReadOptions as R, type SQLiteAdapter as S, type ReembedResult as T, type VectorRankerFallback as U, type VectorRanker as V, type WikiOptions as W, type VectorRankerRankArgs as X, type VectorRankerSemanticResult as Y, WikiBusyError as Z, type WikiBusyOperation as _, type MemoryDump as a, type WikiConfig as a0, type WikiDiagnostic as a1, type WikiDiagnosticCode as a2, type WikiDiagnosticDetail as a3, type WikiDiagnosticOperation as a4, type WikiDiagnosticSeverity as a5, type WikiDiagnosticTrigger as a6, WikiDraftNotFound as a7, WikiDuplicateHashError as a8, type WikiEdge as a9, type WikiEvent as aa, type WikiFact as ab, WikiGraphNodeOwnershipConflict as ac, WikiIngestEmptyError as ad, WikiInvalidReadOptions as ae, type WikiMemoryTestAccess as af, type WikiOutboxEvent as ag, WikiParseError as ah, WikiSourceRefHashCollision as ai, WikiStrictOntologyViolation as aj, type WikiTask as ak, WikiTransactionError as al, validateManifest as am, EmbeddingService as an, ImportExportService as ao, IngestionService as ap, JobManager as aq, MaintenanceService as ar, RetrievalService as as, SearchService as at, WriteService as au, type FormattedMemoryDump as b, WikiMemory as c, type ClassifierAnswer as d, type ClassifierQuestion as e, type ClassifyRequest as f, type ClassifyResponse as g, type DraftPage as h, type EmbedFailureKind as i, type EmbeddingMarkerKind as j, type EntityStatus as k, type ExtractedFact as l, type ExtractedFactEdge as m, type ExtractedFactWithOntology as n, type ExtractedTask as o, type GraphTraversalOptions as p, type GroundingConfig as q, HEAL_RECHECK_MS as r, HOOK_TIMEOUT_MARKER as s, type HealResult as t, ONTOLOGY_BACKFILL_MAX_PROMPT_CHARS as u, ONTOLOGY_BACKFILL_RECHECK_MS as v, type OntologyBackfillResult as w, type OntologyConfig as x, type OntologyEdgeType as y, type OntologyManifest as z };

package/dist/testing.d.mts

@@ -1,3 +1,3 @@
-export { am as EmbeddingService, an as ImportExportService, ao as IngestionService, ap as JobManager, ap as JobManagerType, aq as MaintenanceService, ar as RetrievalService, as as SearchService, as as SearchServiceType, ae as WikiMemoryTestAccess, at as WriteService } from './testing-ClpOUiLI.mjs';
+export { an as EmbeddingService, ao as ImportExportService, ap as IngestionService, aq as JobManager, aq as JobManagerType, ar as MaintenanceService, as as RetrievalService, at as SearchService, at as SearchServiceType, af as WikiMemoryTestAccess, au as WriteService } from './testing-d1SrpDvg.mjs';
 import '@equationalapplications/core-okf';
 import 'minisearch';

package/dist/testing.d.ts

@@ -1,3 +1,3 @@
-export { am as EmbeddingService, an as ImportExportService, ao as IngestionService, ap as JobManager, ap as JobManagerType, aq as MaintenanceService, ar as RetrievalService, as as SearchService, as as SearchServiceType, ae as WikiMemoryTestAccess, at as WriteService } from './testing-ClpOUiLI.js';
+export { an as EmbeddingService, ao as ImportExportService, ap as IngestionService, aq as JobManager, aq as JobManagerType, ar as MaintenanceService, as as RetrievalService, at as SearchService, at as SearchServiceType, af as WikiMemoryTestAccess, au as WriteService } from './testing-d1SrpDvg.js';
 import '@equationalapplications/core-okf';
 import 'minisearch';