@lucern/graph-primitives 1.0.31 → 1.0.33

package/dist/epistemicBeliefs.js

@@ -8,9 +8,9 @@ import { getCurrentUserId } from '@lucern/access-control/auth';
 import { throwStructuredMutationError } from '@lucern/access-control/structuredMutationError';
 import { normalizeTupleContradictionPolicy, mkOpinion, createInheritedContractRecord, readOpinionFromRecord, confidenceFromSL, conditionalDeduction, project, dampedDependencyCascade, trustDiscount, applyNegativeSupport, cumulativeFusion, applyNegativeEvidence, detectTupleContradiction, evaluateTupleContradictionTransition, hasProjectedOpinionChanged } from '@lucern/confidence';
 import { isNodeType, getLayerForNodeType } from '@lucern/contracts/schema-helpers/spine/tables/epistemicNodes';
+import { generateUuidV7, generateGlobalId, assertUuidV7Identity, assertStorageEdgeVocabulary, isUuidV7, assertUuidShapedEdgeEndpoint } from '@lucern/contracts/ids';
 import { assertSchemaEnumValue } from '@lucern/contracts/schema-helpers/enumValidation';
 import { assertEdgePolicyAllowed, edgePolicyManifest } from '@lucern/contracts';
-import { generateGlobalId, assertUuidV7Identity, generateUuidV7, assertStorageEdgeVocabulary, assertUuidShapedEdgeEndpoint } from '@lucern/contracts/ids';
 import { listAudienceRegistryRows } from '@lucern/access-control/audienceRegistry';
 
 // src/epistemicBeliefs.admin.ts
