@lucern/graph-primitives 1.0.22 → 1.0.24

package/dist/epistemicContracts.js

@@ -1,4 +1,4 @@
-import { v } from 'convex/values';
+import { v, ConvexError } from 'convex/values';
 import { normalizeTupleContradictionPolicy, mkOpinion, conditionalDeduction, project, dampedDependencyCascade, hasProjectedOpinionChanged, confidenceFromSL, detectTupleContradiction, evaluateTupleContradictionTransition, deriveContractModulationPlan, deriveContractStatus, trustDiscount, applyNegativeSupport, cumulativeFusion, applyNegativeEvidence, readOpinionFromRecord, parseEvidentialEvaluatorConfig, compareMetricValue, buildEvidentialRationale, parseMetricCheckerConfig, getEvaluatorInputRecord, pickFiniteNumber, resolveComparisonResult, buildComparisonRationale, parseReferenceCheckCounterConfig, parseTemporalDeadlineConfig, parseMarketIndexComparatorConfig, createInheritedContractRecord } from '@lucern/confidence';
 import { checkProjectAccess } from '@lucern/access-control/access';
 import '@lucern/access-control/audience';
@@ -149,6 +149,35 @@ function debugGraphPrimitiveFallback(message, context) {
   console.debug(message, context ?? {});
 }
 var LEGACY_SCOPE_FIELD = "graphScopeProjectId";
+async function resolveTopicNodeScopeOrNull(ctx, ref) {
+  if (!ctx?.db || typeof ctx.db.query !== "function") {
+    return null;
+  }
+  let node = null;
+  try {
+    const byGlobalId = await ctx.db.query("epistemicNodes").withIndex("by_globalId", (q) => q.eq("globalId", ref)).first();
+    if (byGlobalId && byGlobalId.nodeType === "topic") {
+      node = byGlobalId;
+    }
+  } catch (error) {
+    debugGraphPrimitiveFallback(
+      "[topicScope] topic-node scope lookup by globalId failed",
+      { error, ref }
+    );
+  }
+  if (!node) {
+    return null;
+  }
+  const scopeKey = normalizeScopeValue(node.topicId) ?? normalizeScopeValue(node.globalId);
+  if (!scopeKey) {
+    return null;
+  }
+  return {
+    topicId: scopeKey,
+    projectId: asMappedProjectId(node),
+    source: "topic_node"
+  };
+}
 function asMappedProjectId(topic) {
   if (!topic) {
     return;
@@ -289,6 +318,13 @@ async function resolveTopicProjectScope(ctx, args) {
       ) ?? null;
     }
     if (!topic) {
+      const nodeScope = await resolveTopicNodeScopeOrNull(
+        ctx,
+        String(args.topicId)
+      );
+      if (nodeScope) {
+        return nodeScope;
+      }
       throw new Error(`Topic not found: ${String(args.topicId)}`);
     }
     const inherited = await resolveInheritedWorkspaceScope(ctx, topic);
@@ -359,6 +395,16 @@ async function resolveTopicProjectScope(ctx, args) {
         source: "project_mapped_topic"
       };
     }
+    const nodeScope = await resolveTopicNodeScopeOrNull(
+      ctx,
+      String(args.projectId)
+    );
+    if (nodeScope) {
+      return {
+        ...nodeScope,
+        projectId: nodeScope.projectId ?? String(args.projectId)
+      };
+    }
     throw new Error(
       `Legacy project scope ${String(args.projectId)} has no mapped topic.`
     );
@@ -464,7 +510,18 @@ var DEFAULT_CONFIDENCE_POLICY = {
   tupleContradiction: normalizeTupleContradictionPolicy()
 };
 function throwStructuredMutationError(args) {
-  const error = new Error(args.message);
+  const data = {
+    structuredMutationError: true,
+    message: args.message,
+    status: args.status,
+    code: args.code,
+    invariantCode: args.invariantCode,
+    suggestion: args.suggestion,
+    details: args.details
+  };
+  const error = new ConvexError(
+    data
+  );
   error.status = args.status;
   error.code = args.code;
   error.invariantCode = args.invariantCode;
@@ -582,12 +639,12 @@ async function requireProjectWriteAccess(ctx, projectId, userId) {
   );
   if (!hasAccess) {
     throwStructuredMutationError({
-      message: "Project access required.",
+      message: `Project write access denied for topic ${projectId}.`,
       status: 403,
-      code: "FORBIDDEN",
+      code: "PROJECT_ACCESS_DENIED",
       invariantCode: "policy.scope_required",
-      suggestion: "Request write access for the project and retry.",
-      details: { projectId, userId }
+      suggestion: "The acting principal lacks project-write access to this topic. Request a topic grant (or, if the principal created this topic, run the creator-grant backfill) and retry.",
+      details: { topicId: projectId, principalId: userId }
     });
   }
 }
@@ -1243,14 +1300,14 @@ async function applyBeliefConfidenceChange(ctx, args) {
     beliefConfidenceId
   };
 }
-function propagationTriggerForEdge(edgeType, weight) {
+function propagationPressureLabel(edgeType, weight) {
   if (edgeType === "contradicts" || edgeType === "refutes") {
-    return "contradiction_detected";
+    return "contradictory";
   }
   if ((edgeType === "supports" || edgeType === "informs") && weight < 0) {
-    return "contradiction_detected";
+    return "contradictory";
   }
-  return "evidence_added";
+  return "supportive";
 }
 internalMutation({
   args: {
@@ -1287,14 +1344,15 @@ internalMutation({
       getNode: async (nodeId) => await ctx.db.get(nodeId)
     });
     for (const dispatch of dispatches) {
+      const pressureLabel = propagationPressureLabel(dispatch.edgeType, dispatch.weight);
       await applyBeliefConfidenceChange(ctx, {
         nodeId: dispatch.targetNodeId,
         belief: dispatch.opinion.b,
         disbelief: dispatch.opinion.d,
         uncertainty: dispatch.opinion.u,
         baseRate: dispatch.opinion.a,
-        trigger: propagationTriggerForEdge(dispatch.edgeType, dispatch.weight),
-        rationale: `SL propagation via ${dispatch.edgeType} edge: ${dispatch.rationale}`,
+        trigger: "propagation",
+        rationale: `SL propagation via ${dispatch.edgeType} edge (pressure: ${pressureLabel}): ${dispatch.rationale}`,
         authenticatedUserId: args.userId,
         slOperator: dispatch.operator
       });
@@ -2745,10 +2803,7 @@ var createEpistemicContract = mutation({
       createdBy: userId,
       updatedAt: now
     };
-    const insertedId = await ctx.db.insert(
-      "epistemicContracts",
-      contractDoc
-    );
+    const insertedId = await ctx.db.insert("epistemicContracts", contractDoc);
     return {
       contractId,
       id: insertedId,