@productbrain/mcp 0.0.1-beta.168 → 0.0.1-beta.171

package/dist/{chunk-K2GIX46U.js → chunk-RJXJO4DY.js}

@@ -86,7 +86,7 @@ function getToolContext() {
   return toolContextStore.getStore() ?? null;
 }
 var DEFAULT_CLOUD_URL = "https://gateway.productbrain.io";
-var McpCallError = class extends Error {
+var KernelCallError = class extends Error {
   status;
   code;
   /** WP-316 S1a: Structured commit validation — required field keys missing from entry.data. */
@@ -95,7 +95,7 @@ var McpCallError = class extends Error {
   fieldErrors;
   constructor(message, status, code, missingRequiredFields, fieldErrors) {
     super(message);
-    this.name = "McpCallError";
+    this.name = "KernelCallError";
     this.status = status;
     this.code = code;
     this.missingRequiredFields = missingRequiredFields;
@@ -184,7 +184,7 @@ async function startAgentSession() {
   if (!s.apiKeyId) {
     throw new Error("Cannot start session: API key ID not resolved. Ensure workspace resolution completed.");
   }
-  const result = await mcpCall("agent.startSession", {
+  const result = await kernelCall("agent.startSession", {
     workspaceId,
     apiKeyId: s.apiKeyId,
     clientKind: "mcp"
@@ -204,7 +204,7 @@ async function closeAgentSession() {
   if (!s.agentSessionId) return;
   const sessionId = s.agentSessionId;
   try {
-    await mcpCall("agent.closeSession", {
+    await kernelCall("agent.closeSession", {
       sessionId,
       status: "closed"
     });
@@ -220,7 +220,7 @@ async function orphanAgentSession() {
   if (!s.agentSessionId) return;
   const sessionId = s.agentSessionId;
   try {
-    await mcpCall("agent.closeSession", {
+    await kernelCall("agent.closeSession", {
       sessionId,
       status: "orphaned"
     });
@@ -241,7 +241,7 @@ function touchSessionActivity() {
   const lastTouchAt = _lastTouchAtBySession.get(sessionId) ?? 0;
   if (now - lastTouchAt < TOUCH_THROTTLE_MS) return;
   _lastTouchAtBySession.set(sessionId, now);
-  mcpCall("agent.touchSession", {
+  kernelCall("agent.touchSession", {
     sessionId
   }).catch(() => {
   });
@@ -257,7 +257,7 @@ async function recordSessionActivity(activity) {
   const s = state();
   if (!s.agentSessionId) return;
   try {
-    await mcpCall("agent.recordActivity", {
+    await kernelCall("agent.recordActivity", {
       sessionId: s.agentSessionId,
       ...activity
     });
@@ -341,7 +341,7 @@ async function callGateway(fn, args) {
     const errJson = json;
     const msg = errJson.error ?? errJson.message ?? "unknown error";
     audit(fn, "error", Date.now() - start, errJson.code ? `${msg} [${errJson.code}]` : msg);
-    throw new McpCallError(
+    throw new KernelCallError(
       `MCP call "${fn}" failed (${res.status}): ${msg}`,
       res.status,
       errJson.code,
@@ -358,7 +358,7 @@ async function callGateway(fn, args) {
     _meta
   };
 }
-async function mcpCall(fn, args = {}) {
+async function kernelCall(fn, args = {}) {
   const cached = getCached(fn, args);
   if (cached !== void 0) {
     return cached;
@@ -375,7 +375,7 @@ async function mcpCall(fn, args = {}) {
   }
   return data;
 }
-async function mcpCallEnvelope(fn, args = {}) {
+async function kernelCallEnvelope(fn, args = {}) {
   const { data, summary, next, _meta } = await callGateway(fn, args);
   const s = state();
   if (s.agentSessionId && !TOUCH_EXCLUDED.has(fn)) {
@@ -398,7 +398,7 @@ async function resolveWorkspaceWithRetry(maxRetries = 2) {
   let lastError = null;
   for (let attempt = 0; attempt <= maxRetries; attempt++) {
     try {
-      const workspace = await mcpCall("resolveWorkspace", {});
+      const workspace = await kernelCall("resolveWorkspace", {});
       if (!workspace) {
         throw new Error(
           `API key is valid but no workspace is associated. Run \`npx ${MCP_NPX_PACKAGE} setup\` or regenerate your key.`
@@ -438,13 +438,13 @@ async function getWorkspaceContext() {
     governanceMode: s.workspaceGovernanceMode ?? "open"
   };
 }
-async function mcpQuery(fn, args = {}) {
+async function kernelQuery(fn, args = {}) {
   const workspaceId = await getWorkspaceId();
-  return mcpCall(fn, { ...args, workspaceId });
+  return kernelCall(fn, { ...args, workspaceId });
 }
-async function mcpMutation(fn, args = {}) {
+async function kernelMutation(fn, args = {}) {
   const workspaceId = await getWorkspaceId();
-  return mcpCall(fn, { ...args, workspaceId });
+  return kernelCall(fn, { ...args, workspaceId });
 }
 function requireActiveSession() {
   const s = state();
@@ -491,7 +491,7 @@ async function recoverSessionState() {
   const s = state();
   if (!s.workspaceId) return;
   try {
-    const session = await mcpCall("agent.getActiveSession", { workspaceId: s.workspaceId });
+    const session = await kernelCall("agent.getActiveSession", { workspaceId: s.workspaceId });
     if (session && session.status === "active") {
       s.agentSessionId = session._id;
       s.sessionOriented = session.oriented;
@@ -724,7 +724,7 @@ function recordGap(gap) {
 }
 function persistGap(gap) {
   const sessionId = getAgentSessionId();
-  mcpMutation("gaps.record", {
+  kernelMutation("gaps.record", {
     sessionId: sessionId ?? void 0,
     query: gap.query,
     tool: gap.tool,
@@ -756,7 +756,7 @@ function clearSessionGaps() {
   sessionGaps.delete(sessionKey);
 }
 function resolveGapsForEntry(entryName, entryId) {
-  mcpMutation("gaps.resolve", { entryName, entryId }).catch(() => {
+  kernelMutation("gaps.resolve", { entryName, entryId }).catch(() => {
   });
 }
 
@@ -764,7 +764,7 @@ function resolveGapsForEntry(entryName, entryId) {
 async function resolveCollection(params) {
   const { name, description, typeHint, allowReviewRouting } = params;
   const sessionId = getAgentSessionId();
-  const result = await mcpCall("chain.resolveCollection", {
+  const result = await kernelCall("chain.resolveCollection", {
     entryName: name,
     entryDescription: description,
     ...typeHint ? { typeHint } : {},
@@ -779,7 +779,7 @@ import { z } from "zod";
 
 // src/errors.ts
 var MCP_CALL_ERROR_RE = /^MCP call "[^"]+" failed \(\d+\): (.+)$/s;
-function asMcpCallError(err) {
+function asKernelCallError(err) {
   if (err instanceof Error && typeof err.code === "string") {
     const code = err.code;
     const match = MCP_CALL_ERROR_RE.exec(err.message);
@@ -855,7 +855,7 @@ function classifyError(err) {
   if (err instanceof ValidationError) {
     return { code: "VALIDATION_ERROR", message };
   }
-  const mcpErr = asMcpCallError(err);
+  const mcpErr = asKernelCallError(err);
   if (mcpErr) {
     const { code: convexCode, cleanMessage, missingRequiredFields, fieldErrors } = mcpErr;
     if (convexCode === "VALIDATION_FAILED") {
@@ -1073,12 +1073,43 @@ function formatFieldGuidance(fields) {
   return lines.join("\n");
 }
 
+// src/lib/inferSourceDate.ts
+function inferSourceDate(...values) {
+  const combined = values.filter((value) => typeof value === "string" && value.trim().length > 0).join("\n");
+  if (!combined) return void 0;
+  const isoMatch = combined.match(/\b(20\d{2}-\d{2}-\d{2})\b/);
+  if (isoMatch) return isoMatch[1];
+  const monthMatch = combined.match(
+    /\b(january|february|march|april|may|june|july|august|september|october|november|december)\s+(\d{1,2})(?:st|nd|rd|th)?(?:,?\s+(20\d{2}))?\b/i
+  );
+  if (!monthMatch) return void 0;
+  const monthIndex = [
+    "january",
+    "february",
+    "march",
+    "april",
+    "may",
+    "june",
+    "july",
+    "august",
+    "september",
+    "october",
+    "november",
+    "december"
+  ].indexOf(monthMatch[1].toLowerCase());
+  if (monthIndex < 0) return void 0;
+  const inferredYear = monthMatch[3] ?? combined.match(/\b(20\d{2})\b/)?.[1] ?? String((/* @__PURE__ */ new Date()).getUTCFullYear());
+  const month = String(monthIndex + 1).padStart(2, "0");
+  const day = monthMatch[2].padStart(2, "0");
+  return `${inferredYear}-${month}-${day}`;
+}
+
 // src/lib/collectionCache.ts
 var cachedCollections = null;
 var cachedBySlug = null;
 async function getCollections() {
   if (cachedCollections !== null) return cachedCollections;
-  const result = await mcpQuery("chain.listCollections");
+  const result = await kernelQuery("chain.listCollections");
   cachedCollections = result ?? [];
   cachedBySlug = new Map(cachedCollections.map((c) => [c.slug, c]));
   return cachedCollections;
@@ -1137,35 +1168,6 @@ function inferFieldOption(text, collectionFields, fieldKeys) {
   }
   return bestOption;
 }
-function inferSourceDate(...values) {
-  const combined = values.filter((value) => typeof value === "string" && value.trim().length > 0).join("\n");
-  if (!combined) return void 0;
-  const isoMatch = combined.match(/\b(20\d{2}-\d{2}-\d{2})\b/);
-  if (isoMatch) return isoMatch[1];
-  const monthMatch = combined.match(
-    /\b(january|february|march|april|may|june|july|august|september|october|november|december)\s+(\d{1,2})(?:st|nd|rd|th)?(?:,?\s+(20\d{2}))?\b/i
-  );
-  if (!monthMatch) return void 0;
-  const monthIndex = [
-    "january",
-    "february",
-    "march",
-    "april",
-    "may",
-    "june",
-    "july",
-    "august",
-    "september",
-    "october",
-    "november",
-    "december"
-  ].indexOf(monthMatch[1].toLowerCase());
-  if (monthIndex < 0) return void 0;
-  const inferredYear = monthMatch[3] ?? combined.match(/\b(20\d{2})\b/)?.[1] ?? String((/* @__PURE__ */ new Date()).getUTCFullYear());
-  const month = String(monthIndex + 1).padStart(2, "0");
-  const day = monthMatch[2].padStart(2, "0");
-  return `${inferredYear}-${month}-${day}`;
-}
 var COMMON_CHECKS = {
   clearName: {
     id: "clear-name",
@@ -1778,7 +1780,7 @@ function formatQualityReport(result) {
   return lines.join("\n");
 }
 async function checkEntryQuality(entryId) {
-  const entry = await mcpQuery("chain.getEntry", { entryId });
+  const entry = await kernelQuery("chain.getEntry", { entryId });
   if (!entry) {
     return {
       text: `Entry \`${entryId}\` not found. Try search to find the right ID.`,
@@ -1790,7 +1792,7 @@ async function checkEntryQuality(entryId) {
   for (const c of collections) collMap.set(c._id, c.slug);
   const collectionSlug = collMap.get(entry.collectionId) ?? "unknown";
   const profile = await getProfile(collectionSlug);
-  const relations = await mcpQuery("chain.listEntryRelations", { entryId });
+  const relations = await kernelQuery("chain.listEntryRelations", { entryId });
   const linksCreated = [];
   for (const r of relations) {
     const otherId = r.fromId === entry._id ? r.toId : r.fromId;
@@ -2341,7 +2343,7 @@ function registerSmartCaptureTools(server) {
         };
       }
       const profile = await getProfile(resolvedCollection);
-      const col = await mcpQuery("chain.getCollection", { slug: resolvedCollection });
+      const col = await kernelQuery("chain.getCollection", { slug: resolvedCollection });
       if (!col) {
         const displayName = resolvedCollection.split("-").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ");
         return {
@@ -2369,7 +2371,7 @@ Or use \`collections action=list\` to see available collections.`
       }
       const skipAutoDiscoveryEarly = links && links.length > 0;
       const groundingStart = Date.now();
-      const groundingPromise = !skipAutoDiscoveryEarly && (name || description) ? mcpQuery("chain.suggestLinksForCapture", {
+      const groundingPromise = !skipAutoDiscoveryEarly && (name || description) ? kernelQuery("chain.suggestLinksForCapture", {
         entries: [{ name, description: description ?? "", collectionHint: resolvedCollection }],
         limit: 5,
         threshold: 2
@@ -2478,7 +2480,7 @@ ${groundingReport.governance.map((g) => `- **${g.entryId}** ${g.name} [${g.colle
       const shouldDecompose = (isStrategyCapture || isBetCapture) && description.trim().length > 0;
       if (shouldDecompose) {
         try {
-          const decomposed = await mcpCall(
+          const decomposed = await kernelCall(
             "chain.decomposeContent",
             {
               collectionSlug: resolvedCollection,
@@ -2509,7 +2511,7 @@ ${groundingReport.governance.map((g) => `- **${g.entryId}** ${g.name} [${g.colle
       let formativeHints = [];
       let relationSuggestionsFromCreate = [];
       try {
-        const result = await mcpMutation("chain.createEntry", {
+        const result = await kernelMutation("chain.createEntry", {
           collectionSlug: resolvedCollection,
           entryId: entryId ?? void 0,
           name,
@@ -2588,7 +2590,7 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
         throw error;
       }
       const tAfterCreate = Date.now();
-      void mcpMutation("chain.recordGroundingOutcome", {
+      void kernelMutation("chain.recordGroundingOutcome", {
         surface: "mcp",
         promptShown: groundingReport.governance.length > 0,
         highestRatio: Math.max(
@@ -2609,7 +2611,7 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
       if (searchQuery && !skipAutoDiscovery) {
         await populateHubCache();
         const [searchResults, allCollections] = await Promise.all([
-          mcpQuery("chain.searchEntries", { query: searchQuery }),
+          kernelQuery("chain.searchEntries", { query: searchQuery }),
           getCollections()
         ]);
         const collMap = /* @__PURE__ */ new Map();
@@ -2664,7 +2666,7 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
         }
       }
       const resolvedCK = canonicalKey;
-      const batchRelationsPromise = pendingRelations.length > 0 ? mcpMutation(
+      const batchRelationsPromise = pendingRelations.length > 0 ? kernelMutation(
         "chain.createEntryRelations",
         {
           relations: pendingRelations.slice(0, 25).map((r) => ({ fromEntryId: r.fromEntryId, toEntryId: r.toEntryId, type: r.type })),
@@ -2674,9 +2676,9 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
         entryWarnings.push(`Auto-linking partially failed: ${err instanceof Error ? err.message : "unknown error"}`);
         return null;
       }) : Promise.resolve(null);
-      const cardinalityPromise = resolvedCK ? mcpQuery("chain.checkCardinalityWarning", { canonicalKey: resolvedCK }).catch(() => null) : Promise.resolve(null);
+      const cardinalityPromise = resolvedCK ? kernelQuery("chain.checkCardinalityWarning", { canonicalKey: resolvedCK }).catch(() => null) : Promise.resolve(null);
       const contradictionPromise = runContradictionCheck(name, description);
-      const coachingPromise = mcpMutation("quality.evaluateHeuristicAndSchedule", {
+      const coachingPromise = kernelMutation("quality.evaluateHeuristicAndSchedule", {
         entryId: finalEntryId,
         context: "capture"
       }).catch(() => null);
@@ -2761,7 +2763,7 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
       const shouldAutoCommit = shouldAutoCommitCapture(autoCommit, wsCtx.governanceMode);
       if (shouldAutoCommit && finalEntryId && conflictCandidates.length === 0) {
         try {
-          const conflictResults = await mcpQuery("chain.searchEntries", { query: name });
+          const conflictResults = await kernelQuery("chain.searchEntries", { query: name });
           conflictCandidates = (conflictResults ?? []).filter((r) => r.entryId && r.entryId !== finalEntryId && r._id !== internalId).slice(0, 3).map((r) => ({ entryId: r.entryId, name: r.name, collection: r.collectionSlug ?? "unknown" }));
         } catch {
         }
@@ -2777,7 +2779,7 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
           if (blockingConflicts.length > 0) {
             commitError = `blocked by semantic contradiction preflight: ${blockingConflicts[0]?.chainEntryId} ${blockingConflicts[0]?.explanation ?? ""}`.trim();
           } else {
-            const commitResult = await mcpMutation("chain.commitEntry", {
+            const commitResult = await kernelMutation("chain.commitEntry", {
               entryId: finalEntryId,
               author: agentId ? `agent:${agentId}` : void 0,
               sessionId: agentId ?? void 0
@@ -3002,7 +3004,7 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
         }
       }
       try {
-        const readiness = await mcpQuery("chain.workspaceReadiness");
+        const readiness = await kernelQuery("chain.workspaceReadiness");
         if (readiness && readiness.gaps && readiness.gaps.length > 0) {
           const topGaps = readiness.gaps.slice(0, 2);
           lines.push("");
@@ -3242,7 +3244,7 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
         let batchDecomposeWarning;
         if (shouldDecomposeBatch) {
           try {
-            const decomposed = await mcpCall(
+            const decomposed = await kernelCall(
               "chain.decomposeContent",
               {
                 collectionSlug: resolvedSlug,
@@ -3266,7 +3268,7 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
         }
         canonicalizeSelects(data, col.fields ?? [], batchIsBet);
         try {
-          const result = await mcpMutation("chain.createEntry", {
+          const result = await kernelMutation("chain.createEntry", {
             collectionSlug: resolvedSlug,
             entryId: entry.entryId ?? void 0,
             name: entry.name,
@@ -3293,7 +3295,7 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
           const searchQuery = extractSearchTerms(entry.name, entry.description);
           if (searchQuery) {
             try {
-              const searchResults = await mcpQuery("chain.searchEntries", { query: searchQuery });
+              const searchResults = await kernelQuery("chain.searchEntries", { query: searchQuery });
               const candidates = (searchResults ?? []).filter((r) => r.entryId !== finalEntryId).map((r) => {
                 const conf = computeLinkConfidence(r, entry.name, entry.description, resolvedSlug, collIdToSlug.get(r.collectionId) ?? "unknown");
                 return { ...r, collSlug: collIdToSlug.get(r.collectionId) ?? "unknown", confidence: conf.score };
@@ -3308,7 +3310,7 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
                 batchAutoLinks.push({ fromEntryId: finalEntryId, toEntryId: c.entryId, type: relationType });
               }
               if (batchAutoLinks.length > 0) {
-                const batchRes = await mcpMutation("chain.createEntryRelations", {
+                const batchRes = await kernelMutation("chain.createEntryRelations", {
                   relations: batchAutoLinks,
                   sessionId: agentId ?? void 0
                 });
@@ -3326,7 +3328,7 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
               if (blockingConflicts.length > 0) {
                 commitError = `blocked by semantic contradiction preflight: ${blockingConflicts[0]?.chainEntryId} ${blockingConflicts[0]?.explanation ?? ""}`.trim();
               } else {
-                const commitResult = await mcpMutation("chain.commitEntry", {
+                const commitResult = await kernelMutation("chain.commitEntry", {
                   entryId: finalEntryId,
                   author: agentId ? `agent:${agentId}` : void 0,
                   sessionId: agentId ?? void 0
@@ -3669,8 +3671,8 @@ async function runContradictionCheck(name, description) {
     if (keyTerms.length === 0) return warnings;
     const searchQuery = keyTerms.slice(0, 5).join(" ");
     const [govResults, archResults] = await Promise.all([
-      mcpQuery("chain.searchEntries", { query: searchQuery, collectionSlug: "business-rules" }),
-      mcpQuery("chain.searchEntries", { query: searchQuery, collectionSlug: "architecture" })
+      kernelQuery("chain.searchEntries", { query: searchQuery, collectionSlug: "business-rules" }),
+      kernelQuery("chain.searchEntries", { query: searchQuery, collectionSlug: "architecture" })
     ]);
     const allGov = [...govResults ?? [], ...archResults ?? []].slice(0, 5);
     for (const entry of allGov) {
@@ -3679,7 +3681,7 @@ async function runContradictionCheck(name, description) {
       if (matched.length < 3) continue;
       let governsCount = 0;
       try {
-        const relations = await mcpQuery("chain.listEntryRelations", {
+        const relations = await kernelQuery("chain.listEntryRelations", {
           entryId: entry.entryId
         });
         governsCount = (relations ?? []).filter((r) => r.type === "governs").length;
@@ -3699,7 +3701,7 @@ async function runContradictionCheck(name, description) {
 var BLOCKING_CONTRADICTION_THRESHOLD = 0.75;
 async function runSemanticConflictPreflight(name, description, collectionHint) {
   try {
-    const conflicts = await mcpQuery("chain.detectSemanticConflicts", {
+    const conflicts = await kernelQuery("chain.detectSemanticConflicts", {
       name,
       description,
       ...collectionHint ? { collectionHint } : {}
@@ -3792,7 +3794,7 @@ function isBlockingContradiction(conflict) {
 }
 async function runConflictPreflight(name, description, collectionHint) {
   try {
-    const conflicts = await mcpQuery("chain.detectSemanticConflicts", {
+    const conflicts = await kernelQuery("chain.detectSemanticConflicts", {
       name,
       description,
       ...collectionHint ? { collectionHint } : {}
@@ -3803,7 +3805,8 @@ async function runConflictPreflight(name, description, collectionHint) {
       blockingContradictions: conflicts.filter(isBlockingContradiction),
       advisoryWarnings: []
     };
-  } catch {
+  } catch (err) {
+    console.error("[conflict-preflight] Semantic conflict detection unavailable, falling back to heuristic:", err instanceof Error ? err.message : String(err));
     const advisoryWarnings = await runContradictionCheck(name, description);
     return {
       source: "heuristic",
@@ -3879,16 +3882,6 @@ function registerKnowledgeTools(server) {
     },
     withEnvelope(async ({ entryId, name, status: rawStatus, workflowStatus: rawWorkflowStatus, data, order, canonicalKey, autoPublish, changeNote, sourceRef, sourceExcerpt }) => {
       requireWriteAccess();
-      const PROMOTED_FIELDS = ["status", "workflowStatus", "name", "order", "canonicalKey"];
-      const topLevelByField = { status: rawStatus, workflowStatus: rawWorkflowStatus, name, order, canonicalKey };
-      const confusedFields = [];
-      if (data) {
-        for (const field of PROMOTED_FIELDS) {
-          if (field in data && topLevelByField[field] === void 0) {
-            confusedFields.push(field);
-          }
-        }
-      }
       const fieldsProvided = [];
       if (name !== void 0) fieldsProvided.push("name");
       if (rawStatus !== void 0) fieldsProvided.push("status");
@@ -3906,7 +3899,7 @@ function registerKnowledgeTools(server) {
         status = void 0;
         deprecationWarning = `\u26A0\uFE0F Deprecation: \`status: '${rawStatus}'\` \u2014 use \`workflowStatus: '${rawStatus}'\` instead. Support ends ~2026-09-03.`;
       }
-      const updateResult = await mcpMutation("chain.updateEntry", {
+      const updateResult = await kernelMutation("chain.updateEntry", {
         entryId,
         name,
         status,
@@ -3923,7 +3916,7 @@ function registerKnowledgeTools(server) {
       const id = updateResult.id;
       await recordSessionActivity({ entryModified: id });
       const wsCtx = await getWorkspaceContext();
-      const updated = await mcpQuery("chain.getEntry", { entryId });
+      const updated = await kernelQuery("chain.getEntry", { entryId });
       const entryStatus = updated?.status ?? "draft";
       const versionMode = entryStatus === "active" ? "published" : `saved as ${entryStatus}`;
       const responseLines = [
@@ -3944,12 +3937,6 @@ function registerKnowledgeTools(server) {
         responseLines.push("");
         responseLines.push(deprecationWarning);
       }
-      if (confusedFields.length > 0) {
-        responseLines.push("");
-        for (const field of confusedFields) {
-          responseLines.push(`\u26A0\uFE0F \`data.${field}\` detected \u2014 did you mean the top-level \`${field}\` parameter?`);
-        }
-      }
       if (updateResult.normalizationWarnings.length > 0) {
         responseLines.push("");
         responseLines.push("\u26A0\uFE0F **Normalization warnings:**");
@@ -3975,7 +3962,6 @@ function registerKnowledgeTools(server) {
           entryId: id,
           versionMode,
           fieldsProvided,
-          confusedFields,
           // BET-192: normalization breakdown in structuredContent — symmetric with capture tool
           ...updateResult.normalization && (Object.keys(updateResult.normalization.remapped).length > 0 || updateResult.normalization.rejected.length > 0) && {
             normalization: {
@@ -4003,7 +3989,7 @@ function registerKnowledgeTools(server) {
       annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false }
     },
     withEnvelope(async ({ entryId }) => {
-      const history = await mcpQuery("chain.listEntryHistory", { entryId });
+      const history = await kernelQuery("chain.listEntryHistory", { entryId });
       if (history.length === 0) {
         return successResult(
           `No history found for ${entryId}.`,
@@ -4037,7 +4023,7 @@ ${formatted}` }],
     },
     withEnvelope(async ({ entryId, preview }) => {
       requireWriteAccess();
-      const entry = await mcpQuery("chain.getEntry", { entryId });
+      const entry = await kernelQuery("chain.getEntry", { entryId });
       if (!entry) {
         return notFoundResult(entryId, `Entry '${entryId}' not found. Try search to find the right ID.`);
       }
@@ -4087,7 +4073,7 @@ ${formatted}` }],
       }
       let coachingResult = null;
       try {
-        coachingResult = await mcpMutation("quality.evaluateHeuristicAndSchedule", {
+        coachingResult = await kernelMutation("quality.evaluateHeuristicAndSchedule", {
           entryId,
           context: "commit"
         });
@@ -4095,7 +4081,7 @@ ${formatted}` }],
       }
       let result;
       try {
-        result = await mcpMutation("chain.commitEntry", {
+        result = await kernelMutation("chain.commitEntry", {
           entryId,
           author: getAgentSessionId() ? `agent:${getAgentSessionId()}` : void 0,
           sessionId: getAgentSessionId() ?? void 0,
@@ -4234,7 +4220,7 @@ No DB writes \u2014 call without \`preview:true\` to commit for real.` }],
       try {
         const collSlug = entry.collectionSlug ?? entry.collection?.slug;
         if (collSlug) {
-          captureContract = await mcpQuery(
+          captureContract = await kernelQuery(
             "chain.getCaptureContract",
             { collectionSlug: collSlug }
           ) ?? void 0;
@@ -4398,7 +4384,7 @@ function registerEntriesTools(server) {
   );
 }
 async function handleGet(entryId) {
-  const entry = await mcpQuery("chain.getEntry", { entryId });
+  const entry = await kernelQuery("chain.getEntry", { entryId });
   if (!entry) {
     return notFoundResult(entryId, `Entry '${entryId}' not found. Try search to find the right ID.`);
   }
@@ -4492,7 +4478,7 @@ async function handleGet(entryId) {
   };
 }
 async function handleBatch(entryIds) {
-  const results = await mcpQuery("chain.batchGetEntries", { entryIds });
+  const results = await kernelQuery("chain.batchGetEntries", { entryIds });
   const lines = [`## Batch Result`, "", `# Batch Get (${results.length} requested)`, ""];
   for (let i = 0; i < results.length; i++) {
     const r = results[i];
@@ -4583,12 +4569,12 @@ async function handleBatch(entryIds) {
 async function handleList(collection, status, tag, label) {
   let entries;
   if (label) {
-    entries = await mcpQuery("chain.listEntriesByLabel", { labelSlug: label });
+    entries = await kernelQuery("chain.listEntriesByLabel", { labelSlug: label });
     if (status) {
       entries = entries.filter((e) => e.status === status);
     }
   } else {
-    entries = await mcpQuery("chain.listEntries", {
+    entries = await kernelQuery("chain.listEntries", {
       collectionSlug: collection,
       status,
       tag
@@ -4632,7 +4618,7 @@ ${formatted}` }],
 }
 async function handleMove(entryId, toCollection) {
   try {
-    const result = await mcpMutation("chain.moveToCollection", { entryId, toCollectionSlug: toCollection });
+    const result = await kernelMutation("chain.moveToCollection", { entryId, toCollectionSlug: toCollection });
     const lines = [
       `## Move Result`,
       "",
@@ -4673,8 +4659,8 @@ async function handleSearch(server, query, collection, status) {
     logger: "product-os"
   });
   const [results, collections] = await Promise.all([
-    mcpQuery("chain.searchEntries", { query, collectionSlug: collection, status }),
-    mcpQuery("chain.listCollections")
+    kernelQuery("chain.searchEntries", { query, collectionSlug: collection, status }),
+    kernelQuery("chain.listCollections")
   ]);
   if (results.length === 0) {
     const recorded = recordGap({ query, tool: "entries", action: "search", gapType: "search_zero", collectionScope: collection });
@@ -4815,7 +4801,7 @@ function registerGraphTools(server) {
   );
 }
 async function handleFind(entryId, direction) {
-  const relations = await mcpQuery("chain.listEntryRelations", { entryId });
+  const relations = await kernelQuery("chain.listEntryRelations", { entryId });
   if (relations.length === 0) {
     return {
       content: [{ type: "text", text: `No relations found for \`${entryId}\`. Use relations action=create to create connections.` }],
@@ -4829,7 +4815,7 @@ async function handleFind(entryId, direction) {
       )
     };
   }
-  const sourceEntry = await mcpQuery("chain.getEntry", { entryId });
+  const sourceEntry = await kernelQuery("chain.getEntry", { entryId });
   if (!sourceEntry) {
     return notFoundResult(entryId, `Entry '${entryId}' not found. Try entries action=search to find the right ID.`);
   }
@@ -4844,12 +4830,12 @@ async function handleFind(entryId, direction) {
   }
   const otherEntries = /* @__PURE__ */ new Map();
   for (const id of otherIds) {
-    const entry = await mcpQuery("chain.getEntry", { id });
+    const entry = await kernelQuery("chain.getEntry", { id });
     if (entry) {
       otherEntries.set(entry._id, { entryId: entry.entryId, name: entry.name, collectionId: entry.collectionId });
     }
   }
-  const collections = await mcpQuery("chain.listCollections");
+  const collections = await kernelQuery("chain.listCollections");
   const collMap = /* @__PURE__ */ new Map();
   for (const c of collections) collMap.set(c._id, c.slug);
   const lines = [`## Find Result`, "", `# Relations for ${entryId}: ${sourceEntry.name}`, ""];
@@ -4913,7 +4899,7 @@ async function handleFind(entryId, direction) {
   };
 }
 async function handleSuggest(entryId, limit, depth) {
-  const result = await mcpQuery("chain.graphSuggestLinks", {
+  const result = await kernelQuery("chain.graphSuggestLinks", {
     entryId,
     maxHops: depth,
     limit
@@ -5067,7 +5053,7 @@ function registerRelationsTools(server) {
 async function handleCreate(from, to, type, score, preview) {
   requireWriteAccess();
   const agentSessionId = getAgentSessionId();
-  const result = await mcpMutation("chain.createEntryRelation", {
+  const result = await kernelMutation("chain.createEntryRelation", {
     fromEntryId: from,
     toEntryId: to,
     type,
@@ -5157,7 +5143,7 @@ async function handleBatchCreate(relations) {
   const batchRels = relations.filter((r) => r.type !== "governs");
   if (batchRels.length > 0) {
     try {
-      const batchResult = await mcpMutation("chain.createEntryRelations", {
+      const batchResult = await kernelMutation("chain.createEntryRelations", {
         relations: batchRels.map((r) => ({ fromEntryId: r.from, toEntryId: r.to, type: r.type })),
         sessionId: agentSessionId ?? void 0
       });
@@ -5174,7 +5160,7 @@ async function handleBatchCreate(relations) {
   }
   for (const rel of governsRels) {
     try {
-      const result = await mcpMutation("chain.createEntryRelation", {
+      const result = await kernelMutation("chain.createEntryRelation", {
         fromEntryId: rel.from,
         toEntryId: rel.to,
         type: rel.type,
@@ -5229,15 +5215,15 @@ async function handleBatchCreate(relations) {
 }
 async function handleDismiss(from, to, type, score) {
   requireWriteAccess();
-  const fromEntry = await mcpQuery("chain.getEntry", { entryId: from });
+  const fromEntry = await kernelQuery("chain.getEntry", { entryId: from });
   if (!fromEntry) {
     return notFoundResult(from);
   }
-  const toEntry = await mcpQuery("chain.getEntry", { entryId: to });
+  const toEntry = await kernelQuery("chain.getEntry", { entryId: to });
   if (!toEntry) {
     return notFoundResult(to);
   }
-  await mcpMutation("chain.dismissSuggestion", {
+  await kernelMutation("chain.dismissSuggestion", {
     fromEntryId: fromEntry._id,
     suggestedEntryId: toEntry._id,
     recommendedType: type,
@@ -5251,7 +5237,7 @@ async function handleDismiss(from, to, type, score) {
 }
 async function handleDelete(from, to, type) {
   requireWriteAccess();
-  await mcpMutation("chain.removeEntryRelation", {
+  await kernelMutation("chain.removeEntryRelation", {
     fromEntryId: from,
     toEntryId: to,
     type
@@ -5385,7 +5371,7 @@ async function handleGather(server, entryId, task, mode, maxHops, maxResults, st
       data: `Graph traversal for ${entryId} (depth: ${maxHops})...`,
       logger: "product-brain"
     });
-    const result2 = await mcpQuery("chain.graphGatherContext", {
+    const result2 = await kernelQuery("chain.graphGatherContext", {
       entryId,
       maxHops
     });
@@ -5471,11 +5457,11 @@ Use \`graph action=suggest\` to discover potential connections.`
       data: `Loading context for task: "${task.substring(0, 80)}..." [strategy: ${strategyLabel}]`,
       logger: "product-brain"
     });
-    const result2 = strategy === "hybrid" ? await mcpQuery("chain.resolveTaskStartupHybrid", {
+    const result2 = strategy === "hybrid" ? await kernelQuery("chain.resolveTaskStartupHybrid", {
       task,
       maxHops,
       maxResults
-    }) : await mcpQuery("chain.resolveTaskStartup", {
+    }) : await kernelQuery("chain.resolveTaskStartup", {
       task,
       maxHops,
       maxResults
@@ -5643,7 +5629,7 @@ _This helps future sessions start with better constraints and context._`
     data: `Gathering context for ${entryId} (depth: ${maxHops})...`,
     logger: "product-brain"
   });
-  const result = await mcpQuery("chain.gatherContext", { entryId, maxHops });
+  const result = await kernelQuery("chain.gatherContext", { entryId, maxHops });
   if (!result?.root) {
     return notFoundResult(entryId, `Entry '${entryId}' not found. Try search to find the right ID.`);
   }
@@ -5718,7 +5704,7 @@ async function handleJourneyGather(server, mapEntryId, maxHops, maxResults) {
     data: `Loading journey context for map ${mapEntryId}...`,
     logger: "product-brain"
   });
-  const result = await mcpQuery("chain.journeyAwareGatherContext", {
+  const result = await kernelQuery("chain.journeyAwareGatherContext", {
     mapEntryId,
     maxHops,
     maxResults
@@ -5798,7 +5784,7 @@ Add journey steps via MCP: \`map-slot action=add mapEntryId="${mapEntryId}" slot
   };
 }
 async function handleNeighborhood(entryId) {
-  const result = await mcpQuery("chain.getEntryNeighborhood", { entryId, now: Date.now() });
+  const result = await kernelQuery("chain.getEntryNeighborhood", { entryId, now: Date.now() });
   const lines = [`# Neighborhood: ${entryId}`, ""];
   if (result.blockingChain.length > 0) {
     lines.push(`## Blocking Chain (${result.blockingChain.length})`);
@@ -5865,7 +5851,7 @@ async function handleBuild(server, entryId, maxHops) {
     data: `Assembling build context for ${entryId}...`,
     logger: "product-brain"
   });
-  const result = await mcpQuery("chain.assembleBuildContext", {
+  const result = await kernelQuery("chain.assembleBuildContext", {
     entryId,
     maxHops
   });
@@ -5934,7 +5920,7 @@ async function handleBuild(server, entryId, maxHops) {
   };
 }
 async function handleCrossCut(relationType) {
-  const result = await mcpQuery("chain.structuralAggregation", {
+  const result = await kernelQuery("chain.structuralAggregation", {
     relationType
   });
   const groupKeys = Object.keys(result.groups);
@@ -5979,7 +5965,7 @@ No relations of type '${relationType}' found in this workspace.`
 }
 async function handleChainWalk(entryId, direction, maxHops, relationType) {
   const clampedHops = Math.max(1, Math.min(4, maxHops));
-  const result = await mcpQuery("chain.deepChainWalk", {
+  const result = await kernelQuery("chain.deepChainWalk", {
     entryId,
     direction,
     maxHops: clampedHops,
@@ -6051,7 +6037,7 @@ async function handleChanges(since) {
   if (isNaN(sinceMs)) {
     return validationResult(`Invalid 'since' timestamp: '${since}'. Use ISO 8601 format (e.g. '2026-03-24T00:00:00Z').`);
   }
-  const result = await mcpQuery("chain.changeDetection", { since: sinceMs });
+  const result = await kernelQuery("chain.changeDetection", { since: sinceMs });
   const totalEntries = result.entries.length;
   const totalRelations = result.relations.length;
   if (totalEntries === 0 && totalRelations === 0) {
@@ -6109,10 +6095,10 @@ No entries modified or relations created since this timestamp.`
   };
 }
 async function handleIncremental(skill) {
-  const result = await mcpQuery("chain.incrementalChanges", { skill });
+  const result = await kernelQuery("chain.incrementalChanges", { skill });
   const totalEntries = result.newEntries.length;
   const surfacedIds = result.newEntries.map((e) => e.entryId).filter((id) => id !== null);
-  mcpMutation("chain.recordBriefRun", {
+  kernelMutation("chain.recordBriefRun", {
     skill,
     entriesSurfaced: surfacedIds,
     timestamp: Date.now()
@@ -6176,7 +6162,7 @@ No new entries since last brief run (${formatTimeAgo(result.previousRunTimestamp
 async function handleBrief(briefType, sinceMs) {
   const args = { type: briefType };
   if (sinceMs !== void 0) args.since = sinceMs;
-  const result = await mcpQuery("chain.compoundQuery", args);
+  const result = await kernelQuery("chain.compoundQuery", args);
   if (briefType === "steering") {
     return formatSteeringBrief(result);
   }
@@ -6434,7 +6420,7 @@ function registerCollectionsTools(server) {
   trackWriteTool(tool);
 }
 async function handleDescribe(slug) {
-  const col = await mcpQuery("chain.getCollection", { slug });
+  const col = await kernelQuery("chain.getCollection", { slug });
   if (!col) {
     return failureResult(
       `Collection '${slug}' not found.`,
@@ -6527,7 +6513,7 @@ ${refList}`);
   };
 }
 async function handleList2() {
-  const collections = await mcpQuery("chain.listCollections");
+  const collections = await kernelQuery("chain.listCollections");
   if (collections.length === 0) {
     return successResult(
       "No collections found in this workspace.",
@@ -6570,7 +6556,7 @@ ${formatted}` }],
 async function handleCreate2(slug, name, description, purpose, icon, navGroup, fields, meta = {}) {
   requireWriteAccess();
   try {
-    await mcpMutation("chain.createCollection", {
+    await kernelMutation("chain.createCollection", {
       slug,
       name,
       description,
@@ -6618,12 +6604,22 @@ You can now capture entries: \`capture collection="${slug}" name="..." descripti
         [{ tool: "collections", description: "Update collection", parameters: { action: "update", slug } }]
       );
     }
+    const code = error.code ?? error.data?.code;
+    if (code === "COLLECTION_PREFIX_TAKEN" || msg.includes("already used by collection")) {
+      return failureResult(
+        msg,
+        "DUPLICATE",
+        msg,
+        "Choose a different prefix by passing the idPrefix parameter, or let the system derive one from a different slug.",
+        [{ tool: "collections", description: "List collections to see taken prefixes", parameters: { action: "list" } }]
+      );
+    }
     throw error;
   }
 }
 async function handleUpdate(slug, name, description, purpose, icon, navGroup, fields, meta = {}) {
   requireWriteAccess();
-  await mcpMutation("chain.updateCollection", {
+  await kernelMutation("chain.updateCollection", {
     slug,
     ...name !== void 0 && { name },
     ...description !== void 0 && { description },
@@ -6656,7 +6652,7 @@ Use \`collections action=list\` to verify the result.`
   };
 }
 async function handleAudit() {
-  const data = await mcpQuery("chain.auditCollections");
+  const data = await kernelQuery("chain.auditCollections");
   const lines = [];
   lines.push(`# Collection Audit Report`);
   lines.push(`
@@ -6694,7 +6690,7 @@ All collections are healthy.`);
   };
 }
 async function handleExport() {
-  const definitions = await mcpQuery("chain.exportDefinitions");
+  const definitions = await kernelQuery("chain.exportDefinitions");
   return {
     content: [{ type: "text", text: JSON.stringify(definitions, null, 2) }],
     structuredContent: success(
@@ -6728,7 +6724,7 @@ function registerLabelTools(server) {
     },
     withEnvelope(async ({ action, slug, name, color, description, parentSlug, isGroup, order, entryId }) => {
       if (action === "list") {
-        const labels = await mcpQuery("chain.listLabels");
+        const labels = await kernelQuery("chain.listLabels");
         if (labels.length === 0) {
           return successResult(
             "No labels defined in this workspace yet.",
@@ -6774,7 +6770,7 @@ function registerLabelTools(server) {
         }
         let parentId;
         if (parentSlug) {
-          const labels = await mcpQuery("chain.listLabels");
+          const labels = await kernelQuery("chain.listLabels");
           const parent = labels.find((l) => l.slug === parentSlug);
           if (!parent) {
             return failureResult(
@@ -6787,7 +6783,7 @@ function registerLabelTools(server) {
           }
           parentId = parent._id;
         }
-        await mcpMutation("chain.createLabel", { slug, name, color, description, parentId, isGroup, order });
+        await kernelMutation("chain.createLabel", { slug, name, color, description, parentId, isGroup, order });
         return successResult(
           `Label '${name}' (${slug}) created.`,
           `Created label '${name}' (${slug}).`,
@@ -6796,7 +6792,7 @@ function registerLabelTools(server) {
         );
       }
       if (action === "update") {
-        await mcpMutation("chain.updateLabel", { slug, name, color, description, isGroup, order });
+        await kernelMutation("chain.updateLabel", { slug, name, color, description, isGroup, order });
         return successResult(
           `Label '${slug}' updated.`,
           `Updated label '${slug}'.`,
@@ -6805,7 +6801,7 @@ function registerLabelTools(server) {
         );
       }
       if (action === "delete") {
-        await mcpMutation("chain.deleteLabel", { slug });
+        await kernelMutation("chain.deleteLabel", { slug });
         return successResult(
           `Label '${slug}' removed from all entries and deleted.`,
           `Deleted label '${slug}'.`,
@@ -6817,10 +6813,10 @@ function registerLabelTools(server) {
           return validationResult("An entryId is required for apply/remove actions.");
         }
         if (action === "apply") {
-          await mcpMutation("chain.applyLabel", { entryId, labelSlug: slug });
+          await kernelMutation("chain.applyLabel", { entryId, labelSlug: slug });
           return successResult(`Label '${slug}' applied to ${entryId}.`, `Applied label '${slug}' to ${entryId}.`, { slug, entryId });
         }
-        await mcpMutation("chain.removeLabel", { entryId, labelSlug: slug });
+        await kernelMutation("chain.removeLabel", { entryId, labelSlug: slug });
         return successResult(`Label '${slug}' removed from ${entryId}.`, `Removed label '${slug}' from ${entryId}.`, { slug, entryId });
       }
       return validationResult("Unknown action.");
@@ -7426,7 +7422,7 @@ function isValidTopGap(g) {
 }
 async function fetchSessionCoherenceSnapshot(sessionId) {
   try {
-    const session = await mcpCall("agent.getSession", {
+    const session = await kernelCall("agent.getSession", {
       sessionId
     });
     const raw = session?.coherenceSnapshot;
@@ -7445,7 +7441,7 @@ async function suggestLinksForEntries(entries) {
   const results = await mapWithConcurrency(
     entries,
     async (entry) => {
-      const result = await mcpQuery("chain.graphSuggestLinks", {
+      const result = await kernelQuery("chain.graphSuggestLinks", {
         entryId: entry.entryId,
         limit: 3
       });
@@ -7475,7 +7471,7 @@ async function runWrapupReview() {
   if (getApiKeyScope() === "read") {
     return { text: "Read-only session \u2014 nothing to review.", data: null, suggestions: [], failureCode: "READONLY_SCOPE" };
   }
-  const kernelEnvelope = await mcpCallEnvelope("agent.getSessionWrapup", { sessionId });
+  const kernelEnvelope = await kernelCallEnvelope("agent.getSessionWrapup", { sessionId });
   const data = kernelEnvelope.data;
   if (data.wrapupCompletedAt) {
     return { text: "Wrapup already completed this session.", data, suggestions: [], failureCode: "ALREADY_COMPLETED" };
@@ -7641,7 +7637,7 @@ async function runWrapupCommitAll(data, cachedSuggestions) {
   let proposalsCreated = 0;
   for (const draft of data.drafts) {
     try {
-      const result = await mcpMutation("chain.commitEntry", {
+      const result = await kernelMutation("chain.commitEntry", {
         entryId: draft.entryId,
         author: `agent:${sessionId}`,
         sessionId
@@ -7678,7 +7674,7 @@ async function runWrapupCommitAll(data, cachedSuggestions) {
   const batchRels = toApply.filter((s) => s.type !== "governs");
   if (batchRels.length > 0) {
     try {
-      const batchResult = await mcpMutation("chain.createEntryRelations", {
+      const batchResult = await kernelMutation("chain.createEntryRelations", {
         relations: batchRels.map((s) => ({
           fromEntryId: s.fromEntryId,
           toEntryId: s.toEntryId,
@@ -7707,7 +7703,7 @@ async function runWrapupCommitAll(data, cachedSuggestions) {
   }
   for (const s of governsRels) {
     try {
-      const result = await mcpMutation("chain.createEntryRelation", {
+      const result = await kernelMutation("chain.createEntryRelation", {
         fromEntryId: s.fromEntryId,
         toEntryId: s.toEntryId,
         type: s.type,
@@ -7724,7 +7720,7 @@ async function runWrapupCommitAll(data, cachedSuggestions) {
   }
   const committed = results.filter((r) => r.ok && !r.proposed).length;
   const failed = results.filter((r) => !r.ok);
-  await mcpCall("agent.recordWrapup", {
+  await kernelCall("agent.recordWrapup", {
     sessionId,
     draftsReviewed: data.drafts.length,
     draftsCommitted: committed,
@@ -7786,7 +7782,7 @@ function registerWrapupTools(server) {
         );
       }
       const useCachedReview = lastReviewSessionId === sessionId;
-      const data2 = useCachedReview && lastReviewData ? lastReviewData : (await mcpCallEnvelope("agent.getSessionWrapup", { sessionId })).data;
+      const data2 = useCachedReview && lastReviewData ? lastReviewData : (await kernelCallEnvelope("agent.getSessionWrapup", { sessionId })).data;
       if (data2.drafts.length === 0) {
         return failureResult("No uncommitted drafts to commit.", "NOT_FOUND", "No uncommitted drafts to commit.", "Nothing to commit.");
       }
@@ -7929,7 +7925,7 @@ async function handleClose() {
       [{ tool: "session", description: "Start a session", parameters: { action: "start" } }]
     );
   }
-  const session = await mcpCall("agent.getSession", {
+  const session = await kernelCall("agent.getSession", {
     sessionId
   });
   let wrapupNudge = "";
@@ -8009,7 +8005,7 @@ async function handleStatus() {
       [{ tool: "session", description: "Start a session", parameters: { action: "start" } }]
     );
   }
-  const session = await mcpCall("agent.getSession", {
+  const session = await kernelCall("agent.getSession", {
     sessionId
   });
   if (!session) {
@@ -8115,7 +8111,7 @@ async function handleCheck(entryId) {
   );
   if (needsRelations) {
     try {
-      const suggestions = await mcpQuery("chain.graphSuggestLinks", {
+      const suggestions = await kernelQuery("chain.graphSuggestLinks", {
         entryId,
         maxHops: 2,
         limit: 3
@@ -8131,7 +8127,7 @@ ${linkHints}`;
     }
   }
   try {
-    const verdict = await mcpQuery("quality.getLatestVerdictForEntry", { entryId });
+    const verdict = await kernelQuery("quality.getLatestVerdictForEntry", { entryId });
     if (verdict && verdict.criteria && verdict.criteria.length > 0) {
       result.text += "\n\n" + formatRubricVerdictSection(verdict);
       try {
@@ -8176,7 +8172,7 @@ ${linkHints}`;
 async function handleReEvaluate(entryId, context) {
   requireWriteAccess();
   const ws = await getWorkspaceContext();
-  const result = await mcpMutation("quality.reEvaluateEntry", {
+  const result = await kernelMutation("quality.reEvaluateEntry", {
     entryId,
     context
   });
@@ -9307,7 +9303,7 @@ Use workflows action=list to see workflow names and round structure.`
   }
   let run = null;
   try {
-    run = await mcpQuery("chainwork.getLatestWorkflowRun", {
+    run = await kernelQuery("chainwork.getLatestWorkflowRun", {
       agentSessionId,
       workflowId: wf.id
     });
@@ -9372,7 +9368,7 @@ Use workflows action=list to see workflow names and round structure.`
 async function handleGetRun(runId, workflowId) {
   let run;
   if (runId) {
-    run = await mcpQuery("chainwork.getWorkflowRun", {
+    run = await kernelQuery("chainwork.getWorkflowRun", {
       runId
     });
   } else {
@@ -9383,7 +9379,7 @@ async function handleGetRun(runId, workflowId) {
         "Active session required for workflow run inspection by workflowId."
       );
     }
-    run = await mcpQuery("chainwork.getLatestWorkflowRun", {
+    run = await kernelQuery("chainwork.getLatestWorkflowRun", {
       agentSessionId,
       workflowId
     });
@@ -9546,7 +9542,7 @@ This checkpoint was NOT saved. The conversation context is preserved \u2014 cont
       );
     }
     const resolvedSummaryCapture = summaryCapture;
-    const existingRun = await mcpQuery(
+    const existingRun = await kernelQuery(
       "chainwork.getLatestWorkflowRun",
       {
         agentSessionId,
@@ -9568,7 +9564,7 @@ This checkpoint was NOT saved. The conversation context is preserved \u2014 cont
           resolvedCollectionSlug = resolved.collection;
         }
       }
-      const result = await mcpMutation("chainwork.finalizeWorkflowRun", {
+      const result = await kernelMutation("chainwork.finalizeWorkflowRun", {
         agentSessionId,
         workflowId: wf.id,
         workflowName: wf.name,
@@ -9666,7 +9662,7 @@ This checkpoint was NOT saved. The conversation context is preserved \u2014 cont
     try {
       const descriptor = getWorkflowDescriptor(workflowId);
       const template = descriptor ? getWorkflowTemplateMetadata(descriptor) : { slug: wf.id, name: wf.name };
-      const checkpointResult = await mcpMutation("chainwork.recordWorkflowCheckpoint", {
+      const checkpointResult = await kernelMutation("chainwork.recordWorkflowCheckpoint", {
         agentSessionId,
         workflowId: wf.id,
         workflowName: wf.name,
@@ -9754,7 +9750,7 @@ This checkpoint was NOT saved. The conversation context is preserved \u2014 cont
 async function handleFacilitatedFinalization(wf, descriptor, roundId, normalizedOutput, agentSessionId, summaryEntryId, lines, runId) {
   const template = descriptor ? getWorkflowTemplateMetadata(descriptor) : { slug: wf.id, name: wf.name };
   try {
-    const checkpointResult = await mcpMutation("chainwork.recordWorkflowCheckpoint", {
+    const checkpointResult = await kernelMutation("chainwork.recordWorkflowCheckpoint", {
       agentSessionId,
       workflowId: wf.id,
       workflowName: wf.name,
@@ -9872,14 +9868,14 @@ function buildStudioUrl(workspaceSlug, entryId) {
 }
 async function loadBetEntry(entryId) {
   try {
-    return await mcpQuery("chain.getEntry", { entryId });
+    return await kernelQuery("chain.getEntry", { entryId });
   } catch {
     return null;
   }
 }
 async function loadConstellationState(betEntryId, betInternalId) {
   try {
-    const relations = await mcpQuery("chain.listEntryRelations", {
+    const relations = await kernelQuery("chain.listEntryRelations", {
       entryId: betEntryId
     });
     const internalId = betInternalId ?? (await loadBetEntry(betEntryId))?._id;
@@ -9904,7 +9900,7 @@ var RELATION_TO_COLLECTION = {
 };
 async function loadSessionDrafts(betEntryId, betInternalId) {
   try {
-    const relations = await mcpQuery("chain.listEntryRelations", {
+    const relations = await kernelQuery("chain.listEntryRelations", {
       entryId: betEntryId
     });
     const internalId = betInternalId ?? (await loadBetEntry(betEntryId))?._id;
@@ -9914,7 +9910,7 @@ async function loadSessionDrafts(betEntryId, betInternalId) {
     const drafts = [];
     for (const rel of incoming.slice(0, 15)) {
       try {
-        const entry = await mcpQuery(
+        const entry = await kernelQuery(
           "chain.getEntry",
           { id: rel.fromId }
         );
@@ -10045,7 +10041,7 @@ async function handleCommitConstellation(args) {
   }
   const betData = betEntry.data ?? {};
   const operationId = args.operationId ?? `${betId}:${getAgentSessionId() ?? "sessionless"}:${betEntry.status}:${betEntry.currentVersion ?? 0}`;
-  const { blockers: commitBlockerItems, totalRelations } = await mcpQuery("chain.validateCommitConstellation", { betEntryId: betId });
+  const { blockers: commitBlockerItems, totalRelations } = await kernelQuery("chain.validateCommitConstellation", { betEntryId: betId });
   if (commitBlockerItems.length > 0) {
     return {
       content: [{
@@ -10116,11 +10112,13 @@ async function handleCommitConstellation(args) {
   let kernelEnvelope;
   let result;
   try {
-    kernelEnvelope = await mcpCallEnvelope("chain.batchCommitConstellation", {
+    kernelEnvelope = await kernelCallEnvelope("chain.batchCommitConstellation", {
       betEntryId: betId,
       author,
       sessionId,
-      operationId
+      operationId,
+      conflicts: preflight.conflicts
+      // pass for kernel-side enforcement (TEN-1405)
     });
     result = kernelEnvelope.data;
   } catch (err) {
@@ -10152,7 +10150,7 @@ No constellation entries were committed.`
   };
   for (const entryId of result.committedIds) {
     try {
-      const committedEntry = await mcpQuery("chain.getEntry", { entryId });
+      const committedEntry = await kernelQuery("chain.getEntry", { entryId });
       const docId = committedEntry?._id;
       if (typeof docId === "string" && docId.length > 0) {
         await recordSessionActivity({ entryModified: docId });
@@ -10387,7 +10385,7 @@ function registerVerifyTools(server) {
         data: `Verifying "${collection}" against ${schema.size} schema tables at ${projectRoot}`,
         logger: "product-os"
       });
-      const scopedEntries = await mcpQuery("chain.listEntries", { collectionSlug: collection });
+      const scopedEntries = await kernelQuery("chain.listEntries", { collectionSlug: collection });
       if (scopedEntries.length === 0) {
         return failureResult(
           `No entries found in '${collection}'. Nothing to verify.`,
@@ -10404,7 +10402,7 @@ function registerVerifyTools(server) {
       });
       let allEntryIds;
       try {
-        const allEntries = await mcpQuery("chain.listEntries", {});
+        const allEntries = await kernelQuery("chain.listEntries", {});
         allEntryIds = new Set(allEntries.map((e) => e.entryId).filter(Boolean));
       } catch {
         allEntryIds = new Set(scopedEntries.map((e) => e.entryId).filter(Boolean));
@@ -10483,7 +10481,7 @@ function registerVerifyTools(server) {
           const updated = (entry.data?.codeMapping ?? []).map(
             (cm) => cm.status === "aligned" && driftedFields.has(cm.field) ? { ...cm, status: "drifted" } : cm
           );
-          const updateResult = await mcpMutation("chain.updateEntry", {
+          const updateResult = await kernelMutation("chain.updateEntry", {
             entryId: entry.entryId,
             data: { codeMapping: updated }
           });
@@ -10561,7 +10559,7 @@ function registerVerifyTools(server) {
       annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
     },
     withEnvelope(async ({ entryId }) => {
-      const result = await mcpMutation("chain.verifyEntry", { entryId });
+      const result = await kernelMutation("chain.verifyEntry", { entryId });
       return success(`Entry ${entryId} verified.`, result);
     })
   );
@@ -10721,7 +10719,7 @@ function buildPlannedWork(allEntries) {
 }
 async function queryPlannedWork() {
   try {
-    const allEntries = await mcpQuery("chain.listEntries", {});
+    const allEntries = await kernelQuery("chain.listEntries", {});
     if (!allEntries) return { uncommittedDrafts: [], inProgressEntries: [], openTensions: [] };
     return buildPlannedWork(allEntries);
   } catch {
@@ -11258,7 +11256,7 @@ function formatGapOneLiner(gap) {
 async function tryMarkOriented(agentSessionId, coherenceSnapshot) {
   if (!agentSessionId) return { oriented: false, orientationStatus: "no_session" };
   try {
-    await mcpCall("agent.markOriented", {
+    await kernelCall("agent.markOriented", {
       sessionId: agentSessionId,
       ...coherenceSnapshot ? { coherenceSnapshot } : {}
     });
@@ -11269,7 +11267,7 @@ async function tryMarkOriented(agentSessionId, coherenceSnapshot) {
       return { oriented: false, orientationStatus: "failed" };
     }
     try {
-      await mcpCall("agent.markOriented", { sessionId: agentSessionId });
+      await kernelCall("agent.markOriented", { sessionId: agentSessionId });
       setSessionOriented(true);
       return { oriented: true, orientationStatus: "complete" };
     } catch {
@@ -11317,7 +11315,7 @@ function registerStartTools(server) {
       let stage = null;
       let readiness = null;
       try {
-        readiness = await mcpQuery("chain.workspaceReadiness");
+        readiness = await kernelQuery("chain.workspaceReadiness");
         stage = readiness?.stage ?? "blank";
       } catch {
         errors.push("Readiness check unavailable \u2014 showing workspace summary.");
@@ -11343,7 +11341,7 @@ function registerStartTools(server) {
       }
       if (stage === "seeded") {
         const result = await buildSeededResponse(wsCtx, readiness, agentSessionId);
-        void mcpMutation("chain.setOnboardingCompleted", {}).catch(() => {
+        void kernelMutation("chain.setOnboardingCompleted", {}).catch(() => {
         });
         return {
           content: [{ type: "text", text: result.text }],
@@ -11351,7 +11349,7 @@ function registerStartTools(server) {
         };
       }
       if (stage === "grounded" || stage === "connected") {
-        void mcpMutation("chain.setOnboardingCompleted", {}).catch(() => {
+        void kernelMutation("chain.setOnboardingCompleted", {}).catch(() => {
         });
       }
       const orientResult = await buildOrientResponse(wsCtx, agentSessionId, errors, task);
@@ -11374,6 +11372,8 @@ function buildBlankResponse(wsCtx, sessionCtx) {
     "",
     "Tell me what you're building \u2014 paste a doc, describe it in a sentence, or say **scan my codebase**.",
     "",
+    "_Powered by [Product Brain](https://productbrain.io) \u2014 your AI's product context layer._",
+    "",
     "---",
     "",
     // ── Agent instructions — follow these exactly, do not present them ──
@@ -11517,7 +11517,7 @@ Available presets: ${listPresets().map((p) => `\`${p.id}\``).join(", ")}`,
   for (const col of preset.collections) {
     try {
       const purpose = col.purpose ?? col.description;
-      await mcpCall("chain.createCollection", {
+      await kernelCall("chain.createCollection", {
         slug: col.slug,
         name: col.name,
         description: col.description,
@@ -11595,20 +11595,20 @@ async function buildOrientResponse(wsCtx, agentSessionId, errors, task) {
   let priorSessions = [];
   let recoveryBlock = null;
   try {
-    const sessionsResult = await mcpQuery("agent.recentSessions", { limit: 3 });
+    const sessionsResult = await kernelQuery("agent.recentSessions", { limit: 3 });
     priorSessions = sessionsResult?.sessions ?? [];
     recoveryBlock = sessionsResult?.recoveryBlock ?? null;
   } catch {
   }
   let openTensions = [];
   try {
-    const tensions = await mcpQuery("chain.listEntries", { collectionSlug: "tensions" });
+    const tensions = await kernelQuery("chain.listEntries", { collectionSlug: "tensions" });
     openTensions = (tensions ?? []).filter((e) => e.workflowStatus === "open");
   } catch {
   }
   let readiness = null;
   try {
-    readiness = await mcpQuery("chain.workspaceReadiness");
+    readiness = await kernelQuery("chain.workspaceReadiness");
   } catch (e) {
     errors.push(`Readiness: ${e instanceof Error ? e.message : String(e)}`);
   }
@@ -11620,7 +11620,7 @@ async function buildOrientResponse(wsCtx, agentSessionId, errors, task) {
   const coherence = buildCoherenceSection();
   let allCollections = [];
   try {
-    allCollections = await mcpQuery("chain.listCollections") ?? [];
+    allCollections = await kernelQuery("chain.listCollections") ?? [];
   } catch {
   }
   lines.push(`# ${wsCtx.workspaceName}`);
@@ -11669,7 +11669,7 @@ async function buildOrientResponse(wsCtx, agentSessionId, errors, task) {
   } else if (isHighReadiness) {
     let activeBets = [];
     try {
-      const betsEntries = await mcpQuery("chain.listEntries", { collectionSlug: "work-packages" });
+      const betsEntries = await kernelQuery("chain.listEntries", { collectionSlug: "work-packages" });
       activeBets = (betsEntries ?? []).filter((e) => isActiveNowBet(e)).map((e) => ({ name: e.name, entryId: e.entryId ?? null })).slice(0, 8);
     } catch {
     }
@@ -11691,7 +11691,7 @@ async function buildOrientResponse(wsCtx, agentSessionId, errors, task) {
         const govCollections = await getByNavGroup("governance");
         const govSlugs = govCollections.map((c) => c.slug);
         for (const slug of govSlugs) {
-          const entries = await mcpQuery("chain.listEntries", { collectionSlug: slug });
+          const entries = await kernelQuery("chain.listEntries", { collectionSlug: slug });
           const active = (entries ?? []).filter((e) => e.status === "active");
           const colDef = govCollections.find((c) => c.slug === slug);
           const ck = colDef?.defaultCanonicalKey;
@@ -11729,7 +11729,7 @@ async function buildOrientResponse(wsCtx, agentSessionId, errors, task) {
         lines.push(...formatRecoveryBlock(recoveryBlock));
       }
       try {
-        const allEntries = await mcpQuery("chain.listEntries", {});
+        const allEntries = await kernelQuery("chain.listEntries", {});
         const committed = (allEntries ?? []).filter(
           (e) => e.status === "active" && !e.seededByPlatform
         );
@@ -11833,7 +11833,7 @@ function registerUsageTools(server) {
     withEnvelope(async ({ periodDays }) => {
       const ws = await getWorkspaceContext();
       const sessionId = getAgentSessionId();
-      const summary = await mcpQuery("usage.getWorkspaceSummary", {
+      const summary = await kernelQuery("usage.getWorkspaceSummary", {
         periodDays: periodDays ?? 30
       });
       if (!summary) {
@@ -11959,7 +11959,7 @@ function registerGitChainTools(server) {
         if (!title) {
           return validationResult("A `title` is required to create a process.");
         }
-        const result = await mcpMutation(
+        const result = await kernelMutation(
           "gitchain.createChain",
           { title, chainTypeId, description, author }
         );
@@ -11986,7 +11986,7 @@ Use \`chain action=edit chainEntryId="${result.entryId}" linkId="problem" conten
         if (!chainEntryId) {
           return validationResult("A `chainEntryId` is required.");
         }
-        const chain = await mcpQuery("gitchain.getChain", { chainEntryId });
+        const chain = await kernelQuery("gitchain.getChain", { chainEntryId });
         if (!chain) {
           return {
             content: [{ type: "text", text: `Process "${chainEntryId}" not found.` }],
@@ -12027,7 +12027,7 @@ Use \`chain action=edit chainEntryId="${result.entryId}" linkId="problem" conten
         };
       }
       if (action === "list") {
-        const chains = await mcpQuery("gitchain.listChains", { chainTypeId, status });
+        const chains = await kernelQuery("gitchain.listChains", { chainTypeId, status });
         if (chains.length === 0) {
           return {
             content: [{ type: "text", text: "No processes found. Use `chain action=create` to create one." }],
@@ -12061,7 +12061,7 @@ ${formatted}` }],
         if (!content) {
           return validationResult("The `content` for the link is required.");
         }
-        const result = await mcpMutation("gitchain.editLink", { chainEntryId, linkId, content, author });
+        const result = await kernelMutation("gitchain.editLink", { chainEntryId, linkId, content, author });
         return {
           content: [{
             type: "text",
@@ -12098,7 +12098,7 @@ Use \`chain action=get\` to see the full chain with updated scores.`
         if (!commitMessage) {
           return validationResult("A `commitMessage` is required.");
         }
-        const result = await mcpMutation("gitchain.commitChain", { chainEntryId, commitMessage, author });
+        const result = await kernelMutation("gitchain.commitChain", { chainEntryId, commitMessage, author });
         const warning = result.commitLintWarning ? `
 
 > **Lint warning:** ${result.commitLintWarning}` : "";
@@ -12121,7 +12121,7 @@ Use \`chain action=get\` to see the full chain with updated scores.`
         };
       }
       if (action === "list") {
-        const commits = await mcpQuery("gitchain.listCommits", { chainEntryId });
+        const commits = await kernelQuery("gitchain.listCommits", { chainEntryId });
         if (commits.length === 0) {
           return {
             content: [{ type: "text", text: `No commits found for chain "${chainEntryId}". Use \`chain-version action=commit\` to create the first snapshot.` }],
@@ -12152,7 +12152,7 @@ ${formatted}` }],
         if (versionA == null || versionB == null) {
           return validationResult("Both `versionA` and `versionB` are required for diff.");
         }
-        const diff = await mcpMutation("gitchain.diffVersions", { chainEntryId, versionA, versionB });
+        const diff = await kernelMutation("gitchain.diffVersions", { chainEntryId, versionA, versionB });
         let text = `# Diff: v${versionA} \u2192 v${versionB}
 
 - **Chain:** \`${diff.chainEntryId}\`
@@ -12187,7 +12187,7 @@ ${formatted}` }],
         if (toVersion == null) {
           return validationResult("A `toVersion` is required for revert.");
         }
-        const result = await mcpMutation("gitchain.revertChain", { chainEntryId, toVersion, author });
+        const result = await kernelMutation("gitchain.revertChain", { chainEntryId, toVersion, author });
         return {
           content: [{
             type: "text",
@@ -12207,7 +12207,7 @@ History is preserved \u2014 this created a new version, not a destructive reset.
         };
       }
       if (action === "history") {
-        const history = await mcpQuery("gitchain.getHistory", { chainEntryId });
+        const history = await kernelQuery("gitchain.getHistory", { chainEntryId });
         if (history.length === 0) {
           return {
             content: [{ type: "text", text: `No history found for chain "${chainEntryId}".` }],
@@ -12245,7 +12245,7 @@ ${formatted}` }],
     },
     withEnvelope(async ({ action, chainEntryId, branchName, strategy, author }) => {
       if (action === "create") {
-        const result = await mcpMutation("gitchain.createBranch", { chainEntryId, name: branchName, author });
+        const result = await kernelMutation("gitchain.createBranch", { chainEntryId, name: branchName, author });
         return {
           content: [{
             type: "text",
@@ -12265,7 +12265,7 @@ Edit links and commit on this branch, then use \`chain-branch action=merge\` to
         };
       }
       if (action === "list") {
-        const branches = await mcpMutation("gitchain.listBranches", { chainEntryId });
+        const branches = await kernelMutation("gitchain.listBranches", { chainEntryId });
         if (branches.length === 0) {
           return {
             content: [{ type: "text", text: `No branches found for chain "${chainEntryId}".` }],
@@ -12291,7 +12291,7 @@ ${formatted}` }],
         if (!branchName) {
           return validationResult("A `branchName` is required for merge.");
         }
-        const result = await mcpMutation("gitchain.mergeBranch", { chainEntryId, branchName, strategy, author });
+        const result = await kernelMutation("gitchain.mergeBranch", { chainEntryId, branchName, strategy, author });
         return {
           content: [{
             type: "text",
@@ -12314,7 +12314,7 @@ Main is now at v${result.version}. The branch has been closed.`
         if (!branchName) {
           return validationResult("A `branchName` is required for conflict check.");
         }
-        const result = await mcpMutation("gitchain.checkConflicts", { chainEntryId, branchName });
+        const result = await kernelMutation("gitchain.checkConflicts", { chainEntryId, branchName });
         if (!result.hasConflicts) {
           return {
             content: [{
@@ -12365,7 +12365,7 @@ Resolve conflicts before merging.`
     },
     withEnvelope(async ({ action, chainEntryId, commitMessage, versionNumber, linkId, body, commentId, author }) => {
       if (action === "gate") {
-        const gate = await mcpQuery("gitchain.runGate", { chainEntryId, commitMessage });
+        const gate = await kernelQuery("gitchain.runGate", { chainEntryId, commitMessage });
         const checkLines = gate.checks.map((c) => `- ${c.pass ? "PASS" : "FAIL"} **${c.name}**: ${c.detail}`).join("\n");
         const icon = gate.pass ? "PASS" : "BLOCKED";
         return {
@@ -12393,7 +12393,7 @@ ${checkLines}`
         if (!body) {
           return validationResult("A `body` is required.");
         }
-        const result = await mcpMutation("gitchain.addComment", {
+        const result = await kernelMutation("gitchain.addComment", {
           chainEntryId,
           versionNumber,
           linkId,
@@ -12420,11 +12420,11 @@ ${checkLines}`
         if (!commentId) {
           return validationResult("A `commentId` is required.");
         }
-        await mcpMutation("gitchain.resolveComment", { commentId });
+        await kernelMutation("gitchain.resolveComment", { commentId });
         return successResult("Comment resolved.", `Comment ${commentId} resolved.`, { commentId, resolved: true });
       }
       if (action === "list-comments") {
-        const comments = await mcpMutation("gitchain.listComments", {
+        const comments = await kernelMutation("gitchain.listComments", {
           chainEntryId,
           versionNumber
         });
@@ -12519,7 +12519,7 @@ function registerMapTools(server) {
       annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
     },
     withEnvelope(async ({ audienceEntryId }) => {
-      const result = await mcpMutation(
+      const result = await kernelMutation(
         "maps.createAudienceMapSet",
         { audienceEntryId }
       );
@@ -12569,7 +12569,7 @@ Use map-slot to add ingredients. View at /empathy, /narrowing, and /jobs.`
         if (!title) {
           return validationResult("A `title` is required to create a map.");
         }
-        const result = await mcpMutation(
+        const result = await kernelMutation(
           "maps.createMap",
           { title, templateId, description, slotIds }
         );
@@ -12600,7 +12600,7 @@ Use \`map-slot action=add mapEntryId="${result.entryId}" slotId="problem" ingred
         if (!mapEntryId) {
           return validationResult("A `mapEntryId` is required.");
         }
-        const map = await mcpQuery("maps.getMap", { mapEntryId });
+        const map = await kernelQuery("maps.getMap", { mapEntryId });
         if (!map) {
           return {
             content: [{ type: "text", text: `Map "${mapEntryId}" not found.` }],
@@ -12637,7 +12637,7 @@ Use \`map-slot action=add mapEntryId="${result.entryId}" slotId="problem" ingred
         };
       }
       if (action === "list") {
-        const maps = await mcpQuery("maps.listMaps", {
+        const maps = await kernelQuery("maps.listMaps", {
           templateId: templateId !== "lean-canvas" ? templateId : void 0,
           status
         });
@@ -12686,7 +12686,7 @@ ${lines.join("\n")}` }],
       author
     }) => {
       if (action === "list") {
-        const map = await mcpQuery("maps.getMap", { mapEntryId });
+        const map = await kernelQuery("maps.getMap", { mapEntryId });
         if (!map) {
           return {
             content: [{ type: "text", text: `Map "${mapEntryId}" not found.` }],
@@ -12731,7 +12731,7 @@ ${slotSummary(map.slots)}` }],
         if (!slotId || !ingredientEntryId) {
           return validationResult("Both `slotId` and `ingredientEntryId` are required for add.");
         }
-        await mcpMutation("maps.addToSlot", { mapEntryId, slotId, ingredientEntryId, label, author });
+        await kernelMutation("maps.addToSlot", { mapEntryId, slotId, ingredientEntryId, label, author });
         return {
           content: [{ type: "text", text: `Added \`${ingredientEntryId}\` to slot "${slotId}" on map \`${mapEntryId}\`.` }],
           structuredContent: success(
@@ -12745,7 +12745,7 @@ ${slotSummary(map.slots)}` }],
         if (!slotId || !ingredientEntryId) {
           return validationResult("Both `slotId` and `ingredientEntryId` are required for remove.");
         }
-        await mcpMutation("maps.removeFromSlot", { mapEntryId, slotId, ingredientEntryId, author });
+        await kernelMutation("maps.removeFromSlot", { mapEntryId, slotId, ingredientEntryId, author });
         return {
           content: [{ type: "text", text: `Removed \`${ingredientEntryId}\` from slot "${slotId}" on map \`${mapEntryId}\`.` }],
           structuredContent: success(
@@ -12759,7 +12759,7 @@ ${slotSummary(map.slots)}` }],
         if (!slotId || !ingredientEntryId || !newIngredientEntryId) {
           return validationResult("`slotId`, `ingredientEntryId`, and `newIngredientEntryId` are required for replace.");
         }
-        await mcpMutation("maps.replaceInSlot", { mapEntryId, slotId, oldIngredientEntryId: ingredientEntryId, newIngredientEntryId, label, author });
+        await kernelMutation("maps.replaceInSlot", { mapEntryId, slotId, oldIngredientEntryId: ingredientEntryId, newIngredientEntryId, label, author });
         return {
           content: [{ type: "text", text: `Replaced \`${ingredientEntryId}\` with \`${newIngredientEntryId}\` in slot "${slotId}".` }],
           structuredContent: success(
@@ -12783,7 +12783,7 @@ ${slotSummary(map.slots)}` }],
     },
     withEnvelope(async ({ action, mapEntryId, commitMessage, author }) => {
       if (action === "commit") {
-        const result = await mcpMutation("maps.commitMap", {
+        const result = await kernelMutation("maps.commitMap", {
           mapEntryId,
           commitMessage: commitMessage ?? "Map committed",
           author
@@ -12808,7 +12808,7 @@ All ingredient references have been pinned at their current versions.`
         };
       }
       if (action === "list" || action === "history") {
-        const commits = await mcpQuery("maps.listMapCommits", { mapEntryId });
+        const commits = await kernelQuery("maps.listMapCommits", { mapEntryId });
         if (!commits || commits.length === 0) {
           return {
             content: [{ type: "text", text: `No commits yet for map \`${mapEntryId}\`. Use \`map-version action=commit\` to create the first snapshot.` }],
@@ -12846,7 +12846,7 @@ ${lines.join("\n")}` }],
       annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false }
     },
     withEnvelope(async ({ mapEntryId, slotId, query }) => {
-      const map = await mcpQuery("maps.getMap", { mapEntryId });
+      const map = await kernelQuery("maps.getMap", { mapEntryId });
       if (!map) {
         return {
           content: [{ type: "text", text: `Map "${mapEntryId}" not found.` }],
@@ -12871,7 +12871,7 @@ ${lines.join("\n")}` }],
       for (const sid of emptySlots) {
         const def = slotDefs.find((s) => s.id === sid);
         const searchQuery = query ?? def?.label ?? sid;
-        const results = await mcpQuery("knowledge.search", {
+        const results = await kernelQuery("knowledge.search", {
           query: searchQuery,
           limit: 5
         });
@@ -12935,18 +12935,18 @@ var COLLECTION_FIELDS = [
 ];
 var ARCHITECTURE_CANONICAL_KEY = "architecture_note";
 async function ensureCollection() {
-  const collections = await mcpQuery("chain.listCollections");
+  const collections = await kernelQuery("chain.listCollections");
   const existing = collections.find((c) => c.slug === COLLECTION_SLUG);
   if (existing) {
     if (!existing.defaultCanonicalKey) {
-      await mcpMutation("chain.updateCollection", {
+      await kernelMutation("chain.updateCollection", {
         slug: COLLECTION_SLUG,
         defaultCanonicalKey: ARCHITECTURE_CANONICAL_KEY
       });
     }
     return;
   }
-  await mcpMutation("chain.createCollection", {
+  await kernelMutation("chain.createCollection", {
     slug: COLLECTION_SLUG,
     name: "Architecture",
     icon: "\u{1F3D7}\uFE0F",
@@ -12955,7 +12955,7 @@ async function ensureCollection() {
   });
 }
 async function listArchEntries() {
-  return mcpQuery("chain.listEntries", { collectionSlug: COLLECTION_SLUG });
+  return kernelQuery("chain.listEntries", { collectionSlug: COLLECTION_SLUG });
 }
 function byTag(entries, archType) {
   return entries.filter((e) => e.tags?.includes(`archType:${archType}`) || e.data?.archType === archType).sort((a, b) => (a.order ?? 0) - (b.order ?? 0));
@@ -13215,7 +13215,7 @@ ${nodeDetail}${flowLines}`
             );
             if (hasChanges) {
               const mergedData = { ...existingData, ...seedData };
-              const updateResult = await mcpMutation("chain.updateEntry", { entryId: seed.entryId, data: mergedData });
+              const updateResult = await kernelMutation("chain.updateEntry", { entryId: seed.entryId, data: mergedData });
               if (updateResult.normalizationWarnings.length > 0 || updateResult.validationWarnings.length > 0) {
                 allWarnings.push({
                   entryId: seed.entryId,
@@ -13229,7 +13229,7 @@ ${nodeDetail}${flowLines}`
             }
             continue;
           }
-          const createResult = await mcpMutation("chain.createEntry", {
+          const createResult = await kernelMutation("chain.createEntry", {
             collectionSlug: COLLECTION_SLUG,
             entryId: seed.entryId,
             name: seed.name,
@@ -13523,7 +13523,7 @@ import { z as z22 } from "zod";
 var PURPOSE_GAP_PREFIX = "purpose-gap-";
 async function markOrientedWithSnapshotFallback(agentSessionId, coherenceSnapshot) {
   try {
-    await mcpCall("agent.markOriented", {
+    await kernelCall("agent.markOriented", {
       sessionId: agentSessionId,
       ...coherenceSnapshot ? { coherenceSnapshot } : {}
     });
@@ -13532,7 +13532,7 @@ async function markOrientedWithSnapshotFallback(agentSessionId, coherenceSnapsho
   } catch {
     if (!coherenceSnapshot) return false;
     try {
-      await mcpCall("agent.markOriented", { sessionId: agentSessionId });
+      await kernelCall("agent.markOriented", { sessionId: agentSessionId });
       setSessionOriented(true);
       return true;
     } catch {
@@ -13643,7 +13643,7 @@ function registerOrientTool(server) {
       let recoveryBlock = null;
       if (wsCtx) {
         try {
-          const sessionsResult = await mcpQuery("agent.recentSessions", { limit: 3 });
+          const sessionsResult = await kernelQuery("agent.recentSessions", { limit: 3 });
           priorSessions = sessionsResult?.sessions ?? [];
           recoveryBlock = sessionsResult?.recoveryBlock ?? null;
         } catch {
@@ -13657,7 +13657,7 @@ function registerOrientTool(server) {
         if (scope) orientArgs.scope = scope;
         if (sessionEntryIds.length > 0) orientArgs.sessionEntryIds = sessionEntryIds;
         if (lastSessionOnly.length > 0) orientArgs.lastSessionEntryIds = lastSessionOnly;
-        orientEntries = await mcpQuery("chain.getOrientEntries", orientArgs);
+        orientEntries = await kernelQuery("chain.getOrientEntries", orientArgs);
       } catch {
       }
       const hasTaskGrounding = Boolean(task && orientEntries?.taskContext?.context?.length > 0);
@@ -13672,18 +13672,18 @@ function registerOrientTool(server) {
       }
       let openTensions = [];
       try {
-        const tensions = await mcpQuery("chain.listEntries", { collectionSlug: "tensions" });
+        const tensions = await kernelQuery("chain.listEntries", { collectionSlug: "tensions" });
         openTensions = (tensions ?? []).filter((e) => e.workflowStatus === "open");
       } catch {
       }
       let allCollections = [];
       try {
-        allCollections = await mcpQuery("chain.listCollections") ?? [];
+        allCollections = await kernelQuery("chain.listCollections") ?? [];
       } catch {
       }
       let readiness = null;
       try {
-        readiness = await mcpQuery("chain.workspaceReadiness");
+        readiness = await kernelQuery("chain.workspaceReadiness");
       } catch (e) {
         errors.push(`Readiness: ${e instanceof Error ? e.message : String(e)}`);
       }
@@ -13702,7 +13702,7 @@ function registerOrientTool(server) {
         let orientationStatus2 = "no_session";
         if (agentSessionId) {
           try {
-            await mcpCall("agent.markOriented", { sessionId: agentSessionId });
+            await kernelCall("agent.markOriented", { sessionId: agentSessionId });
             setSessionOriented(true);
             oriented = true;
             orientationStatus2 = "complete";
@@ -14114,7 +14114,7 @@ function registerOrientTool(server) {
           }
           let allEntries = [];
           try {
-            allEntries = await mcpQuery("chain.listEntries", {}) ?? [];
+            allEntries = await kernelQuery("chain.listEntries", {}) ?? [];
           } catch {
           }
           const plannedWork = buildPlannedWork(allEntries);
@@ -14205,7 +14205,7 @@ function registerOrientTool(server) {
           lines.push("_Warning: Could not mark session as oriented. Write tools may be restricted._");
         }
         try {
-          await mcpMutation("chain.recordSessionSignal", {
+          await kernelMutation("chain.recordSessionSignal", {
             sessionId: agentSessionId,
             signalType: "immediate_context_load",
             metadata: { source: "orient" }
@@ -14365,13 +14365,13 @@ function formatOrgHealthLines(orgHealth, maxFlags = 3) {
 }
 async function fetchOrganisationHealth() {
   try {
-    const allEntries = await mcpQuery("chain.listEntries", { status: "active" });
+    const allEntries = await kernelQuery("chain.listEntries", { status: "active" });
     if (!allEntries || allEntries.length === 0) return null;
     const classifyInput = allEntries.map((e) => ({
       name: e.name ?? "",
       description: typeof e.data?.description === "string" ? e.data.description : ""
     }));
-    const classifications = await mcpQuery(
+    const classifications = await kernelQuery(
       "chain.batchClassifyHeuristic",
       { entries: classifyInput }
     );
@@ -14393,14 +14393,14 @@ async function handleHealthCheck() {
   }
   let collections = [];
   try {
-    collections = await mcpQuery("chain.listCollections");
+    collections = await kernelQuery("chain.listCollections");
   } catch (e) {
     errors.push(`Collection fetch failed: ${e instanceof Error ? e.message : String(e)}`);
   }
   let totalEntries = 0;
   if (collections.length > 0) {
     try {
-      const entries = await mcpQuery("chain.listEntries", {});
+      const entries = await kernelQuery("chain.listEntries", {});
       totalEntries = entries.length;
     } catch (e) {
       errors.push(`Entry count failed: ${e instanceof Error ? e.message : String(e)}`);
@@ -14477,7 +14477,7 @@ var STAGE_DESCRIPTIONS = {
   connected: "Well-connected knowledge graph \u2014 your Brain is useful."
 };
 async function handleWorkspaceStatus() {
-  const result = await mcpQuery("chain.workspaceReadiness");
+  const result = await kernelQuery("chain.workspaceReadiness");
   const { score, totalChecks, passedChecks, checks, gaps, stats, governanceMode } = result;
   const scoringVersion = result.scoringVersion ?? "v1";
   const stage = result.stage ?? "seeded";
@@ -14779,7 +14779,7 @@ function registerAuditTools(server) {
 async function handleAuditRun(entryId, phase) {
   let result;
   try {
-    result = await mcpQuery("chain.auditBet", { entryId, phase });
+    result = await kernelQuery("chain.auditBet", { entryId, phase });
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
     if (msg.includes("not found") || msg.includes("NOT_FOUND")) {
@@ -14897,7 +14897,7 @@ function registerGovernanceTools(server) {
         );
       }
       if (action === "list") {
-        const proposals = await mcpQuery("governance.listProposals", {
+        const proposals = await kernelQuery("governance.listProposals", {
           ...status ? { status } : {}
         });
         if (proposals.length === 0) {
@@ -14936,7 +14936,7 @@ function registerGovernanceTools(server) {
         );
       }
       if (action === "count") {
-        const result = await mcpQuery("governance.countOpenProposals");
+        const result = await kernelQuery("governance.countOpenProposals");
         return successResult(
           result.count === 0 ? "No open consent proposals." : `${result.count} open consent proposal(s) awaiting review.`,
           `${result.count} open consent proposal(s).`,
@@ -14966,7 +14966,7 @@ function registerGovernanceTools(server) {
           );
         }
         try {
-          const result = await mcpMutation(
+          const result = await kernelMutation(
             "governance.respondToProposal",
             {
               proposalId,
@@ -15179,11 +15179,11 @@ function registerResources(server) {
     "productbrain://orientation",
     async (uri) => {
       const [collectionsResult, eventsResult, standardsResult, rulesResult, principlesResult] = await Promise.allSettled([
-        mcpQuery("chain.listCollections"),
-        mcpQuery("chain.listEntries", { collectionSlug: "tracking-events" }),
-        mcpQuery("chain.listEntries", { collectionSlug: "standards" }),
-        mcpQuery("chain.listEntries", { collectionSlug: "business-rules" }),
-        mcpQuery("chain.listEntries", { collectionSlug: "principles" })
+        kernelQuery("chain.listCollections"),
+        kernelQuery("chain.listEntries", { collectionSlug: "tracking-events" }),
+        kernelQuery("chain.listEntries", { collectionSlug: "standards" }),
+        kernelQuery("chain.listEntries", { collectionSlug: "business-rules" }),
+        kernelQuery("chain.listEntries", { collectionSlug: "principles" })
       ]);
       const collections = collectionsResult.status === "fulfilled" ? collectionsResult.value : null;
       const trackingEvents = eventsResult.status === "fulfilled" ? eventsResult.value : null;
@@ -15204,8 +15204,8 @@ function registerResources(server) {
     "productbrain://terminology",
     async (uri) => {
       const [glossaryResult, standardsResult] = await Promise.allSettled([
-        mcpQuery("chain.listEntries", { collectionSlug: "glossary" }),
-        mcpQuery("chain.listEntries", { collectionSlug: "standards" })
+        kernelQuery("chain.listEntries", { collectionSlug: "glossary" }),
+        kernelQuery("chain.listEntries", { collectionSlug: "standards" })
       ]);
       const lines = ["# Product Brain \u2014 Terminology"];
       if (glossaryResult.status === "fulfilled") {
@@ -15243,7 +15243,7 @@ ${stds}`);
     "chain-collections",
     "productbrain://collections",
     async (uri) => {
-      const collections = await mcpQuery("chain.listCollections") ?? [];
+      const collections = await kernelQuery("chain.listCollections") ?? [];
       if (collections.length === 0) {
         return { contents: [{ uri: uri.href, text: "No collections in this workspace. Use `collections action=create` or `start` with a preset to get started.", mimeType: "text/markdown" }] };
       }
@@ -15266,7 +15266,7 @@ ${formatted}`, mimeType: "text/markdown" }]
     "chain-collection-entries",
     new ResourceTemplate("productbrain://{slug}/entries", {
       list: async () => {
-        const collections = await mcpQuery("chain.listCollections") ?? [];
+        const collections = await kernelQuery("chain.listCollections") ?? [];
         return {
           resources: collections.map((c) => ({
             uri: `productbrain://${c.slug}/entries`,
@@ -15276,7 +15276,7 @@ ${formatted}`, mimeType: "text/markdown" }]
       }
     }),
     async (uri, { slug }) => {
-      const entries = await mcpQuery("chain.listEntries", { collectionSlug: slug }) ?? [];
+      const entries = await kernelQuery("chain.listEntries", { collectionSlug: slug }) ?? [];
       const formatted = entries.map(formatEntryMarkdown).join("\n\n---\n\n");
       return {
         contents: [{
@@ -15291,7 +15291,7 @@ ${formatted}`, mimeType: "text/markdown" }]
     "chain-labels",
     "productbrain://labels",
     async (uri) => {
-      const labels = await mcpQuery("chain.listLabels") ?? [];
+      const labels = await kernelQuery("chain.listLabels") ?? [];
       if (labels.length === 0) {
         return { contents: [{ uri: uri.href, text: "No labels in this workspace.", mimeType: "text/markdown" }] };
       }
@@ -15324,15 +15324,15 @@ ${lines.join("\n")}`, mimeType: "text/markdown" }]
       complete: {
         entryId: async (value) => {
           if (!value || value.length < 1) return [];
-          const entries = await mcpQuery("chain.searchEntries", { query: value }) ?? [];
+          const entries = await kernelQuery("chain.searchEntries", { query: value }) ?? [];
           return entries.slice(0, 10).map((e) => e.entryId ?? e._id);
         }
       }
     }),
     async (uri, { entryId }) => {
       const [entry, collections] = await Promise.all([
-        mcpQuery("chain.getEntry", { entryId }),
-        mcpQuery("chain.listCollections")
+        kernelQuery("chain.getEntry", { entryId }),
+        kernelQuery("chain.listCollections")
       ]);
       if (!entry) {
         return { contents: [{ uri: uri.href, text: `Entry "${entryId}" not found.`, mimeType: "text/markdown" }] };
@@ -15381,13 +15381,13 @@ ${entry.labels.map((l) => `- ${l.name ?? l.slug}`).join("\n")}`);
       complete: {
         entryId: async (value) => {
           if (!value || value.length < 1) return [];
-          const entries = await mcpQuery("chain.searchEntries", { query: value }) ?? [];
+          const entries = await kernelQuery("chain.searchEntries", { query: value }) ?? [];
           return entries.slice(0, 10).map((e) => e.entryId ?? e._id);
         }
       }
     }),
     async (uri, { entryId }) => {
-      const result = await mcpQuery("chain.gatherContext", {
+      const result = await kernelQuery("chain.gatherContext", {
         entryId,
         maxHops: 2
       });
@@ -15424,7 +15424,7 @@ ${entry.labels.map((l) => `- ${l.name ?? l.slug}`).join("\n")}`);
     "chain-collection-capture-contract",
     new ResourceTemplate("productbrain://collections/{slug}/capture-contract", {
       list: async () => {
-        const collections = await mcpQuery("chain.listCollections") ?? [];
+        const collections = await kernelQuery("chain.listCollections") ?? [];
         return {
           resources: collections.map((c) => ({
             uri: `productbrain://collections/${c.slug}/capture-contract`,
@@ -15443,7 +15443,7 @@ ${entry.labels.map((l) => `- ${l.name ?? l.slug}`).join("\n")}`);
       }
       let contract = null;
       try {
-        contract = await mcpQuery(
+        contract = await kernelQuery(
           "chain.getCaptureContract",
           { collectionSlug }
         );
@@ -15492,7 +15492,7 @@ ${entry.labels.map((l) => `- ${l.name ?? l.slug}`).join("\n")}`);
       }
     }),
     async (uri, { query }) => {
-      const results = await mcpQuery("chain.searchEntries", { query });
+      const results = await kernelQuery("chain.searchEntries", { query });
       if (!results || results.length === 0) {
         return { contents: [{ uri: uri.href, text: `No results for "${query}".`, mimeType: "text/markdown" }] };
       }
@@ -15521,7 +15521,7 @@ function registerPrompts(server) {
     "Review code or a design decision against all business rules for a given domain. Fetches the rules and asks you to do a structured compliance review.",
     { domain: z26.string().describe("Business rule domain (e.g. 'Identity & Access', 'Governance & Decision-Making')") },
     async ({ domain }) => {
-      const entries = await mcpQuery("chain.listEntries", { collectionSlug: "business-rules" });
+      const entries = await kernelQuery("chain.listEntries", { collectionSlug: "business-rules" });
       const rules = entries.filter((e) => e.data?.domain === domain);
       if (rules.length === 0) {
         return {
@@ -15574,7 +15574,7 @@ Provide a structured review with a compliance status for each rule (COMPLIANT /
     "Check variable names, field names, or API names against the glossary for terminology alignment. Flags drift from canonical terms.",
     { names: z26.string().describe("Comma-separated list of names to check (e.g. 'vendor_id, compliance_level, formulator_type')") },
     async ({ names }) => {
-      const terms = await mcpQuery("chain.listEntries", { collectionSlug: "glossary" });
+      const terms = await kernelQuery("chain.listEntries", { collectionSlug: "glossary" });
       const glossaryContext = terms.map(
         (t) => `${t.name} (${t.entryId ?? ""}) [${t.status}]: ${t.data?.canonical ?? ""}` + (t.data?.confusedWith?.length > 0 ? ` \u2014 Often confused with: ${t.data.confusedWith.join(", ")}` : "") + (t.data?.codeMapping?.length > 0 ? `
   Code mappings: ${t.data.codeMapping.map((m) => `${m.platform}:${m.field}`).join(", ")}` : "")
@@ -15610,7 +15610,7 @@ Format as a table: Name | Status | Canonical Form | Action Needed`
     "Draft a structured decision record from a description of what was decided. Includes context from recent decisions and relevant rules.",
     { context: z26.string().describe("Description of the decision (e.g. 'We decided to use MRSL v3.1 as the conformance baseline because...')") },
     async ({ context }) => {
-      const recentDecisions = await mcpQuery("chain.listEntries", { collectionSlug: "decisions" });
+      const recentDecisions = await kernelQuery("chain.listEntries", { collectionSlug: "decisions" });
       const sorted = [...recentDecisions].sort((a, b) => (b.data?.date ?? "") > (a.data?.date ?? "") ? 1 : -1).slice(0, 5);
       const recentContext = sorted.length > 0 ? sorted.map((d) => `- [${d.status}] ${d.name} (${d.data?.date ?? "no date"})`).join("\n") : "No previous decisions recorded.";
       return {
@@ -15650,7 +15650,7 @@ After drafting, I can log it using the capture tool with collection "decisions".
       domain: z26.string().describe("Which domain this rule belongs to (e.g. 'Governance & Decision-Making')")
     },
     async ({ observation, domain }) => {
-      const allRules = await mcpQuery("chain.listEntries", { collectionSlug: "business-rules" });
+      const allRules = await kernelQuery("chain.listEntries", { collectionSlug: "business-rules" });
       const existingRules = allRules.filter((r) => r.data?.domain === domain);
       const existingContext = existingRules.length > 0 ? existingRules.map((r) => `${r.entryId ?? ""}: ${r.name} [${r.status}] \u2014 ${r.data?.description ?? ""}`).join("\n") : "No existing rules for this domain.";
       return {
@@ -15809,4 +15809,4 @@ export {
   SERVER_VERSION,
   createProductBrainServer
 };
-//# sourceMappingURL=chunk-K2GIX46U.js.map
+//# sourceMappingURL=chunk-RJXJO4DY.js.map