@equationalapplications/core-llm-wiki 7.2.1 → 7.4.0

package/dist/index.mjs

@@ -1,5 +1,5 @@
-import { __privateAdd, MetadataRepository, EmbeddingService, SearchService, JobManager, PromptService, IngestionService, MaintenanceService, ImportExportService, RetrievalService, WriteService, __privateGet, __privateSet, normalizeSourceRef, normalizeSourceHash, entitySummaryMetaKey, WikiSourceRefHashCollision, validateManifest, generateId, BaseRepository, WikiGraphNodeOwnershipConflict, emptyManifest, resolveNodeType, WikiStrictOntologyViolation, validateInlineEdges, resolveEdgeDefinitions, typeSatisfies, normalizeTitleKey, WikiTransactionError, extractSqliteCode } from './chunk-TTECJ3S3.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, WikiDuplicateHashError, WikiGraphNodeOwnershipConflict, WikiIngestEmptyError, WikiInvalidReadOptions, WikiParseError, WikiSourceRefHashCollision, WikiStrictOntologyViolation, WikiTransactionError, chunkText, configureRandomSource, parseEmbedding, safeSlice, validateManifest } from './chunk-TTECJ3S3.mjs';
+import { __privateAdd, MetadataRepository, EmbeddingService, SearchService, JobManager, PromptService, IngestionService, MaintenanceService, ImportExportService, RetrievalService, WriteService, __privateGet, __privateSet, normalizeSourceRef, normalizeSourceHash, entitySummaryMetaKey, WikiSourceRefHashCollision, DiagnosticBuffer, validateManifest, WikiDraftNotFound, generateId, BaseRepository, WikiGraphNodeOwnershipConflict, emptyManifest, resolveNodeType, WikiStrictOntologyViolation, validateInlineEdges, resolveEdgeDefinitions, typeSatisfies, normalizeTitleKey, WikiTransactionError, extractSqliteCode } from './chunk-G5OR2VWD.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, WikiTransactionError, chunkText, configureRandomSource, parseEmbedding, safeSlice, validateManifest } from './chunk-G5OR2VWD.mjs';
 import { appendRelatedSection, buildConceptDocument, buildLogMd, buildEntityIndexMd, buildRootIndexMd, isAllowedOkfPath, parseRootIndexMd, parseEntityIndexMd, parseConcept, splitRelatedSection, extractMarkdownLinks, parseLogMd, parseEventIdComment, latestVerified, formatSourcesJson, appendEventIdComment, parseVerifiedFlexible, parseCitationsList, deriveTrustTier, isStaleAfter } from '@equationalapplications/core-okf';
 
 // src/db/schema.ts
@@ -1569,16 +1569,52 @@ var EntryRepository = class extends BaseRepository {
       `UPDATE ${this.prefix}entries SET source_type = 'librarian_inferred' WHERE source_type = 'agent_inferred';`
     ].join("\n");
   }
