@equationalapplications/core-llm-wiki 7.8.0 → 7.9.0

package/dist/{testing-CWZaXKLj.d.mts → testing-Kb1uVj1E.d.mts}

@@ -2023,6 +2023,13 @@ declare class SearchService {
      * cannot index itself, such as upsertGraph inside a host transaction.
      */
     markStale(entityId: string): void;
+    /**
+     * Runs syncEntries(id, []) for each entity marked stale when this is called,
+     * so only those entities are rebuilt. Each rebuild still takes its own turn
+     * on the sync chain, and like syncEntries this never rejects. With nothing
+     * stale it resolves at once, without waiting on work already on the chain.
+     */
+    syncStale(): Promise<void>;
     /**
      * Clears the parsed vector cache. Useful for mid-loop flush guarantees
      * or memory pressure evictions.
@@ -3486,6 +3493,28 @@ declare class WikiMemory {
     getEntityStatus(entityId: string): EntityStatus;
     subscribeEntityStatus(entityId: string, callback: (status: EntityStatus) => void): () => void;
     clearVectorCache(): void;
+    /**
+     * Brings the keyword search index up to date with SQLite after a host
+     * transaction that used `upsertGraph` has committed. Core never sees that
+     * commit, so without this the nodes stay out of keyword, hybrid and
+     * fallback retrieval until the entity's next core write.
+     *
+     * With `entityId`, rebuilds that entity if it is stale or has never been
+     * 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.
+     *
+     * 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
+     * stale flag anyway. Serialized with core's internal index syncs and takes
+     * no maintenance lock. Never rejects for a valid `entityId` — on failure the
+     * entity stays stale and the next call retries it. Does not compute
+     * embeddings; that remains the maintenance sweep's job.
+     *
+     * @throws {TypeError} when `entityId` is given but is not a non-empty string.
+     */
+    syncSearchIndex(entityId?: string): Promise<void>;
     exportDump(entityIds?: string[]): Promise<MemoryDump>;
     /** Entity summary prose persisted from an OKF profile ≥ 1 import; null when none stored. */
     getEntitySummary(entityId: string): Promise<string | null>;
@@ -3548,9 +3577,11 @@ declare class WikiMemory {
      * MUST be called from inside an open `db.withTransactionAsync` callback —
      * the third argument is the caller's `tx`. The method does not open a
      * nested transaction, does not acquire any lock, and does not perform
-     * post-commit work (search sync, embedding, cache eviction). Hosts that
-     * want embeddings synced should drive the existing maintenance sweep
-     * (`runLibrarian` / `runHeal` / `runOntologyBackfill` / `runPrune`,
+     * post-commit work (search sync, embedding, cache eviction). After the
+     * transaction commits, call `syncSearchIndex(entityId)` — or
+     * `syncSearchIndex()` after writing several entities in one transaction —
+     * to make the new nodes keyword-searchable. Embeddings still come from the maintenance
+     * sweep (`runLibrarian` / `runHeal` / `runOntologyBackfill` / `runPrune`,
      * scoped via `listEntityIds`).
      *
      * Contract (full pre-flight validation lives inside

package/dist/{testing-CWZaXKLj.d.ts → testing-Kb1uVj1E.d.ts}

@@ -2023,6 +2023,13 @@ declare class SearchService {
      * cannot index itself, such as upsertGraph inside a host transaction.
      */
     markStale(entityId: string): void;
+    /**
+     * Runs syncEntries(id, []) for each entity marked stale when this is called,
+     * so only those entities are rebuilt. Each rebuild still takes its own turn
+     * on the sync chain, and like syncEntries this never rejects. With nothing
+     * stale it resolves at once, without waiting on work already on the chain.
+     */
+    syncStale(): Promise<void>;
     /**
      * Clears the parsed vector cache. Useful for mid-loop flush guarantees
      * or memory pressure evictions.
@@ -3486,6 +3493,28 @@ declare class WikiMemory {
     getEntityStatus(entityId: string): EntityStatus;
     subscribeEntityStatus(entityId: string, callback: (status: EntityStatus) => void): () => void;
     clearVectorCache(): void;
+    /**
+     * Brings the keyword search index up to date with SQLite after a host
+     * transaction that used `upsertGraph` has committed. Core never sees that
+     * commit, so without this the nodes stay out of keyword, hybrid and
+     * fallback retrieval until the entity's next core write.
+     *
+     * With `entityId`, rebuilds that entity if it is stale or has never been
+     * 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.
+     *
+     * 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
+     * stale flag anyway. Serialized with core's internal index syncs and takes
+     * no maintenance lock. Never rejects for a valid `entityId` — on failure the
+     * entity stays stale and the next call retries it. Does not compute
+     * embeddings; that remains the maintenance sweep's job.
+     *
+     * @throws {TypeError} when `entityId` is given but is not a non-empty string.
+     */
+    syncSearchIndex(entityId?: string): Promise<void>;
     exportDump(entityIds?: string[]): Promise<MemoryDump>;
     /** Entity summary prose persisted from an OKF profile ≥ 1 import; null when none stored. */
     getEntitySummary(entityId: string): Promise<string | null>;
@@ -3548,9 +3577,11 @@ declare class WikiMemory {
      * MUST be called from inside an open `db.withTransactionAsync` callback —
      * the third argument is the caller's `tx`. The method does not open a
      * nested transaction, does not acquire any lock, and does not perform
-     * post-commit work (search sync, embedding, cache eviction). Hosts that
-     * want embeddings synced should drive the existing maintenance sweep
-     * (`runLibrarian` / `runHeal` / `runOntologyBackfill` / `runPrune`,
+     * post-commit work (search sync, embedding, cache eviction). After the
+     * transaction commits, call `syncSearchIndex(entityId)` — or
+     * `syncSearchIndex()` after writing several entities in one transaction —
+     * to make the new nodes keyword-searchable. Embeddings still come from the maintenance
+     * sweep (`runLibrarian` / `runHeal` / `runOntologyBackfill` / `runPrune`,
      * scoped via `listEntityIds`).
      *
      * Contract (full pre-flight validation lives inside

package/dist/testing.d.mts

@@ -1,3 +1,3 @@
-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-CWZaXKLj.mjs';
+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-Kb1uVj1E.mjs';
 import '@equationalapplications/core-okf';
 import 'minisearch';

package/dist/testing.d.ts

@@ -1,3 +1,3 @@
-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-CWZaXKLj.js';
+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-Kb1uVj1E.js';
 import '@equationalapplications/core-okf';
 import 'minisearch';

package/dist/testing.js

@@ -5558,6 +5558,16 @@ var _SearchService = class _SearchService {
     this.staleEntities.add(entityId);
     this.staleEpochs.set(entityId, (this.staleEpochs.get(entityId) ?? 0) + 1);
   }
+  /**
+   * Runs syncEntries(id, []) for each entity marked stale when this is called,
+   * so only those entities are rebuilt. Each rebuild still takes its own turn
+   * on the sync chain, and like syncEntries this never rejects. With nothing
+   * stale it resolves at once, without waiting on work already on the chain.
+   */
+  async syncStale() {
+    const ids = [...this.staleEntities];
+    await Promise.all(ids.map((id) => this.syncEntries(id, [])));
+  }
   /**
    * Clears the parsed vector cache. Useful for mid-loop flush guarantees
    * or memory pressure evictions.