@productbrain/mcp 0.0.1-beta.111 → 0.0.1-beta.122

package/dist/{chunk-O337N4MC.js → chunk-ZFODPVNH.js}

@@ -20,6 +20,7 @@ import {
   getWorkspaceContext,
   getWorkspaceId,
   initToolSurface,
+  isFeatureEnabled,
   isSessionOriented,
   mcpCall,
   mcpMutation,
@@ -43,12 +44,13 @@ import {
   unknownAction,
   validationResult,
   withEnvelope
-} from "./chunk-DHBJFEAT.js";
+} from "./chunk-G4WJIWXX.js";
 import {
+  trackChainEntryCommitted,
   trackKnowledgeGap,
   trackQualityCheck,
   trackQualityVerdict
-} from "./chunk-RQXM3TCI.js";
+} from "./chunk-2ZWGQ6PK.js";
 
 // src/server.ts
 import { McpServer as McpServer2 } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -96,7 +98,7 @@ var updateEntrySchema = z.object({
   order: z.number().optional().describe("New sort order"),
   canonicalKey: z.string().optional().describe("Semantic type (e.g. 'decision', 'tension'). Only changeable on draft/uncommitted entries."),
   autoPublish: z.boolean().optional().default(false).describe("Only true when user explicitly asks to publish. Default false = draft. Never auto-publish without user confirmation."),
-  changeNote: z.string().optional().describe("Short human-readable summary for history (e.g. 'Updated description to F1-themed copy'). If omitted, a friendly default is generated from fields changed.")
+  changeNote: z.string().optional().describe("Strongly recommended: short human-readable rationale for WHY this change was made (e.g. 'Aligned description with F1-themed copy per BET-238'). Surfaces in activity feed and pb get. If omitted, falls back to session purpose or auto-generated field summary.")
 });
 var getHistorySchema = z.object({
   entryId: z.string().describe("Entry ID, e.g. 'T-SUPPLIER', 'BR-001'")
@@ -271,7 +273,7 @@ ${formatted}` }],
     },
     withEnvelope(async ({ entryId }) => {
       requireWriteAccess();
-      const { runContradictionCheck } = await import("./smart-capture-ATJ5F7R2.js");
+      const { runContradictionCheck } = await import("./smart-capture-CVZ5PLUZ.js");
       const entry = await mcpQuery("chain.getEntry", { entryId });
       if (!entry) {
         return notFoundResult(entryId, `Entry '${entryId}' not found. Try search to find the right ID.`);
@@ -299,6 +301,13 @@ ${formatted}` }],
       const isProposal = result?.status === "proposal_created";
       if (!isProposal) {
         await recordSessionActivity({ entryModified: docId });
+        const coll = entry.collectionSlug ?? entry.collection?.slug;
+        trackChainEntryCommitted(wsCtx.workspaceId, {
+          entry_id: entry.entryId ?? entryId,
+          collection: coll,
+          commit_method: "manual",
+          surface: "mcp_commit_tool"
+        });
       }
       let lines;
       if (isProposal) {
@@ -516,6 +525,9 @@ async function handleGet(entryId) {
     `**Status:** ${e.status}${e.workflowStatus ? ` / ${e.workflowStatus}` : ""}`,
     `**Type:** ${e.canonicalKey ?? "untyped"}`
   ];
+  if (e.origin) lines.push(`**Origin:** ${e.origin}`);
+  if (e.verificationStatus) lines.push(`**Verification:** ${e.verificationStatus}`);
+  if (e.sourceRef) lines.push(`**Source ref:** ${e.sourceRef}`);
   if (epistemic) {
     lines.push(formatEpistemicLine(epistemic));
   }
@@ -556,6 +568,10 @@ async function handleGet(entryId) {
     status: String(e.status ?? ""),
     ...e.workflowStatus ? { workflowStatus: String(e.workflowStatus) } : {},
     ...epistemic ? { epistemicStatus: epistemic } : {},
+    // BET-240 S6: trust/provenance fields
+    ...e.origin ? { origin: String(e.origin) } : {},
+    ...e.verificationStatus ? { verificationStatus: String(e.verificationStatus) } : {},
+    ...e.sourceRef ? { sourceRef: String(e.sourceRef) } : {},
     entries: [{ entryId: e.entryId, name: e.name, status: e.status, ...e.workflowStatus ? { workflowStatus: e.workflowStatus } : {}, collectionName: String(e.collectionName ?? e.canonicalKey ?? "\u2014") }],
     ...visibleData ? { data: visibleData } : {},
     ...Array.isArray(e.relations) && e.relations.length > 0 ? {
@@ -1317,39 +1333,53 @@ function epistemicCollectionHint(collectionName) {
   if (lc === "assumptions") return " \u2014 _check evidence strength with `entries action=get`_";
   return "";
 }
-var CONTEXT_ACTIONS = ["gather", "build", "neighborhood"];
+var CONTEXT_ACTIONS = ["gather", "build", "neighborhood", "changes", "chain", "cross-cut", "incremental", "brief"];
 var contextSchema = z5.object({
   action: z5.enum(CONTEXT_ACTIONS).describe(
-    "'gather': assemble knowledge context (entry graph, task auto-load, journey mode, or graph mode). 'build': structured build spec for an entry. 'neighborhood': typed graph neighborhood for an entry \u2014 blocking chain, dependencies, parent context, tensions, staleness (BET-142)."
+    "'gather': assemble knowledge context (entry graph, task auto-load, journey mode, or graph mode). 'build': structured build spec for an entry. 'neighborhood': typed graph neighborhood for an entry \u2014 blocking chain, dependencies, parent context, tensions, staleness (BET-142). 'changes': entries modified and relations created since a timestamp (BET-239). Requires 'since' parameter. 'chain': directed traversal along one relation type to depth 4 (BET-239). Requires entryId. Optional: direction, relationType, maxHops (1-4). 'cross-cut': structural aggregation \u2014 all relations of a given type grouped by source collection (BET-239). Requires 'relationType' parameter. 'incremental': delta since last brief run for a skill (BET-239 E4). Requires 'skill' parameter. Returns only entries changed since the skill's last brief. 'brief': compound intelligence query (BET-239 E6). Requires 'briefType' parameter: 'steering' (changes + structure + delta + readiness), 'confidence' (changes + active bets + tensions), or 'delta' (changes + relations since timestamp). Optional 'since' for delta type."
   ),
   entryId: z5.string().optional().describe("Entry ID for graph traversal or build, e.g. 'FEAT-001', 'GT-019'"),
   mapEntryId: z5.string().optional().describe(
     "Journey map entry ID for journey-aware context (gather only). Returns context organised by journey stage. Takes precedence over entryId when both are supplied. Example: 'MAP-1'."
   ),
   task: z5.string().optional().describe("Natural-language task description for auto-loading relevant context (gather only)"),
+  since: z5.string().optional().describe(
+    "ISO 8601 timestamp for 'changes' action \u2014 returns entries/relations modified since this time. Example: '2026-03-24T00:00:00Z'."
+  ),
+  direction: z5.enum(["outgoing", "incoming"]).default("outgoing").optional().describe("For 'chain' action: traversal direction. 'outgoing' follows relations from source, 'incoming' follows relations to source. Default: outgoing."),
+  relationType: z5.string().optional().describe(
+    "Relation type filter. For 'chain': optional filter to traverse only this relation type. For 'cross-cut': required \u2014 scans all relations of this type across the workspace. Examples: 'part_of', 'informs', 'governs', 'blocks', 'depends_on'."
+  ),
   mode: z5.enum(["search", "graph"]).default("search").optional().describe("For gather: 'search' (default) or 'graph' (enhanced with provenance paths). Ignored when mapEntryId is provided."),
-  maxHops: z5.number().min(1).max(3).default(2).describe("Relation traversal depth (1=direct only, 2=default, 3=wide net)"),
-  maxResults: z5.number().min(1).max(25).default(10).optional().describe("Max entries to return in gather task mode (default 10)")
+  maxHops: z5.number().min(1).max(4).default(2).describe("Relation traversal depth (1=direct only, 2=default, 3=wide net, 4=deep chain walk)"),
+  maxResults: z5.number().min(1).max(25).default(10).optional().describe("Max entries to return in gather task mode (default 10)"),
+  strategy: z5.enum(["hybrid", "keyword"]).default("hybrid").optional().describe("Seed strategy for task-based gather: 'hybrid' (vector + FTS, default) or 'keyword' (FTS only). Only affects task mode."),
+  skill: z5.string().optional().describe(
+    "Skill name for 'incremental' action \u2014 identifies which skill's brief history to compare against. Examples: 'preflight', 'shaping', 'review'. Required when action is 'incremental'."
+  ),
+  briefType: z5.enum(["steering", "confidence", "delta"]).optional().describe(
+    "Compound query type for 'brief' action. 'steering': 7d changes + structural aggregation (part_of, depends_on, constrains) + incremental delta + workspace readiness. 'confidence': 7d changes + active bets summary + active tensions breakdown. 'delta': changes + relations since a custom timestamp (use 'since' param). Required when action is 'brief'."
+  )
 });
 function registerContextTools(server) {
   server.registerTool(
     "context",
     {
       title: "Context",
-      description: "Assemble knowledge context in one call. Three actions:\n\n- **gather**: Three modes \u2014 (1) By entry: traverse the graph around a specific entry. (2) By task: auto-load relevant domain knowledge for a natural-language task. (3) Graph mode (entryId + mode='graph'): enhanced traversal with provenance paths.\n- **build**: Structured build spec for any entry \u2014 data, related entries, business rules, glossary terms, chain refs. Use when starting a build. Requires active session.\n- **neighborhood**: Typed graph neighborhood \u2014 blocking chain (what this blocks, 3 hops), dependency chain (what blocks this), parent context (sibling count), related tensions, staleness signal, isolation signal. Fast indexed lookups. Requires entryId.",
+      description: "Assemble knowledge context in one call. Six actions:\n\n- **gather**: Three modes \u2014 (1) By entry: traverse the graph around a specific entry. (2) By task: auto-load relevant domain knowledge for a natural-language task. (3) Graph mode (entryId + mode='graph'): enhanced traversal with provenance paths.\n- **build**: Structured build spec for any entry \u2014 data, related entries, business rules, glossary terms, chain refs. Use when starting a build. Requires active session.\n- **neighborhood**: Typed graph neighborhood \u2014 blocking chain (what this blocks, 3 hops), dependency chain (what blocks this), parent context (sibling count), related tensions, staleness signal, isolation signal. Fast indexed lookups. Requires entryId.\n- **changes**: Detect entries modified and relations created since a timestamp. Use for incremental updates instead of full traversal. Requires 'since' (ISO 8601). Returns grouped counts by collection. Cap: 200 entries. (BET-239)\n- **chain**: Directed deep traversal along one relation type to depth 4 (BET-239). Use for dependency analysis, governance chains, strategic alignment. Requires entryId. Optional: direction (outgoing/incoming), relationType, maxHops (1-4). Cycle detection, fan-out cap 10/hop, total cap 100 nodes. Returns tree + edges.\n- **cross-cut**: Structural aggregation \u2014 all relations of a given type across the workspace, grouped by source collection. Use to answer 'show me everything connected by part_of'. Requires 'relationType'. Cap: 500 entries. (BET-239)\n- **incremental**: Delta since last brief run for a skill. Returns only entries changed since the skill's last brief, filtering out previously surfaced entries. Requires 'skill' parameter. Use for steering briefs that need incremental awareness. (BET-239 E4)\n- **brief**: Compound intelligence query composing multiple primitives. Requires 'briefType': 'steering' (7d changes + structure + delta + readiness), 'confidence' (7d changes + active bets + tensions), or 'delta' (changes since custom timestamp). Auto-records brief run for steering. (BET-239 E6)",
       inputSchema: contextSchema,
       annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false }
     },
     withEnvelope(async (args) => {
       const parsed = parseOrFail(contextSchema, args);
       if (!parsed.ok) return parsed.result;
-      const { action, entryId, mapEntryId, task, mode, maxHops, maxResults } = parsed.data;
+      const { action, entryId, mapEntryId, task, since, direction, relationType, mode, maxHops, maxResults, strategy, skill, briefType } = parsed.data;
       return runWithToolContext({ tool: "context", action }, async () => {
         if (action === "gather") {
           if (mapEntryId) {
             return handleJourneyGather(server, mapEntryId, maxHops ?? 2, maxResults ?? 20);
           }
-          return handleGather(server, entryId, task, mode ?? "search", maxHops ?? 2, maxResults ?? 10);
+          return handleGather(server, entryId, task, mode ?? "search", maxHops ?? 2, maxResults ?? 10, strategy ?? "keyword");
         }
         if (action === "build") {
           if (!entryId) {
@@ -1363,12 +1393,46 @@ function registerContextTools(server) {
           }
           return handleNeighborhood(entryId);
         }
+        if (action === "changes") {
+          if (!since) {
+            return validationResult("'since' (ISO 8601 timestamp) is required when action is 'changes'.");
+          }
+          return handleChanges(since);
+        }
+        if (action === "chain") {
+          if (!entryId) {
+            return validationResult("entryId is required when action is 'chain'.");
+          }
+          return handleChainWalk(entryId, direction ?? "outgoing", maxHops ?? 2, relationType);
+        }
+        if (action === "cross-cut") {
+          if (!relationType) {
+            return validationResult("'relationType' is required when action is 'cross-cut'. Examples: 'part_of', 'informs', 'governs'.");
+          }
+          return handleCrossCut(relationType);
+        }
+        if (action === "incremental") {
+          if (!skill) {
+            return validationResult("'skill' is required when action is 'incremental'. Examples: 'preflight', 'shaping', 'review'.");
+          }
+          return handleIncremental(skill);
+        }
+        if (action === "brief") {
+          if (!briefType) {
+            return validationResult("'briefType' is required when action is 'brief'. Options: 'steering', 'confidence', 'delta'.");
+          }
+          const sinceMs = briefType === "delta" && since ? Date.parse(since) : void 0;
+          if (briefType === "delta" && since && (sinceMs === void 0 || isNaN(sinceMs))) {
+            return validationResult(`Invalid 'since' timestamp: '${since}'. Use ISO 8601 format (e.g. '2026-03-24T00:00:00Z').`);
+          }
+          return handleBrief(briefType, sinceMs);
+        }
         return unknownAction(action, CONTEXT_ACTIONS);
       });
     })
   );
 }
-async function handleGather(server, entryId, task, mode, maxHops, maxResults) {
+async function handleGather(server, entryId, task, mode, maxHops, maxResults, strategy = "hybrid") {
   if (!entryId && !task) {
     return validationResult("Provide either entryId (graph traversal) or task (auto-load context).");
   }
@@ -1426,11 +1490,12 @@ Use \`graph action=suggest\` to discover potential connections.`
         const hopLabel = e.hop > 1 ? ` (hop ${e.hop})` : "";
         const scoreLabel = typeof e.score === "number" ? `  ${e.score}` : "";
         const flagsLabel = e.scoreFlags?.length ? ` [${e.scoreFlags.join(", ")}]` : "";
+        const originLabel = e.origin ? ` (origin: ${e.origin})` : "";
         const provenancePath = e.provenance && e.provenance.length > 1 ? `
   _Path: ${e.provenance.map((p) => `${p.entryId ?? p.name} [${p.relationType}]`).join(" \u2192 ")}_` : "";
         const preview = e.preview ? `
   ${e.preview.substring(0, 120)}` : "";
-        lines2.push(`- ${arrow} **${e.relationType}** ${id}${e.name}${hopLabel}${scoreLabel}${flagsLabel}${provenancePath}${preview}`);
+        lines2.push(`- ${arrow} **${e.relationType}** ${id}${e.name}${hopLabel}${scoreLabel}${flagsLabel}${originLabel}${provenancePath}${preview}`);
       }
       lines2.push("");
     }
@@ -1457,12 +1522,17 @@ Use \`graph action=suggest\` to discover potential connections.`
     };
   }
   if (task && !entryId) {
+    const strategyLabel = strategy === "hybrid" ? "hybrid (vector + FTS)" : "keyword (FTS only)";
     await server.sendLoggingMessage({
       level: "info",
-      data: `Loading context for task: "${task.substring(0, 80)}..."`,
+      data: `Loading context for task: "${task.substring(0, 80)}..." [strategy: ${strategyLabel}]`,
       logger: "product-brain"
     });
-    const result2 = await mcpQuery("chain.taskAwareGatherContext", {
+    const result2 = strategy === "hybrid" ? await mcpQuery("chain.taskAwareHybridGatherContext", {
+      task,
+      maxHops,
+      maxResults
+    }) : await mcpQuery("chain.taskAwareGatherContext", {
       task,
       maxHops,
       maxResults
@@ -1499,11 +1569,16 @@ _This helps future sessions start with better context._`
       if (!byCollection2.has(key)) byCollection2.set(key, []);
       byCollection2.get(key).push(entry);
     }
+    const seedDisplay = result2.seeds?.map((s) => {
+      const id = s.entryId ?? s.name;
+      return s.source ? `${id} [${s.source}]` : id;
+    }).join(", ") ?? "none";
     const lines2 = [
       `# Context Loaded`,
       `**Confidence:** ${result2.confidence.charAt(0).toUpperCase() + result2.confidence.slice(1)}`,
+      `**Strategy:** ${strategyLabel}`,
       `**Matched:** ${result2.totalFound} entries across ${byCollection2.size} collection${byCollection2.size === 1 ? "" : "s"}`,
-      `**Seeds:** ${result2.seeds?.map((s) => s.entryId ?? s.name).join(", ") ?? "none"}`,
+      `**Seeds:** ${seedDisplay}`,
       ""
     ];
     for (const [collName, entries] of byCollection2) {
@@ -1513,8 +1588,9 @@ _This helps future sessions start with better context._`
         const id = e.entryId ? `**${e.entryId}:** ` : "";
         const scoreLabel = typeof e.score === "number" ? `  ${e.score}` : "";
         const flagsLabel = e.scoreFlags?.length ? ` [${e.scoreFlags.join(", ")}]` : "";
+        const originLabel = e.origin ? ` (origin: ${e.origin})` : "";
         const hopLabel = e.hop > 0 ? ` _(hop ${e.hop}, ${arrow} ${e.relationType})_` : "";
-        lines2.push(`- ${id}${e.name}${scoreLabel}${flagsLabel}${hopLabel}`);
+        lines2.push(`- ${id}${e.name}${scoreLabel}${flagsLabel}${originLabel}${hopLabel}`);
       }
       lines2.push("");
     }
@@ -1527,8 +1603,8 @@ _This helps future sessions start with better context._`
     return {
       content: [{ type: "text", text: lines2.join("\n") }],
       structuredContent: success(
-        `Loaded ${result2.totalFound} entries for task (${result2.confidence} confidence).`,
-        { entries: taskEntries, totalFound: result2.totalFound, confidence: result2.confidence }
+        `Loaded ${result2.totalFound} entries for task (${result2.confidence} confidence, ${strategy} strategy).`,
+        { entries: taskEntries, totalFound: result2.totalFound, confidence: result2.confidence, strategy }
       )
     };
   }
@@ -1827,6 +1903,408 @@ async function handleBuild(server, entryId, maxHops) {
     )
   };
 }
+async function handleCrossCut(relationType) {
+  const result = await mcpQuery("chain.structuralAggregation", {
+    relationType
+  });
+  const groupKeys = Object.keys(result.groups);
+  if (result.totalCount === 0) {
+    return {
+      content: [{
+        type: "text",
+        text: `# Cross-Cut: ${relationType}
+
+No relations of type '${relationType}' found in this workspace.`
+      }],
+      structuredContent: success(
+        `No '${relationType}' relations found.`,
+        { groups: {}, totalCount: 0, truncated: false }
+      )
+    };
+  }
+  const lines = [
+    `# Cross-Cut: ${relationType}`,
+    `_${result.totalCount} relations across ${groupKeys.length} source collection${groupKeys.length === 1 ? "" : "s"}${result.truncated ? " (TRUNCATED \u2014 more relations exist)" : ""}_`,
+    ""
+  ];
+  for (const [sourceSlug, items] of Object.entries(result.groups)) {
+    lines.push(`## ${sourceSlug} (${items.length})`);
+    for (const item of items) {
+      const fromId = item.entryId ? `**${item.entryId}:** ` : "";
+      const toId = item.relatedEntryId ?? item.relatedName;
+      lines.push(`- ${fromId}${item.name} \u2192 ${toId} [${item.relatedCollectionSlug}]`);
+    }
+    lines.push("");
+  }
+  if (result.truncated) {
+    lines.push("_Results truncated at 500 relations. Filter by collection or use a more specific relation type._");
+  }
+  return {
+    content: [{ type: "text", text: lines.join("\n") }],
+    structuredContent: success(
+      `${result.totalCount} '${relationType}' relations across ${groupKeys.length} collections.${result.truncated ? " Truncated." : ""}`,
+      result
+    )
+  };
+}
+async function handleChainWalk(entryId, direction, maxHops, relationType) {
+  const clampedHops = Math.max(1, Math.min(4, maxHops));
+  const result = await mcpQuery("chain.deepChainWalk", {
+    entryId,
+    direction,
+    maxHops: clampedHops,
+    ...relationType ? { relationType } : {}
+  });
+  if (result.error) {
+    return notFoundResult(entryId, result.error);
+  }
+  if (result.totalNodes <= 1) {
+    return {
+      content: [{
+        type: "text",
+        text: `# Chain Walk: ${entryId}
+
+_No ${direction} relations found${relationType ? ` of type '${relationType}'` : ""}._
+
+Try \`context action=chain entryId="${entryId}" direction="${direction === "outgoing" ? "incoming" : "outgoing"}"\` or remove the relationType filter.`
+      }],
+      structuredContent: success(
+        `No ${direction} relations found for ${entryId}.`,
+        result
+      )
+    };
+  }
+  const lines = [
+    `# Chain Walk: ${entryId}`,
+    `**Direction:** ${direction}  |  **Depth:** ${clampedHops}${relationType ? `  |  **Type filter:** ${relationType}` : ""}`,
+    `**Nodes:** ${result.totalNodes}${result.truncated ? " (TRUNCATED at 100)" : ""}  |  **Edges:** ${result.edges.length}  |  **Cycles:** ${result.cycles.length}`,
+    ""
+  ];
+  const maxDepth = Math.max(...result.nodes.map((n) => n.depth));
+  for (let d = 0; d <= maxDepth; d++) {
+    const atDepth = result.nodes.filter((n) => n.depth === d);
+    if (atDepth.length === 0) continue;
+    const label = d === 0 ? "Root" : `Depth ${d}`;
+    lines.push(`## ${label} (${atDepth.length})`);
+    for (const node of atDepth) {
+      const indent = "  ".repeat(d);
+      const id = node.entryId ? `**${node.entryId}:** ` : "";
+      const collection = node.collectionSlug ? ` [${node.collectionSlug}]` : "";
+      const parent = node.parentEntryId ? ` (via ${node.parentEntryId})` : "";
+      lines.push(`${indent}- ${id}${node.name}${collection}${parent}`);
+    }
+    lines.push("");
+  }
+  if (result.cycles.length > 0) {
+    lines.push("## Cycles Detected");
+    for (const cycle of result.cycles) {
+      lines.push(`- ${cycle.path.join(" -> ")}`);
+    }
+    lines.push("");
+  }
+  if (result.snapshotWarning) {
+    lines.push("_Note: This traversal spans multiple reads (Convex action). Data consistency is not guaranteed across hops (TEN-1029)._");
+  }
+  if (result.truncated) {
+    lines.push("_Results truncated at 100 nodes. Narrow with relationType filter or reduce maxHops._");
+  }
+  return {
+    content: [{ type: "text", text: lines.join("\n") }],
+    structuredContent: success(
+      `Chain walk for ${entryId}: ${result.totalNodes} nodes, ${result.edges.length} edges, ${result.cycles.length} cycles (${direction}, depth ${clampedHops}).`,
+      result
+    )
+  };
+}
+async function handleChanges(since) {
+  const sinceMs = Date.parse(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 totalEntries = result.entries.length;
+  const totalRelations = result.relations.length;
+  if (totalEntries === 0 && totalRelations === 0) {
+    return {
+      content: [{
+        type: "text",
+        text: `# Changes since ${since}
+
+No entries modified or relations created since this timestamp.`
+      }],
+      structuredContent: success(
+        `No changes detected since ${since}.`,
+        { entries: [], relations: [], counts: {}, truncated: false }
+      )
+    };
+  }
+  const lines = [
+    `# Changes since ${since}`,
+    `_${totalEntries} entries modified, ${totalRelations} relations created${result.truncated ? " (TRUNCATED \u2014 more changes exist)" : ""}_`,
+    ""
+  ];
+  if (totalEntries > 0) {
+    lines.push("## Modified Entries");
+    const sortedCounts = Object.entries(result.counts).sort((a, b) => b[1] - a[1]);
+    for (const [slug, count] of sortedCounts) {
+      lines.push(`### ${slug} (${count})`);
+      const slugEntries = result.entries.filter((e) => e.collectionSlug === slug);
+      for (const e of slugEntries) {
+        const id = e.entryId ? `**${e.entryId}:** ` : "";
+        const ago = formatTimeAgo(e.updatedAt);
+        lines.push(`- ${id}${e.name} _(${ago})_`);
+      }
+      lines.push("");
+    }
+  }
+  if (totalRelations > 0) {
+    lines.push("## New Relations");
+    for (const r of result.relations) {
+      const from = r.fromEntryId ?? "?";
+      const to = r.toEntryId ?? "?";
+      const ago = formatTimeAgo(r.createdAt);
+      lines.push(`- ${from} **${r.type}** ${to} _(${ago})_`);
+    }
+    lines.push("");
+  }
+  if (result.truncated) {
+    lines.push("_Results truncated at 200 entries. Use a more recent timestamp to narrow the window._");
+  }
+  return {
+    content: [{ type: "text", text: lines.join("\n") }],
+    structuredContent: success(
+      `${totalEntries} entries modified, ${totalRelations} relations created since ${since}.${result.truncated ? " Truncated." : ""}`,
+      result
+    )
+  };
+}
+async function handleIncremental(skill) {
+  const result = await mcpQuery("chain.incrementalChanges", { skill });
+  const totalEntries = result.newEntries.length;
+  const surfacedIds = result.newEntries.map((e) => e.entryId).filter((id) => id !== null);
+  mcpMutation("chain.recordBriefRun", {
+    skill,
+    entriesSurfaced: surfacedIds,
+    timestamp: Date.now()
+  }).catch(() => {
+  });
+  if (totalEntries === 0 && !result.isFirstRun) {
+    return {
+      content: [{
+        type: "text",
+        text: `# Incremental Brief \u2014 ${skill}
+
+No new entries since last brief run (${formatTimeAgo(result.previousRunTimestamp)}).`
+      }],
+      structuredContent: success(
+        `No new entries for skill '${skill}' since last brief.`,
+        result
+      )
+    };
+  }
+  const lines = [
+    `# Incremental Brief \u2014 ${skill}`
+  ];
+  if (result.isFirstRun) {
+    lines.push("_First run \u2014 showing all recent entries._");
+  } else {
+    lines.push(`_Delta since last brief (${formatTimeAgo(result.previousRunTimestamp)})_`);
+  }
+  lines.push(`_${totalEntries} new entries${result.truncated ? " (TRUNCATED)" : ""}_`);
+  lines.push("");
+  if (totalEntries > 0) {
+    lines.push("## New Entries");
+    const byCollection = {};
+    for (const e of result.newEntries) {
+      const slug = e.collectionSlug;
+      if (!byCollection[slug]) byCollection[slug] = [];
+      byCollection[slug].push(e);
+    }
+    const sortedSlugs = Object.entries(byCollection).sort((a, b) => b[1].length - a[1].length).map(([slug]) => slug);
+    for (const slug of sortedSlugs) {
+      const entries = byCollection[slug];
+      lines.push(`### ${slug} (${entries.length})`);
+      for (const e of entries) {
+        const id = e.entryId ? `**${e.entryId}:** ` : "";
+        const ago = formatTimeAgo(e.updatedAt);
+        lines.push(`- ${id}${e.name} _(${ago})_`);
+      }
+      lines.push("");
+    }
+  }
+  if (result.truncated) {
+    lines.push("_Results truncated at 200 entries. Run more frequently to stay within the cap._");
+  }
+  return {
+    content: [{ type: "text", text: lines.join("\n") }],
+    structuredContent: success(
+      `${totalEntries} new entries for skill '${skill}'${result.isFirstRun ? " (first run)" : ""}.${result.truncated ? " Truncated." : ""}`,
+      result
+    )
+  };
+}
+async function handleBrief(briefType, sinceMs) {
+  const args = { type: briefType };
+  if (sinceMs !== void 0) args.since = sinceMs;
+  const result = await mcpQuery("chain.compoundQuery", args);
+  if (briefType === "steering") {
+    return formatSteeringBrief(result);
+  }
+  if (briefType === "confidence") {
+    return formatConfidencePass(result);
+  }
+  if (briefType === "delta") {
+    return formatDeltaSync(result);
+  }
+  return validationResult(`Unknown briefType: ${briefType}`);
+}
+function formatSteeringBrief(result) {
+  const changes = result.changes;
+  const delta = result.delta;
+  const readiness = result.readiness;
+  const lines = [
+    "# Steering Brief",
+    "",
+    `## Changes (last 7 days)`,
+    `_${changes.entries.length} entries modified, ${changes.relations.length} relations created${changes.truncated ? " (TRUNCATED)" : ""}_`,
+    ""
+  ];
+  if (Object.keys(changes.counts).length > 0) {
+    const sortedCounts = Object.entries(changes.counts).sort((a, b) => b[1] - a[1]);
+    for (const [slug, count] of sortedCounts) {
+      lines.push(`- **${slug}:** ${count}`);
+    }
+    lines.push("");
+  }
+  lines.push("## Structure");
+  for (const [relType, agg] of Object.entries(result.structure)) {
+    const groupCount = Object.keys(agg.groups).length;
+    lines.push(`- **${relType}:** ${agg.totalCount} relations across ${groupCount} collection groups${agg.truncated ? " (TRUNCATED)" : ""}`);
+  }
+  lines.push("");
+  lines.push("## Incremental Delta (steering skill)");
+  if (delta.isFirstRun) {
+    lines.push("_First run \u2014 all recent entries included._");
+  }
+  lines.push(`${delta.newEntries.length} new entries since last steering brief${delta.truncated ? " (TRUNCATED)" : ""}`);
+  lines.push("");
+  lines.push("## Workspace Readiness");
+  lines.push(`Score: **${readiness.score}%** (${readiness.passedChecks}/${readiness.totalChecks} checks passed)`);
+  if (readiness.gaps.length > 0) {
+    lines.push("");
+    lines.push("**Gaps:**");
+    for (const gap of readiness.gaps.slice(0, 5)) {
+      lines.push(`- ${gap.label}: ${gap.current}/${gap.required}${gap.guidance ? ` \u2014 ${gap.guidance}` : ""}`);
+    }
+  }
+  lines.push("");
+  lines.push("## Trust");
+  lines.push("_Scoring kernel applies trust weighting: human=1.0, agent+verified=0.7, agent+unverified=0.56, external+unverified=0.64. Scores in context/gather reflect this. Use `orient -b` for workspace trust metrics._");
+  lines.push("");
+  if (result.snapshotWarning) {
+    lines.push("_Note: Compound query spans multiple reads. Data consistency is not guaranteed across components (TEN-1029)._");
+  }
+  return {
+    content: [{ type: "text", text: lines.join("\n") }],
+    structuredContent: success(
+      `Steering brief: ${changes.entries.length} changes, ${delta.newEntries.length} new entries, ${readiness.score}% readiness.`,
+      { ...result, trustFilterActive: true }
+    )
+  };
+}
+function formatConfidencePass(result) {
+  const changes = result.changes;
+  const lines = [
+    "# Confidence Pass",
+    "",
+    `## Changes (last 7 days)`,
+    `_${changes.entries.length} entries modified${changes.truncated ? " (TRUNCATED)" : ""}_`,
+    ""
+  ];
+  lines.push(`## Active Bets (${result.betCount})`);
+  if (result.activeBets.length > 0) {
+    for (const bet of result.activeBets) {
+      const id = bet.entryId ? `**${bet.entryId}:** ` : "";
+      lines.push(`- ${id}${bet.name} [${bet.status}]`);
+    }
+  } else {
+    lines.push("_No active bets._");
+  }
+  lines.push("");
+  lines.push(`## Active Tensions (${result.tensionCount})`);
+  if (result.activeTensions.length > 0) {
+    for (const tension of result.activeTensions) {
+      const id = tension.entryId ? `**${tension.entryId}:** ` : "";
+      lines.push(`- ${id}${tension.name}`);
+    }
+  } else {
+    lines.push("_No active tensions._");
+  }
+  lines.push("");
+  lines.push("## Trust");
+  lines.push("_Trust-weighted scoring active: agent-origin and unverified entries receive lower confidence scores (human=1.0, agent+verified=0.7, agent+unverified=0.56). Use `entries action=get` to inspect individual entry origin/verification. Use `orient -b` for workspace trust metrics._");
+  lines.push("");
+  if (result.snapshotWarning) {
+    lines.push("_Note: Compound query spans multiple reads. Data consistency is not guaranteed across components (TEN-1029)._");
+  }
+  return {
+    content: [{ type: "text", text: lines.join("\n") }],
+    structuredContent: success(
+      `Confidence pass: ${changes.entries.length} changes, ${result.betCount} active bets, ${result.tensionCount} active tensions.`,
+      { ...result, trustFilterActive: true }
+    )
+  };
+}
+function formatDeltaSync(result) {
+  const changes = result.changes;
+  const sinceDate = new Date(result.since).toISOString();
+  const lines = [
+    `# Delta Sync since ${sinceDate}`,
+    `_${changes.entries.length} entries modified, ${changes.relations.length} relations created${changes.truncated ? " (TRUNCATED)" : ""}_`,
+    ""
+  ];
+  if (changes.entries.length > 0) {
+    lines.push("## Modified Entries");
+    const sortedCounts = Object.entries(changes.counts).sort((a, b) => b[1] - a[1]);
+    for (const [slug, count] of sortedCounts) {
+      lines.push(`### ${slug} (${count})`);
+      const slugEntries = changes.entries.filter((e) => e.collectionSlug === slug);
+      for (const e of slugEntries) {
+        const id = e.entryId ? `**${e.entryId}:** ` : "";
+        const ago = formatTimeAgo(e.updatedAt);
+        lines.push(`- ${id}${e.name} _(${ago})_`);
+      }
+      lines.push("");
+    }
+  }
+  if (changes.relations.length > 0) {
+    lines.push("## New Relations");
+    for (const r of changes.relations) {
+      const from = r.fromEntryId ?? "?";
+      const to = r.toEntryId ?? "?";
+      const ago = formatTimeAgo(r.createdAt);
+      lines.push(`- ${from} **${r.type}** ${to} _(${ago})_`);
+    }
+    lines.push("");
+  }
+  if (result.snapshotWarning) {
+    lines.push("_Note: Compound query spans multiple reads. Data consistency is not guaranteed across components (TEN-1029)._");
+  }
+  return {
+    content: [{ type: "text", text: lines.join("\n") }],
+    structuredContent: success(
+      `Delta sync since ${sinceDate}: ${changes.entries.length} entries, ${changes.relations.length} relations.${changes.truncated ? " Truncated." : ""}`,
+      result
+    )
+  };
+}
+function formatTimeAgo(ms) {
+  const diff = Date.now() - ms;
+  if (diff < 6e4) return "just now";
+  if (diff < 36e5) return `${Math.floor(diff / 6e4)}m ago`;
+  if (diff < 864e5) return `${Math.floor(diff / 36e5)}h ago`;
+  return `${Math.floor(diff / 864e5)}d ago`;
+}
 
 // src/tools/collections.ts
 import { z as z6 } from "zod";
@@ -1850,7 +2328,9 @@ var fieldSchema = z6.object({
   iconMap: z6.record(z6.string(), z6.string()).optional().describe("ENT-61: maps field values to icons (emoji/symbol), prepended to badge text"),
   helpText: z6.string().optional().describe("Help text shown in editors and describe output"),
   optionDescriptions: z6.record(z6.string()).optional().describe("Per-option guidance for select fields"),
-  semanticRole: z6.enum(["problem", "appetite", "elements", "architecture", "done_when", "risks", "exclusions"]).optional().describe("BET-136: Semantic role for schema-driven consumers \u2014 enables field-key-independent validation and rendering")
+  semanticRole: z6.enum(["problem", "appetite", "elements", "architecture", "done_when", "risks", "exclusions"]).optional().describe("BET-136: Semantic role for schema-driven consumers \u2014 enables field-key-independent validation and rendering"),
+  maxLength: z6.number().optional().describe("BET-196: Maximum character length for field values. Three-tier resolution: explicit > displayHint > type fallback."),
+  minLength: z6.number().optional().describe("BET-196: Minimum character length for field values. Only explicit \u2014 no defaults.")
 });
 var collectionsSchema = z6.object({
   action: z6.enum(COLLECTIONS_ACTIONS).describe(
@@ -3138,10 +3618,13 @@ async function runWrapupCommitAll(data, cachedSuggestions) {
   requireWriteAccess();
   const sessionId = getAgentSessionId();
   if (!sessionId) {
-    return { text: "No active session.", committed: 0, proposalsCreated: 0, linksCreated: 0, failed: 0 };
+    return { text: "No active session.", committed: 0, proposalsCreated: 0, linksCreated: 0, linksFailed: 0, failed: 0 };
   }
+  const wsCtx = await getWorkspaceContext();
   const results = [];
   let linksCreated = 0;
+  let linksFailed = 0;
+  const linkFailureDetails = [];
   let proposalsCreated = 0;
   for (const draft of data.drafts) {
     try {
@@ -3153,6 +3636,11 @@ async function runWrapupCommitAll(data, cachedSuggestions) {
       const proposed = result?.status === "proposal_created";
       if (!proposed) {
         await recordSessionActivity({ entryModified: draft.docId });
+        trackChainEntryCommitted(wsCtx.workspaceId, {
+          entry_id: draft.entryId,
+          commit_method: "manual",
+          surface: "mcp_wrapup"
+        });
       }
       if (proposed) {
         proposalsCreated++;
@@ -3186,8 +3674,22 @@ async function runWrapupCommitAll(data, cachedSuggestions) {
         sessionId
       });
       linksCreated += batchResult?.created ?? 0;
+      if (batchResult && batchResult.failed > 0) {
+        linksFailed += batchResult.failed;
+        const failedResults = batchResult.results.map((r, i) => ({ ...r, index: i })).filter((r) => !r.ok);
+        for (const fr of failedResults) {
+          const rel = batchRels[fr.index];
+          if (rel) {
+            linkFailureDetails.push(
+              `${rel.fromEntryId} \u2192 ${rel.toEntryId} [${rel.type}]: ${fr.error ?? "unknown error"}`
+            );
+          }
+        }
+      }
     } catch (err) {
-      console.warn("[wrapup] batch relation creation failed \u2014 links from this session may be missing:", err);
+      linksFailed += batchRels.length;
+      const msg = err instanceof Error ? err.message : String(err);
+      linkFailureDetails.push(`Batch creation failed (${batchRels.length} relations): ${msg}`);
     }
   }
   for (const s of governsRels) {
@@ -3201,7 +3703,10 @@ async function runWrapupCommitAll(data, cachedSuggestions) {
       if (result?.status !== "proposal_created") {
         linksCreated++;
       }
-    } catch {
+    } catch (err) {
+      linksFailed++;
+      const msg = err instanceof Error ? err.message : String(err);
+      linkFailureDetails.push(`${s.fromEntryId} \u2192 ${s.toEntryId} [${s.type}]: ${msg}`);
     }
   }
   const committed = results.filter((r) => r.ok && !r.proposed).length;
@@ -3217,6 +3722,9 @@ async function runWrapupCommitAll(data, cachedSuggestions) {
     "",
     `**${committed}** drafts committed, **${proposalsCreated}** proposals created, **${linksCreated}** links created.`
   ];
+  if (linksFailed > 0) {
+    lines.push(`**${linksFailed}** link${linksFailed === 1 ? "" : "s"} failed to create.`);
+  }
   if (failed.length > 0) {
     lines.push("");
     lines.push("### Failed to commit");
@@ -3225,11 +3733,20 @@ async function runWrapupCommitAll(data, cachedSuggestions) {
     }
     lines.push("_These remain as drafts for next session._");
   }
+  if (linkFailureDetails.length > 0) {
+    lines.push("");
+    lines.push("### Failed to create links");
+    for (const detail of linkFailureDetails) {
+      lines.push(`- ${detail}`);
+    }
+    lines.push("_You can create these links manually with `entries action=create-relation`._");
+  }
   return {
     text: lines.join("\n"),
     committed,
     proposalsCreated,
     linksCreated,
+    linksFailed,
     failed: failed.length
   };
 }
@@ -3264,13 +3781,15 @@ function registerWrapupTools(server) {
       lastReviewData = null;
       lastReviewSuggestions = [];
       lastReviewSessionId = null;
+      const linkWarnSuffix = result.linksFailed > 0 ? `, ${result.linksFailed} link(s) failed` : "";
       return successResult(
         result.text,
-        `Wrapup processed: ${result.committed} committed, ${result.proposalsCreated} proposals, ${result.linksCreated} links.`,
+        `Wrapup processed: ${result.committed} committed, ${result.proposalsCreated} proposals, ${result.linksCreated} links${linkWarnSuffix}.`,
         {
           committed: result.committed,
           proposalsCreated: result.proposalsCreated,
           linksCreated: result.linksCreated,
+          linksFailed: result.linksFailed,
           failed: result.failed
         }
       );
@@ -3835,7 +4354,9 @@ var RETRO_WORKFLOW_DESCRIPTOR = {
 5. **Synthesize between rounds.** After collecting input, reflect back what you heard before moving on.
 6. **Never go silent.** If something fails, say what happened and what to do next.
 7. **Finalize through the workflow substrate.** Complete the terminal round with \`workflows action=checkpoint ... isFinal=true\` so the durable run creates the retro draft record.
-8. **Match the energy.** Be warm but structured. This is a ceremony, not a checklist.
+8. **Session before checkpoint (default).** Before the **first** \`workflows action=checkpoint\` in this run, ensure an **active** agent write session: MCP \`session action=start\` or \`pb session start\` (DEC-9, STD-135). Inactive or superseded sessions commonly return **400** on checkpoint \u2014 durable progress is lost unless the chat record or a **handoff block** preserves it (see handoff skill: Facilitated workflow handoff).
+9. **Hand off mid-flight.** If the user switches agents or checkpoint keeps failing, emit the **Facilitated workflow handoff** package from \`.productbrain/skills/handoff.md\` (copy-paste block). Another agent resumes from that block + \`workflows get-run\` or \`start\` with \`restart=true\` \u2014 see workflow \`errorRecovery\`.
+10. **Match the energy.** Be warm but structured. This is a ceremony, not a checklist.
 
 ## Communication Style
 
@@ -3991,6 +4512,8 @@ Create a Cursor Plan with these rounds as tasks. Mark each in_progress as you en
 3. **Plan creation fails**: Continue without the Plan. The conversation IS the record.
 4. **Participant goes off-topic**: Gently redirect: "That's valuable \u2014 let's capture it. For now, let's stay with [current round]."
 5. **Participant wants to stop**: Respect it. Summarize what you have so far. Offer to commit partial results to the Chain.
+6. **Checkpoint failed (e.g. 400, superseded session)**: Say so in one line. **Start or refresh session** (\`session action=start\` / \`pb session start\`), then \`workflows action=get-run\` with the \`runId\` you were given. If the run is **incomplete**, retry \`checkpoint\` with that \`runId\`. If the run is **complete** or **missing**, treat server state as unreliable: run \`workflows action=start workflowId=retro restart=true\` and **paste the Facilitated workflow handoff block** from the prior chat into round 1 so scope and completed rounds are explicit \u2014 do not assume partial server progress exists.
+7. **Cross-agent resume (default expectation)**: Receiving agent reads the handoff block first. Prefer \`get-run\` to verify status; otherwise **restart** and continue from the **next round** named in the handoff. The conversation + handoff block are valid SSOT when ChainWork did not persist checkpoints (TEN-917).
 
 The retro must never fail silently. Always communicate state.`
 };
@@ -4053,7 +4576,7 @@ Use \`workflows action=checkpoint\` after each round to persist progress to the
         description: "Confirmed problem statement and appetite",
         format: "structured"
       },
-      kbCollection: "bets",
+      kbCollection: "work-packages",
       maxDurationHint: "10 min"
     },
     {
@@ -4123,16 +4646,16 @@ Use \`workflows action=checkpoint\` after each round to persist progress to the
         description: "Final capture summary \u2014 entries committed, relations created",
         format: "structured"
       },
-      kbCollection: "bets",
+      kbCollection: "work-packages",
       maxDurationHint: "5 min"
     }
   ],
   output: {
     primaryRecord: {
       routing: {
-        // BET-145 E6 / FEAT-468: shape workflow outputs route to bets collection (DEC-245).
+        // BET-145 E6 / FEAT-468: shape workflow outputs route to work-packages collection (DEC-245, BET-230 S5).
         mode: "fixed",
-        collection: "bets"
+        collection: "work-packages"
       }
     },
     emits: [
@@ -4158,8 +4681,8 @@ Use \`workflows action=checkpoint\` after each round to persist progress to the
       },
       {
         kind: "update",
-        collection: "bets",
-        description: "Bet status and no-go updates during finalize."
+        collection: "work-packages",
+        description: "Work package status and no-go updates during finalize."
       }
     ]
   },
@@ -5316,7 +5839,7 @@ var facilitateSchema = z12.object({
   operationId: z12.string().optional().describe("Optional idempotency key for commit-constellation retries.")
 });
 function buildStudioUrl(workspaceSlug, entryId) {
-  const appUrl = process.env.PRODUCTBRAIN_APP_URL ?? "https://productbrain.io";
+  const appUrl = process.env.PRODUCTBRAIN_APP_URL ?? "https://work.productbrain.io";
   return `${appUrl}/${workspaceSlug}/legacy/entries/${entryId}`;
 }
 async function loadBetEntry(entryId) {
@@ -5524,7 +6047,7 @@ async function handleCommitConstellation(args) {
   }
   let contradictionWarnings = [];
   try {
-    const { runContradictionCheck } = await import("./smart-capture-ATJ5F7R2.js");
+    const { runContradictionCheck } = await import("./smart-capture-CVZ5PLUZ.js");
     const links = betData["links"];
     const descField = betData.problem ?? links?.problem ?? betData.description ?? "";
     contradictionWarnings = await runContradictionCheck(
@@ -5884,6 +6407,7 @@ function registerVerifyTools(server) {
         logger: "product-brain"
       });
       const fixes = [];
+      const fixUpdateWarnings = [];
       if (mode === "fix") {
         const driftedByEntry = /* @__PURE__ */ new Map();
         for (const mc of mappingChecks) {
@@ -5898,10 +6422,17 @@ function registerVerifyTools(server) {
           const updated = (entry.data?.codeMapping ?? []).map(
             (cm) => cm.status === "aligned" && driftedFields.has(cm.field) ? { ...cm, status: "drifted" } : cm
           );
-          await mcpMutation("chain.updateEntry", {
+          const updateResult = await mcpMutation("chain.updateEntry", {
             entryId: entry.entryId,
             data: { codeMapping: updated }
           });
+          if (updateResult.normalizationWarnings.length > 0 || updateResult.validationWarnings.length > 0) {
+            fixUpdateWarnings.push({
+              entryId: entry.entryId,
+              normalizationWarnings: updateResult.normalizationWarnings,
+              validationWarnings: updateResult.validationWarnings
+            });
+          }
           fixes.push(entry.entryId);
         }
       }
@@ -5923,8 +6454,22 @@ function registerVerifyTools(server) {
         schema.size,
         projectRoot
       );
+      let reportText = report;
+      if (fixUpdateWarnings.length > 0) {
+        reportText += "\n\n---\n\n\u26A0\uFE0F **Fix update warnings:**";
+        for (const w of fixUpdateWarnings) {
+          for (const nw of w.normalizationWarnings) {
+            reportText += `
+  - **${w.entryId}** (normalization): ${nw}`;
+          }
+          for (const vw of w.validationWarnings) {
+            reportText += `
+  - **${w.entryId}** (validation): ${vw}`;
+          }
+        }
+      }
       return {
-        content: [{ type: "text", text: report }],
+        content: [{ type: "text", text: reportText }],
         structuredContent: success(
           `Trust report for ${collection}: ${totalPassed}/${totalChecks} checks passed (${trustScore}%).`,
           {
@@ -6294,7 +6839,7 @@ function runAlignmentCheck(task, activeBets, taskContextHits) {
     return { aligned: true, matchedBet: matchingBet.name, matchSource: "active_bet", betNames };
   }
   const betHits = (taskContextHits ?? []).filter(
-    (e) => e.collectionSlug === "chains" || e.collectionSlug === "bets"
+    (e) => e.collectionSlug === "chains" || e.collectionSlug === "work-packages"
   );
   if (betHits.length > 0) {
     return { aligned: true, matchedBet: betHits[0]?.name ?? null, matchSource: "task_context", betNames };
@@ -7046,7 +7591,7 @@ async function buildOrientResponse(wsCtx, agentSessionId, errors, task) {
   } else if (isHighReadiness) {
     let activeBets = [];
     try {
-      const betsEntries = await mcpQuery("chain.listEntries", { collectionSlug: "bets" });
+      const betsEntries = await mcpQuery("chain.listEntries", { collectionSlug: "work-packages" });
       activeBets = (betsEntries ?? []).filter((e) => isActiveNowBet(e)).map((e) => ({ name: e.name, entryId: e.entryId ?? null })).slice(0, 8);
     } catch {
     }
@@ -8380,7 +8925,7 @@ var SEED_NODES = [
   { entryId: "ARCH-node-glossary", name: "Glossary", order: 2, data: { archType: "node", layerRef: "ARCH-layer-features", color: "#6366f1", icon: "Aa", description: "Canonical vocabulary management \u2014 term detail, code drift detection, inline term linking", filePaths: "src/routes/glossary/, src/lib/components/glossary/", owner: "Knowledge", rationale: "Features layer \u2014 NOT Core or Infrastructure \u2014 because this is the Glossary PAGE: the SvelteKit route for browsing, editing, and viewing terms. Why not Core? Because Core owns the glossary DATA (Knowledge Graph) and term-linking logic. The MCP server also accesses glossary terms without any page. Why not Infrastructure? Because glossary is domain-specific vocabulary, not generic plumbing. The page is one consumer of the data \u2014 Core owns the dictionary, Features owns the dictionary app." } },
   { entryId: "ARCH-node-tensions", name: "Tensions", order: 3, data: { archType: "node", layerRef: "ARCH-layer-features", color: "#6366f1", icon: "\u26A1", description: "Tension capture and processing \u2014 raise, triage, resolve through governance workflow", filePaths: "src/routes/tensions/, src/lib/components/tensions/", owner: "Governance", rationale: "Features layer because this is the Tensions PAGE \u2014 the UI for raising, listing, and viewing tensions. Why not Core? Because tension data, status rules (SOS-020), and processing logic already live in Core (Governance Engine). This page is a form + list view that reads from and writes to Core. Delete it and the governance engine still processes tensions via MCP." } },
   { entryId: "ARCH-node-strategy", name: "Strategy", order: 4, data: { archType: "node", layerRef: "ARCH-layer-features", color: "#6366f1", icon: "\u25A3", description: "Product strategy pages \u2014 vision, ecosystem, product areas, decision frameworks, sequencing", filePaths: "src/routes/strategy/, src/routes/bridge/, src/routes/topology/", owner: "Strategy", rationale: "Features layer because Strategy is a set of SvelteKit pages (strategy, bridge, topology) that visualize strategy entries. Why not Core? Because the strategy data (vision, principles, ecosystem layers) lives in the Knowledge Graph (Core). These pages render and allow inline editing \u2014 they consume Core downward." } },
-  { entryId: "ARCH-node-governance-ui", name: "Governance Pages", order: 5, data: { archType: "node", layerRef: "ARCH-layer-features", color: "#6366f1", icon: "\u25C8", description: "Roles, circles, principles, policies, decisions, proposals, business rules", filePaths: "src/routes/roles/, src/routes/circles/, src/routes/decisions/, src/routes/proposals/", owner: "Governance", rationale: "Features layer because these are governance PAGES \u2014 list views and detail views for roles, circles, decisions, proposals. Why not Core? Because the governance ENGINE (versioning, consent, IDM) IS in Core. These pages are the user-facing window into governance data. The logic doesn't live here, only the rendering." } },
+  { entryId: "ARCH-node-governance-ui", name: "Governance Pages", order: 5, data: { archType: "node", layerRef: "ARCH-layer-features", color: "#6366f1", icon: "\u25C8", description: "Roles, teams, principles, policies, decisions, proposals, business rules", filePaths: "src/routes/roles/, src/routes/teams/, src/routes/decisions/, src/routes/proposals/", owner: "Governance", rationale: "Features layer because these are governance PAGES \u2014 list views and detail views for roles, teams, decisions, proposals. Why not Core? Because the governance ENGINE (versioning, consent, IDM) IS in Core. These pages are the user-facing window into governance data. The logic doesn't live here, only the rendering." } },
   { entryId: "ARCH-node-artifacts", name: "Artifacts", order: 6, data: { archType: "node", layerRef: "ARCH-layer-features", color: "#6366f1", icon: "\u{1F4C4}", description: "Strategy artifacts from ChainWork \u2014 pitches, briefs, one-pagers linked to the knowledge graph", filePaths: "src/routes/artifacts/", owner: "ChainWork", rationale: "Features layer because the Artifacts page is a list/detail view for strategy artifacts produced by ChainWork. Why not Core? Because artifact data and scoring live in Core (ChainWork Engine). This page just renders the output and links back to the knowledge graph." } },
   // Integration layer
   { entryId: "ARCH-node-cursor", name: "Cursor IDE", order: 0, data: { archType: "node", layerRef: "ARCH-layer-integration", color: "#f59e0b", icon: "\u{1F5A5}\uFE0F", description: "AI-assisted development with MCP-powered knowledge context \u2014 smart capture, verification, context assembly in the editor", filePaths: ".cursor/mcp.json, .cursor/rules/", owner: "AI DX", rationale: "Integration layer because Cursor is an external tool that connects INTO our system via MCP. Why not Core or Features? Because Cursor itself is not our code \u2014 it's a consumer. The .cursor/ config files define how it talks to us, but Cursor lives outside our deployment boundary." } },
@@ -8571,6 +9116,7 @@ ${nodeDetail}${flowLines}`
         let created = 0;
         let updated = 0;
         let unchanged = 0;
+        const allWarnings = [];
         const allSeeds = [
           { ...SEED_TEMPLATE, order: 0, status: "active" },
           ...SEED_LAYERS.map((l) => ({ ...l, status: "active" })),
@@ -8587,14 +9133,21 @@ ${nodeDetail}${flowLines}`
             );
             if (hasChanges) {
               const mergedData = { ...existingData, ...seedData };
-              await mcpMutation("chain.updateEntry", { entryId: seed.entryId, data: mergedData });
+              const updateResult = await mcpMutation("chain.updateEntry", { entryId: seed.entryId, data: mergedData });
+              if (updateResult.normalizationWarnings.length > 0 || updateResult.validationWarnings.length > 0) {
+                allWarnings.push({
+                  entryId: seed.entryId,
+                  normalizationWarnings: updateResult.normalizationWarnings,
+                  validationWarnings: updateResult.validationWarnings
+                });
+              }
               updated++;
             } else {
               unchanged++;
             }
             continue;
           }
-          await mcpMutation("chain.createEntry", {
+          const createResult = await mcpMutation("chain.createEntry", {
             collectionSlug: COLLECTION_SLUG,
             entryId: seed.entryId,
             name: seed.name,
@@ -8602,18 +9155,39 @@ ${nodeDetail}${flowLines}`
             data: seed.data,
             order: seed.order ?? 0
           });
+          if (createResult.normalizationWarnings.length > 0 || createResult.validationWarnings.length > 0) {
+            allWarnings.push({
+              entryId: seed.entryId,
+              normalizationWarnings: createResult.normalizationWarnings,
+              validationWarnings: createResult.validationWarnings
+            });
+          }
           created++;
         }
-        return {
-          content: [{
-            type: "text",
-            text: `# Architecture Seeded
+        let responseText = `# Architecture Seeded
 
 **Created:** ${created} entries
 **Updated:** ${updated} (merged new fields)
 **Unchanged:** ${unchanged}
 
-Use \`architecture action=show\` to view the map.`
+Use \`architecture action=show\` to view the map.`;
+        if (allWarnings.length > 0) {
+          responseText += "\n\n---\n\n\u26A0\uFE0F **Seed warnings:**";
+          for (const w of allWarnings) {
+            for (const nw of w.normalizationWarnings) {
+              responseText += `
+  - **${w.entryId}** (normalization): ${nw}`;
+            }
+            for (const vw of w.validationWarnings) {
+              responseText += `
+  - **${w.entryId}** (validation): ${vw}`;
+            }
+          }
+        }
+        return {
+          content: [{
+            type: "text",
+            text: responseText
           }],
           structuredContent: success(
             `Architecture seeded: ${created} created, ${updated} updated, ${unchanged} unchanged.`,
@@ -9008,6 +9582,9 @@ function registerOrientTool(server) {
           if (sc.productAreaCount != null && sc.productAreaCount > 0) {
             lines.push(`Product areas (${sc.productAreaCount}): ${(sc.productAreas ?? []).join(", ")}`);
           }
+          if (sc.playingFieldCount != null && sc.playingFieldCount > 0) {
+            lines.push(`Playing field (${sc.playingFieldCount}): ${(sc.playingField ?? []).join(", ")}`);
+          }
           lines.push(`${sc.activeBetCount} active bet(s), ${sc.activeTensionCount} tension(s).`);
         }
         if (orientEntries?.taskContext && orientEntries.taskContext.context.length > 0) {
@@ -9017,7 +9594,15 @@ function registerOrientTool(server) {
           for (const e of orientEntries.activeBets) {
             const tensions = e.linkedTensions;
             const tensionPart = tensions?.length ? ` \u2014 ${tensions.map((t) => `${t.entryId ?? t.name} (${t.severity ?? "\u2014"})`).join(", ")}` : "";
-            lines.push(`- \`${e.entryId ?? e._id}\` ${e.name}${tensionPart}`);
+            const originPart = e.origin ? ` (origin: ${e.origin})` : "";
+            lines.push(`- \`${e.entryId ?? e._id}\` ${e.name}${originPart}${tensionPart}`);
+          }
+        }
+        if (orientEntries?.trustMetrics) {
+          const tm = orientEntries.trustMetrics;
+          if (tm.unverified > 0 || tm.verified > 0) {
+            const capNote = tm.scannedCap ? "+" : "";
+            lines.push(`Trust: ${tm.verified} verified, ${tm.unverified} unverified, ${tm.noStatus} no-status (${tm.total}${capNote} scanned).`);
           }
         }
         const briefWna = formatWhatNeedsAttentionBrief(orientEntries?.whatNeedsAttention);
@@ -9140,7 +9725,11 @@ function registerOrientTool(server) {
         const fmt = (e) => {
           const type = e.canonicalKey ?? "generic";
           const stratum = e.stratum ?? "?";
-          return `- \`${e.entryId ?? e._id}\` [${type} \xB7 ${stratum}] ${e.name}`;
+          const confidencePart = e.confidence ? ` [confidence: ${e.confidence}]` : "";
+          const reviewOverdue = e.reviewAt && new Date(e.reviewAt).getTime() < Date.now();
+          const overduePart = reviewOverdue ? " [review overdue]" : "";
+          const originPart = e.origin ? ` (origin: ${e.origin})` : "";
+          return `- \`${e.entryId ?? e._id}\` [${type} \xB7 ${stratum}] ${e.name}${originPart}${confidencePart}${overduePart}`;
         };
         const fullCoherence = buildCoherenceSection();
         if (fullCoherence) {
@@ -9157,6 +9746,9 @@ function registerOrientTool(server) {
             if (sc.productAreaCount != null && sc.productAreaCount > 0) {
               lines.push(`**Product areas (${sc.productAreaCount}):** ${(sc.productAreas ?? []).join(", ")}`);
             }
+            if (sc.playingFieldCount != null && sc.playingFieldCount > 0) {
+              lines.push(`**Playing field (${sc.playingFieldCount}):** ${(sc.playingField ?? []).join(", ")}`);
+            }
             const betLine = sc.currentBet ? `**Current bet:** ${sc.currentBet}. ${sc.activeBetCount} active bet(s).` : "No active bets.";
             lines.push(`${betLine} ${sc.activeTensionCount} open tension(s).`);
             lines.push("");
@@ -9214,7 +9806,8 @@ function registerOrientTool(server) {
             for (const e of tc.context) {
               const id = e.entryId ?? e.name;
               const coll = e.collectionSlug ? ` [${e.collectionSlug}]` : "";
-              lines.push(`- \`${id}\` (score ${e.score})${coll}${e.name !== id ? ` \u2014 ${e.name}` : ""}`);
+              const originTag = e.origin ? ` (origin: ${e.origin})` : "";
+              lines.push(`- \`${id}\` (score ${e.score})${coll}${originTag}${e.name !== id ? ` \u2014 ${e.name}` : ""}`);
               if (e.preview) lines.push(`  _${e.preview}_`);
             }
             lines.push("");
@@ -9235,6 +9828,20 @@ function registerOrientTool(server) {
             lines.push(...formatInitiativeStatusLines(orientEntries.initiativeStatus));
             lines.push(...formatWorkstreamHealthLines(orientEntries.workstreamHealth));
             lines.push(...formatWhatNeedsAttentionLines(orientEntries.whatNeedsAttention));
+            if (orientEntries.trustMetrics) {
+              const tm = orientEntries.trustMetrics;
+              if (tm.verified > 0 || tm.unverified > 0) {
+                const capNote = tm.scannedCap ? " (capped at 500)" : "";
+                lines.push("## Trust metrics");
+                lines.push(`_Entry verification status across workspace${capNote}._`);
+                lines.push("");
+                lines.push(`- **Verified:** ${tm.verified}`);
+                lines.push(`- **Unverified:** ${tm.unverified}`);
+                lines.push(`- **No status (pre-BET-240):** ${tm.noStatus}`);
+                lines.push(`- **Total scanned:** ${tm.total}`);
+                lines.push("");
+              }
+            }
           }
           if (fullCoherence) {
             lines.push(...fullCoherence.lines);
@@ -9275,6 +9882,13 @@ function registerOrientTool(server) {
               orientEntries.strategyHighlights.forEach((e) => lines.push(fmt(e)));
               lines.push("");
             }
+            if (orientEntries.playingField?.length > 0) {
+              lines.push("## Playing field");
+              lines.push("_Products and opportunities in the strategic landscape._");
+              lines.push("");
+              orientEntries.playingField.forEach((e) => lines.push(fmt(e)));
+              lines.push("");
+            }
             if (orientEntries.recentDecisions?.length > 0) {
               lines.push("## Recent decisions");
               orientEntries.recentDecisions.forEach((e) => lines.push(fmt(e)));
@@ -9333,6 +9947,20 @@ function registerOrientTool(server) {
           lines.push(...formatInitiativeStatusLines(orientEntries?.initiativeStatus));
           lines.push(...formatWorkstreamHealthLines(orientEntries?.workstreamHealth));
           lines.push(...formatWhatNeedsAttentionLines(orientEntries?.whatNeedsAttention));
+          if (orientEntries?.trustMetrics) {
+            const tm = orientEntries.trustMetrics;
+            if (tm.verified > 0 || tm.unverified > 0) {
+              const capNote = tm.scannedCap ? " (capped at 500)" : "";
+              lines.push("## Trust metrics");
+              lines.push(`_Entry verification status across workspace${capNote}._`);
+              lines.push("");
+              lines.push(`- **Verified:** ${tm.verified}`);
+              lines.push(`- **Unverified:** ${tm.unverified}`);
+              lines.push(`- **No status (pre-BET-240):** ${tm.noStatus}`);
+              lines.push(`- **Total scanned:** ${tm.total}`);
+              lines.push("");
+            }
+          }
           lines.push(...buildOperatingProtocol());
           if (fullCoherence) {
             lines.push(...fullCoherence.lines);
@@ -9906,6 +10534,270 @@ function registerHealthTools(server) {
   );
 }
 
+// src/tools/audit.ts
+import { z as z22 } from "zod";
+var AUDIT_ACTIONS = ["run"];
+var auditSchema = z22.object({
+  action: z22.enum(AUDIT_ACTIONS).describe(
+    "'run': run the STD-113 hygiene audit for a bet entry."
+  ),
+  entryId: z22.string().describe("Bet entry ID to audit, e.g. 'BET-182'"),
+  phase: z22.enum(["shaping", "handoff"]).default("shaping").optional().describe(
+    "'shaping': check shaping-phase fields only. 'handoff': check all required fields including buildContract/buildSequence/exclusions/risks. Default: shaping."
+  )
+});
+function registerAuditTools(server) {
+  server.registerTool(
+    "audit",
+    {
+      title: "Audit",
+      description: "Run STD-113 hygiene audit on a bet entry. Checks 13 gates covering:\n\n- **Relations**: intentional links, no auto-link noise, strategic anchoring\n- **Risk/Tension**: risks in correct collection, tensions linked\n- **Field completeness**: mandatory fields populated for current phase\n- **Elements**: correct collection, committed status\n- **Acceptance criteria**: doneWhen populated and verifiable\n- **Structural**: no circular relations, appetite consistency\n\nUse `phase=shaping` (default) before starting implementation. Use `phase=handoff` before handing off to AI Engineer.",
+      inputSchema: auditSchema,
+      annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
+    },
+    withEnvelope(async (args) => {
+      const parsed = parseOrFail(auditSchema, args);
+      if (!parsed.ok) return parsed.result;
+      const { entryId, phase = "shaping" } = parsed.data;
+      return runWithToolContext({ tool: "audit", action: "run" }, async () => {
+        return handleAuditRun(entryId, phase ?? "shaping");
+      });
+    })
+  );
+}
+async function handleAuditRun(entryId, phase) {
+  let result;
+  try {
+    result = await mcpQuery("chain.auditBet", { entryId, phase });
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    if (msg.includes("not found") || msg.includes("NOT_FOUND")) {
+      return failureResult(
+        `Entry '${entryId}' not found.`,
+        "NOT_FOUND",
+        `Entry '${entryId}' not found.`,
+        "Use entries action=search to find the correct BET-ID.",
+        [{ tool: "entries", description: "Search entries", parameters: { action: "search", query: entryId } }]
+      );
+    }
+    throw err;
+  }
+  const { verdict, gates, summary, entryName, elapsed_ms } = result;
+  const verdictIcon = verdict === "pass" ? "\u2713" : verdict === "fail" ? "\u2717" : "\u26A0";
+  const verdictLabel = verdict.toUpperCase();
+  const lines = [
+    `## Audit: ${entryId} \u2014 ${entryName}`,
+    `Phase: ${phase} | Verdict: ${verdictIcon} ${verdictLabel} | ${elapsed_ms}ms`,
+    `Gates: ${summary.passed}/${summary.total} passed \xB7 ${summary.failed} failed \xB7 ${summary.warned} warned`,
+    ""
+  ];
+  const failed = gates.filter((g) => g.status === "fail");
+  const warned = gates.filter((g) => g.status === "warn");
+  const passed = gates.filter((g) => g.status === "pass");
+  if (failed.length > 0) {
+    lines.push("### \u2717 Failed Gates (blocking)");
+    for (const gate of failed) {
+      lines.push(`**${gate.gate}**: ${gate.detail}`);
+      if (gate.fix) lines.push(`  \u2192 Fix: ${gate.fix}`);
+      if (gate.hint) lines.push(`  \u2192 Note: ${gate.hint}`);
+    }
+    lines.push("");
+  }
+  if (warned.length > 0) {
+    lines.push("### \u26A0 Warnings (non-blocking)");
+    for (const gate of warned) {
+      lines.push(`**${gate.gate}**: ${gate.detail}`);
+      if (gate.fix) lines.push(`  \u2192 Fix: ${gate.fix}`);
+      if (gate.hint) lines.push(`  \u2192 Note: ${gate.hint}`);
+    }
+    lines.push("");
+  }
+  if (passed.length > 0 && verdict === "pass") {
+    lines.push("### \u2713 All Gates Passed");
+    for (const gate of passed) {
+      lines.push(`  ${gate.gate}: ${gate.detail}`);
+    }
+  } else if (passed.length > 0) {
+    lines.push(`### \u2713 Passed (${passed.length}): ${passed.map((g) => g.gate).join(", ")}`);
+  }
+  const nextActions = [];
+  if (verdict !== "pass") {
+    nextActions.push({
+      tool: "entries",
+      description: "View full entry details",
+      parameters: { action: "get", entryId }
+    });
+    nextActions.push({
+      tool: "relations",
+      description: "Manage entry relations",
+      parameters: { action: "list", entryId }
+    });
+  }
+  return {
+    content: [{ type: "text", text: lines.join("\n") }],
+    structuredContent: success(
+      `Audit ${entryId} (${phase}): ${verdictLabel} \u2014 ${summary.passed}/${summary.total} gates passed.`,
+      {
+        entryId: result.entryId,
+        entryName: result.entryName,
+        phase: result.phase,
+        clean: result.clean,
+        verdict: result.verdict,
+        gates: result.gates,
+        summary: result.summary,
+        elapsed_ms: result.elapsed_ms
+      },
+      nextActions.length > 0 ? nextActions : void 0
+    )
+  };
+}
+
+// src/tools/governance.ts
+import { z as z23 } from "zod";
+var governanceSchema = z23.object({
+  action: z23.enum(["list", "respond", "count"]).describe("Action: list open proposals, respond to a proposal, or count open proposals"),
+  proposalId: z23.string().optional().describe("Proposal ID (required for respond action)"),
+  verdict: z23.enum(["approve", "reject"]).optional().describe("Verdict for respond action: approve or reject"),
+  reason: z23.string().optional().describe("Reason for the verdict (required when rejecting)"),
+  status: z23.enum(["open", "approved", "objected", "expired"]).optional().describe("Filter proposals by status (default: open). Only used with list action.")
+});
+function registerGovernanceTools(server) {
+  const tool = server.registerTool(
+    "governance-proposals",
+    {
+      title: "Governance Proposals",
+      description: "Manage consent proposals \u2014 list open proposals awaiting review, respond with approve/reject, or count open proposals. Consent proposals are created when a governs relation is proposed and require explicit approval before the relation is created. Use list to see what needs attention, respond to act on proposals, and count for badge display.",
+      inputSchema: governanceSchema,
+      annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
+    },
+    withEnvelope(async ({ action, proposalId, verdict, reason, status }) => {
+      const wsCtx = await getWorkspaceContext();
+      const enabled = await isFeatureEnabled(
+        "bet-221-governance-at-scale",
+        wsCtx.workspaceId,
+        wsCtx.workspaceSlug
+      );
+      if (!enabled) {
+        return failureResult(
+          "Governance proposals are not yet enabled for this workspace.",
+          "FEATURE_DISABLED",
+          "The bet-221-governance-at-scale flag is OFF.",
+          "Ask your workspace admin to enable the governance-at-scale feature flag."
+        );
+      }
+      if (action === "list") {
+        const proposals = await mcpQuery("governance.listProposals", {
+          ...status ? { status } : {}
+        });
+        if (proposals.length === 0) {
+          const statusLabel = status ?? "open";
+          return successResult(
+            `No ${statusLabel} consent proposals in this workspace.`,
+            `No ${statusLabel} consent proposals found.`,
+            { proposals: [], count: 0 }
+          );
+        }
+        const lines = ["# Consent Proposals", ""];
+        for (const p of proposals) {
+          const urgency = p.isExpired ? "EXPIRED" : p.hoursRemaining < 1 ? `< 1h remaining` : `${p.hoursRemaining}h remaining`;
+          lines.push(`## ${p.targetEntryName} \u2192 ${p.toEntryName ?? "unknown"}`);
+          lines.push(`- **ID:** \`${p._id}\``);
+          lines.push(`- **Status:** ${p.status} (${urgency})`);
+          lines.push(`- **Operation:** ${p.proposedOperation}`);
+          lines.push(`- **Reasoning:** ${p.reasoning}`);
+          lines.push(`- **Proposed by:** ${p.proposedBy}`);
+          if (p.objectionReason) {
+            lines.push(`- **Objection:** ${p.objectionReason}`);
+          }
+          lines.push("");
+        }
+        return successResult(
+          lines.join("\n"),
+          `Found ${proposals.length} consent proposal(s).`,
+          { proposals, count: proposals.length },
+          [
+            {
+              tool: "governance-proposals",
+              description: "Respond to a proposal",
+              parameters: { action: "respond" }
+            }
+          ]
+        );
+      }
+      if (action === "count") {
+        const result = await mcpQuery("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).`,
+          result,
+          result.count > 0 ? [{
+            tool: "governance-proposals",
+            description: "List open proposals",
+            parameters: { action: "list" }
+          }] : void 0
+        );
+      }
+      if (action === "respond") {
+        requireWriteAccess();
+        if (!proposalId) {
+          return validationResult(
+            "A proposalId is required for the respond action. Use list action to find proposal IDs."
+          );
+        }
+        if (!verdict) {
+          return validationResult(
+            "A verdict (approve or reject) is required for the respond action."
+          );
+        }
+        if (verdict === "reject" && !reason) {
+          return validationResult(
+            "A reason is required when rejecting a proposal. Explain what harm this change would cause."
+          );
+        }
+        try {
+          const result = await mcpMutation(
+            "governance.respondToProposal",
+            {
+              proposalId,
+              verdict,
+              ...reason ? { reason } : {}
+            }
+          );
+          return successResult(
+            result.message,
+            result.message,
+            result,
+            [
+              {
+                tool: "governance-proposals",
+                description: "List remaining proposals",
+                parameters: { action: "list" }
+              }
+            ]
+          );
+        } catch (err) {
+          const msg = err?.message ?? String(err);
+          return failureResult(
+            msg,
+            "PROPOSAL_ERROR",
+            msg,
+            "Use governance-proposals action=list to check proposal status.",
+            [
+              {
+                tool: "governance-proposals",
+                description: "List proposals",
+                parameters: { action: "list" }
+              }
+            ]
+          );
+        }
+      }
+      return validationResult("Unknown action. Valid actions: list, respond, count.");
+    })
+  );
+  trackWriteTool(tool);
+}
+
 // src/resources/index.ts
 import { existsSync as existsSync4 } from "fs";
 import { dirname as dirname2, join, resolve as resolve5 } from "path";
@@ -10036,7 +10928,7 @@ var AGENT_CHEATSHEET = `# Product Brain \u2014 Agent Cheatsheet
 ## Collection Prefixes
 GLO (glossary), BR (business-rules), PRI (principles), STD (standards),
 DEC (decisions), STR (strategy), TEN (tensions), FEAT (features),
-BET (bets), INS (insights), ARCH (architecture), CIR (circles),
+BET (bets), INS (insights), ARCH (architecture), TEAM (teams),
 ROL (roles), MAP (maps), MTRC (tracking-events), ST (semantic-types)
 
 ## Valid Relation Types (21)
@@ -10350,12 +11242,12 @@ ${entry.labels.map((l) => `- ${l.name ?? l.slug}`).join("\n")}`);
 }
 
 // src/prompts/index.ts
-import { z as z22 } from "zod";
+import { z as z24 } from "zod";
 function registerPrompts(server) {
   server.prompt(
     "review-against-rules",
     "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: z22.string().describe("Business rule domain (e.g. 'Identity & Access', 'Governance & Decision-Making')") },
+    { domain: z24.string().describe("Business rule domain (e.g. 'Identity & Access', 'Governance & Decision-Making')") },
     async ({ domain }) => {
       const entries = await mcpQuery("chain.listEntries", { collectionSlug: "business-rules" });
       const rules = entries.filter((e) => e.data?.domain === domain);
@@ -10408,7 +11300,7 @@ Provide a structured review with a compliance status for each rule (COMPLIANT /
   server.prompt(
     "name-check",
     "Check variable names, field names, or API names against the glossary for terminology alignment. Flags drift from canonical terms.",
-    { names: z22.string().describe("Comma-separated list of names to check (e.g. 'vendor_id, compliance_level, formulator_type')") },
+    { names: z24.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 glossaryContext = terms.map(
@@ -10444,7 +11336,7 @@ Format as a table: Name | Status | Canonical Form | Action Needed`
   server.prompt(
     "draft-decision-record",
     "Draft a structured decision record from a description of what was decided. Includes context from recent decisions and relevant rules.",
-    { context: z22.string().describe("Description of the decision (e.g. 'We decided to use MRSL v3.1 as the conformance baseline because...')") },
+    { context: z24.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 sorted = [...recentDecisions].sort((a, b) => (b.data?.date ?? "") > (a.data?.date ?? "") ? 1 : -1).slice(0, 5);
@@ -10482,8 +11374,8 @@ After drafting, I can log it using the capture tool with collection "decisions".
     "draft-rule-from-context",
     "Draft a new business rule from an observation or discovery made while coding. Fetches existing rules for the domain to ensure consistency.",
     {
-      observation: z22.string().describe("What you observed or discovered (e.g. 'Suppliers can have multiple org types in Gateway')"),
-      domain: z22.string().describe("Which domain this rule belongs to (e.g. 'Governance & Decision-Making')")
+      observation: z24.string().describe("What you observed or discovered (e.g. 'Suppliers can have multiple org types in Gateway')"),
+      domain: z24.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" });
@@ -10625,6 +11517,8 @@ function createProductBrainServer() {
   registerStartTools(server);
   registerUsageTools(server);
   registerFacilitateTools(server);
+  registerAuditTools(server);
+  registerGovernanceTools(server);
   registerResources(server);
   registerPrompts(server);
   return server;
@@ -10634,4 +11528,4 @@ export {
   SERVER_VERSION,
   createProductBrainServer
 };
-//# sourceMappingURL=chunk-O337N4MC.js.map
+//# sourceMappingURL=chunk-ZFODPVNH.js.map