@lucern/contracts 0.1.2-alpha.5 → 0.3.0-alpha.1

package/dist/{mcp-tools.contract.js → tool-contracts.js}

@@ -7,19 +7,22 @@ var LENS_PERSPECTIVE_TYPES = [
   "taxonomy"
 ];
 
-// src/mcp-tools.contract.ts
+// src/tool-contracts.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 with a mandatory prior. Creation stores the vacuous opinion `(0, 0, 1, a)`; use modulate_confidence to record the first evidential update.",
+  description: "Commit a new belief (knowledge unit) to the reasoning graph. Like `git commit` \u2014 creates an atomic, traceable knowledge object with a 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" },
+    topicId: {
+      type: "string",
+      description: "Optional topic scope hint for the belief"
+    },
     baseRate: {
       type: "number",
-      description: "Required prior probability used to seed the vacuous opinion `(0, 0, 1, a)` at creation time."
+      description: "Prior probability used to seed the vacuous opinion `(0, 0, 1, a)` at creation time. Defaults to 0.5 when omitted."
     },
     beliefType: {
       type: "string",
@@ -30,7 +33,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", "baseRate"],
+  required: ["canonicalText"],
   response: {
     description: "The created canonical belief record",
     fields: {
@@ -93,7 +96,7 @@ 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. 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.",
+  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. Every modulation must cite a truth-bearing artifact: triggeringEvidenceId, triggeringQuestionId, triggeringAnswerId, triggeringContradictionId, or triggeringWorktreeId. Triggers: evidence_added, evidence_removed, contradiction_detected, contradiction_resolved, agent_assessment, worktree_outcome, worktree_completed, fusion, discount, deduction.",
   parameters: {
     nodeId: { type: "string", description: "The belief to score" },
     belief: {
@@ -112,9 +115,9 @@ var MODULATE_CONFIDENCE = {
       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."
+    worktreeId: {
+      type: "string",
+      description: "Completed worktree that tested this belief when confidence policy requires merge-backed scoring."
     },
     trigger: {
       type: "string",
@@ -129,17 +132,43 @@ var MODULATE_CONFIDENCE = {
         "worktree_completed",
         "fusion",
         "discount",
-        "deduction",
-        "manual",
-        "decay"
+        "deduction"
       ]
     },
+    triggeringEvidenceId: {
+      type: "string",
+      description: "Evidence node that caused an evidence-triggered modulation"
+    },
+    triggeringQuestionId: {
+      type: "string",
+      description: "Answered question whose resolution supports this modulation"
+    },
+    triggeringAnswerId: {
+      type: "string",
+      description: "Answer node whose content supports this modulation"
+    },
+    triggeringContradictionId: {
+      type: "string",
+      description: "Contradiction record that caused a contradiction-triggered modulation"
+    },
+    triggeringWorktreeId: {
+      type: "string",
+      description: "Completed worktree whose outcome caused a worktree-triggered modulation"
+    },
     rationale: {
       type: "string",
       description: "Human-readable explanation of why confidence changed"
     }
   },
-  required: ["nodeId", "trigger", "rationale"],
+  required: [
+    "nodeId",
+    "belief",
+    "disbelief",
+    "uncertainty",
+    "baseRate",
+    "trigger",
+    "rationale"
+  ],
   response: {
     description: "Confidence modulation result",
     fields: {
@@ -302,7 +331,7 @@ var ADD_EVIDENCE = {
   description: "Commit evidence to the reasoning graph and attach it to a belief. Like `git add && git commit` \u2014 an atomic write that creates a traceable evidence object. Weight ranges from -1.0 (contradicts) to +1.0 (strongly supports). Evidence is always context-bound: tied to its source, the time it was captured, and the belief it informs.",
   parameters: {
     canonicalText: { type: "string", description: "The evidence statement" },
-    topicId: { type: "string", description: "Topic scope" },
+    topicId: { type: "string", description: "Optional topic scope hint" },
     sourceUrl: { type: "string", description: "URL of the source material" },
     targetNodeId: {
       type: "string",
@@ -333,7 +362,7 @@ var ADD_EVIDENCE = {
       description: "Optional extra metadata merged into the node (e.g., { codeAnchors: ['path/to/file.ts'], failedApproach: true } for coding intelligence)"
     }
   },
-  required: ["canonicalText", "topicId", "targetNodeId"],
+  required: ["canonicalText", "targetNodeId", "reasoning"],
   response: {
     description: "The created evidence node and its edge",
     fields: {
@@ -363,14 +392,14 @@ var FLAG_CONTRADICTION = {
       description: "How serious the contradiction is",
       enum: ["low", "medium", "high", "critical"]
     },
-    topicId: { type: "string", description: "Topic scope" },
+    topicId: { type: "string", description: "Optional topic scope hint" },
     defeatType: {
       type: "string",
       description: "Pollock defeat classification: rebuts (direct contradiction), undercuts (attacks the inferential link), undermines (attacks a premise)",
       enum: ["rebuts", "undercuts", "undermines"]
     }
   },
-  required: ["beliefA", "beliefB", "description", "topicId"],
+  required: ["beliefA", "beliefB", "description"],
   response: {
     description: "The created contradiction object",
     fields: {
@@ -389,7 +418,7 @@ var ADD_WORKTREE = {
   description: "Check out a branch into an active worktree for investigation. Like `git worktree add <branch>` \u2014 creates independent working state on a thematic branch. Beliefs committed within the worktree can be freely amended (draft code on a feature branch). When investigation is complete, `merge` integrates findings into main.",
   parameters: {
     title: { type: "string", description: "Worktree name/objective" },
-    topicId: { type: "string", description: "Topic scope" },
+    topicId: { type: "string", description: "Optional topic scope hint" },
     branchId: {
       type: "string",
       description: "The branch this worktree investigates"
@@ -414,9 +443,21 @@ var ADD_WORKTREE = {
       type: "string",
       description: "Optional domain pack whose shaping hooks should influence generated questions and tasks"
     },
-    executionOrder: {
+    campaign: {
       type: "number",
-      description: "Global execution order for this worktree"
+      description: "Top-level pipeline campaign number. Campaigns define the outer execution slice."
+    },
+    lane: {
+      type: "string",
+      description: "GitButler-aligned workstream lane name inside the campaign."
+    },
+    laneOrderInCampaign: {
+      type: "number",
+      description: "Ordering for this lane within its campaign."
+    },
+    orderInLane: {
+      type: "number",
+      description: "Position of this worktree inside its lane."
     },
     dependsOn: {
       type: "array",
@@ -648,44 +689,6 @@ var SEARCH_BELIEFS = {
   ontologyPrimitive: "belief",
   tier: "workhorse"
 };
-var SEARCH_RESOURCES = {
-  name: "search_resources",
-  description: "Search beliefs, evidence, and questions in one cross-resource call. Like `git grep` across the reasoning stack \u2014 returns one ranked payload with grouped hits by resource type.",
-  parameters: {
-    q: { type: "string", description: "Search query" },
-    topicId: { type: "string", description: "Topic scope" },
-    types: {
-      type: "array",
-      description: "Optional resource filters: belief, evidence, question"
-    },
-    status: {
-      type: "string",
-      description: "Optional belief/question status filter"
-    },
-    minConfidence: {
-      type: "number",
-      description: "Optional minimum belief confidence threshold"
-    },
-    limit: { type: "number", description: "Maximum results (default: 25)" },
-    cursor: { type: "string", description: "Optional pagination cursor" }
-  },
-  required: ["q", "topicId"],
-  response: {
-    description: "Canonical cross-resource search payload",
-    fields: {
-      q: "string \u2014 echoed query text",
-      topicId: "string \u2014 canonical topic scope",
-      types: "array \u2014 the resource types included in the search",
-      results: "array \u2014 ranked mixed resource hits",
-      beliefs: "array \u2014 grouped belief hits",
-      evidence: "array \u2014 grouped evidence hits",
-      questions: "array \u2014 grouped question hits"
-    }
-  },
-  ownerModule: "graph-search",
-  ontologyPrimitive: "graph",
-  tier: "workhorse"
-};
 var FIND_CONTRADICTIONS = {
   name: "find_contradictions",
   description: "Find contradictions in the reasoning graph \u2014 beliefs that are in tension with each other. Like a merge conflict in `git` \u2014 surfaces incompatible states that require explicit resolution. Contradictions are first-class objects that may remain permanently unresolved. They can block judgments, trigger forks, or collapse confidence. Filter by project, status (unresolved, resolved, accepted), and severity.",
@@ -772,7 +775,7 @@ var RECORD_JUDGMENT = {
       description: "Confidence in the judgment (0-1)"
     }
   },
-  required: ["title", "rationale", "topicId"],
+  required: ["title", "rationale"],
   response: {
     description: "The recorded judgment",
     fields: {
@@ -837,7 +840,7 @@ var CREATE_LENS = {
       status: "string \u2014 'active'"
     }
   },
-  ownerModule: "schema-management",
+  ownerModule: "reasoning-kernel",
   ontologyPrimitive: "lens",
   tier: "showcase"
 };
@@ -871,7 +874,7 @@ var LIST_LENSES = {
       lenses: "array \u2014 each item includes lensId, name, workspaceId, perspectiveType, status, and optional isAppliedToTopic"
     }
   },
-  ownerModule: "schema-management",
+  ownerModule: "reasoning-kernel",
   ontologyPrimitive: "lens",
   tier: "workhorse"
 };
@@ -892,7 +895,7 @@ var APPLY_LENS_TO_TOPIC = {
       status: "string \u2014 'active'"
     }
   },
-  ownerModule: "schema-management",
+  ownerModule: "reasoning-kernel",
   ontologyPrimitive: "lens",
   tier: "workhorse"
 };
@@ -913,7 +916,7 @@ var REMOVE_LENS_FROM_TOPIC = {
       status: "string \u2014 'removed'"
     }
   },
-  ownerModule: "schema-management",
+  ownerModule: "reasoning-kernel",
   ontologyPrimitive: "lens",
   tier: "workhorse"
 };
@@ -1068,50 +1071,6 @@ var GET_FALSIFICATION_QUESTIONS = {
   ontologyPrimitive: "question",
   tier: "showcase"
 };
-var SEARCH_SOURCES = {
-  name: "search_sources",
-  description: "Search and ingest external sources into the knowledge graph. Like `git fetch` \u2014 pulls information from external sources (web, documents, APIs) and stages it for evidence creation. Does not commit \u2014 you decide what becomes evidence.",
-  parameters: {
-    query: { type: "string", description: "Search query" },
-    sources: {
-      type: "array",
-      description: "Source types to search: web, news, academic"
-    }
-  },
-  required: ["query"],
-  response: {
-    description: "Results with source metadata, relevance scores, and suggested evidence",
-    fields: {
-      results: "array \u2014 { title, url, snippet, relevanceScore, suggestedEvidence }"
-    }
-  },
-  ownerModule: "research-engine",
-  ontologyPrimitive: "source",
-  tier: "showcase"
-};
-var EXECUTE_DEEP_RESEARCH = {
-  name: "execute_deep_research",
-  description: "Execute multi-source deep research on a topic. Like `git submodule update --recursive` \u2014 launches a comprehensive research agent that searches multiple sources, synthesizes findings, and produces a structured report. Auto-links results to relevant questions and beliefs.",
-  parameters: {
-    query: { type: "string", description: "Research question or topic" },
-    topicId: { type: "string", description: "Topic scope" },
-    depth: {
-      type: "string",
-      description: "Research depth: quick, standard, deep",
-      enum: ["quick", "standard", "deep"]
-    }
-  },
-  required: ["query", "topicId"],
-  response: {
-    description: "Report with findings, sources, auto-linked evidence and questions",
-    fields: {
-      report: "object \u2014 { summary, findings, sources, linkedEvidence, linkedQuestions }"
-    }
-  },
-  ownerModule: "research-engine",
-  ontologyPrimitive: "source",
-  tier: "showcase"
-};
 var SEARCH_EVIDENCE = {
   name: "search_evidence",
   description: "Search for evidence across the reasoning graph. Like `git grep` \u2014 returns the evidence records that best match a textual query. Results share the same canonical semantics as the HTTP and SDK evidence search surface.",
@@ -1156,6 +1115,10 @@ var CREATE_EVIDENCE = {
       type: "object",
       description: "Optional metadata merged into the canonical evidence node"
     },
+    rationale: {
+      type: "string",
+      description: "Why this evidence should enter the reasoning graph"
+    },
     title: { type: "string", description: "Optional short title" },
     content: { type: "string", description: "Optional long-form content" },
     contentType: {
@@ -1164,7 +1127,7 @@ var CREATE_EVIDENCE = {
     },
     kind: { type: "string", description: "Optional evidence kind" }
   },
-  required: ["topicId", "text"],
+  required: ["text", "rationale"],
   response: {
     description: "The created canonical evidence record",
     fields: {
@@ -1212,7 +1175,7 @@ var LIST_EVIDENCE = {
     limit: { type: "number", description: "Max results" },
     cursor: { type: "string", description: "Pagination cursor" }
   },
-  required: [],
+  required: ["topicId"],
   response: {
     description: "Canonical evidence page",
     fields: {
@@ -1285,7 +1248,7 @@ var CREATE_QUESTION = {
   description: "Commit an investigation question to the reasoning graph. Like `git issue` \u2014 creates a traceable question that drives research and evidence collection. Questions test beliefs and guide worktree investigation.",
   parameters: {
     text: { type: "string", description: "The question text" },
-    topicId: { type: "string", description: "Topic scope" },
+    topicId: { type: "string", description: "Optional topic scope hint" },
     priority: {
       type: "string",
       description: "Priority: urgent, high, medium, low",
@@ -1300,7 +1263,7 @@ var CREATE_QUESTION = {
       description: "Optional metadata merged into the question record"
     }
   },
-  required: ["text", "topicId"],
+  required: ["text"],
   response: {
     description: "The created canonical question record",
     fields: {
@@ -1397,6 +1360,7 @@ var ANSWER_QUESTION = {
   description: "Answer a question with optional evidence links. Like `git commit` on the question thread \u2014 records the answer and closes the loop with a canonical answered state.",
   parameters: {
     id: { type: "string", description: "Canonical question ID" },
+    topicId: { type: "string", description: "Topic scope for the answer" },
     text: { type: "string", description: "Answer text" },
     confidence: {
       type: "string",
@@ -1409,7 +1373,7 @@ var ANSWER_QUESTION = {
     },
     rationale: { type: "string", description: "Why this answer is credible" }
   },
-  required: ["id", "text"],
+  required: ["id", "topicId", "text"],
   response: {
     description: "Answer result",
     fields: {
@@ -1628,6 +1592,10 @@ var LIST_BELIEFS = {
     minConfidence: {
       type: "number",
       description: "Minimum confidence threshold"
+    },
+    limit: {
+      type: "number",
+      description: "Maximum results"
     }
   },
   required: ["topicId"],
@@ -1644,20 +1612,37 @@ var LIST_BELIEFS = {
 };
 var LIST_WORKTREES = {
   name: "list_worktrees",
-  description: "List all worktrees for a topic. Like `git worktree list` \u2014 shows active and completed investigation branches with their phase, status, and belief counts.",
+  description: "List all worktrees for a topic. Like `git worktree list` \u2014 shows active and completed investigation branches with lifecycle phase, pipeline campaign/lane, status, and belief counts.",
   parameters: {
     topicId: { type: "string", description: "Topic scope" },
     status: {
       type: "string",
       description: "Filter: active, merged, abandoned",
       enum: ["active", "merged", "abandoned"]
+    },
+    groupBy: {
+      type: "string",
+      description: "Optional grouping mode for the response.",
+      enum: ["campaign", "lane", "flat"]
+    },
+    lane: {
+      type: "string",
+      description: "Filter by GitButler-aligned lane name."
+    },
+    campaign: {
+      type: "number",
+      description: "Filter by top-level pipeline campaign number."
+    },
+    limit: {
+      type: "number",
+      description: "Maximum results to return."
     }
   },
   required: ["topicId"],
   response: {
-    description: "Worktrees with phase, status, belief count, and creation time",
+    description: "Worktrees with lifecycle phase, campaign, lane, status, belief count, and creation time",
     fields: {
-      worktrees: "array \u2014 { worktreeId, title, phase, status, beliefCount, createdAt }"
+      worktrees: "array \u2014 { worktreeId, title, phase, campaign, lane, laneOrderInCampaign, orderInLane, status, beliefCount, createdAt }"
     }
   },
   ownerModule: "workflow-engine",
@@ -1666,7 +1651,7 @@ var LIST_WORKTREES = {
 };
 var LIST_ALL_WORKTREES = {
   name: "list_all_worktrees",
-  description: "List ALL worktrees across ALL topics in one query. No topic scope required. Like `git worktree list --all` \u2014 returns the complete pipeline inventory with track, trackPosition, executionBand, dependencies, and status. Supports filtering by status, track, and executionBand. This is the PM's primary pipeline query \u2014 one call, full picture.",
+  description: "List ALL worktrees across ALL topics in one query. No topic scope required. Like `git worktree list --all` \u2014 returns the complete pipeline inventory with campaign, lane, lane order, dependencies, and status. Supports filtering by status, lane, and campaign. This is the PM's primary pipeline query \u2014 one call, full picture.",
   parameters: {
     status: {
       type: "string",
@@ -1684,13 +1669,18 @@ var LIST_ALL_WORKTREES = {
         "dismissed"
       ]
     },
-    track: {
+    lane: {
       type: "string",
-      description: "Filter by track name (e.g., 'ontology', 'tc-scope', 'control-plane', 'dev-portal', 'mcp-sdk-parity')"
+      description: "Filter by lane name (e.g., 'ontology', 'tc-scope', 'control-plane', 'dev-portal', 'mcp-sdk-parity')"
     },
-    executionBand: {
+    campaign: {
       type: "number",
-      description: "Filter by execution band number (e.g., 1, 2, 3). Returns only worktrees in that parallel execution group."
+      description: "Filter by campaign number (e.g., 1, 2, 3). Returns only worktrees in that campaign."
+    },
+    groupBy: {
+      type: "string",
+      description: "Optional grouping mode for the response.",
+      enum: ["campaign", "lane", "flat"]
     },
     limit: {
       type: "number",
@@ -1701,10 +1691,39 @@ var LIST_ALL_WORKTREES = {
   response: {
     description: "All worktrees across all topics with full pipeline metadata",
     fields: {
-      worktrees: "array \u2014 { worktreeId, title, topicId, topicName, phase, status, hypothesis, track, trackPosition, executionBand, executionOrder, dependsOn, blocks, gate, createdAt }",
+      worktrees: "array \u2014 { worktreeId, title, topicId, topicName, phase, status, hypothesis, campaign, lane, laneOrderInCampaign, orderInLane, dependsOn, blocks, gate, createdAt }",
       total: "number \u2014 total count after filtering",
-      tracks: "object \u2014 { trackName: count } summary of worktrees per track",
-      bands: "object \u2014 { bandNumber: count } summary of worktrees per execution band"
+      lanes: "object \u2014 { laneName: count } summary of worktrees per lane",
+      campaigns: "object \u2014 { campaignNumber: count } summary of worktrees per campaign"
+    }
+  },
+  ownerModule: "workflow-engine",
+  ontologyPrimitive: "worktree",
+  tier: "showcase"
+};
+var LIST_CAMPAIGNS = {
+  name: "list_campaigns",
+  description: "List compact pipeline campaigns with their nested lanes. Use this to see the top-level campaign > lane > worktree shape without pulling the full worktree inventory.",
+  parameters: {
+    topicId: {
+      type: "string",
+      description: "Optional topic scope."
+    },
+    status: {
+      type: "string",
+      description: "Optional worktree status filter before grouping campaigns and lanes."
+    },
+    limit: {
+      type: "number",
+      description: "Maximum worktrees to scan before grouping."
+    }
+  },
+  required: [],
+  response: {
+    description: "Pipeline campaigns with nested lane summaries.",
+    fields: {
+      campaigns: "array \u2014 { campaign, lanes: [{ lane, laneOrderInCampaign, worktreeCount, activeCount, readyCount, blockedCount, completedCount, nextWorktree }] }",
+      totalWorktrees: "number \u2014 total worktrees scanned after filtering"
     }
   },
   ownerModule: "workflow-engine",
@@ -1767,16 +1786,28 @@ var UPDATE_WORKTREE_TARGETS = {
 };
 var UPDATE_WORKTREE_METADATA = {
   name: "update_worktree_metadata",
-  description: "Update worktree sequencing metadata \u2014 execution order, dependencies, blocking relations, and gates. Like `git config` for a worktree \u2014 sets the scheduling and dependency metadata that determines when this worktree can activate relative to others. Use to backfill or correct sequencing data.",
+  description: "Update worktree sequencing metadata \u2014 campaign, lane, dependencies, blocking relations, and gates. Like `git config` for a worktree \u2014 sets the scheduling and dependency metadata that determines when this worktree can activate relative to others. Use to backfill or correct sequencing data.",
   parameters: {
     worktreeId: { type: "string", description: "The worktree to update" },
     hypothesis: {
       type: "string",
       description: "Testable claim this worktree investigates"
     },
-    executionOrder: {
+    campaign: {
+      type: "number",
+      description: "Top-level pipeline campaign number."
+    },
+    lane: {
+      type: "string",
+      description: "GitButler-aligned workstream lane name inside the campaign."
+    },
+    laneOrderInCampaign: {
       type: "number",
-      description: "Global execution order (1 = first, higher = later)"
+      description: "Ordering for this lane within the campaign."
+    },
+    orderInLane: {
+      type: "number",
+      description: "Position of this worktree inside its lane."
     },
     dependsOn: {
       type: "array",
@@ -1814,18 +1845,6 @@ var UPDATE_WORKTREE_METADATA = {
       type: "object",
       description: "Calibrated auto-fix policy controlling dry-run vs safe execution, per-run action caps, and permitted mutation tiers."
     },
-    track: {
-      type: "string",
-      description: "Parallel workstream name (e.g., 'ontology', 'tc-scope', 'control-plane', 'dev-portal', 'mcp-sdk-parity', 'execution-program'). Groups worktrees into named lanes for pipeline visualization and PM analysis."
-    },
-    trackPosition: {
-      type: "number",
-      description: "Position within the track (1-indexed). E.g., TC-A=1, TC-B=2, TC-C=3 within the 'tc-scope' track."
-    },
-    executionBand: {
-      type: "number",
-      description: "Parallel execution band number. All worktrees in the same band can run simultaneously. Band 2 = OE-B + TC-A, Band 3 = TC-B + 11D-R + S2-13A, etc."
-    },
     status: {
       type: "string",
       description: "Override the worktree status. Use for lifecycle transitions like marking a worktree superseded, long-term, or as a raw idea.",
@@ -2010,7 +2029,7 @@ var INGEST_OBSERVATION = {
   parameters: {
     topicId: {
       type: "string",
-      description: "Topic scope for the observation"
+      description: "Optional topic scope hint for the observation"
     },
     observationType: {
       type: "string",
@@ -2039,7 +2058,7 @@ var INGEST_OBSERVATION = {
       description: "Optional structured metadata payload"
     }
   },
-  required: ["topicId", "observationType", "summary"],
+  required: ["observationType", "summary"],
   response: {
     description: "Recorded observation entry",
     fields: {
@@ -2058,7 +2077,7 @@ var GET_OBSERVATION_CONTEXT = {
   name: "get_observation_context",
   description: "Retrieve observer-ready context for a topic, including recent deltas and semantic matches. Like `git log --grep` \u2014 shows recent context and filtered matches across observation history. This powers prompt context injection without mutating graph state.",
   parameters: {
-    topicId: { type: "string", description: "Topic scope" },
+    topicId: { type: "string", description: "Optional topic scope hint" },
     query: {
       type: "string",
       description: "Optional semantic query over observation history"
@@ -2101,7 +2120,7 @@ var CREATE_TASK = {
     },
     linkedWorktreeId: { type: "string", description: "Worktree scope" }
   },
-  required: ["title", "topicId"],
+  required: ["title"],
   response: {
     description: "The created task",
     fields: {
@@ -2195,6 +2214,10 @@ var LIST_TASKS = {
       type: "string",
       description: "Filter to tasks linked to this worktree"
     },
+    worktreeId: {
+      type: "string",
+      description: "Alias for linkedWorktreeId"
+    },
     status: {
       type: "string",
       description: "Filter by status: todo, in_progress, blocked, done",
@@ -2236,7 +2259,7 @@ var CREATE_TOPIC = {
       depth: "number \u2014 nesting depth"
     }
   },
-  ownerModule: "schema-management",
+  ownerModule: "reasoning-kernel",
   ontologyPrimitive: "graph",
   tier: "showcase"
 };
@@ -2265,7 +2288,7 @@ var LIST_TOPICS = {
       topics: "array \u2014 { id, name, type, depth, status, parentTopicId }"
     }
   },
-  ownerModule: "schema-management",
+  ownerModule: "reasoning-kernel",
   ontologyPrimitive: "graph",
   tier: "workhorse"
 };
@@ -2282,14 +2305,14 @@ var GET_TOPIC = {
       description: "Legacy alias for topicId"
     }
   },
-  required: [],
+  required: ["topicId"],
   response: {
     description: "Single topic record",
     fields: {
       topic: "object \u2014 { id, globalId, name, type, depth, status, parentTopicId, description }"
     }
   },
-  ownerModule: "schema-management",
+  ownerModule: "reasoning-kernel",
   ontologyPrimitive: "graph",
   tier: "workhorse"
 };
@@ -2340,7 +2363,7 @@ var UPDATE_TOPIC = {
       visibility: "string \u2014 topic visibility"
     }
   },
-  ownerModule: "schema-management",
+  ownerModule: "reasoning-kernel",
   ontologyPrimitive: "graph",
   tier: "workhorse"
 };
@@ -2359,7 +2382,7 @@ var GET_TOPIC_TREE = {
     description: "Tree of topics with nesting",
     fields: { tree: "array \u2014 topics in BFS order with depth and path" }
   },
-  ownerModule: "schema-management",
+  ownerModule: "reasoning-kernel",
   ontologyPrimitive: "graph",
   tier: "workhorse"
 };
@@ -2637,7 +2660,7 @@ var GET_ONTOLOGY = {
       description: "Tenant scope for key lookup. Omit for platform-level."
     }
   },
-  required: [],
+  required: ["id"],
   response: {
     description: "Ontology definition with latest published version",
     fields: {
@@ -2675,7 +2698,7 @@ var APPLY_ONTOLOGY = {
       topicId: "string \u2014 canonical topic ID"
     }
   },
-  ownerModule: "schema-management",
+  ownerModule: "reasoning-kernel",
   ontologyPrimitive: "ontology",
   tier: "showcase"
 };
@@ -2704,7 +2727,7 @@ var MATCH_ENTITY_TYPE = {
       description: "Optional maximum number of ranked matches to return"
     }
   },
-  required: ["text"],
+  required: ["text", "ontologyId"],
   response: {
     description: "Ranked ontology entity type matches",
     fields: {
@@ -2713,7 +2736,7 @@ var MATCH_ENTITY_TYPE = {
       topicId: "string|null \u2014 topic scope used for ontology resolution"
     }
   },
-  ownerModule: "schema-management",
+  ownerModule: "reasoning-kernel",
   ontologyPrimitive: "ontology",
   tier: "showcase"
 };
@@ -2882,6 +2905,619 @@ var RESOLVE_EFFECTIVE_ONTOLOGY = {
   ontologyPrimitive: "ontology",
   tier: "workhorse"
 };
+var RECORD_SCOPE_LEARNING = {
+  name: "record_scope_learning",
+  description: "Write a structured learning entry into the epistemic spine. Like `git commit` for scope learnings \u2014 records evidence, can attach to a belief, and can open a follow-up belief/question in one atomic workflow.",
+  parameters: {
+    topicId: { type: "string", description: "Topic scope ID" },
+    summary: { type: "string", description: "Atomic learning statement" },
+    title: {
+      type: "string",
+      description: "Optional evidence title, such as a commit, doc, or issue."
+    },
+    body: {
+      type: "string",
+      description: "Optional rich evidence body. If omitted, body is synthesized from summary and touched paths."
+    },
+    contentType: {
+      type: "string",
+      description: "Optional evidence body format, such as markdown or text."
+    },
+    sourceKind: {
+      type: "string",
+      description: "Source type for the learning event",
+      enum: ["commit", "merge", "doc", "issue", "manual"]
+    },
+    sourceRef: {
+      type: "string",
+      description: "Optional source reference, such as SHA, PR number, or URL slug."
+    },
+    sourceUrl: { type: "string", description: "Optional canonical source URL" },
+    touchedPaths: {
+      type: "array",
+      description: "Optional touched file paths for retrieval hints"
+    },
+    tags: { type: "array", description: "Optional tags" },
+    linkedBeliefNodeId: {
+      type: "string",
+      description: "Optional belief to attach evidence to"
+    },
+    evidenceRelation: {
+      type: "string",
+      description: "Relation to linked belief",
+      enum: ["supports", "contradicts"]
+    },
+    confidence: { type: "number", description: "Optional confidence in [0,1]" },
+    createQuestionText: {
+      type: "string",
+      description: "Optional follow-up question text"
+    },
+    createBeliefText: {
+      type: "string",
+      description: "Optional new belief text"
+    },
+    beliefType: {
+      type: "string",
+      description: "Optional belief type for createBeliefText"
+    }
+  },
+  required: ["summary"],
+  response: {
+    description: "Created learning artifacts",
+    fields: {
+      topicId: "string \u2014 resolved topic ID",
+      evidenceNodeId: "string",
+      linkedBeliefNodeId: "string | null",
+      createdQuestionId: "string | null",
+      createdBeliefId: "string | null",
+      sourceUrl: "string",
+      createdAt: "number"
+    }
+  },
+  ownerModule: "reasoning-kernel",
+  ontologyPrimitive: "evidence",
+  tier: "workhorse",
+  internal: true
+};
+var PIPELINE_SNAPSHOT = {
+  name: "pipeline_snapshot",
+  description: "Summarize a topic's worktree pipeline in campaign-and-lane form. Like `git status --short` for Lucern execution \u2014 returns the hinge worktree, next planned wave, blockers, critical path, superseded work, and graph hygiene debt.",
+  parameters: {
+    topicId: { type: "string", description: "Topic scope ID" }
+  },
+  required: ["topicId"],
+  response: {
+    description: "Human-oriented pipeline summary for a single topic scope",
+    fields: {
+      topicId: "string",
+      topicName: "string",
+      currentCampaign: "number | null",
+      nextCampaign: "number | null",
+      activeWorktrees: "array \u2014 current hinge worktree(s)",
+      nextWave: "array \u2014 worktrees in the next planned campaign",
+      readyNow: "array \u2014 planning worktrees with dependencies completed",
+      blockedBy: "array \u2014 grouped blockers",
+      criticalPath: "array \u2014 ordered incomplete worktree chain",
+      campaigns: "array \u2014 incomplete worktrees grouped by campaign",
+      superseded: "array \u2014 worktrees marked superseded or not for activation",
+      graphHygiene: "object \u2014 untargeted and taskless worktree debt",
+      riskQuestions: "array \u2014 critical/high open questions",
+      narrative: "array \u2014 concise natural-language summary lines"
+    }
+  },
+  ownerModule: "reasoning-kernel",
+  ontologyPrimitive: "graph",
+  tier: "workhorse",
+  internal: true
+};
+var DISCOVER = {
+  name: "discover",
+  description: "Navigate the topic tree to find where knowledge lives. Like `git log --all --grep` \u2014 searches across the graph using bottom-up content matching plus top-down structural scoring.",
+  parameters: {
+    query: {
+      type: "string",
+      description: "What to look for across the topic tree"
+    },
+    topK: {
+      type: "number",
+      description: "How many matching topics to return (default: 3, max: 10)"
+    },
+    includeNeighborhood: {
+      type: "boolean",
+      description: "Whether to include beliefs/questions/evidence for matched topics"
+    }
+  },
+  required: ["query"],
+  response: {
+    description: "Ranked topic matches with optional neighborhood content",
+    fields: {
+      query: "string \u2014 original query",
+      matchedTopics: "array \u2014 ranked topics with scores and paths",
+      neighborhoods: "array \u2014 beliefs, questions, evidence for each match",
+      totalTopicsScored: "number",
+      topicTreeSize: "number"
+    }
+  },
+  ownerModule: "reasoning-kernel",
+  ontologyPrimitive: "graph",
+  tier: "showcase",
+  deprecated: "Deprecated: use lucern.context.compile() with topicId"
+};
+var ANALYZE_TOPIC_DENSITY = {
+  name: "analyze_topic_density",
+  description: "Analyze topic belief density and identify natural conceptual clusters. Like `git diff --stat` for topic organization \u2014 detects when a topic has accumulated too many beliefs and suggests subtopic decomposition.",
+  parameters: {
+    topicId: { type: "string", description: "Topic ID to analyze" },
+    threshold: {
+      type: "number",
+      description: "Belief count threshold for density warning"
+    },
+    minModularity: {
+      type: "number",
+      description: "Minimum modularity score for suggesting decomposition"
+    }
+  },
+  required: ["topicId"],
+  response: {
+    description: "Density analysis with cluster suggestions",
+    fields: {
+      topicId: "string",
+      topicName: "string",
+      beliefCount: "number",
+      edgeCount: "number",
+      threshold: "number",
+      isDense: "boolean",
+      modularity: "number",
+      clusterCount: "number",
+      clusters: "array \u2014 suggested belief clusters",
+      recommendation: "string"
+    }
+  },
+  ownerModule: "reasoning-kernel",
+  ontologyPrimitive: "graph",
+  tier: "showcase"
+};
+var APPLY_AUTO_BRANCHING = {
+  name: "apply_auto_branching",
+  description: "Execute topic decomposition by creating subtopics and reassigning beliefs. Like `git subtree split` \u2014 splits a dense topic into focused subtopics while preserving belief identity and edges.",
+  parameters: {
+    topicId: { type: "string", description: "Parent topic ID to decompose" },
+    clusters: {
+      type: "array",
+      description: "Cluster definitions from analyze_topic_density, each with name and beliefIds"
+    },
+    dryRun: {
+      type: "boolean",
+      description: "Preview changes without applying them"
+    }
+  },
+  required: ["topicId", "clusters"],
+  response: {
+    description: "Results of the auto-branching operation",
+    fields: {
+      success: "boolean",
+      parentTopicId: "string",
+      createdSubtopics: "array",
+      totalReassigned: "number",
+      totalSkipped: "number",
+      dryRun: "boolean"
+    }
+  },
+  ownerModule: "reasoning-kernel",
+  ontologyPrimitive: "graph",
+  tier: "showcase"
+};
+var SEED_BELIEF_LATTICE = {
+  name: "seed_belief_lattice",
+  description: "Seed belief lattice coverage for a topic based on its resolved ontology. Like `git init` for ontology coverage \u2014 creates or previews seed beliefs for entity types that need a baseline anchor.",
+  parameters: {
+    topicId: {
+      type: "string",
+      description: "Topic scope ID. Lattice seeding must target a child topic."
+    },
+    dryRun: {
+      type: "boolean",
+      description: "Preview seeds without creating them"
+    }
+  },
+  required: [],
+  response: {
+    description: "Lattice seed results with per-entity-type status",
+    fields: {
+      topicId: "string",
+      ontologyResolved: "boolean",
+      ontologyKey: "string | null",
+      ontologyVersion: "string | null",
+      entityTypeCount: "number",
+      seeds: "array \u2014 per-entity-type seed status",
+      summary: "object \u2014 created/existing/scored/total counts",
+      dryRun: "boolean"
+    }
+  },
+  ownerModule: "reasoning-kernel",
+  ontologyPrimitive: "belief",
+  tier: "workhorse",
+  internal: true
+};
+var GET_LATTICE_COVERAGE = {
+  name: "get_lattice_coverage",
+  description: "Report belief lattice coverage for a topic. Like `git fsck` for ontology coverage \u2014 identifies anchored, hollow, and missing entity-type belief coverage.",
+  parameters: {
+    topicId: {
+      type: "string",
+      description: "Topic scope ID to check lattice coverage for"
+    }
+  },
+  required: [],
+  response: {
+    description: "Per-entity-type coverage with overall score",
+    fields: {
+      topicId: "string",
+      ontologyKey: "string | null",
+      ontologyVersion: "string | null",
+      entityTypes: "array \u2014 per-entity-type coverage rows",
+      summary: "object \u2014 total/anchored/hollow/missing/coverageScore"
+    }
+  },
+  ownerModule: "reasoning-kernel",
+  ontologyPrimitive: "belief",
+  tier: "workhorse",
+  internal: true
+};
+var DISCOVER_ENTITY_CONNECTIONS = {
+  name: "discover_entity_connections",
+  description: "Find existing entities that should be connected to a belief/question/evidence node. Like `git log --diff-filter=M` for missing entity connections \u2014 scans entities in scope and suggests bridge edge types.",
+  parameters: {
+    nodeId: {
+      type: "string",
+      description: "Epistemic node ID to find entity connections for"
+    },
+    topicId: {
+      type: "string",
+      description: "Optional topic scope override"
+    },
+    minScore: {
+      type: "number",
+      description: "Minimum match score threshold"
+    },
+    limit: {
+      type: "number",
+      description: "Maximum candidates to return"
+    }
+  },
+  required: ["nodeId"],
+  response: {
+    description: "Ranked entity connection candidates",
+    fields: {
+      nodeId: "string",
+      candidateCount: "number",
+      candidates: "array \u2014 suggested entity bridge candidates"
+    }
+  },
+  ownerModule: "reasoning-kernel",
+  ontologyPrimitive: "ontology",
+  tier: "workhorse"
+};
+var TRIGGER_BELIEF_REVIEW = {
+  name: "trigger_belief_review",
+  description: "Flag beliefs for review after an entity changes. Like `git bisect` for stale beliefs \u2014 traverses bridge edges from the changed entity and creates review questions for stale connected beliefs.",
+  parameters: {
+    entityNodeId: {
+      type: "string",
+      description: "The entity node that changed"
+    },
+    changeDescription: {
+      type: "string",
+      description: "What changed about the entity"
+    },
+    maxQuestions: {
+      type: "number",
+      description: "Maximum review questions to create"
+    }
+  },
+  required: ["entityNodeId"],
+  response: {
+    description: "Affected beliefs and created review questions",
+    fields: {
+      entityNodeId: "string",
+      entityTitle: "string",
+      entityType: "string",
+      changeDescription: "string",
+      affectedBeliefCount: "number",
+      questionsCreated: "number",
+      reviewedBeliefs: "array",
+      questions: "array"
+    }
+  },
+  ownerModule: "reasoning-kernel",
+  ontologyPrimitive: "ontology",
+  tier: "workhorse"
+};
+var EVALUATE_CONTRACT = {
+  name: "evaluate_contract",
+  description: "Run a contract evaluation and record the append-only result. Like `git test` for a belief binding \u2014 executes the evaluator, logs the result, and applies any allowed confidence modulation.",
+  parameters: {
+    contractId: { type: "string", description: "Which contract to evaluate" },
+    trigger: {
+      type: "string",
+      description: "What caused this evaluation"
+    }
+  },
+  required: ["contractId"],
+  response: {
+    description: "The most recent contract evaluation result",
+    fields: {
+      evaluationId: "string",
+      result: "string",
+      status: "string",
+      confidenceBefore: "number",
+      confidenceAfter: "number",
+      rationale: "string"
+    }
+  },
+  ownerModule: "graph-primitives",
+  ontologyPrimitive: "belief",
+  tier: "workhorse"
+};
+var GET_CONTRACT_STATUS = {
+  name: "get_contract_status",
+  description: "Inspect epistemic contracts and their latest evaluations. Like `git status` for verification bindings \u2014 returns the contract rows plus the freshest recorded evaluation for each one.",
+  parameters: {
+    beliefNodeId: {
+      type: "string",
+      description: "Return all contracts attached to a specific belief"
+    },
+    contractId: {
+      type: "string",
+      description: "Return one specific contract by contractId"
+    },
+    status: {
+      type: "string",
+      description: "Optional status filter applied after lookup",
+      enum: ["active", "satisfied", "violated", "expired", "suspended", "archived"]
+    }
+  },
+  required: [],
+  response: {
+    description: "Matching contract rows with latest evaluation context",
+    fields: {
+      contracts: "array \u2014 matching contracts with latestEvaluation attached",
+      count: "number"
+    }
+  },
+  ownerModule: "graph-primitives",
+  ontologyPrimitive: "belief",
+  tier: "workhorse"
+};
+var REGISTER_SESSION = {
+  name: "register_session",
+  description: "Announce this agent session's presence to other parallel sessions. Like `git init` for coordination \u2014 creates a session record so other agents can discover you.",
+  parameters: {
+    sessionName: { type: "string", description: "Human-readable session label" },
+    agentType: { type: "string", description: "Agent type" },
+    topicId: { type: "string", description: "Current Lucern topic scope ID" },
+    worktreeId: { type: "string", description: "Active Lucern worktree ID" },
+    gitBranch: { type: "string", description: "Current git branch name" }
+  },
+  required: [],
+  response: {
+    description: "Session registration result",
+    fields: {
+      sessionId: "string",
+      status: "string \u2014 active",
+      isNew: "boolean"
+    }
+  },
+  ownerModule: "coordination",
+  ontologyPrimitive: "graph",
+  tier: "workhorse",
+  internal: true
+};
+var HEARTBEAT_SESSION = {
+  name: "heartbeat_session",
+  description: "Update this session's heartbeat and optional status fields. Like `git status` \u2014 signals liveness and updates what you are working on.",
+  parameters: {
+    topicId: { type: "string", description: "Updated topic scope" },
+    worktreeId: { type: "string", description: "Updated worktree ID" },
+    gitBranch: { type: "string", description: "Updated git branch" },
+    status: {
+      type: "string",
+      description: "Session status update",
+      enum: ["active", "idle"]
+    }
+  },
+  required: [],
+  response: {
+    description: "Heartbeat result",
+    fields: {
+      success: "boolean",
+      message: "string"
+    }
+  },
+  ownerModule: "coordination",
+  ontologyPrimitive: "graph",
+  tier: "workhorse",
+  internal: true
+};
+var END_SESSION = {
+  name: "end_session",
+  description: "Gracefully end this agent session. Like `git stash` \u2014 marks the session as ended so other agents know you are gone.",
+  parameters: {},
+  required: [],
+  response: {
+    description: "Session end result",
+    fields: {
+      success: "boolean",
+      message: "string"
+    }
+  },
+  ownerModule: "coordination",
+  ontologyPrimitive: "graph",
+  tier: "workhorse",
+  internal: true
+};
+var LIST_ACTIVE_SESSIONS = {
+  name: "list_active_sessions",
+  description: "See who else is online with active agent sessions, scope, branch, and file claims. Like `git branch --list` for live agents \u2014 shows active and idle sessions before editing.",
+  parameters: {
+    includeIdle: {
+      type: "boolean",
+      description: "Include idle sessions"
+    }
+  },
+  required: [],
+  response: {
+    description: "List of active/idle agent sessions",
+    fields: {
+      sessions: "array \u2014 active session records"
+    }
+  },
+  ownerModule: "coordination",
+  ontologyPrimitive: "graph",
+  tier: "workhorse",
+  internal: true
+};
+var SEND_AGENT_MESSAGE = {
+  name: "send_agent_message",
+  description: "Send a directed message to a specific agent session. Like `git notes` \u2014 leaves a coordination note for a specific peer.",
+  parameters: {
+    toSessionId: { type: "string", description: "Target session ID" },
+    content: { type: "string", description: "Message text" },
+    messageType: {
+      type: "string",
+      description: "Message intent",
+      enum: ["note", "question", "answer", "alert", "handoff"]
+    },
+    relatedBeliefId: {
+      type: "string",
+      description: "Optional related belief node ID"
+    },
+    relatedWorktreeId: {
+      type: "string",
+      description: "Optional related worktree ID"
+    }
+  },
+  required: ["toSessionId", "content"],
+  response: {
+    description: "Message delivery result",
+    fields: { messageId: "string" }
+  },
+  ownerModule: "coordination",
+  ontologyPrimitive: "graph",
+  tier: "workhorse",
+  internal: true
+};
+var BROADCAST_MESSAGE = {
+  name: "broadcast_message",
+  description: "Send a message to all active agent sessions. Like `git tag` \u2014 marks an important event visible to everyone.",
+  parameters: {
+    content: { type: "string", description: "Broadcast message text" },
+    messageType: {
+      type: "string",
+      description: "Message intent",
+      enum: ["note", "alert", "handoff"]
+    },
+    relatedBeliefId: {
+      type: "string",
+      description: "Optional related belief node ID"
+    },
+    relatedWorktreeId: {
+      type: "string",
+      description: "Optional related worktree ID"
+    }
+  },
+  required: ["content"],
+  response: {
+    description: "Broadcast result",
+    fields: { messageId: "string" }
+  },
+  ownerModule: "coordination",
+  ontologyPrimitive: "graph",
+  tier: "workhorse",
+  internal: true
+};
+var GET_AGENT_INBOX = {
+  name: "get_agent_inbox",
+  description: "Check unread messages addressed to this session. Like `git log --incoming` \u2014 shows direct and broadcast messages from other agents.",
+  parameters: {
+    limit: { type: "number", description: "Max messages to return" },
+    markAsRead: {
+      type: "boolean",
+      description: "Mark returned messages as read"
+    }
+  },
+  required: [],
+  response: {
+    description: "Inbox messages",
+    fields: {
+      messages: "array \u2014 unread direct and broadcast messages"
+    }
+  },
+  ownerModule: "coordination",
+  ontologyPrimitive: "graph",
+  tier: "workhorse",
+  internal: true
+};
+var CLAIM_FILES = {
+  name: "claim_files",
+  description: "Declare which files this session is actively editing. Like `git add` for coordination \u2014 tells other sessions what you are touching and returns advisory conflicts.",
+  parameters: {
+    files: {
+      type: "array",
+      description: "File paths this session is actively editing"
+    }
+  },
+  required: ["files"],
+  response: {
+    description: "File claim result with conflict detection",
+    fields: {
+      success: "boolean",
+      conflicts: "array \u2014 conflicting file claims"
+    }
+  },
+  ownerModule: "coordination",
+  ontologyPrimitive: "graph",
+  tier: "workhorse",
+  internal: true
+};
+var GENERATE_SESSION_HANDOFF = {
+  name: "generate_session_handoff",
+  description: "Generate a complete, zero-context handoff message for a new coding session. Like `git format-patch` \u2014 produces a self-contained instruction set that bootstraps a fresh Lucern worktree session.",
+  parameters: {
+    worktreeId: {
+      type: "string",
+      description: "The Lucern worktree ID to generate handoff instructions for"
+    },
+    gitWorktreePath: {
+      type: "string",
+      description: "Optional existing git worktree path"
+    },
+    gitBranchName: {
+      type: "string",
+      description: "Optional branch name for the session"
+    },
+    additionalContext: {
+      type: "string",
+      description: "Optional extra context to include in the handoff"
+    }
+  },
+  required: ["worktreeId"],
+  response: {
+    description: "A complete handoff message ready for a new coding session",
+    fields: {
+      handoffMessage: "string",
+      worktreeId: "string",
+      worktreeName: "string",
+      trackBoundary: "object",
+      needsActivation: "boolean",
+      needsGitSetup: "string \u2014 create | fast-forward | ready"
+    }
+  },
+  ownerModule: "bootstrap",
+  ontologyPrimitive: "worktree",
+  tier: "showcase",
+  internal: true
+};
 var MCP_TOOL_CONTRACTS = {
   // Belief lifecycle (commit, amend, fork, archive)
   create_belief: CREATE_BELIEF,
@@ -2891,6 +3527,8 @@ var MCP_TOOL_CONTRACTS = {
   fork_belief: FORK_BELIEF,
   archive_belief: ARCHIVE_BELIEF,
   create_epistemic_contract: CREATE_EPISTEMIC_CONTRACT,
+  evaluate_contract: EVALUATE_CONTRACT,
+  get_contract_status: GET_CONTRACT_STATUS,
   // Evidence (commit)
   create_evidence: CREATE_EVIDENCE,
   get_evidence: GET_EVIDENCE,
@@ -2918,7 +3556,6 @@ var MCP_TOOL_CONTRACTS = {
   get_graph_neighborhood: GET_GRAPH_NEIGHBORHOOD,
   trace_entity_impact: TRACE_ENTITY_IMPACT,
   search_beliefs: SEARCH_BELIEFS,
-  search_resources: SEARCH_RESOURCES,
   find_contradictions: FIND_CONTRADICTIONS,
   bisect_confidence: BISECT_CONFIDENCE,
   // Edges (commit)
@@ -2929,9 +3566,6 @@ var MCP_TOOL_CONTRACTS = {
   detect_confirmation_bias: DETECT_CONFIRMATION_BIAS,
   get_graph_structure_analysis: GET_GRAPH_STRUCTURE_ANALYSIS,
   get_falsification_questions: GET_FALSIFICATION_QUESTIONS,
-  // Sources & research (showcase)
-  search_sources: SEARCH_SOURCES,
-  execute_deep_research: EXECUTE_DEEP_RESEARCH,
   // Evidence operations (workhorse)
   search_evidence: SEARCH_EVIDENCE,
   link_evidence_to_belief: LINK_EVIDENCE_TO_BELIEF,
@@ -2953,11 +3587,30 @@ var MCP_TOOL_CONTRACTS = {
   list_beliefs: LIST_BELIEFS,
   list_worktrees: LIST_WORKTREES,
   list_all_worktrees: LIST_ALL_WORKTREES,
+  list_campaigns: LIST_CAMPAIGNS,
   activate_worktree: ACTIVATE_WORKTREE,
   update_worktree_targets: UPDATE_WORKTREE_TARGETS,
   update_worktree_metadata: UPDATE_WORKTREE_METADATA,
   identity_whoami: IDENTITY_WHOAMI,
   compile_context: COMPILE_CONTEXT,
+  record_scope_learning: RECORD_SCOPE_LEARNING,
+  pipeline_snapshot: PIPELINE_SNAPSHOT,
+  discover: DISCOVER,
+  analyze_topic_density: ANALYZE_TOPIC_DENSITY,
+  apply_auto_branching: APPLY_AUTO_BRANCHING,
+  seed_belief_lattice: SEED_BELIEF_LATTICE,
+  get_lattice_coverage: GET_LATTICE_COVERAGE,
+  discover_entity_connections: DISCOVER_ENTITY_CONNECTIONS,
+  trigger_belief_review: TRIGGER_BELIEF_REVIEW,
+  register_session: REGISTER_SESSION,
+  heartbeat_session: HEARTBEAT_SESSION,
+  end_session: END_SESSION,
+  list_active_sessions: LIST_ACTIVE_SESSIONS,
+  send_agent_message: SEND_AGENT_MESSAGE,
+  broadcast_message: BROADCAST_MESSAGE,
+  get_agent_inbox: GET_AGENT_INBOX,
+  claim_files: CLAIM_FILES,
+  generate_session_handoff: GENERATE_SESSION_HANDOFF,
   // Policy / ACL (workhorse)
   check_permission: CHECK_PERMISSION,
   filter_by_permission: FILTER_BY_PERMISSION,
@@ -3011,6 +3664,6 @@ function validateGitSemantics(tool) {
   return { valid: true };
 }
 
-export { ACTIVATE_WORKTREE, ADD_EVIDENCE, ADD_WORKTREE, ANSWER_QUESTION, APPLY_LENS_TO_TOPIC, APPLY_ONTOLOGY, ARCHIVE_BELIEF, ARCHIVE_ONTOLOGY, ARCHIVE_QUESTION, BISECT_CONFIDENCE, CHECK_PERMISSION, COMPILE_CONTEXT, COMPLETE_TASK, CREATE_ANSWER, CREATE_BELIEF, CREATE_EDGE, CREATE_EPISTEMIC_CONTRACT, CREATE_EVIDENCE, CREATE_LENS, CREATE_ONTOLOGY, CREATE_ONTOLOGY_VERSION, CREATE_QUESTION, CREATE_TASK, CREATE_TOPIC, DEPRECATE_ONTOLOGY_VERSION, DETECT_CONFIRMATION_BIAS, EXECUTE_DEEP_RESEARCH, FILTER_BY_PERMISSION, FIND_CONTRADICTIONS, FIND_MISSING_QUESTIONS, FLAG_CONTRADICTION, FORK_BELIEF, GET_ANSWER, GET_AUDIT_TRAIL, GET_BELIEF, GET_CHANGE_HISTORY, GET_CODE_CONTEXT, GET_CONFIDENCE_HISTORY, GET_EVIDENCE, GET_FAILURE_LOG, GET_FALSIFICATION_QUESTIONS, GET_GRAPH_GAPS, GET_GRAPH_NEIGHBORHOOD, GET_GRAPH_STRUCTURE_ANALYSIS, GET_HIGH_PRIORITY_QUESTIONS, GET_OBSERVATION_CONTEXT, GET_ONTOLOGY, GET_QUESTION, GET_TOPIC, GET_TOPIC_COVERAGE, GET_TOPIC_TREE, GIT_SEMANTIC_REQUIRED_TOOLS, IDENTITY_WHOAMI, INGEST_OBSERVATION, LINK_EVIDENCE, LINK_EVIDENCE_TO_BELIEF, LINK_EVIDENCE_TO_QUESTION, LIST_ALL_WORKTREES, LIST_BELIEFS, LIST_EVIDENCE, LIST_LENSES, LIST_ONTOLOGIES, LIST_QUESTIONS, LIST_TASKS, LIST_TOPICS, LIST_WORKTREES, MANAGE_WRITE_POLICY, MATCH_ENTITY_TYPE, MCP_TOOL_CONTRACTS, MERGE, MODULATE_CONFIDENCE, OPEN_PULL_REQUEST, PUBLISH_ONTOLOGY_VERSION, PUSH, QUERY_LINEAGE, RECORD_ATTEMPT, RECORD_JUDGMENT, REFINE_BELIEF, REFINE_QUESTION, REMOVE_LENS_FROM_TOPIC, RESOLVE_EFFECTIVE_ONTOLOGY, SEARCH_BELIEFS, SEARCH_EVIDENCE, SEARCH_RESOURCES, SEARCH_SOURCES, TRACE_ENTITY_IMPACT, TRAVERSE_GRAPH, UPDATE_ONTOLOGY, UPDATE_QUESTION_STATUS, UPDATE_TASK, UPDATE_TOPIC, UPDATE_WORKTREE_METADATA, UPDATE_WORKTREE_TARGETS, validateGitSemantics };
-//# sourceMappingURL=mcp-tools.contract.js.map
-//# sourceMappingURL=mcp-tools.contract.js.map
+export { ACTIVATE_WORKTREE, ADD_EVIDENCE, ADD_WORKTREE, ANALYZE_TOPIC_DENSITY, ANSWER_QUESTION, APPLY_AUTO_BRANCHING, APPLY_LENS_TO_TOPIC, APPLY_ONTOLOGY, ARCHIVE_BELIEF, ARCHIVE_ONTOLOGY, ARCHIVE_QUESTION, BISECT_CONFIDENCE, BROADCAST_MESSAGE, CHECK_PERMISSION, CLAIM_FILES, COMPILE_CONTEXT, COMPLETE_TASK, CREATE_ANSWER, CREATE_BELIEF, CREATE_EDGE, CREATE_EPISTEMIC_CONTRACT, CREATE_EVIDENCE, CREATE_LENS, CREATE_ONTOLOGY, CREATE_ONTOLOGY_VERSION, CREATE_QUESTION, CREATE_TASK, CREATE_TOPIC, DEPRECATE_ONTOLOGY_VERSION, DETECT_CONFIRMATION_BIAS, DISCOVER, DISCOVER_ENTITY_CONNECTIONS, END_SESSION, EVALUATE_CONTRACT, FILTER_BY_PERMISSION, FIND_CONTRADICTIONS, FIND_MISSING_QUESTIONS, FLAG_CONTRADICTION, FORK_BELIEF, GENERATE_SESSION_HANDOFF, GET_AGENT_INBOX, GET_ANSWER, GET_AUDIT_TRAIL, GET_BELIEF, GET_CHANGE_HISTORY, GET_CODE_CONTEXT, GET_CONFIDENCE_HISTORY, GET_CONTRACT_STATUS, GET_EVIDENCE, GET_FAILURE_LOG, GET_FALSIFICATION_QUESTIONS, GET_GRAPH_GAPS, GET_GRAPH_NEIGHBORHOOD, GET_GRAPH_STRUCTURE_ANALYSIS, GET_HIGH_PRIORITY_QUESTIONS, GET_LATTICE_COVERAGE, GET_OBSERVATION_CONTEXT, GET_ONTOLOGY, GET_QUESTION, GET_TOPIC, GET_TOPIC_COVERAGE, GET_TOPIC_TREE, GIT_SEMANTIC_REQUIRED_TOOLS, HEARTBEAT_SESSION, IDENTITY_WHOAMI, INGEST_OBSERVATION, LINK_EVIDENCE, LINK_EVIDENCE_TO_BELIEF, LINK_EVIDENCE_TO_QUESTION, LIST_ACTIVE_SESSIONS, LIST_ALL_WORKTREES, LIST_BELIEFS, LIST_CAMPAIGNS, LIST_EVIDENCE, LIST_LENSES, LIST_ONTOLOGIES, LIST_QUESTIONS, LIST_TASKS, LIST_TOPICS, LIST_WORKTREES, MANAGE_WRITE_POLICY, MATCH_ENTITY_TYPE, MCP_TOOL_CONTRACTS, MERGE, MODULATE_CONFIDENCE, OPEN_PULL_REQUEST, PIPELINE_SNAPSHOT, PUBLISH_ONTOLOGY_VERSION, PUSH, QUERY_LINEAGE, RECORD_ATTEMPT, RECORD_JUDGMENT, RECORD_SCOPE_LEARNING, REFINE_BELIEF, REFINE_QUESTION, REGISTER_SESSION, REMOVE_LENS_FROM_TOPIC, RESOLVE_EFFECTIVE_ONTOLOGY, SEARCH_BELIEFS, SEARCH_EVIDENCE, SEED_BELIEF_LATTICE, SEND_AGENT_MESSAGE, TRACE_ENTITY_IMPACT, TRAVERSE_GRAPH, TRIGGER_BELIEF_REVIEW, UPDATE_ONTOLOGY, UPDATE_QUESTION_STATUS, UPDATE_TASK, UPDATE_TOPIC, UPDATE_WORKTREE_METADATA, UPDATE_WORKTREE_TARGETS, validateGitSemantics };
+//# sourceMappingURL=tool-contracts.js.map
+//# sourceMappingURL=tool-contracts.js.map