@lucern/contracts 0.1.2-alpha.1 → 0.1.2-alpha.2

package/dist/api-enums.contract.d.ts

@@ -12,7 +12,7 @@
 declare const FORK_REASONS: readonly ["refinement", "contradiction_response", "scope_change", "confidence_collapse", "manual"];
 type ForkReason = (typeof FORK_REASONS)[number];
 /** Confidence modulation triggers — what caused a confidence change */
-declare const CONFIDENCE_TRIGGERS: readonly ["evidence_added", "contradiction_detected", "merge_outcome", "manual", "decay"];
+declare const CONFIDENCE_TRIGGERS: readonly ["evidence_added", "evidence_removed", "contradiction_detected", "contradiction_resolved", "manual", "decay", "agent_assessment", "worktree_outcome", "worktree_completed", "fusion", "discount", "deduction"];
 type ConfidenceTrigger = (typeof CONFIDENCE_TRIGGERS)[number];
 /** Belief status — lifecycle state */
 declare const BELIEF_STATUSES: readonly ["unscored", "scored", "archived"];

package/dist/api-enums.contract.js

@@ -14,14 +14,28 @@ var FORK_REASONS = [
 var CONFIDENCE_TRIGGERS = [
   "evidence_added",
   // New evidence bore on the belief
+  "evidence_removed",
+  // Evidence was removed or invalidated
   "contradiction_detected",
   // A contradiction was flagged involving this belief
-  "merge_outcome",
-  // Merge scoring determined this confidence
+  "contradiction_resolved",
+  // A contradiction was resolved
   "manual",
   // User manually adjusted confidence
-  "decay"
+  "decay",
   // Time-based confidence erosion
+  "agent_assessment",
+  // An agent provided a structured assessment
+  "worktree_outcome",
+  // Worktree outcome determined this confidence
+  "worktree_completed",
+  // Worktree completed and closed this scoring loop
+  "fusion",
+  // Confidence came from subjective-logic fusion
+  "discount",
+  // Confidence came from trust discounting
+  "deduction"
+  // Confidence came from conditional deduction
 ];
 var BELIEF_STATUSES = [
   "unscored",

package/dist/api-enums.contract.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/api-enums.contract.ts"],"names":[],"mappings":";AAgBO,IAAM,YAAA,GAAe;AAAA,EAC1B,YAAA;AAAA;AAAA,EACA,wBAAA;AAAA;AAAA,EACA,cAAA;AAAA;AAAA,EACA,qBAAA;AAAA;AAAA,EACA;AAAA;AACF;AAIO,IAAM,mBAAA,GAAsB;AAAA,EACjC,gBAAA;AAAA;AAAA,EACA,wBAAA;AAAA;AAAA,EACA,eAAA;AAAA;AAAA,EACA,QAAA;AAAA;AAAA,EACA;AAAA;AACF;AAIO,IAAM,eAAA,GAAkB;AAAA,EAC7B,UAAA;AAAA;AAAA,EACA,QAAA;AAAA;AAAA,EACA;AAAA;AACF;AAQO,IAAM,iBAAA,GAAoB;AAAA,EAC/B,WAAA;AAAA;AAAA,EACA,WAAA;AAAA;AAAA,EACA,WAAA;AAAA;AAAA,EACA,YAAA;AAAA;AAAA,EACA;AAAA;AACF;AAIO,IAAM,YAAA,GAAe;AAAA,EAC1B,QAAA;AAAA;AAAA,EACA,WAAA;AAAA;AAAA,EACA;AAAA;AACF;AAIO,IAAM,wBAAA,GAA2B;AAAA,EACtC,KAAA;AAAA;AAAA,EACA,QAAA;AAAA;AAAA,EACA,MAAA;AAAA;AAAA,EACA;AAAA;AACF;AAIO,IAAM,sBAAA,GAAyB;AAAA,EACpC,YAAA;AAAA;AAAA,EACA,UAAA;AAAA;AAAA,EACA;AAAA;AACF;AAQO,IAAM,cAAA,GAAiB;AAAA,EAC5B,WAAA;AAAA;AAAA,EACA,aAAA;AAAA;AAAA,EACA,QAAA;AAAA;AAAA,EACA;AAAA;AACF;AAIO,IAAM,eAAA,GAAkB;AAAA,EAC7B,YAAA;AAAA;AAAA,EACA,eAAA;AAAA;AAAA,EACA,YAAA;AAAA;AAAA,EACA;AAAA;AACF;AAQO,IAAM,eAAA,GAAkB;AAAA,EAC7B,SAAA;AAAA;AAAA,EACA,QAAA;AAAA;AAAA,EACA;AAAA;AACF;AAQO,IAAM,qBAAA,GAAwB;AAAA,EACnC,gBAAA;AAAA;AAAA,EACA,mBAAA;AAAA;AAAA,EACA,UAAA;AAAA;AAAA,EACA;AAAA;AACF;AAQO,IAAM,gBAAA,GAAmB;AAAA,EAC9B,IAAA;AAAA;AAAA,EACA,IAAA;AAAA;AAAA,EACA,IAAA;AAAA;AAAA,EACA;AAAA;AACF;AAcO,IAAM,cAAA,GAAiB;AAAA,EAC5B,mBAAA;AAAA;AAAA,EACA,iBAAA;AAAA;AAAA,EACA,sBAAA;AAAA;AAAA,EACA,qBAAA;AAAA;AAAA,EACA;AAAA;AACF;AAQO,IAAM,sBAAA,GAAyB;AAAA;AAAA,EAEpC,SAAA;AAAA;AAAA,EACA,SAAA;AAAA;AAAA,EACA,SAAA;AAAA;AAAA;AAAA,EAEA,aAAA;AAAA;AAAA,EACA,UAAA;AAAA;AAAA;AAAA,EAEA,YAAA;AAAA;AAAA,EACA,cAAA;AAAA;AAAA,EACA,UAAA;AAAA;AAAA,EACA,YAAA;AAAA;AAAA,EACA;AAAA;AACF","file":"api-enums.contract.js","sourcesContent":["/**\n * API Enum Contract Definitions\n *\n * Canonical enum values for all API-facing enumerations.\n * These are co-equal with MCP contracts as external contracts.\n * SDK types are DERIVED from these — not independently authored.\n *\n * CONTRACT SURFACE: Adding a new enum value is additive (non-breaking).\n * Removing or renaming an existing value is a BREAKING CHANGE.\n */\n\n// =============================================================================\n// BELIEF ENUMS\n// =============================================================================\n\n/** Fork reasons — why a scored belief was branched */\nexport const FORK_REASONS = [\n  \"refinement\", // Belief text evolved based on new understanding\n  \"contradiction_response\", // Created in response to a detected contradiction\n  \"scope_change\", // Belief scope narrowed or broadened\n  \"confidence_collapse\", // Confidence dropped below viability threshold\n  \"manual\", // User-initiated fork without specific trigger\n] as const;\nexport type ForkReason = (typeof FORK_REASONS)[number];\n\n/** Confidence modulation triggers — what caused a confidence change */\nexport const CONFIDENCE_TRIGGERS = [\n  \"evidence_added\", // New evidence bore on the belief\n  \"contradiction_detected\", // A contradiction was flagged involving this belief\n  \"merge_outcome\", // Merge scoring determined this confidence\n  \"manual\", // User manually adjusted confidence\n  \"decay\", // Time-based confidence erosion\n] as const;\nexport type ConfidenceTrigger = (typeof CONFIDENCE_TRIGGERS)[number];\n\n/** Belief status — lifecycle state */\nexport const BELIEF_STATUSES = [\n  \"unscored\", // Draft — editable in worktree (on feature branch, pre-merge)\n  \"scored\", // Merged — formulation frozen (merged to main)\n  \"archived\", // Soft-deleted — preserved in history (git rm)\n] as const;\nexport type BeliefStatus = (typeof BELIEF_STATUSES)[number];\n\n// =============================================================================\n// EDGE ENUMS\n// =============================================================================\n\n/** Reasoning methods — how an edge relationship was determined */\nexport const REASONING_METHODS = [\n  \"deductive\", // Logically entailed\n  \"inductive\", // Generalized from instances\n  \"abductive\", // Best explanation inference\n  \"analogical\", // Reasoning by analogy\n  \"empirical\", // Direct observation/measurement\n] as const;\nexport type ReasoningMethod = (typeof REASONING_METHODS)[number];\n\n/** Defeat types (Pollock taxonomy) — how a contradiction operates */\nexport const DEFEAT_TYPES = [\n  \"rebuts\", // Direct contradiction — reasons for the negation\n  \"undercuts\", // Breaks the inference link between evidence and belief\n  \"undermines\", // Attacks a premise the belief depends on\n] as const;\nexport type DefeatType = (typeof DEFEAT_TYPES)[number];\n\n/** Contradiction severity levels */\nexport const CONTRADICTION_SEVERITIES = [\n  \"low\", // Minor tension, may not require action\n  \"medium\", // Moderate conflict, should be investigated\n  \"high\", // Significant contradiction, likely needs resolution\n  \"critical\", // Blocks progress — must be addressed before judgment\n] as const;\nexport type ContradictionSeverity = (typeof CONTRADICTION_SEVERITIES)[number];\n\n/** Contradiction resolution status */\nexport const CONTRADICTION_STATUSES = [\n  \"unresolved\", // Open conflict — may persist indefinitely\n  \"resolved\", // Conflict addressed (one belief forked, archived, or confidence adjusted)\n  \"accepted\", // Explicitly accepted as irreconcilable — both beliefs maintained\n] as const;\nexport type ContradictionStatus = (typeof CONTRADICTION_STATUSES)[number];\n\n// =============================================================================\n// WORKTREE ENUMS (git worktree lifecycle)\n// =============================================================================\n\n/** Merge outcome types — how a worktree merge resolved */\nexport const MERGE_OUTCOMES = [\n  \"validated\", // Beliefs confirmed — clean merge to main\n  \"invalidated\", // Defeat recorded — confidence collapsed (merge with revert)\n  \"forked\", // Beliefs split into competing versions (fork from merge point)\n  \"inconclusive\", // Insufficient evidence — stashed (git stash)\n] as const;\nexport type MergeOutcome = (typeof MERGE_OUTCOMES)[number];\n\n/** Worktree phases — investigation lifecycle within a checked-out worktree */\nexport const WORKTREE_PHASES = [\n  \"hypothesis\", // Form testable claims (write the code — commits)\n  \"investigation\", // Collect evidence (run the tests — more commits)\n  \"evaluation\", // Update credences (review the results — amend as needed)\n  \"resolution\", // Determine outcome (merge to main, fork, or stash)\n] as const;\nexport type WorktreePhase = (typeof WORKTREE_PHASES)[number];\n\n// =============================================================================\n// BRANCH ENUMS (git branch lifecycle)\n// =============================================================================\n\n/** Branch status — thematic branch lifecycle */\nexport const BRANCH_STATUSES = [\n  \"dormant\", // Branch exists but no active worktree (no one investigating)\n  \"active\", // At least one worktree is investigating this branch\n  \"archived\", // Branch retired — no longer a relevant thematic container\n] as const;\nexport type BranchStatus = (typeof BRANCH_STATUSES)[number];\n\n// =============================================================================\n// PULL REQUEST ENUMS (git pull request lifecycle)\n// =============================================================================\n\n/** Pull request status — review lifecycle before merge */\nexport const PULL_REQUEST_STATUSES = [\n  \"pending_review\", // PR opened — awaiting reviewer feedback\n  \"changes_requested\", // Reviewer requests changes before merge\n  \"approved\", // Approved — ready to merge\n  \"blocked\", // Blocked — cannot merge until contradiction is resolved\n] as const;\nexport type PullRequestStatus = (typeof PULL_REQUEST_STATUSES)[number];\n\n// =============================================================================\n// LAYER ENUMS\n// =============================================================================\n\n/** Epistemic layers — the hierarchy of knowledge */\nexport const EPISTEMIC_LAYERS = [\n  \"L1\", // Source — the given (vendored deps)\n  \"L2\", // Evidence — the interpreted (test suite)\n  \"L3\", // Belief — the structural (source files)\n  \"L4\", // Judgment — the committed (release tags)\n] as const;\nexport type EpistemicLayer = (typeof EPISTEMIC_LAYERS)[number];\n\n// =============================================================================\n// JUDGMENT ENUMS (Phase 1: new vocabulary)\n// =============================================================================\n\n/**\n * Judgment type — classification of the determination.\n *\n * Phase 1: These are new enum values for the Judgment (L4) vocabulary.\n * The existing code uses \"Decision\" — these are the forward-looking terms\n * that will eventually replace the Decision vocabulary (Phase 2-3).\n */\nexport const JUDGMENT_TYPES = [\n  \"investment_thesis\", // Judgment on an investment opportunity\n  \"thesis_maturity\", // Judgment that a thesis is ready for IC presentation\n  \"contradiction_ruling\", // Judgment on how to handle an irreconcilable contradiction\n  \"scope_determination\", // Judgment that defines or redefines investigation scope\n  \"confidence_ruling\", // Judgment that overrides automated confidence for policy reasons\n] as const;\nexport type JudgmentType = (typeof JUDGMENT_TYPES)[number];\n\n// =============================================================================\n// SUPPORT RELATION ENUMS\n// =============================================================================\n\n/** Core edge types used in the Integration Surfaces */\nexport const INTEGRATION_EDGE_TYPES = [\n  // Support relations\n  \"informs\", // Evidence bears on a belief (weight = direction/strength)\n  \"grounds\", // Source provides raw basis for evidence\n  \"answers\", // Evidence or belief resolves a question\n  // Defeat relations (Pollock) — weight carries direction\n  \"contradicts\", // Rebuts — direct contradiction\n  \"supports\", // Weight carries valence (negative = weakens/undercuts)\n  // Structural relations\n  \"depends_on\", // Belief B requires Belief A\n  \"derived_from\", // Provenance lineage\n  \"contains\", // Hierarchical containment\n  \"supersedes\", // New version replaces old (lineage)\n  \"tests\", // Question tests a belief\n] as const;\nexport type IntegrationEdgeType = (typeof INTEGRATION_EDGE_TYPES)[number];\n"]}
+{"version":3,"sources":["../src/api-enums.contract.ts"],"names":[],"mappings":";AAgBO,IAAM,YAAA,GAAe;AAAA,EAC1B,YAAA;AAAA;AAAA,EACA,wBAAA;AAAA;AAAA,EACA,cAAA;AAAA;AAAA,EACA,qBAAA;AAAA;AAAA,EACA;AAAA;AACF;AAIO,IAAM,mBAAA,GAAsB;AAAA,EACjC,gBAAA;AAAA;AAAA,EACA,kBAAA;AAAA;AAAA,EACA,wBAAA;AAAA;AAAA,EACA,wBAAA;AAAA;AAAA,EACA,QAAA;AAAA;AAAA,EACA,OAAA;AAAA;AAAA,EACA,kBAAA;AAAA;AAAA,EACA,kBAAA;AAAA;AAAA,EACA,oBAAA;AAAA;AAAA,EACA,QAAA;AAAA;AAAA,EACA,UAAA;AAAA;AAAA,EACA;AAAA;AACF;AAIO,IAAM,eAAA,GAAkB;AAAA,EAC7B,UAAA;AAAA;AAAA,EACA,QAAA;AAAA;AAAA,EACA;AAAA;AACF;AAQO,IAAM,iBAAA,GAAoB;AAAA,EAC/B,WAAA;AAAA;AAAA,EACA,WAAA;AAAA;AAAA,EACA,WAAA;AAAA;AAAA,EACA,YAAA;AAAA;AAAA,EACA;AAAA;AACF;AAIO,IAAM,YAAA,GAAe;AAAA,EAC1B,QAAA;AAAA;AAAA,EACA,WAAA;AAAA;AAAA,EACA;AAAA;AACF;AAIO,IAAM,wBAAA,GAA2B;AAAA,EACtC,KAAA;AAAA;AAAA,EACA,QAAA;AAAA;AAAA,EACA,MAAA;AAAA;AAAA,EACA;AAAA;AACF;AAIO,IAAM,sBAAA,GAAyB;AAAA,EACpC,YAAA;AAAA;AAAA,EACA,UAAA;AAAA;AAAA,EACA;AAAA;AACF;AAQO,IAAM,cAAA,GAAiB;AAAA,EAC5B,WAAA;AAAA;AAAA,EACA,aAAA;AAAA;AAAA,EACA,QAAA;AAAA;AAAA,EACA;AAAA;AACF;AAIO,IAAM,eAAA,GAAkB;AAAA,EAC7B,YAAA;AAAA;AAAA,EACA,eAAA;AAAA;AAAA,EACA,YAAA;AAAA;AAAA,EACA;AAAA;AACF;AAQO,IAAM,eAAA,GAAkB;AAAA,EAC7B,SAAA;AAAA;AAAA,EACA,QAAA;AAAA;AAAA,EACA;AAAA;AACF;AAQO,IAAM,qBAAA,GAAwB;AAAA,EACnC,gBAAA;AAAA;AAAA,EACA,mBAAA;AAAA;AAAA,EACA,UAAA;AAAA;AAAA,EACA;AAAA;AACF;AAQO,IAAM,gBAAA,GAAmB;AAAA,EAC9B,IAAA;AAAA;AAAA,EACA,IAAA;AAAA;AAAA,EACA,IAAA;AAAA;AAAA,EACA;AAAA;AACF;AAcO,IAAM,cAAA,GAAiB;AAAA,EAC5B,mBAAA;AAAA;AAAA,EACA,iBAAA;AAAA;AAAA,EACA,sBAAA;AAAA;AAAA,EACA,qBAAA;AAAA;AAAA,EACA;AAAA;AACF;AAQO,IAAM,sBAAA,GAAyB;AAAA;AAAA,EAEpC,SAAA;AAAA;AAAA,EACA,SAAA;AAAA;AAAA,EACA,SAAA;AAAA;AAAA;AAAA,EAEA,aAAA;AAAA;AAAA,EACA,UAAA;AAAA;AAAA;AAAA,EAEA,YAAA;AAAA;AAAA,EACA,cAAA;AAAA;AAAA,EACA,UAAA;AAAA;AAAA,EACA,YAAA;AAAA;AAAA,EACA;AAAA;AACF","file":"api-enums.contract.js","sourcesContent":["/**\n * API Enum Contract Definitions\n *\n * Canonical enum values for all API-facing enumerations.\n * These are co-equal with MCP contracts as external contracts.\n * SDK types are DERIVED from these — not independently authored.\n *\n * CONTRACT SURFACE: Adding a new enum value is additive (non-breaking).\n * Removing or renaming an existing value is a BREAKING CHANGE.\n */\n\n// =============================================================================\n// BELIEF ENUMS\n// =============================================================================\n\n/** Fork reasons — why a scored belief was branched */\nexport const FORK_REASONS = [\n  \"refinement\", // Belief text evolved based on new understanding\n  \"contradiction_response\", // Created in response to a detected contradiction\n  \"scope_change\", // Belief scope narrowed or broadened\n  \"confidence_collapse\", // Confidence dropped below viability threshold\n  \"manual\", // User-initiated fork without specific trigger\n] as const;\nexport type ForkReason = (typeof FORK_REASONS)[number];\n\n/** Confidence modulation triggers — what caused a confidence change */\nexport const CONFIDENCE_TRIGGERS = [\n  \"evidence_added\", // New evidence bore on the belief\n  \"evidence_removed\", // Evidence was removed or invalidated\n  \"contradiction_detected\", // A contradiction was flagged involving this belief\n  \"contradiction_resolved\", // A contradiction was resolved\n  \"manual\", // User manually adjusted confidence\n  \"decay\", // Time-based confidence erosion\n  \"agent_assessment\", // An agent provided a structured assessment\n  \"worktree_outcome\", // Worktree outcome determined this confidence\n  \"worktree_completed\", // Worktree completed and closed this scoring loop\n  \"fusion\", // Confidence came from subjective-logic fusion\n  \"discount\", // Confidence came from trust discounting\n  \"deduction\", // Confidence came from conditional deduction\n] as const;\nexport type ConfidenceTrigger = (typeof CONFIDENCE_TRIGGERS)[number];\n\n/** Belief status — lifecycle state */\nexport const BELIEF_STATUSES = [\n  \"unscored\", // Draft — editable in worktree (on feature branch, pre-merge)\n  \"scored\", // Merged — formulation frozen (merged to main)\n  \"archived\", // Soft-deleted — preserved in history (git rm)\n] as const;\nexport type BeliefStatus = (typeof BELIEF_STATUSES)[number];\n\n// =============================================================================\n// EDGE ENUMS\n// =============================================================================\n\n/** Reasoning methods — how an edge relationship was determined */\nexport const REASONING_METHODS = [\n  \"deductive\", // Logically entailed\n  \"inductive\", // Generalized from instances\n  \"abductive\", // Best explanation inference\n  \"analogical\", // Reasoning by analogy\n  \"empirical\", // Direct observation/measurement\n] as const;\nexport type ReasoningMethod = (typeof REASONING_METHODS)[number];\n\n/** Defeat types (Pollock taxonomy) — how a contradiction operates */\nexport const DEFEAT_TYPES = [\n  \"rebuts\", // Direct contradiction — reasons for the negation\n  \"undercuts\", // Breaks the inference link between evidence and belief\n  \"undermines\", // Attacks a premise the belief depends on\n] as const;\nexport type DefeatType = (typeof DEFEAT_TYPES)[number];\n\n/** Contradiction severity levels */\nexport const CONTRADICTION_SEVERITIES = [\n  \"low\", // Minor tension, may not require action\n  \"medium\", // Moderate conflict, should be investigated\n  \"high\", // Significant contradiction, likely needs resolution\n  \"critical\", // Blocks progress — must be addressed before judgment\n] as const;\nexport type ContradictionSeverity = (typeof CONTRADICTION_SEVERITIES)[number];\n\n/** Contradiction resolution status */\nexport const CONTRADICTION_STATUSES = [\n  \"unresolved\", // Open conflict — may persist indefinitely\n  \"resolved\", // Conflict addressed (one belief forked, archived, or confidence adjusted)\n  \"accepted\", // Explicitly accepted as irreconcilable — both beliefs maintained\n] as const;\nexport type ContradictionStatus = (typeof CONTRADICTION_STATUSES)[number];\n\n// =============================================================================\n// WORKTREE ENUMS (git worktree lifecycle)\n// =============================================================================\n\n/** Merge outcome types — how a worktree merge resolved */\nexport const MERGE_OUTCOMES = [\n  \"validated\", // Beliefs confirmed — clean merge to main\n  \"invalidated\", // Defeat recorded — confidence collapsed (merge with revert)\n  \"forked\", // Beliefs split into competing versions (fork from merge point)\n  \"inconclusive\", // Insufficient evidence — stashed (git stash)\n] as const;\nexport type MergeOutcome = (typeof MERGE_OUTCOMES)[number];\n\n/** Worktree phases — investigation lifecycle within a checked-out worktree */\nexport const WORKTREE_PHASES = [\n  \"hypothesis\", // Form testable claims (write the code — commits)\n  \"investigation\", // Collect evidence (run the tests — more commits)\n  \"evaluation\", // Update credences (review the results — amend as needed)\n  \"resolution\", // Determine outcome (merge to main, fork, or stash)\n] as const;\nexport type WorktreePhase = (typeof WORKTREE_PHASES)[number];\n\n// =============================================================================\n// BRANCH ENUMS (git branch lifecycle)\n// =============================================================================\n\n/** Branch status — thematic branch lifecycle */\nexport const BRANCH_STATUSES = [\n  \"dormant\", // Branch exists but no active worktree (no one investigating)\n  \"active\", // At least one worktree is investigating this branch\n  \"archived\", // Branch retired — no longer a relevant thematic container\n] as const;\nexport type BranchStatus = (typeof BRANCH_STATUSES)[number];\n\n// =============================================================================\n// PULL REQUEST ENUMS (git pull request lifecycle)\n// =============================================================================\n\n/** Pull request status — review lifecycle before merge */\nexport const PULL_REQUEST_STATUSES = [\n  \"pending_review\", // PR opened — awaiting reviewer feedback\n  \"changes_requested\", // Reviewer requests changes before merge\n  \"approved\", // Approved — ready to merge\n  \"blocked\", // Blocked — cannot merge until contradiction is resolved\n] as const;\nexport type PullRequestStatus = (typeof PULL_REQUEST_STATUSES)[number];\n\n// =============================================================================\n// LAYER ENUMS\n// =============================================================================\n\n/** Epistemic layers — the hierarchy of knowledge */\nexport const EPISTEMIC_LAYERS = [\n  \"L1\", // Source — the given (vendored deps)\n  \"L2\", // Evidence — the interpreted (test suite)\n  \"L3\", // Belief — the structural (source files)\n  \"L4\", // Judgment — the committed (release tags)\n] as const;\nexport type EpistemicLayer = (typeof EPISTEMIC_LAYERS)[number];\n\n// =============================================================================\n// JUDGMENT ENUMS (Phase 1: new vocabulary)\n// =============================================================================\n\n/**\n * Judgment type — classification of the determination.\n *\n * Phase 1: These are new enum values for the Judgment (L4) vocabulary.\n * The existing code uses \"Decision\" — these are the forward-looking terms\n * that will eventually replace the Decision vocabulary (Phase 2-3).\n */\nexport const JUDGMENT_TYPES = [\n  \"investment_thesis\", // Judgment on an investment opportunity\n  \"thesis_maturity\", // Judgment that a thesis is ready for IC presentation\n  \"contradiction_ruling\", // Judgment on how to handle an irreconcilable contradiction\n  \"scope_determination\", // Judgment that defines or redefines investigation scope\n  \"confidence_ruling\", // Judgment that overrides automated confidence for policy reasons\n] as const;\nexport type JudgmentType = (typeof JUDGMENT_TYPES)[number];\n\n// =============================================================================\n// SUPPORT RELATION ENUMS\n// =============================================================================\n\n/** Core edge types used in the Integration Surfaces */\nexport const INTEGRATION_EDGE_TYPES = [\n  // Support relations\n  \"informs\", // Evidence bears on a belief (weight = direction/strength)\n  \"grounds\", // Source provides raw basis for evidence\n  \"answers\", // Evidence or belief resolves a question\n  // Defeat relations (Pollock) — weight carries direction\n  \"contradicts\", // Rebuts — direct contradiction\n  \"supports\", // Weight carries valence (negative = weakens/undercuts)\n  // Structural relations\n  \"depends_on\", // Belief B requires Belief A\n  \"derived_from\", // Provenance lineage\n  \"contains\", // Hierarchical containment\n  \"supersedes\", // New version replaces old (lineage)\n  \"tests\", // Question tests a belief\n] as const;\nexport type IntegrationEdgeType = (typeof INTEGRATION_EDGE_TYPES)[number];\n"]}

package/dist/index.js

@@ -20,14 +20,28 @@ var FORK_REASONS = [
 var CONFIDENCE_TRIGGERS = [
   "evidence_added",
   // New evidence bore on the belief
+  "evidence_removed",
+  // Evidence was removed or invalidated
   "contradiction_detected",
   // A contradiction was flagged involving this belief
-  "merge_outcome",
-  // Merge scoring determined this confidence
+  "contradiction_resolved",
+  // A contradiction was resolved
   "manual",
   // User manually adjusted confidence
-  "decay"
+  "decay",
   // Time-based confidence erosion
+  "agent_assessment",
+  // An agent provided a structured assessment
+  "worktree_outcome",
+  // Worktree outcome determined this confidence
+  "worktree_completed",
+  // Worktree completed and closed this scoring loop
+  "fusion",
+  // Confidence came from subjective-logic fusion
+  "discount",
+  // Confidence came from trust discounting
+  "deduction"
+  // Confidence came from conditional deduction
 ];
 var BELIEF_STATUSES = [
   "unscored",
@@ -580,13 +594,17 @@ var LENS_PERSPECTIVE_TYPES = [
 // src/mcp-tools.contract.ts
 var CREATE_BELIEF = {
   name: "create_belief",
-  description: "Commit a new belief (knowledge unit) to the reasoning graph. Like `git commit` \u2014 creates an atomic, traceable knowledge object. The belief starts as unscored (draft). Score it with modulate_confidence to freeze the formulation.",
+  description: "Commit a new belief (knowledge unit) to the reasoning graph. Like `git commit` \u2014 creates an atomic, traceable knowledge object with a mandatory prior. Creation stores the vacuous opinion `(0, 0, 1, a)`; use modulate_confidence to record the first evidential update.",
   parameters: {
     canonicalText: {
       type: "string",
       description: "The belief statement \u2014 what the agent holds to be true"
     },
     topicId: { type: "string", description: "Topic scope for the belief" },
+    baseRate: {
+      type: "number",
+      description: "Required prior probability used to seed the vacuous opinion `(0, 0, 1, a)` at creation time."
+    },
     beliefType: {
       type: "string",
       description: "Belief type (e.g., hypothesis, belief, principle, invariant, tenet, forecast). Validated against schemaEnumConfig."
@@ -596,7 +614,7 @@ var CREATE_BELIEF = {
       description: "Optional extra metadata merged into the node (e.g., { codeAnchors: ['path/to/file.ts'] } for coding intelligence)"
     }
   },
-  required: ["canonicalText", "topicId"],
+  required: ["canonicalText", "topicId", "baseRate"],
   response: {
     description: "The created canonical belief record",
     fields: {
@@ -659,17 +677,43 @@ var REFINE_BELIEF = {
 };
 var MODULATE_CONFIDENCE = {
   name: "modulate_confidence",
-  description: "Record a confidence change for a belief. Like `git commit` to the credence log \u2014 an atomic, append-only write. Each modulation is a new entry in the history, not an overwrite. Scoring happens via merge; this tool records the individual data points. Triggers: evidence_added, contradiction_detected, merge_outcome, manual, decay.",
+  description: "Record a confidence change for a belief. Like `git commit` to the credence log \u2014 an atomic, append-only write. Each modulation is a new entry in the history, not an overwrite. Scoring happens via merge; this tool records the individual data points. Pass the full subjective-logic tuple (`belief`, `disbelief`, `uncertainty`, `baseRate`) directly. If a caller only has a scalar probability, use `@lucern/sdk` helpers `opinionFromBaseRate`, `opinionFromDogmatic`, or `opinionFromProjected` to name the intended interpretation before calling this tool. Triggers: evidence_added, evidence_removed, contradiction_detected, contradiction_resolved, agent_assessment, worktree_outcome, worktree_completed, fusion, discount, deduction, manual, decay.",
   parameters: {
     nodeId: { type: "string", description: "The belief to score" },
-    confidence: { type: "number", description: "Confidence level in [0, 1]" },
+    belief: {
+      type: "number",
+      description: "Subjective-logic belief mass `b` in [0, 1]"
+    },
+    disbelief: {
+      type: "number",
+      description: "Subjective-logic disbelief mass `d` in [0, 1]"
+    },
+    uncertainty: {
+      type: "number",
+      description: "Subjective-logic uncertainty mass `u` in [0, 1]"
+    },
+    baseRate: {
+      type: "number",
+      description: "Subjective-logic base rate `a` in [0, 1]. Required for tuple payloads."
+    },
+    confidence: {
+      type: "number",
+      description: "Deprecated scalar confidence value in [0, 1]. Scalar-only payloads are rejected as AMBIGUOUS_SCALAR."
+    },
     trigger: {
       type: "string",
       description: "What caused this confidence change",
       enum: [
         "evidence_added",
+        "evidence_removed",
         "contradiction_detected",
-        "merge_outcome",
+        "contradiction_resolved",
+        "agent_assessment",
+        "worktree_outcome",
+        "worktree_completed",
+        "fusion",
+        "discount",
+        "deduction",
         "manual",
         "decay"
       ]
@@ -679,7 +723,7 @@ var MODULATE_CONFIDENCE = {
       description: "Human-readable explanation of why confidence changed"
     }
   },
-  required: ["nodeId", "confidence", "trigger", "rationale"],
+  required: ["nodeId", "trigger", "rationale"],
   response: {
     description: "Confidence modulation result",
     fields: {
@@ -1321,7 +1365,7 @@ var RECORD_JUDGMENT = {
       status: "string \u2014 'issued'"
     }
   },
-  ownerModule: "decision-state",
+  ownerModule: "decisions",
   ontologyPrimitive: "judgment",
   tier: "showcase"
 };
@@ -2590,7 +2634,7 @@ var INGEST_OBSERVATION = {
       contextResourceUri: "string"
     }
   },
-  ownerModule: "agent-harness",
+  ownerModule: "agent-frameworks",
   ontologyPrimitive: "graph",
   tier: "workhorse"
 };
@@ -2620,7 +2664,7 @@ var GET_OBSERVATION_CONTEXT = {
       generatedAt: "number"
     }
   },
-  ownerModule: "agent-harness",
+  ownerModule: "agent-frameworks",
   ontologyPrimitive: "graph",
   tier: "workhorse"
 };
@@ -4559,7 +4603,7 @@ var CREATE_BELIEF_CONDITIONAL = {
       targetBeliefId: "string"
     }
   },
-  ownerModule: "graph-primitives",
+  ownerModule: "edges",
   ontologyPrimitive: "edge",
   tier: "sdk-only"
 };