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

package/dist/runtime.js

@@ -3,10 +3,6 @@ import * as path2 from 'path';
 import { basename, extname } from 'path';
 import { z } from 'zod';
 import { v } from 'convex/values';
-import { internal, components, api as api$1 } from '@lucern/reasoning-kernel/adapters/convex';
-import 'stream';
-import { AsyncLocalStorage } from 'async_hooks';
-import { ConvexHttpClient } from 'convex/browser';
 import 'crypto';
 import * as os from 'os';
 
@@ -2054,6 +2050,40 @@ defineTable({
     { kind: "index", name: "by_tier_window_end", columns: ["tier", "windowEndMs"] }
   ]
 });
+defineTable({
+  name: "oauthDeviceCodes",
+  component: "mc",
+  category: "identity",
+  shape: z.object({
+    "deviceCodeHash": z.string(),
+    "userCode": z.string(),
+    "clientId": z.string(),
+    "scope": z.string(),
+    "status": z.enum(["pending", "approved", "denied", "expired", "consumed"]),
+    "expiresAt": z.number(),
+    "intervalSeconds": z.number(),
+    "lastPolledAt": z.number().optional(),
+    "slowDownCount": z.number().optional(),
+    "clerkUserId": z.string().optional(),
+    "tenantId": idOf("tenants").optional(),
+    "workspaceId": z.string().optional(),
+    "principalId": z.string().optional(),
+    "role": z.string().optional(),
+    "scopes": z.array(z.string()).optional(),
+    "sessionId": z.string().optional(),
+    "approvedAt": z.number().optional(),
+    "deniedAt": z.number().optional(),
+    "consumedAt": z.number().optional(),
+    "createdAt": z.number(),
+    "updatedAt": z.number()
+  }),
+  indices: [
+    { kind: "index", name: "by_deviceCodeHash", columns: ["deviceCodeHash"] },
+    { kind: "index", name: "by_userCode", columns: ["userCode"] },
+    { kind: "index", name: "by_status_expiresAt", columns: ["status", "expiresAt"] },
+    { kind: "index", name: "by_sessionId", columns: ["sessionId"] }
+  ]
+});
 defineTable({
   name: "servicePrincipalKeys",
   component: "mc",
@@ -4010,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(),
@@ -5275,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",
@@ -5288,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"
@@ -5324,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"],
@@ -5356,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" }
   },
@@ -8375,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,
@@ -8468,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,
@@ -8681,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",
@@ -8735,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"
 ];
@@ -9121,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,
@@ -9181,7 +9389,8 @@ var contextContracts = [
         observationId: output && typeof output === "object" ? output.nodeId : void 0,
         observationType: input.observationType
       })
-    }
+    },
+    args: observationArgs
   }),
   surfaceContract({
     name: "get_observation_context",
@@ -9202,7 +9411,8 @@ var contextContracts = [
         status: input.status,
         userId: input.userId
       })
-    }
+    },
+    args: observationContextArgs
   })
 ];
 
@@ -9265,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
@@ -9341,7 +9588,8 @@ var beliefsContracts = [
       functionName: "create",
       kind: "mutation",
       inputProjection: createBeliefInput
-    }
+    },
+    args: createBeliefArgs
   }),
   surfaceContract({
     name: "get_belief",
@@ -9432,7 +9680,8 @@ var beliefsContracts = [
       functionName: "forkBelief",
       kind: "mutation",
       inputProjection: forkBeliefInput
-    }
+    },
+    args: forkBeliefArgs
   }),
   surfaceContract({
     name: "archive_belief",
@@ -9513,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,
@@ -9589,7 +9876,8 @@ var evidenceContracts = [
       functionName: "create",
       kind: "mutation",
       inputProjection: createEvidenceInput
-    }
+    },
+    args: createEvidenceArgs
   }),
   surfaceContract({
     name: "add_evidence",
@@ -9625,7 +9913,8 @@ var evidenceContracts = [
           context
         );
       }
-    }
+    },
+    args: addEvidenceArgs
   }),
   surfaceContract({
     name: "get_evidence",
@@ -9732,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
@@ -9780,7 +10152,8 @@ var questionsContracts = [
       functionName: "create",
       kind: "mutation",
       inputProjection: createQuestionInput
-    }
+    },
+    args: createQuestionArgs
   }),
   surfaceContract({
     name: "get_question",
@@ -9836,7 +10209,8 @@ var questionsContracts = [
         category: input.category,
         priority: input.priority
       })
-    }
+    },
+    args: refineQuestionArgs
   }),
   surfaceContract({
     name: "update_question_status",
@@ -9912,7 +10286,8 @@ var questionsContracts = [
         }),
         context
       )
-    }
+    },
+    args: createAnswerArgs
   }),
   surfaceContract({
     name: "answer_question",
@@ -9941,7 +10316,8 @@ var questionsContracts = [
         }),
         context
       )
-    }
+    },
+    args: answerQuestionArgs
   }),
   surfaceContract({
     name: "get_answer",
@@ -9973,7 +10349,8 @@ var questionsContracts = [
       functionName: "getByTopic",
       kind: "query",
       inputProjection: questionTopicInput
-    }
+    },
+    args: missingQuestionsArgs
   }),
   surfaceContract({
     name: "get_high_priority_questions",
@@ -10008,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
 });
@@ -10093,7 +10481,8 @@ var topicsContracts = [
       functionName: "update",
       kind: "mutation",
       inputProjection: updateTopicInput
-    }
+    },
+    args: updateTopicArgs
   }),
   surfaceContract({
     name: "get_topic_tree",
@@ -10112,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,
@@ -10150,7 +10558,8 @@ var lensesContracts = [
       functionName: "create",
       kind: "mutation",
       inputProjection: createLensInput
-    }
+    },
+    args: createLensArgs
   }),
   surfaceContract({
     name: "list_lenses",
@@ -10212,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
 });