-  async findRecentByEntityIds(entityIds, limit, tx) {
+  async findRecentByEntityIds(entityIds, limit, tx, opts) {
     if (entityIds.length === 0) return [];
     const executor = this.getExecutor(tx);
     const placeholders = entityIds.map(() => "?").join(",");
+    const draftClause = opts?.excludeDrafts === true ? ` AND lifecycle_status != 'draft'` : "";
     const rows = await executor.getAllAsync(
-      `SELECT * FROM ${this.prefix}entries WHERE entity_id IN (${placeholders}) AND deleted_at IS NULL ORDER BY updated_at DESC LIMIT ?`,
+      `SELECT * FROM ${this.prefix}entries WHERE entity_id IN (${placeholders}) AND deleted_at IS NULL${draftClause} ORDER BY updated_at DESC LIMIT ?`,
       [...entityIds, limit]
     );
     return rows.map(mapRowToFact);
   }
+  /** IDs of live draft facts for the given entities (spec §5.1). Callers pass ≤ 100 entity ids. */
+  async findDraftIdsByEntityIds(entityIds, tx) {
+    if (entityIds.length === 0) return /* @__PURE__ */ new Set();
+    const executor = this.getExecutor(tx);
+    const placeholders = entityIds.map(() => "?").join(",");
+    const rows = await executor.getAllAsync(
+      `SELECT id FROM ${this.prefix}entries
+       WHERE entity_id IN (${placeholders}) AND deleted_at IS NULL AND lifecycle_status = 'draft'`,
+      [...entityIds]
+    );
+    return new Set(rows.map((r) => r.id));
+  }
+  /** Live drafts for one entity, newest first, keyset-paged by (created_at, id). */
+  async listDraftsByEntityId(entityId, limit, after, tx) {
+    const executor = this.getExecutor(tx);
+    const afterClause = after ? ` AND (created_at < ? OR (created_at = ? AND id < ?))` : "";
+    const args = after ? [entityId, after.createdAt, after.createdAt, after.id, limit] : [entityId, limit];
+    const rows = await executor.getAllAsync(
+      `SELECT * FROM ${this.prefix}entries
+       WHERE entity_id = ? AND deleted_at IS NULL AND lifecycle_status = 'draft'${afterClause}
+       ORDER BY created_at DESC, id DESC LIMIT ?`,
+      args
+    );
+    return rows.map(mapRowToFact);
+  }
+  /** True iff `entryId` is a live draft owned by `entityId`. */
+  async isLiveDraft(entryId, entityId, tx) {
+    const executor = this.getExecutor(tx);
+    const row = await executor.getFirstAsync(
+      `SELECT id FROM ${this.prefix}entries
+       WHERE id = ? AND entity_id = ? AND deleted_at IS NULL AND lifecycle_status = 'draft'`,
+      [entryId, entityId]
+    );
+    return row != null;
+  }
   /**
    * Live untyped facts eligible for ontology backfill, oldest first.
    * Skips facts checked within the recheck cooldown (ontology_checked_at > recheckCutoff).
@@ -2365,6 +2401,7 @@ var EdgeRepository = class extends BaseRepository {
             END
           ) >= ?
           AND n.source_type NOT IN (${excludeSourceTypesPlaceholders})
+          AND (? = 0 OR n.lifecycle_status != 'draft')
         WHERE w.depth < ?
           AND instr(w.visited, ',' || (CASE WHEN e.source_id = w.node_id THEN e.target_id ELSE e.source_id END) || ',') = 0
       )
@@ -2384,6 +2421,7 @@ var EdgeRepository = class extends BaseRepository {
       entityId,
       minConfidenceRank,
       ...opts.excludeSourceTypes,
+      opts.excludeDrafts === true ? 1 : 0,
       opts.maxDepth,
       opts.maxNodes
     ];
@@ -2499,6 +2537,17 @@ var OntologyService = class {
     const canonical = resolveNodeType(rawType, manifest);
     if (!canonical) {
       if (strict) throw new WikiStrictOntologyViolation(opts?.entityId ?? "", "node", rawType);
+      if (opts?.drops && Array.isArray(fact.edges)) {
+        for (const edge of fact.edges) {
+          opts.drops.push({
+            reason: "no_source_type",
+            sourceId: null,
+            edgeType: typeof edge?.edge_type === "string" ? edge.edge_type : null,
+            sourceNodeType: null,
+            targetNodeType: null
+          });
+        }
+      }
       return { okf_type: null, edges: [] };
     }
     const edges = validateInlineEdges(canonical, null, fact.edges ?? [], manifest, opts);
@@ -2511,18 +2560,39 @@ var OntologyService = class {
    * writes inside their own transaction (e.g. `IngestionService.ingestDocument`
    * when delegating to `upsertGraphCore`).
    */
-  resolveEdges(entityId, sourceId, sourceType, edges, manifest, titleIndex, now) {
-    if (!sourceType || edges.length === 0) return [];
+  resolveEdges(entityId, sourceId, sourceType, edges, manifest, titleIndex, now, drops) {
+    if (edges.length === 0) return [];
+    if (!sourceType) {
+      for (const edge of edges) {
+        drops?.push({ reason: "no_source_type", sourceId, edgeType: edge.edge_type, sourceNodeType: null, targetNodeType: null });
+      }
+      return [];
+    }
     const out = [];
     for (const edge of edges) {
       const candidates = resolveEdgeDefinitions(edge.edge_type, manifest).filter((d) => typeSatisfies(d.source_type, sourceType, manifest));
-      if (candidates.length === 0) continue;
+      if (candidates.length === 0) {
+        drops?.push({ reason: "type_not_in_manifest", sourceId, edgeType: edge.edge_type, sourceNodeType: sourceType, targetNodeType: null });
+        continue;
+      }
       const targetKey = normalizeTitleKey(edge.target_title);
       const target = titleIndex.get(targetKey);
-      if (!target) continue;
+      if (!target) {
+        drops?.push({ reason: "target_not_found", sourceId, edgeType: edge.edge_type, sourceNodeType: sourceType, targetNodeType: null });
+        continue;
+      }
       const targetType = (target.okf_type ?? "").trim().toLowerCase();
       const def = candidates.find((d) => d.target_type.trim().toLowerCase() === targetType) ?? candidates.find((d) => typeSatisfies(d.target_type, targetType, manifest));
-      if (!def) continue;
+      if (!def) {
+        drops?.push({
+          reason: "target_type_mismatch",
+          sourceId,
+          edgeType: edge.edge_type,
+          sourceNodeType: sourceType,
+          targetNodeType: target.okf_type ?? null
+        });
+        continue;
+      }
       out.push({
         id: generateId(),
         entity_id: entityId,
@@ -2541,8 +2611,8 @@ var OntologyService = class {
    * want self-contained edge persistence (e.g. MaintenanceService heal /
    * backfill callers that do not have a separate edge-write step).
    */
-  async resolveAndPersistEdges(entityId, sourceId, sourceType, edges, manifest, titleIndex, tx, now) {
-    const resolved = this.resolveEdges(entityId, sourceId, sourceType, edges, manifest, titleIndex, now);
+  async resolveAndPersistEdges(entityId, sourceId, sourceType, edges, manifest, titleIndex, tx, now, drops) {
+    const resolved = this.resolveEdges(entityId, sourceId, sourceType, edges, manifest, titleIndex, now, drops);
     let persisted = 0;
     for (const edge of resolved) {
       const inserted = await this.edgeRepo.addIgnoreDuplicate(edge, tx);
@@ -2571,6 +2641,7 @@ var GraphTraversalService = class {
       edgeTypes: options.edgeTypes,
       minConfidence: options.minTraversalConfidence ?? this.config.minTraversalConfidence ?? "tentative",
       excludeSourceTypes: options.excludeSourceTypes ?? this.config.excludeSourceTypes ?? [],
+      excludeDrafts: options.excludeDrafts ?? this.config.excludeDrafts ?? false,
       maxNodes
     };
     const { nodeIds, edges } = await this.edgeRepo.getNeighborhood(entityId, options.sourceId, opts);
@@ -2744,6 +2815,15 @@ var OkfTrustWritesRepository = class {
 
 // src/WikiMemory.ts
 var TABLE_PREFIX_PATTERN = /^[A-Za-z][A-Za-z0-9_]{0,30}_$/;
+function decodeDraftCursor(cursor) {
+  const sep = typeof cursor === "string" ? cursor.indexOf(":") : -1;
+  const createdAt = sep > 0 ? Number(cursor.slice(0, sep)) : Number.NaN;
+  const id = sep > 0 ? cursor.slice(sep + 1) : "";
+  if (!Number.isSafeInteger(createdAt) || id.length === 0) {
+    throw new TypeError("Invalid listDrafts cursor.");
+  }
+  return { createdAt, id };
+}
 var _testAccessNonTestEnvWarned;
 var WikiMemory = class {
   constructor(db, options) {
@@ -3163,11 +3243,15 @@ var WikiMemory = class {
         attemptedSourceRef: sourceRef
       });
     }
-    return this.ingestionService.upsertGraphCore(
+    const diagBuffer = new DiagnosticBuffer();
+    const result = await this.ingestionService.upsertGraphCore(
       entityId,
       { sourceRef, sourceHash, nodes: params.nodes, edges: params.edges },
-      adapter
+      adapter,
+      { diag: { buffer: diagBuffer, operation: "upsertGraph" } }
     );
+    diagBuffer.flush(this.options);
+    return result;
   }
   /**
    * Returns up to `limit` unprocessed outbox events, oldest first.
@@ -3284,6 +3368,43 @@ var WikiMemory = class {
   async setLifecycleStatus(entryId, entityId, status) {
     return this.okfTrustWrites.setLifecycleStatus(entryId, entityId, status);
   }
+  /**
+   * Live draft facts for one entity, newest first (spec §5.2). Default page
+   * size 50, clamped to [1, 500]. Pass `nextCursor` back unchanged for the next page.
+   */
+  async listDrafts(entityId, options) {
+    const rawLimit = options?.limit;
+    const limit = typeof rawLimit === "number" && Number.isFinite(rawLimit) ? Math.min(500, Math.max(1, Math.floor(rawLimit))) : 50;
+    const after = options?.cursor === void 0 ? null : decodeDraftCursor(options.cursor);
+    const rows = await this.entryRepo.listDraftsByEntityId(entityId, limit + 1, after);
+    const facts = rows.slice(0, limit);
+    const last = facts[facts.length - 1];
+    return {
+      facts,
+      nextCursor: rows.length > limit && last ? `${last.created_at}:${last.id}` : null
+    };
+  }
+  /**
+   * Promote a draft to `stable` and record who reviewed it, atomically
+   * (spec §5.2). Metadata writes only: `updated_at` is not bumped and no
+   * outbox event is pushed. Pass `by: 'human:<id>'` so `trustTier` becomes
+   * `'human-reviewed'`.
+   *
+   * @throws WikiDraftNotFound when no live draft with that id exists for the entity.
+   */
+  async promoteDraft(entryId, entityId, reviewer) {
+    const by = reviewer?.by;
+    if (typeof by !== "string" || by.trim().length === 0) {
+      throw new TypeError("promoteDraft requires reviewer.by to be a non-empty string.");
+    }
+    await this.db.withTransactionAsync(async (tx) => {
+      if (!await this.entryRepo.isLiveDraft(entryId, entityId, tx)) {
+        throw new WikiDraftNotFound();
+      }
+      await this.okfTrustWrites.setLifecycleStatus(entryId, entityId, "stable", tx);
+      await this.okfTrustWrites.writeOkfTrust(entryId, entityId, [{ by, at: (/* @__PURE__ */ new Date()).toISOString() }], tx);
+    });
+  }
   /** Set a fact's stale_after (epoch ms) or clear it. Does NOT touch `updated_at`. */
   async setStaleAfter(entryId, entityId, date) {
     return this.okfTrustWrites.setStaleAfter(entryId, entityId, date);