@lucern/mcp 0.3.0-alpha.3 → 0.3.0-alpha.4

package/dist/runtime.js

@@ -4040,7 +4040,9 @@ defineTable({
     "defaultProjectVisibility": z.enum(["private", "team", "firm", "external", "public"]).optional(),
     "deployments": z.record(z.object({
       "url": z.string(),
-      "encryptedDeployKey": z.string()
+      "target": z.enum(["kernelDeployment", "appDeployment"]).optional(),
+      "encryptedDeployKey": z.string().optional(),
+      "credentialRef": z.string().optional()
     })).optional(),
     "metadata": z.record(z.any()).optional(),
     "createdBy": z.string().optional(),
@@ -5305,6 +5307,14 @@ 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" },
+    name: {
+      type: "string",
+      description: "Optional storage-name alias for callers that already use backend naming"
+    },
+    projectId: {
+      type: "string",
+      description: "Legacy topicId alias"
+    },
     topicId: { type: "string", description: "Optional topic scope hint" },
     branchId: {
       type: "string",
@@ -5318,14 +5328,87 @@ var ADD_WORKTREE = {
       type: "string",
       description: "The testable claim this worktree investigates"
     },
+    rationale: {
+      type: "string",
+      description: "Why this worktree exists and why it belongs in the campaign"
+    },
+    worktreeType: {
+      type: "string",
+      description: "Schema-enum worktree type used by the kernel lifecycle and retrieval layers"
+    },
+    gate: {
+      type: "string",
+      description: "Exit gate name for this worktree"
+    },
+    startDate: {
+      type: "number",
+      description: "Planned start timestamp in milliseconds since epoch"
+    },
+    endDate: {
+      type: "number",
+      description: "Planned end timestamp in milliseconds since epoch"
+    },
+    durationWeeks: {
+      type: "number",
+      description: "Planned duration in weeks"
+    },
+    confidenceImpact: {
+      type: "string",
+      description: "Expected confidence impact if the worktree succeeds",
+      enum: ["high", "medium", "low"]
+    },
+    beliefFocus: {
+      type: "string",
+      description: "Natural-language focus spanning the target belief neighborhood"
+    },
     beliefIds: {
       type: "array",
-      description: "Beliefs to test in this worktree"
+      description: "Legacy alias for targetBeliefIds"
+    },
+    beliefs: {
+      type: "array",
+      description: "Legacy alias for targetBeliefIds"
+    },
+    targetBeliefIds: {
+      type: "array",
+      description: "Belief node IDs this worktree is expected to test or update"
+    },
+    targetQuestionIds: {
+      type: "array",
+      description: "Question node IDs this worktree is expected to answer"
+    },
+    keyQuestions: {
+      type: "array",
+      description: "Inline key question objects with question, optional status, answer, answerConfidence, and linkedQuestionId"
+    },
+    evidenceSignals: {
+      type: "array",
+      description: "Evidence signal objects with signal, optional collected state, progress, and notes"
+    },
+    decisionGate: {
+      type: "object",
+      description: "Decision gate object with goCriteria, noGoSignals, optional verdict, rationale, decidedAt, and decidedBy"
+    },
+    goCriteria: {
+      type: "array",
+      description: "Shorthand go criteria used to build decisionGate"
+    },
+    noGoSignals: {
+      type: "array",
+      description: "Shorthand no-go signals used to build decisionGate"
+    },
+    proofArtifacts: {
+      type: "array",
+      description: "Expected proof artifacts required to close the worktree"
     },
     autoShape: {
       type: "boolean",
       description: "Whether to invoke inquiry auto-shaping during worktree creation"
     },
+    autoFixPolicy: {
+      type: "object",
+      description: "Policy for permitted automatic remediation inside the worktree"
+    },
     domainPackId: {
       type: "string",
       description: "Optional domain pack whose shaping hooks should influence generated questions and tasks"
@@ -5354,9 +5437,17 @@ var ADD_WORKTREE = {
       type: "array",
       description: "Worktree IDs blocked by this worktree"
     },
-    gate: {
+    staffingHint: {
       type: "string",
-      description: "Exit gate name for this worktree"
+      description: "Suggested staffing or agent allocation note"
+    },
+    lensId: {
+      type: "string",
+      description: "Lens that scopes this worktree when applicable"
+    },
+    lastReconciledAt: {
+      type: "number",
+      description: "Timestamp when worktree metadata was last reconciled"
     }
   },
   required: ["title", "topicId"],
@@ -5386,7 +5477,7 @@ var MERGE = {
     worktreeId: { type: "string", description: "The worktree to merge" },
     outcomes: {
       type: "array",
-      description: "Scoring outcomes for each belief: { beliefId, confidence, rationale }"
+      description: "Merge outcomes as key-finding strings, or scoring outcomes for beliefs: { beliefId, confidence, rationale }"
     },
     summary: { type: "string", description: "Overall findings summary" }
   },
@@ -8405,6 +8496,69 @@ var GENERATE_SESSION_HANDOFF = {
   tier: "showcase",
   internal: true
 };
+var BEGIN_BUILD_SESSION = {
+  name: "begin_build_session",
+  description: "Bootstrap a coding build session for a Lucern worktree. Like `git worktree add` plus `git status` \u2014 returns the compact context packet an agent needs before editing.",
+  parameters: {
+    worktreeId: {
+      type: "string",
+      description: "The Lucern worktree ID to bootstrap."
+    },
+    branch: {
+      type: "string",
+      description: "Optional git branch name. Auto-generated from the worktree name when omitted."
+    },
+    branchBase: {
+      type: "string",
+      description: 'Base branch for the feature branch. Default: "staging".'
+    },
+    prBase: {
+      type: "string",
+      description: 'Target branch for the PR. Default: "staging".'
+    },
+    sessionMode: {
+      type: "string",
+      description: 'Session mode: "async" for Codex/headless or "interactive" for live sessions.',
+      enum: ["async", "interactive"]
+    },
+    activateIfPlanning: {
+      type: "boolean",
+      description: "When true, automatically activate a planning worktree during bootstrap."
+    }
+  },
+  required: ["worktreeId"],
+  response: {
+    description: "A compact build-session packet with worktree metadata, graph anchors, questions, dependencies, and git defaults.",
+    fields: {
+      topicId: "string \u2014 canonical topic scope",
+      topicName: "string \u2014 human-readable topic name",
+      worktreeId: "string \u2014 worktree ID",
+      worktreeName: "string \u2014 human-readable worktree name",
+      branch: "string \u2014 git branch name",
+      branchBase: "string \u2014 base branch",
+      prBase: "string \u2014 PR target branch",
+      campaign: "number | null \u2014 top-level pipeline campaign",
+      lane: "string \u2014 campaign lane",
+      gate: "string \u2014 exit gate",
+      hypothesis: "string \u2014 worktree hypothesis",
+      focus: "string \u2014 session focus",
+      status: "string \u2014 worktree status after optional activation",
+      sessionMode: "string \u2014 async | interactive",
+      targetBeliefIds: "array \u2014 scoped belief IDs",
+      targetQuestionIds: "array \u2014 scoped question IDs",
+      topBeliefs: "array \u2014 highest-confidence scoped beliefs",
+      openQuestions: "array \u2014 open scoped questions",
+      resolvedDecisions: "array \u2014 answered questions summarized for the session",
+      dependencies: "array \u2014 upstream worktrees",
+      unblocks: "array \u2014 downstream worktrees",
+      mergeOrderNotes: "string \u2014 merge ordering advisory"
+    }
+  },
+  ownerModule: "bootstrap",
+  ontologyPrimitive: "worktree",
+  tier: "showcase",
+  internal: true
+};
 var MCP_TOOL_CONTRACTS = {
   // Belief lifecycle (commit, amend, fork, archive)
   create_belief: CREATE_BELIEF,
@@ -8498,6 +8652,7 @@ var MCP_TOOL_CONTRACTS = {
   get_agent_inbox: GET_AGENT_INBOX,
   claim_files: CLAIM_FILES,
   generate_session_handoff: GENERATE_SESSION_HANDOFF,
+  begin_build_session: BEGIN_BUILD_SESSION,
   // Policy / ACL (workhorse)
   check_permission: CHECK_PERMISSION,
   filter_by_permission: FILTER_BY_PERMISSION,
@@ -8711,6 +8866,7 @@ var PLATFORM_INTERNAL_OPERATION_NAMES = [
   "get_change_history",
   "get_failure_log",
   "record_attempt",
+  "begin_build_session",
   "push",
   "open_pull_request",
   "record_judgment",
@@ -8765,7 +8921,6 @@ var SDK_ONLY_OPERATION_NAMES = [
   "find_semantic_orphans"
 ];
 var MCP_ONLY_INTERNAL_OPERATION_NAMES = [
-  "begin_build_session",
   "evaluate_engineering_contract",
   "evaluate_research_contract"
 ];
@@ -9151,8 +9306,31 @@ function assertSurfaceCoverage(contracts) {
     }
   }
 }
-
-// ../contracts/src/function-registry/context.ts
+var jsonRecordSchema2 = z.record(z.unknown());
+var observationArgs = z.object({
+  topicId: z.string().optional().describe("Topic scope for the observation."),
+  summary: z.string().describe("Short observation summary."),
+  text: z.string().optional().describe("Canonical observation text alias."),
+  title: z.string().optional().describe("Optional observation title."),
+  content: z.string().optional().describe("Optional rich observation content."),
+  contentType: z.string().optional().describe("Observation content type."),
+  kind: z.string().optional().describe("Evidence kind to store."),
+  observationType: z.string().optional().describe("Observation type."),
+  tags: z.array(z.string()).optional().describe("Observation tags."),
+  source: z.string().optional().describe("Observation source label."),
+  sourceType: z.string().optional().describe("Evidence source type."),
+  externalSourceType: z.string().optional().describe("External source type for imported observations."),
+  sourceUrl: z.string().optional().describe("Canonical source URL."),
+  confidence: z.number().optional().describe("Observation confidence."),
+  metadata: jsonRecordSchema2.optional().describe("Observation metadata."),
+  rationale: z.string().optional().describe("Why this observation should be recorded.")
+});
+var observationContextArgs = z.object({
+  topicId: z.string().describe("Topic scope."),
+  query: z.string().optional().describe("Optional context query."),
+  limit: z.number().optional().describe("Maximum observations to return."),
+  status: z.string().optional().describe("Observation status filter.")
+});
 var observationInput = (input, context) => withUserId(
   compactRecord4({
     projectId: input.projectId,
@@ -9211,7 +9389,8 @@ var contextContracts = [
         observationId: output && typeof output === "object" ? output.nodeId : void 0,
         observationType: input.observationType
       })
-    }
+    },
+    args: observationArgs
   }),
   surfaceContract({
     name: "get_observation_context",
@@ -9232,7 +9411,8 @@ var contextContracts = [
         status: input.status,
         userId: input.userId
       })
-    }
+    },
+    args: observationContextArgs
   })
 ];
 
