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

package/dist/gateway.js

@@ -1890,6 +1890,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",
@@ -3846,7 +3880,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(),
@@ -5043,6 +5079,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",
@@ -5056,14 +5100,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"
@@ -5092,9 +5209,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"],
@@ -5124,7 +5249,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" }
   },
@@ -8143,6 +8268,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,
@@ -8236,6 +8424,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,
@@ -8449,6 +8638,7 @@ var PLATFORM_INTERNAL_OPERATION_NAMES = [
   "get_change_history",
   "get_failure_log",
   "record_attempt",
+  "begin_build_session",
   "push",
   "open_pull_request",
   "record_judgment",
@@ -8503,7 +8693,6 @@ var SDK_ONLY_OPERATION_NAMES = [
   "find_semantic_orphans"
 ];
 var MCP_ONLY_INTERNAL_OPERATION_NAMES = [
-  "begin_build_session",
   "evaluate_engineering_contract",
   "evaluate_research_contract"
 ];
@@ -8889,8 +9078,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,
@@ -8949,7 +9161,8 @@ var contextContracts = [
         observationId: output && typeof output === "object" ? output.nodeId : void 0,
         observationType: input.observationType
       })
-    }
+    },
+    args: observationArgs
   }),
   surfaceContract({
     name: "get_observation_context",
@@ -8970,7 +9183,8 @@ var contextContracts = [
         status: input.status,
         userId: input.userId
       })
-    }
+    },
+    args: observationContextArgs
   })
 ];
 
@@ -9033,8 +9247,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
@@ -9109,7 +9360,8 @@ var beliefsContracts = [
       functionName: "create",
       kind: "mutation",
       inputProjection: createBeliefInput
-    }
+    },
+    args: createBeliefArgs
   }),
   surfaceContract({
     name: "get_belief",
@@ -9200,7 +9452,8 @@ var beliefsContracts = [
       functionName: "forkBelief",
       kind: "mutation",
       inputProjection: forkBeliefInput
-    }
+    },
+    args: forkBeliefArgs
   }),
   surfaceContract({
     name: "archive_belief",
@@ -9281,8 +9534,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,
@@ -9357,7 +9648,8 @@ var evidenceContracts = [
       functionName: "create",
       kind: "mutation",
       inputProjection: createEvidenceInput
-    }
+    },
+    args: createEvidenceArgs
   }),
   surfaceContract({
     name: "add_evidence",
@@ -9393,7 +9685,8 @@ var evidenceContracts = [
           context
         );
       }
-    }
+    },
+    args: addEvidenceArgs
   }),
   surfaceContract({
     name: "get_evidence",
@@ -9500,8 +9793,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
@@ -9548,7 +9924,8 @@ var questionsContracts = [
       functionName: "create",
       kind: "mutation",
       inputProjection: createQuestionInput
-    }
+    },
+    args: createQuestionArgs
   }),
   surfaceContract({
     name: "get_question",
@@ -9604,7 +9981,8 @@ var questionsContracts = [
         category: input.category,
         priority: input.priority
       })
-    }
+    },
+    args: refineQuestionArgs
   }),
   surfaceContract({
     name: "update_question_status",
@@ -9680,7 +10058,8 @@ var questionsContracts = [
         }),
         context
       )
-    }
+    },
+    args: createAnswerArgs
   }),
   surfaceContract({
     name: "answer_question",
@@ -9709,7 +10088,8 @@ var questionsContracts = [
         }),
         context
       )
-    }
+    },
+    args: answerQuestionArgs
   }),
   surfaceContract({
     name: "get_answer",
@@ -9741,7 +10121,8 @@ var questionsContracts = [
       functionName: "getByTopic",
       kind: "query",
       inputProjection: questionTopicInput
-    }
+    },
+    args: missingQuestionsArgs
   }),
   surfaceContract({
     name: "get_high_priority_questions",
@@ -9776,11 +10157,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
 });
@@ -9861,7 +10253,8 @@ var topicsContracts = [
       functionName: "update",
       kind: "mutation",
       inputProjection: updateTopicInput
-    }
+    },
+    args: updateTopicArgs
   }),
   surfaceContract({
     name: "get_topic_tree",
@@ -9880,8 +10273,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,
@@ -9918,7 +10330,8 @@ var lensesContracts = [
       functionName: "create",
       kind: "mutation",
       inputProjection: createLensInput
-    }
+    },
+    args: createLensArgs
   }),
   surfaceContract({
     name: "list_lenses",
@@ -9980,8 +10393,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
 });
@@ -10060,11 +10483,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",
@@ -10147,7 +10570,8 @@ var ontologiesContracts = [
       functionName: "publishOntologyVersion",
       kind: "mutation",
       inputProjection: ontologyVersionIdInput
-    }
+    },
+    args: ontologyVersionLifecycleArgs
   }),
   surfaceContract({
     name: "deprecate_ontology_version",
@@ -10163,7 +10587,8 @@ var ontologiesContracts = [
       functionName: "deprecateOntologyVersion",
       kind: "mutation",
       inputProjection: ontologyVersionIdInput
-    }
+    },
+    args: ontologyVersionLifecycleArgs
   }),
   surfaceContract({
     name: "resolve_effective_ontology",
@@ -10182,8 +10607,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
 });
@@ -10216,6 +10709,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,
@@ -10223,6 +10760,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",
@@ -10239,13 +10786,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,
@@ -10271,12 +10817,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",
@@ -10388,7 +10934,8 @@ var worktreesContracts = [
       functionName: "updateMetadata",
       kind: "mutation",
       inputProjection: worktreeMetadataInput
-    }
+    },
+    args: worktreeMetadataArgs
   }),
   surfaceContract({
     name: "merge",
@@ -10406,9 +10953,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 ?? []
         },
@@ -10430,7 +10975,8 @@ var worktreesContracts = [
       functionName: "updateMetadata",
       kind: "mutation",
       inputProjection: worktreeMetadataInput
-    }
+    },
+    args: pushArgs
   }),
   surfaceContract({
     name: "open_pull_request",
@@ -10446,7 +10992,8 @@ var worktreesContracts = [
       functionName: "updateMetadata",
       kind: "mutation",
       inputProjection: worktreeMetadataInput
-    }
+    },
+    args: openPullRequestArgs
   })
 ];
 
@@ -10550,6 +11097,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;
@@ -10620,11 +11176,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":
@@ -10679,7 +11283,8 @@ var graphContracts = [
       functionName: "getLineage",
       kind: "query",
       inputProjection: lineageInput
-    }
+    },
+    args: traverseGraphArgs
   }),
   surfaceContract({
     name: "get_graph_neighborhood",
@@ -10695,7 +11300,8 @@ var graphContracts = [
       functionName: "getByTopic",
       kind: "query",
       inputProjection: topicEdgesInput
-    }
+    },
+    args: graphNeighborhoodArgs
   }),
   surfaceContract({
     name: "get_graph_structure_analysis",
@@ -10744,7 +11350,8 @@ var graphContracts = [
       functionName: "create",
       kind: "mutation",
       inputProjection: flagContradictionInput
-    }
+    },
+    args: flagContradictionArgs
   }),
   surfaceContract({
     name: "detect_confirmation_bias",
@@ -10835,7 +11442,8 @@ var graphContracts = [
       functionName: "getLineage",
       kind: "query",
       inputProjection: lineageInput
-    }
+    },
+    args: discoverEntityConnectionsArgs
   }),
   surfaceContract({
     name: "trigger_belief_review",
@@ -10866,7 +11474,8 @@ var graphContracts = [
       functionName: "getLineage",
       kind: "query",
       inputProjection: lineageInput
-    }
+    },
+    args: lineageArgs
   })
 ];
 
@@ -10918,8 +11527,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",
@@ -10974,7 +11591,8 @@ var judgmentsContracts = [
         minLayer: input.minLayer,
         maxLayer: input.maxLayer
       })
-    }
+    },
+    args: auditTrailArgs
   })
 ];
 
@@ -11142,8 +11760,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",
@@ -11164,7 +11787,8 @@ var pipelineContracts = [
         campaign: input.campaign,
         limit: input.limit
       })
