@equationalapplications/core-llm-wiki 6.1.0 → 6.3.0

package/dist/{testing-D0m2V9-E.d.mts → testing-BPwT0171.d.mts}

@@ -1244,10 +1244,23 @@ declare class MetadataRepository extends BaseRepository {
         mode: OntologyMode;
         manifest: OntologyManifest;
     } | null>;
+    /**
+     * Write an entity's manifest.
+     *
+     * `opts.ifAbsent` selects the conflict behaviour:
+     * - omitted / `false` — upsert. An existing row is replaced.
+     * - `true` — create-if-absent. An existing row is left exactly as it is.
+     *
+     * Returns whether this call actually wrote a row. Under `ifAbsent` a `false`
+     * result means another writer got there first; the check and the write are one
+     * statement, so there is no window between them.
+     */
     setManifest(entityId: string, data: {
         mode: OntologyMode;
         manifest: OntologyManifest;
-    }, tx: SQLiteAdapter): Promise<void>;
+    }, tx: SQLiteAdapter, opts?: {
+        ifAbsent?: boolean;
+    }): Promise<boolean>;
     mergeManifestUpdates(entityId: string, updates: OntologyUpdates, tx: SQLiteAdapter): Promise<OntologyManifest>;
 }
 
@@ -2339,10 +2352,44 @@ declare class WikiMemory {
      * Seeds or replaces an entity's ontology manifest and optional mode override.
      * Validates manifest invariants (unique type slugs, edge endpoints reference node types).
      * Invalidates the in-memory ontology cache for this entity.
+     *
+     * Delegates to `setOntologyManifests` so there is a single write path. The
+     * observable contract is unchanged: same upsert semantics, same cache
+     * invalidation, same `void` result.
      */
     setOntologyManifest(entityId: string, manifest: OntologyManifest, options?: {
         mode?: OntologyMode;
     }): Promise<void>;
+    /**
+     * Write several entities' ontology manifests in a single transaction.
+     *
+     * All succeed or none do. The transaction is opened on this instance's
+     * serialized adapter — callers pass data, never a transaction handle, because
+     * a consumer holds the unwrapped adapter and a transaction opened on it would
+     * bypass the serialization mutex applied in the constructor.
+     *
+     * Returns which entities were written. `skipped` is only ever non-empty under
+     * `opts.ifAbsent`.
+     *
+     * Sharp edge: `ifAbsent` checks for a PERSISTED row, not for an effective
+     * manifest. An entity whose manifest currently comes from
+     * `WikiConfig.ontology.seedManifests` has no row until the seed is
+     * materialized on first access that supplies a transaction (in practice, an
+     * ingest). Until then `ifAbsent` treats the entity as absent, writes the new
+     * manifest over the configured seed, and reports it in `written`; the same
+     * call after the seed has been materialized reports it in `skipped`. See the
+     * `ifAbsent` notes in the package README.
+     */
+    setOntologyManifests(entries: Array<{
+        entityId: string;
+        manifest: OntologyManifest;
+        mode?: OntologyMode;
+    }>, opts?: {
+        ifAbsent?: boolean;
+    }): Promise<{
+        written: string[];
+        skipped: string[];
+    }>;
     /** Append a verification event to a fact. Does NOT touch `updated_at`. */
     writeOkfTrust(entryId: string, entityId: string, verified: {
         by: string;

package/dist/{testing-D0m2V9-E.d.ts → testing-BPwT0171.d.ts}

@@ -1244,10 +1244,23 @@ declare class MetadataRepository extends BaseRepository {
         mode: OntologyMode;
         manifest: OntologyManifest;
     } | null>;
+    /**
+     * Write an entity's manifest.
+     *
+     * `opts.ifAbsent` selects the conflict behaviour:
+     * - omitted / `false` — upsert. An existing row is replaced.
+     * - `true` — create-if-absent. An existing row is left exactly as it is.
+     *
+     * Returns whether this call actually wrote a row. Under `ifAbsent` a `false`
+     * result means another writer got there first; the check and the write are one
+     * statement, so there is no window between them.
+     */
     setManifest(entityId: string, data: {
         mode: OntologyMode;
         manifest: OntologyManifest;
-    }, tx: SQLiteAdapter): Promise<void>;
+    }, tx: SQLiteAdapter, opts?: {
+        ifAbsent?: boolean;
+    }): Promise<boolean>;
     mergeManifestUpdates(entityId: string, updates: OntologyUpdates, tx: SQLiteAdapter): Promise<OntologyManifest>;
 }
 
