@lucern/contracts 0.1.2-alpha.4 → 0.3.0-alpha.0

package/dist/sdk-tools.contract.js

@@ -7,7 +7,7 @@ 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.",
@@ -16,7 +16,10 @@ var CREATE_BELIEF = {
       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."
@@ -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", "baseRate"],
   response: {
     description: "The created canonical belief record",
     fields: {
@@ -302,7 +305,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 +336,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"],
   response: {
     description: "The created evidence node and its edge",
     fields: {
@@ -363,14 +366,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 +392,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"
@@ -648,44 +651,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 +737,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 +802,7 @@ var CREATE_LENS = {
       status: "string \u2014 'active'"
     }
   },
-  ownerModule: "schema-management",
+  ownerModule: "reasoning-kernel",
   ontologyPrimitive: "lens",
   tier: "showcase"
 };
@@ -871,7 +836,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 +857,7 @@ var APPLY_LENS_TO_TOPIC = {
       status: "string \u2014 'active'"
     }
   },
-  ownerModule: "schema-management",
+  ownerModule: "reasoning-kernel",
   ontologyPrimitive: "lens",
   tier: "workhorse"
 };
@@ -913,7 +878,7 @@ var REMOVE_LENS_FROM_TOPIC = {
       status: "string \u2014 'removed'"
     }
   },
-  ownerModule: "schema-management",
+  ownerModule: "reasoning-kernel",
   ontologyPrimitive: "lens",
   tier: "workhorse"
 };
@@ -1068,50 +1033,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.",
@@ -1164,7 +1085,7 @@ var CREATE_EVIDENCE = {
     },
     kind: { type: "string", description: "Optional evidence kind" }
   },
-  required: ["topicId", "text"],
+  required: ["text"],
   response: {
     description: "The created canonical evidence record",
     fields: {
@@ -1285,7 +1206,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 +1221,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: {
@@ -2010,7 +1931,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 +1960,7 @@ var INGEST_OBSERVATION = {
       description: "Optional structured metadata payload"
     }
   },
-  required: ["topicId", "observationType", "summary"],
+  required: ["observationType", "summary"],
   response: {
     description: "Recorded observation entry",
     fields: {
@@ -2058,7 +1979,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 +2022,7 @@ var CREATE_TASK = {
     },
     linkedWorktreeId: { type: "string", description: "Worktree scope" }
   },
-  required: ["title", "topicId"],
+  required: ["title"],
   response: {
     description: "The created task",
     fields: {
@@ -2236,7 +2157,7 @@ var CREATE_TOPIC = {
       depth: "number \u2014 nesting depth"
     }
   },
-  ownerModule: "schema-management",
+  ownerModule: "reasoning-kernel",
   ontologyPrimitive: "graph",
   tier: "showcase"
 };
@@ -2265,7 +2186,7 @@ var LIST_TOPICS = {
       topics: "array \u2014 { id, name, type, depth, status, parentTopicId }"
     }
   },
-  ownerModule: "schema-management",
+  ownerModule: "reasoning-kernel",
   ontologyPrimitive: "graph",
   tier: "workhorse"
 };
@@ -2289,7 +2210,7 @@ var GET_TOPIC = {
       topic: "object \u2014 { id, globalId, name, type, depth, status, parentTopicId, description }"
     }
   },
-  ownerModule: "schema-management",
+  ownerModule: "reasoning-kernel",
   ontologyPrimitive: "graph",
   tier: "workhorse"
 };
@@ -2340,7 +2261,7 @@ var UPDATE_TOPIC = {
       visibility: "string \u2014 topic visibility"
     }
   },
-  ownerModule: "schema-management",
+  ownerModule: "reasoning-kernel",
   ontologyPrimitive: "graph",
   tier: "workhorse"
 };
@@ -2359,7 +2280,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"
 };
@@ -2675,7 +2596,7 @@ var APPLY_ONTOLOGY = {
       topicId: "string \u2014 canonical topic ID"
     }
   },
-  ownerModule: "schema-management",
+  ownerModule: "reasoning-kernel",
   ontologyPrimitive: "ontology",
   tier: "showcase"
 };