@@ -9295,8 +9475,45 @@ var identityContracts = [
     }
   })
 ];
-
-// ../contracts/src/function-registry/beliefs.ts
+var jsonRecordSchema3 = z.record(z.unknown());
+var sourceTypeSchema = z.enum(["human", "ai_extracted", "ai_generated"]);
+var reversibilitySchema = z.enum([
+  "irreversible",
+  "hard_to_reverse",
+  "reversible",
+  "trivial"
+]);
+var predictionMetaSchema = z.object({
+  isPrediction: z.boolean().describe("Whether this belief is a prediction."),
+  registeredAt: z.number().describe("Timestamp when the prediction was registered."),
+  expectedBy: z.number().optional().describe("Timestamp when the prediction should be evaluated.")
+});
+var createBeliefArgs = z.object({
+  canonicalText: z.string().describe("The belief statement the agent holds to be true."),
+  topicId: z.string().optional().describe("Topic scope hint for the belief."),
+  baseRate: z.number().optional().describe("Prior base rate used to seed the vacuous opinion."),
+  beliefType: z.string().optional().describe("Schema belief type."),
+  metadata: jsonRecordSchema3.optional().describe("Extra metadata merged into the belief node."),
+  rationale: z.string().optional().describe("Why this belief should enter the reasoning graph."),
+  pillar: z.string().optional().describe("Innovation pillar or product pillar associated with the belief."),
+  worktreeId: z.string().optional().describe("Worktree responsible for creating or testing this belief."),
+  sourceBeliefIds: z.array(z.string()).optional().describe("Source belief IDs this belief derives from."),
+  sourceType: sourceTypeSchema.optional().describe("Actor/source class that produced the belief."),
+  reversibility: reversibilitySchema.optional().describe("How reversible the belief's implied decision is."),
+  predictionMeta: predictionMetaSchema.optional().describe("Prediction lifecycle metadata when this belief is a forecast.")
+});
+var forkBeliefArgs = z.object({
+  nodeId: z.string().describe("The scored belief to fork from."),
+  newFormulation: z.string().describe("The evolved belief statement."),
+  forkReason: z.enum([
+    "refinement",
+    "contradiction_response",
+    "scope_change",
+    "confidence_collapse",
+    "manual"
+  ]).describe("Why this fork was created."),
+  rationale: z.string().optional().describe("Why the fork is warranted.")
+});
 var beliefLookupInput = (input) => compactRecord4({
   nodeId: input.nodeId ?? input.id ?? input.beliefId,
   beliefId: input.beliefId
@@ -9371,7 +9588,8 @@ var beliefsContracts = [
       functionName: "create",
       kind: "mutation",
       inputProjection: createBeliefInput
-    }
+    },
+    args: createBeliefArgs
   }),
   surfaceContract({
     name: "get_belief",
@@ -9462,7 +9680,8 @@ var beliefsContracts = [
       functionName: "forkBelief",
       kind: "mutation",
       inputProjection: forkBeliefInput
-    }
+    },
+    args: forkBeliefArgs
   }),
   surfaceContract({
     name: "archive_belief",
@@ -9543,8 +9762,46 @@ var beliefsContracts = [
     }
   })
 ];
-
-// ../contracts/src/function-registry/evidence.ts
+var jsonRecordSchema4 = z.record(z.unknown());
+var evidenceRelationSchema = z.enum(["supports", "contradicts", "neutral"]);
+var createEvidenceArgs = z.object({
+  topicId: z.string().optional().describe("Topic scope for the evidence."),
+  text: z.string().describe("Canonical evidence text."),
+  source: z.string().optional().describe("Source URL or source label."),
+  sourceUrl: z.string().optional().describe("Canonical source URL."),
+  targetId: z.string().optional().describe("Belief or question identifier to link immediately."),
+  linkedBeliefNodeId: z.string().optional().describe("Belief node this evidence bears on."),
+  evidenceRelation: evidenceRelationSchema.optional().describe("How the evidence relates to the linked belief."),
+  confidence: z.number().optional().describe("Confidence in the evidence relation."),
+  weight: z.number().optional().describe("Support weight from -1.0 to +1.0."),
+  metadata: jsonRecordSchema4.optional().describe("Metadata merged into the canonical evidence node."),
+  rationale: z.string().describe("Why this evidence should enter the reasoning graph."),
+  reasoning: z.string().optional().describe("Reasoning note preserved in evidence metadata."),
+  title: z.string().optional().describe("Optional short title."),
+  content: z.string().optional().describe("Optional long-form content."),
+  contentType: z.string().optional().describe("Content format or MIME hint."),
+  kind: z.string().optional().describe("Evidence kind."),
+  tags: z.array(z.string()).optional().describe("Evidence tags."),
+  sourceType: z.string().optional().describe("Evidence source type."),
+  externalSourceType: z.string().optional().describe("External source type for imported evidence."),
+  sourceQuestionId: z.string().optional().describe("Question that sourced this evidence."),
+  methodology: z.string().optional().describe("Collection methodology."),
+  informationAsymmetry: z.string().optional().describe("Information asymmetry class."),
+  sourceDescription: z.string().optional().describe("Human-readable source description.")
+});
+var addEvidenceArgs = z.object({
+  canonicalText: z.string().describe("The evidence statement."),
+  text: z.string().optional().describe("Canonical evidence text alias used by newer callers."),
+  topicId: z.string().optional().describe("Topic scope hint."),
+  sourceUrl: z.string().optional().describe("URL of the source material."),
+  targetNodeId: z.string().describe("The belief this evidence bears on."),
+  weight: z.number().optional().describe("Support weight from -1.0 to +1.0."),
+  reasoning: z.string().describe("Why this evidence is relevant to the target belief."),
+  title: z.string().optional().describe("Optional short title."),
+  content: z.string().optional().describe("Optional long-form evidence content."),
+  contentType: z.string().optional().describe("Content format or MIME hint."),
+  metadata: jsonRecordSchema4.optional().describe("Optional metadata merged into the evidence node.")
+});
 var evidenceIdInput = (input) => compactRecord4({
   evidenceId: input.evidenceId,
   insightId: input.insightId,
@@ -9619,7 +9876,8 @@ var evidenceContracts = [
       functionName: "create",
       kind: "mutation",
       inputProjection: createEvidenceInput
-    }
+    },
+    args: createEvidenceArgs
   }),
   surfaceContract({
     name: "add_evidence",
@@ -9655,7 +9913,8 @@ var evidenceContracts = [
           context
         );
       }
-    }
+    },
+    args: addEvidenceArgs
   }),
   surfaceContract({
     name: "get_evidence",
@@ -9762,8 +10021,91 @@ var evidenceContracts = [
     }
   })
 ];