@@ -1246,7 +1246,7 @@ async function markBeliefGraphDirty(ctx, scope) {
   );
 }
 async function resolveBeliefScopeOrNull(ctx, args) {
-  if (!(args.projectId || args.topicId)) {
+  if (!args.topicId) {
     return null;
   }
   try {
@@ -1776,7 +1776,7 @@ var getByPillar = query({
   },
   returns: permissiveReturn,
   handler: async (ctx, args) => {
-    if (!(args.projectId || args.topicId)) {
+    if (!args.topicId) {
       return [];
     }
     let scope;
@@ -2207,7 +2207,7 @@ var getRecentConfidenceChanges = query({
     if (!scope) {
       return [];
     }
-    const scopeId = scope.topicId ? String(scope.topicId) : scope.projectId;
+    const scopeId = scope.topicId ? String(scope.topicId) : void 0;
     if (!(scopeId && await checkScopeAccess(ctx, scopeId, args.userId))) {
       return [];
     }
@@ -2464,7 +2464,7 @@ var backfillScoredBeliefEdges = internalMutation({
   returns: permissiveReturn,
   handler: async (ctx, args) => {
     const dryRun = args.dryRun ?? false;
-    const scopeTopicId = args.topicId ?? args.projectId;
+    const scopeTopicId = args.topicId;
     if (!scopeTopicId) {
       return {
         dryRun,
@@ -2498,13 +2498,16 @@ var backfillScoredBeliefEdges = internalMutation({
         if (!theme.globalId) {
           continue;
         }
-        const edgeGlobalId = `edge-${belief.globalId}-relates_to_thesis-${theme.globalId}`;
-        const existing = await ctx.db.query("epistemicEdges").filter((q) => q.eq(q.field("globalId"), edgeGlobalId)).first();
+        const existing = await ctx.db.query("epistemicEdges").withIndex(
+          "by_from_to",
+          (q) => q.eq("fromNodeId", belief.globalId).eq("toNodeId", theme.globalId)
+        ).filter((q) => q.eq(q.field("edgeType"), "relates_to_thesis")).first();
         if (existing) {
           skipped++;
           continue;
         }
         if (!dryRun) {
+          const edgeGlobalId = generateUuidV7();
           await ctx.scheduler.runAfter(0, internal.neo4jEdgeAPI.createEdge, {
             globalId: edgeGlobalId,
             fromGlobalId: belief.globalId,
@@ -3425,16 +3428,13 @@ async function scheduleFirstScoringThemeEdges(ctx, args, node, state) {
   if (!state.isFirstScoring) {
     return;
   }
-  const themeNodes = await ctx.db.query("epistemicNodes").withIndex(
-    "by_topic",
-    (q) => q.eq("topicId", node.topicId || node.projectId)
-  ).filter((q) => q.eq(q.field("nodeType"), "theme")).collect();
+  const themeNodes = await ctx.db.query("epistemicNodes").withIndex("by_topic", (q) => q.eq("topicId", node.topicId)).filter((q) => q.eq(q.field("nodeType"), "theme")).collect();
   for (const theme of themeNodes) {
     if (!(theme.globalId && node.globalId)) {
       continue;
     }
     await ctx.scheduler.runAfter(0, internal.neo4jEdgeAPI.createEdge, {
-      globalId: `edge-${node.globalId}-relates_to_thesis-${theme.globalId}`,
+      globalId: generateUuidV7(),
       fromGlobalId: node.globalId,
       toGlobalId: theme.globalId,
       edgeType: "relates_to_thesis",
@@ -3789,36 +3789,26 @@ async function insertEpistemicEdge(ctx, doc) {
 function cleanString(value) {
   return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
 }
-function topicNodeCandidates(topicRef) {
+function requireTopicGlobalId(topicRef) {
   const normalized = topicRef.trim();
-  if (!normalized) {
-    return [];
-  }
-  const candidates = [normalized];
-  if (normalized.startsWith("top_")) {
-    candidates.push(normalized.slice(4));
+  if (!(normalized && isUuidV7(normalized))) {
+    throw new Error(
+      "Belief creation topic anchors must be UUIDv7 epistemicNodes.globalId values."
+    );
   }
-  return [...new Set(candidates)];
+  return normalized;
 }
 function readTopicNodeRef(args) {
   return cleanString(args.topicGlobalId) ?? cleanString(args.topicNodeId) ?? cleanString(args.topicId);
 }
 async function resolveRequiredTopicAnchor(ctx, topicRef) {
-  for (const candidate of topicNodeCandidates(topicRef)) {
-    try {
-      const direct = await ctx.db.get(candidate);
-      if (direct?.nodeType === "topic" && cleanString(direct.globalId)) {
-        return direct;
-      }
-    } catch {
-    }
-    const byGlobalId = await ctx.db.query("epistemicNodes").withIndex("by_globalId", (q) => q.eq("globalId", candidate)).first();
-    if (byGlobalId?.nodeType === "topic" && cleanString(byGlobalId.globalId)) {
-      return byGlobalId;
-    }
+  const topicGlobalId = requireTopicGlobalId(topicRef);
+  const byGlobalId = await ctx.db.query("epistemicNodes").withIndex("by_globalId", (q) => q.eq("globalId", topicGlobalId)).first();
+  if (byGlobalId?.nodeType === "topic" && cleanString(byGlobalId.globalId)) {
+    return byGlobalId;
   }
   throw new Error(
-    "Belief creation requires topicGlobalId or topicNodeId for a topic node in epistemicNodes. Legacy topics-table IDs are not valid belief anchors."
+    "Belief creation requires a UUIDv7 topicGlobalId for a topic node in epistemicNodes. Legacy topics-table IDs are not valid belief anchors."
   );
 }
 function scopeFromTopicAnchor(topicNode) {
@@ -4329,7 +4319,7 @@ var create = mutation({
       projectId: scope.projectId,
       topicId: String(scope.topicId)
     });
-    if (scope.projectId || scope.topicId) {
+    if (scope.topicId) {
       await ctx.scheduler.runAfter(
         0,
         "embeddingActions:generateEpistemicNodeEmbedding",
@@ -4348,7 +4338,7 @@ Rationale: ${args.rationale}` : args.formulation
         }
       );
     }
-    if (scope.projectId || scope.topicId) {
+    if (scope.topicId) {
       await ctx.scheduler.runAfter(
         2e3,
         // 2 second delay
@@ -4361,7 +4351,7 @@ Rationale: ${args.rationale}` : args.formulation
         }
       );
     }
-    if (pillar === "other" && (scope.projectId || scope.topicId)) {
+    if (pillar === "other" && scope.topicId) {
       await ctx.scheduler.runAfter(
         2500,
         "beliefCategorization:autoCategorizeBelief",
@@ -4372,7 +4362,7 @@ Rationale: ${args.rationale}` : args.formulation
         }
       );
     }
-    if (scope.projectId || scope.topicId) {
+    if (scope.topicId) {
       await ctx.scheduler.runAfter(
         3e3,
         // 3 second delay — after entity extraction
@@ -4640,7 +4630,7 @@ var getByProject = query({
   },
   returns: permissiveReturn,
   handler: async (ctx, args) => {
-    if (!(args.projectId || args.topicId)) {
+    if (!args.topicId) {
       return [];
     }
     const pageSize = clampBeliefLimit(args.limit);
@@ -4663,7 +4653,7 @@ var getByProject = query({
       return [];
     }
     if (args.userId) {
-      const scopeId = scope.topicId ? String(scope.topicId) : scope.projectId;
+      const scopeId = scope.topicId ? String(scope.topicId) : void 0;
       if (!scopeId) {
         return [];
       }
@@ -4820,7 +4810,7 @@ var forkBelief = mutation({
         supersededBy: newNodeId,
         updatedAt: now,
         metadata: {
-          ...metadata ?? {},
+          ...metadata,
           status: "superseded",
           beliefStatus: "superseded",
           epistemicStatus: "superseded",
@@ -4900,7 +4890,7 @@ var forkBelief = mutation({
       projectId: parent.projectId,
       topicId: parent.topicId
     });
-    if (parent.projectId || parent.topicId) {
+    if (parent.topicId) {
       const inheritedPillar = normalizePillar(
         String(metadata?.pillar || metadata?.topic || "")
       );
@@ -5306,7 +5296,7 @@ async function insertInternalBeliefAudit(ctx, args) {
   });
 }
 async function scheduleInternalBeliefEmbedding(ctx, args) {
-  if (!(args.scope.projectId || args.scope.topicId)) {
+  if (!args.scope.topicId) {
     return;
   }
   await ctx.scheduler.runAfter(0, EMBEDDING_GENERATION_ACTION, {
@@ -5334,7 +5324,7 @@ function numericRequestedConfidence(confidence) {
   return 0.5;
 }
 async function scheduleInternalBeliefCategorization(ctx, args) {
-  if (normalizePillar(args.args.pillar || args.args.topic) !== "other" || !(args.scope.projectId || args.scope.topicId)) {
+  if (normalizePillar(args.args.pillar || args.args.topic) !== "other" || !args.scope.topicId) {
     return;
   }
   await ctx.scheduler.runAfter(2500, BELIEF_CATEGORIZATION_ACTION, {