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

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

@@ -994,7 +994,7 @@ var metaSchema = z.object({
     perEntryAvgMs: z.number().optional()
   }).passthrough().optional()
 }).optional();
-function withEnvelope(handler) {
+function thinWrapper(handler) {
   return async (args) => {
     const start = Date.now();
     try {
@@ -1009,17 +1009,7 @@ function withEnvelope(handler) {
           ...sc.ok === false ? { isError: true } : {}
         };
       }
-      console.warn(`[withEnvelope] Handler returned without envelope shape. Wrapping automatically. Content preview: "${result.content?.[0]?.text?.slice(0, 60) ?? "(empty)"}"`);
-      return {
-        content: result.content ?? [],
-        structuredContent: {
-          ...success(
-            result.content?.[0]?.text?.slice(0, 100) ?? "",
-            sc ?? {}
-          ),
-          _meta: { durationMs }
-        }
-      };
+      throw new Error(`[thinWrapper] Handler '${handler.name || "<anonymous>"}' returned without envelope shape \u2014 migration incomplete.`);
     } catch (err) {
       const durationMs = Date.now() - start;
       const classified = classifyError(err);
@@ -2294,7 +2284,7 @@ function registerSmartCaptureTools(server) {
       inputSchema: captureSchema.shape,
       annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
     },
-    withEnvelope(async ({ collection, name, description, context, entryId, canonicalKey, data: userData, links, autoCommit, sourceRef, sourceExcerpt, preview, suggestOnly, format }) => {
+    thinWrapper(async ({ collection, name, description, context, entryId, canonicalKey, data: userData, links, autoCommit, sourceRef, sourceExcerpt, preview, suggestOnly, format }) => {
       requireWriteAccess();
       const timingStart = Date.now();
       const wsCtx = await getWorkspaceContext();
@@ -3098,7 +3088,7 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
       inputSchema: batchCaptureSchema.shape,
       annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
     },
-    withEnvelope(async ({ entries, autoCommit, preview }) => {
+    thinWrapper(async ({ entries, autoCommit, preview }) => {
       requireWriteAccess();
       const batchTimingStart = Date.now();
       const agentId = getAgentSessionId();
@@ -3880,7 +3870,7 @@ function registerKnowledgeTools(server) {
       inputSchema: updateEntrySchema,
       annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false }
     },
-    withEnvelope(async ({ entryId, name, status: rawStatus, workflowStatus: rawWorkflowStatus, data, order, canonicalKey, autoPublish, changeNote, sourceRef, sourceExcerpt }) => {
+    thinWrapper(async ({ entryId, name, status: rawStatus, workflowStatus: rawWorkflowStatus, data, order, canonicalKey, autoPublish, changeNote, sourceRef, sourceExcerpt }) => {
       requireWriteAccess();
       const fieldsProvided = [];
       if (name !== void 0) fieldsProvided.push("name");
@@ -3988,7 +3978,7 @@ function registerKnowledgeTools(server) {
       inputSchema: getHistorySchema,
       annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false }
     },
-    withEnvelope(async ({ entryId }) => {
+    thinWrapper(async ({ entryId }) => {
       const history = await kernelQuery("chain.listEntryHistory", { entryId });
       if (history.length === 0) {
         return successResult(
@@ -4021,7 +4011,7 @@ ${formatted}` }],
       inputSchema: commitEntrySchema,
       annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false }
     },
-    withEnvelope(async ({ entryId, preview }) => {
+    thinWrapper(async ({ entryId, preview }) => {
       requireWriteAccess();
       const entry = await kernelQuery("chain.getEntry", { entryId });
       if (!entry) {
@@ -4347,7 +4337,7 @@ function registerEntriesTools(server) {
       inputSchema: entriesSchema,
       annotations: { idempotentHint: false, openWorldHint: false }
     },
-    withEnvelope(async (args) => {
+    thinWrapper(async (args) => {
       const parsed = parseOrFail(entriesSchema, args);
       if (!parsed.ok) return parsed.result;
       const { action, entryId, entryIds, collection, toCollection, status, tag, label, query } = parsed.data;
@@ -4784,7 +4774,7 @@ function registerGraphTools(server) {
       inputSchema: graphSchema,
       annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false }
     },
-    withEnvelope(async (args) => {
+    thinWrapper(async (args) => {
       const parsed = parseOrFail(graphSchema, args);
       if (!parsed.ok) return parsed.result;
       const { action, entryId, direction, limit, depth } = parsed.data;
@@ -5015,7 +5005,7 @@ function registerRelationsTools(server) {
       inputSchema: relationsSchema,
       annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false }
     },
-    withEnvelope(async (args) => {
+    thinWrapper(async (args) => {
       const parsed = parseOrFail(relationsSchema, args);
       if (!parsed.ok) return parsed.result;
       const { action, from, to, type, score, relations, preview } = parsed.data;
@@ -5299,7 +5289,7 @@ function registerContextTools(server) {
       inputSchema: contextSchema,
       annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false }
     },
-    withEnvelope(async (args) => {
+    thinWrapper(async (args) => {
       const parsed = parseOrFail(contextSchema, args);
       if (!parsed.ok) return parsed.result;
       const { action, entryId, mapEntryId, task, since, direction, relationType, mode, maxHops, maxResults, strategy, skill, briefType } = parsed.data;
@@ -6377,7 +6367,7 @@ function registerCollectionsTools(server) {
       inputSchema: collectionsSchema,
       annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false }
     },
-    withEnvelope(async (args) => {
+    thinWrapper(async (args) => {
       const parsed = parseOrFail(collectionsSchema, args);
       if (!parsed.ok) return parsed.result;
       const { action, slug, name, description, purpose, icon, navGroup, fields, defaultCanonicalKey, defaultWorkflowStatus, validWorkflowStatuses, classificationCheck, classificationPriority, qualityCriteria, usageGuidance } = parsed.data;
@@ -6722,7 +6712,7 @@ function registerLabelTools(server) {
       inputSchema: labelsSchema,
       annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false }
     },
-    withEnvelope(async ({ action, slug, name, color, description, parentSlug, isGroup, order, entryId }) => {
+    thinWrapper(async ({ action, slug, name, color, description, parentSlug, isGroup, order, entryId }) => {
       if (action === "list") {
         const labels = await kernelQuery("chain.listLabels");
         if (labels.length === 0) {
@@ -7471,7 +7461,12 @@ async function runWrapupReview() {
   if (getApiKeyScope() === "read") {
     return { text: "Read-only session \u2014 nothing to review.", data: null, suggestions: [], failureCode: "READONLY_SCOPE" };
   }
-  const kernelEnvelope = await kernelCallEnvelope("agent.getSessionWrapup", { sessionId });
+  const { workspaceId } = await getWorkspaceContext();
+  const kernelEnvelope = await kernelCallEnvelope("agentKnowledge.wrapupEnvelope", {
+    workspaceId,
+    sessionId,
+    action: "review"
+  });
   const data = kernelEnvelope.data;
   if (data.wrapupCompletedAt) {
     return { text: "Wrapup already completed this session.", data, suggestions: [], failureCode: "ALREADY_COMPLETED" };
@@ -7782,7 +7777,17 @@ function registerWrapupTools(server) {
         );
       }
       const useCachedReview = lastReviewSessionId === sessionId;
-      const data2 = useCachedReview && lastReviewData ? lastReviewData : (await kernelCallEnvelope("agent.getSessionWrapup", { sessionId })).data;
+      let data2;
+      if (useCachedReview && lastReviewData) {
+        data2 = lastReviewData;
+      } else {
+        const { workspaceId } = await getWorkspaceContext();
+        data2 = (await kernelCallEnvelope("agentKnowledge.wrapupEnvelope", {
+          workspaceId,
+          sessionId,
+          action: "review"
+        })).data;
+      }
       if (data2.drafts.length === 0) {
         return failureResult("No uncommitted drafts to commit.", "NOT_FOUND", "No uncommitted drafts to commit.", "Nothing to commit.");
       }
@@ -7843,7 +7848,7 @@ ${text}` : text;
     description: WRAPUP_TOOL_DESCRIPTION + " Also known as: wrapup, finish.",
     annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false },
     inputSchema: wrapupSchema
-  }, withEnvelope(async (args) => {
+  }, thinWrapper(async (args) => {
     const parsed = parseOrFail(wrapupSchema, args);
     if (!parsed.ok) return parsed.result;
     const act = parsed.data.action ?? "review";
@@ -7871,7 +7876,7 @@ function registerSessionTools(server) {
       inputSchema: sessionSchema,
       annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
     },
-    withEnvelope(async (args) => {
+    thinWrapper(async (args) => {
       const parsed = parseOrFail(sessionSchema, args);
       if (!parsed.ok) return parsed.result;
       const { action } = parsed.data;
@@ -8087,7 +8092,7 @@ function registerQualityTools(server) {
       inputSchema: qualitySchema,
       annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false }
     },
-    withEnvelope(async (args) => {
+    thinWrapper(async (args) => {
       const parsed = parseOrFail(qualitySchema, args);
       if (!parsed.ok) return parsed.result;
       const { action, entryId, context } = parsed.data;
@@ -9175,7 +9180,7 @@ function registerWorkflowTools(server) {
       inputSchema: workflowsSchema,
       annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false }
     },
-    withEnvelope(async (args) => {
+    thinWrapper(async (args) => {
       const parsed = parseOrFail(workflowsSchema, args);
       if (!parsed.ok) return parsed.result;
       const {
@@ -9866,71 +9871,6 @@ function buildStudioUrl(workspaceSlug, entryId) {
   const appUrl = process.env.PRODUCTBRAIN_APP_URL ?? "https://work.productbrain.io";
   return `${appUrl}/${workspaceSlug}/legacy/entries/${entryId}`;
 }
-async function loadBetEntry(entryId) {
-  try {
-    return await kernelQuery("chain.getEntry", { entryId });
-  } catch {
-    return null;
-  }
-}
-async function loadConstellationState(betEntryId, betInternalId) {
-  try {
-    const relations = await kernelQuery("chain.listEntryRelations", {
-      entryId: betEntryId
-    });
-    const internalId = betInternalId ?? (await loadBetEntry(betEntryId))?._id;
-    const elementCount = relations.filter(
-      (r) => r.type === "part_of" && r.toId === internalId
-    ).length;
-    const riskCount = relations.filter(
-      (r) => r.type === "constrains" && r.toId === internalId
-    ).length;
-    const decisionCount = relations.filter(
-      (r) => r.type === "informs" && r.toId === internalId
-    ).length;
-    return { relations, elementCount, riskCount, decisionCount };
-  } catch {
-    return { relations: [], elementCount: 0, riskCount: 0, decisionCount: 0 };
-  }
-}
-var RELATION_TO_COLLECTION = {
-  part_of: "features",
-  constrains: "tensions",
-  informs: "decisions"
-};
-async function loadSessionDrafts(betEntryId, betInternalId) {
-  try {
-    const relations = await kernelQuery("chain.listEntryRelations", {
-      entryId: betEntryId
-    });
-    const internalId = betInternalId ?? (await loadBetEntry(betEntryId))?._id;
-    const incoming = relations.filter(
-      (r) => r.toId === internalId && ["part_of", "constrains", "informs"].includes(r.type)
-    );
-    const drafts = [];
-    for (const rel of incoming.slice(0, 15)) {
-      try {
-        const entry = await kernelQuery(
-          "chain.getEntry",
-          { id: rel.fromId }
-        );
-        if (entry?.entryId) {
-          drafts.push({
-            entryId: entry.entryId,
-            name: entry.name,
-            collection: RELATION_TO_COLLECTION[rel.type] ?? "unknown",
-            relationType: rel.type,
-            status: entry.status ?? "draft"
-          });
-        }
-      } catch {
-      }
-    }
-    return drafts;
-  } catch {
-    return [];
-  }
-}
 function registerFacilitateTools(server) {
   server.registerTool(
     "facilitate",
@@ -9945,7 +9885,7 @@ function registerFacilitateTools(server) {
         openWorldHint: false
       }
     },
-    withEnvelope(async (args) => {
+    thinWrapper(async (args) => {
       const parsed = facilitateSchema.safeParse(args);
       if (!parsed.success) {
         const issues = parsed.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ");
@@ -9970,55 +9910,44 @@ async function handleResume(args) {
   if (!betId) {
     return validationResult("`betEntryId` is required for resume action.");
   }
-  const betEntry = await loadBetEntry(betId);
-  if (!betEntry) {
-    return {
-      content: [{ type: "text", text: `Bet \`${betId}\` not found. Cannot resume.` }],
-      structuredContent: failure(
-        "NOT_FOUND",
-        `Bet '${betId}' not found.`,
-        "Use `capture` to create a bet entry, then resume."
-      )
-    };
-  }
-  const [constellation, sessionDrafts, wsCtx] = await Promise.all([
-    loadConstellationState(betId, betEntry._id),
-    loadSessionDrafts(betId, betEntry._id),
-    getWorkspaceContext()
-  ]);
-  const studioUrl = buildStudioUrl(wsCtx.workspaceSlug, betId);
-  const betData = betEntry.data ?? {};
-  const constellationSummary = [];
-  if (constellation.elementCount > 0) constellationSummary.push(`${constellation.elementCount} element(s)`);
-  if (constellation.riskCount > 0) constellationSummary.push(`${constellation.riskCount} risk(s)`);
-  if (constellation.decisionCount > 0) constellationSummary.push(`${constellation.decisionCount} decision(s)`);
-  const output = [
-    `# Session State \u2014 ${betEntry.name}`,
+  const { workspaceId, workspaceSlug } = await getWorkspaceContext();
+  const envelope = await kernelCallEnvelope("agentKnowledge.facilitateEnvelope", {
+    workspaceId,
+    action: "resume",
+    betEntryId: betId
+  });
+  const enrichedData = {
+    ...envelope.data,
+    studioUrl: buildStudioUrl(workspaceSlug, betId)
+  };
+  const bet = enrichedData.betEntry;
+  const cx = enrichedData.constellation;
+  const constellationParts = [];
+  if (cx.elementCount > 0) constellationParts.push(`${cx.elementCount} element(s)`);
+  if (cx.riskCount > 0) constellationParts.push(`${cx.riskCount} risk(s)`);
+  if (cx.decisionCount > 0) constellationParts.push(`${cx.decisionCount} decision(s)`);
+  const constellationSummary = constellationParts.length > 0 ? constellationParts.join(", ") : "no entries captured yet";
+  const draftLines = enrichedData.sessionDrafts.slice(0, 10).map(
+    (d) => `- \`${d.entryId}\` ${d.name} [${d.collection}] (${d.status})`
+  );
+  const textLines = [
+    `# ${bet.name}`,
     "",
-    `**Bet:** \`${betId}\``,
-    `**Cortex:** ${studioUrl}`,
-    `**Status:** ${betEntry.status}`,
-    constellationSummary.length > 0 ? `**Constellation:** ${constellationSummary.join(", ")}` : "**Constellation:** Empty \u2014 no entries captured yet.",
-    sessionDrafts.length > 0 ? `**Session drafts (${sessionDrafts.length}):** ${sessionDrafts.map((d) => `\`${d.entryId}\` ${d.name}`).join(", ")}` : ""
-  ].filter(Boolean).join("\n");
+    `**ID:** \`${bet.betEntryId}\` \xB7 **Status:** ${bet.status}`,
+    enrichedData.studioUrl ? `**Cortex:** ${enrichedData.studioUrl}` : "",
+    "",
+    `**Constellation:** ${constellationSummary}`,
+    ...draftLines.length > 0 ? ["", "**Session drafts:**", ...draftLines] : []
+  ].filter((l) => l !== void 0);
   return {
-    content: [{ type: "text", text: output }],
-    structuredContent: success(
-      `Loaded session state for "${betEntry.name}".`,
-      {
-        betEntryId: betId,
-        betName: betEntry.name,
-        betStatus: betEntry.status,
-        betData,
-        studioUrl,
-        constellation: {
-          elementCount: constellation.elementCount,
-          riskCount: constellation.riskCount,
-          decisionCount: constellation.decisionCount
-        },
-        sessionDrafts
-      }
-    )
+    content: [{ type: "text", text: textLines.join("\n") }],
+    structuredContent: {
+      ok: true,
+      summary: envelope.summary,
+      data: enrichedData,
+      next: envelope.next,
+      _meta: envelope._meta
+    }
   };
 }
 async function handleCommitConstellation(args) {
@@ -10027,55 +9956,25 @@ async function handleCommitConstellation(args) {
   if (!betId) {
     return validationResult("`betEntryId` is required for commit-constellation action.");
   }
-  const betEntry = await loadBetEntry(betId);
-  if (!betEntry) {
-    return {
-      content: [{ type: "text", text: `Bet \`${betId}\` not found.` }],
-      structuredContent: failure(
-        "NOT_FOUND",
-        `Bet '${betId}' not found.`,
-        "Use 'capture' to create a bet entry first, then pass its ID here.",
-        [{ tool: "capture", description: "Create a bet entry", parameters: { name: "<bet name>", description: "<bet description>" } }]
-      )
-    };
-  }
-  const betData = betEntry.data ?? {};
-  const operationId = args.operationId ?? `${betId}:${getAgentSessionId() ?? "sessionless"}:${betEntry.status}:${betEntry.currentVersion ?? 0}`;
-  const { blockers: commitBlockerItems, totalRelations } = await kernelQuery("chain.validateCommitConstellation", { betEntryId: betId });
-  if (commitBlockerItems.length > 0) {
-    return {
-      content: [{
-        type: "text",
-        text: [
-          `# Cannot commit constellation`,
-          "",
-          `**${commitBlockerItems.length} blocker(s) found** \u2014 fix these before committing:`,
-          ...commitBlockerItems.map((b) => `- ${b.blocker} \u2192 \`${b.fix}\``),
-          "",
-          "No entries were committed."
-        ].join("\n")
-      }],
-      structuredContent: failure(
-        "VALIDATION_ERROR",
-        `${commitBlockerItems.length} blocker(s) found. Fix before committing.`,
-        commitBlockerItems.map((b) => `${b.blocker} \u2192 ${b.fix}`).join("; "),
-        void 0,
-        {
-          operationId,
-          blockers: commitBlockerItems,
-          committedIds: [],
-          totalRelations
-        }
-      )
-    };
+  const { workspaceId } = await getWorkspaceContext();
+  const sessionId = getAgentSessionId();
+  const operationId = args.operationId ?? `${betId}:${sessionId ?? "sessionless"}:${Date.now()}`;
+  let betName = betId;
+  let betDesc = "";
+  let betCollectionHint;
+  try {
+    const betEnvelope = await kernelCallEnvelope("chain.getEntry", { entryId: betId });
+    const entry = betEnvelope.data;
+    if (entry) {
+      betName = entry.name ?? betId;
+      const d = entry.data ?? {};
+      const links = d["links"];
+      betDesc = d.problem ?? links?.problem ?? d.description ?? "";
+      betCollectionHint = entry.collectionSlug ?? entry.collection?.slug ?? entry.collection?.name;
+    }
+  } catch {
   }
-  const links = betData["links"];
-  const descField = betData.problem ?? links?.problem ?? betData.description ?? "";
-  const preflight = await runConflictPreflight(
-    betEntry.name ?? betId,
-    descField,
-    betEntry.collectionSlug ?? betEntry.collection?.slug ?? betEntry.collection?.name
-  );
+  const preflight = await runConflictPreflight(betName, betDesc, betCollectionHint);
   if (preflight.blockingContradictions.length > 0) {
     await recordSessionActivity({ contradictionWarning: true });
     const conflictLines = preflight.blockingContradictions.map((c) => `- ${c.chainEntryName} (${c.chainEntryId}) \u2014 ${c.explanation}`).join("\n");
@@ -10107,20 +10006,16 @@ async function handleCommitConstellation(args) {
   if (preflight.source === "semantic" ? preflight.conflicts.length > 0 : preflight.advisoryWarnings.length > 0) {
     await recordSessionActivity({ contradictionWarning: true });
   }
-  const author = getAgentSessionId() ? `agent:${getAgentSessionId()}` : void 0;
-  const sessionId = getAgentSessionId() ?? void 0;
-  let kernelEnvelope;
-  let result;
+  let envelope;
   try {
-    kernelEnvelope = await kernelCallEnvelope("chain.batchCommitConstellation", {
+    envelope = await kernelCallEnvelope("agentKnowledge.facilitateEnvelope", {
+      workspaceId,
+      action: "commit-constellation",
       betEntryId: betId,
-      author,
-      sessionId,
       operationId,
-      conflicts: preflight.conflicts
-      // pass for kernel-side enforcement (TEN-1405)
+      sessionId: sessionId ?? void 0,
+      author: sessionId ? `agent:${sessionId}` : "kernel:facilitate"
     });
-    result = kernelEnvelope.data;
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
     return {
@@ -10140,26 +10035,17 @@ No constellation entries were committed.`
       )
     };
   }
-  result = {
-    ...result,
-    committedIds: result.committedIds ?? [],
-    alreadyCommittedIds: result.alreadyCommittedIds ?? [],
-    proposedIds: result.proposedIds ?? [],
-    failedIds: result.failedIds ?? [],
-    conflictIds: result.conflictIds ?? []
-  };
-  for (const entryId of result.committedIds) {
+  await recordSessionActivity({ contradictionWarning: preflight.blockingContradictions.length > 0 });
+  for (const docId of envelope.data?.result?.committedIds ?? []) {
     try {
-      const committedEntry = await kernelQuery("chain.getEntry", { entryId });
-      const docId = committedEntry?._id;
-      if (typeof docId === "string" && docId.length > 0) {
-        await recordSessionActivity({ entryModified: docId });
-      }
+      await recordSessionActivity({ entryModified: docId });
     } catch {
     }
   }
+  const result = envelope.data.result;
+  const suggestions = { conflictPreflightSource: preflight.source };
   const lines = [];
-  const hasIssues = result.failedIds.length > 0 || result.conflictIds.length > 0;
+  const hasIssues = (result.failedIds?.length ?? 0) > 0 || (result.conflictIds?.length ?? 0) > 0;
   if (result.proposalCreated) {
     lines.push(
       hasIssues ? `# Proposal created with issues` : `# Proposal created`,
@@ -10171,50 +10057,54 @@ No constellation entries were committed.`
     lines.push(
       hasIssues ? `# Published with issues` : `# Published`,
       "",
-      `**${result.committedIds.length} entries** committed to the Chain, **${result.totalRelations} connections** preserved.`,
+      `**${result.committedIds?.length ?? 0} entries** committed to the Chain, **${result.totalRelations} connections** preserved.`,
       hasIssues ? `\`${betId}\` was partially committed. Review conflicts/failed entries below before considering the constellation complete.` : `\`${betId}\` and its full constellation are now source of truth.`
     );
   }
-  const contradictionWarnings = preflight.source === "semantic" ? preflight.conflicts : preflight.advisoryWarnings;
-  if (contradictionWarnings.length > 0) {
+  if (preflight.source === "semantic" && preflight.conflicts.length > 0) {
+    lines.push(
+      "",
+      `\u26A0 **Semantic conflict preflight** (advisory):`,
+      ...preflight.conflicts.map((c) => `- \`${c.chainEntryId}\` ${c.chainEntryName}: ${c.explanation}`)
+    );
+  } else if (preflight.source === "heuristic" && preflight.advisoryWarnings.length > 0) {
     lines.push(
       "",
-      preflight.source === "semantic" ? `\u26A0 **Semantic conflict preflight** (advisory):` : `\u26A0 **Contradiction warnings** (advisory):`,
-      ...preflight.source === "semantic" ? contradictionWarnings.map((c) => `- \`${c.chainEntryId}\` ${c.chainEntryName}: ${c.explanation}`) : contradictionWarnings.map(
+      `\u26A0 **Contradiction warnings** (advisory):`,
+      ...preflight.advisoryWarnings.map(
         (w) => `- \`${w.entryId}\` ${w.name} [${w.collection}] (${w.governsCount} governs relation${w.governsCount === 1 ? "" : "s"})`
       )
     );
   }
-  if (result.committedIds.length > 0) {
+  if ((result.committedIds?.length ?? 0) > 0) {
     lines.push("", `**Committed:** ${result.committedIds.join(", ")}`);
   }
-  if (result.alreadyCommittedIds.length > 0) {
+  if ((result.alreadyCommittedIds?.length ?? 0) > 0) {
     lines.push("", `**Already committed:** ${result.alreadyCommittedIds.join(", ")}`);
   }
-  if (result.proposedIds.length > 0) {
+  if ((result.proposedIds?.length ?? 0) > 0) {
     lines.push("", `**Proposed (not yet committed):** ${result.proposedIds.join(", ")}`);
   }
-  if (result.conflictIds.length > 0) {
+  if ((result.conflictIds?.length ?? 0) > 0) {
     lines.push("", `**${result.conflictIds.length} conflicts:**`);
     for (const c of result.conflictIds) {
       lines.push(`- \`${c.entryId}\` ${c.name}: ${c.reason}`);
     }
   }
-  if (result.failedIds.length > 0) {
+  if ((result.failedIds?.length ?? 0) > 0) {
     lines.push("", `**${result.failedIds.length} failed:**`);
     for (const f of result.failedIds) {
       lines.push(`- \`${f.entryId}\` ${f.name}: ${f.error}`);
     }
   }
-  const suggestions = { contradictionWarnings, conflictPreflightSource: preflight.source };
   return {
     content: [{ type: "text", text: lines.join("\n") }],
     structuredContent: {
       ok: true,
-      summary: kernelEnvelope.summary,
+      summary: envelope.summary,
       data: { result, suggestions },
-      next: kernelEnvelope.next,
-      _meta: kernelEnvelope._meta
+      next: envelope.next,
+      _meta: envelope._meta
     }
   };
 }
@@ -10370,7 +10260,7 @@ function registerVerifyTools(server) {
       inputSchema: verifySchema,
       annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false }
     },
-    withEnvelope(async ({ collection, mode }) => {
+    thinWrapper(async ({ collection, mode }) => {
       const projectRoot = resolveProjectRoot();
       if (!projectRoot) {
         return failureResult(
@@ -10558,7 +10448,7 @@ function registerVerifyTools(server) {
       inputSchema: verifyEntrySchema,
       annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
     },
-    withEnvelope(async ({ entryId }) => {
+    thinWrapper(async ({ entryId }) => {
       const result = await kernelMutation("chain.verifyEntry", { entryId });
       return success(`Entry ${entryId} verified.`, result);
     })
@@ -11292,7 +11182,7 @@ function registerStartTools(server) {
       inputSchema: startSchema,
       annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false }
     },
-    withEnvelope(async ({ preset, task }) => {
+    thinWrapper(async ({ preset, task }) => {
       const errors = [];
       const agentSessionId = getAgentSessionId();
       let wsCtx = null;
@@ -11830,7 +11720,7 @@ function registerUsageTools(server) {
       inputSchema: usageSummarySchema,
       annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false }
     },
-    withEnvelope(async ({ periodDays }) => {
+    thinWrapper(async ({ periodDays }) => {
       const ws = await getWorkspaceContext();
       const sessionId = getAgentSessionId();
       const summary = await kernelQuery("usage.getWorkspaceSummary", {
@@ -11954,7 +11844,7 @@ function registerGitChainTools(server) {
       inputSchema: chainSchema,
       annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
     },
-    withEnvelope(async ({ action, chainEntryId, title, chainTypeId, description, linkId, content, status, author }) => {
+    thinWrapper(async ({ action, chainEntryId, title, chainTypeId, description, linkId, content, status, author }) => {
       if (action === "create") {
         if (!title) {
           return validationResult("A `title` is required to create a process.");
@@ -12093,7 +11983,7 @@ Use \`chain action=get\` to see the full chain with updated scores.`
       inputSchema: chainVersionSchema,
       annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
     },
-    withEnvelope(async ({ action, chainEntryId, commitMessage, versionA, versionB, toVersion, author }) => {
+    thinWrapper(async ({ action, chainEntryId, commitMessage, versionA, versionB, toVersion, author }) => {
       if (action === "commit") {
         if (!commitMessage) {
           return validationResult("A `commitMessage` is required.");
@@ -12243,7 +12133,7 @@ ${formatted}` }],
       inputSchema: chainBranchSchema,
       annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
     },
-    withEnvelope(async ({ action, chainEntryId, branchName, strategy, author }) => {
+    thinWrapper(async ({ action, chainEntryId, branchName, strategy, author }) => {
       if (action === "create") {
         const result = await kernelMutation("gitchain.createBranch", { chainEntryId, name: branchName, author });
         return {
@@ -12363,7 +12253,7 @@ Resolve conflicts before merging.`
       inputSchema: chainReviewSchema,
       annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false }
     },
-    withEnvelope(async ({ action, chainEntryId, commitMessage, versionNumber, linkId, body, commentId, author }) => {
+    thinWrapper(async ({ action, chainEntryId, commitMessage, versionNumber, linkId, body, commentId, author }) => {
       if (action === "gate") {
         const gate = await kernelQuery("gitchain.runGate", { chainEntryId, commitMessage });
         const checkLines = gate.checks.map((c) => `- ${c.pass ? "PASS" : "FAIL"} **${c.name}**: ${c.detail}`).join("\n");
@@ -12518,7 +12408,7 @@ function registerMapTools(server) {
       inputSchema: createAudienceMapSetSchema,
       annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
     },
-    withEnvelope(async ({ audienceEntryId }) => {
+    thinWrapper(async ({ audienceEntryId }) => {
       const result = await kernelMutation(
         "maps.createAudienceMapSet",
         { audienceEntryId }
@@ -12564,7 +12454,7 @@ Use map-slot to add ingredients. View at /empathy, /narrowing, and /jobs.`
       inputSchema: mapSchema,
       annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
     },
-    withEnvelope(async ({ action, mapEntryId, title, templateId, description, slotIds, status }) => {
+    thinWrapper(async ({ action, mapEntryId, title, templateId, description, slotIds, status }) => {
       if (action === "create") {
         if (!title) {
           return validationResult("A `title` is required to create a map.");
@@ -12676,7 +12566,7 @@ ${lines.join("\n")}` }],
       inputSchema: mapSlotSchema,
       annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false }
     },
-    withEnvelope(async ({
+    thinWrapper(async ({
       action,
       mapEntryId,
       slotId,
@@ -12781,7 +12671,7 @@ ${slotSummary(map.slots)}` }],
       inputSchema: mapVersionSchema,
       annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
     },
-    withEnvelope(async ({ action, mapEntryId, commitMessage, author }) => {
+    thinWrapper(async ({ action, mapEntryId, commitMessage, author }) => {
       if (action === "commit") {
         const result = await kernelMutation("maps.commitMap", {
           mapEntryId,
@@ -12845,7 +12735,7 @@ ${lines.join("\n")}` }],
       inputSchema: mapSuggestSchema,
       annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false }
     },
-    withEnvelope(async ({ mapEntryId, slotId, query }) => {
+    thinWrapper(async ({ mapEntryId, slotId, query }) => {
       const map = await kernelQuery("maps.getMap", { mapEntryId });
       if (!map) {
         return {
@@ -13039,7 +12929,7 @@ function registerArchitectureTools(server) {
       inputSchema: architectureSchema,
       annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false }
     },
-    withEnvelope(async ({ action, template, layer, flow }) => {
+    thinWrapper(async ({ action, template, layer, flow }) => {
       await ensureCollection();
       const all = await listArchEntries();
       if (action === "show") {
@@ -13190,7 +13080,7 @@ ${nodeDetail}${flowLines}`
       inputSchema: architectureAdminSchema,
       annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false }
     },
-    withEnvelope(async ({ action }) => {
+    thinWrapper(async ({ action }) => {
       if (action === "seed") {
         await ensureCollection();
         const existing = await listArchEntries();
@@ -13609,7 +13499,7 @@ function registerOrientTool(server) {
       inputSchema: orientSchema,
       annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false }
     },
-    withEnvelope(async ({ mode = "full", task, scope }) => {
+    thinWrapper(async ({ mode = "full", task, scope }) => {
       const errors = [];
       if (scope && !task) {
         errors.push("--scope requires --task to filter governance. Scope was ignored.");
@@ -14729,7 +14619,7 @@ function registerHealthTools(server) {
       inputSchema: healthSchema,
       annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false }
     },
-    withEnvelope(async (args) => {
+    thinWrapper(async (args) => {
       const parsed = parseOrFail(healthSchema, args);
       if (!parsed.ok) return parsed.result;
       const { action, limit } = parsed.data;
@@ -14766,7 +14656,7 @@ function registerAuditTools(server) {
       inputSchema: auditSchema,
       annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
     },
-    withEnvelope(async (args) => {
+    thinWrapper(async (args) => {
       const parsed = parseOrFail(auditSchema, args);
       if (!parsed.ok) return parsed.result;
       const { entryId, phase = "shaping" } = parsed.data;
@@ -14881,7 +14771,7 @@ function registerGovernanceTools(server) {
       inputSchema: governanceSchema,
       annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
     },
-    withEnvelope(async ({ action, proposalId, verdict, reason, status }) => {
+    thinWrapper(async ({ action, proposalId, verdict, reason, status }) => {
       const wsCtx = await getWorkspaceContext();
       const enabled = await isFeatureEnabled(
         "bet-221-governance-at-scale",
@@ -15809,4 +15699,4 @@ export {
   SERVER_VERSION,
   createProductBrainServer
 };
-//# sourceMappingURL=chunk-RJXJO4DY.js.map
+//# sourceMappingURL=chunk-VD2UZKWN.js.map