@lucern/graph-primitives 1.0.15 → 1.0.17

package/dist/epistemicBeliefs.lifecycle.d.ts

@@ -1,5 +1,5 @@
 /** Split belief confidence and lifecycle mutations out of epistemicBeliefs.ts. */
-declare const modulateConfidence: any;
+declare const appendSlScoring: any;
 /**
  * Update a belief's status.
  */
@@ -16,4 +16,4 @@ declare const archive: any;
 declare const updateRationale: any;
 declare const updateStatusInternal: any;
 
-export { archive, modulateConfidence, updateRationale, updateStatus, updateStatusInternal };
+export { appendSlScoring, archive, updateRationale, updateStatus, updateStatusInternal };

package/dist/epistemicBeliefs.lifecycle.js

@@ -384,18 +384,32 @@ function assertTenantPackWorkspaceMutationAllowed(args) {
 var BELIEF_STATUS_VALUES = [
   "assumption",
   "hypothesis",
-  "belief",
-  "fact"
-];
-var RESOLVED_PREDICTION_OUTCOMES = [
-  "confirmed",
-  "disconfirmed",
-  "partial",
-  "expired"
+  "active",
+  "superseded",
+  "resolved_true",
+  "resolved_false"
 ];
 function isBeliefLifecycleStatus(value) {
   return typeof value === "string" && BELIEF_STATUS_VALUES.includes(value);
 }
+function normalizeLegacyBeliefStatus(value) {
+  if (isBeliefLifecycleStatus(value)) {
+    return value;
+  }
+  if (value === "belief" || value === "established" || value === "emerging") {
+    return "active";
+  }
+  if (value === "fact" || value === "confirmed") {
+    return "resolved_true";
+  }
+  if (value === "disconfirmed" || value === "expired") {
+    return "resolved_false";
+  }
+  if (value === "deprecated") {
+    return "superseded";
+  }
+  return null;
+}
 function normalizeBeliefConfidence(confidence) {
   if (typeof confidence !== "number" || !Number.isFinite(confidence)) {
     return null;
@@ -415,47 +429,61 @@ function isResolvedByConfidence(confidence) {
   }
   return normalized <= 0 || normalized >= 1;
 }
-function hasResolvedPredictionOutcome(predictionMeta) {
+function getPredictionMetaFromMetadata(metadata) {
+  return metadata?.predictionMeta;
+}
+function resolvedPredictionStatus(predictionMeta) {
   if (!predictionMeta || typeof predictionMeta !== "object") {
-    return false;
+    return null;
   }
   const outcome = predictionMeta.outcome;
-  return typeof outcome === "string" && RESOLVED_PREDICTION_OUTCOMES.includes(outcome);
-}
-function getPredictionMetaFromMetadata(metadata) {
-  return metadata?.predictionMeta;
+  if (outcome === "confirmed") {
+    return "resolved_true";
+  }
+  if (outcome === "disconfirmed" || outcome === "expired") {
+    return "resolved_false";
+  }
+  return null;
 }
-function shouldTreatBeliefAsFact(opts) {
+function shouldTreatBeliefAsResolved(opts) {
   if (isResolvedByConfidence(opts.confidence)) {
-    return true;
+    const normalized = normalizeBeliefConfidence(opts.confidence);
+    return normalized === 0 ? "resolved_false" : "resolved_true";
   }
-  if (hasResolvedPredictionOutcome(opts.predictionMeta)) {
-    return true;
+  const directPredictionStatus = resolvedPredictionStatus(opts.predictionMeta);
+  if (directPredictionStatus) {
+    return directPredictionStatus;
   }
-  if (hasResolvedPredictionOutcome(getPredictionMetaFromMetadata(opts.metadata))) {
-    return true;
+  const metadataPredictionStatus = resolvedPredictionStatus(
+    getPredictionMetaFromMetadata(opts.metadata)
+  );
+  if (metadataPredictionStatus) {
+    return metadataPredictionStatus;
   }
-  return false;
+  return null;
 }
 function resolveBeliefLifecycleStatus(opts) {
-  if (shouldTreatBeliefAsFact(opts)) {
-    return "fact";
+  const resolvedStatus = shouldTreatBeliefAsResolved(opts);
+  if (resolvedStatus) {
+    return resolvedStatus;
   }
   const direct = opts.beliefStatus;
-  if (isBeliefLifecycleStatus(direct)) {
+  const normalizedDirect = normalizeLegacyBeliefStatus(direct);
+  if (normalizedDirect) {
     const normalized = normalizeBeliefConfidence(opts.confidence);
-    if (normalized !== null && isPreValidationBeliefStatus(direct)) {
-      return "belief";
+    if (normalized !== null && isPreValidationBeliefStatus(normalizedDirect)) {
+      return "active";
     }
-    return direct;
+    return normalizedDirect;
   }
   const metaStatus = opts.metadata?.beliefStatus;
-  if (isBeliefLifecycleStatus(metaStatus)) {
+  const normalizedMetaStatus = normalizeLegacyBeliefStatus(metaStatus);
+  if (normalizedMetaStatus) {
     const normalized = normalizeBeliefConfidence(opts.confidence);
-    if (normalized !== null && isPreValidationBeliefStatus(metaStatus)) {
-      return "belief";
+    if (normalized !== null && isPreValidationBeliefStatus(normalizedMetaStatus)) {
+      return "active";
     }
-    return metaStatus;
+    return normalizedMetaStatus;
   }
   return "assumption";
 }
@@ -463,13 +491,14 @@ function isPreValidationBeliefStatus(status) {
   return status === "assumption" || status === "hypothesis";
 }
 function promoteBeliefStatusAfterScoring(status, opts) {
-  if (shouldTreatBeliefAsFact({ ...opts })) {
-    return "fact";
+  const resolvedStatus = shouldTreatBeliefAsResolved({ ...opts });
+  if (resolvedStatus) {
+    return resolvedStatus;
   }
   if (isPreValidationBeliefStatus(status)) {
-    return "belief";
+    return "active";
   }
-  return status === "fact" ? "fact" : "belief";
+  return status;
 }
 
 // src/edges/contains.ts
@@ -908,7 +937,7 @@ function buildBeliefConfidenceRow(args) {
     disbelief: args.disbelief,
     uncertainty: args.uncertainty,
     baseRate: args.baseRate,
-    slOperator: args.slOperator ?? "manual_assessment",
+    slOperator: args.slOperator ?? "prior_seed",
     trigger: args.trigger,
     ...args.rationale ? { rationale: args.rationale } : {},
     assessedBy: args.assessedBy,
@@ -1040,17 +1069,17 @@ async function applyBeliefConfidenceChange(ctx, args) {
       status: 404,
       code: "NOT_FOUND",
       invariantCode: "belief.exists",
-      suggestion: "Verify nodeId points to an existing node before modulating confidence.",
+      suggestion: "Verify nodeId points to an existing node before appending SL scoring.",
       details: { nodeId: args.nodeId }
     });
   }
   if (node.nodeType !== "belief") {
     throwStructuredMutationError({
-      message: `modulateConfidence only applies to belief nodes. Received nodeType "${node.nodeType}". Entity nodes (company, person, investor, etc.) do not have confidence \u2014 use entityLifecycle.updateEntityAttributes for mutable entity data.`,
+      message: `appendSlScoring only applies to belief nodes. Received nodeType "${node.nodeType}". Entity nodes (company, person, investor, etc.) do not have confidence \u2014 use entityLifecycle.updateEntityAttributes for mutable entity data.`,
       status: 400,
       code: "INVALID_ARGUMENT",
       invariantCode: "entity.no_confidence",
-      suggestion: "Use entityLifecycle.updateEntityAttributes for entity mutations. modulateConfidence is for belief nodes only.",
+      suggestion: "Use entityLifecycle.updateEntityAttributes for entity mutations. appendSlScoring is for belief nodes only.",
       details: { nodeId: args.nodeId, nodeType: node.nodeType }
     });
   }
@@ -1060,7 +1089,7 @@ async function applyBeliefConfidenceChange(ctx, args) {
       status: 400,
       code: "MISSING_SCOPE",
       invariantCode: "belief.project_required",
-      suggestion: "Belief must have a projectId to modulate confidence.",
+      suggestion: "Belief must have a projectId before SL scoring can be appended.",
       details: { nodeId: args.nodeId }
     });
   }
@@ -1083,7 +1112,7 @@ async function applyBeliefConfidenceChange(ctx, args) {
         status: 409,
         code: "CONFLICT",
         invariantCode: "belief.confidence_append_only",
-        suggestion: "Complete a worktree linked to this belief before recording confidence modulation.",
+        suggestion: "Complete a worktree linked to this belief before recording SL scoring.",
         details: { nodeId: args.nodeId }
       });
     }
@@ -1339,7 +1368,7 @@ internalMutation({
 });
 
 // src/epistemicBeliefs.lifecycle.ts
-var modulateConfidence = mutation({
+var appendSlScoring = mutation({
   args: {
     nodeId: v.id("epistemicNodes"),
     // SL opinion — the ONLY confidence input (EK-7)
@@ -1356,8 +1385,6 @@ var modulateConfidence = mutation({
       v.literal("evidence_removed"),
       v.literal("contradiction_detected"),
       v.literal("contradiction_resolved"),
-      v.literal("manual"),
-      v.literal("decay"),
       v.literal("agent_assessment"),
       v.literal("worktree_outcome"),
       v.literal("worktree_completed"),
@@ -1369,7 +1396,7 @@ var modulateConfidence = mutation({
     ),
     rationale: v.optional(v.string()),
     userId: v.string(),
-    // SL operator provenance (optional — defaults to manual_assessment)
+    // SL operator provenance (optional — defaults inside the SL scorer)
     slOperator: v.optional(
       v.union(
         v.literal("cumulative_fusion"),
@@ -1379,7 +1406,8 @@ var modulateConfidence = mutation({
         v.literal("dependency_cascade"),
         v.literal("negation"),
         v.literal("constraint_fusion"),
-        v.literal("manual_assessment")
+        v.literal("no_op"),
+        v.literal("prior_seed")
       )
     ),
     triggeringEvidenceId: v.optional(v.id("epistemicNodes")),
@@ -1603,6 +1631,6 @@ var updateStatusInternal = internalMutation({
   }
 });
 
-export { archive, modulateConfidence, updateRationale, updateStatus, updateStatusInternal };
+export { appendSlScoring, archive, updateRationale, updateStatus, updateStatusInternal };
 //# sourceMappingURL=epistemicBeliefs.lifecycle.js.map
 //# sourceMappingURL=epistemicBeliefs.lifecycle.js.map