@lucern/graph-primitives 0.3.0-alpha.17 → 0.3.0-alpha.3

package/dist/epistemicBeliefs.js

@@ -6,7 +6,7 @@ import { listAudienceRegistryRows } from '@lucern/access-control/audienceRegistr
 import { getCurrentUserId } from '@lucern/access-control/auth';
 import { assertSchemaEnumValue } from '@lucern/contracts/schema-helpers/enumValidation';
 import { permissiveReturn } from '@lucern/contracts/schema-helpers/validators';
-import { componentsGeneric, anyApi, internalMutationGeneric, mutationGeneric, queryGeneric, internalQueryGeneric } from 'convex/server';
+import { componentsGeneric, internalMutationGeneric, mutationGeneric, anyApi, queryGeneric, internalQueryGeneric } from 'convex/server';
 import { isNodeType, getLayerForNodeType } from '@lucern/contracts/schema-helpers/spine/tables/epistemicNodes';
 
 // src/epistemicBeliefs.ts
@@ -169,7 +169,9 @@ function propagateNegativeSupportWithMetadata(sourceOpinion, targetOpinion, edge
     readEdgeMetadata(edge)
   );
 }
-var propagateNegativeInform = applyNegativeEvidence;
+function propagateNegativeInform(sourceOpinion, targetOpinion, edgeWeight) {
+  return applyNegativeEvidence(sourceOpinion, targetOpinion, edgeWeight);
+}
 
 // src/edges/contradicts.ts
 var contradictsPropagationSpec = {
@@ -392,20 +394,6 @@ function getTraversalDirections(direction) {
   }
   return ["outgoing", "incoming"];
 }
