@lucern/contracts 1.0.13 → 1.0.15

package/CHANGELOG.md

@@ -46,3 +46,9 @@ All notable changes to `@lucern/contracts` are tracked in this repository.
 ## [1.0.13] - 2026-06-01
 - Publishes the evidence-relation contract, MCP output-schema metadata, and
   retrieval/synthesis receipt fields used by the Campaign 1 closeout surfaces.
+
+## [1.0.14] - 2026-06-01
+- Release notes pending.
+
+## [1.0.15] - 2026-06-01
+- Release notes pending.

package/dist/function-registry/evidence.js

@@ -5513,11 +5513,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 compactRecord2(input) {
@@ -5576,7 +5620,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";
@@ -5716,14 +5760,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: jsonRecordSchema2.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."),
@@ -5765,13 +5813,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) => {
@@ -5798,7 +5851,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,