@equationalapplications/core-llm-wiki 6.1.0 → 6.3.0

package/README.md

@@ -535,7 +535,11 @@ const wikiMemory = new WikiMemory(db, {
 });
 ```
 
-`seedManifests` entries are written to SQLite on first access when no row exists for that entity.
+`seedManifests` entries are written to SQLite the first time an entity's ontology is
+resolved *inside a transaction* (ingest, heal) and no row exists for it. A read outside a
+transaction — including `getOntologyManifest` — resolves the seed without persisting it, so
+a configured entity can report a manifest while still having no row in `entity_manifests`.
+That distinction matters for `ifAbsent` below.
 
 ### Public API
 
@@ -559,6 +563,37 @@ await wikiMemory.setOntologyManifest('team-alpha', {
 }, { mode: 'strict' });
 ```
 
+Seed several entities atomically — all manifests are written in one transaction,
+so a failure partway through leaves none of them behind:
+
+```typescript
+const { written, skipped } = await wikiMemory.setOntologyManifests(
+  [
+    { entityId: 'tier_fact', manifest, mode: 'strict' },
+    { entityId: 'tier_wisdom', manifest, mode: 'strict' },
+  ],
+  { ifAbsent: true },
+);
+// written: entities whose manifest this call wrote
+// skipped: entities that already had a persisted manifest (only under `ifAbsent`)
+```
+
+`ifAbsent` makes each write create-if-absent rather than an upsert, so a
+concurrent initializer loses the race by writing nothing instead of overwriting
+a manifest it never read. Omit it for replace-on-conflict, which is what
+`setOntologyManifest` does.
+
+**`ifAbsent` tests for a persisted row, not for an effective manifest.** An entity
+whose manifest comes from `WikiConfig.ontology.seedManifests` has no row until an
+ingest materializes one, so `ifAbsent` writes over the configured seed and reports
+the entity in `written`; after an ingest has run for that entity the same call
+reports it in `skipped`. Don't mix the two seeding routes for one entity: seed it
+through the config, or through this method, not both.
+
+The method takes data, never a transaction handle: `WikiMemory` serializes
+transactions on the adapter it is given, so a transaction opened on the adapter
+you passed to `createWiki` would not participate in that serialization.
+
 ### Fact Shape Extensions
 
 In **Strict** and **Emergent** modes, librarian and ingest JSON may include typed facts with inline edges:
@@ -1211,6 +1246,7 @@ The flowchart shows:
 | [@equationalapplications/core-llm-tools](https://github.com/equationalapplications/expo-llm-wiki/blob/main/packages/core-llm-tools/README.md) | Gemini tool schemas and capability injector |
 | [@equationalapplications/core-okf](https://github.com/equationalapplications/expo-llm-wiki/blob/main/packages/okf/README.md) | Zero-dependency Open Knowledge Format (OKF) v0.1 + v0.2 primitives — parse and produce interoperable knowledge bundles. |
 | [@equationalapplications/schema-org-llm-wiki](https://github.com/equationalapplications/expo-llm-wiki/blob/main/packages/schema-org/README.md) | Curated schema.org warm-agent ontology manifest |
+| [@equationalapplications/schema-software-org](https://github.com/equationalapplications/expo-llm-wiki/blob/main/packages/schema-software-org/README.md) | Software-organization executive ontology manifest — 17 node types, 40 edges, warm-agent superset, data-only |
 
 ## OKF v0.2 conformance (llm-wiki/2)
 

package/dist/{chunk-YEESP6J2.mjs → chunk-YDTJ2OO4.mjs}

@@ -2337,15 +2337,29 @@ var MetadataRepository = class extends BaseRepository {
       manifest
     };
   }
-  async setManifest(entityId, data, tx) {
+  /**
+   * 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.
+   */
+  async setManifest(entityId, data, tx, opts) {
     validateManifest(data.manifest);
     const executor = this.getExecutor(tx);
-    await executor.runAsync(
+    const conflictClause = opts?.ifAbsent ? "ON CONFLICT(entity_id) DO NOTHING" : `ON CONFLICT(entity_id) DO UPDATE SET
+           mode = excluded.mode, manifest_json = excluded.manifest_json, updated_at = excluded.updated_at`;
+    const result = await executor.runAsync(
       `INSERT INTO ${this.prefix}entity_manifests (entity_id, mode, manifest_json, updated_at)
        VALUES (?, ?, ?, ?)
-       ON CONFLICT(entity_id) DO UPDATE SET mode = excluded.mode, manifest_json = excluded.manifest_json, updated_at = excluded.updated_at`,
+       ${conflictClause}`,
       [entityId, data.mode, JSON.stringify(data.manifest), Date.now()]
     );
+    return result.changes > 0;
   }
   async mergeManifestUpdates(entityId, updates, tx) {
     const current = await this.getManifest(entityId, tx) ?? {
@@ -4620,5 +4634,5 @@ var WriteService = class {
 };
 
 export { BaseRepository, DEFAULT_CHUNK_OVERLAP, DEFAULT_MAX_CHUNK_LENGTH, EmbeddingService, HEAL_ANCHORS_PER_CANDIDATE, HEAL_BATCH_SIZE, HEAL_MAX_FACT_BODY_CHARS_L3, HEAL_MAX_TASKS, HEAL_RECHECK_MS, HOOK_TIMEOUT_MARKER, ImportExportService, IngestionService, JobManager, MaintenanceService, MetadataRepository, ONTOLOGY_BACKFILL_BATCH_SIZE, ONTOLOGY_BACKFILL_MAX_PROMPT_CHARS, ONTOLOGY_BACKFILL_RECHECK_MS, ONTOLOGY_BACKFILL_SYSTEM_PROMPT, PromptService, PrunePartialFailureError, RetrievalService, SearchService, WikiBusyError, WikiDuplicateHashError, WikiIngestEmptyError, WikiParseError, WikiSourceRefHashCollision, WikiStrictOntologyViolation, WikiTransactionError, WriteService, __privateAdd, __privateGet, __privateSet, chunkText, configureRandomSource, emptyManifest, entitySummaryMetaKey, extractSqliteCode, generateId, normalizeSourceHash, normalizeSourceRef, normalizeTitleKey, parseEmbedding, resolveEdgeDefinitions, resolveNodeType, safeSlice, typeSatisfies, validateInlineEdges, validateManifest };
-//# sourceMappingURL=chunk-YEESP6J2.mjs.map
-//# sourceMappingURL=chunk-YEESP6J2.mjs.map
+//# sourceMappingURL=chunk-YDTJ2OO4.mjs.map
+//# sourceMappingURL=chunk-YDTJ2OO4.mjs.map