-
-// src/debug.ts
-function isGraphPrimitiveDebugEnabled() {
-  const env = globalThis.process?.env;
-  return env?.LUCERN_COMPAT_FALLBACK_DEBUG === "1" || env?.LUCERN_GRAPH_DEBUG === "1";
-}
-function debugGraphPrimitiveFallback(message, context) {
-  if (!isGraphPrimitiveDebugEnabled()) {
-    return;
-  }
-  console.debug(message, context ?? {});
-}
-
-// src/topicScope.ts
 var LEGACY_SCOPE_FIELD = "graphScopeProjectId";
 function asMappedProjectId(topic) {
   if (!topic) {
@@ -447,14 +435,7 @@ async function findTopicsByScopeAlias(ctx, scopeId) {
       "by_graph_scope_project",
       (q) => q.eq(LEGACY_SCOPE_FIELD, scopeId)
     ).collect();
-  } catch (error) {
-    debugGraphPrimitiveFallback(
-      "[topicScope] Failed to resolve scope alias via index",
-      {
-        error,
-        scopeId
-      }
-    );
+  } catch {
     const topics = await ctx.db.query("topics").collect();
     return topics.filter((topic) => {
       const normalizedGlobalId = normalizeScopeValue(topic.globalId);
@@ -471,14 +452,7 @@ async function tryResolveHostTopicById(ctx, topicId) {
     return await ctx.runQuery(api.topics.get, {
       id: topicId
     }) ?? null;
-  } catch (error) {
-    debugGraphPrimitiveFallback(
-      "[topicScope] Failed to resolve topic by host query",
-      {
-        error,
-        topicId
-      }
-    );
+  } catch {
     return null;
   }
 }
@@ -490,14 +464,7 @@ async function tryResolveHostTopicByLegacyScope(ctx, legacyScopeId) {
     return await ctx.runQuery(api.topics.getByLegacyScopeId, {
       projectId: legacyScopeId
     }) ?? null;
-  } catch (error) {
-    debugGraphPrimitiveFallback(
-      "[topicScope] Failed to resolve topic by legacy scope",
-      {
-        error,
-        legacyScopeId
-      }
-    );
+  } catch {
     return null;
   }
 }
@@ -526,17 +493,8 @@ async function resolveTopicProjectScope(ctx, args) {
   if (args.topicId) {
     let topic = null;
     try {
-      topic = await ctx.db.get(
-        args.topicId
-      );
-    } catch (error) {
-      debugGraphPrimitiveFallback(
-        "[topicScope] Failed to load topic by direct id",
-        {
-          error,
-          topicId: args.topicId
-        }
-      );
+      topic = await ctx.db.get(args.topicId);
+    } catch {
     }
     if (!topic) {
       topic = await tryResolveHostTopicById(ctx, String(args.topicId));
@@ -573,14 +531,7 @@ async function resolveTopicProjectScope(ctx, args) {
       directTopic = await ctx.db.get(
         args.projectId
       );
-    } catch (error) {
-      debugGraphPrimitiveFallback(
-        "[topicScope] Failed to load direct project topic",
-        {
-          error,
-          projectId: args.projectId
-        }
-      );
+    } catch {
     }
     if (directTopic) {
       const inherited = await resolveInheritedWorkspaceScope(ctx, directTopic);
@@ -924,15 +875,7 @@ async function scheduleEmbeddingGeneration(args) {
         confidence: args.confidence
       }
     );
-  } catch (error) {
-    debugGraphPrimitiveFallback(
-      "[embeddingTrigger] Failed to schedule embedding generation",
-      {
-        error,
-        nodeId: String(args.nodeId),
-        nodeType: args.nodeType
-      }
-    );
+  } catch {
   }
 }
 
@@ -1054,37 +997,19 @@ function isProjectLikeTopic(topic) {
   return topic.type === "theme" || topic.type === "thematic" || topic.type === "deal" || topic.type === "monitoring" || readLegacyProjectId(topic) !== void 0 || readNonEmptyString(metadata.projectType) !== void 0;
 }
 function isMissingLucernChildComponentError(error) {
-  const message = getErrorMessage(error);
+  const message = error instanceof Error ? error.message : String(error);
   return message.includes(
     'Child component ComponentName(Identifier("lucern")) not found'
   ) || message.includes("Child component") && message.includes("lucern") && message.includes("not found");
 }
-function getErrorMessage(error) {
-  if (error instanceof Error) {
-    return error.message;
-  }
-  if (typeof error === "object" && error !== null && "message" in error && typeof error.message === "string") {
-    return error.message;
-  }
-  return "unknown error";
-}
 async function resolveTopicDoc(ctx, scopeId) {
   if (ctx?.db && typeof ctx.db.get === "function") {
     try {
-      const directTopic = await ctx.db.get(
-        scopeId
-      );
+      const directTopic = await ctx.db.get(scopeId);
       if (directTopic) {
         return directTopic;
       }
-    } catch (error) {
-      debugGraphPrimitiveFallback(
-        "[topicProjectOverlay] Failed to resolve topic by direct ID",
-        {
-          error,
-          scopeId
-        }
-      );
+    } catch {
     }
   }
   if (typeof ctx.runQuery !== "function") {
@@ -1097,14 +1022,7 @@ async function resolveTopicDoc(ctx, scopeId) {
     if (topic?.name !== void 0 && topic?.type !== void 0) {
       return topic;
     }
-  } catch (error) {
-    debugGraphPrimitiveFallback(
-      "[topicProjectOverlay] Failed to resolve topic by ID query",
-      {
-        error,
-        scopeId
-      }
-    );
+  } catch {
   }
   try {
     const topic = await ctx.runQuery(api.topics.getByLegacyScopeId, {
@@ -1113,11 +1031,7 @@ async function resolveTopicDoc(ctx, scopeId) {
     if (topic?.name !== void 0 && topic?.type !== void 0) {
       return topic;
     }
-  } catch (error) {
-    debugGraphPrimitiveFallback(
-      "[topicProjectOverlay] Failed to resolve topic by legacy scope ID",
-      { error, scopeId }
-    );
+  } catch {
   }
   return null;
 }
@@ -1171,11 +1085,7 @@ async function listTopicProjectOverlays(ctx, options = {}) {
   if (ctx?.db?.query && typeof ctx.db.query === "function") {
     try {
       allTopics = await ctx.db.query("topics").collect();
-    } catch (error) {
-      debugGraphPrimitiveFallback(
-        "[topicProjectOverlay] Failed to read topics table; falling back to API",
-        { error }
-      );
+    } catch {
       allTopics = [];
     }
   }
@@ -1270,28 +1180,19 @@ async function patchTopicProjectOverlay(ctx, scopeId, value) {
       "Cannot patch topic without component adapter (ctx.runMutation unavailable)"
     );
   }
-  return materializeTopicProjectOverlay({
-    ...topic,
-    ...patch,
-    metadata: nextMetadata
-  });
+  return materializeTopicProjectOverlay(
+    {
+      ...topic,
+      ...patch,
+      metadata: nextMetadata
+    }
+  );
 }
 
 // src/resolvers.ts
 function isMissingLucernChildComponentError2(error) {
-  const message = getErrorMessage2(error);
-  return message.includes(
-    'Child component ComponentName(Identifier("lucern")) not found'
-  ) || message.includes("Child component") && message.includes("lucern") && message.includes("not found");
-}
-function getErrorMessage2(error) {
-  if (error instanceof Error) {
-    return error.message;
-  }
-  if (typeof error === "object" && error !== null && "message" in error && typeof error.message === "string") {
-    return error.message;
-  }
-  return "unknown error";
+  const message = error instanceof Error ? error.message : String(error);
+  return message.includes('Child component ComponentName(Identifier("lucern")) not found') || message.includes("Child component") && message.includes("lucern") && message.includes("not found");
 }
 function isAdvisoryTopicPatch(value) {
   const advisoryKeys = /* @__PURE__ */ new Set(["lastActivityAt", "updatedAt"]);
@@ -1305,27 +1206,32 @@ async function patchProjectWithTolerance(ctx, projectId, value) {
     if (!isAdvisoryTopicPatch(value) || !isMissingLucernChildComponentError2(error)) {
       throw error;
     }
-    console.warn(
-      "[lucern graph-primitives] Non-fatal advisory topic patch failure",
-      {
-        projectId,
-        keys: Object.keys(value),
-        error: getErrorMessage2(error)
-      }
-    );
+    console.warn("[lucern graph-primitives] Non-fatal advisory topic patch failure", {
+      projectId,
+      keys: Object.keys(value),
+      error: error instanceof Error ? error.message : error
+    });
   }
 }
 function defaultResolvers() {
   return {
-    getProject: (ctx, projectId) => resolveTopicProjectOverlay(ctx, projectId, {
-      idMode: "legacy",
-      projectLikeOnly: false
-    }),
-    patchProject: (ctx, projectId, value) => patchProjectWithTolerance(ctx, projectId, value),
-    listTopics: (ctx) => listTopicProjectOverlays(ctx, {
-      idMode: "legacy"
-    }),
-    getFinalArtifact: (ctx, artifactId) => ctx.db.get(artifactId)
+    async getProject(ctx, projectId) {
+      return await resolveTopicProjectOverlay(ctx, projectId, {
+        idMode: "legacy",
+        projectLikeOnly: false
+      });
+    },
+    async patchProject(ctx, projectId, value) {
+      await patchProjectWithTolerance(ctx, projectId, value);
+    },
+    async listTopics(ctx) {
+      return await listTopicProjectOverlays(ctx, {
+        idMode: "legacy"
+      });
+    },
+    async getFinalArtifact(ctx, artifactId) {
+      return await ctx.db.get(artifactId);
+    }
   };
 }
 var resolverOverrides = {};
@@ -1401,15 +1307,6 @@ function buildBeliefConfidenceRow(args) {
     ...args.triggeringWorktreeId ? { triggeringWorktreeId: args.triggeringWorktreeId } : {}
   };
 }
-function buildBeliefStatusSuccessResult() {
-  return { success: true };
-}
-function buildBeliefEvidenceNotFoundResult() {
-  const result = {};
-  result.success = false;
-  result.message = "Evidence node not found";
-  return result;
-}
 function deriveSyntheticBackfillOpinion(source) {
   const belief = readFiniteNumber(source.opinion_b) ?? readFiniteNumber(source.belief);
   const disbelief = readFiniteNumber(source.opinion_d) ?? readFiniteNumber(source.disbelief);
@@ -1418,13 +1315,7 @@ function deriveSyntheticBackfillOpinion(source) {
   if (belief !== void 0 || disbelief !== void 0 || uncertainty !== void 0 || baseRate !== void 0) {
     try {
       return readOpinionFromRecord(source);
-    } catch (error) {
-      debugGraphPrimitiveFallback(
-        "[epistemicBeliefs] Failed to decode legacy belief opinion",
-        {
-          error
-        }
-      );
+    } catch {
       return mkOpinion(0, 0, 1, 0.5);
     }
   }
@@ -1452,14 +1343,7 @@ function readBeliefOpinionSnapshot(node, metadata) {
       opinion_u: node.opinion_u,
       opinion_a: node.opinion_a
     });
-  } catch (error) {
-    debugGraphPrimitiveFallback(
-      "[epistemicBeliefs] Failed to read belief opinion snapshot",
-      {
-        error,
-        beliefId: node._id
-      }
-    );
+  } catch {
     return mkOpinion(0, 0, 1, 0.5);
   }
 }
@@ -1552,15 +1436,7 @@ async function resolveBeliefScopeOrNull(ctx, args) {
       projectId: args.projectId ?? void 0,
       topicId: args.topicId ?? void 0
     });
-  } catch (error) {
-    debugGraphPrimitiveFallback(
-      "[epistemicBeliefs] Failed to resolve belief scope",
-      {
-        error,
-        projectId: args.projectId,
-        topicId: args.topicId
-      }
-    );
+  } catch {
     return null;
   }
 }
@@ -1660,13 +1536,7 @@ async function getActiveConfidencePolicy(ctx) {
         activeConfig?.tupleContradictionPolicy
       )
     };
