@equationalapplications/core-llm-wiki 7.8.0 → 7.9.0

package/dist/index.mjs

@@ -1,5 +1,5 @@
-import { BaseRepository, WikiGraphNodeOwnershipConflict, liveAtSql, __privateAdd, MetadataRepository, EmbeddingService, SearchService, TemporalService, JobManager, PromptService, resolveGrounding, IngestionService, MaintenanceService, ImportExportService, RetrievalService, WriteService, __privateGet, __privateSet, normalizeSourceRef, normalizeSourceHash, entitySummaryMetaKey, WikiSourceRefHashCollision, DiagnosticBuffer, validateManifest, WikiDraftNotFound, generateId, emptyManifest, resolveNodeType, WikiStrictOntologyViolation, validateInlineEdges, resolveEdgeDefinitions, typeSatisfies, normalizeTitleKey, edgeTripleAllowed, MAX_EMBED_ATTEMPTS, UsageMeter, WikiBusyError, WikiInvalidReadOptions, isLiveAt, packFactsByBudget, factTokenCost, WikiTransactionError, extractSqliteCode } from './chunk-M76CF2Q6.mjs';
-export { DEFAULT_CHUNK_OVERLAP, DEFAULT_MAX_CHUNK_LENGTH, DEFAULT_MAX_EMBED_CHARS, EMBED_CHARS_CEILING, HEAL_ANCHORS_PER_CANDIDATE, HEAL_BATCH_SIZE, HEAL_MAX_FACT_BODY_CHARS_L3, HEAL_MAX_TASKS, HEAL_RECHECK_MS, HOOK_TIMEOUT_MARKER, ONTOLOGY_BACKFILL_BATCH_SIZE, ONTOLOGY_BACKFILL_MAX_PROMPT_CHARS, ONTOLOGY_BACKFILL_RECHECK_MS, ONTOLOGY_BACKFILL_SYSTEM_PROMPT, PromptService, PrunePartialFailureError, WikiBusyError, WikiDraftNotFound, WikiDuplicateHashError, WikiGraphNodeOwnershipConflict, WikiIngestEmptyError, WikiInvalidReadOptions, WikiParseError, WikiSourceRefHashCollision, WikiStrictOntologyViolation, WikiSupersedeError, WikiTransactionError, chunkText, configureRandomSource, parseEmbedding, safeSlice, validateManifest } from './chunk-M76CF2Q6.mjs';
+import { BaseRepository, WikiGraphNodeOwnershipConflict, liveAtSql, __privateAdd, MetadataRepository, EmbeddingService, SearchService, TemporalService, JobManager, PromptService, resolveGrounding, IngestionService, MaintenanceService, ImportExportService, RetrievalService, WriteService, __privateGet, __privateSet, normalizeSourceRef, normalizeSourceHash, entitySummaryMetaKey, WikiSourceRefHashCollision, DiagnosticBuffer, validateManifest, WikiDraftNotFound, generateId, emptyManifest, resolveNodeType, WikiStrictOntologyViolation, validateInlineEdges, resolveEdgeDefinitions, typeSatisfies, normalizeTitleKey, edgeTripleAllowed, MAX_EMBED_ATTEMPTS, UsageMeter, WikiBusyError, WikiInvalidReadOptions, isLiveAt, packFactsByBudget, factTokenCost, WikiTransactionError, extractSqliteCode } from './chunk-J2TWKOEE.mjs';
+export { DEFAULT_CHUNK_OVERLAP, DEFAULT_MAX_CHUNK_LENGTH, DEFAULT_MAX_EMBED_CHARS, EMBED_CHARS_CEILING, HEAL_ANCHORS_PER_CANDIDATE, HEAL_BATCH_SIZE, HEAL_MAX_FACT_BODY_CHARS_L3, HEAL_MAX_TASKS, HEAL_RECHECK_MS, HOOK_TIMEOUT_MARKER, ONTOLOGY_BACKFILL_BATCH_SIZE, ONTOLOGY_BACKFILL_MAX_PROMPT_CHARS, ONTOLOGY_BACKFILL_RECHECK_MS, ONTOLOGY_BACKFILL_SYSTEM_PROMPT, PromptService, PrunePartialFailureError, WikiBusyError, WikiDraftNotFound, WikiDuplicateHashError, WikiGraphNodeOwnershipConflict, WikiIngestEmptyError, WikiInvalidReadOptions, WikiParseError, WikiSourceRefHashCollision, WikiStrictOntologyViolation, WikiSupersedeError, WikiTransactionError, chunkText, configureRandomSource, parseEmbedding, safeSlice, validateManifest } from './chunk-J2TWKOEE.mjs';
 import { deriveTrustTier, isStaleAfter, appendRelatedSection, buildConceptDocument, buildLogMd, buildEntityIndexMd, buildRootIndexMd, isAllowedOkfPath, parseRootIndexMd, parseEntityIndexMd, parseConcept, splitRelatedSection, extractMarkdownLinks, parseLogMd, parseEventIdComment, latestVerified, formatSourcesJson, appendEventIdComment, parseVerifiedFlexible, parseCitationsList } from '@equationalapplications/core-okf';
 
 // src/db/schema.ts
@@ -3902,6 +3902,32 @@ var WikiMemory = class {
   clearVectorCache() {
     this.searchService.evictCache();
   }
+  /**
+   * 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.
+   */
+  async syncSearchIndex(entityId) {
+    if (entityId === void 0) return this.searchService.syncStale();
+    assertEntityId(entityId);
+    return this.searchService.syncEntries(entityId, []);
+  }
   async exportDump(entityIds) {
     return this.importExportService.exportDump(entityIds);
   }
@@ -3948,9 +3974,11 @@ var WikiMemory = class {
    * 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