@@ -2339,10 +2352,44 @@ declare class WikiMemory {
      * Seeds or replaces an entity's ontology manifest and optional mode override.
      * Validates manifest invariants (unique type slugs, edge endpoints reference node types).
      * Invalidates the in-memory ontology cache for this entity.
+     *
+     * Delegates to `setOntologyManifests` so there is a single write path. The
+     * observable contract is unchanged: same upsert semantics, same cache
+     * invalidation, same `void` result.
      */
     setOntologyManifest(entityId: string, manifest: OntologyManifest, options?: {
         mode?: OntologyMode;
     }): Promise<void>;
+    /**
+     * Write several entities' ontology manifests in a single transaction.
+     *
+     * All succeed or none do. The transaction is opened on this instance's
+     * serialized adapter — callers pass data, never a transaction handle, because
+     * a consumer holds the unwrapped adapter and a transaction opened on it would
+     * bypass the serialization mutex applied in the constructor.
+     *
+     * Returns which entities were written. `skipped` is only ever non-empty under
+     * `opts.ifAbsent`.
+     *
+     * Sharp edge: `ifAbsent` checks for a PERSISTED row, not for an effective
+     * manifest. An entity whose manifest currently comes from
+     * `WikiConfig.ontology.seedManifests` has no row until the seed is
+     * materialized on first access that supplies a transaction (in practice, an
+     * ingest). Until then `ifAbsent` treats the entity as absent, writes the new
+     * manifest over the configured seed, and reports it in `written`; the same
+     * call after the seed has been materialized reports it in `skipped`. See the
+     * `ifAbsent` notes in the package README.
+     */
+    setOntologyManifests(entries: Array<{
+        entityId: string;
+        manifest: OntologyManifest;
+        mode?: OntologyMode;
+    }>, opts?: {
+        ifAbsent?: boolean;
+    }): Promise<{
+        written: string[];
+        skipped: string[];
+    }>;
     /** Append a verification event to a fact. Does NOT touch `updated_at`. */
     writeOkfTrust(entryId: string, entityId: string, verified: {
         by: string;

package/dist/testing.d.mts

@@ -1,3 +1,3 @@
-export { a3 as EmbeddingService, a4 as ImportExportService, a5 as IngestionService, a6 as JobManager, a6 as JobManagerType, a7 as MaintenanceService, a8 as RetrievalService, a9 as SearchService, a9 as SearchServiceType, Y as WikiMemoryTestAccess, aa as WriteService } from './testing-D0m2V9-E.mjs';
+export { a3 as EmbeddingService, a4 as ImportExportService, a5 as IngestionService, a6 as JobManager, a6 as JobManagerType, a7 as MaintenanceService, a8 as RetrievalService, a9 as SearchService, a9 as SearchServiceType, Y as WikiMemoryTestAccess, aa as WriteService } from './testing-BPwT0171.mjs';
 import '@equationalapplications/core-okf';
 import 'minisearch';

package/dist/testing.d.ts

@@ -1,3 +1,3 @@
-export { a3 as EmbeddingService, a4 as ImportExportService, a5 as IngestionService, a6 as JobManager, a6 as JobManagerType, a7 as MaintenanceService, a8 as RetrievalService, a9 as SearchService, a9 as SearchServiceType, Y as WikiMemoryTestAccess, aa as WriteService } from './testing-D0m2V9-E.js';
+export { a3 as EmbeddingService, a4 as ImportExportService, a5 as IngestionService, a6 as JobManager, a6 as JobManagerType, a7 as MaintenanceService, a8 as RetrievalService, a9 as SearchService, a9 as SearchServiceType, Y as WikiMemoryTestAccess, aa as WriteService } from './testing-BPwT0171.js';
 import '@equationalapplications/core-okf';
 import 'minisearch';