@@ -2713,7 +2634,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 +2803,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 band-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",
+      currentBand: "number | null",
+      nextBand: "number | null",
+      activeWorktrees: "array \u2014 current hinge worktree(s)",
+      nextWave: "array \u2014 worktrees in the next planned band",
+      readyNow: "array \u2014 planning worktrees with dependencies completed",
+      blockedBy: "array \u2014 grouped blockers",
+      criticalPath: "array \u2014 ordered incomplete worktree chain",
+      bands: "array \u2014 incomplete worktrees grouped by executionBand",
+      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 +3425,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 +3454,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 +3464,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,
@@ -2958,6 +3490,24 @@ var MCP_TOOL_CONTRACTS = {
   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,
@@ -3985,65 +4535,6 @@ var GET_BELIEFS_BY_EPISTEMIC_STATUS = {
   ontologyPrimitive: "belief",
   tier: "sdk-only"
 };
-var GET_PRIVILEGED_EVIDENCE = {
-  name: "get_privileged_evidence",
-  description: "Retrieve high-value evidence with access characteristics. Like `git log --author` filtering for key sources \u2014 identifies evidence from privileged access: primary interviews, proprietary data, non-public filings, expert networks.",
-  parameters: {
-    topicId: { type: "string", description: "Topic scope" },
-    projectId: {
-      type: "string",
-      description: "Deprecated legacy alias for topic scope"
-    },
-    accessType: {
-      type: "string",
-      description: "Filter by access type",
-      enum: [
-        "primary_interview",
-        "proprietary_data",
-        "non_public",
-        "expert_network",
-        "field_research"
-      ]
-    }
-  },
-  required: ["topicId"],
-  response: {
-    description: "Privileged evidence items",
-    fields: {
-      evidence: "array \u2014 { nodeId, canonicalText, accessType, sourceDescription, linkedBeliefs }",
-      totalCount: "number"
-    }
-  },
-  ownerModule: "graph-search",
-  ontologyPrimitive: "evidence",
-  tier: "sdk-only"
-};
-var GET_PRIVILEGED_SIGNALS = {
-  name: "get_privileged_signals",
-  description: "Aggregate high-signal patterns across evidence. Like `git shortlog --summary` for signal strength \u2014 identifies recurring patterns across privileged evidence sources that may indicate strong conviction drivers.",
-  parameters: {
-    topicId: { type: "string", description: "Topic scope" },
-    projectId: {
-      type: "string",
-      description: "Deprecated legacy alias for topic scope"
-    },
-    minSignalStrength: {
-      type: "number",
-      description: "Minimum signal score (0-1, default: 0.7)"
-    }
-  },
-  required: ["topicId"],
-  response: {
-    description: "Aggregated signal patterns",
-    fields: {
-      signals: "array \u2014 { pattern, signalStrength, evidenceCount, sources, affectedBeliefs }",
-      totalSignals: "number"
-    }
-  },
-  ownerModule: "graph-search",
-  ontologyPrimitive: "evidence",
-  tier: "sdk-only"
-};
 var DETECT_ANCHORING_BIAS = {
   name: "detect_anchoring_bias",
   description: "Detect old unchallenged beliefs that may anchor reasoning. Like `git log --before` \u2014 finding stale commits that haven't been reviewed. Flags beliefs that were established early and have not received new evidence or challenge.",
@@ -4220,8 +4711,6 @@ var SDK_ONLY_TOOL_CONTRACTS = {
   get_causal_chains: GET_CAUSAL_CHAINS,
   get_non_consensus_beliefs: GET_NON_CONSENSUS_BELIEFS,
   get_beliefs_by_epistemic_status: GET_BELIEFS_BY_EPISTEMIC_STATUS,
-  get_privileged_evidence: GET_PRIVILEGED_EVIDENCE,
-  get_privileged_signals: GET_PRIVILEGED_SIGNALS,
   // 3.7 Bias detection suite (detect_confirmation_bias is in MCP)
   detect_anchoring_bias: DETECT_ANCHORING_BIAS,
   detect_source_concentration: DETECT_SOURCE_CONCENTRATION,
@@ -4247,6 +4736,6 @@ function validateSdkGitSemantics(tool) {
   return { valid: true };
 }
 
-export { ADD_NOTE_TO_WORKTREE, ADD_RESEARCH_ACTION, ADVANCE_WORKTREE_PHASE, ALL_SDK_TOOL_CONTRACTS, ALL_SDK_TOOL_NAMES, ANALYZE_BELIEF_CLUSTER_CANDIDATES, ANALYZE_BELIEF_CRITICALITY, ANALYZE_REASONING_DEPTH, COMPLETE_EVIDENCE_REVIEW, COMPLETE_HYPOTHESIS_FORMATION, CREATE_BELIEF_CONDITIONAL, CREATE_EVIDENCE_TASK, CREATE_SYNTHESIZED_BELIEF, DETECT_ANCHORING_BIAS, DETECT_SOURCE_CONCENTRATION, EXPLORE_CONNECTIONS, FIND_SEMANTIC_BRIDGES, FIND_SEMANTIC_ORPHANS, FIND_SOFT_CONTRADICTIONS, GET_BELIEFS_BY_EPISTEMIC_STATUS, GET_BELIEF_RELATIONSHIPS, GET_BELIEF_SUPPORT_CHAIN, GET_CAUSAL_CHAINS, GET_CHALLENGED_BELIEFS, GET_COLLECTION_CONVICTION, GET_CONVICTION_TREND, GET_DEEP_LINEAGE, GET_EVIDENCE_BY_METHODOLOGY, GET_NECESSARY_EVIDENCE, GET_NON_CONSENSUS_BELIEFS, GET_PREDICTIONS, GET_PRIVILEGED_EVIDENCE, GET_PRIVILEGED_SIGNALS, GET_SURPRISE_DETECTION, GET_TASK_COUNTS, GRAPH_AWARE_SEARCH, LINK_BELIEF_TO_WORKTREE, LINK_DOCUMENT_TO_WORKTREE, LINK_EVIDENCE_TO_WORKTREE, LINK_QUESTION_TO_WORKTREE, LIST_TASKS2 as LIST_TASKS, REFINE_WORKTREE_BELIEF, SDK_ONLY_TOOL_CONTRACTS, SDK_ONLY_TOOL_NAMES, START_WORKTREE, TRACE_PROVENANCE, UPDATE_TASK2 as UPDATE_TASK, UPDATE_WORKTREE_PHASE, validateSdkGitSemantics };
+export { ADD_NOTE_TO_WORKTREE, ADD_RESEARCH_ACTION, ADVANCE_WORKTREE_PHASE, ALL_SDK_TOOL_CONTRACTS, ALL_SDK_TOOL_NAMES, ANALYZE_BELIEF_CLUSTER_CANDIDATES, ANALYZE_BELIEF_CRITICALITY, ANALYZE_REASONING_DEPTH, COMPLETE_EVIDENCE_REVIEW, COMPLETE_HYPOTHESIS_FORMATION, CREATE_BELIEF_CONDITIONAL, CREATE_EVIDENCE_TASK, CREATE_SYNTHESIZED_BELIEF, DETECT_ANCHORING_BIAS, DETECT_SOURCE_CONCENTRATION, EXPLORE_CONNECTIONS, FIND_SEMANTIC_BRIDGES, FIND_SEMANTIC_ORPHANS, FIND_SOFT_CONTRADICTIONS, GET_BELIEFS_BY_EPISTEMIC_STATUS, GET_BELIEF_RELATIONSHIPS, GET_BELIEF_SUPPORT_CHAIN, GET_CAUSAL_CHAINS, GET_CHALLENGED_BELIEFS, GET_COLLECTION_CONVICTION, GET_CONVICTION_TREND, GET_DEEP_LINEAGE, GET_EVIDENCE_BY_METHODOLOGY, GET_NECESSARY_EVIDENCE, GET_NON_CONSENSUS_BELIEFS, GET_PREDICTIONS, GET_SURPRISE_DETECTION, GET_TASK_COUNTS, GRAPH_AWARE_SEARCH, LINK_BELIEF_TO_WORKTREE, LINK_DOCUMENT_TO_WORKTREE, LINK_EVIDENCE_TO_WORKTREE, LINK_QUESTION_TO_WORKTREE, LIST_TASKS2 as LIST_TASKS, REFINE_WORKTREE_BELIEF, SDK_ONLY_TOOL_CONTRACTS, SDK_ONLY_TOOL_NAMES, START_WORKTREE, TRACE_PROVENANCE, UPDATE_TASK2 as UPDATE_TASK, UPDATE_WORKTREE_PHASE, validateSdkGitSemantics };
 //# sourceMappingURL=sdk-tools.contract.js.map
 //# sourceMappingURL=sdk-tools.contract.js.map