@@ -10292,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",
@@ -10379,7 +10798,8 @@ var ontologiesContracts = [
       functionName: "publishOntologyVersion",
       kind: "mutation",
       inputProjection: ontologyVersionIdInput
-    }
+    },
+    args: ontologyVersionLifecycleArgs
   }),
   surfaceContract({
     name: "deprecate_ontology_version",
@@ -10395,7 +10815,8 @@ var ontologiesContracts = [
       functionName: "deprecateOntologyVersion",
       kind: "mutation",
       inputProjection: ontologyVersionIdInput
-    }
+    },
+    args: ontologyVersionLifecycleArgs
   }),
   surfaceContract({
     name: "resolve_effective_ontology",
@@ -10414,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
 });
@@ -10448,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,
@@ -10455,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",
@@ -10471,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,
@@ -10503,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",
@@ -10620,7 +11162,8 @@ var worktreesContracts = [
       functionName: "updateMetadata",
       kind: "mutation",
       inputProjection: worktreeMetadataInput
-    }
+    },
+    args: worktreeMetadataArgs
   }),
   surfaceContract({
     name: "merge",
@@ -10638,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 ?? []
         },
@@ -10662,7 +11203,8 @@ var worktreesContracts = [
       functionName: "updateMetadata",
       kind: "mutation",
       inputProjection: worktreeMetadataInput
-    }
+    },
+    args: pushArgs
   }),
   surfaceContract({
     name: "open_pull_request",
@@ -10678,7 +11220,8 @@ var worktreesContracts = [
       functionName: "updateMetadata",
       kind: "mutation",
       inputProjection: worktreeMetadataInput
-    }
+    },
+    args: openPullRequestArgs
   })
 ];
 
@@ -10782,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;
@@ -10852,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":
@@ -10911,7 +11511,8 @@ var graphContracts = [
       functionName: "getLineage",
       kind: "query",
       inputProjection: lineageInput
-    }
+    },
+    args: traverseGraphArgs
   }),
   surfaceContract({
     name: "get_graph_neighborhood",
@@ -10927,7 +11528,8 @@ var graphContracts = [
       functionName: "getByTopic",
       kind: "query",
       inputProjection: topicEdgesInput
-    }
+    },
+    args: graphNeighborhoodArgs
   }),
   surfaceContract({
     name: "get_graph_structure_analysis",
@@ -10976,7 +11578,8 @@ var graphContracts = [
       functionName: "create",
       kind: "mutation",
       inputProjection: flagContradictionInput
-    }
+    },
+    args: flagContradictionArgs
   }),
   surfaceContract({
     name: "detect_confirmation_bias",
@@ -11067,7 +11670,8 @@ var graphContracts = [
       functionName: "getLineage",
       kind: "query",
       inputProjection: lineageInput
-    }
+    },
+    args: discoverEntityConnectionsArgs
   }),
   surfaceContract({
     name: "trigger_belief_review",
@@ -11098,7 +11702,8 @@ var graphContracts = [
       functionName: "getLineage",
       kind: "query",
       inputProjection: lineageInput
-    }
+    },
+    args: lineageArgs
   })
 ];
 
@@ -11150,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",
@@ -11206,7 +11819,8 @@ var judgmentsContracts = [
         minLayer: input.minLayer,
         maxLayer: input.maxLayer
       })
-    }
+    },
+    args: auditTrailArgs
   })
 ];
 
@@ -11374,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",
@@ -11396,7 +12015,8 @@ var pipelineContracts = [
         campaign: input.campaign,
         limit: input.limit
       })
