@equationalapplications/core-llm-wiki 7.3.0 → 7.5.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, DiagnosticBuffer, validateManifest, generateId, BaseRepository, WikiGraphNodeOwnershipConflict, emptyManifest, resolveNodeType, WikiStrictOntologyViolation, validateInlineEdges, resolveEdgeDefinitions, typeSatisfies, normalizeTitleKey, WikiTransactionError, extractSqliteCode } from './chunk-IAYO63DQ.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-IAYO63DQ.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-3P7FAKJA.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-3P7FAKJA.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
     ];
@@ -2603,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);
@@ -2776,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) {
@@ -3320,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);