@lucern/mcp 0.3.0-alpha.6 → 0.3.0-alpha.7

package/dist/gateway.js

@@ -4865,6 +4865,11 @@ var TENANT_CLIENT_INSTALLABLE_PACKAGES = [
     role: "sdk_dependency",
     directTenantImport: false
   },
+  {
+    packageName: "@lucern/graph-sync",
+    role: "host_addon_runtime",
+    directTenantImport: true
+  },
   {
     packageName: "@lucern/identity",
     role: "component_runtime",
@@ -4984,8 +4989,11 @@ function compactRecord(input) {
     Object.entries(input).filter(([, value]) => value !== void 0)
   );
 }
+function isRecord(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
 function recordValue(value) {
-  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+  return isRecord(value) ? value : {};
 }
 var createEvidenceProjection = defineProjection({
   contractName: "create_evidence",
@@ -5691,9 +5699,16 @@ var ADD_WORKTREE = {
     },
     projectId: {
       type: "string",
-      description: "Legacy topicId alias"
+      description: "Legacy topicId alias or resolver hint"
+    },
+    topicId: {
+      type: "string",
+      description: "Optional topic scope hint for resolver validation"
+    },
+    topicHint: {
+      type: "string",
+      description: "Natural-language topic hint for automatic topic resolution"
     },
-    topicId: { type: "string", description: "Optional topic scope hint" },
     branchId: {
       type: "string",
       description: "The branch this worktree investigates"
@@ -5791,6 +5806,22 @@ var ADD_WORKTREE = {
       type: "string",
       description: "Optional domain pack whose shaping hooks should influence generated questions and tasks"
     },
+    tags: {
+      type: "array",
+      description: "Additional topic-resolution tags for the worktree"
+    },
+    touchedPaths: {
+      type: "array",
+      description: "File paths used as topic-resolution signals"
+    },
+    sourceRef: {
+      type: "string",
+      description: "Source reference used as a topic-resolution signal"
+    },
+    sourceKind: {
+      type: "string",
+      description: "Source kind used as a topic-resolution signal"
+    },
     campaign: {
       type: "number",
       description: "Top-level pipeline campaign number. Campaigns define the outer execution slice."
@@ -5828,7 +5859,7 @@ var ADD_WORKTREE = {
       description: "Timestamp when worktree metadata was last reconciled"
     }
   },
-  required: ["title", "topicId"],
+  required: ["title"],
   response: {
     description: "The created worktree",
     fields: {
@@ -7531,18 +7562,60 @@ var CREATE_TASK = {
   name: "create_task",
   description: "Create an execution task tied to the reasoning state. Like `git task` \u2014 tracks concrete work items (calls to make, data to gather, analyses to run) linked to questions, beliefs, or worktrees.",
   parameters: {
-    title: { type: "string", description: "Task description" },
+    title: { type: "string", description: "Task title" },
     topicId: { type: "string", description: "Topic scope" },
+    description: {
+      type: "string",
+      description: "Long-form task description"
+    },
     taskType: {
       type: "string",
-      description: "Type: research, interview, analysis, data_collection",
-      enum: ["research", "interview", "analysis", "data_collection"]
+      description: "Task taxonomy",
+      enum: [
+        "general",
+        "find_evidence",
+        "verify_claim",
+        "research",
+        "review",
+        "interview",
+        "analysis",
+        "track_metrics"
+      ]
+    },
+    priority: {
+      type: "string",
+      description: "Priority",
+      enum: ["urgent", "high", "medium", "low"]
+    },
+    status: {
+      type: "string",
+      description: "Initial status (defaults to todo)",
+      enum: ["todo", "in_progress", "blocked", "done"]
+    },
+    linkedWorktreeId: {
+      type: "string",
+      description: "Worktree this task belongs to"
+    },
+    linkedBeliefId: {
+      type: "string",
+      description: "Belief this task supports"
     },
     linkedQuestionId: {
       type: "string",
       description: "Question this task addresses"
     },
-    linkedWorktreeId: { type: "string", description: "Worktree scope" }
+    assigneeId: {
+      type: "string",
+      description: "Principal assigned to the task"
+    },
+    dueDate: {
+      type: "number",
+      description: "Due date as epoch milliseconds"
+    },
+    tags: {
+      type: "array",
+      description: "Free-form string tags"
+    }
   },
   required: ["title"],
   response: {
@@ -9625,9 +9698,7 @@ function mcpContractFromArgsSchema(base, args, contractName) {
     required: converted.filter(([, field]) => field.required).map(([fieldName]) => fieldName)
   };
 }
-function defineFunctionContract(contract) {
-  return contract;
-}
+var defineFunctionContract = (contract) => contract;
 function authUserId(context) {
   return context.userId ?? context.principalId ?? "lucern-agent";
 }
@@ -9781,6 +9852,9 @@ var observationContextArgs = z.object({
   limit: z.number().optional().describe("Maximum observations to return."),
   status: z.string().optional().describe("Observation status filter.")
 });
+function isRecord2(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
 var observationInput = (input, context) => withUserId(
   compactRecord4({
     projectId: input.projectId,
@@ -9835,8 +9909,8 @@ var contextContracts = [
       kind: "mutation",
       inputProjection: observationInput,
       outputProjection: (output, input) => ({
-        ...output && typeof output === "object" ? output : {},
-        observationId: output && typeof output === "object" ? output.nodeId : void 0,
+        ...isRecord2(output) ? output : {},
+        observationId: isRecord2(output) ? output.nodeId : void 0,
         observationType: input.observationType
       })
     },
@@ -11317,10 +11391,11 @@ var worktreeDecisionGateInputSchema = z.object({
   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."),
+  title: z.string().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."),
+  topicId: z.string().optional().describe("Optional primary topic scope hint for resolver validation."),
+  projectId: z.string().optional().describe("Legacy topicId alias/hint."),
+  topicHint: z.string().optional().describe("Natural-language topic hint for automatic topic resolution."),
   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."),
@@ -11345,6 +11420,10 @@ var addWorktreeArgs = z.object({
   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."),
+  tags: z.array(z.string()).optional().describe("Additional topic-resolution tags for the worktree."),
+  touchedPaths: z.array(z.string()).optional().describe("File paths used as topic-resolution signals."),
+  sourceRef: z.string().optional().describe("Source reference used as a topic-resolution signal."),
+  sourceKind: z.string().optional().describe("Source kind used as a topic-resolution signal."),
   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."),
@@ -11674,8 +11753,46 @@ var worktreesContracts = [
     args: openPullRequestArgs
   })
 ];
-
-// ../contracts/src/function-registry/tasks.ts
+var taskPrioritySchema = z.enum(["urgent", "high", "medium", "low"]);
+var taskStatusSchema2 = z.enum(["todo", "in_progress", "blocked", "done"]);
+var taskTypeSchema = z.enum([
+  "general",
+  "find_evidence",
+  "verify_claim",
+  "research",
+  "review",
+  "interview",
+  "analysis",
+  "track_metrics"
+]);
+var createTaskArgs = z.object({
+  title: z.string().describe("Task title."),
+  topicId: z.string().optional().describe("Topic scope."),
+  description: z.string().optional().describe("Long-form task description."),
+  taskType: taskTypeSchema.optional().describe("Task taxonomy."),
+  priority: taskPrioritySchema.optional().describe("Priority. Defaults to medium when omitted by the server."),
+  status: taskStatusSchema2.optional().describe("Initial status. Defaults to todo."),
+  linkedWorktreeId: z.string().optional().describe("Worktree this task belongs to."),
+  linkedBeliefId: z.string().optional().describe("Belief this task supports."),
+  linkedQuestionId: z.string().optional().describe("Question this task addresses."),
+  assigneeId: z.string().optional().describe("Principal assigned to the task."),
+  dueDate: z.number().optional().describe("Due date as epoch milliseconds."),
+  tags: z.array(z.string()).optional().describe("Free-form tags.")
+});
+var createTaskInput = (input) => compactRecord4({
+  title: input.title,
+  topicId: input.topicId,
+  description: input.description,
+  taskType: input.taskType,
+  priority: input.priority ?? "medium",
+  status: input.status ?? "todo",
+  linkedWorktreeId: input.linkedWorktreeId,
+  linkedBeliefId: input.linkedBeliefId,
+  linkedQuestionId: input.linkedQuestionId,
+  assigneeId: input.assigneeId,
+  dueDate: input.dueDate,
+  tags: input.tags
+});
 var taskInput = (input) => compactRecord4({
   ...input,
   taskId: input.taskId ?? input.id
@@ -11707,8 +11824,10 @@ var tasksContracts = [
     convex: {
       module: "tasks",
       functionName: "create",
-      kind: "mutation"
-    }
+      kind: "mutation",
+      inputProjection: createTaskInput
+    },
+    args: createTaskArgs
   }),
   surfaceContract({
     name: "list_tasks",
@@ -12826,9 +12945,12 @@ var ALL_FUNCTION_CONTRACTS = [
   ...legacyContracts
 ];
 assertSurfaceCoverage(ALL_FUNCTION_CONTRACTS);
-new Map(
+var FUNCTION_CONTRACTS_BY_NAME = new Map(
   ALL_FUNCTION_CONTRACTS.map((contract) => [contract.name, contract])
 );
+FUNCTION_CONTRACTS_BY_NAME.get.bind(
+  FUNCTION_CONTRACTS_BY_NAME
+);
 
 // ../contracts/src/text-matching.contract.ts
 var TOKEN_SPLIT_REGEX = /[^a-z0-9]+/;
@@ -13873,15 +13995,31 @@ function defaultSuggestionForCode(code) {
       return void 0;
   }
 }
+function createGatewaySuccessBody(payload, args) {
+  const body = {};
+  body.success = true;
+  body.data = payload;
+  body.correlationId = args.correlationId;
+  body.policyTraceId = args.policyTraceId ?? null;
+  body.idempotentReplay = args.idempotentReplay ?? false;
+  return body;
+}
+function createGatewayErrorBody(args, safeMessage) {
+  const body = {};
+  body.success = false;
+  body.error = safeMessage;
+  body.code = args.code;
+  body.invariant = args.invariant ?? defaultInvariantForCode(args.code) ?? null;
+  body.suggestion = args.suggestion ?? defaultSuggestionForCode(args.code) ?? null;
+  body.details = args.details;
+  body.correlationId = args.correlationId;
+  body.policyTraceId = args.policyTraceId ?? null;
+  return body;
+}
 function successResponse(payload, args) {
+  const body = createGatewaySuccessBody(payload, args);
   return Response.json(
-    {
-      success: true,
-      data: payload,
-      correlationId: args.correlationId,
-      policyTraceId: args.policyTraceId ?? null,
-      idempotentReplay: args.idempotentReplay ?? false
-    },
+    body,
     {
       status: args.status ?? 200,
       headers: buildHeaders({
@@ -13908,17 +14046,9 @@ function errorResponse(args) {
     status: args.status,
     code: args.code
   });
+  const body = createGatewayErrorBody(args, safeMessage);
   return Response.json(
-    {
-      success: false,
-      error: safeMessage,
-      code: args.code,
-      invariant: args.invariant ?? defaultInvariantForCode(args.code) ?? null,
-      suggestion: args.suggestion ?? defaultSuggestionForCode(args.code) ?? null,
-      details: args.details,
-      correlationId: args.correlationId,
-      policyTraceId: args.policyTraceId ?? null
-    },
+    body,
     {
       status: args.status,
       headers
@@ -13967,6 +14097,42 @@ var api = makeProxy("api");
 makeProxy("components");
 makeProxy("internal");
 
+// ../server-core/src/debug.ts
+function formatUnknownError(error) {
+  if (error instanceof Error) {
+    const cause = error.cause;
+    const message = `${error.name}: ${error.message}`;
+    if (cause === void 0) {
+      return message;
+    }
+    return `${message}; cause=${formatUnknownError(cause)}`;
+  }
+  if (typeof error === "string") {
+    return error;
+  }
+  if (error === null) {
+    return "null";
+  }
+  if (error === void 0) {
+    return "undefined";
+  }
+  try {
+    return JSON.stringify(error);
+  } catch {
+    return Object.prototype.toString.call(error);
+  }
+}
+function isServerCoreFallbackDebugEnabled() {
+  const env = globalThis.process?.env;
+  return env?.LUCERN_COMPAT_FALLBACK_DEBUG === "1" || env?.LUCERN_SERVER_CORE_DEBUG === "1";
+}
+function debugServerCoreFallback(scope, message, context) {
+  if (!isServerCoreFallbackDebugEnabled()) {
+    return;
+  }
+  console.debug(`[${scope}] ${message}`, context ?? {});
+}
+
 // ../server-core/src/mcp-context-tools.ts
 function requireMcpConvex(authContext, label) {
   const convex = authContext.convex;
@@ -14890,6 +15056,9 @@ async function bisectBeliefConfidence(port, input) {
 }
 var DEFAULT_THRESHOLD = 0.35;
 var TREE_MAX_DEPTH = 20;
+var BM25_K1 = 1.2;
+var BM25_B = 0.75;
+var BM25_NORMALIZATION = 8;
 var METADATA_TOKEN_KEYS = [
   "aliases",
   "alias",
@@ -14942,35 +15111,44 @@ function readStringArray2(value) {
   }
   return value.map((entry) => readString2(entry)).filter((entry) => Boolean(entry));
 }
+function isRecord3(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function decodePrefixedIdOrNull(value) {
+  const normalized = value.trim();
+  const match = /^([a-z][a-z0-9]*)_(.+)$/.exec(normalized);
+  if (!match) {
+    return null;
+  }
+  return {
+    prefix: match[1],
+    value: match[2]
+  };
+}
 function asRecord2(value) {
-  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+  return isRecord3(value) ? value : {};
 }
 function normalizeTopicId(value) {
   const normalized = readString2(value);
   if (!normalized) {
     return void 0;
   }
-  try {
-    const decoded = decodePrefixedId(normalized);
-    return decoded.prefix === "top" ? decoded.value : normalized;
-  } catch {
-    return normalized;
-  }
+  const decoded = decodePrefixedIdOrNull(normalized);
+  return decoded?.prefix === "top" ? decoded.value : normalized;
 }
 function normalizeExternalId(value, prefix) {
   const normalized = readString2(value);
   if (!normalized) {
     return void 0;
   }
-  try {
-    const decoded = decodePrefixedId(normalized);
-    if (prefix && decoded.prefix !== prefix) {
-      return normalized;
-    }
-    return decoded.value;
-  } catch {
+  const decoded = decodePrefixedIdOrNull(normalized);
+  if (!decoded) {
     return normalized;
   }
+  if (prefix && decoded.prefix !== prefix) {
+    return normalized;
+  }
+  return decoded.value;
 }
 function normalizeToken(value) {
   const normalized = value.toLowerCase().trim();
@@ -15049,15 +15227,83 @@ function collectTopicMetadataTokens(metadata) {
 function topicNameSlug(name) {
   return tokenize(name).join(" ");
 }
+function topicTokenList(topic) {
+  return [
+    ...tokenize(topic.name),
+    ...tokenize(topic.description),
+    ...tokenize(topic.type),
+    ...collectTopicMetadataTokens(topic.metadata ?? {}).flatMap(
+      (value) => tokenize(value)
+    )
+  ];
+}
 function topicTokenSet(topic) {
   const tokens = /* @__PURE__ */ new Set();
-  addTokens(tokens, tokenize(topic.name));
-  addTokens(tokens, tokenize(topic.description));
-  addTokens(tokens, tokenize(topic.type));
-  addTokens(tokens, collectTopicMetadataTokens(topic.metadata ?? {}));
+  addTokens(tokens, topicTokenList(topic));
   return tokens;
 }
+function buildTopicScoreCorpus(topics2) {
+  const documentFrequencyByToken = /* @__PURE__ */ new Map();
+  let documentCount = 0;
+  let totalLength = 0;
+  for (const topic of topics2) {
+    const tokens = topicTokenList(topic);
+    const uniqueTokens = new Set(tokens);
+    documentCount += 1;
+    totalLength += tokens.length;
+    for (const token of uniqueTokens) {
+      documentFrequencyByToken.set(
+        token,
+        (documentFrequencyByToken.get(token) ?? 0) + 1
+      );
+    }
+  }
+  return {
+    documentCount,
+    averageDocumentLength: documentCount > 0 ? Math.max(1, totalLength / documentCount) : 1,
+    documentFrequencyByToken
+  };
+}
+function countTokens(tokens) {
+  const counts = /* @__PURE__ */ new Map();
+  for (const token of tokens) {
+    counts.set(token, (counts.get(token) ?? 0) + 1);
+  }
+  return counts;
+}
+function bm25Score(topic, signals, corpus) {
+  if (signals.allTokens.size === 0 || corpus.documentCount === 0) {
+    return 0;
+  }
+  const documentTokens = topicTokenList(topic);
+  if (documentTokens.length === 0) {
+    return 0;
+  }
+  const counts = countTokens(documentTokens);
+  const docLength = documentTokens.length;
+  let score = 0;
+  for (const token of signals.allTokens) {
+    const termFrequency = counts.get(token) ?? 0;
+    if (termFrequency === 0) {
+      continue;
+    }
+    const documentFrequency = corpus.documentFrequencyByToken.get(token) ?? 0;
+    const idf = Math.log(
+      1 + (corpus.documentCount - documentFrequency + 0.5) / (documentFrequency + 0.5)
+    );
+    const denominator = termFrequency + BM25_K1 * (1 - BM25_B + BM25_B * (docLength / corpus.averageDocumentLength));
+    score += idf * (termFrequency * (BM25_K1 + 1) / denominator);
+  }
+  return score / (score + BM25_NORMALIZATION);
+}
 function scoreTopicMatch(topic, input) {
+  return scoreTopicMatchWithCorpus(
+    topic,
+    input,
+    buildTopicScoreCorpus([topic])
+  );
+}
+function scoreTopicMatchWithCorpus(topic, input, corpus) {
   const signals = buildSignalBag(input);
   const topicTokens = topicTokenSet(topic);
   if (signals.allTokens.size === 0 || topicTokens.size === 0) {
@@ -15071,6 +15317,7 @@ function scoreTopicMatch(topic, input) {
   }
   const union = (/* @__PURE__ */ new Set([...signals.allTokens, ...topicTokens])).size;
   const jaccard = union > 0 ? intersection / union : 0;
+  const bm25 = bm25Score(topic, signals, corpus);
   const topicSlug = topicNameSlug(topic.name);
   let boost = 0;
   for (const token of signals.tagTokens) {
@@ -15091,7 +15338,7 @@ function scoreTopicMatch(topic, input) {
       break;
     }
   }
-  return Math.max(0, Math.min(1, jaccard + boost));
+  return Math.max(0, Math.min(1, bm25 * 0.55 + jaccard * 0.45 + boost));
 }
 function normalizeTopicCandidate(value) {
   const record = asRecord2(value);
@@ -15113,26 +15360,21 @@ function normalizeTopicCandidate(value) {
     globalId: readString2(record.globalId)
   };
 }
-function topicMatchesScope(topic, tenantId, workspaceId) {
-  if (topic.status === "archived") {
-    return false;
-  }
-  if (tenantId && topic.tenantId && topic.tenantId !== tenantId) {
-    return false;
-  }
-  if (workspaceId && topic.workspaceId && topic.workspaceId !== workspaceId) {
-    return false;
-  }
-  return true;
-}
 async function fetchTopicById(ctx, topicId) {
   const normalizedTopicId = normalizeTopicId(topicId);
   if (!normalizedTopicId) {
     return null;
   }
-  const topic = await getConvex(ctx).query(api.topics.get, {
-    id: normalizedTopicId
-  }).catch(() => null);
+  let topic = null;
+  try {
+    topic = await getConvex(ctx).query(api.topics.get, {
+      id: normalizedTopicId
+    });
+  } catch (error) {
+    debugServerCoreFallback("topic-resolver", `fetchTopicById: topics.get(${normalizedTopicId})`, {
+      error: formatUnknownError(error)
+    });
+  }
   return normalizeTopicCandidate(topic);
 }
 function readRecordTopicId(value) {
@@ -15142,7 +15384,14 @@ function readRecordTopicId(value) {
   );
 }
 async function fetchRecordTopicId(ctx, reference, args) {
-  const result = await getConvex(ctx).query(reference, args).catch(() => null);
+  let result = null;
+  try {
+    result = await getConvex(ctx).query(reference, args);
+  } catch (error) {
+    debugServerCoreFallback("topic-resolver", "fetchRecordTopicId", {
+      error: formatUnknownError(error)
+    });
+  }
   return readRecordTopicId(result);
 }
 async function resolveBeliefTopicId(ctx, beliefId) {
@@ -15185,12 +15434,9 @@ async function resolveTopicIdFromEvidenceTarget(ctx, targetId, targetType) {
   if (targetType === "belief") {
     return resolveBeliefTopicId(ctx, normalizedTargetId);
   }
-  try {
-    const decoded = decodePrefixedId(normalizedTargetId);
-    if (decoded.prefix === "que") {
-      return resolveQuestionTopicId(ctx, normalizedTargetId);
-    }
-  } catch {
+  const decoded = decodePrefixedIdOrNull(normalizedTargetId);
+  if (decoded?.prefix === "que") {
+    return resolveQuestionTopicId(ctx, normalizedTargetId);
   }
   return resolveBeliefTopicId(ctx, normalizedTargetId);
 }
@@ -15202,7 +15448,9 @@ async function resolveCommonBeliefTopicId(ctx, beliefIds) {
     return void 0;
   }
   const resolvedTopicIds = (await Promise.all(
-    normalizedBeliefIds.map((beliefId) => resolveBeliefTopicId(ctx, beliefId))
+    normalizedBeliefIds.map(
+      (beliefId) => resolveBeliefTopicId(ctx, beliefId)
+    )
   )).filter((topicId) => Boolean(topicId));
   if (resolvedTopicIds.length !== normalizedBeliefIds.length) {
     return void 0;
@@ -15211,17 +15459,31 @@ async function resolveCommonBeliefTopicId(ctx, beliefIds) {
 }
 async function fetchTopicTree(ctx) {
   const convex = getConvex(ctx);
-  const tree = await convex.query(api.topics.getTree, {
-    rootId: ROOT_TOPIC_ID,
-    maxDepth: TREE_MAX_DEPTH
-  }).catch(() => null);
+  let tree = null;
+  try {
+    tree = await convex.query(api.topics.getTree, {
+      rootId: ROOT_TOPIC_ID,
+      maxDepth: TREE_MAX_DEPTH
+    });
+  } catch (error) {
+    debugServerCoreFallback("topic-resolver", "fetchTopicTree: topics.getTree", {
+      error: formatUnknownError(error)
+    });
+  }
   const normalizedTree = Array.isArray(tree) ? tree.map((topic) => normalizeTopicCandidate(topic)).filter((topic) => Boolean(topic)) : [];
   if (normalizedTree.length > 0) {
     return normalizedTree;
   }
-  const listed = await convex.query(api.topics.list, {
-    status: "active"
-  }).catch(() => []);
+  let listed = [];
+  try {
+    listed = await convex.query(api.topics.list, {
+      status: "active"
+    });
+  } catch (error) {
+    debugServerCoreFallback("topic-resolver", "fetchTopicTree: topics.list fallback", {
+      error: formatUnknownError(error)
+    });
+  }
   return Array.isArray(listed) ? listed.map((topic) => normalizeTopicCandidate(topic)).filter((topic) => Boolean(topic)) : [];
 }
 function buildTopicMaps(topics2) {
@@ -15254,42 +15516,43 @@ function buildPath(topicId, byId) {
 function titleCase(value) {
   return value.replace(/\b[a-z]/g, (match) => match.toUpperCase());
 }
-function compactWhitespace(value) {
-  return value.replace(/\s+/g, " ").trim();
-}
 function deriveTopicName(input, parentTopic) {
   const textualHint = readString2(input.topicHint);
   if (textualHint && tokenize(textualHint).length > 0) {
-    return titleCase(compactWhitespace(textualHint)).slice(0, 60);
+    return titleCase(textualHint.replace(/\s+/g, " ").trim()).slice(0, 60);
   }
   const firstTag = (input.tags ?? []).find((tag) => tokenize(tag).length > 0);
   if (firstTag) {
-    return titleCase(compactWhitespace(firstTag)).slice(0, 60);
+    return titleCase(firstTag.replace(/\s+/g, " ").trim()).slice(0, 60);
   }
   const firstPathStem = (input.touchedPaths ?? []).map((filePath) => basenameStem(filePath)).find((stem) => stem && tokenize(stem).length > 0);
   if (firstPathStem) {
-    return titleCase(compactWhitespace(firstPathStem.replace(/[-_]+/g, " "))).slice(0, 60);
+    return titleCase(
+      firstPathStem.replace(/[-_]+/g, " ").replace(/\s+/g, " ").trim()
+    ).slice(0, 60);
   }
-  const summary = compactWhitespace(input.summary);
+  const summary = input.summary.replace(/\s+/g, " ").trim();
   if (summary.length > 0) {
     return titleCase(summary.slice(0, 60));
   }
   const sourceRef = readString2(input.sourceRef);
   if (sourceRef) {
-    return titleCase(compactWhitespace(sourceRef.replace(/[-_:/]+/g, " "))).slice(0, 60);
+    return titleCase(
+      sourceRef.replace(/[-_:/]+/g, " ").replace(/\s+/g, " ").trim()
+    ).slice(0, 60);
   }
-  return `${titleCase(parentTopic.name)} Subtopic`;
+  return parentTopic ? `${titleCase(parentTopic.name)} Subtopic` : "Lucern";
 }
-async function createChildTopic(ctx, parentTopic, input) {
+async function createTopic(ctx, input, parentTopic) {
   const convex = getConvex(ctx);
   const desiredTenantId = ctx.tenantId;
   const desiredWorkspaceId = readString2(input.workspaceId) ?? ctx.workspaceId;
   const createdBy = ctx.principalId ?? ctx.userId;
   const created = await convex.mutation(api.topics.create, {
     name: deriveTopicName(input, parentTopic),
-    description: compactWhitespace(input.summary).slice(0, 280) || void 0,
+    description: input.summary.replace(/\s+/g, " ").trim().slice(0, 280) || void 0,
     type: "theme",
-    parentTopicId: parentTopic.rawId,
+    ...parentTopic ? { parentTopicId: parentTopic.rawId } : {},
     tenantId: desiredTenantId,
     workspaceId: desiredWorkspaceId,
     visibility: "team",
@@ -15306,10 +15569,18 @@ async function createChildTopic(ctx, parentTopic, input) {
   const createdId = readString2(createdRecord.id) ?? readString2(createdRecord.topicId) ?? readString2(createdRecord._id);
   const hydrated = await fetchTopicById(ctx, createdId);
   if (!hydrated) {
-    throw new Error("[topic-resolver] Auto-created topic could not be reloaded.");
+    throw new Error(
+      "[topic-resolver] Auto-created topic could not be reloaded."
+    );
   }
   return hydrated;
 }
+function createChildTopic(ctx, parentTopic, input) {
+  return createTopic(ctx, input, parentTopic);
+}
+function createRootTopic(ctx, input) {
+  return createTopic(ctx, input);
+}
 function pushTrace(trace, topic, score) {
   const existing = trace[trace.length - 1];
   if (existing?.topicId === topic.rawId) {
@@ -15324,9 +15595,10 @@ function pushTrace(trace, topic, score) {
   });
 }
 function pickBestTopic(topics2, input) {
+  const corpus = buildTopicScoreCorpus(topics2);
   const ranked = topics2.filter((topic) => topic.status !== "archived").map((topic) => ({
     topic,
-    score: scoreTopicMatch(topic, input)
+    score: scoreTopicMatchWithCorpus(topic, input, corpus)
   })).sort((left, right) => {
     if (right.score !== left.score) {
       return right.score - left.score;
@@ -15342,27 +15614,31 @@ function pickFallbackRootTopic(topics2, input) {
   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 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;
+  let candidatePool = rawTopics;
+  let root = pickFallbackRootTopic(candidatePool, input) ?? candidatePool.find((topic) => !topic.parentTopicId) ?? candidatePool[0] ?? null;
+  let rootCreated = false;
   if (!root) {
-    throw new Error("[topic-resolver] Root topic not found.");
+    if (input.autoCreate === false) {
+      throw new Error(
+        "[topic-resolver] No topics available for resolution."
+      );
+    }
+    root = await createRootTopic(ctx, input);
+    rootCreated = true;
+    candidatePool = [root];
   }
-  const topics2 = rawTopics.filter(
-    (topic) => topic.rawId === root.rawId || topicMatchesScope(topic, desiredTenantId, desiredWorkspaceId)
-  );
   const dedupedTopics = /* @__PURE__ */ new Map();
   dedupedTopics.set(root.rawId, root);
-  for (const topic of topics2) {
+  for (const topic of candidatePool) {
     dedupedTopics.set(topic.rawId, topic);
   }
-  const { byId, childrenByParent } = buildTopicMaps([...dedupedTopics.values()]);
+  const { byId, childrenByParent } = buildTopicMaps([
+    ...dedupedTopics.values()
+  ]);
   return {
     root,
+    rootCreated,
     byId,
     childrenByParent
   };
@@ -15373,7 +15649,9 @@ async function validateTopicOrNull(ctx, topicId) {
     return null;
   }
   const { byId } = await loadTopicUniverse(ctx, {
-    summary: topic.name});
+    summary: topic.name,
+    autoCreate: false
+  });
   if (!byId.has(topic.rawId)) {
     byId.set(topic.rawId, topic);
   }
@@ -15395,8 +15673,10 @@ async function resolveTopicForWrite(ctx, input) {
   const threshold = typeof input.threshold === "number" && Number.isFinite(input.threshold) ? Math.max(0, Math.min(1, input.threshold)) : DEFAULT_THRESHOLD;
   const createThreshold = Math.max(0.5, Math.min(1, threshold + 0.15));
   const autoCreate = input.autoCreate !== false;
-  const { root, byId, childrenByParent } = await loadTopicUniverse(ctx, input);
+  const { root, rootCreated, byId, childrenByParent } = await loadTopicUniverse(ctx, input);
   const trace = [];
+  const scoreCorpus = buildTopicScoreCorpus(byId.values());
+  const scoreTopic = (topic) => scoreTopicMatchWithCorpus(topic, input, scoreCorpus);
   const ownScore = /* @__PURE__ */ new Map();
   const subtreeScore = /* @__PURE__ */ new Map();
   const computeSubtreeScore = (topicId, visited) => {
@@ -15413,7 +15693,7 @@ async function resolveTopicForWrite(ctx, input) {
       return 0;
     }
     if (!ownScore.has(topicId)) {
-      ownScore.set(topicId, scoreTopicMatch(topic, input));
+      ownScore.set(topicId, scoreTopic(topic));
     }
     let best = ownScore.get(topicId);
     for (const child of childrenByParent.get(topicId) ?? []) {
@@ -15425,7 +15705,7 @@ async function resolveTopicForWrite(ctx, input) {
   };
   computeSubtreeScore(root.rawId, /* @__PURE__ */ new Set());
   let current = root;
-  let currentScore = ownScore.get(root.rawId) ?? scoreTopicMatch(root, input);
+  let currentScore = ownScore.get(root.rawId) ?? scoreTopic(root);
   pushTrace(trace, current, currentScore);
   while (true) {
     const children = (childrenByParent.get(current.rawId) ?? []).filter(
@@ -15436,7 +15716,7 @@ async function resolveTopicForWrite(ctx, input) {
     }
     const rankedChildren = children.map((topic) => {
       if (!ownScore.has(topic.rawId)) {
-        ownScore.set(topic.rawId, scoreTopicMatch(topic, input));
+        ownScore.set(topic.rawId, scoreTopic(topic));
       }
       return {
         topic,
@@ -15448,13 +15728,13 @@ async function resolveTopicForWrite(ctx, input) {
       break;
     }
     current = bestChild.topic;
-    currentScore = ownScore.get(current.rawId) ?? scoreTopicMatch(current, input);
+    currentScore = ownScore.get(current.rawId) ?? scoreTopic(current);
     pushTrace(trace, current, currentScore);
   }
-  let created = false;
+  let created = rootCreated;
   let resolvedTopic = current;
   let finalScore = currentScore;
-  if (autoCreate && finalScore < createThreshold) {
+  if (autoCreate && !rootCreated && finalScore < createThreshold) {
     const siblings = childrenByParent.get(current.rawId) ?? [];
     const derivedName = deriveTopicName(input, current).toLowerCase();
     const existingSibling = siblings.find(
@@ -15462,7 +15742,7 @@ async function resolveTopicForWrite(ctx, input) {
     );
     if (existingSibling) {
       resolvedTopic = existingSibling;
-      finalScore = scoreTopicMatch(existingSibling, input);
+      finalScore = scoreTopic(existingSibling);
       pushTrace(trace, resolvedTopic, finalScore);
     } else {
       resolvedTopic = await createChildTopic(ctx, current, input);
@@ -15486,6 +15766,23 @@ async function resolveTopicForWrite(ctx, input) {
     trace
   };
 }
+async function resolveTopicIdForWrite(ctx, input) {
+  const explicitTopicId = normalizeTopicId(input.topicId);
+  const explicit = await validateTopicOrNull(ctx, explicitTopicId);
+  if (explicit) {
+    return explicit;
+  }
+  if (explicitTopicId) {
+    console.warn(
+      `[topic-resolver] Explicit topicId "${explicitTopicId}" is invalid or stale. Falling back to hop-by-hop topic resolution.`
+    );
+  }
+  return resolveTopicForWrite(ctx, {
+    ...input,
+    topicHint: input.topicHint ?? explicitTopicId,
+    autoCreate: explicitTopicId ? false : input.autoCreate
+  });
+}
 
 // ../server-core/src/beliefs.ts
 function resolveBeliefNodeId(value) {
@@ -16454,39 +16751,47 @@ function resolveExternalId2(value) {
   if (!value) {
     return value;
   }
+  return resolveNodeId(value);
+}
+function resolveNodeId(value) {
   try {
     return decodePrefixedId(value).value;
-  } catch {
+  } catch (_error) {
     return value;
   }
 }
+async function queryWithFallback(label, run, fallback) {
+  try {
+    return await run();
+  } catch (error) {
+    debugServerCoreFallback("edges", label, {
+      error: formatUnknownError(error)
+    });
+    return fallback;
+  }
+}
 async function fetchNodeWithQuery(runQuery, id) {
   if (!id.trim()) {
     return null;
   }
-  const rawId = (() => {
-    try {
-      return decodePrefixedId(id).value;
-    } catch {
-      return id;
-    }
-  })();
-  try {
-    const byNodeId = await runQuery(api.epistemicNodes.get, {
+  const rawId = resolveNodeId(id);
+  const byNodeId = await queryWithFallback(
+    `fetchNodeWithQuery local id lookup for ${id}`,
+    () => runQuery(api.epistemicNodes.get, {
       nodeId: rawId
-    });
-    if (byNodeId) {
-      return byNodeId;
-    }
-  } catch {
+    }),
+    null
+  );
+  if (byNodeId) {
+    return byNodeId;
   }
-  try {
-    return await runQuery(api.epistemicNodes.getByGlobalId, {
+  return await queryWithFallback(
+    `fetchNodeWithQuery global id lookup for ${id}`,
+    () => runQuery(api.epistemicNodes.getByGlobalId, {
       globalId: id
-    });
-  } catch {
-    return null;
-  }
+    }),
+    null
+  );
 }
 function resolveTopicIdFromNode(node) {
   const record = asRecord6(node);
@@ -16520,7 +16825,9 @@ async function ensureTopicAccessWithQuery2(runQuery, topicId, userId, contextLab
     userId
   });
   if (allowed !== true) {
-    throw new Error(`[edges] ${contextLabel} requires access to topic ${topicId}.`);
+    throw new Error(
+      `[edges] ${contextLabel} requires access to topic ${topicId}.`
+    );
   }
 }
 async function executeTraversal(runQuery, runAction, userId, input) {
@@ -16591,10 +16898,13 @@ function createGatewayEdgesPort(authContext) {
         authContext.userId,
         "list"
       );
-      const rows = await authContext.convex.query(api.epistemicEdges.getBySourceNode, {
-        sourceNodeId: args.sourceRawId,
-        edgeType: args.edgeType
-      });
+      const rows = await authContext.convex.query(
+        api.epistemicEdges.getBySourceNode,
+        {
+          sourceNodeId: args.sourceRawId,
+          edgeType: args.edgeType
+        }
+      );
       return Array.isArray(rows) ? rows.slice(0, args.limit ?? rows.length) : [];
     },
     traverseEdges(input) {
@@ -17357,17 +17667,11 @@ function normalizeGlobalIds(input) {
   }
   return [...ids];
 }
-function normalizeGraphNode(value) {
-  return asRecord8(value);
-}
-function normalizeGraphEdge(value) {
-  return asRecord8(value);
-}
 function normalizeNeighborhoodResult(value, maxDepth) {
   const payload = asRecord8(value);
   return {
-    nodes: asRecordArray(payload.nodes).map(normalizeGraphNode),
-    edges: asRecordArray(payload.edges).map(normalizeGraphEdge),
+    nodes: asRecordArray(payload.nodes).map(asRecord8),
+    edges: asRecordArray(payload.edges).map(asRecord8),
     depth: normalizeDepth(payload.depth, maxDepth)
   };
 }
@@ -17377,8 +17681,8 @@ function normalizeTraverseResult(value, input) {
     startNode: readString9(payload.startNode) ?? input.startNode,
     direction: normalizeDirection2(payload.direction ?? input.direction),
     maxDepth: normalizeDepth(payload.maxDepth, input.maxDepth),
-    nodes: asRecordArray(payload.nodes).map(normalizeGraphNode),
-    edges: asRecordArray(payload.edges).map(normalizeGraphEdge),
+    nodes: asRecordArray(payload.nodes).map(asRecord8),
+    edges: asRecordArray(payload.edges).map(asRecord8),
     depth: normalizeDepth(payload.depth, input.maxDepth),
     ...readString9(payload.topicId) ?? readString9(input.topicId) ? { topicId: readString9(payload.topicId) ?? readString9(input.topicId) } : {}
   };
@@ -17835,6 +18139,20 @@ async function answerQuestion(deps, input) {
 }
 
 // ../server-core/src/questions.ts
+function normalizePrefixedId(value, prefix) {
+  if (!value) {
+    return value;
+  }
+  try {
+    const decoded = decodePrefixedId(value);
+    if (prefix && decoded.prefix !== prefix) {
+      return value;
+    }
+    return decoded.value;
+  } catch (_error) {
+    return value;
+  }
+}
 function normalizeAnswerConfidence2(value) {
   if (value === "medium") {
     return "moderate";
@@ -17855,26 +18173,18 @@ function readStringArray5(value) {
   const items = value.map((entry) => readString11(entry)).filter((entry) => Boolean(entry));
   return items.length > 0 ? items : void 0;
 }
-function resolveExternalId4(value, prefix) {
-  if (!value) {
-    return value;
-  }
-  try {
-    const decoded = decodePrefixedId(value);
-    if (prefix && decoded.prefix !== prefix) {
-      return value;
-    }
-    return decoded.value;
-  } catch {
-    return value;
-  }
+function isRecord4(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
 }
 async function resolveQuestionTopicIdWithGatewayAuth(authContext, questionId) {
-  const question = await authContext.convex.query(api.epistemicQuestions.getById, {
-    questionId,
-    nodeId: questionId
-  });
-  return readString11(question?.topicId);
+  const question = await authContext.convex.query(
+    api.epistemicQuestions.getById,
+    {
+      questionId,
+      nodeId: questionId
+    }
+  );
+  return isRecord4(question) ? readString11(question.topicId) : void 0;
 }
 async function emitQuestionEventFromGatewayAuth(authContext, args) {
   return emitDomainEvent(
@@ -17906,8 +18216,8 @@ function normalizeLatestAnswerRecord(questionId, answer) {
       questionNodeId: questionId
     };
   }
-  const record = answer;
-  const metadata = record.metadata && typeof record.metadata === "object" && !Array.isArray(record.metadata) ? record.metadata : {};
+  const record = isRecord4(answer) ? answer : {};
+  const metadata = isRecord4(record.metadata) ? record.metadata : {};
   return {
     nodeId: typeof record._id === "string" ? record._id : null,
     globalId: typeof record.globalId === "string" ? record.globalId : null,
@@ -17946,10 +18256,13 @@ function createGatewayQuestionsPort(authContext) {
       });
     },
     refineQuestion(input) {
-      return authContext.convex.mutation(api.epistemicQuestions.updateQuestion, {
-        questionId: input.questionRawId,
-        question: input.text
-      });
+      return authContext.convex.mutation(
+        api.epistemicQuestions.updateQuestion,
+        {
+          questionId: input.questionRawId,
+          question: input.text
+        }
+      );
     },
     updateQuestionStatus(input) {
       return authContext.convex.mutation(api.epistemicQuestions.updateStatus, {
@@ -17992,10 +18305,13 @@ async function createQuestionFromGatewayAuth(authContext, input) {
     sourceKind: "question",
     autoCreate: input.topicId ? false : true
   });
-  const payload = await createQuestion(createGatewayQuestionsPort(authContext), {
-    ...input,
-    topicId: resolvedTopic.topicId
-  });
+  const payload = await createQuestion(
+    createGatewayQuestionsPort(authContext),
+    {
+      ...input,
+      topicId: resolvedTopic.topicId
+    }
+  );
   await emitQuestionEventFromGatewayAuth(authContext, {
     topicId: payload.topicId ?? resolvedTopic.topicId,
     type: "question.created",
@@ -18017,9 +18333,15 @@ function listQuestionsFromGatewayAuth(authContext, query) {
   return listQuestions(createGatewayQuestionsPort(authContext), query);
 }
 async function answerQuestionFromGatewayAuth(authContext, input) {
-  const payload = await answerQuestion(createGatewayQuestionsPort(authContext), input);
+  const payload = await answerQuestion(
+    createGatewayQuestionsPort(authContext),
+    input
+  );
   await emitQuestionEventFromGatewayAuth(authContext, {
-    topicId: await resolveQuestionTopicIdWithGatewayAuth(authContext, payload.questionId) ?? "",
+    topicId: await resolveQuestionTopicIdWithGatewayAuth(
+      authContext,
+      payload.questionId
+    ) ?? "",
     type: "question.answered",
     resourceId: payload.questionId,
     data: {
@@ -18043,13 +18365,16 @@ async function getQuestionAnswerFromGatewayAuth(authContext, questionId) {
   return normalizeLatestAnswerRecord(questionId, answer);
 }
 async function refineQuestionFromGatewayAuth(authContext, input) {
-  const payload = await refineQuestion(createGatewayQuestionsPort(authContext), input);
+  const payload = await refineQuestion(
+    createGatewayQuestionsPort(authContext),
+    input
+  );
   await emitQuestionEventFromGatewayAuth(authContext, {
     topicId: payload.topicId ?? "",
     type: "question.refined",
     resourceId: payload.id,
     data: {
-      previousText: typeof payload.previousText === "string" ? payload.previousText : void 0,
+      previousText: isRecord4(payload) && typeof payload.previousText === "string" ? payload.previousText : void 0,
       text: payload.text,
       rationale: input.rationale
     }
@@ -18057,7 +18382,10 @@ async function refineQuestionFromGatewayAuth(authContext, input) {
   return payload;
 }
 async function archiveQuestionFromGatewayAuth(authContext, input) {
-  const payload = await archiveQuestion(createGatewayQuestionsPort(authContext), input);
+  const payload = await archiveQuestion(
+    createGatewayQuestionsPort(authContext),
+    input
+  );
   await emitQuestionEventFromGatewayAuth(authContext, {
     topicId: payload.topicId ?? "",
     type: "question.archived",
@@ -18080,15 +18408,17 @@ async function updateQuestionStatusFromGatewayAuth(authContext, input) {
     type: "question.status_updated",
     resourceId: payload.id,
     data: {
-      previousStatus: typeof payload.previousStatus === "string" ? payload.previousStatus : void 0,
-      newStatus: typeof payload.newStatus === "string" ? payload.newStatus : payload.status,
+      previousStatus: isRecord4(payload) && typeof payload.previousStatus === "string" ? payload.previousStatus : void 0,
+      newStatus: isRecord4(payload) && typeof payload.newStatus === "string" ? payload.newStatus : payload.status,
       rationale: input.rationale
     }
   });
   return payload;
 }
 function createQuestionsBatchFromGatewayAuth(authContext, input) {
-  const linkedBeliefIds = input.questions.map((question) => question.linkedBeliefNodeId).filter((questionId) => Boolean(readString11(questionId)));
+  const linkedBeliefIds = input.questions.map((question) => question.linkedBeliefNodeId).filter(
+    (questionId) => Boolean(readString11(questionId))
+  );
   const linkedWorktreeIds = [
     ...new Set(
       input.questions.map((question) => question.linkedWorktreeId).filter(
@@ -18120,22 +18450,19 @@ function createQuestionsBatchFromGatewayAuth(authContext, input) {
       sourceKind: "question_batch",
       autoCreate: input.topicId ? false : true
     })).topicId;
-    return authContext.convex.mutation(
-      api.epistemicQuestions.createBatch,
-      {
-        topicId: resolvedTopicId,
-        questions: input.questions.map((question) => ({
-          ...question,
-          linkedBeliefNodeId: resolveExternalId4(
-            question.linkedBeliefNodeId,
-            "bel"
-          ),
-          linkedWorktreeId: resolveExternalId4(question.linkedWorktreeId, "wt")
-        })),
-        source: input.source,
-        userId: authContext.userId
-      }
-    );
+    return authContext.convex.mutation(api.epistemicQuestions.createBatch, {
+      topicId: resolvedTopicId,
+      questions: input.questions.map((question) => ({
+        ...question,
+        linkedBeliefNodeId: normalizePrefixedId(
+          question.linkedBeliefNodeId,
+          "bel"
+        ),
+        linkedWorktreeId: normalizePrefixedId(question.linkedWorktreeId, "wt")
+      })),
+      source: input.source,
+      userId: authContext.userId
+    });
   })();
 }
 async function addQuestionFromGatewayAuth(authContext, input) {
@@ -18159,26 +18486,35 @@ async function addQuestionFromGatewayAuth(authContext, input) {
     sourceKind: input.questionType ?? "question",
     autoCreate: input.topicId ? false : true
   })).topicId;
-  const questionId = await authContext.convex.mutation(api.epistemicQuestions.addQuestion, {
-    topicId: resolvedTopicId,
-    question: input.question ?? input.text ?? "",
-    category: input.category,
-    priority: input.priority,
-    source: input.source,
-    beliefId: resolveExternalId4(input.beliefId ?? input.linkedBeliefId, "bel"),
-    linkedWorktreeId: input.linkedWorktreeId,
-    chatId: input.chatId,
-    importance: input.importance,
-    epistemicUnlock: input.epistemicUnlock,
-    metadata: input.metadata,
-    questionType: input.questionType,
-    userId: authContext.userId
-  });
+  const questionId = await authContext.convex.mutation(
+    api.epistemicQuestions.addQuestion,
+    {
+      topicId: resolvedTopicId,
+      question: input.question ?? input.text ?? "",
+      category: input.category,
+      priority: input.priority,
+      source: input.source,
+      beliefId: normalizePrefixedId(
+        input.beliefId ?? input.linkedBeliefId,
+        "bel"
+      ),
+      linkedWorktreeId: input.linkedWorktreeId,
+      chatId: input.chatId,
+      importance: input.importance,
+      epistemicUnlock: input.epistemicUnlock,
+      metadata: input.metadata,
+      questionType: input.questionType,
+      userId: authContext.userId
+    }
+  );
   return getQuestionFromGatewayAuth(authContext, String(questionId));
 }
 async function updateQuestionPriorityFromGatewayAuth(authContext, input) {
   await authContext.convex.mutation(api.epistemicQuestions.updatePriority, {
-    nodeId: resolveExternalId4(input.id ?? input.nodeId ?? input.questionId, "que") ?? "",
+    nodeId: normalizePrefixedId(
+      input.id ?? input.nodeId ?? input.questionId,
+      "que"
+    ) ?? "",
     priority: input.priority,
     userId: authContext.userId
   });
@@ -18188,15 +18524,24 @@ async function updateQuestionPriorityFromGatewayAuth(authContext, input) {
   );
 }
 function advanceQuestionToConvictionFromGatewayAuth(authContext, input) {
-  return authContext.convex.mutation(api.epistemicQuestions.advanceToConviction, {
-    questionId: resolveExternalId4(input.questionId ?? input.id ?? input.nodeId, "que") ?? "",
-    worktreeId: input.worktreeId,
-    userId: authContext.userId
-  });
+  return authContext.convex.mutation(
+    api.epistemicQuestions.advanceToConviction,
+    {
+      questionId: normalizePrefixedId(
+        input.questionId ?? input.id ?? input.nodeId,
+        "que"
+      ) ?? "",
+      worktreeId: input.worktreeId,
+      userId: authContext.userId
+    }
+  );
 }
 function updateQuestionConvictionFromGatewayAuth(authContext, input) {
   return authContext.convex.mutation(api.epistemicQuestions.updateConviction, {
-    questionId: resolveExternalId4(input.questionId ?? input.id ?? input.nodeId, "que") ?? "",
+    questionId: normalizePrefixedId(
+      input.questionId ?? input.id ?? input.nodeId,
+      "que"
+    ) ?? "",
     conviction: input.conviction,
     answerCompleteness: input.answerCompleteness,
     convictionRationale: input.convictionRationale,
@@ -18204,18 +18549,24 @@ function updateQuestionConvictionFromGatewayAuth(authContext, input) {
   });
 }
 function finalizeQuestionConvictionFromGatewayAuth(authContext, input) {
-  return authContext.convex.mutation(api.epistemicQuestions.finalizeConviction, {
-    questionId: resolveExternalId4(input.questionId ?? input.id ?? input.nodeId, "que") ?? "",
-    conviction: input.conviction,
-    answer: input.answer,
-    convictionRationale: input.convictionRationale,
-    answerCompleteness: input.answerCompleteness,
-    whatWeNeed: input.whatWeNeed,
-    userId: authContext.userId
-  });
+  return authContext.convex.mutation(
+    api.epistemicQuestions.finalizeConviction,
+    {
+      questionId: normalizePrefixedId(
+        input.questionId ?? input.id ?? input.nodeId,
+        "que"
+      ) ?? "",
+      conviction: input.conviction,
+      answer: input.answer,
+      convictionRationale: input.convictionRationale,
+      answerCompleteness: input.answerCompleteness,
+      whatWeNeed: input.whatWeNeed,
+      userId: authContext.userId
+    }
+  );
 }
 async function updateQuestionFromGatewayAuth(authContext, input) {
-  const questionId = resolveExternalId4(input.questionId ?? input.id ?? input.nodeId, "que") ?? "";
+  const questionId = normalizePrefixedId(input.questionId ?? input.id ?? input.nodeId, "que") ?? "";
   await authContext.convex.mutation(api.epistemicQuestions.updateQuestion, {
     questionId,
     question: input.question ?? input.text,
@@ -18226,7 +18577,10 @@ async function updateQuestionFromGatewayAuth(authContext, input) {
 }
 function deleteQuestionFromGatewayAuth(authContext, input) {
   return authContext.convex.mutation(api.epistemicQuestions.deleteQuestion, {
-    questionId: resolveExternalId4(input.questionId ?? input.id ?? input.nodeId, "que") ?? "",
+    questionId: normalizePrefixedId(
+      input.questionId ?? input.id ?? input.nodeId,
+      "que"
+    ) ?? "",
     userId: authContext.userId
   });
 }
@@ -18267,7 +18621,7 @@ function matchesOptionalString(actual, expected) {
   }
   return readString12(actual) === expected;
 }
-function normalizeGraphNode2(row) {
+function normalizeGraphNode(row) {
   const record = asRecord10(row);
   const nodeId = readString12(record.nodeId) ?? readString12(record._id);
   const globalId = readString12(record.globalId);
@@ -18279,7 +18633,7 @@ function normalizeGraphNode2(row) {
     ...text ? { text, canonicalText: text } : {}
   };
 }
-function normalizeGraphEdge2(row) {
+function normalizeGraphEdge(row) {
   const record = asRecord10(row);
   const edgeId = readString12(record.edgeId) ?? readString12(record._id);
   return {
@@ -18294,13 +18648,13 @@ async function fetchGraphNodeByIdentifier(authContext, input) {
     const node = await authContext.convex.query(api.epistemicNodes.get, {
       nodeId: input.nodeId
     });
-    return node ? normalizeGraphNode2(node) : null;
+    return node ? normalizeGraphNode(node) : null;
   }
   if (input.globalId) {
     const node = await authContext.convex.query(api.epistemicNodes.getByGlobalId, {
       globalId: input.globalId
     });
-    return node ? normalizeGraphNode2(node) : null;
+    return node ? normalizeGraphNode(node) : null;
   }
   return null;
 }
@@ -18538,7 +18892,7 @@ async function listGraphNodesFromGatewayAuth(authContext, input) {
     userId: authContext.userId,
     limit: normalizeLimit(input.limit, 250, 1e3)
   });
-  const nodes = asRecordArray2(rows).map(normalizeGraphNode2).filter((node) => matchesOptionalString(node.nodeType, input.nodeType));
+  const nodes = asRecordArray2(rows).map(normalizeGraphNode).filter((node) => matchesOptionalString(node.nodeType, input.nodeType));
   return { items: nodes, nodes, total: nodes.length };
 }
 async function listGraphEdgesFromGatewayAuth(authContext, input) {
@@ -18551,7 +18905,7 @@ async function listGraphEdgesFromGatewayAuth(authContext, input) {
     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));
+  const edges = asRecordArray2(rows).map(normalizeGraphEdge).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 };
 }
 
@@ -20008,7 +20362,7 @@ function classifyCoverage(beliefs, questions, evidence) {
   }
   return "partial";
 }
-async function createTopic(deps, input) {
+async function createTopic2(deps, input) {
   const created = await deps.createTopic({
     name: requireString2(input.name, "name"),
     description: readString18(input.description),
@@ -20195,24 +20549,29 @@ async function emitTopicEventFromGatewayAuth(authContext, args) {
     }
   );
 }
+function normalizePrefixedId2(value) {
+  try {
+    const decoded = decodePrefixedId(value);
+    return decoded.prefix === "top" ? decoded.value : value;
+  } catch (_error) {
+    return value;
+  }
+}
+function isRecord5(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
 function normalizeTopicEventId(topicId) {
   const normalized = topicId.trim();
   if (!normalized) {
     return normalized;
   }
-  try {
-    const decoded = decodePrefixedId(normalized);
-    return decoded.prefix === "top" ? decoded.value : normalized;
-  } catch {
-    return normalized;
-  }
+  return normalizePrefixedId2(normalized);
 }
 function readCanonicalTopicRawId(value) {
-  if (!value || typeof value !== "object" || Array.isArray(value)) {
+  if (!isRecord5(value)) {
     return void 0;
   }
-  const record = value;
-  for (const candidate of [record._id, record.id, record.topicId, record.projectId]) {
+  for (const candidate of [value._id, value.id, value.topicId, value.projectId]) {
     if (typeof candidate === "string" && candidate.trim().length > 0) {
       return normalizeTopicEventId(candidate);
     }
@@ -20291,7 +20650,10 @@ function createGatewayTopicsPort(authContext) {
   };
 }
 async function createTopicFromGatewayAuth(authContext, input) {
-  const payload = await createTopic(createGatewayTopicsPort(authContext), input);
+  const payload = await createTopic2(
+    createGatewayTopicsPort(authContext),
+    input
+  );
   await emitTopicEventFromGatewayAuth(authContext, {
     topicId: normalizeTopicEventId(payload.topicId),
     type: "topic.created",
@@ -20308,7 +20670,10 @@ async function createTopicFromGatewayAuth(authContext, input) {
   return payload;
 }
 async function updateTopicFromGatewayAuth(authContext, input) {
-  const payload = await updateTopic(createGatewayTopicsPort(authContext), input);
+  const payload = await updateTopic(
+    createGatewayTopicsPort(authContext),
+    input
+  );
   await emitTopicEventFromGatewayAuth(authContext, {
     topicId: normalizeTopicEventId(payload.topicId),
     type: payload.status === "archived" ? "topic.archived" : "topic.updated",
@@ -20345,7 +20710,7 @@ async function removeTopicFromGatewayAuth(authContext, input) {
     id: normalizedId
   });
   return {
-    ...payload,
+    ...isRecord5(payload) ? payload : {},
     id: input.id
   };
 }
@@ -20979,7 +21344,7 @@ function toSubjectiveLogicOpinion(confidence) {
     baseRate: 0.5
   };
 }
-function resolveExternalId5(value, prefix) {
+function normalizePrefixedId3(value, prefix) {
   if (!value) {
     return value;
   }
@@ -20989,26 +21354,28 @@ function resolveExternalId5(value, prefix) {
       return value;
     }
     return decoded.value;
-  } catch {
+  } catch (_error) {
     return value;
   }
 }
+function isRecord6(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
 function summarizeWorktreeCollection(rows) {
   const worktrees2 = Array.isArray(rows) ? rows : [];
   const lanes = {};
   const campaigns = {};
   for (const row of worktrees2) {
-    if (!row || typeof row !== "object" || Array.isArray(row)) {
+    if (!isRecord6(row)) {
       continue;
     }
-    const record = row;
-    const lane = typeof record.lane === "string" && record.lane.trim().length > 0 ? record.lane.trim() : "unlaned";
+    const lane = typeof row.lane === "string" && row.lane.trim().length > 0 ? row.lane.trim() : "unlaned";
     lanes[lane] = (lanes[lane] ?? 0) + 1;
-    const campaignValue = typeof record.campaign === "number" ? String(record.campaign) : "uncampaigned";
+    const campaignValue = typeof row.campaign === "number" ? String(row.campaign) : "uncampaigned";
     campaigns[campaignValue] = (campaigns[campaignValue] ?? 0) + 1;
   }
   return {
-    worktrees: worktrees2,
+    worktrees: worktrees2.filter(isRecord6),
     total: worktrees2.length,
     lanes,
     campaigns
@@ -21068,7 +21435,7 @@ function readString20(value) {
   return normalized.length > 0 ? normalized : void 0;
 }
 function withRequestedWorktreeId(payload, worktreeId) {
-  if (!payload || typeof payload !== "object" || Array.isArray(payload)) {
+  if (!isRecord6(payload)) {
     return payload;
   }
   return {
@@ -21080,7 +21447,7 @@ async function resolveWorktreeTopicIdWithGatewayAuth(authContext, worktreeId) {
   const worktree = await authContext.convex.query(api.worktrees.get, {
     worktreeId
   });
-  return readString20(worktree?.topicId);
+  return isRecord6(worktree) ? readString20(worktree.topicId) : void 0;
 }
 async function emitWorktreeEventFromGatewayAuth(authContext, args) {
   return emitDomainEvent(
@@ -21124,8 +21491,30 @@ function createGatewayWorktreesPort(authContext) {
     },
     async createWorktree(input) {
       const shouldAutoShape = input.autoShape === true || Boolean(input.domainPackId?.trim());
-      const created = shouldAutoShape ? await authContext.convex.mutation(api.worktrees.createShaped, {
-        ...buildCreateMutationArgs(
+      const created = shouldAutoShape ? await authContext.convex.mutation(
+        api.worktrees.createShaped,
+        {
+          ...buildCreateMutationArgs(
+            {
+              ...input,
+              topicId: input.topicRawId,
+              title: input.title,
+              beliefIds: input.beliefRawIds,
+              targetBeliefIds: input.targetBeliefRawIds,
+              targetQuestionIds: input.targetQuestionRawIds
+            },
+            authContext.userId
+          ),
+          ...input.domainPackId?.trim() ? { domainPackId: input.domainPackId.trim() } : {},
+          ...typeof input.autoShape === "boolean" ? { autoShape: input.autoShape } : {},
+          ...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 } : {}
+        }
+      ) : await authContext.convex.mutation(
+        api.worktrees.create,
+        buildCreateMutationArgs(
           {
             ...input,
             topicId: input.topicRawId,
@@ -21135,26 +21524,10 @@ function createGatewayWorktreesPort(authContext) {
             targetQuestionIds: input.targetQuestionRawIds
           },
           authContext.userId
-        ),
-        ...input.domainPackId?.trim() ? { domainPackId: input.domainPackId.trim() } : {},
-        ...typeof input.autoShape === "boolean" ? { autoShape: input.autoShape } : {},
-        ...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 } : {}
-      }) : await authContext.convex.mutation(api.worktrees.create, buildCreateMutationArgs(
-        {
-          ...input,
-          topicId: input.topicRawId,
-          title: input.title,
-          beliefIds: input.beliefRawIds,
-          targetBeliefIds: input.targetBeliefRawIds,
-          targetQuestionIds: input.targetQuestionRawIds
-        },
-        authContext.userId
-      ));
+        )
+      );
       if (!shouldAutoShape && (Array.isArray(input.proofArtifacts) || input.staffingHint || typeof input.lastReconciledAt === "number" || input.autoFixPolicy)) {
-        const createdRecord = created && typeof created === "object" ? created : {};
+        const createdRecord = isRecord6(created) ? created : {};
         const worktreeId = typeof created === "string" ? created : typeof createdRecord.worktreeId === "string" ? createdRecord.worktreeId : "";
         if (worktreeId) {
           await authContext.convex.mutation(api.worktrees.updateMetadata, {
@@ -21185,14 +21558,17 @@ function createGatewayWorktreesPort(authContext) {
     },
     scoreBeliefOutcome(args) {
       const opinion = toSubjectiveLogicOpinion(args.confidence);
-      return authContext.convex.mutation(api.epistemicBeliefs.modulateConfidence, {
-        nodeId: args.beliefRawId,
-        trigger: "worktree_outcome",
-        rationale: args.rationale,
-        userId: authContext.userId,
-        triggeringWorktreeId: args.worktreeRawId,
-        ...opinion
-      });
+      return authContext.convex.mutation(
+        api.epistemicBeliefs.modulateConfidence,
+        {
+          nodeId: args.beliefRawId,
+          trigger: "worktree_outcome",
+          rationale: args.rationale,
+          userId: authContext.userId,
+          triggeringWorktreeId: args.worktreeRawId,
+          ...opinion
+        }
+      );
     },
     updateWorktreeMetadata(input) {
       return authContext.convex.mutation(api.worktrees.updateMetadata, {
@@ -21226,16 +21602,44 @@ function createGatewayWorktreesPort(authContext) {
           removeBeliefIds: input.removeBeliefRawIds.map((id) => id)
         } : {},
         ...input.removeQuestionRawIds?.length ? {
-          removeQuestionIds: input.removeQuestionRawIds.map((id) => id)
+          removeQuestionIds: input.removeQuestionRawIds.map(
+            (id) => id
+          )
         } : {}
       });
     }
   };
 }
 async function createWorktreeFromGatewayAuth(authContext, input) {
-  const payload = await createWorktree(createGatewayWorktreesPort(authContext), input);
+  const explicitTopicId = readString20(input.topicId);
+  const resolvedTopic = await resolveTopicIdForWrite(authContext, {
+    topicId: explicitTopicId,
+    topicHint: readString20(input.topicHint) ?? explicitTopicId,
+    workspaceId: authContext.workspaceId,
+    summary: readString20(input.objective) ?? readString20(input.hypothesis) ?? readString20(input.rationale) ?? readString20(input.title) ?? "",
+    tags: [
+      ...input.tags ?? [],
+      input.lane,
+      input.gate,
+      input.worktreeType,
+      input.domainPackId,
+      input.confidenceImpact
+    ].filter((value) => Boolean(readString20(value))),
+    touchedPaths: input.touchedPaths,
+    sourceRef: readString20(input.sourceRef) ?? readString20(input.title),
+    sourceKind: readString20(input.sourceKind) ?? "worktree",
+    autoCreate: !explicitTopicId
+  });
+  const resolvedInput = {
+    ...input,
+    topicId: resolvedTopic.topicId
+  };
+  const payload = await createWorktree(
+    createGatewayWorktreesPort(authContext),
+    resolvedInput
+  );
   await emitWorktreeEventFromGatewayAuth(authContext, {
-    topicId: payload.topicId ?? input.topicId,
+    topicId: payload.topicId ?? resolvedInput.topicId,
     type: "worktree.created",
     resourceId: payload.worktreeId,
     data: {
@@ -21269,15 +21673,21 @@ async function listAllWorktreesFromGatewayAuth(authContext, query = {}) {
     ...typeof query.campaign === "number" ? { campaign: query.campaign } : {},
     ...typeof query.limit === "number" ? { limit: query.limit } : {}
   });
-  return summarizeWorktreeCollection(rows);
+  return summarizeWorktreeCollection(Array.isArray(rows) ? rows : []);
 }
 async function listCampaignsFromGatewayAuth(authContext, query = {}) {
   return listCampaigns(createGatewayWorktreesPort(authContext), query);
 }
 async function activateWorktreeFromGatewayAuth(authContext, input) {
-  const payload = await activateWorktree(createGatewayWorktreesPort(authContext), input);
+  const payload = await activateWorktree(
+    createGatewayWorktreesPort(authContext),
+    input
+  );
   await emitWorktreeEventFromGatewayAuth(authContext, {
-    topicId: payload.topicId ?? await resolveWorktreeTopicIdWithGatewayAuth(authContext, payload.worktreeId) ?? "",
+    topicId: payload.topicId ?? await resolveWorktreeTopicIdWithGatewayAuth(
+      authContext,
+      payload.worktreeId
+    ) ?? "",
     type: "worktree.activated",
     resourceId: payload.worktreeId,
     data: {
@@ -21289,9 +21699,15 @@ async function activateWorktreeFromGatewayAuth(authContext, input) {
   return payload;
 }
 async function updateWorktreeFromGatewayAuth(authContext, input) {
-  const payload = await updateWorktree(createGatewayWorktreesPort(authContext), input);
+  const payload = await updateWorktree(
+    createGatewayWorktreesPort(authContext),
+    input
+  );
   await emitWorktreeEventFromGatewayAuth(authContext, {
-    topicId: payload.topicId ?? await resolveWorktreeTopicIdWithGatewayAuth(authContext, payload.worktreeId) ?? "",
+    topicId: payload.topicId ?? await resolveWorktreeTopicIdWithGatewayAuth(
+      authContext,
+      payload.worktreeId
+    ) ?? "",
     type: "worktree.metadata_updated",
     resourceId: payload.worktreeId,
     data: {
@@ -21308,9 +21724,15 @@ async function updateWorktreeFromGatewayAuth(authContext, input) {
   return payload;
 }
 async function mergeWorktreeFromGatewayAuth(authContext, input) {
-  const payload = await mergeWorktree(createGatewayWorktreesPort(authContext), input);
+  const payload = await mergeWorktree(
+    createGatewayWorktreesPort(authContext),
+    input
+  );
   await emitWorktreeEventFromGatewayAuth(authContext, {
-    topicId: await resolveWorktreeTopicIdWithGatewayAuth(authContext, payload.worktreeId) ?? "",
+    topicId: await resolveWorktreeTopicIdWithGatewayAuth(
+      authContext,
+      payload.worktreeId
+    ) ?? "",
     type: "worktree.merged",
     resourceId: payload.worktreeId,
     data: {
@@ -21330,7 +21752,10 @@ async function updateWorktreeTargetsFromGatewayAuth(authContext, input) {
     input
   );
   await emitWorktreeEventFromGatewayAuth(authContext, {
-    topicId: payload.topicId ?? await resolveWorktreeTopicIdWithGatewayAuth(authContext, payload.worktreeId) ?? "",
+    topicId: payload.topicId ?? await resolveWorktreeTopicIdWithGatewayAuth(
+      authContext,
+      payload.worktreeId
+    ) ?? "",
     type: "worktree.targets_updated",
     resourceId: payload.worktreeId,
     data: {
@@ -21346,32 +21771,36 @@ async function updateWorktreeTargetsFromGatewayAuth(authContext, input) {
 }
 function completeWorktreeRecordFromGatewayAuth(authContext, input) {
   return authContext.convex.mutation(api.worktrees.complete, {
-    worktreeId: resolveExternalId5(input.worktreeId, "wt") ?? input.worktreeId,
+    worktreeId: normalizePrefixedId3(input.worktreeId, "wt") ?? input.worktreeId,
     keyFindings: input.keyFindings ?? [],
     decisionsReached: input.decisionsReached ?? [],
     nextSteps: input.nextSteps ?? [],
     userId: authContext.userId
-  }).then((payload) => withRequestedWorktreeId(payload, input.worktreeId));
+  }).then(
+    (payload) => withRequestedWorktreeId(payload, input.worktreeId)
+  );
 }
 function advanceWorktreePhaseFromGatewayAuth(authContext, input) {
   return authContext.convex.mutation(api.worktrees.advancePhase, {
-    worktreeId: resolveExternalId5(input.worktreeId, "wt") ?? input.worktreeId,
+    worktreeId: normalizePrefixedId3(input.worktreeId, "wt") ?? input.worktreeId,
     userId: authContext.userId
   });
 }
 function setWorktreePhaseFromGatewayAuth(authContext, input) {
   return authContext.convex.mutation(api.worktrees.setPhase, {
-    worktreeId: resolveExternalId5(input.worktreeId, "wt") ?? input.worktreeId,
+    worktreeId: normalizePrefixedId3(input.worktreeId, "wt") ?? input.worktreeId,
     phase: input.phase,
     userId: authContext.userId
   });
 }
 function patchWorktreeStateFromGatewayAuth(authContext, input) {
   return authContext.convex.mutation(api.worktrees.patchState, {
-    worktreeId: resolveExternalId5(input.worktreeId, "wt") ?? input.worktreeId,
+    worktreeId: normalizePrefixedId3(input.worktreeId, "wt") ?? input.worktreeId,
     patch: input.patch,
     userId: authContext.userId
-  }).then((payload) => withRequestedWorktreeId(payload, input.worktreeId));
+  }).then(
+    (payload) => withRequestedWorktreeId(payload, input.worktreeId)
+  );
 }
 function bulkCreateWorktreesFromGatewayAuth(authContext, input) {
   return authContext.convex.mutation(api.worktrees.bulkCreate, {
@@ -24815,6 +25244,7 @@ async function handleWorktreeCreate(args) {
     const payload = await createWorktreeFromGatewayAuth(args.authContext, {
       title: readString33(body.title) ?? readString33(body.name) ?? "",
       topicId: readString33(body.topicId ?? body.projectId) ?? "",
+      topicHint: readString33(body.topicHint),
       objective: readString33(body.objective),
       hypothesis: readString33(body.hypothesis),
       rationale: readString33(body.rationale),
@@ -24835,6 +25265,10 @@ async function handleWorktreeCreate(args) {
       } : void 0,
       autoShape: typeof body.autoShape === "boolean" ? body.autoShape : void 0,
       domainPackId: readString33(body.domainPackId),
+      tags: readStringArray17(body.tags),
+      touchedPaths: readStringArray17(body.touchedPaths),
+      sourceRef: readString33(body.sourceRef),
+      sourceKind: readString33(body.sourceKind),
       campaign: readNumber22(body.campaign),
       lane: readString33(body.lane),
       laneOrderInCampaign: readNumber22(body.laneOrderInCampaign),