@equationalapplications/core-llm-wiki 7.17.2 → 8.0.0

package/dist/{testing-DRB-65AM.d.mts → testing-De-WJ7xh.d.mts}

@@ -253,7 +253,7 @@ interface LibrarianGateConfig {
     /** Best-neighbour cosine below which a candidate is novel. Default 0.30 (calibrated against the 30 supersession scenarios). */
     novelThreshold?: number;
 }
-/** `'legacy'` is the 7.x add-only librarian. `'ops'` is the spec §5.1 / §5.3 dispatcher. */
+/** `'legacy'` is the 7.x add-only librarian. `'ops'` (default since 8.0.0) is the spec §5.1 / §5.3 dispatcher. */
 interface LibrarianConfig {
     strategy?: 'legacy' | 'ops';
     gate?: LibrarianGateConfig;
@@ -358,15 +358,16 @@ interface WikiConfig {
     grounding?: GroundingConfig;
     /** Emit an `llm_usage` diagnostic after every LLM text call. Default false. */
     reportLlmUsage?: boolean;
-    /** Librarian strategy selection (spec 2026-09-29 §5.1). Default `{ strategy: 'legacy' }`. */
+    /** Librarian strategy selection (spec 2026-09-29 §5.1). Default `{ strategy: 'ops' }` since 8.0.0. */
     librarian?: LibrarianConfig;
     /**
-     * `'auto'` (default): write() starts librarian/heal in the background when
-     * thresholds are crossed. `'deferred'`: write() only records the event; the
-     * host runs `runPendingMaintenance()` (spec 2026-09-29 §6). Pair with
-     * `librarian: { strategy: 'ops' }`: the legacy strategy reads only the
-     * newest 50 events per pass and advances the watermark past them, so a
-     * deferred backlog larger than that is never extracted.
+     * `'deferred'` (default since 8.0.0): write() only records the event, and
+     * nothing is extracted or healed until the host runs
+     * `runPendingMaintenance()` (spec 2026-09-29 §6). `'auto'`: write() starts
+     * librarian/heal in the background when thresholds are crossed. Don't pair
+     * `'deferred'` with `librarian: { strategy: 'legacy' }`: the legacy strategy
+     * reads only the newest 50 events per pass and advances the watermark past
+     * them, so a deferred backlog larger than that is never extracted.
      */
     maintenance?: 'auto' | 'deferred';
     /** `'auto'` mode only: also trigger the librarian when pending event text reaches ~this many tokens (chars/4). */
@@ -2815,7 +2816,7 @@ declare class PromptService {
      * placeholders and leaves data placeholders verbatim; heal never receives
      * ontology context, matching `buildHealPrompt`.
      */
-    buildInstructionTemplates(ontologyContext: OntologyPromptContext | null): WikiInstructions;
+    buildInstructionTemplates(ontologyContext: OntologyPromptContext | null, librarianStrategy: 'legacy' | 'ops'): WikiInstructions;
 }
 
 declare class IngestionService {

package/dist/{testing-DRB-65AM.d.ts → testing-De-WJ7xh.d.ts}

@@ -253,7 +253,7 @@ interface LibrarianGateConfig {
     /** Best-neighbour cosine below which a candidate is novel. Default 0.30 (calibrated against the 30 supersession scenarios). */
     novelThreshold?: number;
 }
-/** `'legacy'` is the 7.x add-only librarian. `'ops'` is the spec §5.1 / §5.3 dispatcher. */
+/** `'legacy'` is the 7.x add-only librarian. `'ops'` (default since 8.0.0) is the spec §5.1 / §5.3 dispatcher. */
 interface LibrarianConfig {
     strategy?: 'legacy' | 'ops';
     gate?: LibrarianGateConfig;
@@ -358,15 +358,16 @@ interface WikiConfig {
     grounding?: GroundingConfig;
     /** Emit an `llm_usage` diagnostic after every LLM text call. Default false. */
     reportLlmUsage?: boolean;
-    /** Librarian strategy selection (spec 2026-09-29 §5.1). Default `{ strategy: 'legacy' }`. */
+    /** Librarian strategy selection (spec 2026-09-29 §5.1). Default `{ strategy: 'ops' }` since 8.0.0. */
     librarian?: LibrarianConfig;
     /**
-     * `'auto'` (default): write() starts librarian/heal in the background when
-     * thresholds are crossed. `'deferred'`: write() only records the event; the
-     * host runs `runPendingMaintenance()` (spec 2026-09-29 §6). Pair with
-     * `librarian: { strategy: 'ops' }`: the legacy strategy reads only the
-     * newest 50 events per pass and advances the watermark past them, so a
-     * deferred backlog larger than that is never extracted.
+     * `'deferred'` (default since 8.0.0): write() only records the event, and
+     * nothing is extracted or healed until the host runs
+     * `runPendingMaintenance()` (spec 2026-09-29 §6). `'auto'`: write() starts
+     * librarian/heal in the background when thresholds are crossed. Don't pair
+     * `'deferred'` with `librarian: { strategy: 'legacy' }`: the legacy strategy
+     * reads only the newest 50 events per pass and advances the watermark past
+     * them, so a deferred backlog larger than that is never extracted.
      */
     maintenance?: 'auto' | 'deferred';
     /** `'auto'` mode only: also trigger the librarian when pending event text reaches ~this many tokens (chars/4). */
@@ -2815,7 +2816,7 @@ declare class PromptService {
      * placeholders and leaves data placeholders verbatim; heal never receives
      * ontology context, matching `buildHealPrompt`.
      */
-    buildInstructionTemplates(ontologyContext: OntologyPromptContext | null): WikiInstructions;
+    buildInstructionTemplates(ontologyContext: OntologyPromptContext | null, librarianStrategy: 'legacy' | 'ops'): WikiInstructions;
 }
 
 declare class IngestionService {

package/dist/testing.d.mts

@@ -1,2 +1,2 @@
-export { aH as EmbeddingService, aI as ImportExportService, aJ as IngestionService, aK as JobManager, aK as JobManagerType, aL as MaintenanceService, aM as RetrievalService, aN as SearchService, aN as SearchServiceType, au as WikiMemoryTestAccess, aO as WriteService } from './testing-DRB-65AM.mjs';
+export { aH as EmbeddingService, aI as ImportExportService, aJ as IngestionService, aK as JobManager, aK as JobManagerType, aL as MaintenanceService, aM as RetrievalService, aN as SearchService, aN as SearchServiceType, au as WikiMemoryTestAccess, aO as WriteService } from './testing-De-WJ7xh.mjs';
 import '@equationalapplications/core-okf';

package/dist/testing.d.ts

@@ -1,2 +1,2 @@
-export { aH as EmbeddingService, aI as ImportExportService, aJ as IngestionService, aK as JobManager, aK as JobManagerType, aL as MaintenanceService, aM as RetrievalService, aN as SearchService, aN as SearchServiceType, au as WikiMemoryTestAccess, aO as WriteService } from './testing-DRB-65AM.js';
+export { aH as EmbeddingService, aI as ImportExportService, aJ as IngestionService, aK as JobManager, aK as JobManagerType, aL as MaintenanceService, aM as RetrievalService, aN as SearchService, aN as SearchServiceType, au as WikiMemoryTestAccess, aO as WriteService } from './testing-De-WJ7xh.js';
 import '@equationalapplications/core-okf';

package/dist/testing.js

@@ -1907,11 +1907,11 @@ ${JSON.stringify({ items })}` };
    * placeholders and leaves data placeholders verbatim; heal never receives
    * ontology context, matching `buildHealPrompt`.
    */
-  buildInstructionTemplates(ontologyContext) {
+  buildInstructionTemplates(ontologyContext, librarianStrategy) {
     const o = this.globalOverrides;
     return {
       ingest: this.appendGrounding(this.buildSystemPrompt(o?.ingestSystemPrompt ?? INGEST_SYSTEM_PROMPT, {}, ontologyContext), "ingest"),
-      librarian: this.appendGrounding(this.buildSystemPrompt(o?.librarianSystemPrompt ?? LIBRARIAN_SYSTEM_PROMPT, {}, ontologyContext), "librarian"),
+      librarian: librarianStrategy === "ops" ? this.appendGrounding(this.appendOntology(OPS_EXTRACT_SYSTEM_PROMPT, ontologyContext), "librarian") : this.appendGrounding(this.buildSystemPrompt(o?.librarianSystemPrompt ?? LIBRARIAN_SYSTEM_PROMPT, {}, ontologyContext), "librarian"),
       heal: this.appendGrounding(o?.healSystemPrompt ?? HEAL_SYSTEM_PROMPT, "heal"),
       ontologyBackfill: this.buildSystemPrompt(o?.ontologyBackfillSystemPrompt ?? ONTOLOGY_BACKFILL_SYSTEM_PROMPT, {}, ontologyContext)
     };
@@ -2709,6 +2709,16 @@ function classifierStateForFact(fact) {
   return parts.join("\n\n");
 }
 
+// src/utils/engineDefaults.ts
+var DEFAULT_LIBRARIAN_STRATEGY = "ops";
+var DEFAULT_MAINTENANCE_MODE = "deferred";
+function resolveLibrarianStrategy(config) {
+  return config?.librarian?.strategy ?? DEFAULT_LIBRARIAN_STRATEGY;
+}
+function resolveMaintenanceMode(config) {
+  return config?.maintenance ?? DEFAULT_MAINTENANCE_MODE;
+}
+
 // src/utils/embedding.ts
 function parseEmbedding(blob, text) {
   if (blob && blob.byteLength > 0) {
@@ -3997,7 +4007,7 @@ var STRATEGIES = /* @__PURE__ */ new Map([
   ["ops", runOpsLibrarianPass]
 ]);
 async function runLibrarianStrategy(deps, ctx) {
-  const strategy = deps.options.config?.librarian?.strategy ?? "legacy";
+  const strategy = resolveLibrarianStrategy(deps.options.config);
   const fn = STRATEGIES.get(strategy);
   if (!fn) {
     throw new Error(`Unknown librarian strategy: ${strategy}`);
@@ -4146,7 +4156,7 @@ var MaintenanceService = class {
       }
       if (retainEventsFor !== null) {
         const cutoff = now - retainEventsFor * 864e5;
-        const guarded = this.options.config?.maintenance === "deferred" || this.options.config?.librarian?.strategy === "ops";
+        const guarded = resolveMaintenanceMode(this.options.config) === "deferred" || resolveLibrarianStrategy(this.options.config) === "ops";
         if (guarded) {
           const wm = await this.metadataRepo.getLibrarianWatermark(entityId, this.db);
           deletedEvents = (await this.eventRepo.pruneThrough(entityId, cutoff, wm)).changes;
@@ -6724,7 +6734,7 @@ var WriteService = class {
       created_at: now,
       occurred_at: occurredAt
     };
-    const deferred = this.options.config?.maintenance === "deferred";
+    const deferred = resolveMaintenanceMode(this.options.config) === "deferred";
     if (deferred) {
       await this.eventRepo.add(newEvent);
       return;