-
-// ../contracts/src/function-registry/questions.ts
+var jsonRecordSchema5 = z.record(z.unknown());
+var questionPrioritySchema = z.enum(["urgent", "high", "medium", "low"]);
+var kernelQuestionPrioritySchema = z.enum([
+  "critical",
+  "high",
+  "medium",
+  "low"
+]);
+var questionTypeSchema = z.enum([
+  "validation",
+  "falsification",
+  "assumption_probe",
+  "prediction_test",
+  "counterfactual",
+  "discovery",
+  "clarification",
+  "comparison",
+  "causal",
+  "mechanism",
+  "general"
+]);
+var createQuestionArgs = z.object({
+  text: z.string().describe("The question text."),
+  question: z.string().optional().describe("Backend question text alias for kernel-native callers."),
+  topicId: z.string().optional().describe("Topic scope hint."),
+  priority: questionPrioritySchema.optional().describe("Human-facing question priority."),
+  linkedBeliefId: z.string().optional().describe("Belief this question tests."),
+  linkedBeliefNodeId: z.string().optional().describe("Belief node this question tests."),
+  metadata: jsonRecordSchema5.optional().describe("Optional metadata merged into the question record."),
+  category: z.string().optional().describe("Question category."),
+  source: z.string().optional().describe("Question source."),
+  testType: z.enum(["validates", "invalidates", "clarifies"]).optional().describe("How this question tests its linked belief."),
+  importance: z.number().optional().describe("Numeric importance score."),
+  epistemicUnlock: z.string().optional().describe("What this question unlocks if answered."),
+  sourceQuestionIds: z.array(z.string()).optional().describe("Question IDs this question derives from."),
+  linkedWorktreeId: z.string().optional().describe("Worktree this question belongs to."),
+  questionType: questionTypeSchema.optional().describe("Question type."),
+  questionPriority: kernelQuestionPrioritySchema.optional().describe("Kernel-native question priority.")
+});
+var refineQuestionArgs = z.object({
+  id: z.string().describe("The question to refine."),
+  text: z.string().describe("Updated question text."),
+  question: z.string().optional().describe("Backend question text alias for kernel-native callers."),
+  rationale: z.string().optional().describe("Why the question is refined."),
+  category: z.string().optional().describe("Updated question category."),
+  priority: questionPrioritySchema.optional().describe("Updated human-facing priority.")
+});
+var createAnswerArgs = z.object({
+  questionNodeId: z.string().describe("The question node ID this answer responds to."),
+  questionId: z.string().optional().describe("Question ID alias accepted by the projection."),
+  answerText: z.string().describe("The answer content."),
+  topicId: z.string().optional().describe("Topic scope for the answer."),
+  confidence: z.string().optional().describe("Answer confidence."),
+  evidenceNodeIds: z.array(z.string()).optional().describe("Evidence node IDs supporting the answer."),
+  answerSource: z.string().optional().describe("How the answer was produced."),
+  worktreeId: z.string().optional().describe("Worktree whose outcome produced this answer."),
+  sprintId: z.string().optional().describe("Legacy sprint identifier.")
+});
+var answerQuestionArgs = z.object({
+  id: z.string().describe("Canonical question ID."),
+  topicId: z.string().describe("Topic scope for the answer."),
+  text: z.string().describe("Answer text."),
+  confidence: z.enum(["weak", "medium", "strong"]).optional().describe("Optional answer confidence."),
+  evidenceIds: z.array(z.string()).optional().describe("Canonical evidence IDs supporting the answer."),
+  rationale: z.string().optional().describe("Why this answer is credible."),
+  questionId: z.string().optional().describe("Question ID alias accepted by the projection."),
+  questionNodeId: z.string().optional().describe("Question node ID alias accepted by the projection."),
+  answerText: z.string().optional().describe("Canonical answer text alias accepted by newer callers."),
+  evidenceNodeIds: z.array(z.string()).optional().describe("Evidence node ID alias accepted by newer callers."),
+  answerSource: z.string().optional().describe("How the answer was produced."),
+  worktreeId: z.string().optional().describe("Worktree whose outcome produced this answer."),
+  sprintId: z.string().optional().describe("Legacy sprint identifier.")
+});
+var missingQuestionsArgs = z.object({
+  topicId: z.string().describe("Topic scope."),
+  minConfidence: z.number().optional().describe("Minimum confidence threshold for missing-question checks."),
+  status: z.string().optional().describe("Question status filter."),
+  limit: z.number().optional().describe("Maximum questions to inspect.")
+});
+var falsificationQuestionsArgs = z.object({
+  topicId: z.string().describe("Topic scope."),
+  beliefIds: z.array(z.string()).optional().describe("Beliefs to generate falsification questions for."),
+  status: z.string().optional().describe("Question status filter."),
+  limit: z.number().optional().describe("Maximum questions to inspect.")
+});
 var questionNodeInput = (input) => compactRecord4({
   nodeId: input.nodeId ?? input.id ?? input.questionId,
   questionId: input.questionId
@@ -9810,7 +10152,8 @@ var questionsContracts = [
       functionName: "create",
       kind: "mutation",
       inputProjection: createQuestionInput
-    }
+    },
+    args: createQuestionArgs
   }),
   surfaceContract({
     name: "get_question",
@@ -9866,7 +10209,8 @@ var questionsContracts = [
         category: input.category,
         priority: input.priority
       })
-    }
+    },
+    args: refineQuestionArgs
   }),
   surfaceContract({
     name: "update_question_status",
@@ -9942,7 +10286,8 @@ var questionsContracts = [
         }),
         context
       )
-    }
+    },
+    args: createAnswerArgs
   }),
   surfaceContract({
     name: "answer_question",
@@ -9971,7 +10316,8 @@ var questionsContracts = [
         }),
         context
       )
-    }
+    },
+    args: answerQuestionArgs
   }),
   surfaceContract({
     name: "get_answer",
@@ -10003,7 +10349,8 @@ var questionsContracts = [
       functionName: "getByTopic",
       kind: "query",
       inputProjection: questionTopicInput
-    }
+    },
+    args: missingQuestionsArgs
   }),
   surfaceContract({
     name: "get_high_priority_questions",
@@ -10038,11 +10385,22 @@ var questionsContracts = [
       functionName: "getByTopic",
       kind: "query",
       inputProjection: questionTopicInput
-    }
+    },
+    args: falsificationQuestionsArgs
   })
 ];
-
-// ../contracts/src/function-registry/topics.ts
+var updateTopicArgs = z.object({
+  id: z.string().describe("Topic ID."),
+  topicId: z.string().optional().describe("Topic ID alias."),
+  name: z.string().optional().describe("Topic name."),
+  description: z.string().optional().describe("Topic description."),
+  type: z.string().optional().describe("Topic type."),
+  status: z.string().optional().describe("Topic status."),
+  visibility: z.string().optional().describe("Topic visibility."),
+  ontologyId: z.string().optional().describe("Ontology to bind."),
+  clearOntologyId: z.boolean().optional().describe("Whether to clear the ontology binding."),
+  metadata: z.record(z.unknown()).optional().describe("Topic metadata.")
+});
 var topicIdInput = (input) => compactRecord4({
   id: input.id ?? input.topicId
 });
@@ -10123,7 +10481,8 @@ var topicsContracts = [
       functionName: "update",
       kind: "mutation",
       inputProjection: updateTopicInput
-    }
+    },
+    args: updateTopicArgs
   }),
   surfaceContract({
     name: "get_topic_tree",
@@ -10142,8 +10501,27 @@ var topicsContracts = [
     }
   })
 ];
-
-// ../contracts/src/function-registry/lenses.ts
+var lensPerspectiveSchema = z.enum([
+  "investigation",
+  "monitoring",
+  "analysis",
+  "comparison",
+  "taxonomy"
+]);
+var jsonRecordSchema6 = z.record(z.unknown());
+var createLensArgs = z.object({
+  name: z.string().describe("Lens name."),
+  workspaceId: z.string().optional().describe("Workspace scope for the lens."),
+  topicId: z.string().optional().describe("Originating topic scope."),
+  description: z.string().optional().describe("What this lens investigates or monitors."),
+  perspectiveType: lensPerspectiveSchema.describe("Perspective type."),
+  promptTemplates: z.array(jsonRecordSchema6).optional().describe("Prompt templates used through this lens."),
+  workflowTemplates: z.array(jsonRecordSchema6).optional().describe("Guided workflow templates."),
+  taskTemplates: z.array(jsonRecordSchema6).optional().describe("Default task templates."),
+  questionTemplates: z.array(jsonRecordSchema6).optional().describe("Default question templates."),
+  filterCriteria: jsonRecordSchema6.optional().describe("Belief/evidence filtering criteria."),
+  metadata: jsonRecordSchema6.optional().describe("Additional lens metadata.")
+});
 var createLensInput = (input, context) => compactRecord4({
   name: input.name,
   description: input.description,
@@ -10180,7 +10558,8 @@ var lensesContracts = [
       functionName: "create",
       kind: "mutation",
       inputProjection: createLensInput
-    }
+    },
+    args: createLensArgs
   }),
   surfaceContract({
     name: "list_lenses",
@@ -10242,8 +10621,18 @@ var lensesContracts = [
     }
   })
 ];
-
-// ../contracts/src/function-registry/ontologies.ts
+var updateOntologyArgs = z.object({
+  id: z.string().describe("Ontology definition ID."),
+  ontologyId: z.string().optional().describe("Ontology ID alias."),
+  name: z.string().optional().describe("Ontology display name."),
+  description: z.string().optional().describe("Ontology description."),
+  status: z.string().optional().describe("Ontology lifecycle status.")
+});
+var ontologyVersionLifecycleArgs = z.object({
+  id: z.string().describe("Ontology version ID."),
+  versionId: z.string().optional().describe("Ontology version ID alias."),
+  ontologyId: z.string().optional().describe("Ontology definition ID.")
+});
 var ontologyIdInput = (input) => compactRecord4({
   id: input.id ?? input.ontologyId
 });
@@ -10322,11 +10711,11 @@ var ontologiesContracts = [
         id: input.id ?? input.ontologyId,
         name: input.name,
         description: input.description,
-        parentOntologyId: input.parentOntologyId,
         status: input.status,
         actorId: input.actorId
       })
-    }
+    },
+    args: updateOntologyArgs
   }),
   surfaceContract({
     name: "archive_ontology",
@@ -10409,7 +10798,8 @@ var ontologiesContracts = [
       functionName: "publishOntologyVersion",
       kind: "mutation",
       inputProjection: ontologyVersionIdInput
-    }
+    },
+    args: ontologyVersionLifecycleArgs
   }),
   surfaceContract({
     name: "deprecate_ontology_version",
@@ -10425,7 +10815,8 @@ var ontologiesContracts = [
       functionName: "deprecateOntologyVersion",
       kind: "mutation",
       inputProjection: ontologyVersionIdInput
-    }
+    },
+    args: ontologyVersionLifecycleArgs
   }),
   surfaceContract({
     name: "resolve_effective_ontology",
@@ -10444,8 +10835,76 @@ var ontologiesContracts = [
     }
   })
 ];