-    }
+    },
+    args: pipelineSnapshotArgs
   }),
   surfaceContract({
     name: "seed_belief_lattice",
@@ -11216,7 +11840,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;
@@ -11333,7 +11981,8 @@ var codingContracts = [
         status: input.status,
         userId: input.userId
       })
-    }
+    },
+    args: codeContextArgs
   }),
   surfaceContract({
     name: "get_change_history",
@@ -11370,7 +12019,8 @@ var codingContracts = [
       functionName: "create",
       kind: "mutation",
       inputProjection: attemptInput
-    }
+    },
+    args: recordAttemptArgs
   }),
   surfaceContract({
     name: "get_failure_log",
@@ -11734,34 +12384,638 @@ function rankEntityTypeMatches(inputText, entityTypes, options) {
   return matches;
 }
 
-// ../contracts/src/v1/topics/v1.ts
-var ROOT_TOPIC_ID = "n17tm38rwet7wqgzrmwahyt1z582590y";
-
-// ../server-core/src/errors/server-errors.ts
-var ServerCoreError = class extends Error {
-  constructor(status, code, message, options) {
-    super(message);
-    this.status = status;
-    this.code = code;
-    this.name = "ServerCoreError";
-    this.details = options?.details;
-  }
-  status;
-  code;
-  details;
-};
-var VALID_CODES = /* @__PURE__ */ new Set([
-  "AUTH_REQUIRED",
-  "AUTHENTICATION_REQUIRED",
-  "AUTH_TOKEN_MISSING",
-  "INVALID_REQUEST",
-  "IDEMPOTENCY_KEY_REQUIRED",
-  "FORBIDDEN",
-  "SCOPE_INSUFFICIENT",
-  "ENVIRONMENT_MISMATCH",
-  "KEY_EXPIRED",
-  "KEY_REVOKED",
-  "RATE_LIMIT_EXCEEDED",
+// ../contracts/src/tenant-bootstrap-seed.contract.ts
+function isCopyableSeedRequirement(entry) {
+  return (entry.copyMode === "template_global" || entry.copyMode === "template_tenant_rewrite" || entry.copyMode === "template_reference_remap") && Boolean(entry.scope) && Array.isArray(entry.uniqueKey) && entry.uniqueKey.length > 0;
+}
+var TENANT_BOOTSTRAP_TABLE_REQUIREMENTS = [
+  {
+    component: "kernel",
+    table: "agentMessages",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Agent coordination messages are session data, not template data."
+  },
+  {
+    component: "kernel",
+    table: "agentSessions",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Agent coordination sessions are created by active clients."
+  },
+  {
+    component: "kernel",
+    table: "autofixJobs",
+    prepopulation: "runtime_queue",
+    copyMode: "none",
+    description: "Autofix work items are runtime queue rows."
+  },
+  {
+    component: "kernel",
+    table: "backgroundJobRuns",
+    prepopulation: "runtime_log",
+    copyMode: "none",
+    description: "Background job executions are runtime logs."
+  },
+  {
+    component: "kernel",
+    table: "backgroundJobSettings",
+    prepopulation: "required_template",
+    copyMode: "template_global",
+    scope: "global",
+    uniqueKey: ["jobKey"],
+    description: "Default job enablement settings must come from the K template."
+  },
+  {
+    component: "kernel",
+    table: "beliefConfidence",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Belief confidence rows are created with tenant graph facts."
+  },
+  {
+    component: "kernel",
+    table: "beliefEvidenceLinks",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Belief-to-evidence links are tenant graph data."
+  },
+  {
+    component: "kernel",
+    table: "beliefHistory",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Belief history is append-only tenant graph data."
+  },
+  {
+    component: "kernel",
+    table: "beliefScenarios",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Scenario rows are tenant-authored reasoning data."
+  },
+  {
+    component: "kernel",
+    table: "beliefVotes",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Decision belief votes are tenant-authored data."
+  },
+  {
+    component: "kernel",
+    table: "calibrationScores",
+    prepopulation: "runtime_derived",
+    copyMode: "none",
+    description: "Calibration scores are computed from tenant outcomes."
+  },
+  {
+    component: "kernel",
+    table: "contractEvaluations",
+    prepopulation: "runtime_log",
+    copyMode: "none",
+    description: "Contract evaluation rows are runtime computation logs."
+  },
+  {
+    component: "kernel",
+    table: "contradictions",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Contradictions are tenant graph facts."
+  },
+  {
+    component: "kernel",
+    table: "crossProjectConnections",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Cross-topic connections are tenant graph facts."
+  },
+  {
+    component: "kernel",
+    table: "decisionComputedSummaries",
+    prepopulation: "runtime_derived",
+    copyMode: "none",
+    description: "Decision summaries are derived tenant outputs."
+  },
+  {
+    component: "kernel",
+    table: "decisionEvents",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Decision events are lifecycle data."
+  },
+  {
+    component: "kernel",
+    table: "decisionParticipants",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Decision participants are tenant-selected actors."
+  },
+  {
+    component: "kernel",
+    table: "decisionRiskLedger",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Decision risk rows are tenant decision data."
+  },
+  {
+    component: "kernel",
+    table: "decisionSnapshots",
+    prepopulation: "runtime_derived",
+    copyMode: "none",
+    description: "Decision snapshots are derived from tenant state."
+  },
+  {
+    component: "kernel",
+    table: "deliberationContributions",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Deliberation contributions are tenant-authored data."
+  },
+  {
+    component: "kernel",
+    table: "deliberationSessions",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Deliberation sessions are created by tenant workflows."
+  },
+  {
+    component: "kernel",
+    table: "epistemicAudit",
+    prepopulation: "runtime_log",
+    copyMode: "none",
+    description: "Epistemic audit rows are append-only runtime audit data."
+  },
+  {
+    component: "kernel",
+    table: "epistemicContracts",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Epistemic contracts are tenant-authored governance data."
+  },
+  {
+    component: "kernel",
+    table: "epistemicEdges",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Edges are tenant reasoning graph data."
+  },
+  {
+    component: "kernel",
+    table: "epistemicNodeEmbeddings",
+    prepopulation: "runtime_derived",
+    copyMode: "none",
+    description: "Embeddings are derived from tenant graph nodes."
+  },
+  {
+    component: "kernel",
+    table: "epistemicNodes",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Nodes are tenant reasoning graph data."
+  },
+  {
+    component: "kernel",
+    table: "graphAnalysisCache",
+    prepopulation: "runtime_derived",
+    copyMode: "none",
+    description: "Graph analysis cache rows are derived from tenant graph state."
+  },
+  {
+    component: "kernel",
+    table: "graphAnalysisResults",
+    prepopulation: "runtime_derived",
+    copyMode: "none",
+    description: "Graph analysis result rows are derived tenant outputs."
+  },
+  {
+    component: "kernel",
+    table: "graphSuggestions",
+    prepopulation: "runtime_derived",
+    copyMode: "none",
+    description: "Graph suggestions are derived recommendations."
+  },
+  {
+    component: "kernel",
+    table: "harnessReplays",
+    prepopulation: "runtime_log",
+    copyMode: "none",
+    description: "Harness replay rows are runtime verification logs."
+  },
+  {
+    component: "kernel",
+    table: "harnessRuns",
+    prepopulation: "runtime_log",
+    copyMode: "none",
+    description: "Harness run rows are runtime verification logs."
+  },
+  {
+    component: "kernel",
+    table: "idempotencyTokens",
+    prepopulation: "runtime_log",
+    copyMode: "none",
+    description: "Idempotency tokens are request-scoped runtime guards."
+  },
+  {
+    component: "kernel",
+    table: "lenses",
+    prepopulation: "optional_template",
+    copyMode: "none",
+    description: "Reusable lens templates may live in K templates, but workspace-specific copies are not required for core SDK boot."
+  },
+  {
+    component: "kernel",
+    table: "lensTopicBindings",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Lens bindings attach runtime topics to runtime/workspace lenses."
+  },
+  {
+    component: "kernel",
+    table: "neo4jSyncQueue",
+    prepopulation: "runtime_queue",
+    copyMode: "none",
+    description: "Neo4j sync queue rows are runtime work items."
+  },
+  {
+    component: "kernel",
+    table: "ontologyDefinitions",
+    prepopulation: "required_template",
+    copyMode: "template_global",
+    scope: "global",
+    uniqueKey: ["ontologyKey"],
+    description: "Platform ontology definitions power taxonomy reads and effective ontology resolution."
+  },
+  {
+    component: "kernel",
+    table: "ontologyVersions",
+    prepopulation: "required_template",
+    copyMode: "template_reference_remap",
+    scope: "global",
+    uniqueKey: ["ontologyKey", "version"],
+    dependsOn: ["ontologyDefinitions"],
+    description: "Ontology versions must be copied with ontologyDefinition ID remapping."
+  },
+  {
+    component: "kernel",
+    table: "platformAgentRunPolicyDecisions",
+    prepopulation: "runtime_log",
+    copyMode: "none",
+    description: "Agent-run policy decisions are audit logs."
+  },
+  {
+    component: "kernel",
+    table: "platformAgentRunPromptResolutions",
+    prepopulation: "runtime_log",
+    copyMode: "none",
+    description: "Agent-run prompt resolution rows are runtime logs."
+  },
+  {
+    component: "kernel",
+    table: "platformAgentRuns",
+    prepopulation: "runtime_log",
+    copyMode: "none",
+    description: "Agent runs are runtime execution records."
+  },
+  {
+    component: "kernel",
+    table: "platformAgentRunToolCalls",
+    prepopulation: "runtime_log",
+    copyMode: "none",
+    description: "Agent-run tool calls are runtime execution records."
+  },
+  {
+    component: "kernel",
+    table: "platformHarnessShadowAudit",
+    prepopulation: "runtime_log",
+    copyMode: "none",
+    description: "Harness shadow audit rows are runtime audit records."
+  },
+  {
+    component: "kernel",
+    table: "publicationRules",
+    prepopulation: "required_template",
+    copyMode: "template_tenant_rewrite",
+    scope: "tenant",
+    uniqueKey: ["tenantId", "workspaceId", "name"],
+    description: "Default publication policy rules are rewritten into each tenant."
+  },
+  {
+    component: "kernel",
+    table: "questionEvidenceLinks",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Question-to-evidence links are tenant graph data."
+  },
+  {
+    component: "kernel",
+    table: "researchJobs",
+    prepopulation: "runtime_queue",
+    copyMode: "none",
+    description: "Research job rows are runtime queue items."
+  },
+  {
+    component: "kernel",
+    table: "schemaEnumConfig",
+    prepopulation: "required_template",
+    copyMode: "template_global",
+    scope: "global",
+    uniqueKey: ["category", "value"],
+    description: "Runtime-extensible enum defaults required by SDK graph APIs."
+  },
+  {
+    component: "kernel",
+    table: "stakeholderGroups",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Stakeholder groups are tenant decision data."
+  },
+  {
+    component: "kernel",
+    table: "systemLogs",
+    prepopulation: "runtime_log",
+    copyMode: "none",
+    description: "System logs are runtime telemetry."
+  },
+  {
+    component: "kernel",
+    table: "tasks",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Tasks are tenant-authored work items."
+  },
+  {
+    component: "kernel",
+    table: "topics",
+    prepopulation: "runtime_bootstrap",
+    copyMode: "none",
+    description: "Default topics are created by tenant provisioning, not copied from templates."
+  },
+  {
+    component: "kernel",
+    table: "workflowDefinitions",
+    prepopulation: "optional_template",
+    copyMode: "none",
+    description: "Table-driven workflow definitions can be template data after the workflow engine leaves legacy mode."
+  },
+  {
+    component: "kernel",
+    table: "workflowPullRequests",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Workflow pull requests are tenant workflow data."
+  },
+  {
+    component: "kernel",
+    table: "workflowStages",
+    prepopulation: "optional_template",
+    copyMode: "none",
+    dependsOn: ["workflowDefinitions"],
+    description: "Workflow stages can be template data after workflowDefinitions are enabled for bootstrap copying."
+  },
+  {
+    component: "kernel",
+    table: "worktreeBeliefCluster",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Worktree cluster rows link runtime worktrees to runtime beliefs."
+  },
+  {
+    component: "kernel",
+    table: "worktrees",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Worktrees are tenant/runtime planning data."
+  },
+  {
+    component: "identity",
+    table: "agents",
+    prepopulation: "runtime_bootstrap",
+    copyMode: "none",
+    description: "Service agents are provisioned per tenant or service, not copied."
+  },
+  {
+    component: "identity",
+    table: "mcpWritePolicy",
+    prepopulation: "required_template",
+    copyMode: "template_global",
+    scope: "global",
+    uniqueKey: ["topicId", "role", "toolCategory"],
+    description: "Global write policy defaults govern service and interactive MCP writes."
+  },
+  {
+    component: "identity",
+    table: "modelCallLogs",
+    prepopulation: "runtime_log",
+    copyMode: "none",
+    description: "Model call logs are runtime telemetry."
+  },
+  {
+    component: "identity",
+    table: "modelFunctionSlots",
+    prepopulation: "required_template",
+    copyMode: "template_global",
+    scope: "global",
+    uniqueKey: ["slot"],
+    description: "Function-to-model slots are required by model runtime resolution."
+  },
+  {
+    component: "identity",
+    table: "modelRegistry",
+    prepopulation: "required_template",
+    copyMode: "template_global",
+    scope: "global",
+    uniqueKey: ["key"],
+    description: "Model catalog defaults are required by model runtime clients."
+  },
+  {
+    component: "identity",
+    table: "modelSlotConfigs",
+    prepopulation: "required_template",
+    copyMode: "template_global",
+    scope: "global",
+    uniqueKey: ["slot"],
+    description: "Slot-level defaults are required before tenant overrides exist."
+  },
+  {
+    component: "identity",
+    table: "platformAudienceGrants",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Audience grants are principal/group-specific access rows."
+  },
+  {
+    component: "identity",
+    table: "platformAudiences",
+    prepopulation: "required_template",
+    copyMode: "template_tenant_rewrite",
+    scope: "tenant",
+    uniqueKey: ["tenantId", "workspaceId", "audienceKey"],
+    description: "Default tenant audience taxonomy rows are rewritten into each tenant."
+  },
+  {
+    component: "identity",
+    table: "platformPolicyDecisionLogs",
+    prepopulation: "runtime_log",
+    copyMode: "none",
+    description: "Policy decisions are runtime audit logs."
+  },
+  {
+    component: "identity",
+    table: "projectGrants",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Project/topic grants are principal or group-specific access rows."
+  },
+  {
+    component: "identity",
+    table: "reasoningPermissions",
+    prepopulation: "runtime_data",
+    copyMode: "none",
+    description: "Reasoning permissions are principal-specific policy rows."
+  },
+  {
+    component: "identity",
+    table: "tenantApiKeys",
+    prepopulation: "runtime_secret",
+    copyMode: "none",
+    description: "API keys are tenant credentials and must never be copied."
+  },
+  {
+    component: "identity",
+    table: "tenantConfig",
+    prepopulation: "required_template",
+    copyMode: "template_tenant_rewrite",
+    scope: "tenant",
+    uniqueKey: ["tenantId"],
+    description: "Tenant-local config defaults are rewritten during bootstrap."
+  },
+  {
+    component: "identity",
+    table: "tenantIntegrations",
+    prepopulation: "required_template",
+    copyMode: "template_tenant_rewrite",
+    scope: "tenant",
+    uniqueKey: ["tenantId", "integrationKey"],
+    description: "Non-secret integration descriptors are rewritten into each tenant."
+  },
+  {
+    component: "identity",
+    table: "tenantModelSlotBindings",
+    prepopulation: "runtime_secret",
+    copyMode: "none",
+    description: "Tenant model slot bindings reference provider secrets and are runtime-only."
+  },
+  {
+    component: "identity",
+    table: "tenantPolicies",
+    prepopulation: "required_template",
+    copyMode: "template_tenant_rewrite",
+    scope: "tenant",
+    uniqueKey: ["tenantId", "workspaceId", "roleName"],
+    description: "Default tenant policy roles are rewritten during bootstrap."
+  },
+  {
+    component: "identity",
+    table: "tenantProviderSecrets",
+    prepopulation: "runtime_secret",
+    copyMode: "none",
+    description: "Provider secrets are credentials and must never be copied."
+  },
+  {
+    component: "identity",
+    table: "tenantProxyGatewayUsage",
+    prepopulation: "runtime_log",
+    copyMode: "none",
+    description: "Proxy gateway usage rows are runtime telemetry."
+  },
+  {
+    component: "identity",
+    table: "tenantProxyTokenMints",
+    prepopulation: "runtime_secret",
+    copyMode: "none",
+    description: "Proxy token mints are ephemeral secret-bearing runtime rows."
+  },
+  {
+    component: "identity",
+    table: "tenantSandboxAuditEvents",
+    prepopulation: "runtime_log",
+    copyMode: "none",
+    description: "Sandbox audit rows are runtime security logs."
+  },
+  {
+    component: "identity",
+    table: "tenantSecrets",
+    prepopulation: "runtime_secret",
+    copyMode: "none",
+    description: "Tenant secrets are credentials and must never be copied."
+  },
+  {
+    component: "identity",
+    table: "toolAcls",
+    prepopulation: "required_template",
+    copyMode: "template_global",
+    scope: "global",
+    uniqueKey: ["role", "toolName"],
+    description: "Default role-to-tool grants are required for SDK/MCP tool access."
+  },
+  {
+    component: "identity",
+    table: "toolRegistry",
+    prepopulation: "required_template",
+    copyMode: "template_global",
+    scope: "global",
+    uniqueKey: ["toolName"],
+    description: "Core tool catalog rows are required before pack or tenant tools exist."
+  },
+  {
+    component: "identity",
+    table: "users",
+    prepopulation: "runtime_bootstrap",
+    copyMode: "none",
+    description: "Users are created from Clerk/MC principal resolution, not copied."
+  }
+];
+TENANT_BOOTSTRAP_TABLE_REQUIREMENTS.filter(
+  isCopyableSeedRequirement
+);
+TENANT_BOOTSTRAP_TABLE_REQUIREMENTS.filter(
+  (entry) => !isCopyableSeedRequirement(entry)
+).map((entry) => entry.table);
+
+// ../contracts/src/v1/topics/v1.ts
+var ROOT_TOPIC_ID = "n17tm38rwet7wqgzrmwahyt1z582590y";
+
+// ../server-core/src/errors/server-errors.ts
+var ServerCoreError = class extends Error {
+  constructor(status, code, message, options) {
+    super(message);
+    this.status = status;
+    this.code = code;
+    this.name = "ServerCoreError";
+    this.details = options?.details;
+  }
+  status;
+  code;
+  details;
+};
+var GatewayAuthError = class extends ServerCoreError {
+  constructor(status, code, message, options) {
+    super(status, code, message, options);
+    this.name = "GatewayAuthError";
+  }
+};
+var VALID_CODES = /* @__PURE__ */ new Set([
+  "AUTH_REQUIRED",
+  "AUTHENTICATION_REQUIRED",
+  "AUTH_TOKEN_MISSING",
+  "INVALID_REQUEST",
+  "IDEMPOTENCY_KEY_REQUIRED",
+  "FORBIDDEN",
+  "SCOPE_INSUFFICIENT",
+  "ENVIRONMENT_MISMATCH",
+  "KEY_EXPIRED",
+  "KEY_REVOKED",
+  "RATE_LIMIT_EXCEEDED",
   "NOT_FOUND",
   "CONFLICT",
   "UPSTREAM_ERROR",
@@ -13334,11 +14588,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 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.");
   }
@@ -16244,6 +17519,56 @@ function readString12(value) {
 function readNumber7(value) {
   return typeof value === "number" && Number.isFinite(value) ? value : void 0;
 }
+function normalizeLimit(value, fallback, max) {
+  const parsed = readNumber7(value);
+  if (parsed === void 0) {
+    return fallback;
+  }
+  return Math.max(1, Math.min(Math.floor(parsed), max));
+}
+function matchesOptionalString(actual, expected) {
+  if (!expected) {
+    return true;
+  }
+  return readString12(actual) === expected;
+}
+function normalizeGraphNode2(row) {
+  const record = asRecord10(row);
+  const nodeId = readString12(record.nodeId) ?? readString12(record._id);
+  const globalId = readString12(record.globalId);
+  const text = readString12(record.text) ?? readString12(record.canonicalText);
+  return {
+    ...record,
+    ...nodeId ? { nodeId } : {},
+    ...globalId ? { globalId } : {},
+    ...text ? { text, canonicalText: text } : {}
+  };
+}
+function normalizeGraphEdge2(row) {
+  const record = asRecord10(row);
+  const edgeId = readString12(record.edgeId) ?? readString12(record._id);
+  return {
+    ...record,
+    ...edgeId ? { edgeId } : {},
+    fromNodeId: readString12(record.fromNodeId) ?? readString12(record.sourceGlobalId),
+    toNodeId: readString12(record.toNodeId) ?? readString12(record.targetGlobalId)
+  };
+}
+async function fetchGraphNodeByIdentifier(authContext, input) {
+  if (input.nodeId) {
+    const node = await authContext.convex.query(api.epistemicNodes.get, {
+      nodeId: input.nodeId
+    });
+    return node ? normalizeGraphNode2(node) : null;
+  }
+  if (input.globalId) {
+    const node = await authContext.convex.query(api.epistemicNodes.getByGlobalId, {
+      globalId: input.globalId
+    });
+    return node ? normalizeGraphNode2(node) : null;
+  }
+  return null;
+}
 function inferRiskLevel(score, threshold) {
   if (score >= Math.max(threshold + 0.2, 0.9)) {
     return "critical";
@@ -16455,6 +17780,45 @@ function graphGapsFromGatewayAuth(authContext, input) {
 function graphFalsifyFromGatewayAuth(authContext, input) {
   return graphFalsify(createGatewayGraphPort(authContext), input);
 }
+async function listGraphNodesFromGatewayAuth(authContext, input) {
+  if (input.nodeId || input.globalId) {
+    const node = await fetchGraphNodeByIdentifier(authContext, input);
+    if (!node) {
+      return { items: [], nodes: [], total: 0 };
+    }
+    if (input.topicId && readString12(node.topicId) !== input.topicId) {
+      return { items: [], nodes: [], total: 0 };
+    }
+    if (!matchesOptionalString(node.nodeType, input.nodeType)) {
+      return { items: [], nodes: [], total: 0 };
+    }
+    return { items: [node], nodes: [node], total: 1 };
+  }
+  const topicId = readString12(input.topicId) ?? readString12(input.projectId);
+  if (!topicId) {
+    throw new Error("[graph] topicId is required to list graph nodes.");
+  }
+  const rows = await authContext.convex.query(api.epistemicNodes.getByTopic, {
+    topicId,
+    userId: authContext.userId,
+    limit: normalizeLimit(input.limit, 250, 1e3)
+  });
+  const nodes = asRecordArray2(rows).map(normalizeGraphNode2).filter((node) => matchesOptionalString(node.nodeType, input.nodeType));
+  return { items: nodes, nodes, total: nodes.length };
+}
+async function listGraphEdgesFromGatewayAuth(authContext, input) {
+  const topicId = readString12(input.topicId) ?? readString12(input.projectId);
+  if (!topicId) {
+    throw new Error("[graph] topicId is required to list graph edges.");
+  }
+  const rows = await authContext.convex.query(api.epistemicEdges.getByTopic, {
+    topicId,
+    userId: authContext.userId,
+    limit: normalizeLimit(input.limit, 500, 2e3)
+  });
+  const edges = asRecordArray2(rows).map(normalizeGraphEdge2).filter((edge) => matchesOptionalString(edge.edgeId, input.edgeId)).filter((edge) => matchesOptionalString(edge.fromNodeId, input.fromNodeId)).filter((edge) => matchesOptionalString(edge.toNodeId, input.toNodeId)).filter((edge) => matchesOptionalString(edge.edgeType, input.edgeType));
+  return { items: edges, edges, total: edges.length };
+}
 
 // ../server-core/src/auth/gateway-claims.ts
 function lastDelegator(delegationChain) {
@@ -16478,7 +17842,8 @@ function resolveGatewayClaims(authContext) {
         principalType: "human",
         tenantId: authContext.tenantId ?? authContext.servicePrincipalTenantId ?? "unknown",
         workspaceId: authContext.workspaceId ?? authContext.servicePrincipalWorkspaceId,
-        roles: [],
+        roles: authContext.roles ?? [],
+        membershipId: authContext.membershipId,
         scopes: [...authContext.grantedScopes],
         authMode: "interactive_user",
         sessionId: authContext.sessionId,
@@ -16493,6 +17858,7 @@ function resolveGatewayClaims(authContext) {
         tenantId: authContext.tenantId ?? authContext.servicePrincipalTenantId ?? "unknown",
         workspaceId: authContext.workspaceId ?? authContext.servicePrincipalWorkspaceId,
         roles: ["service_agent"],
+        membershipId: authContext.membershipId,
         scopes: [...authContext.grantedScopes],
         authMode: "service_principal",
         sessionId: authContext.sessionId,
@@ -16507,6 +17873,7 @@ function resolveGatewayClaims(authContext) {
         tenantId: authContext.tenantId ?? authContext.servicePrincipalTenantId ?? "unknown",
         workspaceId: authContext.workspaceId ?? authContext.servicePrincipalWorkspaceId,
         roles: ["service_agent"],
+        membershipId: authContext.membershipId,
         scopes: [...authContext.grantedScopes],
         authMode: "tenant_api_key",
         sessionId: authContext.sessionId,
@@ -16521,6 +17888,7 @@ function resolveGatewayClaims(authContext) {
         tenantId: authContext.tenantId ?? "unknown",
         workspaceId: authContext.workspaceId,
         roles: authContext.roles ?? [],
+        membershipId: authContext.membershipId,
         scopes: [...authContext.grantedScopes],
         authMode: "session_token",
         sessionId: authContext.sessionId,
@@ -18303,23 +19671,118 @@ function readStringArray9(value) {
   const normalized = value.map((entry) => readString19(entry)).filter((entry) => Boolean(entry));
   return normalized.length > 0 ? normalized : void 0;
 }
-function compareNullableNumber(left, right, fallback = 9999) {
-  return (left ?? fallback) - (right ?? fallback);
-}
-function requireString3(value, field) {
-  const normalized = readString19(value);
-  if (!normalized) {
-    throw createWorktreesError({
-      message: `[worktrees] ${field} is required.`,
-      status: 400,
-      code: "INVALID_REQUEST",
-      invariantCode: "request.valid_shape",
-      suggestion: `Provide ${field} in the request payload.`
-    });
+function normalizeKeyQuestions(keyQuestions) {
+  if (!Array.isArray(keyQuestions)) {
+    return void 0;
   }
-  return normalized;
+  const normalized = keyQuestions.map((entry) => {
+    const question = readString19(entry.question);
+    if (!question) {
+      return void 0;
+    }
+    return {
+      question,
+      ...entry.status ? { status: entry.status } : {},
+      ...readString19(entry.answer) ? { answer: readString19(entry.answer) } : {},
+      ...entry.answerConfidence ? { answerConfidence: entry.answerConfidence } : {},
+      ...readString19(entry.linkedQuestionId) ? {
+        linkedQuestionId: decodeExternalId9(
+          readString19(entry.linkedQuestionId),
+          "que",
+          "keyQuestions.linkedQuestionId"
+        )
+      } : {}
+    };
+  }).filter((entry) => Boolean(entry));
+  return normalized.length > 0 ? normalized : void 0;
 }
-function decodeExternalId9(id, prefix, field) {
+function normalizeEvidenceSignals(evidenceSignals) {
+  if (!Array.isArray(evidenceSignals)) {
+    return void 0;
+  }
+  const normalized = evidenceSignals.map((entry) => {
+    const signal = readString19(entry.signal);
+    if (!signal) {
+      return void 0;
+    }
+    return {
+      signal,
+      ...typeof entry.collected === "boolean" ? { collected: entry.collected } : {},
+      ...readString19(entry.progress) ? { progress: readString19(entry.progress) } : {},
+      ...readString19(entry.notes) ? { notes: readString19(entry.notes) } : {}
+    };
+  }).filter((entry) => Boolean(entry));
+  return normalized.length > 0 ? normalized : void 0;
+}
+function normalizeDecisionGate(input) {
+  const source = input.decisionGate ?? (input.goCriteria || input.noGoSignals ? {
+    goCriteria: input.goCriteria ?? [],
+    noGoSignals: input.noGoSignals ?? []
+  } : void 0);
+  if (!source) {
+    return void 0;
+  }
+  return {
+    goCriteria: readStringArray9(source.goCriteria) ?? [],
+    noGoSignals: readStringArray9(source.noGoSignals) ?? [],
+    ...source.verdict ? { verdict: source.verdict } : {},
+    ...readString19(source.verdictRationale) ? { verdictRationale: readString19(source.verdictRationale) } : {},
+    ...typeof source.decidedAt === "number" && Number.isFinite(source.decidedAt) ? { decidedAt: source.decidedAt } : {},
+    ...readString19(source.decidedBy) ? { decidedBy: readString19(source.decidedBy) } : {}
+  };
+}
+function normalizeMergeOutcomes(outcomes) {
+  const keyFindings = [];
+  const scoringOutcomes = [];
+  for (const outcome of outcomes) {
+    const finding = readString19(outcome);
+    if (finding) {
+      keyFindings.push(finding);
+      continue;
+    }
+    const record = asRecord15(outcome);
+    if (!Object.keys(record).length) {
+      throw createWorktreesError({
+        message: "[worktrees] merge outcomes must be strings or { beliefId, confidence, rationale } objects.",
+        status: 400,
+        code: "INVALID_REQUEST",
+        invariantCode: "request.valid_shape",
+        suggestion: "Pass string outcomes for key findings, or scoring objects for belief confidence outcomes."
+      });
+    }
+    scoringOutcomes.push({
+      beliefId: requireString3(record.beliefId, "outcomes[].beliefId"),
+      confidence: readNumber13(record.confidence) ?? (() => {
+        throw createWorktreesError({
+          message: "[worktrees] outcomes[].confidence must be a finite number.",
+          status: 400,
+          code: "INVALID_REQUEST",
+          invariantCode: "request.valid_shape",
+          suggestion: "Provide confidence as a number when scoring a belief outcome."
+        });
+      })(),
+      rationale: requireString3(record.rationale, "outcomes[].rationale")
+    });
+  }
+  return { keyFindings, scoringOutcomes };
+}
+function compareNullableNumber(left, right, fallback = 9999) {
+  return (left ?? fallback) - (right ?? fallback);
+}
+function requireString3(value, field) {
+  const normalized = readString19(value);
+  if (!normalized) {
+    throw createWorktreesError({
+      message: `[worktrees] ${field} is required.`,
+      status: 400,
+      code: "INVALID_REQUEST",
+      invariantCode: "request.valid_shape",
+      suggestion: `Provide ${field} in the request payload.`
+    });
+  }
+  return normalized;
+}
+function decodeExternalId9(id, prefix, field) {
   const normalized = requireString3(id, field);
   try {
     const decoded = decodePrefixedId(normalized);
@@ -18547,14 +20010,33 @@ function buildWorktreeCampaignList(records) {
 }
 async function createWorktree(deps, input) {
   const topicRawId = decodeExternalId9(input.topicId, "top", "topicId");
+  const targetBeliefIds = input.targetBeliefIds ?? input.beliefIds;
   const created = await deps.createWorktree({
     title: requireString3(input.title, "title"),
     topicRawId,
     objective: readString19(input.objective),
     hypothesis: readString19(input.hypothesis),
-    beliefRawIds: input.beliefIds?.map(
+    rationale: readString19(input.rationale),
+    worktreeType: readString19(input.worktreeType),
+    startDate: typeof input.startDate === "number" && Number.isFinite(input.startDate) ? input.startDate : void 0,
+    endDate: typeof input.endDate === "number" && Number.isFinite(input.endDate) ? input.endDate : void 0,
+    durationWeeks: typeof input.durationWeeks === "number" && Number.isFinite(input.durationWeeks) ? input.durationWeeks : void 0,
+    confidenceImpact: input.confidenceImpact,
+    beliefFocus: readString19(input.beliefFocus),
+    beliefRawIds: targetBeliefIds?.map(
       (id) => decodeExternalId9(id, "bel", "beliefIds")
     ),
+    targetBeliefRawIds: input.targetBeliefIds?.map(
+      (id) => decodeExternalId9(id, "bel", "targetBeliefIds")
+    ),
+    targetQuestionRawIds: input.targetQuestionIds?.map(
+      (id) => decodeExternalId9(id, "que", "targetQuestionIds")
+    ),
+    keyQuestions: normalizeKeyQuestions(input.keyQuestions),
+    evidenceSignals: normalizeEvidenceSignals(input.evidenceSignals),
+    decisionGate: normalizeDecisionGate(input),
+    goCriteria: readStringArray9(input.goCriteria),
+    noGoSignals: readStringArray9(input.noGoSignals),
     autoShape: typeof input.autoShape === "boolean" ? input.autoShape : void 0,
     domainPackId: readString19(input.domainPackId),
     campaign: typeof input.campaign === "number" && Number.isFinite(input.campaign) ? input.campaign : void 0,
@@ -18686,11 +20168,45 @@ async function updateWorktreeTargets(deps, input) {
 }
 async function mergeWorktree(deps, input) {
   const rawId = decodeExternalId9(input.id, "wt", "id");
-  const summary = readString19(input.summary) ?? "Worktree merged.";
-  await deps.completeWorktree({ worktreeRawId: rawId, summary });
+  const { keyFindings, scoringOutcomes } = normalizeMergeOutcomes(input.outcomes);
+  const summary = readString19(input.summary) ?? keyFindings[0] ?? "Worktree merged.";
+  const completeKeyFindings = keyFindings.length > 0 ? keyFindings : [summary];
+  const worktree = await deps.fetchWorktree(rawId);
+  if (!worktree) {
+    throw createWorktreesError({
+      message: `[worktrees] Worktree not found: ${rawId}.`,
+      status: 404,
+      code: "NOT_FOUND",
+      invariantCode: "resource.exists"
+    });
+  }
+  const worktreeStatus = readString19(asRecord15(worktree).status);
+  if (worktreeStatus === "planning") {
+    await deps.activateWorktree({ worktreeRawId: rawId });
+    await deps.completeWorktree({
+      worktreeRawId: rawId,
+      summary,
+      keyFindings: completeKeyFindings
+    });
+  } else if (!worktreeStatus || worktreeStatus === "active") {
+    await deps.completeWorktree({
+      worktreeRawId: rawId,
+      summary,
+      keyFindings: completeKeyFindings
+    });
+  } else if (worktreeStatus !== "completed" && worktreeStatus !== "merged") {
+    throw createWorktreesError({
+      message: `[worktrees] Cannot merge worktree in status "${worktreeStatus}".`,
+      status: 409,
+      code: "CONFLICT",
+      invariantCode: "worktree.mergeable_status",
+      suggestion: "Merge only planning, active, completed, or already-merged worktrees.",
+      details: { worktreeId: encodeWorktreeId(rawId), status: worktreeStatus }
+    });
+  }
   const failedBeliefs = [];
   let beliefsScored = 0;
-  for (const outcome of input.outcomes) {
+  for (const outcome of scoringOutcomes) {
     try {
       await deps.scoreBeliefOutcome({
         worktreeRawId: rawId,
@@ -18766,15 +20282,35 @@ function summarizeWorktreeCollection(rows) {
 function buildCreateMutationArgs(input, userId) {
   const objective = input.objective?.trim();
   const hypothesis = input.hypothesis?.trim();
+  const rationale = input.rationale?.trim();
+  const worktreeType = input.worktreeType?.trim();
+  const beliefFocus = input.beliefFocus?.trim();
   const gate = input.gate?.trim();
   const lensId = input.lensId?.trim();
+  const targetBeliefIds = input.targetBeliefIds && input.targetBeliefIds.length > 0 ? input.targetBeliefIds : input.beliefIds;
   return {
     name: input.title,
     topicId: input.topicId,
     createdBy: userId,
     ...objective ? { objective } : {},
     ...hypothesis ? { hypothesis } : {},
-    ...objective || hypothesis ? { beliefFocus: hypothesis ?? objective } : {},
+    ...rationale ? { rationale } : {},
+    ...worktreeType ? { worktreeType } : {},
+    ...typeof input.startDate === "number" ? { startDate: input.startDate } : {},
+    ...typeof input.endDate === "number" ? { endDate: input.endDate } : {},
+    ...typeof input.durationWeeks === "number" ? { durationWeeks: input.durationWeeks } : {},
+    ...input.confidenceImpact ? { confidenceImpact: input.confidenceImpact } : {},
+    ...beliefFocus || objective || hypothesis ? { beliefFocus: beliefFocus ?? hypothesis ?? objective } : {},
+    ...Array.isArray(input.targetQuestionIds) && input.targetQuestionIds.length > 0 ? { targetQuestionIds: input.targetQuestionIds.map((id) => id) } : Array.isArray(input.questionRawIds) && input.questionRawIds.length > 0 ? { targetQuestionIds: input.questionRawIds.map((id) => id) } : {},
+    ...Array.isArray(targetBeliefIds) && targetBeliefIds.length > 0 ? { targetBeliefIds: targetBeliefIds.map((id) => id) } : {},
+    ...Array.isArray(input.keyQuestions) && input.keyQuestions.length > 0 ? { keyQuestions: input.keyQuestions } : {},
+    ...Array.isArray(input.evidenceSignals) && input.evidenceSignals.length > 0 ? { evidenceSignals: input.evidenceSignals } : {},
+    ...input.decisionGate ? { decisionGate: input.decisionGate } : input.goCriteria || input.noGoSignals ? {
+      decisionGate: {
+        goCriteria: input.goCriteria ?? [],
+        noGoSignals: input.noGoSignals ?? []
+      }
+    } : {},
     ...typeof input.campaign === "number" ? { campaign: input.campaign } : {},
     ...input.lane ? { lane: input.lane } : {},
     ...typeof input.laneOrderInCampaign === "number" ? { laneOrderInCampaign: input.laneOrderInCampaign } : {},
@@ -18783,7 +20319,10 @@ function buildCreateMutationArgs(input, userId) {
     ...Array.isArray(input.blocks) && input.blocks.length > 0 ? { blocks: input.blocks.map((id) => id) } : {},
     ...gate ? { gate } : {},
     ...lensId ? { lensId } : {},
-    ...Array.isArray(input.beliefIds) && input.beliefIds.length > 0 ? { targetBeliefIds: input.beliefIds.map((id) => id) } : {}
+    ...Array.isArray(input.proofArtifacts) ? { proofArtifacts: input.proofArtifacts } : {},
+    ...input.staffingHint?.trim() ? { staffingHint: input.staffingHint.trim() } : {},
+    ...typeof input.lastReconciledAt === "number" ? { lastReconciledAt: input.lastReconciledAt } : {},
+    ...input.autoFixPolicy ? { autoFixPolicy: input.autoFixPolicy } : {}
   };
 }
 function readString20(value) {
@@ -18856,7 +20395,9 @@ function createGatewayWorktreesPort(authContext) {
             ...input,
             topicId: input.topicRawId,
             title: input.title,
-            beliefIds: input.beliefRawIds
+            beliefIds: input.beliefRawIds,
+            targetBeliefIds: input.targetBeliefRawIds,
+            targetQuestionIds: input.targetQuestionRawIds
           },
           authContext.userId
         ),
@@ -18871,7 +20412,9 @@ function createGatewayWorktreesPort(authContext) {
           ...input,
           topicId: input.topicRawId,
           title: input.title,
-          beliefIds: input.beliefRawIds
+          beliefIds: input.beliefRawIds,
+          targetBeliefIds: input.targetBeliefRawIds,
+          targetQuestionIds: input.targetQuestionRawIds
         },
         authContext.userId
       ));
@@ -18899,7 +20442,7 @@ function createGatewayWorktreesPort(authContext) {
     completeWorktree(args) {
       return authContext.convex.mutation(api.worktrees.complete, {
         worktreeId: args.worktreeRawId,
-        keyFindings: [args.summary],
+        keyFindings: args.keyFindings?.length ? args.keyFindings : [args.summary],
         decisionsReached: [],
         nextSteps: [],
         userId: authContext.userId
@@ -20454,6 +21997,44 @@ async function handleGraphNeighborhood(args) {
     );
   }
 }
+async function handleGraphNodeList(args) {
+  try {
+    const payload = await listGraphNodesFromGatewayAuth(
+      args.authContext,
+      args.query
+    );
+    return successResponse(payload, {
+      correlationId: args.correlationId,
+      policyTraceId: args.policyTraceId
+    });
+  } catch (error) {
+    return handleGraphError(
+      error,
+      "Failed to list graph nodes.",
+      args.correlationId,
+      args.policyTraceId
+    );
+  }
+}
+async function handleGraphEdgeList(args) {
+  try {
+    const payload = await listGraphEdgesFromGatewayAuth(
+      args.authContext,
+      args.query
+    );
+    return successResponse(payload, {
+      correlationId: args.correlationId,
+      policyTraceId: args.policyTraceId
+    });
+  } catch (error) {
+    return handleGraphError(
+      error,
+      "Failed to list graph edges.",
+      args.correlationId,
+      args.policyTraceId
+    );
+  }
+}
 async function handleGraphTraverse(args) {
   const body = asRecord20(args.body);
   if (!readString25(body.startNode)) {
@@ -20595,6 +22176,516 @@ async function handleGraphFalsify(args) {
   }
 }
 
+// ../server-core/src/graph-analysis.ts
+function cleanString(value) {
+  if (typeof value !== "string") {
+    return void 0;
+  }
+  const normalized = value.trim();
+  return normalized.length > 0 ? normalized : void 0;
+}
+function cleanNumber(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+function cleanStringArray(value) {
+  if (!Array.isArray(value)) {
+    return void 0;
+  }
+  const normalized = value.map((entry) => cleanString(entry)).filter((entry) => Boolean(entry));
+  return normalized.length > 0 ? normalized : void 0;
+}
+function asRecord21(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function asRecordArray3(value) {
+  return Array.isArray(value) ? value.filter(
+    (entry) => Boolean(entry) && typeof entry === "object" && !Array.isArray(entry)
+  ) : [];
+}
+function requireString4(value, label) {
+  const normalized = cleanString(value);
+  if (!normalized) {
+    throw new Error(`${label} is required`);
+  }
+  return normalized;
+}
+function requireMatchingTenantScope(authContext, input) {
+  const tenantId = requireString4(input.tenantId, "tenantId");
+  const workspaceId = requireString4(input.workspaceId, "workspaceId");
+  if (authContext.tenantId && authContext.tenantId !== tenantId) {
+    throw new GatewayAuthError(
+      403,
+      "FORBIDDEN",
+      "Requested tenantId does not match the authenticated Lucern tenant context."
+    );
+  }
+  if (authContext.workspaceId && authContext.workspaceId !== workspaceId) {
+    throw new GatewayAuthError(
+      403,
+      "FORBIDDEN",
+      "Requested workspaceId does not match the authenticated Lucern workspace context."
+    );
+  }
+  return { tenantId, workspaceId };
+}
+function readLimit(value) {
+  const parsed = cleanNumber(value);
+  if (parsed === void 0) {
+    return void 0;
+  }
+  return Math.max(1, Math.min(Math.floor(parsed), 200));
+}
+function publicSuggestionStatus(status) {
+  const normalized = cleanString(status);
+  if (normalized === "pending") {
+    return "open";
+  }
+  if (normalized === "declined") {
+    return "dismissed";
+  }
+  return normalized;
+}
+function normalizeSuggestion(row) {
+  return {
+    ...row,
+    suggestionId: cleanString(row.suggestionId) ?? cleanString(row.recommendationId),
+    recommendationId: cleanString(row.recommendationId) ?? cleanString(row.suggestionId),
+    status: publicSuggestionStatus(row.status)
+  };
+}
+function normalizeRecommendation(row) {
+  const suggestion = normalizeSuggestion(row);
+  return {
+    ...suggestion,
+    recommendationId: cleanString(suggestion.recommendationId) ?? cleanString(suggestion.suggestionId)
+  };
+}
+function readChangeTimestamp(row) {
+  return cleanNumber(row.updatedAt) ?? cleanNumber(row.actedAt) ?? cleanNumber(row.createdAt);
+}
+function includesAny(value, expected) {
+  if (!expected || expected.length === 0) {
+    return true;
+  }
+  if (Array.isArray(value)) {
+    return value.some((entry) => expected.includes(String(entry)));
+  }
+  return typeof value === "string" && expected.includes(value);
+}
+function normalizeGraphChange(row, kind) {
+  const metadata = asRecord21(row.metadata);
+  const sourceNodeIds = cleanStringArray(row.sourceNodeIds) ?? cleanStringArray(row.targetNodeIds) ?? [
+    cleanString(row.targetNodeId),
+    cleanString(row.secondaryNodeId),
+    cleanString(row.resultNodeId)
+  ].filter((value) => Boolean(value));
+  const sourceEdgeIds = cleanStringArray(row.sourceEdgeIds) ?? [];
+  return {
+    changeId: cleanString(row.changeId) ?? cleanString(row.suggestionId) ?? cleanString(row.analysisId) ?? cleanString(row.recommendationId) ?? cleanString(row._id),
+    analysisId: cleanString(row.analysisId) ?? cleanString(row.analysisResultId) ?? cleanString(row._id),
+    suggestionId: cleanString(row.suggestionId),
+    topicId: cleanString(row.topicId),
+    workspaceId: cleanString(row.workspaceId),
+    changeType: cleanString(row.changeType) ?? kind,
+    nodeIds: sourceNodeIds,
+    edgeIds: sourceEdgeIds,
+    summary: cleanString(row.summary) ?? cleanString(row.title) ?? cleanString(row.analysisText) ?? cleanString(row.rationale),
+    metadata,
+    createdAt: readChangeTimestamp(row)
+  };
+}
+function normalizeNodeResult(row, input) {
+  const metadata = asRecord21(row.metadata);
+  const confidence = cleanNumber(row.confidence) ?? cleanNumber(metadata.confidence) ?? cleanNumber(row.baseRate);
+  return {
+    nodeId: cleanString(row.globalId) ?? cleanString(row.nodeId) ?? String(row._id ?? ""),
+    globalId: cleanString(row.globalId),
+    topicId: cleanString(row.topicId),
+    sourceWorkspaceId: cleanString(row.workspaceId) ?? cleanString(metadata.workspaceId) ?? cleanString(input.workspaceId),
+    publishedAt: cleanNumber(metadata.publishedAt),
+    publishedByPrincipalId: cleanString(metadata.publishedByPrincipalId),
+    visibility: cleanString(metadata.visibility) ?? "workspace",
+    confidence: confidence ?? null,
+    confidenceHistory: Array.isArray(metadata.confidenceHistory) ? metadata.confidenceHistory : void 0,
+    provenance: {
+      scope: cleanString(input.provenanceScope) ?? "own_workspace",
+      sourceWorkspaceId: cleanString(metadata.sourceWorkspaceId) ?? cleanString(input.workspaceId),
+      publishedAt: cleanNumber(metadata.publishedAt),
+      publishedByPrincipalId: cleanString(metadata.publishedByPrincipalId),
+      metadata: metadata.provenance
+    },
+    nodeType: cleanString(row.nodeType),
+    text: cleanString(row.canonicalText) ?? cleanString(row.text) ?? cleanString(row.title),
+    title: cleanString(row.title),
+    metadata
+  };
+}
+function filterNodeResults(rows, input) {
+  const nodeTypes = new Set(cleanStringArray(input.nodeTypes) ?? []);
+  const minConfidence = cleanNumber(input.minConfidence);
+  return rows.map((row) => normalizeNodeResult(row, input)).filter((row) => {
+    const nodeType = cleanString(row.nodeType);
+    if (nodeTypes.size > 0 && (!nodeType || !nodeTypes.has(nodeType))) {
+      return false;
+    }
+    if (minConfidence !== void 0 && (typeof row.confidence !== "number" || row.confidence < minConfidence)) {
+      return false;
+    }
+    return true;
+  });
+}
+async function saveGraphAnalysisFromGatewayAuth(authContext, input) {
+  return await authContext.convex.mutation(
+    api.graphAnalysisResults.saveAnalysis,
+    {
+      ...input,
+      topicId: requireString4(input.topicId, "topicId"),
+      workspaceId: requireString4(input.workspaceId, "workspaceId"),
+      userId: authContext.userId
+    }
+  );
+}
+async function listGraphAnalysesFromGatewayAuth(authContext, input) {
+  const analyses = await authContext.convex.query(
+    api.graphAnalysisResults.listAnalyses,
+    {
+      topicId: requireString4(input.topicId, "topicId"),
+      workspaceId: cleanString(input.workspaceId),
+      analysisType: cleanString(input.analysisType),
+      limit: readLimit(input.limit),
+      userId: authContext.userId
+    }
+  );
+  return { analyses: Array.isArray(analyses) ? analyses : [] };
+}
+async function getLatestGraphAnalysisFromGatewayAuth(authContext, input) {
+  return await authContext.convex.query(
+    api.graphAnalysisResults.getLatestAnalysis,
+    {
+      topicId: requireString4(input.topicId, "topicId"),
+      workspaceId: cleanString(input.workspaceId),
+      analysisType: cleanString(input.analysisType),
+      userId: authContext.userId
+    }
+  );
+}
+async function saveGraphSuggestionsFromGatewayAuth(authContext, input) {
+  const suggestions = await authContext.convex.mutation(
+    api.graphAnalysisResults.saveSuggestions,
+    {
+      ...input,
+      topicId: requireString4(input.topicId, "topicId"),
+      workspaceId: requireString4(input.workspaceId, "workspaceId"),
+      userId: authContext.userId
+    }
+  );
+  return {
+    suggestions: Array.isArray(suggestions) ? suggestions.map((row) => normalizeSuggestion(asRecord21(row))) : []
+  };
+}
+async function listGraphSuggestionsFromGatewayAuth(authContext, input) {
+  const suggestions = await authContext.convex.query(
+    api.graphAnalysisResults.listSuggestions,
+    {
+      topicId: requireString4(input.topicId, "topicId"),
+      workspaceId: cleanString(input.workspaceId),
+      analysisId: cleanString(input.analysisId),
+      findingId: cleanString(input.findingId),
+      status: cleanString(input.status),
+      limit: readLimit(input.limit),
+      userId: authContext.userId
+    }
+  );
+  return {
+    suggestions: Array.isArray(suggestions) ? suggestions.map((row) => normalizeSuggestion(asRecord21(row))) : []
+  };
+}
+async function listGraphChangesFromGatewayAuth(authContext, input) {
+  const minimumCreatedAt = cleanNumber(input.minimumCreatedAt) ?? cleanNumber(input.since) ?? cleanNumber(input.createdAt) ?? cleanNumber(input.analysisCreatedAt);
+  if (minimumCreatedAt === void 0) {
+    throw new Error("minimumCreatedAt is required");
+  }
+  const sourceNodeIds = cleanStringArray(input.sourceNodeIds) ?? (cleanString(input.nodeId) ? [cleanString(input.nodeId)] : void 0);
+  const sourceEdgeIds = cleanStringArray(input.sourceEdgeIds) ?? (cleanString(input.edgeId) ? [cleanString(input.edgeId)] : void 0);
+  const limit = readLimit(input.limit) ?? 100;
+  const [{ analyses }, { suggestions }] = await Promise.all([
+    listGraphAnalysesFromGatewayAuth(authContext, input),
+    listGraphSuggestionsFromGatewayAuth(authContext, input)
+  ]);
+  const analysisChanges = analyses.map((row) => normalizeGraphChange(asRecord21(row), "analysis_recorded")).filter((row) => {
+    const createdAt = cleanNumber(row.createdAt);
+    return createdAt !== void 0 && createdAt >= minimumCreatedAt && includesAny(row.nodeIds, sourceNodeIds) && includesAny(row.edgeIds, sourceEdgeIds);
+  });
+  const suggestionChanges = suggestions.map((row) => normalizeGraphChange(asRecord21(row), "suggestion_recorded")).filter((row) => {
+    const createdAt = cleanNumber(row.createdAt);
+    return createdAt !== void 0 && createdAt >= minimumCreatedAt && includesAny(row.nodeIds, sourceNodeIds) && includesAny(row.edgeIds, sourceEdgeIds);
+  });
+  const changes = [...analysisChanges, ...suggestionChanges].sort((left, right) => {
+    const leftAt = cleanNumber(left.createdAt) ?? 0;
+    const rightAt = cleanNumber(right.createdAt) ?? 0;
+    return rightAt - leftAt;
+  }).slice(0, limit);
+  return {
+    changes,
+    items: changes,
+    total: changes.length
+  };
+}
+async function updateGraphSuggestionStatusFromGatewayAuth(authContext, input) {
+  const suggestion = await authContext.convex.mutation(
+    api.graphAnalysisResults.updateSuggestionStatus,
+    {
+      suggestionId: requireString4(input.suggestionId, "suggestionId"),
+      status: requireString4(input.status, "status"),
+      rationale: cleanString(input.rationale),
+      metadata: input.metadata,
+      userId: authContext.userId
+    }
+  );
+  return normalizeSuggestion(asRecord21(suggestion));
+}
+async function computeOrRequestGraphAnalysisFromGatewayAuth(authContext, input) {
+  const topicId = requireString4(input.topicId, "topicId");
+  const analysisType = cleanString(input.analysisType) ?? "structure_analysis";
+  const analysis = await graphAnalyzeFromGatewayAuth(authContext, {
+    topicId,
+    metric: analysisType
+  });
+  const payload = asRecord21(analysis.payload);
+  return {
+    analysisId: `computed:${topicId}:${analysisType}`,
+    topicId,
+    workspaceId: requireString4(input.workspaceId, "workspaceId"),
+    analysisType,
+    healthScore: cleanNumber(payload.healthScore),
+    findings: asRecordArray3(payload.findings),
+    suggestions: [],
+    sourceNodeIds: cleanStringArray(input.sourceNodeIds) ?? [],
+    sourceEdgeIds: cleanStringArray(input.sourceEdgeIds) ?? [],
+    detectorVersions: asRecord21(input.detectorVersions),
+    metadata: asRecord21(input.metadata),
+    createdAt: Date.now()
+  };
+}
+async function listGraphRecommendationsFromGatewayAuth(authContext, input) {
+  const { suggestions } = await listGraphSuggestionsFromGatewayAuth(authContext, input);
+  return {
+    recommendations: suggestions.map((row) => normalizeRecommendation(row))
+  };
+}
+async function getGraphRecommendationFromGatewayAuth(authContext, recommendationId) {
+  const recommendation = await authContext.convex.query(
+    api.graphAnalysisResults.getSuggestion,
+    {
+      suggestionId: recommendationId,
+      userId: authContext.userId
+    }
+  );
+  return normalizeRecommendation(asRecord21(recommendation));
+}
+async function markGraphRecommendationStatusFromGatewayAuth(authContext, input) {
+  const updated = await updateGraphSuggestionStatusFromGatewayAuth(authContext, {
+    suggestionId: requireString4(input.recommendationId, "recommendationId"),
+    status: requireString4(input.status, "status"),
+    rationale: cleanString(input.rationale),
+    metadata: input.metadata
+  });
+  return normalizeRecommendation(updated);
+}
+async function searchOrgGraphFromGatewayAuth(authContext, input) {
+  requireMatchingTenantScope(authContext, input);
+  const query = requireString4(input.query, "query");
+  const rows = await authContext.convex.query(api.nodes.search, {
+    searchQuery: query,
+    limit: readLimit(input.limit)
+  });
+  return {
+    results: filterNodeResults(Array.isArray(rows) ? rows : [], input)
+  };
+}
+async function getOrgGraphNodeFromGatewayAuth(authContext, input) {
+  requireMatchingTenantScope(authContext, input);
+  const nodeId = cleanString(input.nodeId);
+  const globalId = cleanString(input.globalId) ?? nodeId;
+  if (!globalId) {
+    throw new Error("nodeId or globalId is required");
+  }
+  const node = await authContext.convex.query(api.nodes.getByGlobalId, {
+    globalId
+  });
+  return normalizeNodeResult(asRecord21(node), input);
+}
+async function listOrgGraphByProvenanceFromGatewayAuth(authContext, input) {
+  requireMatchingTenantScope(authContext, input);
+  requireString4(input.provenanceScope, "provenanceScope");
+  const rows = await authContext.convex.query(api.nodes.listAll, {
+    limit: readLimit(input.limit)
+  });
+  return {
+    results: filterNodeResults(Array.isArray(rows) ? rows : [], input)
+  };
+}
+async function listPublishedOrgGraphFromGatewayAuth(authContext, input) {
+  return listOrgGraphByProvenanceFromGatewayAuth(authContext, {
+    ...input,
+    provenanceScope: "published"
+  });
+}
+
+// ../../apps/gateway/src/routes/graph-analysis.ts
+function asRecord22(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function routeError(error, fallbackMessage, correlationId, policyTraceId) {
+  const resolved = resolveServerCoreError(error, fallbackMessage);
+  return errorResponse({
+    code: resolved.code,
+    message: resolved.message,
+    status: resolved.status,
+    correlationId,
+    policyTraceId,
+    invariant: resolved.invariant,
+    suggestion: resolved.suggestion,
+    details: resolved.details
+  });
+}
+async function withGraphRoute(args) {
+  try {
+    const payload = await args.run();
+    return successResponse(payload, {
+      correlationId: args.correlationId,
+      policyTraceId: args.policyTraceId
+    });
+  } catch (error) {
+    return routeError(
+      error,
+      args.fallbackMessage,
+      args.correlationId,
+      args.policyTraceId
+    );
+  }
+}
+async function handleGraphAnalysisSave(args) {
+  return withGraphRoute({
+    ...args,
+    fallbackMessage: "Failed to save graph analysis.",
+    run: () => saveGraphAnalysisFromGatewayAuth(args.authContext, asRecord22(args.body))
+  });
+}
+async function handleGraphAnalysisList(args) {
+  return withGraphRoute({
+    ...args,
+    fallbackMessage: "Failed to list graph analyses.",
+    run: () => listGraphAnalysesFromGatewayAuth(args.authContext, args.query)
+  });
+}
+async function handleGraphAnalysisLatest(args) {
+  return withGraphRoute({
+    ...args,
+    fallbackMessage: "Failed to fetch latest graph analysis.",
+    run: () => getLatestGraphAnalysisFromGatewayAuth(args.authContext, args.query)
+  });
+}
+async function handleGraphAnalysisSaveSuggestions(args) {
+  return withGraphRoute({
+    ...args,
+    fallbackMessage: "Failed to save graph suggestions.",
+    run: () => saveGraphSuggestionsFromGatewayAuth(args.authContext, asRecord22(args.body))
+  });
+}
+async function handleGraphAnalysisListSuggestions(args) {
+  return withGraphRoute({
+    ...args,
+    fallbackMessage: "Failed to list graph suggestions.",
+    run: () => listGraphSuggestionsFromGatewayAuth(args.authContext, args.query)
+  });
+}
+async function handleGraphAnalysisListChanges(args) {
+  return withGraphRoute({
+    ...args,
+    fallbackMessage: "Failed to list graph analysis changes.",
+    run: () => listGraphChangesFromGatewayAuth(args.authContext, args.query)
+  });
+}
+async function handleGraphAnalysisUpdateSuggestion(args) {
+  return withGraphRoute({
+    ...args,
+    fallbackMessage: "Failed to update graph suggestion.",
+    run: () => updateGraphSuggestionStatusFromGatewayAuth(args.authContext, {
+      ...asRecord22(args.body),
+      suggestionId: args.suggestionId
+    })
+  });
+}
+async function handleGraphAnalysisCompute(args) {
+  return withGraphRoute({
+    ...args,
+    fallbackMessage: "Failed to compute graph analysis.",
+    run: () => computeOrRequestGraphAnalysisFromGatewayAuth(
+      args.authContext,
+      asRecord22(args.body)
+    )
+  });
+}
+async function handleGraphRecommendationsList(args) {
+  return withGraphRoute({
+    ...args,
+    fallbackMessage: "Failed to list graph recommendations.",
+    run: () => listGraphRecommendationsFromGatewayAuth(args.authContext, args.query)
+  });
+}
+async function handleGraphRecommendationGet(args) {
+  return withGraphRoute({
+    ...args,
+    fallbackMessage: "Failed to fetch graph recommendation.",
+    run: () => getGraphRecommendationFromGatewayAuth(
+      args.authContext,
+      args.recommendationId
+    )
+  });
+}
+async function handleGraphRecommendationStatus(args) {
+  return withGraphRoute({
+    ...args,
+    fallbackMessage: "Failed to update graph recommendation.",
+    run: () => markGraphRecommendationStatusFromGatewayAuth(args.authContext, {
+      ...asRecord22(args.body),
+      recommendationId: args.recommendationId
+    })
+  });
+}
+async function handleOrgGraphSearch(args) {
+  return withGraphRoute({
+    ...args,
+    fallbackMessage: "Failed to search organization graph.",
+    run: () => searchOrgGraphFromGatewayAuth(args.authContext, asRecord22(args.body))
+  });
+}
+async function handleOrgGraphNodeGet(args) {
+  return withGraphRoute({
+    ...args,
+    fallbackMessage: "Failed to fetch organization graph node.",
+    run: () => getOrgGraphNodeFromGatewayAuth(args.authContext, {
+      ...args.query,
+      nodeId: args.nodeId
+    })
+  });
+}
+async function handleOrgGraphByProvenance(args) {
+  return withGraphRoute({
+    ...args,
+    fallbackMessage: "Failed to list organization graph by provenance.",
+    run: () => listOrgGraphByProvenanceFromGatewayAuth(args.authContext, args.query)
+  });
+}
+async function handleOrgGraphPublished(args) {
+  return withGraphRoute({
+    ...args,
+    fallbackMessage: "Failed to list published organization graph nodes.",
+    run: () => listPublishedOrgGraphFromGatewayAuth(args.authContext, args.query)
+  });
+}
+
 // ../../apps/gateway/src/routes/identity.ts
 async function handleIdentityWhoami(args) {
   try {
@@ -20622,7 +22713,7 @@ async function handleIdentityWhoami(args) {
 }
 
 // ../../apps/gateway/src/routes/ontologies.ts
-function asRecord21(value) {
+function asRecord23(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : {};
 }
 function readString26(value) {
@@ -20682,7 +22773,7 @@ async function handleOntologyGet(args) {
 }
 async function handleOntologyBind(args) {
   try {
-    const body = asRecord21(args.body);
+    const body = asRecord23(args.body);
     const payload = await bindOntologyFromGatewayAuth(args.authContext, {
       ontologyId: args.ontologyId,
       topicId: readString26(body.topicId) ?? ""
@@ -20702,7 +22793,7 @@ async function handleOntologyBind(args) {
 }
 async function handleOntologyMatch(args) {
   try {
-    const body = asRecord21(args.body);
+    const body = asRecord23(args.body);
     const payload = await matchOntologyFromGatewayAuth(args.authContext, {
       text: readString26(body.text) ?? "",
       topicId: readString26(body.topicId),
@@ -20725,7 +22816,7 @@ async function handleOntologyMatch(args) {
 }
 
 // ../../apps/gateway/src/routes/questions.ts
-function asRecord22(value) {
+function asRecord24(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : {};
 }
 function readString27(value) {
@@ -20747,13 +22838,13 @@ function readStringArray13(value) {
 }
 async function handleQuestionCreate(args) {
   try {
-    const body = asRecord22(args.body);
+    const body = asRecord24(args.body);
     const payload = await createQuestionFromGatewayAuth(args.authContext, {
       topicId: readString27(body.topicId),
       text: readString27(body.text) ?? "",
       priority: readString27(body.priority),
       linkedBeliefId: readString27(body.linkedBeliefId),
-      metadata: asRecord22(body.metadata)
+      metadata: asRecord24(body.metadata)
     });
     return successResponse(payload, {
       status: 201,
@@ -20800,7 +22891,7 @@ async function handleQuestionGet(args) {
 }
 async function handleQuestionArchive(args) {
   try {
-    const body = asRecord22(args.body);
+    const body = asRecord24(args.body);
     const payload = await archiveQuestionFromGatewayAuth(args.authContext, {
       id: args.questionId,
       rationale: readString27(body.reason) ?? readString27(body.rationale)
@@ -20846,7 +22937,7 @@ async function handleQuestionList(args) {
 }
 async function handleQuestionAnswer(args) {
   try {
-    const body = asRecord22(args.body);
+    const body = asRecord24(args.body);
     const payload = await answerQuestionFromGatewayAuth(args.authContext, {
       id: args.questionId,
       text: readString27(body.text) ?? "",
@@ -20898,7 +22989,7 @@ async function handleQuestionGetAnswer(args) {
 }
 async function handleQuestionRefine(args) {
   try {
-    const body = asRecord22(args.body);
+    const body = asRecord24(args.body);
     const payload = await refineQuestionFromGatewayAuth(args.authContext, {
       id: args.questionId,
       text: readString27(body.text) ?? "",
@@ -20924,7 +23015,7 @@ async function handleQuestionRefine(args) {
 }
 async function handleQuestionUpdateStatus(args) {
   try {
-    const body = asRecord22(args.body);
+    const body = asRecord24(args.body);
     const payload = await updateQuestionStatusFromGatewayAuth(args.authContext, {
       id: args.questionId,
       status: readString27(body.status) ?? "",
@@ -20953,8 +23044,8 @@ async function handleQuestionUpdateStatus(args) {
 }
 async function handleQuestionBatchCreate(args) {
   try {
-    const body = asRecord22(args.body);
-    const questions = Array.isArray(body.questions) ? body.questions.map((entry) => asRecord22(entry)).map((entry) => ({
+    const body = asRecord24(args.body);
+    const questions = Array.isArray(body.questions) ? body.questions.map((entry) => asRecord24(entry)).map((entry) => ({
       question: readString27(entry.question) ?? readString27(entry.text) ?? "",
       category: readString27(entry.category),
       priority: readString27(entry.priority),
@@ -20991,7 +23082,7 @@ async function handleQuestionBatchCreate(args) {
 }
 async function handleQuestionAdd(args) {
   try {
-    const body = asRecord22(args.body);
+    const body = asRecord24(args.body);
     const payload = await addQuestionFromGatewayAuth(args.authContext, {
       topicId: readString27(body.topicId),
       question: readString27(body.question) ?? readString27(body.text),
@@ -21003,7 +23094,7 @@ async function handleQuestionAdd(args) {
       chatId: readString27(body.chatId),
       importance: readNumber18(body.importance),
       epistemicUnlock: readString27(body.epistemicUnlock),
-      metadata: asRecord22(body.metadata),
+      metadata: asRecord24(body.metadata),
       questionType: readString27(body.questionType)
     });
     return successResponse(payload, {
@@ -21027,7 +23118,7 @@ async function handleQuestionAdd(args) {
 }
 async function handleQuestionUpdatePriority(args) {
   try {
-    const body = asRecord22(args.body);
+    const body = asRecord24(args.body);
     const payload = await updateQuestionPriorityFromGatewayAuth(
       args.authContext,
       {
@@ -21058,7 +23149,7 @@ async function handleQuestionUpdatePriority(args) {
 }
 async function handleQuestionAdvanceToConviction(args) {
   try {
-    const body = asRecord22(args.body);
+    const body = asRecord24(args.body);
     const payload = await advanceQuestionToConvictionFromGatewayAuth(
       args.authContext,
       {
@@ -21089,7 +23180,7 @@ async function handleQuestionAdvanceToConviction(args) {
 }
 async function handleQuestionUpdateConviction(args) {
   try {
-    const body = asRecord22(args.body);
+    const body = asRecord24(args.body);
     const payload = await updateQuestionConvictionFromGatewayAuth(
       args.authContext,
       {
@@ -21122,7 +23213,7 @@ async function handleQuestionUpdateConviction(args) {
 }
 async function handleQuestionFinalizeConviction(args) {
   try {
-    const body = asRecord22(args.body);
+    const body = asRecord24(args.body);
     const payload = await finalizeQuestionConvictionFromGatewayAuth(
       args.authContext,
       {
@@ -21157,7 +23248,7 @@ async function handleQuestionFinalizeConviction(args) {
 }
 async function handleQuestionUpdate(args) {
   try {
-    const body = asRecord22(args.body);
+    const body = asRecord24(args.body);
     const payload = await updateQuestionFromGatewayAuth(args.authContext, {
       questionId: readString27(body.questionId) ?? readString27(body.id) ?? readString27(body.nodeId),
       question: readString27(body.question) ?? readString27(body.text),
@@ -21184,7 +23275,7 @@ async function handleQuestionUpdate(args) {
 }
 async function handleQuestionDelete(args) {
   try {
-    const body = asRecord22(args.body);
+    const body = asRecord24(args.body);
     const payload = await deleteQuestionFromGatewayAuth(args.authContext, {
       questionId: readString27(body.questionId) ?? readString27(body.id) ?? readString27(body.nodeId)
     });
@@ -21208,7 +23299,7 @@ async function handleQuestionDelete(args) {
 }
 
 // ../../apps/gateway/src/routes/search.ts
-function asRecord23(value) {
+function asRecord25(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : {};
 }
 function readString28(value) {
@@ -21229,7 +23320,7 @@ function readStringArray14(value) {
   return items.length > 0 ? items : void 0;
 }
 async function handleSearchResources(args) {
-  const body = asRecord23(args.body);
+  const body = asRecord25(args.body);
   const q = readString28(body.q) ?? readString28(body.query);
   const topicId = readString28(body.topicId) ?? readString28(body.projectId);
   if (!q) {
@@ -21280,7 +23371,7 @@ async function handleSearchResources(args) {
 }
 
 // ../../apps/gateway/src/routes/sources.ts
-function asRecord24(value) {
+function asRecord26(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : {};
 }
 function readString29(value) {
@@ -21308,7 +23399,7 @@ function handleSourcesError(error, fallbackMessage, correlationId, policyTraceId
 }
 async function handleSourceUpsert(args) {
   try {
-    const body = asRecord24(args.body);
+    const body = asRecord26(args.body);
     const payload = await upsertSourceFromGatewayAuth(args.authContext, {
       url: readString29(body.url),
       sha: readString29(body.sha),
@@ -21316,7 +23407,7 @@ async function handleSourceUpsert(args) {
       title: readString29(body.title),
       capturedAt: readNumber20(body.capturedAt),
       topicId: readString29(body.topicId),
-      metadata: asRecord24(body.metadata)
+      metadata: asRecord26(body.metadata)
     });
     return successResponse(payload, {
       status: 201,
@@ -21350,7 +23441,7 @@ async function handleSourceGet(args) {
 }
 
 // ../../apps/gateway/src/routes/tasks.ts
-function asRecord25(value) {
+function asRecord27(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : {};
 }
 function readString30(value) {
@@ -21375,7 +23466,7 @@ function handleTasksError(error, fallbackMessage, correlationId, policyTraceId)
 }
 async function handleTaskCreate(args) {
   try {
-    const body = asRecord25(args.body);
+    const body = asRecord27(args.body);
     const payload = await createTaskFromGatewayAuth(args.authContext, {
       topicId: readString30(body.topicId),
       title: readString30(body.title) ?? "",
@@ -21419,7 +23510,7 @@ async function handleTaskList(args) {
 }
 async function handleTaskUpdate(args) {
   try {
-    const body = asRecord25(args.body);
+    const body = asRecord27(args.body);
     const payload = await updateTaskFromGatewayAuth(args.authContext, {
       id: args.taskId,
       title: readString30(body.title),
@@ -21446,7 +23537,7 @@ async function handleTaskUpdate(args) {
 }
 async function handleTaskComplete(args) {
   try {
-    const body = asRecord25(args.body);
+    const body = asRecord27(args.body);
     const payload = await completeTaskFromGatewayAuth(args.authContext, {
       id: args.taskId,
       outputSummary: readString30(body.outputSummary)
@@ -21466,7 +23557,7 @@ async function handleTaskComplete(args) {
 }
 
 // ../../apps/gateway/src/routes/topics.ts
-function asRecord26(value) {
+function asRecord28(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : {};
 }
 function readString31(value) {
@@ -21504,7 +23595,7 @@ function handleTopicsError(error, fallbackMessage, correlationId, policyTraceId)
 }
 async function handleTopicCreate(args) {
   try {
-    const body = asRecord26(args.body);
+    const body = asRecord28(args.body);
     const payload = await createTopicFromGatewayAuth(args.authContext, {
       name: readString31(body.name) ?? "",
       description: readString31(body.description),
@@ -21532,7 +23623,7 @@ async function handleTopicCreate(args) {
 }
 async function handleTopicUpdate(args) {
   try {
-    const body = asRecord26(args.body);
+    const body = asRecord28(args.body);
     const payload = await updateTopicFromGatewayAuth(args.authContext, {
       id: args.topicId,
       name: readString31(body.name),
@@ -21629,7 +23720,7 @@ async function handleTopicCoverage(args) {
 }
 async function handleTopicRemove(args) {
   try {
-    const body = asRecord26(args.body);
+    const body = asRecord28(args.body);
     const payload = await removeTopicFromGatewayAuth(args.authContext, {
       id: readString31(body.id) ?? readString31(body.topicId) ?? ""
     });
@@ -21648,8 +23739,8 @@ async function handleTopicRemove(args) {
 }
 async function handleTopicBulkCreate(args) {
   try {
-    const body = asRecord26(args.body);
-    const topics2 = Array.isArray(body.topics) ? body.topics.map((entry) => asRecord26(entry)).map((entry) => ({
+    const body = asRecord28(args.body);
+    const topics2 = Array.isArray(body.topics) ? body.topics.map((entry) => asRecord28(entry)).map((entry) => ({
       globalId: readString31(entry.globalId) ?? "",
       name: readString31(entry.name) ?? "",
       description: readString31(entry.description),
@@ -21662,7 +23753,7 @@ async function handleTopicBulkCreate(args) {
       graphScopeProjectId: readString31(entry.graphScopeProjectId),
       status: readString31(entry.status) ?? "active",
       visibility: readString31(entry.visibility),
-      metadata: asRecord26(entry.metadata),
+      metadata: asRecord28(entry.metadata),
       createdBy: readString31(entry.createdBy)
     })) : [];
     const payload = await bulkCreateTopicsFromGatewayAuth(args.authContext, {
@@ -21684,7 +23775,7 @@ async function handleTopicBulkCreate(args) {
 }
 
 // ../../apps/gateway/src/routes/webhooks.ts
-function asRecord27(value) {
+function asRecord29(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : {};
 }
 function readString32(value) {
@@ -21719,7 +23810,7 @@ function handleWebhooksError(error, fallbackMessage, correlationId, policyTraceI
 }
 async function handleWebhookCreate(args) {
   try {
-    const body = asRecord27(args.body);
+    const body = asRecord29(args.body);
     const payload = await args.authContext.convex.mutation(
       "events:createWebhook",
       {
@@ -21789,7 +23880,7 @@ async function handleWebhookGet(args) {
 }
 async function handleWebhookUpdate(args) {
   try {
-    const body = asRecord27(args.body);
+    const body = asRecord29(args.body);
     const payload = await args.authContext.convex.mutation(
       "events:updateWebhook",
       {
@@ -21843,7 +23934,7 @@ async function handleWebhookDelete(args) {
 }
 async function handleWebhookTest(args) {
   try {
-    const body = asRecord27(args.body);
+    const body = asRecord29(args.body);
     const payload = await args.authContext.convex.action("events:testWebhook", {
       webhookId: args.webhookId,
       tenantId: args.authContext.tenantId,
@@ -21918,7 +24009,7 @@ async function handleWebhookHealth(args) {
 }
 
 // ../../apps/gateway/src/routes/worktrees.ts
-function asRecord28(value) {
+function asRecord30(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : {};
 }
 function readString33(value) {
@@ -21938,6 +24029,36 @@ function readStringArray17(value) {
   const normalized = value.map((entry) => readString33(entry)).filter((entry) => Boolean(entry));
   return normalized.length > 0 ? normalized : void 0;
 }
+function readObjectArray(value) {
+  if (!Array.isArray(value)) {
+    return void 0;
+  }
+  const normalized = value.map((entry) => asRecord30(entry)).filter((entry) => Object.keys(entry).length > 0);
+  return normalized.length > 0 ? normalized : void 0;
+}
+function readConfidenceImpact(value) {
+  return value === "high" || value === "medium" || value === "low" ? value : void 0;
+}
+function normalizeMergeOutcomes2(value) {
+  if (!Array.isArray(value)) {
+    return [];
+  }
+  return value.map((entry) => {
+    const finding = readString33(entry);
+    if (finding) {
+      return finding;
+    }
+    const row = asRecord30(entry);
+    if (!Object.keys(row).length) {
+      return null;
+    }
+    return {
+      beliefId: readString33(row.beliefId) ?? "",
+      confidence: readNumber22(row.confidence) ?? Number.NaN,
+      rationale: readString33(row.rationale) ?? ""
+    };
+  }).filter((entry) => entry !== null);
+}
 function handleWorktreesError(error, fallbackMessage, correlationId, policyTraceId) {
   const resolved = resolveServerCoreError(error, fallbackMessage);
   return errorResponse({
@@ -21953,13 +24074,30 @@ function handleWorktreesError(error, fallbackMessage, correlationId, policyTrace
 }
 async function handleWorktreeCreate(args) {
   try {
-    const body = asRecord28(args.body);
+    const body = asRecord30(args.body);
+    const goCriteria = readStringArray17(body.goCriteria);
+    const noGoSignals = readStringArray17(body.noGoSignals);
     const payload = await createWorktreeFromGatewayAuth(args.authContext, {
-      title: readString33(body.title) ?? "",
+      title: readString33(body.title) ?? readString33(body.name) ?? "",
       topicId: readString33(body.topicId ?? body.projectId) ?? "",
       objective: readString33(body.objective),
       hypothesis: readString33(body.hypothesis),
-      beliefIds: readStringArray17(body.beliefIds) ?? readStringArray17(body.beliefs),
+      rationale: readString33(body.rationale),
+      worktreeType: readString33(body.worktreeType),
+      startDate: readNumber22(body.startDate),
+      endDate: readNumber22(body.endDate),
+      durationWeeks: readNumber22(body.durationWeeks),
+      confidenceImpact: readConfidenceImpact(body.confidenceImpact),
+      beliefFocus: readString33(body.beliefFocus),
+      beliefIds: readStringArray17(body.targetBeliefIds) ?? readStringArray17(body.beliefIds) ?? readStringArray17(body.beliefs),
+      targetBeliefIds: readStringArray17(body.targetBeliefIds),
+      targetQuestionIds: readStringArray17(body.targetQuestionIds),
+      keyQuestions: readObjectArray(body.keyQuestions),
+      evidenceSignals: readObjectArray(body.evidenceSignals),
+      decisionGate: body.decisionGate && typeof body.decisionGate === "object" && !Array.isArray(body.decisionGate) ? body.decisionGate : goCriteria || noGoSignals ? {
+        goCriteria: goCriteria ?? [],
+        noGoSignals: noGoSignals ?? []
+      } : void 0,
       autoShape: typeof body.autoShape === "boolean" ? body.autoShape : void 0,
       domainPackId: readString33(body.domainPackId),
       campaign: readNumber22(body.campaign),
@@ -22074,7 +24212,7 @@ async function handleWorktreeActivate(args) {
 }
 async function handleWorktreeUpdate(args) {
   try {
-    const body = asRecord28(args.body);
+    const body = asRecord30(args.body);
     const payload = await updateWorktreeFromGatewayAuth(args.authContext, {
       id: args.worktreeId,
       objective: readString33(body.objective),
@@ -22111,13 +24249,8 @@ async function handleWorktreeUpdate(args) {
 }
 async function handleWorktreeMerge(args) {
   try {
-    const body = asRecord28(args.body);
-    const rawOutcomes = Array.isArray(body.outcomes) ? body.outcomes : [];
-    const outcomes = rawOutcomes.map((entry) => asRecord28(entry)).map((entry) => ({
-      beliefId: readString33(entry.beliefId) ?? "",
-      confidence: readNumber22(entry.confidence) ?? Number.NaN,
-      rationale: readString33(entry.rationale) ?? ""
-    }));
+    const body = asRecord30(args.body);
+    const outcomes = normalizeMergeOutcomes2(body.outcomes);
     const payload = await mergeWorktreeFromGatewayAuth(args.authContext, {
       id: args.worktreeId,
       summary: readString33(body.summary),
@@ -22138,7 +24271,7 @@ async function handleWorktreeMerge(args) {
 }
 async function handleWorktreeUpdateTargets(args) {
   try {
-    const body = asRecord28(args.body);
+    const body = asRecord30(args.body);
     const payload = await updateWorktreeTargetsFromGatewayAuth(
       args.authContext,
       {
@@ -22164,7 +24297,7 @@ async function handleWorktreeUpdateTargets(args) {
 }
 async function handleWorktreeComplete(args) {
   try {
-    const body = asRecord28(args.body);
+    const body = asRecord30(args.body);
     const payload = await completeWorktreeRecordFromGatewayAuth(
       args.authContext,
       {
@@ -22189,7 +24322,7 @@ async function handleWorktreeComplete(args) {
 }
 async function handleWorktreeAdvancePhase(args) {
   try {
-    const body = asRecord28(args.body);
+    const body = asRecord30(args.body);
     const payload = await advanceWorktreePhaseFromGatewayAuth(args.authContext, {
       worktreeId: readString33(body.worktreeId) ?? ""
     });
@@ -22208,7 +24341,7 @@ async function handleWorktreeAdvancePhase(args) {
 }
 async function handleWorktreeSetPhase(args) {
   try {
-    const body = asRecord28(args.body);
+    const body = asRecord30(args.body);
     const payload = await setWorktreePhaseFromGatewayAuth(args.authContext, {
       worktreeId: readString33(body.worktreeId) ?? "",
       phase: readString33(body.phase) ?? ""
@@ -22228,12 +24361,12 @@ async function handleWorktreeSetPhase(args) {
 }
 async function handleWorktreePatchState(args) {
   try {
-    const body = asRecord28(args.body);
+    const body = asRecord30(args.body);
     const payload = await patchWorktreeStateFromGatewayAuth(
       args.authContext,
       {
         worktreeId: readString33(body.worktreeId) ?? "",
-        patch: asRecord28(body.patch)
+        patch: asRecord30(body.patch)
       }
     );
     return successResponse(payload, {
@@ -22251,7 +24384,7 @@ async function handleWorktreePatchState(args) {
 }
 async function handleWorktreeBulkCreate(args) {
   try {
-    const body = asRecord28(args.body);
+    const body = asRecord30(args.body);
     const payload = await bulkCreateWorktreesFromGatewayAuth(args.authContext, {
       worktrees: Array.isArray(body.worktrees) ? body.worktrees : []
     });
@@ -22270,6 +24403,6 @@ async function handleWorktreeBulkCreate(args) {
   }
 }
 
-export { handleBeliefArchive, handleBeliefBatchUpdateCriticality, handleBeliefBisect, handleBeliefConfidenceHistory, handleBeliefCreate, handleBeliefCreateContract, handleBeliefFork, handleBeliefGet, handleBeliefLineage, handleBeliefLink, handleBeliefList, handleBeliefReassignTopic, handleBeliefRefine, handleBeliefRelationships, handleBeliefUnlinkEvidence, handleBeliefUpdateConfidence, handleBeliefUpdateCriticality, handleBeliefUpdateRationale, handleBeliefUpdateStatus, handleContradictionFlag, handleContradictionGet, handleContradictionList, handleEdgeBatchCreate, handleEdgeCreate, handleEdgeDelete, handleEdgeList, handleEdgeRemove, handleEdgeTraverse, handleEdgeUpdate, handleEdgesRemoveBetween, handleEventsList, handleEventsReplay, handleEvidenceClassify, handleEvidenceClassifyBatch, handleEvidenceCreate, handleEvidenceFlagIncorrect, handleEvidenceGet, handleEvidenceLink, handleEvidenceList, handleEvidenceRemove, handleEvidenceSearch, handleEvidenceUpdate, handleEvidenceUpdateStatus, handleEvidenceUpdateVerificationStatus, handleGraphAnalyze, handleGraphBias, handleGraphFalsify, handleGraphGaps, handleGraphNeighborhood, handleGraphTraverse, handleIdentityWhoami, handleOntologyBind, handleOntologyGet, handleOntologyList, handleOntologyMatch, handleQuestionAdd, handleQuestionAdvanceToConviction, handleQuestionAnswer, handleQuestionArchive, handleQuestionBatchCreate, handleQuestionCreate, handleQuestionDelete, handleQuestionFinalizeConviction, handleQuestionGet, handleQuestionGetAnswer, handleQuestionList, handleQuestionRefine, handleQuestionUpdate, handleQuestionUpdateConviction, handleQuestionUpdatePriority, handleQuestionUpdateStatus, handleSearchResources, handleSourceGet, handleSourceUpsert, handleTaskComplete, handleTaskCreate, handleTaskList, handleTaskUpdate, handleTopicBulkCreate, handleTopicCoverage, handleTopicCreate, handleTopicGet, handleTopicList, handleTopicRemove, handleTopicTree, handleTopicUpdate, handleWebhookCreate, handleWebhookDelete, handleWebhookDeliveries, handleWebhookGet, handleWebhookHealth, handleWebhookList, handleWebhookTest, handleWebhookUpdate, handleWorktreeActivate, handleWorktreeAdvancePhase, handleWorktreeBulkCreate, handleWorktreeComplete, handleWorktreeCreate, handleWorktreeList, handleWorktreeListAll, handleWorktreeListCampaigns, handleWorktreeMerge, handleWorktreePatchState, handleWorktreeSetPhase, handleWorktreeUpdate, handleWorktreeUpdateTargets };
+export { handleBeliefArchive, handleBeliefBatchUpdateCriticality, handleBeliefBisect, handleBeliefConfidenceHistory, handleBeliefCreate, handleBeliefCreateContract, handleBeliefFork, handleBeliefGet, handleBeliefLineage, handleBeliefLink, handleBeliefList, handleBeliefReassignTopic, handleBeliefRefine, handleBeliefRelationships, handleBeliefUnlinkEvidence, handleBeliefUpdateConfidence, handleBeliefUpdateCriticality, handleBeliefUpdateRationale, handleBeliefUpdateStatus, handleContradictionFlag, handleContradictionGet, handleContradictionList, handleEdgeBatchCreate, handleEdgeCreate, handleEdgeDelete, handleEdgeList, handleEdgeRemove, handleEdgeTraverse, handleEdgeUpdate, handleEdgesRemoveBetween, handleEventsList, handleEventsReplay, handleEvidenceClassify, handleEvidenceClassifyBatch, handleEvidenceCreate, handleEvidenceFlagIncorrect, handleEvidenceGet, handleEvidenceLink, handleEvidenceList, handleEvidenceRemove, handleEvidenceSearch, handleEvidenceUpdate, handleEvidenceUpdateStatus, handleEvidenceUpdateVerificationStatus, handleGraphAnalysisCompute, handleGraphAnalysisLatest, handleGraphAnalysisList, handleGraphAnalysisListChanges, handleGraphAnalysisListSuggestions, handleGraphAnalysisSave, handleGraphAnalysisSaveSuggestions, handleGraphAnalysisUpdateSuggestion, handleGraphAnalyze, handleGraphBias, handleGraphEdgeList, handleGraphFalsify, handleGraphGaps, handleGraphNeighborhood, handleGraphNodeList, handleGraphRecommendationGet, handleGraphRecommendationStatus, handleGraphRecommendationsList, handleGraphTraverse, handleIdentityWhoami, handleOntologyBind, handleOntologyGet, handleOntologyList, handleOntologyMatch, handleOrgGraphByProvenance, handleOrgGraphNodeGet, handleOrgGraphPublished, handleOrgGraphSearch, handleQuestionAdd, handleQuestionAdvanceToConviction, handleQuestionAnswer, handleQuestionArchive, handleQuestionBatchCreate, handleQuestionCreate, handleQuestionDelete, handleQuestionFinalizeConviction, handleQuestionGet, handleQuestionGetAnswer, handleQuestionList, handleQuestionRefine, handleQuestionUpdate, handleQuestionUpdateConviction, handleQuestionUpdatePriority, handleQuestionUpdateStatus, handleSearchResources, handleSourceGet, handleSourceUpsert, handleTaskComplete, handleTaskCreate, handleTaskList, handleTaskUpdate, handleTopicBulkCreate, handleTopicCoverage, handleTopicCreate, handleTopicGet, handleTopicList, handleTopicRemove, handleTopicTree, handleTopicUpdate, handleWebhookCreate, handleWebhookDelete, handleWebhookDeliveries, handleWebhookGet, handleWebhookHealth, handleWebhookList, handleWebhookTest, handleWebhookUpdate, handleWorktreeActivate, handleWorktreeAdvancePhase, handleWorktreeBulkCreate, handleWorktreeComplete, handleWorktreeCreate, handleWorktreeList, handleWorktreeListAll, handleWorktreeListCampaigns, handleWorktreeMerge, handleWorktreePatchState, handleWorktreeSetPhase, handleWorktreeUpdate, handleWorktreeUpdateTargets };
 //# sourceMappingURL=gateway.js.map
 //# sourceMappingURL=gateway.js.map