@lucern/graph-primitives 1.0.16 → 1.0.18

package/dist/beliefEvidenceLinks.js

@@ -658,86 +658,31 @@ function resolveGraphPrimitivesAppResolvers(_ctx) {
   };
 }
 
-// src/beliefEvidenceLinks.ts
-var beliefIdUnion = v.id("epistemicNodes");
-var insightIdUnion = v.id("epistemicNodes");
-var suggestionStatusValidator = v.union(
-  v.literal("suggested"),
-  v.literal("approved"),
-  v.literal("dismissed")
-);
-var matcherMetadataValidator = v.object({
-  surface: v.string(),
-  matcherFamily: v.optional(v.string()),
-  matcherKey: v.optional(v.string()),
-  matcherVersion: v.optional(v.string()),
-  reviewStatus: v.optional(
-    v.union(
-      v.literal("pending"),
-      v.literal("accepted"),
-      v.literal("rejected"),
-      v.literal("auto_accepted"),
-      v.literal("superseded")
-    )
-  ),
-  configSnapshot: v.optional(v.any()),
-  signalSnapshot: v.optional(v.any()),
-  outcomeMetadata: v.optional(v.any())
-});
-async function markProjectGraphDirty(ctx, projectId) {
-  if (!projectId) {
-    return;
+// src/beliefEvidenceLinks.operational.ts
+function assertEvidenceImpact(args) {
+  if (!Number.isFinite(args.weight) || args.weight === 0 || args.weight < -1 || args.weight > 1) {
+    throw new Error("Belief evidence links require explicit nonzero weight in [-1, 1]");
   }
-  await ctx.scheduler.runAfter(
-    0,
-    internal.graphAnalysisCache.markCacheStaleInternal,
-    {
-      projectId
-    }
-  );
-  await resolveGraphPrimitivesAppResolvers().patchProject(ctx, projectId, {
-    lastActivityAt: Date.now()
-  });
-}
-async function recordMatcherDecision(ctx, args) {
-  if (!args.matcherMetadata) {
-    return;
+  if (args.relation === "supports" && args.weight < 0) {
+    throw new Error("Supporting evidence links require positive weight");
+  }
+  if (args.relation === "contradicts" && args.weight > 0) {
+    throw new Error("Contradicting evidence links require negative weight");
   }
-  await ctx.runMutation("matcherFeedback:recordDecision", {
-    projectId: args.beliefNode.projectId,
-    topicId: args.beliefNode.topicId,
-    surface: args.matcherMetadata.surface,
-    matcherFamily: args.matcherMetadata.matcherFamily,
-    matcherKey: args.matcherMetadata.matcherKey,
-    matcherVersion: args.matcherMetadata.matcherVersion,
-    sourceEntityId: String(args.insightId),
-    targetEntityId: String(args.beliefId),
-    suggestionTable: "beliefEvidenceLinks",
-    suggestionId: args.linkId,
-    reviewStatus: deriveMatcherReviewStatus({
-      explicitReviewStatus: args.matcherMetadata.reviewStatus,
-      linkStatus: args.linkStatus
-    }),
-    reviewedBy: args.reviewedBy,
-    decisionReason: args.decisionReason,
-    configSnapshot: args.matcherMetadata.configSnapshot,
-    signalSnapshot: args.matcherMetadata.signalSnapshot,
-    outcomeMetadata: args.matcherMetadata.outcomeMetadata
-  });
 }
 async function applyOperationalLinkEffects(ctx, args) {
+  assertEvidenceImpact({ relation: args.relation, weight: args.weight });
+  const confidence = Math.abs(args.weight);
   const currentSupporting = args.beliefNode.supportingInsightIds ?? [];
   const currentContradicting = args.beliefNode.contradictingInsightIds ?? [];
-  if (args.relation === "supports") {
-    if (!currentSupporting.includes(args.insightId)) {
-      await ctx.db.patch(args.beliefId, {
-        supportingInsightIds: [...currentSupporting, args.insightId],
-        contradictingInsightIds: currentContradicting.filter(
-          (id) => id !== args.insightId
-        )
-      });
-    }
-  } else if (!currentContradicting.includes(args.insightId)) {
+  if (args.relation === "supports" && !currentSupporting.includes(args.insightId)) {
+    await ctx.db.patch(args.beliefId, {
+      supportingInsightIds: [...currentSupporting, args.insightId],
+      contradictingInsightIds: currentContradicting.filter(
+        (id) => id !== args.insightId
+      )
+    });
+  } else if (args.relation === "contradicts" && !currentContradicting.includes(args.insightId)) {
     await ctx.db.patch(args.beliefId, {
       contradictingInsightIds: [...currentContradicting, args.insightId],
       supportingInsightIds: currentSupporting.filter(
@@ -748,7 +693,7 @@ async function applyOperationalLinkEffects(ctx, args) {
   try {
     const beliefSpineNode = await ctx.db.get(args.beliefId);
     const evidenceSpineNode = await ctx.db.get(args.insightId);
-    if (beliefSpineNode && beliefSpineNode.nodeType === "belief" && evidenceSpineNode && evidenceSpineNode.nodeType === "evidence") {
+    if (beliefSpineNode?.nodeType === "belief" && evidenceSpineNode?.nodeType === "evidence") {
       const existingEdges = await ctx.db.query("epistemicEdges").withIndex(
         "by_from_to",
         (q) => q.eq("fromNodeId", evidenceSpineNode._id).eq("toNodeId", beliefSpineNode._id)
@@ -761,16 +706,44 @@ async function applyOperationalLinkEffects(ctx, args) {
           await ctx.db.delete(edge._id);
         }
       }
-      const weight = args.relation === "supports" ? args.confidence ?? 0.7 : -(args.confidence ?? 0.7);
       const globalId = `edge-${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;
+      const context = args.rationale || `Linked as ${args.relation}`;
+      await ctx.db.insert("epistemicEdges", {
+        globalId,
+        fromNodeId: evidenceSpineNode._id,
+        toNodeId: beliefSpineNode._id,
+        sourceGlobalId: evidenceSpineNode.globalId,
+        targetGlobalId: beliefSpineNode.globalId,
+        edgeType: "informs",
+        weight: args.weight,
+        confidence,
+        context,
+        reasoningMethod: "testimonial",
+        derivationType: "evidence_sl_scoring",
+        metadata: {
+          relation: args.relation,
+          confidence,
+          impactScore: args.weight,
+          invariant: "evidence.belief_impact_required"
+        },
+        createdBy: args.createdBy,
+        createdAt: Date.now(),
+        updatedAt: Date.now(),
+        projectId: args.beliefNode.projectId,
+        topicId: args.beliefNode.topicId ? String(args.beliefNode.topicId) : void 0,
+        fromNodeType: "evidence",
+        toNodeType: "belief",
+        fromLayer: "L2",
+        toLayer: "L3"
+      });
       await ctx.scheduler.runAfter(0, internal.neo4jEdgeAPI.createEdge, {
         globalId,
         fromGlobalId: evidenceSpineNode.globalId,
         toGlobalId: beliefSpineNode.globalId,
         edgeType: "informs",
-        weight,
-        confidence: args.confidence,
-        context: args.rationale || `Linked as ${args.relation}`,
+        weight: args.weight,
+        confidence,
+        context,
         projectId: args.beliefNode.projectId ? String(args.beliefNode.projectId) : void 0,
         createdBy: args.createdBy,
         fromNodeType: "evidence",
@@ -783,17 +756,13 @@ async function applyOperationalLinkEffects(ctx, args) {
     console.error("[EpistemicSpine] Failed to create informs edge:", e);
   }
   if (args.beliefNode.projectId) {
-    await ctx.scheduler.runAfter(
-      0,
-      "verificationActions:deepVerifyEvidence",
-      {
-        insightId: args.insightId,
-        targetType: "belief",
-        targetId: args.beliefId,
-        projectId: args.beliefNode.projectId,
-        userId: args.createdBy
-      }
-    );
+    await ctx.scheduler.runAfter(0, "verificationActions:deepVerifyEvidence", {
+      insightId: args.insightId,
+      targetType: "belief",
+      targetId: args.beliefId,
+      projectId: args.beliefNode.projectId,
+      userId: args.createdBy
+    });
   }
 }
 async function removeOperationalLinkEffects(ctx, args) {
@@ -818,7 +787,7 @@ async function removeOperationalLinkEffects(ctx, args) {
   try {
     const beliefSpineNode = await ctx.db.get(args.beliefId);
     const evidenceSpineNode = await ctx.db.get(args.insightId);
-    if (beliefSpineNode && beliefSpineNode.nodeType === "belief" && evidenceSpineNode && evidenceSpineNode.nodeType === "evidence") {
+    if (beliefSpineNode?.nodeType === "belief" && evidenceSpineNode?.nodeType === "evidence") {
       const edges = await ctx.db.query("epistemicEdges").withIndex(
         "by_from_to",
         (q) => q.eq("fromNodeId", evidenceSpineNode._id).eq("toNodeId", beliefSpineNode._id)
@@ -836,11 +805,80 @@ async function removeOperationalLinkEffects(ctx, args) {
     console.error("[EpistemicSpine] Failed to remove informs edge:", e);
   }
 }
+
+// src/beliefEvidenceLinks.ts
+var beliefIdUnion = v.id("epistemicNodes");
+var insightIdUnion = v.id("epistemicNodes");
+var suggestionStatusValidator = v.union(
+  v.literal("suggested"),
+  v.literal("approved"),
+  v.literal("dismissed")
+);
+var matcherMetadataValidator = v.object({
+  surface: v.string(),
+  matcherFamily: v.optional(v.string()),
+  matcherKey: v.optional(v.string()),
+  matcherVersion: v.optional(v.string()),
+  reviewStatus: v.optional(
+    v.union(
+      v.literal("pending"),
+      v.literal("accepted"),
+      v.literal("rejected"),
+      v.literal("auto_accepted"),
+      v.literal("superseded")
+    )
+  ),
+  configSnapshot: v.optional(v.any()),
+  signalSnapshot: v.optional(v.any()),
+  outcomeMetadata: v.optional(v.any())
+});
+async function markProjectGraphDirty(ctx, projectId) {
+  if (!projectId) {
+    return;
+  }
+  await ctx.scheduler.runAfter(
+    0,
+    internal.graphAnalysisCache.markCacheStaleInternal,
+    {
+      projectId
+    }
+  );
+  await resolveGraphPrimitivesAppResolvers().patchProject(ctx, projectId, {
+    lastActivityAt: Date.now()
+  });
+}
+async function recordMatcherDecision(ctx, args) {
+  if (!args.matcherMetadata) {
+    return;
+  }
+  await ctx.runMutation("matcherFeedback:recordDecision", {
+    projectId: args.beliefNode.projectId,
+    topicId: args.beliefNode.topicId,
+    surface: args.matcherMetadata.surface,
+    matcherFamily: args.matcherMetadata.matcherFamily,
+    matcherKey: args.matcherMetadata.matcherKey,
+    matcherVersion: args.matcherMetadata.matcherVersion,
+    sourceEntityId: String(args.insightId),
+    targetEntityId: String(args.beliefId),
+    suggestionTable: "beliefEvidenceLinks",
+    suggestionId: args.linkId,
+    reviewStatus: deriveMatcherReviewStatus({
+      explicitReviewStatus: args.matcherMetadata.reviewStatus,
+      linkStatus: args.linkStatus
+    }),
+    reviewedBy: args.reviewedBy,
+    decisionReason: args.decisionReason,
+    configSnapshot: args.matcherMetadata.configSnapshot,
+    signalSnapshot: args.matcherMetadata.signalSnapshot,
+    outcomeMetadata: args.matcherMetadata.outcomeMetadata
+  });
+}
 var create = mutation({
   args: {
     beliefId: beliefIdUnion,
     insightId: insightIdUnion,
     relation: v.union(v.literal("supports"), v.literal("contradicts")),
+    weight: v.number(),
     confidence: v.optional(v.number()),
     rationale: v.optional(v.string()),
     status: v.optional(suggestionStatusValidator),
@@ -859,6 +897,16 @@ var create = mutation({
     if (!insightNode) {
       throw new Error("Evidence node not found");
     }
+    if (!Number.isFinite(args.weight) || args.weight === 0 || args.weight < -1 || args.weight > 1) {
+      throw new Error("Belief evidence links require explicit nonzero weight in [-1, 1]");
+    }
+    if (args.relation === "supports" && args.weight < 0) {
+      throw new Error("Supporting evidence links require positive weight");
+    }
+    if (args.relation === "contradicts" && args.weight > 0) {
+      throw new Error("Contradicting evidence links require negative weight");
+    }
+    const relationConfidence = Math.abs(args.weight);
     if (beliefNode.projectId) {
       const hasAccess = await checkProjectAccess(
         ctx,
@@ -883,7 +931,7 @@ var create = mutation({
       );
       await ctx.db.patch(duplicate._id, {
         relation: args.relation,
-        confidence: args.confidence,
+        confidence: relationConfidence,
         rationale: args.rationale,
         status: nextStatus
       });
@@ -895,7 +943,7 @@ var create = mutation({
           beliefId: resolvedBeliefId,
           insightId: resolvedInsightId,
           relation: args.relation,
-          confidence: args.confidence,
+          weight: args.weight,
           rationale: args.rationale,
           createdBy: args.createdBy
         });
@@ -911,15 +959,12 @@ var create = mutation({
       await markProjectGraphDirty(ctx, beliefNode.projectId);
       return duplicate._id;
     }
-    if (args.confidence !== void 0 && (args.confidence < 0 || args.confidence > 1)) {
-      throw new Error("Confidence must be between 0 and 1");
-    }
     const now = Date.now();
     const linkId = await ctx.db.insert("beliefEvidenceLinks", {
       beliefId: args.beliefId,
       insightId: args.insightId,
       relation: args.relation,
-      confidence: args.confidence,
+      confidence: relationConfidence,
       rationale: args.rationale,
       status: args.status,
       createdBy: args.createdBy,
@@ -939,7 +984,7 @@ var create = mutation({
         beliefId: resolvedBeliefId,
         insightId: resolvedInsightId,
         relation: args.relation,
-        confidence: args.confidence,
+        weight: args.weight,
         rationale: args.rationale,
         createdBy: args.createdBy
       });
@@ -1047,7 +1092,7 @@ var reviewSuggestion = mutation({
         beliefId: link.beliefId,
         insightId: link.insightId,
         relation: link.relation,
-        confidence: link.confidence,
+        weight: link.relation === "supports" ? Math.abs(link.confidence ?? 0) : -Math.abs(link.confidence ?? 0),
         rationale: link.rationale,
         createdBy: args.userId
       });