-
-// ../contracts/src/function-registry/worktrees.ts
+var autoFixPolicyInputSchema = z.object({
+  enabled: z.boolean().optional().describe("Whether automatic remediation is enabled."),
+  mode: z.string().optional().describe("Automation mode for worktree auto-fixes."),
+  maxAttempts: z.number().optional().describe("Maximum number of auto-fix attempts."),
+  reviewer: z.string().optional().describe("Reviewer responsible for auto-fix oversight."),
+  maxActionsPerRun: z.number().optional().describe("Maximum number of auto-fix actions per run."),
+  permittedMutationTiers: z.array(z.enum(["read_only", "low_risk_write", "high_risk_write"])).optional().describe("Mutation tiers the auto-fix worker may execute."),
+  requireAuditTrail: z.boolean().optional().describe("Whether auto-fix actions must write an audit trail."),
+  escalationGate: z.string().optional().describe("Gate to trigger when auto-fix policy requires escalation.")
+}).passthrough().describe("Policy for permitted automatic remediation inside the worktree.");
+var worktreeKeyQuestionInputSchema = z.object({
+  question: z.string().describe("Question the worktree must resolve."),
+  status: z.enum(["open", "answered", "forked"]).optional().describe("Current disposition of the key question."),
+  answer: z.string().optional().describe("Captured answer when the key question is resolved."),
+  answerConfidence: z.enum(["high", "medium", "low"]).optional().describe("Confidence in the captured answer."),
+  linkedQuestionId: z.string().optional().describe("Canonical question node linked to this key question.")
+}).passthrough().describe("Question contract embedded in the worktree plan.");
+var worktreeEvidenceSignalInputSchema = z.object({
+  signal: z.string().describe("Evidence signal the worktree should collect."),
+  collected: z.boolean().optional().describe("Whether the signal has already been collected."),
+  progress: z.string().optional().describe("Collection progress note for the signal."),
+  notes: z.string().optional().describe("Additional evidence collection notes.")
+}).passthrough().describe("Evidence signal embedded in the worktree plan.");
+var worktreeDecisionGateInputSchema = z.object({
+  goCriteria: z.array(z.string()).describe("Criteria that must hold for the worktree to proceed."),
+  noGoSignals: z.array(z.string()).describe("Signals that stop or redirect the worktree."),
+  verdict: z.enum(["go", "no_go", "pivot", "pending"]).optional().describe("Current decision verdict for the worktree gate."),
+  verdictRationale: z.string().optional().describe("Rationale supporting the current gate verdict."),
+  decidedAt: z.number().optional().describe("Timestamp when the gate verdict was decided."),
+  decidedBy: z.string().optional().describe("Actor that decided the gate verdict.")
+}).passthrough().describe("Decision gate contract for worktree activation or exit.");
+var addWorktreeArgs = z.object({
+  title: z.string().optional().describe("Human-readable worktree name or objective."),
+  name: z.string().optional().describe("Storage-name alias for callers that already use backend naming."),
+  topicId: z.string().describe("Primary topic scope for the worktree."),
+  projectId: z.string().optional().describe("Legacy topicId alias."),
+  branchId: z.string().optional().describe("Legacy branch identifier for compatibility with workflow callers."),
+  objective: z.string().optional().describe("Reasoning objective this worktree is intended to resolve."),
+  hypothesis: z.string().optional().describe("Testable claim this worktree investigates."),
+  rationale: z.string().optional().describe("Why this worktree exists and why it belongs in the campaign."),
+  worktreeType: z.string().optional().describe("Schema-enum worktree type used for kernel lifecycle behavior."),
+  gate: z.string().optional().describe("Exit gate for this worktree."),
+  startDate: z.number().optional().describe("Planned start timestamp in milliseconds since epoch."),
+  endDate: z.number().optional().describe("Planned end timestamp in milliseconds since epoch."),
+  durationWeeks: z.number().optional().describe("Planned duration in weeks."),
+  confidenceImpact: z.enum(["high", "medium", "low"]).optional().describe("Expected confidence impact if this worktree succeeds."),
+  beliefFocus: z.string().optional().describe("Natural-language focus spanning the target belief neighborhood."),
+  beliefIds: z.array(z.string()).optional().describe("Legacy alias for targetBeliefIds."),
+  beliefs: z.array(z.string()).optional().describe("Legacy alias for targetBeliefIds."),
+  targetBeliefIds: z.array(z.string()).optional().describe("Belief node IDs this worktree is expected to test or update."),
+  targetQuestionIds: z.array(z.string()).optional().describe("Question node IDs this worktree is expected to answer."),
+  keyQuestions: z.array(worktreeKeyQuestionInputSchema).optional().describe("Inline key questions captured as part of the worktree plan."),
+  evidenceSignals: z.array(worktreeEvidenceSignalInputSchema).optional().describe("Evidence signals the worktree needs to collect or validate."),
+  decisionGate: worktreeDecisionGateInputSchema.optional(),
+  goCriteria: z.array(z.string()).optional().describe("Shorthand go criteria used to build decisionGate."),
+  noGoSignals: z.array(z.string()).optional().describe("Shorthand no-go signals used to build decisionGate."),
+  proofArtifacts: z.array(z.unknown()).optional().describe("Expected proof artifacts required to close the worktree."),
+  autoShape: z.boolean().optional().describe("Whether to invoke inquiry auto-shaping during creation."),
+  autoFixPolicy: autoFixPolicyInputSchema.optional(),
+  domainPackId: z.string().optional().describe("Domain pack whose shaping hooks should influence the worktree."),
+  campaign: z.number().optional().describe("Top-level pipeline campaign number."),
+  lane: z.string().optional().describe("Campaign lane for the worktree."),
+  laneOrderInCampaign: z.number().optional().describe("Ordering for this lane within its campaign."),
+  orderInLane: z.number().optional().describe("Position of this worktree inside its lane."),
+  dependsOn: z.array(z.string()).optional().describe("Worktree IDs that must complete before this worktree."),
+  blocks: z.array(z.string()).optional().describe("Worktree IDs blocked by this worktree."),
+  staffingHint: z.string().optional().describe("Suggested staffing or agent allocation note."),
+  lensId: z.string().optional().describe("Lens that scopes this worktree when applicable."),
+  lastReconciledAt: z.number().optional().describe("Timestamp when worktree metadata was last reconciled.")
+});
 var worktreeIdInput = (input) => compactRecord4({
   worktreeId: input.worktreeId ?? input.id
 });
@@ -10478,6 +10937,50 @@ var worktreeMetadataInput = (input) => compactRecord4({
   autoFixPolicy: input.autoFixPolicy,
   lastReconciledAt: input.lastReconciledAt
 });
+var worktreeMetadataArgs = z.object({
+  worktreeId: z.string().describe("The worktree to update."),
+  id: z.string().optional().describe("Worktree ID alias."),
+  topicId: z.string().optional().describe("Primary topic scope."),
+  additionalTopicIds: z.array(z.string()).optional().describe("Additional topic scopes associated with this worktree."),
+  status: z.string().optional().describe("Worktree lifecycle status."),
+  campaign: z.number().optional().describe("Top-level pipeline campaign."),
+  lane: z.string().optional().describe("Campaign lane."),
+  laneOrderInCampaign: z.number().optional().describe("Ordering for this lane within its campaign."),
+  orderInLane: z.number().optional().describe("Position of this worktree inside its lane."),
+  gate: z.string().optional().describe("Exit gate for this worktree."),
+  hypothesis: z.string().optional().describe("Testable claim this worktree investigates."),
+  objective: z.string().optional().describe("Reasoning objective for the worktree."),
+  rationale: z.string().optional().describe("Why this worktree is sequenced here."),
+  proofArtifacts: z.array(z.unknown()).optional().describe("Proof artifacts required to close the worktree."),
+  staffingHint: z.string().optional().describe("Suggested staffing or agent allocation note."),
+  blocks: z.array(z.string()).optional().describe("Worktree IDs blocked by this worktree."),
+  dependsOn: z.array(z.string()).optional().describe("Worktree IDs this worktree depends on."),
+  lensId: z.string().optional().describe("Lens that scopes this worktree."),
+  autoFixPolicy: autoFixPolicyInputSchema.optional(),
+  lastReconciledAt: z.number().optional().describe("Timestamp of the last deterministic reconciliation pass.")
+});
+var pushArgs = worktreeMetadataArgs.extend({
+  targetContext: z.string().describe("Where to push merged findings."),
+  beliefIds: z.array(z.string()).optional().describe("Optional subset of beliefs to push.")
+});
+var openPullRequestArgs = worktreeMetadataArgs.extend({
+  reviewers: z.array(z.string()).optional().describe("User IDs of requested reviewers."),
+  summary: z.string().describe("Summary of findings and why they are ready for review.")
+});
+var mergeKeyFindingsInput = (input) => {
+  if (Array.isArray(input.keyFindings)) {
+    return input.keyFindings;
+  }
+  if (Array.isArray(input.outcomes)) {
+    const findings = input.outcomes.filter(
+      (outcome) => typeof outcome === "string" && outcome.trim().length > 0
+    );
+    if (findings.length > 0) {
+      return findings;
+    }
+  }
+  return [input.summary ?? "Merged worktree"];
+};
 var listAllWorktreesInput = (input) => compactRecord4({
   status: input.status,
   lane: input.lane,
@@ -10485,6 +10988,16 @@ var listAllWorktreesInput = (input) => compactRecord4({
   limit: input.limit
 });
 var worktreesContracts = [
+  surfaceContract({
+    name: "begin_build_session",
+    kind: "mutation",
+    domain: "worktrees",
+    surfaceClass: "platform_internal",
+    path: "/mcp/build-session/begin",
+    sdkNamespace: "worktrees",
+    sdkMethod: "beginBuildSession",
+    summary: "Begin a coding build session for a worktree."
+  }),
   surfaceContract({
     name: "add_worktree",
     kind: "mutation",
@@ -10501,13 +11014,12 @@ var worktreesContracts = [
       inputProjection: (input, context) => withCreatedBy(
         compactRecord4({
           name: input.name ?? input.title,
-          topicId: input.topicId,
+          topicId: input.topicId ?? input.projectId,
           worktreeType: input.worktreeType,
           objective: input.objective,
           gate: input.gate,
           hypothesis: input.hypothesis,
           rationale: input.rationale,
-          signal: input.signal,
           startDate: input.startDate,
           endDate: input.endDate,
           durationWeeks: input.durationWeeks,
@@ -10533,12 +11045,12 @@ var worktreesContracts = [
           staffingHint: input.staffingHint,
           domainPackId: input.domainPackId,
           lensId: input.lensId,
-          linkedQuestionId: input.linkedQuestionId,
           lastReconciledAt: input.lastReconciledAt
         }),
         context
       )
-    }
+    },
+    args: addWorktreeArgs
   }),
   surfaceContract({
     name: "activate_worktree",
@@ -10650,7 +11162,8 @@ var worktreesContracts = [
       functionName: "updateMetadata",
       kind: "mutation",
       inputProjection: worktreeMetadataInput
-    }
+    },
+    args: worktreeMetadataArgs
   }),
   surfaceContract({
     name: "merge",
@@ -10668,9 +11181,7 @@ var worktreesContracts = [
       inputProjection: (input, context) => withUserId(
         {
           ...worktreeIdInput(input),
-          keyFindings: input.keyFindings ?? [
-            input.summary ?? "Merged worktree"
-          ],
+          keyFindings: mergeKeyFindingsInput(input),
           decisionsReached: input.decisionsReached ?? [],
           nextSteps: input.nextSteps ?? []
         },
@@ -10692,7 +11203,8 @@ var worktreesContracts = [
       functionName: "updateMetadata",
       kind: "mutation",
       inputProjection: worktreeMetadataInput
-    }
+    },
+    args: pushArgs
   }),
   surfaceContract({
     name: "open_pull_request",
@@ -10708,7 +11220,8 @@ var worktreesContracts = [
       functionName: "updateMetadata",
       kind: "mutation",
       inputProjection: worktreeMetadataInput
-    }
+    },
+    args: openPullRequestArgs
   })
 ];
 
@@ -10812,6 +11325,15 @@ var createEdgeArgs = z.object({
   topicId: z.string().optional(),
   trustedBypassAccessCheck: z.boolean().optional()
 });
+var queryLineageArgs = z.object({
+  nodeId: z.string().describe("Starting node to trace from."),
+  startNode: z.string().optional().describe("Starting node alias accepted by traversal callers."),
+  depth: z.number().optional().describe("Traversal depth alias."),
+  maxDepth: z.number().optional().describe("Maximum traversal depth."),
+  mode: z.string().optional().describe("Traversal mode."),
+  minLayer: z.string().optional().describe("Minimum epistemic layer."),
+  maxLayer: z.string().optional().describe("Maximum epistemic layer.")
+});
 function graphRefNodeId(ref) {
   if (ref.kind === "epistemic_node") {
     return ref.nodeId;
@@ -10882,11 +11404,59 @@ var edgesContracts = [
         minLayer: input.minLayer,
         maxLayer: input.maxLayer
       })
-    }
+    },
+    args: queryLineageArgs
   })
 ];
