@equationalapplications/core-llm-wiki 7.3.0 → 7.5.0

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

@@ -82,6 +82,14 @@ interface OntologyConfig {
         manifest: OntologyManifest;
         mode?: OntologyMode;
     }>;
+    /**
+     * Engine default for `runOntologyBackfill`'s `classifier` option.
+     * `'auto'` uses `llmProvider.classify` for node typing when present
+     * (no edges are proposed); `'llm'` always uses `generateText`. Default `'llm'`.
+     */
+    backfillClassifier?: 'auto' | 'llm';
+    /** Minimum classifier confidence to apply a node type. Finite, in [0, 1]. Default 0.5. */
+    classifyMinConfidence?: number;
 }
 interface ExtractedFactEdge {
     edge_type: string;
@@ -269,6 +277,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 +322,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 +470,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. */
@@ -481,6 +506,8 @@ interface LLMProvider {
     /**
      * Generates text using the developer's LLM of choice.
      * Expected to return the raw text response (typically a JSON string).
+     * Called with the provider as `this`, so class-based adapters may keep
+     * SDK handles and config on the instance.
      */
     generateText: (params: {
         systemPrompt: string;
@@ -491,6 +518,8 @@ interface LLMProvider {
      * Must return a stable-dimension float array for any input text.
      * Called once per fact on creation/update, and once per `read()` query.
      * When absent or throws, `read()` falls back to MiniSearch.
+     * Called with the provider as `this` (never detached), same as
+     * `generateText`, so class-based adapters may read their own state.
      */
     embed?: (text: string) => Promise<number[]>;
     /**
@@ -504,6 +533,49 @@ interface LLMProvider {
      * never trusted as a guarantee.
      */
     maxOutputTokens?: number;
+    /**
+     * Optional non-generative classifier (System-One models such as Jev,
+     * OpenJev, or a local ONNX classifier). Core never calls it unless the host
+     * opts in (e.g. `WikiConfig.ontology.backfillClassifier: 'auto'`); merely
+     * providing it changes nothing (REQ-COMPAT-01.5). Output is validated as
+     * untrusted.
+     */
+    classify?: (request: ClassifyRequest) => Promise<ClassifyResponse>;
+}
+/** One typed question for a classifier. Vendor-neutral (Jev `noul` ↔ `binary`). */
+type ClassifierQuestion = {
+    kind: 'choice';
+    options: string[];
+    instructions?: string;
+} | {
+    kind: 'binary';
+    instructions: string;
+} | {
+    kind: 'score';
+    levels: string[];
+    instructions?: string;
+};
+/** One state evaluated against a map of questions (many questions per state, one state per call). */
+interface ClassifyRequest {
+    state: string;
+    questions: Record<string, ClassifierQuestion>;
+}
+type ClassifierAnswer = {
+    kind: 'choice';
+    choice: string;
+    confidence: number;
+    probabilities: Record<string, number>;
+} | {
+    kind: 'binary';
+    probability: number;
+} | {
+    kind: 'score';
+    score: number;
+    confidence: number;
+    probabilities: number[];
+};
+interface ClassifyResponse {
+    answers: Record<string, ClassifierAnswer>;
 }
 /**
  * Result of semantic ranking for a single fact.
@@ -942,6 +1014,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 +1405,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 +1824,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 {
     /**
@@ -2223,6 +2330,7 @@ declare class MaintenanceService {
     runOntologyBackfill(entityId: string, options?: {
         promptOverride?: string;
         batchSize?: number;
+        classifier?: 'auto' | 'llm';
     }): Promise<OntologyBackfillResult>;
     /**
      * Re-embed facts, honouring per-row failure markers and exponential backoff.
@@ -2297,7 +2405,15 @@ declare class MaintenanceService {
     doRunOntologyBackfill(entityId: string, options?: {
         promptOverride?: string;
         batchSize?: number;
+        classifier?: 'auto' | 'llm';
     }): Promise<OntologyBackfillResult>;
+    /**
+     * Classifier-mode backfill (spec §7.3): one `choice` question per untyped
+     * fact over the effective manifest's node-type slugs. Accepted answers go
+     * through `_applyOntologyBackfillBatch` exactly like LLM classifications.
+     * No edges are proposed.
+     */
+    private _runClassifierBackfill;
     /**
      * Applies one parsed backfill batch in its own transaction. Per-batch rather
      * than one transaction for the pass, so mergeEmergentUpdates semantics and
@@ -2374,6 +2490,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.
@@ -2604,6 +2721,7 @@ declare class WikiMemory {
     runOntologyBackfill(entityId: string, options?: {
         promptOverride?: string;
         batchSize?: number;
+        classifier?: 'auto' | 'llm';
     }): Promise<OntologyBackfillResult>;
     runReembed(entityId?: string, opts?: {
         force?: boolean;
@@ -2787,6 +2905,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 +2942,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 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 };

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

@@ -82,6 +82,14 @@ interface OntologyConfig {
         manifest: OntologyManifest;
         mode?: OntologyMode;
     }>;
+    /**
+     * Engine default for `runOntologyBackfill`'s `classifier` option.
+     * `'auto'` uses `llmProvider.classify` for node typing when present
+     * (no edges are proposed); `'llm'` always uses `generateText`. Default `'llm'`.
+     */
+    backfillClassifier?: 'auto' | 'llm';
+    /** Minimum classifier confidence to apply a node type. Finite, in [0, 1]. Default 0.5. */
+    classifyMinConfidence?: number;
 }
 interface ExtractedFactEdge {
     edge_type: string;
@@ -269,6 +277,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 +322,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 +470,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. */
@@ -481,6 +506,8 @@ interface LLMProvider {
     /**
      * Generates text using the developer's LLM of choice.
      * Expected to return the raw text response (typically a JSON string).
+     * Called with the provider as `this`, so class-based adapters may keep
+     * SDK handles and config on the instance.
      */
     generateText: (params: {
         systemPrompt: string;
@@ -491,6 +518,8 @@ interface LLMProvider {
      * Must return a stable-dimension float array for any input text.
      * Called once per fact on creation/update, and once per `read()` query.
      * When absent or throws, `read()` falls back to MiniSearch.
+     * Called with the provider as `this` (never detached), same as
+     * `generateText`, so class-based adapters may read their own state.
      */
     embed?: (text: string) => Promise<number[]>;
     /**
@@ -504,6 +533,49 @@ interface LLMProvider {
      * never trusted as a guarantee.
      */
     maxOutputTokens?: number;
+    /**
+     * Optional non-generative classifier (System-One models such as Jev,
+     * OpenJev, or a local ONNX classifier). Core never calls it unless the host
+     * opts in (e.g. `WikiConfig.ontology.backfillClassifier: 'auto'`); merely
+     * providing it changes nothing (REQ-COMPAT-01.5). Output is validated as
+     * untrusted.
+     */
+    classify?: (request: ClassifyRequest) => Promise<ClassifyResponse>;
+}
+/** One typed question for a classifier. Vendor-neutral (Jev `noul` ↔ `binary`). */
+type ClassifierQuestion = {
+    kind: 'choice';
+    options: string[];
+    instructions?: string;
+} | {
+    kind: 'binary';
+    instructions: string;
+} | {
+    kind: 'score';
+    levels: string[];
+    instructions?: string;
+};
+/** One state evaluated against a map of questions (many questions per state, one state per call). */
+interface ClassifyRequest {
+    state: string;
+    questions: Record<string, ClassifierQuestion>;
+}
+type ClassifierAnswer = {
+    kind: 'choice';
+    choice: string;
+    confidence: number;
+    probabilities: Record<string, number>;
+} | {
+    kind: 'binary';
+    probability: number;
+} | {
+    kind: 'score';
+    score: number;
+    confidence: number;
+    probabilities: number[];
+};
+interface ClassifyResponse {
+    answers: Record<string, ClassifierAnswer>;
 }
 /**
  * Result of semantic ranking for a single fact.
@@ -942,6 +1014,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 +1405,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 +1824,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 {
     /**
@@ -2223,6 +2330,7 @@ declare class MaintenanceService {
     runOntologyBackfill(entityId: string, options?: {
         promptOverride?: string;
         batchSize?: number;
+        classifier?: 'auto' | 'llm';
     }): Promise<OntologyBackfillResult>;
     /**
      * Re-embed facts, honouring per-row failure markers and exponential backoff.
@@ -2297,7 +2405,15 @@ declare class MaintenanceService {
     doRunOntologyBackfill(entityId: string, options?: {
         promptOverride?: string;
         batchSize?: number;
+        classifier?: 'auto' | 'llm';
     }): Promise<OntologyBackfillResult>;
+    /**
+     * Classifier-mode backfill (spec §7.3): one `choice` question per untyped
+     * fact over the effective manifest's node-type slugs. Accepted answers go
+     * through `_applyOntologyBackfillBatch` exactly like LLM classifications.
+     * No edges are proposed.
+     */
+    private _runClassifierBackfill;
     /**
      * Applies one parsed backfill batch in its own transaction. Per-batch rather
      * than one transaction for the pass, so mergeEmergentUpdates semantics and
@@ -2374,6 +2490,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.
@@ -2604,6 +2721,7 @@ declare class WikiMemory {
     runOntologyBackfill(entityId: string, options?: {
         promptOverride?: string;
         batchSize?: number;
+        classifier?: 'auto' | 'llm';
     }): Promise<OntologyBackfillResult>;
     runReembed(entityId?: string, opts?: {
         force?: boolean;
@@ -2787,6 +2905,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 +2942,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 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 };

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 { 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';
 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 { 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';
 import '@equationalapplications/core-okf';
 import 'minisearch';