@equationalapplications/core-llm-wiki 7.3.0 → 7.4.0

package/dist/{testing-ht1qOvcD.d.mts → testing-Dmh1kfkd.d.mts}

@@ -269,6 +269,11 @@ interface WikiConfig {
     traversalDirection?: 'inbound' | 'outbound' | 'both';
     /** Default source_type dead-end list for discovered traversal nodes. Default []. */
     excludeSourceTypes?: Array<WikiFact['source_type']>;
+    /**
+     * Engine default for `ReadOptions.excludeDrafts` and
+     * `GraphTraversalOptions.excludeDrafts`. Default false (drafts visible).
+     */
+    excludeDrafts?: boolean;
 }
 interface ReadOptions {
     maxResults?: number;
@@ -309,6 +314,12 @@ interface ReadOptions {
      * by `tierWeights: 0`, or a floor keyed to an entity not in `entityId`.
      */
     tierFloors?: Record<string, number>;
+    /**
+     * When true, facts whose `lifecycle_status` is `'draft'` are excluded before
+     * `maxResults`, `tierFloors` and every other cut, on every read path.
+     * Resolves call → `WikiConfig.excludeDrafts` → false.
+     */
+    excludeDrafts?: boolean;
 }
 interface WikiFact {
     id: string;
@@ -451,6 +462,12 @@ interface GraphTraversalOptions {
     minTraversalConfidence?: 'certain' | 'inferred' | 'tentative';
     /** source_type values to dead-end on for *discovered* nodes. Does not gate the anchor. Default []. */
     excludeSourceTypes?: Array<WikiFact['source_type']>;
+    /**
+     * When true, draft facts are dead ends for *discovered* nodes (not
+     * discovered, not traversed through). Does not gate the anchor.
+     * Resolves call → `WikiConfig.excludeDrafts` → false.
+     */
+    excludeDrafts?: boolean;
 }
 interface GraphNeighborhood {
     /** Anchor node first, then discovered neighbors ordered by depth ASC, then updated_at DESC. */
@@ -942,6 +959,22 @@ declare class WikiInvalidReadOptions extends Error {
     readonly reason: string;
     constructor(field: string, reason: string);
 }
+/**
+ * Thrown by `promoteDraft` when no live draft with that id exists for the
+ * entity: missing, soft-deleted, owned by another entity, or not a draft.
+ * Contextless for the same reason as {@link WikiGraphNodeOwnershipConflict}.
+ * The `WIKI_` code keeps it clear of `extractSqliteCode`, so it passes through
+ * the serialized transaction wrapper unwrapped.
+ */
+declare class WikiDraftNotFound extends Error {
+    readonly code: "WIKI_DRAFT_NOT_FOUND";
+    constructor();
+}
+/** One page of `listDrafts`. `nextCursor` is opaque; pass it back unchanged. */
+interface DraftPage {
+    facts: WikiFact[];
+    nextCursor: string | null;
+}
 
 interface WikiOutboxEvent<T = unknown> {
     id: string;
@@ -1317,7 +1350,18 @@ declare class EntryRepository extends BaseRepository {
     }>>;
     trackAccess(ids: readonly string[], now: number, tx?: SQLiteAdapter): Promise<void>;
     getLegacyMigrationSQL(): string;
-    findRecentByEntityIds(entityIds: readonly string[], limit: number, tx?: SQLiteAdapter): Promise<WikiFact[]>;
+    findRecentByEntityIds(entityIds: readonly string[], limit: number, tx?: SQLiteAdapter, opts?: {
+        excludeDrafts?: boolean;
+    }): Promise<WikiFact[]>;
+    /** IDs of live draft facts for the given entities (spec §5.1). Callers pass ≤ 100 entity ids. */
+    findDraftIdsByEntityIds(entityIds: readonly string[], tx?: SQLiteAdapter): Promise<Set<string>>;
+    /** Live drafts for one entity, newest first, keyset-paged by (created_at, id). */
+    listDraftsByEntityId(entityId: string, limit: number, after: {
+        createdAt: number;
+        id: string;
+    } | null, tx?: SQLiteAdapter): Promise<WikiFact[]>;
+    /** True iff `entryId` is a live draft owned by `entityId`. */
+    isLiveDraft(entryId: string, entityId: string, tx?: SQLiteAdapter): Promise<boolean>;
     /**
      * Live untyped facts eligible for ontology backfill, oldest first.
      * Skips facts checked within the recheck cooldown (ontology_checked_at > recheckCutoff).
@@ -1725,6 +1769,14 @@ interface NeighborhoodQueryOptions {
     minConfidence: 'certain' | 'inferred' | 'tentative';
     excludeSourceTypes: string[];
     maxNodes: number;
+    /**
+     * When true, draft facts are dead-ends for *discovered* nodes — the recursive
+     * walk will not step onto a draft, and will not step *past* one either, since
+     * a draft's neighbours are unreachable through it. The anchor node is exempt
+     * (it is validated up-front and never gated by this flag), so callers can
+     * intentionally start from a draft. Default false (drafts visible).
+     */
+    excludeDrafts?: boolean;
 }
 declare class EdgeRepository extends BaseRepository {
     /**
@@ -2374,6 +2426,7 @@ declare class RetrievalService {
      * Stable tie-break sort: score desc → access_count desc → updated_at desc → id asc.
      */
     private _tieBreakSort;
+    private _withoutDrafts;
     /**
      * Comparator for score + deterministic tie-break fields.
      * Negative return means "a ranks ahead of b" for descending score order.
@@ -2787,6 +2840,25 @@ declare class WikiMemory {
     }>): Promise<void>;
     /** Set a fact's OKF v0.2 lifecycle status. Does NOT touch `updated_at`. */
     setLifecycleStatus(entryId: string, entityId: string, status: 'draft' | 'stable' | 'deprecated'): Promise<void>;
+    /**
+     * Live draft facts for one entity, newest first (spec §5.2). Default page
+     * size 50, clamped to [1, 500]. Pass `nextCursor` back unchanged for the next page.
+     */
+    listDrafts(entityId: string, options?: {
+        limit?: number;
+        cursor?: string;
+    }): Promise<DraftPage>;
+    /**
+     * Promote a draft to `stable` and record who reviewed it, atomically
+     * (spec §5.2). Metadata writes only: `updated_at` is not bumped and no
+     * outbox event is pushed. Pass `by: 'human:<id>'` so `trustTier` becomes
+     * `'human-reviewed'`.
+     *
+     * @throws WikiDraftNotFound when no live draft with that id exists for the entity.
+     */
+    promoteDraft(entryId: string, entityId: string, reviewer: {
+        by: string;
+    }): Promise<void>;
     /** Set a fact's stale_after (epoch ms) or clear it. Does NOT touch `updated_at`. */
     setStaleAfter(entryId: string, entityId: string, date: number | null): Promise<void>;
     /** Set a fact's generated_by actor string. Does NOT touch `updated_at`. */
@@ -2805,4 +2877,4 @@ declare class WikiMemory {
     setGeneratedByTask(taskId: string, entityId: string, actor: string): Promise<void>;
 }
 
-export { type WikiDiagnosticSeverity as $, type ReembedResult as A, type VectorRankerFallback 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 VectorRankerRankArgs as J, type VectorRankerSemanticResult as K, type LLMProvider as L, type MemoryBundle as M, WikiBusyError as N, ONTOLOGY_BACKFILL_BATCH_SIZE as O, type PromptOverrides as P, type WikiBusyOperation as Q, type ReadOptions as R, type SQLiteAdapter as S, type WikiCheckpoint as T, type WikiConfig as U, type VectorRanker as V, type WikiOptions as W, type WikiDiagnostic as X, type WikiDiagnosticCode as Y, type WikiDiagnosticDetail as Z, type WikiDiagnosticOperation as _, type MemoryDump as a, type WikiDiagnosticTrigger as a0, WikiDuplicateHashError as a1, type WikiEdge as a2, type WikiEvent as a3, type WikiFact as a4, WikiGraphNodeOwnershipConflict as a5, WikiIngestEmptyError as a6, WikiInvalidReadOptions as a7, type WikiMemoryTestAccess as a8, type WikiOutboxEvent as a9, WikiParseError as aa, WikiSourceRefHashCollision as ab, WikiStrictOntologyViolation as ac, type WikiTask as ad, WikiTransactionError as ae, validateManifest as af, EmbeddingService as ag, ImportExportService as ah, IngestionService as ai, JobManager as aj, MaintenanceService as ak, RetrievalService as al, SearchService as am, WriteService as an, type FormattedMemoryDump as b, WikiMemory as c, type EmbedFailureKind as d, type EmbeddingMarkerKind as e, type EntityStatus as f, type ExtractedFact as g, type ExtractedFactEdge as h, type ExtractedFactWithOntology as i, type ExtractedTask as j, type GraphTraversalOptions as k, HEAL_RECHECK_MS as l, HOOK_TIMEOUT_MARKER as m, type HealResult as n, ONTOLOGY_BACKFILL_MAX_PROMPT_CHARS as o, ONTOLOGY_BACKFILL_RECHECK_MS as p, type OntologyBackfillResult as q, type OntologyConfig as r, type OntologyEdgeType as s, type OntologyManifest as t, type OntologyMode as u, type OntologyNodeType as v, type OntologyPromptContext as w, type OntologyUpdates as x, PromptService as y, PrunePartialFailureError as z };
+export { type WikiDiagnosticOperation as $, PrunePartialFailureError as A, type ReembedResult 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 VectorRankerFallback as J, type VectorRankerRankArgs as K, type LLMProvider as L, type MemoryBundle as M, type VectorRankerSemanticResult as N, ONTOLOGY_BACKFILL_BATCH_SIZE as O, type PromptOverrides as P, WikiBusyError as Q, type ReadOptions as R, type SQLiteAdapter as S, type WikiBusyOperation as T, type WikiCheckpoint as U, type VectorRanker as V, type WikiOptions as W, type WikiConfig as X, type WikiDiagnostic as Y, type WikiDiagnosticCode as Z, type WikiDiagnosticDetail as _, type MemoryDump as a, type WikiDiagnosticSeverity as a0, type WikiDiagnosticTrigger as a1, WikiDraftNotFound as a2, WikiDuplicateHashError as a3, type WikiEdge as a4, type WikiEvent as a5, type WikiFact as a6, WikiGraphNodeOwnershipConflict as a7, WikiIngestEmptyError as a8, WikiInvalidReadOptions as a9, type WikiMemoryTestAccess as aa, type WikiOutboxEvent as ab, WikiParseError as ac, WikiSourceRefHashCollision as ad, WikiStrictOntologyViolation as ae, type WikiTask as af, WikiTransactionError as ag, validateManifest as ah, EmbeddingService as ai, ImportExportService as aj, IngestionService as ak, JobManager as al, MaintenanceService as am, RetrievalService as an, SearchService as ao, WriteService as ap, type FormattedMemoryDump as b, WikiMemory as c, type DraftPage as d, type EmbedFailureKind as e, type EmbeddingMarkerKind as f, type EntityStatus as g, type ExtractedFact as h, type ExtractedFactEdge as i, type ExtractedFactWithOntology as j, type ExtractedTask as k, type GraphTraversalOptions as l, HEAL_RECHECK_MS as m, HOOK_TIMEOUT_MARKER as n, type HealResult as o, ONTOLOGY_BACKFILL_MAX_PROMPT_CHARS as p, ONTOLOGY_BACKFILL_RECHECK_MS as q, type OntologyBackfillResult as r, type OntologyConfig as s, type OntologyEdgeType as t, type OntologyManifest as u, type OntologyMode as v, type OntologyNodeType as w, type OntologyPromptContext as x, type OntologyUpdates as y, PromptService as z };

package/dist/{testing-ht1qOvcD.d.ts → testing-Dmh1kfkd.d.ts}

@@ -269,6 +269,11 @@ interface WikiConfig {
     traversalDirection?: 'inbound' | 'outbound' | 'both';
     /** Default source_type dead-end list for discovered traversal nodes. Default []. */
     excludeSourceTypes?: Array<WikiFact['source_type']>;
+    /**
+     * Engine default for `ReadOptions.excludeDrafts` and
+     * `GraphTraversalOptions.excludeDrafts`. Default false (drafts visible).
+     */
+    excludeDrafts?: boolean;
 }
 interface ReadOptions {
     maxResults?: number;
@@ -309,6 +314,12 @@ interface ReadOptions {
      * by `tierWeights: 0`, or a floor keyed to an entity not in `entityId`.
      */
     tierFloors?: Record<string, number>;
+    /**
+     * When true, facts whose `lifecycle_status` is `'draft'` are excluded before
+     * `maxResults`, `tierFloors` and every other cut, on every read path.
+     * Resolves call → `WikiConfig.excludeDrafts` → false.
+     */
+    excludeDrafts?: boolean;
 }
 interface WikiFact {
     id: string;
@@ -451,6 +462,12 @@ interface GraphTraversalOptions {
     minTraversalConfidence?: 'certain' | 'inferred' | 'tentative';
     /** source_type values to dead-end on for *discovered* nodes. Does not gate the anchor. Default []. */
     excludeSourceTypes?: Array<WikiFact['source_type']>;
+    /**
+     * When true, draft facts are dead ends for *discovered* nodes (not
+     * discovered, not traversed through). Does not gate the anchor.
+     * Resolves call → `WikiConfig.excludeDrafts` → false.
+     */
+    excludeDrafts?: boolean;
 }
 interface GraphNeighborhood {
     /** Anchor node first, then discovered neighbors ordered by depth ASC, then updated_at DESC. */
@@ -942,6 +959,22 @@ declare class WikiInvalidReadOptions extends Error {
     readonly reason: string;
     constructor(field: string, reason: string);
 }
+/**
+ * Thrown by `promoteDraft` when no live draft with that id exists for the
+ * entity: missing, soft-deleted, owned by another entity, or not a draft.
+ * Contextless for the same reason as {@link WikiGraphNodeOwnershipConflict}.
+ * The `WIKI_` code keeps it clear of `extractSqliteCode`, so it passes through
+ * the serialized transaction wrapper unwrapped.
+ */
+declare class WikiDraftNotFound extends Error {
+    readonly code: "WIKI_DRAFT_NOT_FOUND";
+    constructor();
+}
+/** One page of `listDrafts`. `nextCursor` is opaque; pass it back unchanged. */
+interface DraftPage {
+    facts: WikiFact[];
+    nextCursor: string | null;
+}
 
 interface WikiOutboxEvent<T = unknown> {
     id: string;
@@ -1317,7 +1350,18 @@ declare class EntryRepository extends BaseRepository {
     }>>;
     trackAccess(ids: readonly string[], now: number, tx?: SQLiteAdapter): Promise<void>;
     getLegacyMigrationSQL(): string;
-    findRecentByEntityIds(entityIds: readonly string[], limit: number, tx?: SQLiteAdapter): Promise<WikiFact[]>;
+    findRecentByEntityIds(entityIds: readonly string[], limit: number, tx?: SQLiteAdapter, opts?: {
+        excludeDrafts?: boolean;
+    }): Promise<WikiFact[]>;
+    /** IDs of live draft facts for the given entities (spec §5.1). Callers pass ≤ 100 entity ids. */
+    findDraftIdsByEntityIds(entityIds: readonly string[], tx?: SQLiteAdapter): Promise<Set<string>>;
+    /** Live drafts for one entity, newest first, keyset-paged by (created_at, id). */
+    listDraftsByEntityId(entityId: string, limit: number, after: {
+        createdAt: number;
+        id: string;
+    } | null, tx?: SQLiteAdapter): Promise<WikiFact[]>;
+    /** True iff `entryId` is a live draft owned by `entityId`. */
+    isLiveDraft(entryId: string, entityId: string, tx?: SQLiteAdapter): Promise<boolean>;
     /**
      * Live untyped facts eligible for ontology backfill, oldest first.
      * Skips facts checked within the recheck cooldown (ontology_checked_at > recheckCutoff).
@@ -1725,6 +1769,14 @@ interface NeighborhoodQueryOptions {
     minConfidence: 'certain' | 'inferred' | 'tentative';
     excludeSourceTypes: string[];
     maxNodes: number;
+    /**
+     * When true, draft facts are dead-ends for *discovered* nodes — the recursive
+     * walk will not step onto a draft, and will not step *past* one either, since
+     * a draft's neighbours are unreachable through it. The anchor node is exempt
+     * (it is validated up-front and never gated by this flag), so callers can
+     * intentionally start from a draft. Default false (drafts visible).
+     */
+    excludeDrafts?: boolean;
 }
 declare class EdgeRepository extends BaseRepository {
     /**
@@ -2374,6 +2426,7 @@ declare class RetrievalService {
      * Stable tie-break sort: score desc → access_count desc → updated_at desc → id asc.
      */
     private _tieBreakSort;
+    private _withoutDrafts;
     /**
      * Comparator for score + deterministic tie-break fields.
      * Negative return means "a ranks ahead of b" for descending score order.
@@ -2787,6 +2840,25 @@ declare class WikiMemory {
     }>): Promise<void>;
     /** Set a fact's OKF v0.2 lifecycle status. Does NOT touch `updated_at`. */
     setLifecycleStatus(entryId: string, entityId: string, status: 'draft' | 'stable' | 'deprecated'): Promise<void>;
+    /**
+     * Live draft facts for one entity, newest first (spec §5.2). Default page
+     * size 50, clamped to [1, 500]. Pass `nextCursor` back unchanged for the next page.
+     */
+    listDrafts(entityId: string, options?: {
+        limit?: number;
+        cursor?: string;
+    }): Promise<DraftPage>;
+    /**
+     * Promote a draft to `stable` and record who reviewed it, atomically
+     * (spec §5.2). Metadata writes only: `updated_at` is not bumped and no
+     * outbox event is pushed. Pass `by: 'human:<id>'` so `trustTier` becomes
+     * `'human-reviewed'`.
+     *
+     * @throws WikiDraftNotFound when no live draft with that id exists for the entity.
+     */
+    promoteDraft(entryId: string, entityId: string, reviewer: {
+        by: string;
+    }): Promise<void>;
     /** Set a fact's stale_after (epoch ms) or clear it. Does NOT touch `updated_at`. */
     setStaleAfter(entryId: string, entityId: string, date: number | null): Promise<void>;
     /** Set a fact's generated_by actor string. Does NOT touch `updated_at`. */
@@ -2805,4 +2877,4 @@ declare class WikiMemory {
     setGeneratedByTask(taskId: string, entityId: string, actor: string): Promise<void>;
 }
 
-export { type WikiDiagnosticSeverity as $, type ReembedResult as A, type VectorRankerFallback 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 VectorRankerRankArgs as J, type VectorRankerSemanticResult as K, type LLMProvider as L, type MemoryBundle as M, WikiBusyError as N, ONTOLOGY_BACKFILL_BATCH_SIZE as O, type PromptOverrides as P, type WikiBusyOperation as Q, type ReadOptions as R, type SQLiteAdapter as S, type WikiCheckpoint as T, type WikiConfig as U, type VectorRanker as V, type WikiOptions as W, type WikiDiagnostic as X, type WikiDiagnosticCode as Y, type WikiDiagnosticDetail as Z, type WikiDiagnosticOperation as _, type MemoryDump as a, type WikiDiagnosticTrigger as a0, WikiDuplicateHashError as a1, type WikiEdge as a2, type WikiEvent as a3, type WikiFact as a4, WikiGraphNodeOwnershipConflict as a5, WikiIngestEmptyError as a6, WikiInvalidReadOptions as a7, type WikiMemoryTestAccess as a8, type WikiOutboxEvent as a9, WikiParseError as aa, WikiSourceRefHashCollision as ab, WikiStrictOntologyViolation as ac, type WikiTask as ad, WikiTransactionError as ae, validateManifest as af, EmbeddingService as ag, ImportExportService as ah, IngestionService as ai, JobManager as aj, MaintenanceService as ak, RetrievalService as al, SearchService as am, WriteService as an, type FormattedMemoryDump as b, WikiMemory as c, type EmbedFailureKind as d, type EmbeddingMarkerKind as e, type EntityStatus as f, type ExtractedFact as g, type ExtractedFactEdge as h, type ExtractedFactWithOntology as i, type ExtractedTask as j, type GraphTraversalOptions as k, HEAL_RECHECK_MS as l, HOOK_TIMEOUT_MARKER as m, type HealResult as n, ONTOLOGY_BACKFILL_MAX_PROMPT_CHARS as o, ONTOLOGY_BACKFILL_RECHECK_MS as p, type OntologyBackfillResult as q, type OntologyConfig as r, type OntologyEdgeType as s, type OntologyManifest as t, type OntologyMode as u, type OntologyNodeType as v, type OntologyPromptContext as w, type OntologyUpdates as x, PromptService as y, PrunePartialFailureError as z };
+export { type WikiDiagnosticOperation as $, PrunePartialFailureError as A, type ReembedResult 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 VectorRankerFallback as J, type VectorRankerRankArgs as K, type LLMProvider as L, type MemoryBundle as M, type VectorRankerSemanticResult as N, ONTOLOGY_BACKFILL_BATCH_SIZE as O, type PromptOverrides as P, WikiBusyError as Q, type ReadOptions as R, type SQLiteAdapter as S, type WikiBusyOperation as T, type WikiCheckpoint as U, type VectorRanker as V, type WikiOptions as W, type WikiConfig as X, type WikiDiagnostic as Y, type WikiDiagnosticCode as Z, type WikiDiagnosticDetail as _, type MemoryDump as a, type WikiDiagnosticSeverity as a0, type WikiDiagnosticTrigger as a1, WikiDraftNotFound as a2, WikiDuplicateHashError as a3, type WikiEdge as a4, type WikiEvent as a5, type WikiFact as a6, WikiGraphNodeOwnershipConflict as a7, WikiIngestEmptyError as a8, WikiInvalidReadOptions as a9, type WikiMemoryTestAccess as aa, type WikiOutboxEvent as ab, WikiParseError as ac, WikiSourceRefHashCollision as ad, WikiStrictOntologyViolation as ae, type WikiTask as af, WikiTransactionError as ag, validateManifest as ah, EmbeddingService as ai, ImportExportService as aj, IngestionService as ak, JobManager as al, MaintenanceService as am, RetrievalService as an, SearchService as ao, WriteService as ap, type FormattedMemoryDump as b, WikiMemory as c, type DraftPage as d, type EmbedFailureKind as e, type EmbeddingMarkerKind as f, type EntityStatus as g, type ExtractedFact as h, type ExtractedFactEdge as i, type ExtractedFactWithOntology as j, type ExtractedTask as k, type GraphTraversalOptions as l, HEAL_RECHECK_MS as m, HOOK_TIMEOUT_MARKER as n, type HealResult as o, ONTOLOGY_BACKFILL_MAX_PROMPT_CHARS as p, ONTOLOGY_BACKFILL_RECHECK_MS as q, type OntologyBackfillResult as r, type OntologyConfig as s, type OntologyEdgeType as t, type OntologyManifest as u, type OntologyMode as v, type OntologyNodeType as w, type OntologyPromptContext as x, type OntologyUpdates as y, PromptService as z };

package/dist/testing.d.mts

@@ -1,3 +1,3 @@
-export { ag as EmbeddingService, ah as ImportExportService, ai as IngestionService, aj as JobManager, aj as JobManagerType, ak as MaintenanceService, al as RetrievalService, am as SearchService, am as SearchServiceType, a8 as WikiMemoryTestAccess, an as WriteService } from './testing-ht1qOvcD.mjs';
+export { ai as EmbeddingService, aj as ImportExportService, ak as IngestionService, al as JobManager, al as JobManagerType, am as MaintenanceService, an as RetrievalService, ao as SearchService, ao as SearchServiceType, aa as WikiMemoryTestAccess, ap as WriteService } from './testing-Dmh1kfkd.mjs';
 import '@equationalapplications/core-okf';
 import 'minisearch';

package/dist/testing.d.ts

@@ -1,3 +1,3 @@
-export { ag as EmbeddingService, ah as ImportExportService, ai as IngestionService, aj as JobManager, aj as JobManagerType, ak as MaintenanceService, al as RetrievalService, am as SearchService, am as SearchServiceType, a8 as WikiMemoryTestAccess, an as WriteService } from './testing-ht1qOvcD.js';
+export { ai as EmbeddingService, aj as ImportExportService, ak as IngestionService, al as JobManager, al as JobManagerType, am as MaintenanceService, an as RetrievalService, ao as SearchService, ao as SearchServiceType, aa as WikiMemoryTestAccess, ap as WriteService } from './testing-Dmh1kfkd.js';
 import '@equationalapplications/core-okf';
 import 'minisearch';

package/dist/testing.js

@@ -3516,6 +3516,7 @@ function selectWithFloors(sortedRows, floors, maxResults) {
 }
 
 // src/services/RetrievalService.ts
+var EMPTY_ID_SET = /* @__PURE__ */ new Set();
 var RetrievalService = class {
   constructor(options, entryRepo, taskRepo, eventRepo, metadataRepo, searchService) {
     this.options = options;
@@ -3548,6 +3549,7 @@ var RetrievalService = class {
     }
     const rawMaxResults = options?.maxResults ?? config?.maxResults ?? config?.maxFtsResults ?? 10;
     const maxResults = Number.isFinite(rawMaxResults) ? Math.max(0, Math.trunc(rawMaxResults)) : 10;
+    const excludeDrafts = (options?.excludeDrafts ?? config?.excludeDrafts ?? false) === true;
     const trimmedQuery = query.trim();
     const sanitizedTierFloors = trimmedQuery && exposeMetadata ? validateTierFloors(
       entityIds,
@@ -3567,6 +3569,9 @@ var RetrievalService = class {
     if (maxResults === 0) ; else if (trimmedQuery) {
       let usedEmbed = false;
       const scoredEntityIds = this._filterScoredEntities(entityIds, sanitizedTierWeights, options?.includeZeroWeightEntities);
+      const draftIds = excludeDrafts && scoredEntityIds.length > 0 ? await this.entryRepo.findDraftIdsByEntityIds(scoredEntityIds) : EMPTY_ID_SET;
+      const draftPad = draftIds.size;
+      const padLimit = (n) => n >= Number.MAX_SAFE_INTEGER ? n : n + draftPad;
       if (scoredEntityIds.length === 0) {
         usedEmbed = true;
       } else if (!skipEmbed && embedFn) {
@@ -3600,7 +3605,7 @@ var RetrievalService = class {
           let miniSearchScores;
           if (effectivePreFilterLimit !== void 0) {
             populateCache = false;
-            const preResults = this.searchService.searchKeyword(trimmedQuery, scoredEntityIds, Number.MAX_SAFE_INTEGER);
+            const preResults = this.searchService.searchKeyword(trimmedQuery, scoredEntityIds, Number.MAX_SAFE_INTEGER).filter((r) => !draftIds.has(r.id));
             if (preResults.length === 0) {
               candidateRows = null;
             } else {
@@ -3622,9 +3627,9 @@ var RetrievalService = class {
             }
           } else {
             if (useRanker) {
-              candidateRows = await this.entryRepo.findMetadataByEntityIds(scoredEntityIds);
+              candidateRows = this._withoutDrafts(await this.entryRepo.findMetadataByEntityIds(scoredEntityIds), draftIds);
             } else {
-              candidateRows = await this.entryRepo.findWithEmbeddingsByEntityIds(scoredEntityIds);
+              candidateRows = this._withoutDrafts(await this.entryRepo.findWithEmbeddingsByEntityIds(scoredEntityIds), draftIds);
             }
             if (weight !== void 0 && weight < 1) {
               miniSearchScores = this.searchService.getMiniSearchScores(trimmedQuery, scoredEntityIds);
@@ -3654,7 +3659,7 @@ var RetrievalService = class {
                       candidateRows: rowsForEntity,
                       weight,
                       miniSearchScores,
-                      limit: Math.max(maxResults * 2, maxResults + 50)
+                      limit: padLimit(Math.max(maxResults * 2, maxResults + 50))
                     });
                     return ranked.map((row) => ({ ...row, entity_id: scopedEntityId }));
                   })
@@ -3868,7 +3873,7 @@ var RetrievalService = class {
                   });
                 } else if (policy === "keyword") {
                   const hasActiveFloorsKeywordFallback = sanitizedTierFloors !== void 0 && Object.values(sanitizedTierFloors).some((f) => f > 0);
-                  const keywordOversampledLimit = hasActiveFloorsKeywordFallback ? Number.MAX_SAFE_INTEGER : Math.max(maxResults * 2, maxResults + 50);
+                  const keywordOversampledLimit = hasActiveFloorsKeywordFallback ? Number.MAX_SAFE_INTEGER : padLimit(Math.max(maxResults * 2, maxResults + 50));
                   const preFilteredIds = effectivePreFilterLimit !== void 0 ? new Set(candidateRows.map((r) => r.id)) : void 0;
                   const keywordResults = this.searchService.searchKeyword(trimmedQuery, scoredEntityIds, keywordOversampledLimit);
                   const topResults = preFilteredIds === void 0 ? keywordResults : keywordResults.filter((r) => preFilteredIds.has(r.id));
@@ -3909,6 +3914,7 @@ var RetrievalService = class {
                 // read() re-sorts after applying tier weights
               });
             }
+            if (draftPad > 0) scored = scored.filter((s) => !draftIds.has(s.id));
             if (scored.length > 0) {
               scored = scored.map((row) => ({
                 ...row,
@@ -3971,8 +3977,8 @@ var RetrievalService = class {
       }
       if (!usedEmbed && scoredEntityIds.length > 0) {
         const hasActiveFloors = sanitizedTierFloors !== void 0 && Object.values(sanitizedTierFloors).some((f) => f > 0);
-        const fallbackOversampledLimit = hasActiveFloors ? Number.MAX_SAFE_INTEGER : Math.max(maxResults * 2, maxResults + 50);
-        const results = this.searchService.searchKeyword(trimmedQuery, scoredEntityIds, fallbackOversampledLimit);
+        const fallbackOversampledLimit = hasActiveFloors ? Number.MAX_SAFE_INTEGER : padLimit(Math.max(maxResults * 2, maxResults + 50));
+        const results = this.searchService.searchKeyword(trimmedQuery, scoredEntityIds, fallbackOversampledLimit).filter((r) => !draftIds.has(r.id));
         const candidates = results.map((r) => ({
           id: r.id,
           entity_id: r.entity_id,
@@ -3996,7 +4002,7 @@ var RetrievalService = class {
         await this.entryRepo.trackAccess(ids, now);
       }
     } else {
-      facts = await this.entryRepo.findRecentByEntityIds(entityIds, maxResults);
+      facts = excludeDrafts ? await this.entryRepo.findRecentByEntityIds(entityIds, maxResults, void 0, { excludeDrafts: true }) : await this.entryRepo.findRecentByEntityIds(entityIds, maxResults);
     }
     const eventsLimit = Math.min(10 * entityIds.length, 100);
     const [tasks, events] = await Promise.all([
@@ -4032,6 +4038,9 @@ var RetrievalService = class {
   _tieBreakSort(items) {
     items.sort((a, b) => this._compareScoredRows(a, b));
   }
+  _withoutDrafts(rows, draftIds) {
+    return draftIds.size === 0 ? rows : rows.filter((row) => !draftIds.has(row.id));
+  }
   /**
    * Comparator for score + deterministic tie-break fields.
    * Negative return means "a ranks ahead of b" for descending score order.