@equationalapplications/core-llm-wiki 5.3.1 → 5.4.0

package/README.md

@@ -998,6 +998,30 @@ The flowchart shows:
 | [@equationalapplications/core-okf](https://github.com/equationalapplications/expo-llm-wiki/blob/main/packages/okf/README.md) | Zero-dependency Open Knowledge Format (OKF) v0.1 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 |
 
+## OKF v0.2 conformance (llm-wiki/2)
+
+`formatOkfBundle` defaults to `okf_version: 0.2` + `profile: llm-wiki/2`. To force a v0.1 export, pass `{ profile: 'llm-wiki/1' }`:
+
+```ts
+formatOkfBundle(dump, { profile: 'llm-wiki/1' });
+```
+
+`parseOkfBundle` auto-detects the profile from the root index frontmatter:
+
+- `profile === 'llm-wiki/2'` → v0.2 path (new fields populated).
+- `profile === 'llm-wiki/1'` → v0.1 path (unchanged behavior).
+- `profile === undefined && okf_version === '0.1'` → v0.1 legacy path.
+- `profile === undefined && okf_version === undefined` → profile-0 (legacy) path.
+
+New public methods on `WikiMemory` for OKF v0.2 trust/provenance writes (each DAO method omits `updated_at` from its SQL):
+
+- `writeOkfTrust(entryId, entityId, verified)`
+- `writeOkfSources(entryId, entityId, sources)`
+- `setLifecycleStatus(entryId, entityId, status)`
+- `setStaleAfter(entryId, entityId, date | null)`
+- `setGeneratedBy(entryId, entityId, actor)`
+- (and `…Task` variants of all five)
+
 ## License
 
 MIT

package/dist/{chunk-KIJINNYU.mjs → chunk-N2NXN6PO.mjs}

@@ -1,4 +1,5 @@
 import MiniSearch from 'minisearch';
+import { latestVerified } from '@equationalapplications/core-okf';
 
 var __typeError = (msg) => {
   throw TypeError(msg);
@@ -2686,8 +2687,6 @@ var MaintenanceService = class {
     return sanitizeRankerError(err, this.options.sanitizeRankerErrors);
   }
 };
-
-// src/services/ImportExportService.ts
 var MAX_EMBEDDING_BLOB_BYTES = 32 * 1024;
 var IMPORT_TITLE_MAX = 500;
 var IMPORT_BODY_MAX = 8e3;
@@ -2907,7 +2906,23 @@ var ImportExportService = class {
           access_count: fact.access_count,
           deleted_at: fact.deleted_at,
           embedding_blob: blobData ?? void 0,
-          okf_type: fact.okf_type ?? null
+          okf_type: fact.okf_type ?? null,
+          // OKF v0.2 — forwarded as-is; parseOkfBundle / the caller is responsible for
+          // populating these per spec, importDump does not derive or validate them.
+          lifecycle_status: fact.lifecycle_status ?? "stable",
+          stale_after: fact.stale_after ?? null,
+          generated_by: fact.generated_by ?? null,
+          okf_sources: fact.okf_sources ?? [],
+          okf_verified: fact.okf_verified ?? [],
+          okf_usage_window: fact.okf_usage_window ?? null,
+          // last_verified_at/_by are DERIVED mirrors of `okf_verified` per spec
+          // §5.3. Recomputing here (instead of trusting the payload field) closes
+          // the invariant that a raw importDump cannot carry a
+          // last_verified_by that contradicts its own okf_verified list.
+          ...(() => {
+            const latest = latestVerified(fact.okf_verified ?? [], Date.now());
+            return { last_verified_at: latest?.at ?? null, last_verified_by: latest?.by ?? null };
+          })()
         };
         await this.entryRepo.upsertForImport(factObj, tx);
         if (blobData != null) {
@@ -2957,7 +2972,19 @@ var ImportExportService = class {
             updated_at: safeUpdatedAt,
             resolved_at: task.resolved_at,
             deleted_at: task.deleted_at,
-            okf_type: task.okf_type ?? null
+            okf_type: task.okf_type ?? null,
+            // OKF v0.2
+            lifecycle_status: task.lifecycle_status ?? "stable",
+            stale_after: task.stale_after ?? null,
+            generated_by: task.generated_by ?? null,
+            okf_sources: task.okf_sources ?? [],
+            okf_verified: task.okf_verified ?? [],
+            okf_usage_window: task.okf_usage_window ?? null,
+            // Derived mirrors — see fact branch above; same invariant.
+            ...(() => {
+              const latest = latestVerified(task.okf_verified ?? [], Date.now());
+              return { last_verified_at: latest?.at ?? null, last_verified_by: latest?.by ?? null };
+            })()
           },
           tx,
           safeUpdatedAt
@@ -3914,5 +3941,5 @@ var WriteService = class {
 };
 
 export { BaseRepository, DEFAULT_CHUNK_OVERLAP, DEFAULT_MAX_CHUNK_LENGTH, EmbeddingService, HEAL_BATCH_SIZE, 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, WikiSourceRefHashCollision, WikiStrictOntologyViolation, WikiTransactionError, WriteService, __privateAdd, __privateGet, __privateSet, chunkText, configureRandomSource, emptyManifest, entitySummaryMetaKey, extractSqliteCode, generateId, normalizeSourceHash, normalizeSourceRef, normalizeTitleKey, parseEmbedding, resolveEdgeDefinitions, resolveNodeType, safeSlice, validateInlineEdges, validateManifest };
-//# sourceMappingURL=chunk-KIJINNYU.mjs.map
-//# sourceMappingURL=chunk-KIJINNYU.mjs.map
+//# sourceMappingURL=chunk-N2NXN6PO.mjs.map
+//# sourceMappingURL=chunk-N2NXN6PO.mjs.map