-
-// ../contracts/src/function-registry/graph.ts
+var traversalLayerSchema = z.enum([
+  "L4",
+  "L3",
+  "L2",
+  "L1",
+  "ontological",
+  "organizational"
+]);
+var traversalModeSchema = z.enum(["low", "medium", "high", "extra_high"]);
+var lineageAliasArgs = z.object({
+  nodeId: z.string().optional().describe("Starting node to traverse from."),
+  startNode: z.string().optional().describe("Starting node alias for traversal callers."),
+  entityId: z.string().optional().describe("Entity identifier alias for impact tracing."),
+  depth: z.number().optional().describe("Traversal depth alias."),
+  maxDepth: z.number().optional().describe("Maximum traversal depth."),
+  mode: traversalModeSchema.optional().describe("Traversal mode."),
+  minLayer: traversalLayerSchema.optional().describe("Minimum epistemic layer to include."),
+  maxLayer: traversalLayerSchema.optional().describe("Maximum epistemic layer to include.")
+});
+var lineageArgs = lineageAliasArgs.extend({
+  nodeId: z.string().describe("Starting node to traverse from.")
+});
+var traverseGraphArgs = lineageAliasArgs.extend({
+  startNode: z.string().describe("Node to start traversal from."),
+  direction: z.enum(["up", "down", "both"]).optional().describe("Traversal direction.")
+});
+var graphNeighborhoodArgs = z.object({
+  globalId: z.string().optional().describe("Single root global ID."),
+  globalIds: z.array(z.string()).optional().describe("Root global IDs for the neighborhood."),
+  maxDepth: z.number().optional().describe("Maximum traversal depth."),
+  topicId: z.string().optional().describe("Topic scope for edge lookup."),
+  limit: z.number().optional().describe("Maximum edges to return.")
+});
+var flagContradictionArgs = z.object({
+  beliefA: z.string().describe("First belief in tension."),
+  beliefB: z.string().describe("Second belief in tension."),
+  topicId: z.string().optional().describe("Topic scope for the contradiction."),
+  description: z.string().optional().describe("Human-readable contradiction."),
+  severity: z.enum(["critical", "high", "medium", "low"]).optional().describe("Contradiction severity."),
+  defeatType: z.string().optional().describe("Defeat type annotation."),
+  supportingInsightIds: z.array(z.string()).optional().describe("Evidence supporting the primary belief."),
+  contradictingInsightIds: z.array(z.string()).optional().describe("Evidence or beliefs contradicting the primary belief.")
+});
+var discoverEntityConnectionsArgs = lineageAliasArgs.extend({
+  nodeId: z.string().describe("Epistemic node ID to find entity connections for."),
+  topicId: z.string().optional().describe("Topic scope override."),
+  minScore: z.number().optional().describe("Minimum match score."),
+  limit: z.number().optional().describe("Maximum candidates to return.")
+});
 var contradictionSeverity = (value) => {
   switch (value) {
     case "critical":
@@ -10941,7 +11511,8 @@ var graphContracts = [
       functionName: "getLineage",
       kind: "query",
       inputProjection: lineageInput
-    }
+    },
+    args: traverseGraphArgs
   }),
   surfaceContract({
     name: "get_graph_neighborhood",
@@ -10957,7 +11528,8 @@ var graphContracts = [
       functionName: "getByTopic",
       kind: "query",
       inputProjection: topicEdgesInput
-    }
+    },
+    args: graphNeighborhoodArgs
   }),
   surfaceContract({
     name: "get_graph_structure_analysis",
@@ -11006,7 +11578,8 @@ var graphContracts = [
       functionName: "create",
       kind: "mutation",
       inputProjection: flagContradictionInput
-    }
+    },
+    args: flagContradictionArgs
   }),
   surfaceContract({
     name: "detect_confirmation_bias",
@@ -11097,7 +11670,8 @@ var graphContracts = [
       functionName: "getLineage",
       kind: "query",
       inputProjection: lineageInput
-    }
+    },
+    args: discoverEntityConnectionsArgs
   }),
   surfaceContract({
     name: "trigger_belief_review",
@@ -11128,7 +11702,8 @@ var graphContracts = [
       functionName: "getLineage",
       kind: "query",
       inputProjection: lineageInput
-    }
+    },
+    args: lineageArgs
   })
 ];
 
@@ -11180,8 +11755,16 @@ var contractsContracts = [
     }
   })
 ];
-
-// ../contracts/src/function-registry/judgments.ts
+var auditTrailArgs = z.object({
+  nodeId: z.string().describe("The node to audit."),
+  id: z.string().optional().describe("Node ID alias."),
+  limit: z.number().optional().describe("Maximum entries to return."),
+  depth: z.number().optional().describe("Traversal depth alias."),
+  maxDepth: z.number().optional().describe("Maximum lineage depth."),
+  mode: z.string().optional().describe("Traversal mode."),
+  minLayer: z.string().optional().describe("Minimum epistemic layer."),
+  maxLayer: z.string().optional().describe("Maximum epistemic layer.")
+});
 var judgmentsContracts = [
   surfaceContract({
     name: "record_judgment",
@@ -11236,7 +11819,8 @@ var judgmentsContracts = [
         minLayer: input.minLayer,
         maxLayer: input.maxLayer
       })
-    }
+    },
+    args: auditTrailArgs
   })
 ];
 
@@ -11404,8 +11988,13 @@ var coordinationContracts = [
     }
   })
 ];
