@equationalapplications/core-llm-wiki 7.11.2 → 7.12.0

package/dist/{testing-B0UtFCq1.d.mts → testing-7d76Ptlq.d.mts}

@@ -209,6 +209,10 @@ interface HealResult {
      * cooldown", not "there is no more work" — it climbs back as the cooldown lapses
      * and as new facts are written. A host loop terminates, but it converges to
      * "corpus swept once this cooldown window", not to a drained queue.
+     *
+     * A pass that could not make progress (`searchUnavailable` or `budgetStop`
+     * set) leaves `remaining > 0`, so a convergence loop must also stop on those:
+     * `while (r.remaining > 0 && !r.searchUnavailable && !r.budgetStop)`.
      */
     remaining: number;
     /** Heal candidates inside the recheck cooldown. */
@@ -217,6 +221,12 @@ interface HealResult {
     budgetStop?: {
         requiredEstimate: number;
     };
+    /**
+     * True when the LLM pass was skipped because keyword search is unavailable
+     * (heal anchors need it; spec #280). Candidates stay eligible and unattempted;
+     * retry after `syncSearchIndex()` restores keyword search.
+     */
+    searchUnavailable?: true;
 }
 /**
  * Opt-in evidence check for LLM-authored facts (spec §6). Default off: 7.x
@@ -324,6 +334,12 @@ interface WikiConfig {
      * entries table, so memory stays flat at any size. The first `setup()` that
      * attaches FTS5 to an existing database rebuilds the index in one
      * transaction, holding the write lock for its whole duration.
+     * If FTS5 init fails under `'auto'`, `setup()` retries once after 250 ms and
+     * then completes with keyword search unavailable (queries throw
+     * `WikiSearchUnavailableError`); it never demotes to MiniSearch. MiniSearch
+     * is used only when pinned or when the SQLite build lacks FTS5/json1, and it
+     * holds all entry text in the JS heap: the measured ceiling is ~1M entries
+     * on a default Node heap (raise `--max-old-space-size` for larger stores).
      * @default 'auto'
      */
     indexStrategy?: 'fts5' | 'minisearch' | 'auto';
@@ -355,6 +371,14 @@ interface WikiConfig {
     maintenance?: 'auto' | 'deferred';
     /** `'auto'` mode only: also trigger the librarian when pending event text reaches ~this many tokens (chars/4). */
     autoLibrarianTokenThreshold?: number;
+    /**
+     * Migration policy for setup().
+     * - `'allow'`: Run all migrations (default, preserves existing behavior)
+     * - `'refuse'`: Throw WikiMigrationRequiredError before any mutations
+     * - `'auto'`: Run the source_ref normalize if pending; throw if a schema migration is pending
+     * @default 'allow'
+     */
+    migrations?: MigrationPolicy;
 }
 interface ReadOptions {
     maxResults?: number;
@@ -1266,6 +1290,12 @@ interface EntityMaintenanceReport {
     reembedded: boolean;
     /** Set when a lock was held elsewhere; nothing ran for that job. */
     busy?: MaintenanceJob[];
+    /**
+     * Set when keyword search is unavailable and the job could not run for this
+     * entity (spec #280). Its watermark/checkpoint is kept; retry after
+     * `syncSearchIndex()` restores keyword search.
+     */
+    searchUnavailable?: MaintenanceJob[];
 }
 interface RunPendingMaintenanceResult {
     perEntity: EntityMaintenanceReport[];
@@ -1276,6 +1306,33 @@ interface RunPendingMaintenanceResult {
     remaining: number | null;
     stoppedReason: MaintenanceStopReason;
 }
+type MigrationPolicy = 'allow' | 'refuse' | 'auto';
+/** Work the migration gate found pending on an existing store. Watermarks are resume rowids (0 = not started). */
+type PendingMigrationWork = {
+    type: 'schema_migration';
+    fromVersion: number;
+    toVersion: number;
+} | {
+    type: 'source_ref_normalize';
+    entriesWatermark: number;
+    sourceRefIndexWatermark: number;
+};
+declare class WikiMigrationRequiredError extends Error {
+    readonly code = "WIKI_MIGRATION_REQUIRED";
+    readonly pendingWork: PendingMigrationWork;
+    constructor(message: string, pendingWork: PendingMigrationWork);
+}
+/**
+ * Thrown per keyword-search query while the keyword index is unavailable
+ * (FTS5 init failed after its retry; spec #280 Change 4). Writes keep working
+ * and the index converges once a later open or no-arg syncSearchIndex()
+ * re-inits successfully. `cause` is the underlying init error.
+ */
+declare class WikiSearchUnavailableError extends Error {
+    constructor(message?: string, cause?: unknown);
+}
+/** Proxy-safe `instanceof WikiSearchUnavailableError` (issue #96). */
+declare function isWikiSearchUnavailableError(err: unknown): boolean;
 
 interface WikiOutboxEvent<T = unknown> {
     id: string;
@@ -1395,6 +1452,8 @@ declare class EntryRepository extends BaseRepository {
     private static readonly MINI_SEARCH_LIVE_WHERE;
     private chunkSize;
     constructor(db: SQLiteAdapter, prefix: string, outbox: OutboxRepository);
+    /** Whether the entity has any non-deleted row (librarian gate: keyword ranking over zero facts is trivially empty). */
+    hasLiveEntry(entityId: string, tx?: SQLiteAdapter): Promise<boolean>;
     /**
      * Fetch facts by IDs, optionally scoped to entity IDs.
      * Returns facts in the order of the input IDs (first match wins).
@@ -1653,11 +1712,6 @@ declare class EntryRepository extends BaseRepository {
     hasLegacySourceTypes(tx?: SQLiteAdapter): Promise<boolean>;
     countLegacySourceTypes(tx?: SQLiteAdapter): Promise<number>;
     findAllForReembed(entityId?: string, tx?: SQLiteAdapter): Promise<ReembedCandidateRow[]>;
-    findRowsForSourceRefMigration(tx?: SQLiteAdapter): Promise<Array<{
-        rowid: number;
-        source_ref: string;
-    }>>;
-    updateSourceRefByRowid(rowid: number, sourceRef: string | null, tx: SQLiteAdapter): Promise<void>;
     findLatestSourceHash(entityId: string, sourceRef: string, tx?: SQLiteAdapter): Promise<string | null>;
     /**
      * Batch version of {@link findLatestSourceHash}. Returns a Map covering every
@@ -2123,6 +2177,8 @@ declare class SearchService {
      * service runs on an empty MiniSearch placeholder, as it always has.
      */
     setIndexStrategy(strategy: IndexStrategy): void;
+    /** False while the installed strategy is the degraded UnavailableIndexStrategy (spec #280 Change 4). */
+    isKeywordAvailable(): boolean;
     /**
      * One serialized drain turn for strategies with a durable ledger. Like
      * sync(), it never rejects: the keyword index is rebuildable, and a failed
@@ -3192,7 +3248,8 @@ declare class MaintenanceService {
      *
      * Bounded: at most `batchSize` candidates per pass (#67). Loop on
      * `result.remaining > 0` for convergence — see {@link HealResult.remaining}
-     * for what convergence means here.
+     * for what convergence means here, and for the no-progress flags
+     * (`searchUnavailable`, `budgetStop`) a loop must also stop on.
      */
     doRunHeal(entityId: string, options?: {
         promptOverride?: string;
@@ -3368,6 +3425,7 @@ declare class WriteService {
      * {@link write}) so a partial pass retries on the next write.
      */
     private maybeRunHeal;
+    private warnedSearchUnavailable;
     private reportBackgroundFailure;
 }
 
@@ -3457,7 +3515,25 @@ declare class WikiMemory {
      * If `NODE_ENV` is not `"test"`, emits a single `console.warn` per instance (skipped when `process` is undefined).
      */
     get __testAccess(): WikiMemoryTestAccess;
-    setup(): Promise<void>;
+    private reinitSearch;
+    /** Monotonic time before which a no-arg syncSearchIndex() skips the re-init (0 = no cooldown). */
+    private reinitRetryAt;
+    /** Consecutive failed re-inits; drives the exponential backoff. */
+    private reinitFailures;
+    /**
+     * Opens the store: migration gate, DDL, schema migrations, then the stamped
+     * source_ref normalize. Await it before any other call on this instance — the
+     * normalize commits in chunks, so a sourceRef-keyed call (forget, upsertGraph,
+     * hasChanged, ingest) issued before setup() resolves can see partially
+     * normalized refs.
+     *
+     * Pass `{ migrations: 'refuse' }` from inside a writer lease: pending one-time
+     * work then throws WikiMigrationRequiredError before any mutation, and the
+     * host runs a plain `setup()` outside the lease.
+     */
+    setup(opts?: {
+        migrations?: MigrationPolicy;
+    }): Promise<void>;
     hasChanged(entityId: string, sourceRef: string, sourceHash: string): Promise<boolean>;
     /**
      * Batched overload.
@@ -3644,7 +3720,10 @@ declare class WikiMemory {
      * indexed; otherwise it is a no-op that still waits for rebuilds already
      * queued. Without an argument, rebuilds every entity currently marked
      * stale; when none is, it resolves immediately and does not wait for rebuilds
-     * already queued.
+     * already queued. While keyword search is unavailable it first retries the
+     * index init; after a failed attempt it waits at least 5 s, doubling per
+     * consecutive failure up to 5 min (longer when an attempt is itself slow),
+     * before retrying again.
      *
      * Call only after the host's transaction commits: called inside it, the
      * rebuild may index rows that later roll back, or miss them and clear the
@@ -3887,4 +3966,4 @@ declare class WikiMemory {
     setGeneratedByTask(taskId: string, entityId: string, actor: string): Promise<void>;
 }
 
-export { type ReembedResult as $, ONTOLOGY_BACKFILL_RECHECK_MS as A, type OntologyBackfillResult 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 OntologyConfig as J, type OntologyEdgeType as K, type LLMProvider as L, type MemoryBundle as M, type OntologyManifest as N, ONTOLOGY_BACKFILL_BATCH_SIZE as O, type OntologyMode as P, type OntologyNodeType as Q, type ReadOptions as R, type SQLiteAdapter as S, type OntologyPromptContext as T, type OntologyUpdates as U, type PendingMaintenance as V, type WikiOptions as W, type PendingSourceStatus as X, type PromptOverrides as Y, PromptService as Z, PrunePartialFailureError as _, type MemoryDump as a, type RunPendingMaintenanceOptions as a0, type RunPendingMaintenanceResult as a1, type SupersedeReplacement as a2, type VectorRanker as a3, type VectorRankerFallback as a4, type VectorRankerRankArgs as a5, type VectorRankerSemanticResult as a6, WikiBusyError as a7, type WikiBusyOperation as a8, type WikiCheckpoint as a9, validateManifest as aA, EmbeddingService as aB, ImportExportService as aC, IngestionService as aD, JobManager as aE, MaintenanceService as aF, RetrievalService as aG, SearchService as aH, WriteService as aI, type WikiConfig as aa, type WikiDiagnostic as ab, type WikiDiagnosticCode as ac, type WikiDiagnosticDetail as ad, type WikiDiagnosticOperation as ae, type WikiDiagnosticSeverity as af, type WikiDiagnosticTrigger as ag, WikiDraftNotFound as ah, WikiDuplicateHashError as ai, type WikiEdge as aj, type WikiEvent as ak, type WikiFact as al, WikiGraphNodeOwnershipConflict as am, WikiIngestEmptyError as an, type WikiInstructions as ao, WikiInvalidReadOptions as ap, type WikiLintReport as aq, type WikiMemoryTestAccess as ar, type WikiOutboxEvent as as, WikiParseError as at, WikiSourceRefHashCollision as au, WikiStrictOntologyViolation as av, WikiSupersedeError as aw, type WikiSupersedeReason as ax, type WikiTask as ay, WikiTransactionError as az, 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 EntityMaintenanceReport as k, type EntityStatus as l, type ExtractedFact as m, type ExtractedFactEdge as n, type ExtractedFactWithOntology as o, type ExtractedTask as p, type GraphTraversalOptions as q, type GroundingConfig as r, HEAL_RECHECK_MS as s, HOOK_TIMEOUT_MARKER as t, type HealResult as u, type LibrarianConfig as v, type LibrarianGateConfig as w, type MaintenanceJob as x, type MaintenanceStopReason as y, ONTOLOGY_BACKFILL_MAX_PROMPT_CHARS as z };
+export { PromptService as $, ONTOLOGY_BACKFILL_MAX_PROMPT_CHARS as A, ONTOLOGY_BACKFILL_RECHECK_MS 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 OntologyBackfillResult as J, type OntologyConfig as K, type LLMProvider as L, type MemoryBundle as M, type OntologyEdgeType as N, ONTOLOGY_BACKFILL_BATCH_SIZE as O, type OntologyManifest as P, type OntologyMode as Q, type ReadOptions as R, type SQLiteAdapter as S, type OntologyNodeType as T, type OntologyPromptContext as U, type OntologyUpdates as V, type WikiOptions as W, type PendingMaintenance as X, type PendingMigrationWork as Y, type PendingSourceStatus as Z, type PromptOverrides as _, type MemoryDump as a, PrunePartialFailureError as a0, type ReembedResult as a1, type RunPendingMaintenanceOptions as a2, type RunPendingMaintenanceResult as a3, type SupersedeReplacement as a4, type VectorRanker as a5, type VectorRankerFallback as a6, type VectorRankerRankArgs as a7, type VectorRankerSemanticResult as a8, WikiBusyError as a9, WikiSupersedeError as aA, type WikiSupersedeReason as aB, type WikiTask as aC, WikiTransactionError as aD, isWikiSearchUnavailableError 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 WikiBusyOperation as aa, type WikiCheckpoint as ab, type WikiConfig as ac, type WikiDiagnostic as ad, type WikiDiagnosticCode as ae, type WikiDiagnosticDetail as af, type WikiDiagnosticOperation as ag, type WikiDiagnosticSeverity as ah, type WikiDiagnosticTrigger as ai, WikiDraftNotFound as aj, WikiDuplicateHashError as ak, type WikiEdge as al, type WikiEvent as am, type WikiFact as an, WikiGraphNodeOwnershipConflict as ao, WikiIngestEmptyError as ap, type WikiInstructions as aq, WikiInvalidReadOptions as ar, type WikiLintReport as as, type WikiMemoryTestAccess as at, WikiMigrationRequiredError as au, type WikiOutboxEvent as av, WikiParseError as aw, WikiSearchUnavailableError as ax, WikiSourceRefHashCollision as ay, WikiStrictOntologyViolation as az, 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 EntityMaintenanceReport as k, type EntityStatus as l, type ExtractedFact as m, type ExtractedFactEdge as n, type ExtractedFactWithOntology as o, type ExtractedTask as p, type GraphTraversalOptions as q, type GroundingConfig as r, HEAL_RECHECK_MS as s, HOOK_TIMEOUT_MARKER as t, type HealResult as u, type LibrarianConfig as v, type LibrarianGateConfig as w, type MaintenanceJob as x, type MaintenanceStopReason as y, type MigrationPolicy as z };

package/dist/{testing-B0UtFCq1.d.ts → testing-7d76Ptlq.d.ts}

@@ -209,6 +209,10 @@ interface HealResult {
      * cooldown", not "there is no more work" — it climbs back as the cooldown lapses
      * and as new facts are written. A host loop terminates, but it converges to
      * "corpus swept once this cooldown window", not to a drained queue.
+     *
+     * A pass that could not make progress (`searchUnavailable` or `budgetStop`
+     * set) leaves `remaining > 0`, so a convergence loop must also stop on those:
+     * `while (r.remaining > 0 && !r.searchUnavailable && !r.budgetStop)`.
      */
     remaining: number;
     /** Heal candidates inside the recheck cooldown. */
@@ -217,6 +221,12 @@ interface HealResult {
     budgetStop?: {
         requiredEstimate: number;
     };
+    /**
+     * True when the LLM pass was skipped because keyword search is unavailable
+     * (heal anchors need it; spec #280). Candidates stay eligible and unattempted;
+     * retry after `syncSearchIndex()` restores keyword search.
+     */
+    searchUnavailable?: true;
 }
 /**
  * Opt-in evidence check for LLM-authored facts (spec §6). Default off: 7.x
@@ -324,6 +334,12 @@ interface WikiConfig {
      * entries table, so memory stays flat at any size. The first `setup()` that
      * attaches FTS5 to an existing database rebuilds the index in one
      * transaction, holding the write lock for its whole duration.
+     * If FTS5 init fails under `'auto'`, `setup()` retries once after 250 ms and
+     * then completes with keyword search unavailable (queries throw
+     * `WikiSearchUnavailableError`); it never demotes to MiniSearch. MiniSearch
+     * is used only when pinned or when the SQLite build lacks FTS5/json1, and it
+     * holds all entry text in the JS heap: the measured ceiling is ~1M entries
+     * on a default Node heap (raise `--max-old-space-size` for larger stores).
      * @default 'auto'
      */
     indexStrategy?: 'fts5' | 'minisearch' | 'auto';
@@ -355,6 +371,14 @@ interface WikiConfig {
     maintenance?: 'auto' | 'deferred';
     /** `'auto'` mode only: also trigger the librarian when pending event text reaches ~this many tokens (chars/4). */
     autoLibrarianTokenThreshold?: number;
+    /**
+     * Migration policy for setup().
+     * - `'allow'`: Run all migrations (default, preserves existing behavior)
+     * - `'refuse'`: Throw WikiMigrationRequiredError before any mutations
+     * - `'auto'`: Run the source_ref normalize if pending; throw if a schema migration is pending
+     * @default 'allow'
+     */
+    migrations?: MigrationPolicy;
 }
 interface ReadOptions {
     maxResults?: number;
@@ -1266,6 +1290,12 @@ interface EntityMaintenanceReport {
     reembedded: boolean;
     /** Set when a lock was held elsewhere; nothing ran for that job. */
     busy?: MaintenanceJob[];
+    /**
+     * Set when keyword search is unavailable and the job could not run for this
+     * entity (spec #280). Its watermark/checkpoint is kept; retry after
+     * `syncSearchIndex()` restores keyword search.
+     */
+    searchUnavailable?: MaintenanceJob[];
 }
 interface RunPendingMaintenanceResult {
     perEntity: EntityMaintenanceReport[];
@@ -1276,6 +1306,33 @@ interface RunPendingMaintenanceResult {
     remaining: number | null;
     stoppedReason: MaintenanceStopReason;
 }
+type MigrationPolicy = 'allow' | 'refuse' | 'auto';
+/** Work the migration gate found pending on an existing store. Watermarks are resume rowids (0 = not started). */
+type PendingMigrationWork = {
+    type: 'schema_migration';
+    fromVersion: number;
+    toVersion: number;
+} | {
+    type: 'source_ref_normalize';
+    entriesWatermark: number;
+    sourceRefIndexWatermark: number;
+};
+declare class WikiMigrationRequiredError extends Error {
+    readonly code = "WIKI_MIGRATION_REQUIRED";
+    readonly pendingWork: PendingMigrationWork;
+    constructor(message: string, pendingWork: PendingMigrationWork);
+}
+/**
+ * Thrown per keyword-search query while the keyword index is unavailable
+ * (FTS5 init failed after its retry; spec #280 Change 4). Writes keep working
+ * and the index converges once a later open or no-arg syncSearchIndex()
+ * re-inits successfully. `cause` is the underlying init error.
+ */
+declare class WikiSearchUnavailableError extends Error {
+    constructor(message?: string, cause?: unknown);
+}
+/** Proxy-safe `instanceof WikiSearchUnavailableError` (issue #96). */
+declare function isWikiSearchUnavailableError(err: unknown): boolean;
 
 interface WikiOutboxEvent<T = unknown> {
     id: string;
@@ -1395,6 +1452,8 @@ declare class EntryRepository extends BaseRepository {
     private static readonly MINI_SEARCH_LIVE_WHERE;
     private chunkSize;
     constructor(db: SQLiteAdapter, prefix: string, outbox: OutboxRepository);
+    /** Whether the entity has any non-deleted row (librarian gate: keyword ranking over zero facts is trivially empty). */
+    hasLiveEntry(entityId: string, tx?: SQLiteAdapter): Promise<boolean>;
     /**
      * Fetch facts by IDs, optionally scoped to entity IDs.
      * Returns facts in the order of the input IDs (first match wins).
@@ -1653,11 +1712,6 @@ declare class EntryRepository extends BaseRepository {
     hasLegacySourceTypes(tx?: SQLiteAdapter): Promise<boolean>;
     countLegacySourceTypes(tx?: SQLiteAdapter): Promise<number>;
     findAllForReembed(entityId?: string, tx?: SQLiteAdapter): Promise<ReembedCandidateRow[]>;
-    findRowsForSourceRefMigration(tx?: SQLiteAdapter): Promise<Array<{
-        rowid: number;
-        source_ref: string;
-    }>>;
-    updateSourceRefByRowid(rowid: number, sourceRef: string | null, tx: SQLiteAdapter): Promise<void>;
     findLatestSourceHash(entityId: string, sourceRef: string, tx?: SQLiteAdapter): Promise<string | null>;
     /**
      * Batch version of {@link findLatestSourceHash}. Returns a Map covering every
@@ -2123,6 +2177,8 @@ declare class SearchService {
      * service runs on an empty MiniSearch placeholder, as it always has.
      */
     setIndexStrategy(strategy: IndexStrategy): void;
+    /** False while the installed strategy is the degraded UnavailableIndexStrategy (spec #280 Change 4). */
+    isKeywordAvailable(): boolean;
     /**
      * One serialized drain turn for strategies with a durable ledger. Like
      * sync(), it never rejects: the keyword index is rebuildable, and a failed
@@ -3192,7 +3248,8 @@ declare class MaintenanceService {
      *
      * Bounded: at most `batchSize` candidates per pass (#67). Loop on
      * `result.remaining > 0` for convergence — see {@link HealResult.remaining}
-     * for what convergence means here.
+     * for what convergence means here, and for the no-progress flags
+     * (`searchUnavailable`, `budgetStop`) a loop must also stop on.
      */
     doRunHeal(entityId: string, options?: {
         promptOverride?: string;
@@ -3368,6 +3425,7 @@ declare class WriteService {
      * {@link write}) so a partial pass retries on the next write.
      */
     private maybeRunHeal;
+    private warnedSearchUnavailable;
     private reportBackgroundFailure;
 }
 
@@ -3457,7 +3515,25 @@ declare class WikiMemory {
      * If `NODE_ENV` is not `"test"`, emits a single `console.warn` per instance (skipped when `process` is undefined).
      */
     get __testAccess(): WikiMemoryTestAccess;
-    setup(): Promise<void>;
+    private reinitSearch;
+    /** Monotonic time before which a no-arg syncSearchIndex() skips the re-init (0 = no cooldown). */
+    private reinitRetryAt;
+    /** Consecutive failed re-inits; drives the exponential backoff. */
+    private reinitFailures;
+    /**
+     * Opens the store: migration gate, DDL, schema migrations, then the stamped
+     * source_ref normalize. Await it before any other call on this instance — the
+     * normalize commits in chunks, so a sourceRef-keyed call (forget, upsertGraph,
+     * hasChanged, ingest) issued before setup() resolves can see partially
+     * normalized refs.
+     *
+     * Pass `{ migrations: 'refuse' }` from inside a writer lease: pending one-time
+     * work then throws WikiMigrationRequiredError before any mutation, and the
+     * host runs a plain `setup()` outside the lease.
+     */
+    setup(opts?: {
+        migrations?: MigrationPolicy;
+    }): Promise<void>;
     hasChanged(entityId: string, sourceRef: string, sourceHash: string): Promise<boolean>;
     /**
      * Batched overload.
@@ -3644,7 +3720,10 @@ declare class WikiMemory {
      * indexed; otherwise it is a no-op that still waits for rebuilds already
      * queued. Without an argument, rebuilds every entity currently marked
      * stale; when none is, it resolves immediately and does not wait for rebuilds
-     * already queued.
+     * already queued. While keyword search is unavailable it first retries the
+     * index init; after a failed attempt it waits at least 5 s, doubling per
+     * consecutive failure up to 5 min (longer when an attempt is itself slow),
+     * before retrying again.
      *
      * Call only after the host's transaction commits: called inside it, the
      * rebuild may index rows that later roll back, or miss them and clear the
@@ -3887,4 +3966,4 @@ declare class WikiMemory {
     setGeneratedByTask(taskId: string, entityId: string, actor: string): Promise<void>;
 }
 
-export { type ReembedResult as $, ONTOLOGY_BACKFILL_RECHECK_MS as A, type OntologyBackfillResult 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 OntologyConfig as J, type OntologyEdgeType as K, type LLMProvider as L, type MemoryBundle as M, type OntologyManifest as N, ONTOLOGY_BACKFILL_BATCH_SIZE as O, type OntologyMode as P, type OntologyNodeType as Q, type ReadOptions as R, type SQLiteAdapter as S, type OntologyPromptContext as T, type OntologyUpdates as U, type PendingMaintenance as V, type WikiOptions as W, type PendingSourceStatus as X, type PromptOverrides as Y, PromptService as Z, PrunePartialFailureError as _, type MemoryDump as a, type RunPendingMaintenanceOptions as a0, type RunPendingMaintenanceResult as a1, type SupersedeReplacement as a2, type VectorRanker as a3, type VectorRankerFallback as a4, type VectorRankerRankArgs as a5, type VectorRankerSemanticResult as a6, WikiBusyError as a7, type WikiBusyOperation as a8, type WikiCheckpoint as a9, validateManifest as aA, EmbeddingService as aB, ImportExportService as aC, IngestionService as aD, JobManager as aE, MaintenanceService as aF, RetrievalService as aG, SearchService as aH, WriteService as aI, type WikiConfig as aa, type WikiDiagnostic as ab, type WikiDiagnosticCode as ac, type WikiDiagnosticDetail as ad, type WikiDiagnosticOperation as ae, type WikiDiagnosticSeverity as af, type WikiDiagnosticTrigger as ag, WikiDraftNotFound as ah, WikiDuplicateHashError as ai, type WikiEdge as aj, type WikiEvent as ak, type WikiFact as al, WikiGraphNodeOwnershipConflict as am, WikiIngestEmptyError as an, type WikiInstructions as ao, WikiInvalidReadOptions as ap, type WikiLintReport as aq, type WikiMemoryTestAccess as ar, type WikiOutboxEvent as as, WikiParseError as at, WikiSourceRefHashCollision as au, WikiStrictOntologyViolation as av, WikiSupersedeError as aw, type WikiSupersedeReason as ax, type WikiTask as ay, WikiTransactionError as az, 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 EntityMaintenanceReport as k, type EntityStatus as l, type ExtractedFact as m, type ExtractedFactEdge as n, type ExtractedFactWithOntology as o, type ExtractedTask as p, type GraphTraversalOptions as q, type GroundingConfig as r, HEAL_RECHECK_MS as s, HOOK_TIMEOUT_MARKER as t, type HealResult as u, type LibrarianConfig as v, type LibrarianGateConfig as w, type MaintenanceJob as x, type MaintenanceStopReason as y, ONTOLOGY_BACKFILL_MAX_PROMPT_CHARS as z };
+export { PromptService as $, ONTOLOGY_BACKFILL_MAX_PROMPT_CHARS as A, ONTOLOGY_BACKFILL_RECHECK_MS 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 OntologyBackfillResult as J, type OntologyConfig as K, type LLMProvider as L, type MemoryBundle as M, type OntologyEdgeType as N, ONTOLOGY_BACKFILL_BATCH_SIZE as O, type OntologyManifest as P, type OntologyMode as Q, type ReadOptions as R, type SQLiteAdapter as S, type OntologyNodeType as T, type OntologyPromptContext as U, type OntologyUpdates as V, type WikiOptions as W, type PendingMaintenance as X, type PendingMigrationWork as Y, type PendingSourceStatus as Z, type PromptOverrides as _, type MemoryDump as a, PrunePartialFailureError as a0, type ReembedResult as a1, type RunPendingMaintenanceOptions as a2, type RunPendingMaintenanceResult as a3, type SupersedeReplacement as a4, type VectorRanker as a5, type VectorRankerFallback as a6, type VectorRankerRankArgs as a7, type VectorRankerSemanticResult as a8, WikiBusyError as a9, WikiSupersedeError as aA, type WikiSupersedeReason as aB, type WikiTask as aC, WikiTransactionError as aD, isWikiSearchUnavailableError 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 WikiBusyOperation as aa, type WikiCheckpoint as ab, type WikiConfig as ac, type WikiDiagnostic as ad, type WikiDiagnosticCode as ae, type WikiDiagnosticDetail as af, type WikiDiagnosticOperation as ag, type WikiDiagnosticSeverity as ah, type WikiDiagnosticTrigger as ai, WikiDraftNotFound as aj, WikiDuplicateHashError as ak, type WikiEdge as al, type WikiEvent as am, type WikiFact as an, WikiGraphNodeOwnershipConflict as ao, WikiIngestEmptyError as ap, type WikiInstructions as aq, WikiInvalidReadOptions as ar, type WikiLintReport as as, type WikiMemoryTestAccess as at, WikiMigrationRequiredError as au, type WikiOutboxEvent as av, WikiParseError as aw, WikiSearchUnavailableError as ax, WikiSourceRefHashCollision as ay, WikiStrictOntologyViolation as az, 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 EntityMaintenanceReport as k, type EntityStatus as l, type ExtractedFact as m, type ExtractedFactEdge as n, type ExtractedFactWithOntology as o, type ExtractedTask as p, type GraphTraversalOptions as q, type GroundingConfig as r, HEAL_RECHECK_MS as s, HOOK_TIMEOUT_MARKER as t, type HealResult as u, type LibrarianConfig as v, type LibrarianGateConfig as w, type MaintenanceJob as x, type MaintenanceStopReason as y, type MigrationPolicy as z };

package/dist/testing.d.mts

@@ -1,2 +1,2 @@
-export { aB as EmbeddingService, aC as ImportExportService, aD as IngestionService, aE as JobManager, aE as JobManagerType, aF as MaintenanceService, aG as RetrievalService, aH as SearchService, aH as SearchServiceType, ar as WikiMemoryTestAccess, aI as WriteService } from './testing-B0UtFCq1.mjs';
+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, at as WikiMemoryTestAccess, aN as WriteService } from './testing-7d76Ptlq.mjs';
 import '@equationalapplications/core-okf';

package/dist/testing.d.ts

@@ -1,2 +1,2 @@
-export { aB as EmbeddingService, aC as ImportExportService, aD as IngestionService, aE as JobManager, aE as JobManagerType, aF as MaintenanceService, aG as RetrievalService, aH as SearchService, aH as SearchServiceType, ar as WikiMemoryTestAccess, aI as WriteService } from './testing-B0UtFCq1.js';
+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, at as WikiMemoryTestAccess, aN as WriteService } from './testing-7d76Ptlq.js';
 import '@equationalapplications/core-okf';