@lucern/events 1.0.13 → 1.0.14

package/dist/index.js

@@ -11783,11 +11783,55 @@ var createEvidenceInputSchemaBase = z.object({
   metadata: jsonRecordSchema.optional(),
   trustedBypassAccessCheck: z.boolean().optional()
 }).passthrough();
-var createEvidenceInputSchema = createEvidenceInputSchemaBase.refine(
-  (input) => Boolean(input.text ?? input.canonicalText),
-  {
-    message: "create_evidence requires text",
-    path: ["text"]
+function hasNonzeroWeight(value) {
+  return typeof value === "number" && Number.isFinite(value) && value !== 0;
+}
+function hasRelationSignal(value, weight) {
+  return Boolean(normalizeRelation(value, weight));
+}
+var createEvidenceInputSchema = createEvidenceInputSchemaBase.superRefine(
+  (input, ctx) => {
+    if (!input.text && !input.canonicalText) {
+      ctx.addIssue({
+        code: z.ZodIssueCode.custom,
+        message: "create_evidence requires text",
+        path: ["text"]
+      });
+    }
+    const target = input.targetId ?? input.targetNodeId;
+    const kind = targetKind(target);
+    const linksPrimaryBelief = Boolean(
+      input.linkedBeliefNodeId || kind === "belief" || kind === "unknown" && target
+    );
+    const weight = typeof input.weight === "number" ? input.weight : void 0;
+    if (linksPrimaryBelief && !hasRelationSignal(input.evidenceRelation, weight)) {
+      ctx.addIssue({
+        code: z.ZodIssueCode.custom,
+        message: "belief-targeted evidence requires evidenceRelation='supports'|'contradicts' or a nonzero signed weight",
+        path: ["evidenceRelation"]
+      });
+    }
+    input.beliefRelations?.forEach((relation, index) => {
+      const beliefNodeId = relation.beliefNodeId ?? relation.beliefId ?? relation.targetId;
+      if (!beliefNodeId) {
+        ctx.addIssue({
+          code: z.ZodIssueCode.custom,
+          message: "beliefRelations entries require beliefId, beliefNodeId, or targetId",
+          path: ["beliefRelations", index, "beliefNodeId"]
+        });
+      }
+      const relationWeight2 = typeof relation.weight === "number" ? relation.weight : void 0;
+      if (beliefNodeId && !hasRelationSignal(
+        relation.evidenceRelation ?? relation.relation,
+        relationWeight2
+      )) {
+        ctx.addIssue({
+          code: z.ZodIssueCode.custom,
+          message: "beliefRelations entries require evidenceRelation='supports'|'contradicts' or a nonzero signed weight",
+          path: ["beliefRelations", index, "evidenceRelation"]
+        });
+      }
+    });
   }
 );
 function compactRecord(input) {
@@ -11846,7 +11890,7 @@ function normalizeRelation(value, weight) {
   if (value === "contradicts" || value === "contradicting") {
     return "contradicts";
   }
-  if (weight === void 0) {
+  if (weight === void 0 || !hasNonzeroWeight(weight)) {
     return void 0;
   }
   return weight < 0 ? "contradicts" : "supports";
@@ -13355,14 +13399,18 @@ var createEvidenceArgs = z.object({
   text: z.string().describe("Canonical evidence text."),
   source: z.string().optional().describe("Source URL or source label."),
   sourceUrl: z.string().optional().describe("Canonical source URL."),
-  targetId: z.string().optional().describe("Belief, question, or worktree identifier to link or preserve on the evidence record."),
+  targetId: z.string().optional().describe(
+    "Belief, question, or worktree identifier to link or preserve on the evidence record. Belief targets require evidenceRelation or a nonzero signed weight."
+  ),
   linkedBeliefNodeId: z.string().optional().describe("Belief node this evidence bears on."),
-  evidenceRelation: evidenceRelationSchema2.optional().describe("How the evidence relates to the linked belief."),
+  evidenceRelation: evidenceRelationSchema2.optional().describe(
+    "How the evidence relates to the linked belief. Use supports for proof/fixes; use contradicts for bugs, regressions, or falsifying observations."
+  ),
   beliefRelations: z.array(beliefRelationSchema2).optional().describe(
     "Additional belief relations for one evidence record. Use when the same evidence supports or contradicts multiple beliefs."
   ),
   confidence: z.number().optional().describe("Confidence in the evidence relation."),
-  weight: z.number().optional().describe("Support weight from -1.0 to +1.0."),
+  weight: z.number().optional().describe("Nonzero support weight from -1.0 to +1.0."),
   metadata: jsonRecordSchema4.optional().describe("Metadata merged into the canonical evidence node."),
   rationale: z.string().describe("Why this evidence should enter the reasoning graph."),
   reasoning: z.string().optional().describe("Reasoning note preserved in evidence metadata."),
@@ -13404,13 +13452,18 @@ var createEvidenceInput = (input, context) => {
   );
 };
 function relationWeight(input) {
-  if (typeof input.weight === "number") {
+  if (typeof input.weight === "number" && Number.isFinite(input.weight) && input.weight !== 0) {
     return input.weight;
   }
-  const confidence = typeof input.confidence === "number" ? Math.max(0, Math.min(1, input.confidence)) : 0.7;
   const relation = String(
     input.evidenceRelation ?? input.relation ?? input.type ?? ""
   );
+  if (relation !== "supports" && relation !== "supporting" && relation !== "contradicts" && relation !== "contradicting") {
+    throw new Error(
+      "Belief evidence links require evidenceRelation='supports'|'contradicts' or a nonzero signed weight."
+    );
+  }
+  const confidence = typeof input.confidence === "number" ? Math.max(0, Math.min(1, input.confidence)) : 0.7;
   return relation === "contradicts" || relation === "contradicting" ? -confidence : confidence;
 }
 var linkEvidenceToBeliefInput = (input, context) => {
@@ -13437,7 +13490,7 @@ var linkEvidenceToBeliefEdgeInput = (input, context) => withCreatedBy(
     )}:${String(
       input.beliefNodeId ?? input.beliefId ?? input.targetId
     )}:informs`,
-    weight: typeof input.weight === "number" ? input.weight : input.type === "contradicting" ? -1 : 1,
+    weight: relationWeight(input),
     context: input.rationale ?? input.context,
     skipLayerValidation: true,
     topicId: input.topicId,