-    }
+    },
+    args: pipelineSnapshotArgs
   }),
   surfaceContract({
     name: "seed_belief_lattice",
@@ -11448,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;
@@ -11565,7 +12209,8 @@ var codingContracts = [
         status: input.status,
         userId: input.userId
       })
-    }
+    },
+    args: codeContextArgs
   }),
   surfaceContract({
     name: "get_change_history",
@@ -11602,7 +12247,8 @@ var codingContracts = [
       functionName: "create",
       kind: "mutation",
       inputProjection: attemptInput
-    }
+    },
+    args: recordAttemptArgs
   }),
   surfaceContract({
     name: "get_failure_log",
@@ -11677,360 +12323,624 @@ new Map(
   ALL_FUNCTION_CONTRACTS.map((contract) => [contract.name, contract])
 );
 
-// ../contracts/src/v1/topics/v1.ts
-var ROOT_TOPIC_ID = "n17tm38rwet7wqgzrmwahyt1z582590y";
-
-// ../server-core/src/kernelApi.ts
-var REQUIRED_KERNEL_API_REF_SUFFIXES = [
-  "contradictions.create",
-  "contradictions.getById",
-  "contradictions.getByTopic",
-  "epistemicAnswers.create",
-  "epistemicAnswers.getLatestForQuestion",
-  "epistemicBeliefs.archive",
-  "epistemicBeliefs.batchUpdateCriticality",
-  "epistemicBeliefs.create",
-  "epistemicBeliefs.forkBelief",
-  "epistemicBeliefs.getById",
-  "epistemicBeliefs.getByTopic",
-  "epistemicBeliefs.getConfidenceHistory",
-  "epistemicBeliefs.getLineage",
-  "epistemicBeliefs.getRelationships",
-  "epistemicBeliefs.linkBeliefs",
-  "epistemicBeliefs.linkEvidence",
-  "epistemicBeliefs.modulateConfidence",
-  "epistemicBeliefs.reassignBeliefsTopic",
-  "epistemicBeliefs.refineBelief",
-  "epistemicBeliefs.unlinkEvidence",
-  "epistemicBeliefs.updateCriticality",
-  "epistemicBeliefs.updateRationale",
-  "epistemicBeliefs.updateStatus",
-  "epistemicContracts.createEpistemicContract",
-  "epistemicContracts.evaluateContract",
-  "epistemicContracts.getContractStatus",
-  "epistemicEdges.batchCreate",
-  "epistemicEdges.create",
-  "epistemicEdges.deleteEdges",
-  "epistemicEdges.getBySourceNode",
-  "epistemicEdges.getByTopicAndType",
-  "epistemicEdges.remove",
-  "epistemicEdges.removeBetween",
-  "epistemicEdges.update",
-  "epistemicEvidence.create",
-  "epistemicEvidence.flagAsIncorrect",
-  "epistemicEvidence.getById",
-  "epistemicEvidence.getByTopic",
-  "epistemicEvidence.getForBelief",
-  "epistemicEvidence.remove",
-  "epistemicEvidence.update",
-  "epistemicEvidence.updateStatus",
-  "epistemicEvidence.updateVerificationStatus",
-  "epistemicNodes.get",
-  "epistemicNodes.getByGlobalId",
-  "epistemicQuestions.addQuestion",
-  "epistemicQuestions.advanceToConviction",
-  "epistemicQuestions.create",
-  "epistemicQuestions.createBatch",
-  "epistemicQuestions.deleteQuestion",
-  "epistemicQuestions.finalizeConviction",
-  "epistemicQuestions.getById",
-  "epistemicQuestions.getByTopic",
-  "epistemicQuestions.internalCreate",
-  "epistemicQuestions.updateConviction",
-  "epistemicQuestions.updatePriority",
-  "epistemicQuestions.updateQuestion",
-  "epistemicQuestions.updateStatus",
-  "evidenceClassifier.classifyEvidence",
-  "evidenceClassifier.classifyEvidenceBatch",
-  "graphAnalysisCache.getCachedAnalysis",
-  "graphIntelligence.analyzeProject",
-  "neo4jEdgeAPI.getGraphNeighborhood",
-  "neo4jQueries.getConfirmationBiasScore",
-  "ontologyDefinitions.archiveOntologyDefinition",
-  "ontologyDefinitions.createOntologyDefinition",
-  "ontologyDefinitions.createOntologyVersion",
-  "ontologyDefinitions.deprecateOntologyVersion",
-  "ontologyDefinitions.getOntologyDefinition",
-  "ontologyDefinitions.getOntologyDefinitionByKey",
-  "ontologyDefinitions.getPublishedVersion",
-  "ontologyDefinitions.listOntologyDefinitions",
-  "ontologyDefinitions.publishOntologyVersion",
-  "ontologyDefinitions.resolveEffectiveOntology",
-  "ontologyDefinitions.updateOntologyDefinition",
-  "policy.filterByPermission",
-  "questionEvidenceLinks.create",
-  "questionEvidenceLinks.getEvidenceWithDetails",
-  "tasks.complete",
-  "tasks.create",
-  "tasks.get",
-  "tasks.getByTopic",
-  "tasks.getByWorktree",
-  "tasks.update",
-  "topics.bulkCreate",
-  "topics.checkAccess",
-  "topics.create",
-  "topics.get",
-  "topics.getTree",
-  "topics.list",
-  "topics.listByOntology",
-  "topics.remove",
-  "topics.resolveTopicOntology",
-  "topics.update",
-  "worktrees.activate",
-  "worktrees.advancePhase",
-  "worktrees.bulkCreate",
-  "worktrees.complete",
-  "worktrees.create",
-  "worktrees.get",
-  "worktrees.list",
-  "worktrees.listAll",
-  "worktrees.patchState",
-  "worktrees.setPhase",
-  "worktrees.updateMetadata",
-  "worktrees.updateTargets"
-];
-var KERNEL_API_REF_MANIFEST = REQUIRED_KERNEL_API_REF_SUFFIXES.map((path3) => ({
-  path: `api.${path3}`,
-  componentPath: `components.lucern.${path3}`
-}));
-var GLOBAL_KEY = "__LUCERN_SERVER_CORE_KERNEL_API_BINDING__";
-function store() {
-  return globalThis;
-}
-function registerKernelApi(nextBinding) {
-  assertKernelApiBinding(nextBinding);
-  store()[GLOBAL_KEY] = nextBinding;
-}
-function getBinding() {
-  const current = store()[GLOBAL_KEY];
-  if (!current) {
-    throw new Error(
-      "Server-core kernelApi not registered. Call registerKernelApi({api, components, internal}) at host boot."
-    );
-  }
-  return current;
-}
-function readPath(root, path3) {
-  let cursor = root;
-  for (const part of path3) {
-    if (cursor == null || typeof cursor !== "object") {
-      return void 0;
-    }
-    cursor = cursor[part];
-  }
-  return cursor;
+// ../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;
 }
-function resolveApiPath(binding, which, path3) {
-  return readPath(binding[which], path3);
-}
-function validateKernelApiBinding(binding) {
-  const missing = [];
-  const resolved = [];
-  for (const entry of KERNEL_API_REF_MANIFEST) {
-    const suffix = entry.path.split(".").slice(1);
-    const reference = resolveApiPath(binding, "api", suffix);
-    if (reference === void 0) {
-      missing.push(entry);
-    } else {
-      resolved.push(entry);
-    }
-  }
-  return {
-    ok: missing.length === 0,
-    missing,
-    resolved
-  };
-}
-function assertKernelApiBinding(binding) {
-  const result = validateKernelApiBinding(binding);
-  if (!result.ok) {
-    const refs = result.missing.map((entry) => entry.path).join(", ");
-    throw new Error(
-      `Server-core kernelApi binding is missing required refs: ${refs}`
-    );
+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."
   }
-}
-function makeProxy(which, path3 = []) {
-  return new Proxy({}, {
-    get(_target, prop) {
-      if (typeof prop !== "string") {
-        return void 0;
-      }
-      const nextPath = [...path3, prop];
-      const resolved = resolveApiPath(getBinding(), which, nextPath);
-      return resolved === void 0 ? makeProxy(which, nextPath) : resolved;
-    }
-  });
-}
-var api = makeProxy("api");
-makeProxy("components");
-makeProxy("internal");
+];
+TENANT_BOOTSTRAP_TABLE_REQUIREMENTS.filter(
+  isCopyableSeedRequirement
+);
+TENANT_BOOTSTRAP_TABLE_REQUIREMENTS.filter(
+  (entry) => !isCopyableSeedRequirement(entry)
+).map((entry) => entry.table);
 
-// ../../apps/mcp-server/src/kernelApi.ts
-registerKernelApi({
-  api: api$1,
-  components: components,
-  internal: internal
-});
-var api2 = api$1;
-var components2 = components;
-function isQuietMcpBoot() {
-  return process.env.LUCERN_MCP_QUIET === "1";
-}
-function logMcpInfo(message) {
-  if (!isQuietMcpBoot()) {
-    console.error(message);
-  }
-}
+// ../contracts/src/v1/topics/v1.ts
+var ROOT_TOPIC_ID = "n17tm38rwet7wqgzrmwahyt1z582590y";
 
-// ../../apps/mcp-server/src/convex-client.ts
-var _requestScopedClient = new AsyncLocalStorage();
-function runWithScopedClient(client, fn) {
-  return _requestScopedClient.run(client, fn);
-}
-function createAdminClient(url, deployKey) {
-  const client = new ConvexHttpClient(url);
-  client.setAdminAuth(deployKey);
-  return client;
-}
-var _lucernClient = null;
-function getLucernClient() {
-  const scoped = _requestScopedClient.getStore();
-  if (scoped) {
-    return scoped;
-  }
-  if (_lucernClient) {
-    return _lucernClient;
-  }
-  const url = process.env.LUCERN_CONVEX_URL;
-  const key = process.env.LUCERN_DEPLOY_KEY;
-  if (!url) {
-    throw new Error(
-      "LUCERN_CONVEX_URL is required. Ensure LUCERN_API_KEY is set in .env.lucern"
-    );
-  }
-  if (!key) {
-    throw new Error(
-      "LUCERN_DEPLOY_KEY is required. Ensure LUCERN_API_KEY is set in .env.lucern"
-    );
-  }
-  _lucernClient = new ConvexHttpClient(url);
-  _lucernClient.setAdminAuth(key);
-  logMcpInfo(`[lucern-graph] Lucern client initialized \u2192 ${url}`);
-  return _lucernClient;
-}
-var MCP_META_KEYS = [
-  "mcpSessionId",
-  "mcpToolName",
-  "runtimeToolName",
-  "runtimePackKey",
-  "runtimePackInstallScope"
-];
-var mutationRuntimeCache = /* @__PURE__ */ new Map();
-var packInstallScopeCache = /* @__PURE__ */ new Map();
-async function resolvePackInstallScope(packKey) {
-  const normalizedPackKey = packKey.trim();
-  if (!normalizedPackKey) {
-    return;
-  }
-  let cached = packInstallScopeCache.get(normalizedPackKey);
-  if (!cached) {
-    cached = (async () => {
-      const packDefinition = await mcAdminQuery(
-        "packs:getPackDefinition",
-        {
-          packKey: normalizedPackKey
-        }
-      );
-      const installScope = packDefinition?.installScope;
-      if (installScope === "tenant" || installScope === "workspace") {
-        return installScope;
-      }
-      throw new Error(
-        `[mcp-runtime] Pack "${normalizedPackKey}" is missing a valid installScope`
-      );
-    })();
-    packInstallScopeCache.set(normalizedPackKey, cached);
-  }
-  return await cached;
-}
-async function resolveMutationRuntimeFields(toolName) {
-  if (typeof toolName !== "string" || toolName.trim().length === 0) {
-    return null;
-  }
-  const normalizedToolName = toolName.trim();
-  let cached = mutationRuntimeCache.get(normalizedToolName);
-  if (!cached) {
-    cached = (async () => {
-      const tools = await adminQuery("toolAccess:listToolRegistry", {});
-      const tool = tools.find(
-        (candidate) => candidate?.toolName === normalizedToolName && candidate?.isActive !== false && candidate?.status !== "deprecated" && candidate?.status !== "disabled"
-      );
-      const packKey = typeof tool?.packKey === "string" ? tool.packKey.trim() : "";
-      if (!packKey) {
-        return { runtimeToolName: normalizedToolName };
-      }
-      return {
-        runtimeToolName: normalizedToolName,
-        runtimePackKey: packKey,
-        runtimePackInstallScope: await resolvePackInstallScope(packKey)
-      };
-    })();
-    mutationRuntimeCache.set(normalizedToolName, cached);
-  }
-  return await cached;
-}
-async function adminMutation(fn, args) {
-  const cleanArgs = { ...args };
-  if (cleanArgs.runtimeToolName === void 0 && cleanArgs.runtimePackKey === void 0 && cleanArgs.runtimePackInstallScope === void 0) {
-    const runtimeFields = await resolveMutationRuntimeFields(args?.mcpToolName);
-    if (runtimeFields) {
-      Object.assign(cleanArgs, runtimeFields);
-    }
-  }
-  for (const key of MCP_META_KEYS) {
-    delete cleanArgs[key];
-  }
-  return getLucernClient().mutation(fn, cleanArgs);
-}
-async function adminQuery(fn, args) {
-  return getLucernClient().query(fn, args);
-}
-var _mcClient = null;
-var _mcClientChecked = false;
-function getMcClient() {
-  if (_mcClientChecked) {
-    return _mcClient;
-  }
-  const url = process.env.MC_CONVEX_URL;
-  const key = process.env.MC_DEPLOY_KEY;
-  if (url && key) {
-    _mcClient = new ConvexHttpClient(url);
-    _mcClient.setAdminAuth(key);
-    logMcpInfo(`[lucern-graph] Master Control client initialized \u2192 ${url}`);
-  } else {
-    logMcpInfo(
-      "[lucern-graph] Master Control client not configured (no MC_CONVEX_URL). Methodology packs will use hardcoded fallback."
-    );
-  }
-  _mcClientChecked = true;
-  return _mcClient;
-}
-async function mcAdminQuery(fn, args) {
-  const c = getMcClient();
-  if (!c) {
-    throw new Error(
-      "Master Control client not configured (set MC_CONVEX_URL + MC_DEPLOY_KEY)"
-    );
-  }
-  return c.query(fn, args);
+// ../../apps/mcp-server/src/runtime-context.ts
+var runtimeContext = Object.freeze({
+  transportKind: "stdio"
+});
+function getMcpRuntimeContext() {
+  return runtimeContext;
 }
-process.env.LUCERN_AGENT_IDENTITY || "agent:claude-code";
-crypto.randomUUID();
 
 // ../../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;
@@ -12056,9 +12966,55 @@ 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;
 }
+function getLucernClient() {
+  const client = getMcpRuntimeContext().lucernClient;
+  if (!client) {
+    throw new Error("[scope] Lucern SDK client is not initialized.");
+  }
+  return client;
+}
+function unwrapGatewayData(value) {
+  if (!value || typeof value !== "object") {
+    return null;
+  }
+  const record = value;
+  const data = record.data;
+  if (data && typeof data === "object" && !Array.isArray(data)) {
+    return data;
+  }
+  return record;
+}
+function readRecordId(record) {
+  if (!record) {
+    return void 0;
+  }
+  const candidate = record._id ?? record.id ?? record.topicId ?? record.nodeId;
+  return isNonEmptyString(candidate) ? candidate : void 0;
+}
 function readTopicMappedProjectId(topic) {
   const metadata = topic.metadata || {};
   const candidate = metadata.legacyProjectId || metadata.projectId || metadata.scopeProjectId;
@@ -12070,27 +13026,23 @@ async function tryGetTopicById(topicId) {
     return null;
   }
   try {
-    const topic = await adminQuery(components2.lucern.topics.get, {
-      id: normalizedTopicId
-    });
-    return topic || null;
+    return unwrapGatewayData(await getLucernClient().topics.get(normalizedTopicId));
   } catch {
     return null;
   }
 }
 async function tryGetNodeById(nodeId) {
   try {
-    const node = await adminQuery(api2.epistemicNodes.getInternal, {
-      nodeId
-    });
-    return node || null;
+    return unwrapGatewayData(await getLucernClient().nodes.get({ nodeId }));
   } catch {
     return null;
   }
 }
 async function findTopicByMappedProjectId(legacyScopeId) {
   try {
-    const topics2 = await adminQuery(components2.lucern.topics.list, {});
+    const response = await getLucernClient().topics.list({});
+    const data = unwrapGatewayData(response);
+    const topics2 = Array.isArray(data?.topics) ? data.topics : Array.isArray(data?.items) ? data.items : [];
     return topics2.find((topic) => readTopicMappedProjectId(topic) === legacyScopeId) || null;
   } catch {
     return null;
@@ -12124,7 +13076,7 @@ async function resolveTopicScopeId(scopeId, toolName) {
   if (!resolved) {
     const mappedTopic = normalizedScopeId ? await findTopicByMappedProjectId(normalizedScopeId) : null;
     if (mappedTopic) {
-      resolved = String(mappedTopic._id);
+      resolved = readRecordId(mappedTopic);
     }
   }
   if (!resolved) {
@@ -12323,315 +13275,38 @@ var beliefHandlers = {
   }
 };
 
-// ../../apps/mcp-server/src/handlers/bootstrap-session.ts
-function slugify(name) {
-  return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 40);
+// ../../apps/mcp-server/src/handlers/bootstrap.ts
+function readString2(value) {
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
 }
-async function resolveBeliefs(nodeIds) {
-  const results = [];
-  for (const nodeId of nodeIds) {
-    try {
-      const node = await adminQuery(api2.epistemicNodes.get, {
-        nodeId
-      });
-      if (!node) {
-        continue;
-      }
-      results.push({
-        nodeId,
-        text: String(node.canonicalText || "").slice(0, 200),
-        confidence: typeof node.confidence === "number" ? node.confidence : null
-      });
-    } catch {
-    }
-  }
-  return results;
+function readNullableNumber(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : null;
 }
-async function resolveQuestions(nodeIds) {
-  const results = [];
-  for (const nodeId of nodeIds) {
-    try {
-      const node = await adminQuery(api2.epistemicNodes.get, {
-        nodeId
-      });
-      if (!node) {
-        continue;
-      }
-      const metadata = node.metadata || {};
-      results.push({
-        nodeId,
-        text: String(node.canonicalText || "").slice(0, 200),
-        status: String(metadata.questionStatus || node.status || "open"),
-        priority: String(metadata.priority || "medium")
-      });
-    } catch {
-    }
-  }
-  return results;
-}
-async function beginBuildSession(args) {
-  const worktreeId = typeof args.worktreeId === "string" ? args.worktreeId : void 0;
-  if (!worktreeId) {
-    throw new Error("[begin_build_session] worktreeId is required");
-  }
-  const branch = typeof args.branch === "string" && args.branch.trim().length > 0 ? args.branch.trim() : void 0;
-  const branchBase = typeof args.branchBase === "string" && args.branchBase.trim().length > 0 ? args.branchBase.trim() : "staging";
-  const prBase = typeof args.prBase === "string" && args.prBase.trim().length > 0 ? args.prBase.trim() : "staging";
-  const sessionMode = typeof args.sessionMode === "string" && args.sessionMode.trim().length > 0 ? args.sessionMode.trim() : "async";
-  const activateIfPlanning = args.activateIfPlanning !== false;
-  const worktree = await adminQuery(components2.lucern.worktrees.get, {
-    worktreeId
-  });
-  if (!worktree) {
-    throw new Error(`Worktree ${worktreeId} not found`);
-  }
-  const worktreeName = String(worktree.name || "Untitled");
-  const topicId = String(worktree.topicId || "");
-  const campaign = typeof worktree.campaign === "number" ? worktree.campaign : null;
-  const lane = String(worktree.lane || "unlaned");
-  const laneOrderInCampaign = typeof worktree.laneOrderInCampaign === "number" ? worktree.laneOrderInCampaign : null;
-  const orderInLane = typeof worktree.orderInLane === "number" ? worktree.orderInLane : null;
-  const gate = String(worktree.gate || "");
-  const hypothesis = String(worktree.hypothesis || worktree.beliefFocus || "");
-  let status = String(worktree.status || "planning");
-  const dependsOn = worktree.dependsOn || [];
-  const blocks = worktree.blocks || [];
-  const targetBeliefIds = worktree.targetBeliefIds || [];
-  const targetQuestionIds = worktree.targetQuestionIds || [];
-  if (activateIfPlanning && status === "planning") {
-    try {
-      await adminMutation(components2.lucern.worktrees.activate, {
-        worktreeId
-      });
-      status = "active";
-    } catch {
-    }
-  }
-  let topicName = "Unknown";
-  try {
-    const topic = await adminQuery(components2.lucern.topics.get, {
-      id: topicId
-    });
-    if (topic) {
-      topicName = String(topic.name || "Unknown");
-    }
-  } catch {
-  }
-  const allBeliefs = await resolveBeliefs(targetBeliefIds);
-  const topBeliefs = allBeliefs.slice().sort((left, right) => (right.confidence ?? -1) - (left.confidence ?? -1)).slice(0, 8);
-  const allQuestions = await resolveQuestions(targetQuestionIds);
-  const openQuestions = [];
-  const resolvedDecisions = [];
-  for (const question of allQuestions) {
-    const questionStatus = question.status.toLowerCase();
-    if (questionStatus === "answered" || questionStatus === "resolved") {
-      let decision = "(decision recorded \u2014 call get_answer for details)";
-      try {
-        const answer = await adminQuery(
-          api2.epistemicAnswers.getLatestForQuestion,
-          {
-            questionNodeId: question.nodeId
-          }
-        );
-        if (answer) {
-          decision = String(
-            answer.answerText || answer.canonicalText || decision
-          ).slice(0, 200);
-        }
-      } catch {
-        try {
-          const node = await adminQuery(api2.epistemicNodes.get, {
-            nodeId: question.nodeId
-          });
-          if (node?._id) {
-            const answer = await adminQuery(
-              api2.epistemicAnswers.getLatestForQuestion,
-              {
-                questionNodeId: node._id
-              }
-            );
-            if (answer) {
-              decision = String(
-                answer.answerText || answer.canonicalText || decision
-              ).slice(0, 200);
-            }
-          }
-        } catch {
-        }
-      }
-      resolvedDecisions.push({
-        question: question.text.slice(0, 150),
-        decision
-      });
-      continue;
-    }
-    openQuestions.push({
-      nodeId: question.nodeId,
-      text: question.text,
-      priority: question.priority
-    });
-  }
-  try {
-    const topicQuestions = await adminQuery(api2.epistemicQuestions.getByTopic, {
-      topicId,
-      userId: "system",
-      limit: 20
-    }).catch(() => []);
-    for (const question of Array.isArray(topicQuestions) ? topicQuestions : []) {
-      const metadata = question.metadata || {};
-      const questionStatus = String(
-        metadata.questionStatus || question.status || "open"
-      ).toLowerCase();
-      if ((questionStatus === "open" || questionStatus === "in_progress") && !targetQuestionIds.includes(String(question._id))) {
-        openQuestions.push({
-          nodeId: String(question._id),
-          text: String(question.canonicalText || "").slice(0, 200),
-          priority: String(metadata.priority || "medium")
-        });
-      }
-    }
-  } catch {
+function refreshLucernContextFromBuildSession(payload, args) {
+  if (!payload || typeof payload !== "object" || Array.isArray(payload)) {
+    return;
   }
-  const dependencies = [];
-  for (const dependencyId of dependsOn.slice(0, 5)) {
-    try {
-      const dependency = await adminQuery(components2.lucern.worktrees.get, {
-        worktreeId: dependencyId
-      });
-      dependencies.push({
-        worktreeId: dependencyId,
-        title: String(dependency?.name || "Unknown"),
-        status: String(dependency?.status || "unknown")
-      });
-    } catch {
-      dependencies.push({
-        worktreeId: dependencyId,
-        title: "Unknown",
-        status: "unknown"
-      });
-    }
-  }
-  const unblocks = [];
-  for (const blockedId of blocks.slice(0, 5)) {
-    try {
-      const blocked = await adminQuery(components2.lucern.worktrees.get, {
-        worktreeId: blockedId
-      });
-      unblocks.push({
-        worktreeId: blockedId,
-        title: String(blocked?.name || "Unknown")
-      });
-    } catch {
-      unblocks.push({
-        worktreeId: blockedId,
-        title: "Unknown"
-      });
-    }
-  }
-  const effectiveBranch = branch || `codex/${slugify(worktreeName)}`;
-  const incompleteDependencies = dependencies.filter(
-    (dependency) => dependency.status !== "completed" && dependency.status !== "merged"
-  );
-  const mergeOrderNotes = incompleteDependencies.length > 0 ? `Blocked by: ${incompleteDependencies.map((dependency) => dependency.title).join(", ")}` : "none";
-  const requiredDocs = [
-    "docs/api/EK-13-api-sdk-architecture.md",
-    "docs/api/EK-13.1.5-repo-architecture-blueprint.md",
-    "docs/api/EK-13.1-contract-authority.md",
-    "docs/development/handoff-contract.md"
-  ];
-  const focus = hypothesis ? `${hypothesis.split(".")[0]}.` : `Complete ${worktreeName}`;
-  const exitCriteria = gate ? [`Gate: ${gate}`] : [];
-  exitCriteria.push(
-    "All namespace surfaces end-to-end: contract \u2192 domain \u2192 HTTP \u2192 SDK \u2192 MCP \u2192 test",
-    "All code lands in target-state paths under lucern/",
-    "PR targets staging, not main"
-  );
-  const keyFiles = [
-    "app/api/platform/v1/_lib/gateway.ts",
-    "modules/access-control/src/principalContext.ts",
-    "lucern/packages/sdk/src/coreClient.ts",
-    "lucern/packages/sdk/src/identityClient.ts",
-    "lucern/contracts/src/sdk-methods.contract.ts",
-    "app/api/platform/v1/identity/"
-  ];
-  const pillarKeywords = [
-    "Pillar 1",
-    "Pillar 2",
-    "Pillar 3",
-    "Pillar 4",
-    "Pillar 5",
-    "Pillar 6",
-    "Pillar 7",
-    "Pillar 8",
-    "8 innovation pillars"
-  ];
-  const pillarBeliefs = [];
-  for (const belief of allBeliefs) {
-    for (const keyword of pillarKeywords) {
-      if (!belief.text.includes(keyword)) {
-        continue;
-      }
-      const pillarMatch = belief.text.match(/Pillar \d+ \([^)]+\)/);
-      pillarBeliefs.push({
-        pillar: pillarMatch ? pillarMatch[0] : keyword,
-        text: belief.text.slice(0, 250),
-        nodeId: belief.nodeId
-      });
-      break;
-    }
+  const record = payload;
+  const topicId = readString2(record.topicId);
+  const worktreeId = readString2(record.worktreeId) ?? readString2(args.worktreeId);
+  if (!topicId || !worktreeId) {
+    return;
   }
-  const visionDocs = [
-    {
-      path: "docs/product/core-value-propositions.md",
-      description: "8 innovation pillars through developer, marketing, and investor lenses"
-    },
-    {
-      path: "docs/product/five-domains.md",
-      description: "5 product domains: MC, Tenant, Developer, Reasoning Control, Reasoning"
-    },
-    {
-      path: "docs/product/innovation-pillars.md",
-      description: "The 8 pillars that define what makes Lucern unique"
-    },
-    {
-      path: "docs/product/vision-to-roadmap-bridge.md",
-      description: "Where each pillar is today vs. where it goes \u2014 the north star trajectory"
-    }
-  ];
-  return {
+  writeLucernJson({
     topicId,
-    topicName,
-    worktreeId,
-    worktreeName,
-    branch: effectiveBranch,
-    branchBase,
-    prBase,
-    campaign,
-    lane,
-    laneOrderInCampaign,
-    orderInLane,
-    gate,
-    hypothesis,
-    focus,
-    status,
-    sessionMode,
-    targetBeliefIds,
-    targetQuestionIds,
-    topBeliefs,
-    openQuestions,
-    resolvedDecisions,
-    exitCriteria,
-    requiredDocs,
-    keyFiles,
-    pillarBeliefs,
-    visionDocs,
-    dependencies,
-    unblocks,
-    mergeOrderNotes
-  };
+    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
+    }
+  });
 }
-
-// ../../apps/mcp-server/src/handlers/bootstrap.ts
 var bootstrapHandlers = {
   async generate_session_handoff(args, ctx) {
     return formatSdkResult(
@@ -12639,7 +13314,11 @@ var bootstrapHandlers = {
     );
   },
   async begin_build_session(args, ctx) {
-    return beginBuildSession(args);
+    const payload = formatSdkResult(
+      await getSdkClient(ctx).mcp.beginBuildSession(args)
+    );
+    refreshLucernContextFromBuildSession(payload, args);
+    return payload;
   }
 };
 
@@ -12995,19 +13674,16 @@ var engineeringVerificationHandlers = {
         "evaluate_engineering_contract requires at least one verification payload."
       );
     }
-    const result = await adminMutation(
-      "epistemicContracts:evaluateEngineeringContracts",
-      {
+    return formatSdkResult(
+      await getSdkClient(ctx).mcp.evaluateEngineeringContract({
         beliefNodeId: args.beliefNodeId,
         trigger: args.trigger,
         testOutput: args.testOutput,
         tscOutput: args.tscOutput,
         lintOutput: args.lintOutput,
-        sentryData: args.sentryData,
-        authenticatedUserId: ctx.userId
-      }
+        sentryData: args.sentryData
+      })
     );
-    return result;
   }
 };
 
@@ -13185,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(
@@ -13960,6 +14644,47 @@ var intelligenceHandlers = {
   get_graph_structure_analysis: graphHandlers.get_graph_structure_analysis,
   get_falsification_questions: graphHandlers.get_falsification_questions
 };
+var GLOBAL_KEY = "__LUCERN_SERVER_CORE_KERNEL_API_BINDING__";
+function store() {
+  return globalThis;
+}
+function getBinding() {
+  const current = store()[GLOBAL_KEY];
+  if (!current) {
+    throw new Error(
+      "Server-core kernelApi not registered. Call registerKernelApi({api, components, internal}) at host boot."
+    );
+  }
+  return current;
+}
+function readPath(root, path3) {
+  let cursor = root;
+  for (const part of path3) {
+    if (cursor == null || typeof cursor !== "object") {
+      return void 0;
+    }
+    cursor = cursor[part];
+  }
+  return cursor;
+}
+function resolveApiPath(binding, which, path3) {
+  return readPath(binding[which], path3);
+}
+function makeProxy(which, path3 = []) {
+  return new Proxy({}, {
+    get(_target, prop) {
+      if (typeof prop !== "string") {
+        return void 0;
+      }
+      const nextPath = [...path3, prop];
+      const resolved = resolveApiPath(getBinding(), which, nextPath);
+      return resolved === void 0 ? makeProxy(which, nextPath) : resolved;
+    }
+  });
+}
+var api = makeProxy("api");
+makeProxy("components");
+makeProxy("internal");
 
 // ../server-core/src/mcp-context-tools.ts
 function requireMcpConvex(authContext, label) {
@@ -14012,7 +14737,7 @@ function getConvex(ctx) {
   }
   return requireMcpConvex(ctx, "topic-resolver");
 }
-function readString2(value) {
+function readString3(value) {
   if (typeof value !== "string") {
     return void 0;
   }
@@ -14023,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;
   }
@@ -14041,7 +14766,7 @@ function normalizeTopicId(value) {
   }
 }
 function normalizeExternalId(value, prefix) {
-  const normalized = readString2(value);
+  const normalized = readString3(value);
   if (!normalized) {
     return void 0;
   }
@@ -14063,7 +14788,7 @@ function normalizeToken(value) {
   return normalized;
 }
 function tokenize(value) {
-  const normalized = readString2(value);
+  const normalized = readString3(value);
   if (!normalized) {
     return [];
   }
@@ -14178,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) {
@@ -14221,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) {
@@ -14240,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;
@@ -14302,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);
   }
@@ -14318,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);
   }
@@ -14327,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),
@@ -14347,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.");
@@ -14367,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.");
   }
@@ -15025,16 +15771,16 @@ function buildInputData(args) {
 var researchVerificationHandlers = {
   async evaluate_research_contract(args, ctx) {
     const inputData = buildInputData(args);
-    const result = await adminMutation(
-      api2.contracts.evaluateContractsForTrigger,
-      {
+    return formatSdkResult(
+      await getSdkClient(ctx).mcp.evaluateResearchContract({
         beliefNodeId: args.beliefNodeId,
         trigger: typeof args.trigger === "string" && args.trigger.length > 0 ? args.trigger : "event_driven",
-        ...inputData ? { inputData } : {},
-        authenticatedUserId: ctx.userId
-      }
+        metricData: inputData?.metricData,
+        referenceCheckData: inputData?.referenceCheckData,
+        marketIndexData: inputData?.marketIndexData,
+        temporalData: inputData?.temporalData
+      })
     );
-    return result;
   }
 };
 
@@ -15214,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));
@@ -15409,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
         }
       )
     );