-
-// ../contracts/src/function-registry/pipeline.ts
+var pipelineSnapshotArgs = z.object({
+  topicId: z.string().describe("Topic scope ID."),
+  status: z.string().optional().describe("Worktree status filter."),
+  lane: z.string().optional().describe("Campaign lane filter."),
+  campaign: z.number().optional().describe("Campaign number filter."),
+  limit: z.number().optional().describe("Maximum worktrees to inspect.")
+});
 var pipelineContracts = [
   surfaceContract({
     name: "pipeline_snapshot",
@@ -11426,7 +12015,8 @@ var pipelineContracts = [
         campaign: input.campaign,
         limit: input.limit
       })
-    }
+    },
+    args: pipelineSnapshotArgs
   }),
   surfaceContract({
     name: "seed_belief_lattice",
@@ -11478,7 +12068,31 @@ var recordScopeLearningArgs = z.object({
   rationale: z.string().optional().describe("Why this learning should enter the reasoning graph"),
   createQuestionText: z.string().optional().describe("Optional follow-up question text"),
   createBeliefText: z.string().optional().describe("Optional new belief text"),
-  beliefType: z.string().optional().describe("Optional belief type for createBeliefText")
+  beliefType: z.string().optional().describe("Optional belief type for createBeliefText"),
+  text: z.string().optional().describe("Canonical learning text alias."),
+  content: z.string().optional().describe("Canonical learning content alias."),
+  kind: z.string().optional().describe("Evidence kind to store."),
+  sourceType: z.string().optional().describe("Evidence source type."),
+  externalSourceType: z.string().optional().describe("External source type alias."),
+  metadata: z.record(z.unknown()).optional().describe("Learning metadata.")
+});
+var codeContextArgs = z.object({
+  topicId: z.string().optional().describe("Topic scope."),
+  filePath: z.string().optional().describe("File path anchor."),
+  includeFailures: z.boolean().optional().describe("Whether to include failed attempts."),
+  limit: z.number().optional().describe("Maximum records to return."),
+  status: z.string().optional().describe("Evidence status filter.")
+});
+var recordAttemptArgs = z.object({
+  topicId: z.string().optional().describe("Topic scope."),
+  description: z.string().describe("Attempt description."),
+  errorMessage: z.string().optional().describe("Failure or error message."),
+  filePaths: z.array(z.string()).optional().describe("Files involved in the attempt."),
+  filePath: z.string().optional().describe("Single file path alias."),
+  linkedBeliefId: z.string().optional().describe("Linked belief ID."),
+  metadata: z.record(z.unknown()).optional().describe("Attempt metadata."),
+  rationale: z.string().optional().describe("Why this attempt should be recorded."),
+  title: z.string().optional().describe("Attempt evidence title.")
 });
 var learningInput = (input, context) => {
   const sourceKind = input.sourceKind ?? input.externalSourceType;
@@ -11595,7 +12209,8 @@ var codingContracts = [
         status: input.status,
         userId: input.userId
       })
-    }
+    },
+    args: codeContextArgs
   }),
   surfaceContract({
     name: "get_change_history",
@@ -11632,7 +12247,8 @@ var codingContracts = [
       functionName: "create",
       kind: "mutation",
       inputProjection: attemptInput
-    }
+    },
+    args: recordAttemptArgs
   }),
   surfaceContract({
     name: "get_failure_log",
@@ -11707,6 +12323,604 @@ new Map(
   ALL_FUNCTION_CONTRACTS.map((contract) => [contract.name, contract])
 );
 
+// ../contracts/src/tenant-bootstrap-seed.contract.ts
+function isCopyableSeedRequirement(entry) {
+  return (entry.copyMode === "template_global" || entry.copyMode === "template_tenant_rewrite" || entry.copyMode === "template_reference_remap") && Boolean(entry.scope) && Array.isArray(entry.uniqueKey) && entry.uniqueKey.length > 0;
+}
+var TENANT_BOOTSTRAP_TABLE_REQUIREMENTS = [
+  {
+    component: "kernel",
+    table: "agentMessages",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Agent coordination messages are session data, not template data."
+  },
+  {
+    component: "kernel",
+    table: "agentSessions",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Agent coordination sessions are created by active clients."
+  },
+  {
+    component: "kernel",
+    table: "autofixJobs",
+    prepopulation: "runtime_queue",
+    copyMode: "none",
+    description: "Autofix work items are runtime queue rows."
+  },
+  {
+    component: "kernel",
+    table: "backgroundJobRuns",
+    prepopulation: "runtime_log",
+    copyMode: "none",
+    description: "Background job executions are runtime logs."
+  },
+  {
+    component: "kernel",
+    table: "backgroundJobSettings",
+    prepopulation: "required_template",
+    copyMode: "template_global",
+    scope: "global",
+    uniqueKey: ["jobKey"],
+    description: "Default job enablement settings must come from the K template."
+  },
+  {
+    component: "kernel",
+    table: "beliefConfidence",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Belief confidence rows are created with tenant graph facts."
+  },
+  {
+    component: "kernel",
+    table: "beliefEvidenceLinks",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Belief-to-evidence links are tenant graph data."
+  },
+  {
+    component: "kernel",
+    table: "beliefHistory",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Belief history is append-only tenant graph data."
+  },
+  {
+    component: "kernel",
+    table: "beliefScenarios",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Scenario rows are tenant-authored reasoning data."
+  },
+  {
+    component: "kernel",
+    table: "beliefVotes",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Decision belief votes are tenant-authored data."
+  },
+  {
+    component: "kernel",
+    table: "calibrationScores",
+    prepopulation: "runtime_derived",
+    copyMode: "none",
+    description: "Calibration scores are computed from tenant outcomes."
+  },
+  {
+    component: "kernel",
+    table: "contractEvaluations",
+    prepopulation: "runtime_log",
+    copyMode: "none",
+    description: "Contract evaluation rows are runtime computation logs."
+  },
+  {
+    component: "kernel",
+    table: "contradictions",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Contradictions are tenant graph facts."
+  },
+  {
+    component: "kernel",
+    table: "crossProjectConnections",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Cross-topic connections are tenant graph facts."
+  },
+  {
+    component: "kernel",
+    table: "decisionComputedSummaries",
+    prepopulation: "runtime_derived",
+    copyMode: "none",
+    description: "Decision summaries are derived tenant outputs."
+  },
+  {
+    component: "kernel",
+    table: "decisionEvents",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Decision events are lifecycle data."
+  },
+  {
+    component: "kernel",
+    table: "decisionParticipants",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Decision participants are tenant-selected actors."
+  },
+  {
+    component: "kernel",
+    table: "decisionRiskLedger",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Decision risk rows are tenant decision data."
+  },
+  {
+    component: "kernel",
+    table: "decisionSnapshots",
+    prepopulation: "runtime_derived",
+    copyMode: "none",
+    description: "Decision snapshots are derived from tenant state."
+  },
+  {
+    component: "kernel",
+    table: "deliberationContributions",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Deliberation contributions are tenant-authored data."
+  },
+  {
+    component: "kernel",
+    table: "deliberationSessions",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Deliberation sessions are created by tenant workflows."
+  },
+  {
+    component: "kernel",
+    table: "epistemicAudit",
+    prepopulation: "runtime_log",
+    copyMode: "none",
+    description: "Epistemic audit rows are append-only runtime audit data."
+  },
+  {
+    component: "kernel",
+    table: "epistemicContracts",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Epistemic contracts are tenant-authored governance data."
+  },
+  {
+    component: "kernel",
+    table: "epistemicEdges",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Edges are tenant reasoning graph data."
+  },
+  {
+    component: "kernel",
+    table: "epistemicNodeEmbeddings",
+    prepopulation: "runtime_derived",
+    copyMode: "none",
+    description: "Embeddings are derived from tenant graph nodes."
+  },
+  {
+    component: "kernel",
+    table: "epistemicNodes",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Nodes are tenant reasoning graph data."
+  },
+  {
+    component: "kernel",
+    table: "graphAnalysisCache",
+    prepopulation: "runtime_derived",
+    copyMode: "none",
+    description: "Graph analysis cache rows are derived from tenant graph state."
+  },
+  {
+    component: "kernel",
+    table: "graphAnalysisResults",
+    prepopulation: "runtime_derived",
+    copyMode: "none",
+    description: "Graph analysis result rows are derived tenant outputs."
+  },
+  {
+    component: "kernel",
+    table: "graphSuggestions",
+    prepopulation: "runtime_derived",
+    copyMode: "none",
+    description: "Graph suggestions are derived recommendations."
+  },
+  {
+    component: "kernel",
+    table: "harnessReplays",
+    prepopulation: "runtime_log",
+    copyMode: "none",
+    description: "Harness replay rows are runtime verification logs."
+  },
+  {
+    component: "kernel",
+    table: "harnessRuns",
+    prepopulation: "runtime_log",
+    copyMode: "none",
+    description: "Harness run rows are runtime verification logs."
+  },
+  {
+    component: "kernel",
+    table: "idempotencyTokens",
+    prepopulation: "runtime_log",
+    copyMode: "none",
+    description: "Idempotency tokens are request-scoped runtime guards."
+  },
+  {
+    component: "kernel",
+    table: "lenses",
+    prepopulation: "optional_template",
+    copyMode: "none",
+    description: "Reusable lens templates may live in K templates, but workspace-specific copies are not required for core SDK boot."
+  },
+  {
+    component: "kernel",
+    table: "lensTopicBindings",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Lens bindings attach runtime topics to runtime/workspace lenses."
+  },
+  {
+    component: "kernel",
+    table: "neo4jSyncQueue",
+    prepopulation: "runtime_queue",
+    copyMode: "none",
+    description: "Neo4j sync queue rows are runtime work items."
+  },
+  {
+    component: "kernel",
+    table: "ontologyDefinitions",
+    prepopulation: "required_template",
+    copyMode: "template_global",
+    scope: "global",
+    uniqueKey: ["ontologyKey"],
+    description: "Platform ontology definitions power taxonomy reads and effective ontology resolution."
+  },
+  {
+    component: "kernel",
+    table: "ontologyVersions",
+    prepopulation: "required_template",
+    copyMode: "template_reference_remap",
+    scope: "global",
+    uniqueKey: ["ontologyKey", "version"],
+    dependsOn: ["ontologyDefinitions"],
+    description: "Ontology versions must be copied with ontologyDefinition ID remapping."
+  },
+  {
+    component: "kernel",
+    table: "platformAgentRunPolicyDecisions",
+    prepopulation: "runtime_log",
+    copyMode: "none",
+    description: "Agent-run policy decisions are audit logs."
+  },
+  {
+    component: "kernel",
+    table: "platformAgentRunPromptResolutions",
+    prepopulation: "runtime_log",
+    copyMode: "none",
+    description: "Agent-run prompt resolution rows are runtime logs."
+  },
+  {
+    component: "kernel",
+    table: "platformAgentRuns",
+    prepopulation: "runtime_log",
+    copyMode: "none",
+    description: "Agent runs are runtime execution records."
+  },
+  {
+    component: "kernel",
+    table: "platformAgentRunToolCalls",
+    prepopulation: "runtime_log",
+    copyMode: "none",
+    description: "Agent-run tool calls are runtime execution records."
+  },
+  {
+    component: "kernel",
+    table: "platformHarnessShadowAudit",
+    prepopulation: "runtime_log",
+    copyMode: "none",
+    description: "Harness shadow audit rows are runtime audit records."
+  },
+  {
+    component: "kernel",
+    table: "publicationRules",
+    prepopulation: "required_template",
+    copyMode: "template_tenant_rewrite",
+    scope: "tenant",
+    uniqueKey: ["tenantId", "workspaceId", "name"],
+    description: "Default publication policy rules are rewritten into each tenant."
+  },
+  {
+    component: "kernel",
+    table: "questionEvidenceLinks",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Question-to-evidence links are tenant graph data."
+  },
+  {
+    component: "kernel",
+    table: "researchJobs",
+    prepopulation: "runtime_queue",
+    copyMode: "none",
+    description: "Research job rows are runtime queue items."
+  },
+  {
+    component: "kernel",
+    table: "schemaEnumConfig",
+    prepopulation: "required_template",
+    copyMode: "template_global",
+    scope: "global",
+    uniqueKey: ["category", "value"],
+    description: "Runtime-extensible enum defaults required by SDK graph APIs."
+  },
+  {
+    component: "kernel",
+    table: "stakeholderGroups",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Stakeholder groups are tenant decision data."
+  },
+  {
+    component: "kernel",
+    table: "systemLogs",
+    prepopulation: "runtime_log",
+    copyMode: "none",
+    description: "System logs are runtime telemetry."
+  },
+  {
+    component: "kernel",
+    table: "tasks",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Tasks are tenant-authored work items."
+  },
+  {
+    component: "kernel",
+    table: "topics",
+    prepopulation: "runtime_bootstrap",
+    copyMode: "none",
+    description: "Default topics are created by tenant provisioning, not copied from templates."
+  },
+  {
+    component: "kernel",
+    table: "workflowDefinitions",
+    prepopulation: "optional_template",
+    copyMode: "none",
+    description: "Table-driven workflow definitions can be template data after the workflow engine leaves legacy mode."
+  },
+  {
+    component: "kernel",
+    table: "workflowPullRequests",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Workflow pull requests are tenant workflow data."
+  },
+  {
+    component: "kernel",
+    table: "workflowStages",
+    prepopulation: "optional_template",
+    copyMode: "none",
+    dependsOn: ["workflowDefinitions"],
+    description: "Workflow stages can be template data after workflowDefinitions are enabled for bootstrap copying."
+  },
+  {
+    component: "kernel",
+    table: "worktreeBeliefCluster",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Worktree cluster rows link runtime worktrees to runtime beliefs."
+  },
+  {
+    component: "kernel",
+    table: "worktrees",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Worktrees are tenant/runtime planning data."
+  },
+  {
+    component: "identity",
+    table: "agents",
+    prepopulation: "runtime_bootstrap",
+    copyMode: "none",
+    description: "Service agents are provisioned per tenant or service, not copied."
+  },
+  {
+    component: "identity",
+    table: "mcpWritePolicy",
+    prepopulation: "required_template",
+    copyMode: "template_global",
+    scope: "global",
+    uniqueKey: ["topicId", "role", "toolCategory"],
+    description: "Global write policy defaults govern service and interactive MCP writes."
+  },
+  {
+    component: "identity",
+    table: "modelCallLogs",
+    prepopulation: "runtime_log",
+    copyMode: "none",
+    description: "Model call logs are runtime telemetry."
+  },
+  {
+    component: "identity",
+    table: "modelFunctionSlots",
+    prepopulation: "required_template",
+    copyMode: "template_global",
+    scope: "global",
+    uniqueKey: ["slot"],
+    description: "Function-to-model slots are required by model runtime resolution."
+  },
+  {
+    component: "identity",
+    table: "modelRegistry",
+    prepopulation: "required_template",
+    copyMode: "template_global",
+    scope: "global",
+    uniqueKey: ["key"],
+    description: "Model catalog defaults are required by model runtime clients."
+  },
+  {
+    component: "identity",
+    table: "modelSlotConfigs",
+    prepopulation: "required_template",
+    copyMode: "template_global",
+    scope: "global",
+    uniqueKey: ["slot"],
+    description: "Slot-level defaults are required before tenant overrides exist."
+  },
+  {
+    component: "identity",
+    table: "platformAudienceGrants",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Audience grants are principal/group-specific access rows."
+  },
+  {
+    component: "identity",
+    table: "platformAudiences",
+    prepopulation: "required_template",
+    copyMode: "template_tenant_rewrite",
+    scope: "tenant",
+    uniqueKey: ["tenantId", "workspaceId", "audienceKey"],
+    description: "Default tenant audience taxonomy rows are rewritten into each tenant."
+  },
+  {
+    component: "identity",
+    table: "platformPolicyDecisionLogs",
+    prepopulation: "runtime_log",
+    copyMode: "none",
+    description: "Policy decisions are runtime audit logs."
+  },
+  {
+    component: "identity",
+    table: "projectGrants",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Project/topic grants are principal or group-specific access rows."
+  },
+  {
+    component: "identity",
+    table: "reasoningPermissions",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Reasoning permissions are principal-specific policy rows."
+  },
+  {
+    component: "identity",
+    table: "tenantApiKeys",
+    prepopulation: "runtime_secret",
+    copyMode: "none",
+    description: "API keys are tenant credentials and must never be copied."
+  },
+  {
+    component: "identity",
+    table: "tenantConfig",
+    prepopulation: "required_template",
+    copyMode: "template_tenant_rewrite",
+    scope: "tenant",
+    uniqueKey: ["tenantId"],
+    description: "Tenant-local config defaults are rewritten during bootstrap."
+  },
+  {
+    component: "identity",
+    table: "tenantIntegrations",
+    prepopulation: "required_template",
+    copyMode: "template_tenant_rewrite",
+    scope: "tenant",
+    uniqueKey: ["tenantId", "integrationKey"],
+    description: "Non-secret integration descriptors are rewritten into each tenant."
+  },
+  {
+    component: "identity",
+    table: "tenantModelSlotBindings",
+    prepopulation: "runtime_secret",
+    copyMode: "none",
+    description: "Tenant model slot bindings reference provider secrets and are runtime-only."
+  },
+  {
+    component: "identity",
+    table: "tenantPolicies",
+    prepopulation: "required_template",
+    copyMode: "template_tenant_rewrite",
+    scope: "tenant",
+    uniqueKey: ["tenantId", "workspaceId", "roleName"],
+    description: "Default tenant policy roles are rewritten during bootstrap."
+  },
+  {
+    component: "identity",
+    table: "tenantProviderSecrets",
+    prepopulation: "runtime_secret",
+    copyMode: "none",
+    description: "Provider secrets are credentials and must never be copied."
+  },
+  {
+    component: "identity",
+    table: "tenantProxyGatewayUsage",
+    prepopulation: "runtime_log",
+    copyMode: "none",
+    description: "Proxy gateway usage rows are runtime telemetry."
+  },
+  {
+    component: "identity",
+    table: "tenantProxyTokenMints",
+    prepopulation: "runtime_secret",
+    copyMode: "none",
+    description: "Proxy token mints are ephemeral secret-bearing runtime rows."
+  },
+  {
+    component: "identity",
+    table: "tenantSandboxAuditEvents",
+    prepopulation: "runtime_log",
+    copyMode: "none",
+    description: "Sandbox audit rows are runtime security logs."
+  },
+  {
+    component: "identity",
+    table: "tenantSecrets",
+    prepopulation: "runtime_secret",
+    copyMode: "none",
+    description: "Tenant secrets are credentials and must never be copied."
+  },
+  {
+    component: "identity",
+    table: "toolAcls",
+    prepopulation: "required_template",
+    copyMode: "template_global",
+    scope: "global",
+    uniqueKey: ["role", "toolName"],
+    description: "Default role-to-tool grants are required for SDK/MCP tool access."
+  },
+  {
+    component: "identity",
+    table: "toolRegistry",
+    prepopulation: "required_template",
+    copyMode: "template_global",
+    scope: "global",
+    uniqueKey: ["toolName"],
+    description: "Core tool catalog rows are required before pack or tenant tools exist."
+  },
+  {
+    component: "identity",
+    table: "users",
+    prepopulation: "runtime_bootstrap",
+    copyMode: "none",
+    description: "Users are created from Clerk/MC principal resolution, not copied."
+  }
+];
+TENANT_BOOTSTRAP_TABLE_REQUIREMENTS.filter(
+  isCopyableSeedRequirement
+);
+TENANT_BOOTSTRAP_TABLE_REQUIREMENTS.filter(
+  (entry) => !isCopyableSeedRequirement(entry)
+).map((entry) => entry.table);
+
 // ../contracts/src/v1/topics/v1.ts
 var ROOT_TOPIC_ID = "n17tm38rwet7wqgzrmwahyt1z582590y";
 
@@ -11721,6 +12935,12 @@ function getMcpRuntimeContext() {
 // ../../apps/mcp-server/src/scope.ts
 var defaultTopicId = null;
 var PUBLIC_TOPIC_PREFIX = "top_";
+function encodePublicTopicId(topicId) {
+  if (!isNonEmptyString(topicId)) {
+    return void 0;
+  }
+  return topicId.startsWith(PUBLIC_TOPIC_PREFIX) ? topicId : `${PUBLIC_TOPIC_PREFIX}${topicId}`;
+}
 function decodePublicTopicId(topicId) {
   if (!isNonEmptyString(topicId)) {
     return void 0;
@@ -11746,6 +12966,27 @@ function readLucernJson() {
     return null;
   }
 }
+function writeLucernJson(context) {
+  try {
+    const previous = readLucernJson() ?? {};
+    const topicId = encodePublicTopicId(context.topicId ?? previous.topicId);
+    const topicName = context.topicName ?? previous.topicName;
+    const normalized = {
+      ...previous,
+      ...context,
+      ...topicId ? { topicId, projectId: topicId } : {},
+      ...topicName ? { topicName, projectName: topicName } : {},
+      lastUpdated: context.lastUpdated ?? (/* @__PURE__ */ new Date()).toISOString()
+    };
+    fs.writeFileSync(
+      LUCERN_JSON_PATH,
+      `${JSON.stringify(normalized, null, 2)}
+`,
+      "utf-8"
+    );
+  } catch {
+  }
+}
 function isNonEmptyString(value) {
   return typeof value === "string" && value.trim().length > 0;
 }
@@ -12035,6 +13276,37 @@ var beliefHandlers = {
 };
 
 // ../../apps/mcp-server/src/handlers/bootstrap.ts
+function readString2(value) {
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
+}
+function readNullableNumber(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+function refreshLucernContextFromBuildSession(payload, args) {
+  if (!payload || typeof payload !== "object" || Array.isArray(payload)) {
+    return;
+  }
+  const record = payload;
+  const topicId = readString2(record.topicId);
+  const worktreeId = readString2(record.worktreeId) ?? readString2(args.worktreeId);
+  if (!topicId || !worktreeId) {
+    return;
+  }
+  writeLucernJson({
+    topicId,
+    topicName: readString2(record.topicName),
+    activeWorktree: {
+      worktreeId,
+      title: readString2(record.worktreeName) ?? readString2(record.title) ?? readString2(record.name) ?? worktreeId,
+      status: readString2(record.status) ?? "unknown",
+      campaign: readNullableNumber(record.campaign),
+      lane: readString2(record.lane) ?? null,
+      orderInLane: readNullableNumber(record.orderInLane),
+      gate: readString2(record.gate) ?? null,
+      branch: readString2(record.branch) ?? readString2(args.branch) ?? null
+    }
+  });
+}
 var bootstrapHandlers = {
   async generate_session_handoff(args, ctx) {
     return formatSdkResult(
@@ -12042,9 +13314,11 @@ var bootstrapHandlers = {
     );
   },
   async begin_build_session(args, ctx) {
-    return formatSdkResult(
+    const payload = formatSdkResult(
       await getSdkClient(ctx).mcp.beginBuildSession(args)
     );
+    refreshLucernContextFromBuildSession(payload, args);
+    return payload;
   }
 };
 
@@ -12587,6 +13861,14 @@ var generatedFunctionSurfaceHandlers = {
       )
     );
   },
+  async begin_build_session(args, ctx) {
+    return formatSdkResult(
+      await getSdkClient(ctx).raw.functionSurface.beginBuildSession(
+        stripInternalArgs(args),
+        idempotencyKeyFrom(args)
+      )
+    );
+  },
   async bisect_confidence(args, ctx) {
     return formatSdkResult(
       await getSdkClient(ctx).raw.functionSurface.bisectConfidence(
@@ -13455,7 +14737,7 @@ function getConvex(ctx) {
   }
   return requireMcpConvex(ctx, "topic-resolver");
 }
-function readString2(value) {
+function readString3(value) {
   if (typeof value !== "string") {
     return void 0;
   }
@@ -13466,13 +14748,13 @@ function readStringArray2(value) {
   if (!Array.isArray(value)) {
     return [];
   }
-  return value.map((entry) => readString2(entry)).filter((entry) => Boolean(entry));
+  return value.map((entry) => readString3(entry)).filter((entry) => Boolean(entry));
 }
 function asRecord2(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : {};
 }
 function normalizeTopicId(value) {
-  const normalized = readString2(value);
+  const normalized = readString3(value);
   if (!normalized) {
     return void 0;
   }
@@ -13484,7 +14766,7 @@ function normalizeTopicId(value) {
   }
 }
 function normalizeExternalId(value, prefix) {
-  const normalized = readString2(value);
+  const normalized = readString3(value);
   if (!normalized) {
     return void 0;
   }
@@ -13506,7 +14788,7 @@ function normalizeToken(value) {
   return normalized;
 }
 function tokenize(value) {
-  const normalized = readString2(value);
+  const normalized = readString3(value);
   if (!normalized) {
     return [];
   }
@@ -13621,22 +14903,22 @@ function scoreTopicMatch(topic, input) {
 }
 function normalizeTopicCandidate(value) {
   const record = asRecord2(value);
-  const rawId = readString2(record._id) ?? readString2(record.id) ?? normalizeTopicId(readString2(record.topicId)) ?? normalizeTopicId(readString2(record.projectId));
-  const name = readString2(record.name);
+  const rawId = readString3(record._id) ?? readString3(record.id) ?? normalizeTopicId(readString3(record.topicId)) ?? normalizeTopicId(readString3(record.projectId));
+  const name = readString3(record.name);
   if (!rawId || !name) {
     return null;
   }
   return {
     rawId,
     name,
-    description: readString2(record.description),
-    type: readString2(record.type),
-    parentTopicId: normalizeTopicId(readString2(record.parentTopicId)) ?? null,
-    tenantId: readString2(record.tenantId),
-    workspaceId: readString2(record.workspaceId),
-    status: readString2(record.status),
+    description: readString3(record.description),
+    type: readString3(record.type),
+    parentTopicId: normalizeTopicId(readString3(record.parentTopicId)) ?? null,
+    tenantId: readString3(record.tenantId),
+    workspaceId: readString3(record.workspaceId),
+    status: readString3(record.status),
     metadata: asRecord2(record.metadata),
-    globalId: readString2(record.globalId)
+    globalId: readString3(record.globalId)
   };
 }
 function topicMatchesScope(topic, tenantId, workspaceId) {
@@ -13664,7 +14946,7 @@ async function fetchTopicById(ctx, topicId) {
 function readRecordTopicId(value) {
   const record = asRecord2(value);
   return normalizeTopicId(
-    readString2(record.topicId) ?? readString2(record.projectId) ?? readString2(asRecord2(record.metadata).topicId)
+    readString3(record.topicId) ?? readString3(record.projectId) ?? readString3(asRecord2(record.metadata).topicId)
   );
 }
 async function fetchRecordTopicId(ctx, reference, args) {
@@ -13683,7 +14965,7 @@ async function resolveBeliefTopicId(ctx, beliefId) {
 }
 async function resolveCommonBeliefTopicId(ctx, beliefIds) {
   const normalizedBeliefIds = (beliefIds ?? []).filter(
-    (beliefId) => Boolean(readString2(beliefId))
+    (beliefId) => Boolean(readString3(beliefId))
   );
   if (normalizedBeliefIds.length === 0) {
     return void 0;
@@ -13745,7 +15027,7 @@ function compactWhitespace(value) {
   return value.replace(/\s+/g, " ").trim();
 }
 function deriveTopicName(input, parentTopic) {
-  const textualHint = readString2(input.topicHint);
+  const textualHint = readString3(input.topicHint);
   if (textualHint && tokenize(textualHint).length > 0) {
     return titleCase(compactWhitespace(textualHint)).slice(0, 60);
   }
@@ -13761,7 +15043,7 @@ function deriveTopicName(input, parentTopic) {
   if (summary.length > 0) {
     return titleCase(summary.slice(0, 60));
   }
-  const sourceRef = readString2(input.sourceRef);
+  const sourceRef = readString3(input.sourceRef);
   if (sourceRef) {
     return titleCase(compactWhitespace(sourceRef.replace(/[-_:/]+/g, " "))).slice(0, 60);
   }
@@ -13770,7 +15052,7 @@ function deriveTopicName(input, parentTopic) {
 async function createChildTopic(ctx, parentTopic, input) {
   const convex = getConvex(ctx);
   const desiredTenantId = ctx.tenantId;
-  const desiredWorkspaceId = readString2(input.workspaceId) ?? ctx.workspaceId;
+  const desiredWorkspaceId = readString3(input.workspaceId) ?? ctx.workspaceId;
   const createdBy = ctx.principalId ?? ctx.userId;
   const created = await convex.mutation(api.topics.create, {
     name: deriveTopicName(input, parentTopic),
@@ -13790,7 +15072,7 @@ async function createChildTopic(ctx, parentTopic, input) {
     }
   });
   const createdRecord = asRecord2(created);
-  const createdId = readString2(createdRecord.id) ?? readString2(createdRecord.topicId) ?? readString2(createdRecord._id);
+  const createdId = readString3(createdRecord.id) ?? readString3(createdRecord.topicId) ?? readString3(createdRecord._id);
   const hydrated = await fetchTopicById(ctx, createdId);
   if (!hydrated) {
     throw new Error("[topic-resolver] Auto-created topic could not be reloaded.");
@@ -13810,11 +15092,32 @@ function pushTrace(trace, topic, score) {
     score
   });
 }
+function pickBestTopic(topics2, input) {
+  const ranked = topics2.filter((topic) => topic.status !== "archived").map((topic) => ({
+    topic,
+    score: scoreTopicMatch(topic, input)
+  })).sort((left, right) => {
+    if (right.score !== left.score) {
+      return right.score - left.score;
+    }
+    const leftName = left.topic.name.trim().toLowerCase();
+    const rightName = right.topic.name.trim().toLowerCase();
+    return leftName.localeCompare(rightName);
+  });
+  return ranked[0]?.topic ?? null;
+}
+function pickFallbackRootTopic(topics2, input) {
+  const parentless = topics2.filter((topic) => !topic.parentTopicId);
+  return pickBestTopic(parentless, input) ?? pickBestTopic(topics2, input);
+}
 async function loadTopicUniverse(ctx, input) {
   const desiredTenantId = ctx.tenantId;
-  const desiredWorkspaceId = readString2(input.workspaceId) ?? ctx.workspaceId;
+  const desiredWorkspaceId = readString3(input.workspaceId) ?? ctx.workspaceId;
   const rawTopics = await fetchTopicTree(ctx);
-  const root = rawTopics.find((topic) => topic.rawId === ROOT_TOPIC_ID) ?? await fetchTopicById(ctx, ROOT_TOPIC_ID) ?? rawTopics.find((topic) => !topic.parentTopicId) ?? null;
+  const scopedTopics = rawTopics.filter(
+    (topic) => topicMatchesScope(topic, desiredTenantId, desiredWorkspaceId)
+  );
+  const root = rawTopics.find((topic) => topic.rawId === ROOT_TOPIC_ID) ?? await fetchTopicById(ctx, ROOT_TOPIC_ID) ?? pickFallbackRootTopic(scopedTopics, input) ?? null;
   if (!root) {
     throw new Error("[topic-resolver] Root topic not found.");
   }
@@ -14657,7 +15960,13 @@ var scopeContextHandlers = {
         packWeightOverrides: Array.isArray(args.packWeightOverrides) ? args.packWeightOverrides : void 0
       })
     );
-    return toPublicCompiledContext(compiled);
+    const publicContext = toPublicCompiledContext(compiled);
+    writeLucernJson({
+      topicId: publicContext.topicId ?? topicId,
+      topicName: publicContext.topicName,
+      activeWorktree: null
+    });
+    return publicContext;
   },
   async record_scope_learning(args, ctx) {
     const explicitTopicId = readString(readTopicIdArg(args));
@@ -14852,20 +16161,27 @@ var worktreeHandlers = {
   },
   async merge(args, ctx) {
     const record = asRecord(args);
-    const outcomes = Array.isArray(record.outcomes) ? record.outcomes : [];
+    const outcomes = Array.isArray(record.outcomes) ? record.outcomes.map((entry) => {
+      const finding = readString(entry);
+      if (finding) {
+        return finding;
+      }
+      const row = asRecord(entry);
+      if (!Object.keys(row).length) {
+        return null;
+      }
+      return {
+        beliefId: readString(row.beliefId) ?? "",
+        confidence: readNumber(row.confidence) ?? Number.NaN,
+        rationale: readString(row.rationale) ?? ""
+      };
+    }).filter((entry) => entry !== null) : [];
     return formatSdkResult(
       await getSdkClient(ctx).worktrees.merge(
         readString(record.worktreeId ?? record.id) ?? "",
         {
           summary: readString(record.summary),
-          outcomes: outcomes.map((entry) => {
-            const row = asRecord(entry);
-            return {
-              beliefId: readString(row.beliefId) ?? "",
-              confidence: readNumber(row.confidence) ?? Number.NaN,
-              rationale: readString(row.rationale) ?? ""
-            };
-          })
+          outcomes
         }
       )
     );