-  } catch (error) {
-    debugGraphPrimitiveFallback(
-      "[epistemicBeliefs] Failed to load active confidence policy",
-      {
-        error
-      }
-    );
+  } catch {
     return DEFAULT_CONFIDENCE_POLICY;
   }
 }
@@ -1703,11 +1573,7 @@ async function applyBeliefConfidenceChange(ctx, args) {
       details: { nodeId: args.nodeId }
     });
   }
-  await requireProjectWriteAccess(
-    ctx,
-    node.projectId,
-    args.authenticatedUserId
-  );
+  await requireProjectWriteAccess(ctx, node.projectId, args.authenticatedUserId);
   const existingMetadata = node.metadata || {};
   const currentBeliefStatus = resolveBeliefStatus(node, existingMetadata);
   const confidencePolicy = await getActiveConfidencePolicy(ctx);
@@ -1751,29 +1617,29 @@ async function applyBeliefConfidenceChange(ctx, args) {
     opinion: nextOpinion,
     policy: tupleTransition.policy
   });
-  const newBeliefStatus = promoteBeliefStatusAfterScoring(currentBeliefStatus, {
-    confidence: derivedConfidence,
-    predictionMeta,
-    metadata: existingMetadata
-  });
+  const newBeliefStatus = promoteBeliefStatusAfterScoring(
+    currentBeliefStatus,
+    {
+      confidence: derivedConfidence,
+      predictionMeta,
+      metadata: existingMetadata
+    }
+  );
   let tupleContradictionId;
   if (tupleTransition.crossedIntoTupleContradiction) {
-    tupleContradictionId = await ctx.runMutation(
-      "contradictions:create",
-      {
-        projectId: node.projectId,
-        topicId: node.topicId,
-        beliefId: args.nodeId,
-        beliefBId: args.nodeId,
-        supportingInsightIds: [],
-        contradictingInsightIds: [],
-        severity: deriveTupleContradictionSeverity(node),
-        source: "tuple_space",
-        detectionMethod: "agent",
-        description: tupleContradictionDescription,
-        createdBy: args.authenticatedUserId
-      }
-    );
+    tupleContradictionId = await ctx.runMutation("contradictions:create", {
+      projectId: node.projectId,
+      topicId: node.topicId,
+      beliefId: args.nodeId,
+      beliefBId: args.nodeId,
+      supportingInsightIds: [],
+      contradictingInsightIds: [],
+      severity: deriveTupleContradictionSeverity(node),
+      source: "tuple_space",
+      detectionMethod: "agent",
+      description: tupleContradictionDescription,
+      createdBy: args.authenticatedUserId
+    });
   }
   await ctx.db.patch(args.nodeId, {
     confidence: derivedConfidence,
@@ -1797,10 +1663,7 @@ async function applyBeliefConfidenceChange(ctx, args) {
   });
   if (isFirstScoring) {
     const nodeTopicId = node.topicId;
-    const themeNodes = await ctx.db.query("epistemicNodes").withIndex(
-      "by_topic",
-      (q) => q.eq("topicId", nodeTopicId || 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", nodeTopicId || node.projectId)).filter((q) => q.eq(q.field("nodeType"), "theme")).collect();
     for (const theme of themeNodes) {
       if (theme.globalId && node.globalId) {
         await ctx.scheduler.runAfter(0, internal.neo4jEdgeAPI.createEdge, {
@@ -2398,15 +2261,7 @@ var getByProject = query({
         projectId: args.projectId,
         topicId: args.topicId
       });
-    } catch (error) {
-      debugGraphPrimitiveFallback(
-        "[epistemicBeliefs] Failed to resolve project scope",
-        {
-          error,
-          projectId: args.projectId,
-          topicId: args.topicId
-        }
-      );
+    } catch {
       return [];
     }
     if (args.userId) {
@@ -2450,9 +2305,7 @@ var getByTopic = query({
   handler: async (ctx, args) => {
     const pageSize = clampBeliefLimit(args.limit);
     const scanLimit = Math.min(pageSize * 3, MAX_PROJECT_BELIEF_LIMIT);
-    const scope = await resolveTopicProjectScope(ctx, {
-      topicId: args.topicId
-    });
+    const scope = await resolveTopicProjectScope(ctx, { topicId: args.topicId });
     const query2 = ctx.db.query("epistemicNodes").withIndex(
       "by_topic_type",
       (q) => q.eq("topicId", args.topicId).eq("nodeType", "belief")
@@ -2678,18 +2531,16 @@ var modulateConfidence = mutation({
     rationale: v.optional(v.string()),
     userId: v.string(),
     // SL operator provenance (optional — defaults to manual_assessment)
-    slOperator: v.optional(
-      v.union(
-        v.literal("cumulative_fusion"),
-        v.literal("averaging_fusion"),
-        v.literal("trust_discount"),
-        v.literal("conditional_deduction"),
-        v.literal("dependency_cascade"),
-        v.literal("negation"),
-        v.literal("constraint_fusion"),
-        v.literal("manual_assessment")
-      )
-    ),
+    slOperator: v.optional(v.union(
+      v.literal("cumulative_fusion"),
+      v.literal("averaging_fusion"),
+      v.literal("trust_discount"),
+      v.literal("conditional_deduction"),
+      v.literal("dependency_cascade"),
+      v.literal("negation"),
+      v.literal("constraint_fusion"),
+      v.literal("manual_assessment")
+    )),
     triggeringEvidenceId: v.optional(v.id("epistemicNodes")),
     triggeringWorktreeId: v.optional(v.string())
   },
@@ -2920,7 +2771,10 @@ var getConfidenceHistory = query({
     if (!node || node.nodeType !== "belief") {
       return [];
     }
-    return await ctx.db.query("beliefConfidence").withIndex("by_beliefId_time", (q) => q.eq("beliefId", args.nodeId)).order("asc").collect();
+    return await ctx.db.query("beliefConfidence").withIndex(
+      "by_beliefId_time",
+      (q) => q.eq("beliefId", args.nodeId)
+    ).order("asc").collect();
   }
 });
 var getLineage = query({
@@ -3224,7 +3078,7 @@ var unlinkEvidence = mutation({
     const now = Date.now();
     const evidenceNode = await ctx.db.get(args.insightId);
     if (!evidenceNode || evidenceNode.nodeType !== "evidence") {
-      return buildBeliefEvidenceNotFoundResult();
+      return { success: false, message: "Evidence node not found" };
     }
     if (!evidenceNode.projectId) {
       throw new Error("Evidence has no project scope");
@@ -3265,7 +3119,7 @@ var unlinkEvidence = mutation({
         projectId: evidenceNode.projectId
       });
     }
-    return buildBeliefStatusSuccessResult();
+    return { success: true };
   }
 });
 var getWithEvidence = query({
@@ -3377,7 +3231,7 @@ var deleteRelationship = mutation({
       changedAt: now,
       projectId: edge.projectId
     });
-    return buildBeliefStatusSuccessResult();
+    return { success: true };
   }
 });
 var updateCriticality = mutation({
@@ -3506,23 +3360,13 @@ var batchUpdateCriticality = mutation({
           changedAt: now,
           projectId: node.projectId
         });
-        const result = {};
-        result.beliefId = update.beliefId;
-        result.nodeId = node._id;
-        result.success = true;
-        results.push(result);
-      } catch (error) {
-        debugGraphPrimitiveFallback(
-          "[epistemicBeliefs] Failed to update belief criticality",
-          {
-            error,
-            beliefId: update.beliefId
-          }
-        );
-        const result = {};
-        result.beliefId = update.beliefId;
-        result.success = false;
-        results.push(result);
+        results.push({
+          beliefId: update.beliefId,
+          nodeId: node._id,
+          success: true
+        });
+      } catch {
+        results.push({ beliefId: update.beliefId, success: false });
       }
     }
     return { results, updatedCount: results.filter((r) => r.success).length };
@@ -3637,15 +3481,7 @@ var getByPillar = query({
         projectId: args.projectId,
         topicId: args.topicId
       });
-    } catch (error) {
-      debugGraphPrimitiveFallback(
-        "[epistemicBeliefs] Failed to resolve criticality scope",
-        {
-          error,
-          projectId: args.projectId,
-          topicId: args.topicId
-        }
-      );
+    } catch {
       return [];
     }
     const nodes = await ctx.db.query("epistemicNodes").withIndex(
@@ -3766,9 +3602,7 @@ var internalGetByTopic = internalQuery({
     const pageSize = clampBeliefLimit(args.limit, 500);
     const scanLimit = Math.min(pageSize * 3, MAX_PROJECT_BELIEF_LIMIT);
     const audienceMode = args.audienceMode ?? "internal";
-    const scope = await resolveTopicProjectScope(ctx, {
-      topicId: args.topicId
-    });
+    const scope = await resolveTopicProjectScope(ctx, { topicId: args.topicId });
     const registryRows = await listAudienceRegistryRows(ctx, {
       tenantId: scope.tenantId,
       workspaceId: scope.workspaceId
@@ -4113,9 +3947,7 @@ var backfillSyntheticOpinionHistory = internalMutation({
         skippedHasHistory++;
         continue;
       }
-      const opinion = deriveSyntheticBackfillOpinion(
-        node
-      );
+      const opinion = deriveSyntheticBackfillOpinion(node);
       await ctx.db.insert(
         "beliefConfidence",
         buildBeliefConfidenceRow({
@@ -4421,13 +4253,7 @@ var getBeliefClusterPositions = query({
       return {
         positions: {},
         hasClusters: false,
-        counts: {
-          raw: 0,
-          hypothesis: 0,
-          conditional: 0,
-          unprocessed: 0,
-          total: 0
-        }
+        counts: { raw: 0, hypothesis: 0, conditional: 0, unprocessed: 0, total: 0 }
       };
     }
     const allBeliefNodes = await getBeliefNodesForScope(ctx, scope);
@@ -4489,8 +4315,14 @@ var reassignBeliefsTopic = mutation({
     let connectedReassigned = 0;
     const alreadyReassigned = /* @__PURE__ */ new Set();
     for (const beliefId of movedBeliefIds) {
-      const outbound = await ctx.db.query("epistemicEdges").withIndex("by_from", (q) => q.eq("fromNodeId", beliefId)).collect();
-      const inbound = await ctx.db.query("epistemicEdges").withIndex("by_to", (q) => q.eq("toNodeId", beliefId)).collect();
+      const outbound = await ctx.db.query("epistemicEdges").withIndex(
+        "by_from",
+        (q) => q.eq("fromNodeId", beliefId)
+      ).collect();
+      const inbound = await ctx.db.query("epistemicEdges").withIndex(
+        "by_to",
+        (q) => q.eq("toNodeId", beliefId)
+      ).collect();
       const connectedNodeIds = /* @__PURE__ */ new Set();
       for (const edge of outbound) {
         if (edge.toNodeId) connectedNodeIds.add(String(edge.toNodeId));
@@ -4513,14 +4345,7 @@ var reassignBeliefsTopic = mutation({
             alreadyReassigned.add(connectedId);
             connectedReassigned++;
           }
-        } catch (error) {
-          debugGraphPrimitiveFallback(
-            "[epistemicBeliefs] Failed to reassign connected node",
-            {
-              error,
-              connectedId
-            }
-          );
+        } catch {
         }
       }
     }