@@ -15586,6 +16345,20 @@ function recordWrite(toolName, topicId, sessionId = "default") {
   existing.push(record);
   sessionWritesBySession.set(sessionId, existing);
 }
+async function checkGatewayWritePolicy(args) {
+  const client = args.authCtx.lucernClient;
+  const checkWritePolicy2 = client?.mcp?.checkWritePolicy;
+  if (!checkWritePolicy2) {
+    throw new Error("Lucern SDK MCP write-policy client is not initialized.");
+  }
+  const response = await checkWritePolicy2({
+    topicId: args.topicId,
+    workspaceId: args.authCtx.workspaceId,
+    role: args.authCtx.role,
+    toolName: args.toolName
+  });
+  return response.data ?? null;
+}
 function buildRateLimitExplanation(args) {
   const summary = `Denied ${args.toolName}: session write limit ${args.currentCount}/${args.maxWritesPerSession} reached for the matched write policy.`;
   return {
@@ -15623,10 +16396,10 @@ async function checkWritePolicy(toolName, topicId, authCtx) {
     return { allowed: true, permission: "allow", reason: "read_only_tool" };
   }
   try {
-    const result = await adminQuery("mcpWritePolicy:checkAccess", {
+    const result = await checkGatewayWritePolicy({
       topicId: topicId ?? void 0,
-      role: authCtx.role,
-      toolName
+      toolName,
+      authCtx
     });
     if (!result) {
       return {
@@ -15692,9 +16465,11 @@ async function checkWritePolicy(toolName, topicId, authCtx) {
     };
   }
 }
+
+// ../../apps/mcp-server/src/credentials.ts
 var LUCERN_HOME = path2.join(os.homedir(), ".lucern");
 path2.join(LUCERN_HOME, "credentials");
 
-export { buildHandlerMap, checkWritePolicy, createAdminClient, isMutationTool, recordWrite, runWithScopedClient };
+export { buildHandlerMap, checkWritePolicy, isMutationTool, recordWrite };
 //# sourceMappingURL=runtime.js.map
 //# sourceMappingURL=runtime.js.map