@productbrain/mcp 0.0.1-beta.62 → 0.0.1-beta.63

package/dist/{chunk-MH5MYP76.js → chunk-GKMXGRJW.js}

@@ -38,11 +38,12 @@ import {
   unknownAction,
   validationResult,
   withEnvelope
-} from "./chunk-4M3SUZHX.js";
+} from "./chunk-DM5DZC7B.js";
 import {
+  trackKnowledgeGap,
   trackQualityCheck,
   trackQualityVerdict
-} from "./chunk-MRIO53BY.js";
+} from "./chunk-RQXM3TCI.js";
 
 // src/server.ts
 import { McpServer as McpServer2 } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -232,7 +233,7 @@ ${formatted}` }],
     },
     withEnvelope(async ({ entryId }) => {
       requireWriteAccess();
-      const { runContradictionCheck } = await import("./smart-capture-NXLUISUD.js");
+      const { runContradictionCheck } = await import("./smart-capture-NYOKGAFS.js");
       const entry = await mcpQuery("chain.getEntry", { entryId });
       if (!entry) {
         return notFoundResult(entryId, `Entry '${entryId}' not found. Try search to find the right ID.`);
@@ -352,6 +353,43 @@ ${formatted}` }],
 
 // src/tools/entries.ts
 import { z as z2 } from "zod";
+
+// src/gap-store.ts
+var SESSION_GAPS = [];
+var DEDUP_WINDOW_MS = 6e4;
+function isDuplicate(gap) {
+  const cutoff = gap.timestamp - DEDUP_WINDOW_MS;
+  return SESSION_GAPS.some(
+    (existing) => existing.query === gap.query && existing.tool === gap.tool && existing.action === gap.action && existing.timestamp >= cutoff
+  );
+}
+function recordGap(gap) {
+  const timestamped = { ...gap, timestamp: Date.now() };
+  if (isDuplicate(timestamped)) return false;
+  SESSION_GAPS.push(timestamped);
+  return true;
+}
+function getSessionGaps() {
+  return SESSION_GAPS;
+}
+function getTopGaps(limit = 5) {
+  const counts = /* @__PURE__ */ new Map();
+  for (const gap of SESSION_GAPS) {
+    const key = gap.query.toLowerCase().trim();
+    const existing = counts.get(key);
+    if (existing) {
+      existing.count++;
+    } else {
+      counts.set(key, { count: 1, gapType: gap.gapType });
+    }
+  }
+  return [...counts.entries()].map(([query, { count, gapType }]) => ({ query, count, gapType })).sort((a, b) => b.count - a.count).slice(0, limit);
+}
+function clearSessionGaps() {
+  SESSION_GAPS.length = 0;
+}
+
+// src/tools/entries.ts
 function sanitizeEntryData(data) {
   if (!data || typeof data !== "object") return void 0;
   const filtered = Object.fromEntries(
@@ -664,15 +702,23 @@ async function handleSearch(server, query, collection, status) {
     mcpQuery("chain.listCollections")
   ]);
   if (results.length === 0) {
+    const recorded = recordGap({ query, tool: "entries", action: "search", gapType: "search_zero", collectionScope: collection });
+    if (recorded) {
+      getWorkspaceId().then((wsId) => trackKnowledgeGap(wsId, { query, tool: "entries", action: "search", gap_type: "search_zero", collection_scope: collection })).catch(() => {
+      });
+    }
     return {
       content: [{
         type: "text",
-        text: `No results for "${query}"${scope}. Try a broader search or use \`collections action=list\` to see available data.`
+        text: `"${query}" is not yet on the Chain${scope}. Try a broader search or use \`collections action=list\` to browse available knowledge.`
       }],
       structuredContent: success(
-        `No results for '${query}'${scope}.`,
+        `'${query}' is not yet on the Chain${scope}.`,
         { entries: [], total: 0, query },
-        [{ tool: "collections", description: "List collections", parameters: { action: "list" } }]
+        [
+          { tool: "entries", description: "Try a broader search", parameters: { action: "search", query: query.split(" ")[0] } },
+          { tool: "collections", description: "Browse available collections", parameters: { action: "list" } }
+        ]
       )
     };
   }
@@ -1253,6 +1299,11 @@ async function handleGather(server, entryId, task, mode, maxHops, maxResults) {
       return notFoundResult(entryId, `Entry '${entryId}' not found. Try search to find the right ID.`);
     }
     if (result2.context.length === 0) {
+      const recorded = recordGap({ query: result2.root.entryId, tool: "context", action: "gather", gapType: "context_graph_empty" });
+      if (recorded) {
+        getWorkspaceId().then((wsId) => trackKnowledgeGap(wsId, { query: result2.root.entryId, tool: "context", action: "gather", gap_type: "context_graph_empty" })).catch(() => {
+        });
+      }
       return {
         content: [{
           type: "text",
@@ -1330,6 +1381,12 @@ Use \`graph action=suggest\` to discover potential connections.`
       maxResults
     });
     if (!result2 || result2.totalFound === 0) {
+      const taskQuery = task.slice(0, 200);
+      const recorded = recordGap({ query: taskQuery, tool: "context", action: "gather", gapType: "context_task_empty" });
+      if (recorded) {
+        getWorkspaceId().then((wsId) => trackKnowledgeGap(wsId, { query: taskQuery, tool: "context", action: "gather", gap_type: "context_task_empty" })).catch(() => {
+        });
+      }
       return {
         content: [{
           type: "text",
@@ -1337,15 +1394,15 @@ Use \`graph action=suggest\` to discover potential connections.`
 
 **Confidence:** None
 
-No context found for this task. The chain may not cover this area yet.
+The Chain doesn't cover this area yet. If you discover relevant knowledge during this task, use \`capture\` with a name and description to add it.
 
-_Consider capturing domain knowledge discovered during this task via \`capture\`._`
+_This helps future sessions start with better context._`
         }],
         structuredContent: failure(
           "NOT_FOUND",
-          "No context found for this task.",
-          "The chain may not cover this area. Capture domain knowledge via capture.",
-          [{ tool: "capture", description: "Capture knowledge", parameters: {} }]
+          "The Chain doesn't cover this area yet.",
+          "If you discover relevant knowledge during this task, capture it with a name and description.",
+          [{ tool: "entries", description: "Search for related terms", parameters: { action: "search", query: task.split(" ").slice(0, 3).join(" ") } }]
         )
       };
     }
@@ -1398,6 +1455,11 @@ _Consider capturing domain knowledge discovered during this task via \`capture\`
     return notFoundResult(entryId, `Entry '${entryId}' not found. Try search to find the right ID.`);
   }
   if (result.related.length === 0) {
+    const recorded = recordGap({ query: result.root.entryId, tool: "context", action: "gather", gapType: "context_entry_isolated" });
+    if (recorded) {
+      getWorkspaceId().then((wsId) => trackKnowledgeGap(wsId, { query: result.root.entryId, tool: "context", action: "gather", gap_type: "context_entry_isolated" })).catch(() => {
+      });
+    }
     return {
       content: [{
         type: "text",
@@ -2031,6 +2093,18 @@ async function runWrapupReview() {
     }
     lines.push("");
   }
+  const topGaps = getTopGaps(5);
+  if (topGaps.length > 0) {
+    lines.push("### Learning Opportunities", "");
+    lines.push(`This session, agents looked for ${topGaps.length} topic${topGaps.length === 1 ? "" : "s"} not yet on the Chain:`, "");
+    for (const gap of topGaps) {
+      const freq = gap.count > 1 ? ` _(${gap.count}x)_` : "";
+      lines.push(`- **${gap.query}** \u2014 not yet captured${freq}`);
+    }
+    lines.push("");
+    lines.push("_Capturing these will make future sessions more effective._");
+    lines.push("");
+  }
   if (data.drafts.length > 0) {
     const draftIds = data.drafts.map((d) => `\`${d.entryId}\``).join(", ");
     lines.push("### Actions", "");
@@ -2038,7 +2112,8 @@ async function runWrapupReview() {
     lines.push("- **Commit all:** call `session-wrapup` with action `commit-all`");
     lines.push("- **Skip:** call `session action=close` \u2014 drafts remain for next session's orient recovery.");
   }
-  return { text: lines.join("\n"), data, suggestions };
+  const gapCount = getSessionGaps().length;
+  return { text: lines.join("\n"), data, suggestions, gapCount };
 }
 async function runWrapupCommitAll(data, cachedSuggestions) {
   requireWriteAccess();
@@ -2163,7 +2238,7 @@ function registerWrapupTools(server) {
         }
       );
     }
-    const { text, data, suggestions, failureCode } = await runWrapupReview();
+    const { text, data, suggestions, failureCode, gapCount } = await runWrapupReview();
     lastReviewData = data;
     lastReviewSuggestions = suggestions;
     lastReviewSessionId = getAgentSessionId();
@@ -2174,14 +2249,16 @@ ${text}` : text;
       return failureResult(fullText, failureCode, text);
     }
     const next = data.drafts.length > 0 ? [{ tool: "session-wrapup", description: "Commit all drafts", parameters: { action: "commit-all" } }] : void 0;
+    const gapsSummary = gapCount ? `, ${gapCount} knowledge gaps detected` : "";
     return successResult(
       fullText,
-      `Session review: ${data.drafts.length} uncommitted, ${data.committed.length} committed, ${suggestions.length} link suggestions.`,
+      `Session review: ${data.drafts.length} uncommitted, ${data.committed.length} committed, ${suggestions.length} link suggestions${gapsSummary}.`,
       {
         drafts: data.drafts.length,
         committed: data.committed.length,
         uncommitted: data.summary.uncommitted,
-        suggestedLinks: suggestions.length
+        suggestedLinks: suggestions.length,
+        knowledgeGaps: gapCount ?? 0
       },
       next
     );
@@ -2296,6 +2373,7 @@ async function handleClose() {
     }
   }
   await closeAgentSession();
+  clearSessionGaps();
   const lines = [
     `Session ${sessionId} closed.`,
     ""
@@ -3469,7 +3547,7 @@ var workflowsSchema = z11.object({
     "'list': browse available workflows. 'checkpoint': record round output or final summary. 'get-run': inspect a persisted workflow run."
   ),
   workflowId: z11.string().optional().describe("Workflow ID for checkpoint, e.g. 'retro'"),
-  runId: z11.string().optional().describe("Workflow run ID to inspect. Optional for action='get-run' when workflowId is provided."),
+  runId: z11.string().optional().describe("Workflow run ID: for get-run, which run to load; for checkpoint, target this run (avoids session drift \u2014 pass runId from get-run)."),
   roundId: z11.string().optional().describe("Round ID for checkpoint, e.g. 'what-went-well'"),
   output: z11.union([z11.string(), workflowRunOutputInputSchema]).optional().describe(
     "The round's output \u2014 either legacy synthesized text or a typed workflow run payload."
@@ -3504,6 +3582,38 @@ function validateFinalWorkflowCheckpoint(workflow, roundId) {
   }
   return null;
 }
+function levenshtein(a, b) {
+  const m = a.length;
+  const n = b.length;
+  const dp = Array.from(
+    { length: m + 1 },
+    (_, i) => Array.from({ length: n + 1 }, (_2, j) => i === 0 ? j : j === 0 ? i : 0)
+  );
+  for (let i = 1; i <= m; i++) {
+    for (let j = 1; j <= n; j++) {
+      dp[i][j] = a[i - 1] === b[j - 1] ? dp[i - 1][j - 1] : 1 + Math.min(dp[i - 1][j], dp[i][j - 1], dp[i - 1][j - 1]);
+    }
+  }
+  return dp[m][n];
+}
+function findClosestRound(input, rounds) {
+  if (rounds.length === 0) return null;
+  const substringMatch = rounds.find(
+    (r) => r.id.includes(input) || input.includes(r.id)
+  );
+  if (substringMatch) return substringMatch;
+  let best = rounds[0];
+  let bestDist = levenshtein(input, best.id);
+  for (const r of rounds.slice(1)) {
+    const dist = levenshtein(input, r.id);
+    if (dist < bestDist) {
+      bestDist = dist;
+      best = r;
+    }
+  }
+  const threshold = Math.ceil(Math.max(input.length, best.id.length) / 2);
+  return bestDist <= threshold ? best : null;
+}
 function registerWorkflowTools(server) {
   const workflowsTool = server.registerTool(
     "workflows",
@@ -3554,7 +3664,8 @@ function registerWorkflowTools(server) {
             restart,
             summaryName,
             summaryDescription,
-            summaryEntryId
+            summaryEntryId,
+            runId
           );
         }
         return unknownAction(action, WORKFLOWS_ACTIONS);
@@ -3662,7 +3773,7 @@ async function handleGetRun(runId, workflowId) {
     )
   };
 }
-async function handleCheckpoint(workflowId, roundId, output, isFinal, restart, summaryName, summaryDescription, summaryEntryId) {
+async function handleCheckpoint(workflowId, roundId, output, isFinal, restart, summaryName, summaryDescription, summaryEntryId, runId) {
   const wf = getWorkflow(workflowId);
   if (!wf) {
     return {
@@ -3683,18 +3794,33 @@ This checkpoint was NOT saved. Continue the conversation \u2014 the facilitator
   const round = wf.rounds.find((r) => r.id === roundId);
   if (!round) {
     const availableRounds = wf.rounds.map((r) => r.id).join(", ");
+    const closest = findClosestRound(roundId, wf.rounds);
+    const correctionActions = closest ? [
+      {
+        tool: "workflows",
+        description: `Retry with corrected round ID '${closest.id}'`,
+        parameters: { action: "checkpoint", workflowId, roundId: closest.id }
+      }
+    ] : [
+      {
+        tool: "workflows",
+        description: "List workflows to inspect round IDs",
+        parameters: { action: "list" }
+      }
+    ];
+    const suggestionHint = closest ? ` Did you mean '${closest.id}'?` : "";
     return {
       content: [{
         type: "text",
-        text: `Round "${roundId}" not found in workflow "${workflowId}". Available rounds: ${availableRounds}.
+        text: `Round "${roundId}" not found in workflow "${workflowId}".${suggestionHint} Available rounds: ${availableRounds}.
 
 This checkpoint was NOT saved. The conversation context is preserved \u2014 continue facilitating.`
       }],
       structuredContent: failure(
         "NOT_FOUND",
         `Round '${roundId}' not found in workflow '${workflowId}'.`,
-        `Available rounds: ${availableRounds}`,
-        [{ tool: "workflows", description: "List workflows", parameters: { action: "list" } }]
+        closest ? `Did you mean '${closest.id}'? Available rounds: ${availableRounds}` : `Available rounds: ${availableRounds}`,
+        correctionActions
       )
     };
   }
@@ -3755,7 +3881,8 @@ This checkpoint was NOT saved. The conversation context is preserved \u2014 cont
         normalizedOutput,
         agentSessionId,
         summaryEntryId,
-        lines
+        lines,
+        runId
       );
     }
     const existingRun = await mcpQuery(
@@ -3888,6 +4015,7 @@ This checkpoint was NOT saved. The conversation context is preserved \u2014 cont
           recordedAt: (/* @__PURE__ */ new Date()).toISOString()
         },
         restart,
+        ...runId ? { runId } : {},
         ...summaryEntryId ? { summaryEntryId } : {}
       });
       lines.push(
@@ -3952,7 +4080,7 @@ This checkpoint was NOT saved. The conversation context is preserved \u2014 cont
     }
   }
 }
-async function handleFacilitatedFinalization(wf, descriptor, roundId, normalizedOutput, agentSessionId, summaryEntryId, lines) {
+async function handleFacilitatedFinalization(wf, descriptor, roundId, normalizedOutput, agentSessionId, summaryEntryId, lines, runId) {
   const template = descriptor ? getWorkflowTemplateMetadata(descriptor) : { slug: wf.id, name: wf.name };
   try {
     const checkpointResult = await mcpMutation("chainwork.recordWorkflowCheckpoint", {
@@ -3974,7 +4102,8 @@ async function handleFacilitatedFinalization(wf, descriptor, roundId, normalized
         output: normalizedOutput,
         recordedAt: (/* @__PURE__ */ new Date()).toISOString()
       },
-      summaryEntryId
+      summaryEntryId,
+      ...runId ? { runId } : {}
     });
     const linked = checkpointResult.summary?.linked ?? false;
     lines.push(
@@ -6176,7 +6305,7 @@ async function handleCommitConstellation(args) {
   }
   let contradictionWarnings = [];
   try {
-    const { runContradictionCheck } = await import("./smart-capture-NXLUISUD.js");
+    const { runContradictionCheck } = await import("./smart-capture-NYOKGAFS.js");
     const descField = betData.problem ?? betData.description ?? "";
     contradictionWarnings = await runContradictionCheck(
       betEntry.name ?? betId,
@@ -7024,7 +7153,7 @@ function extractionToBatchEntries(extracted) {
 }
 function getInterviewInstructions(workspaceName) {
   return {
-    systemPrompt: `You are activating the **${workspaceName}** Product Brain. Ask 1\u20132 focused questions, then extract structured knowledge and feed it to batch-capture. Everything stays pending \u2014 the user confirms before anything is committed.`,
+    systemPrompt: `You are activating the **${workspaceName}** Product Brain. Ask 1\u20132 focused questions, then extract structured knowledge and feed it to batch-capture. In Open governance mode, entries are committed automatically. In consensus/role mode, they stay as drafts for review.`,
     question1: `**Q1 \u2014 What are you building and for whom?** Describe your product in 1\u20132 sentences and who it's for. (This becomes your Product Vision and primary Audience.)`,
     question2: `**Q2 (optional) \u2014 What's your tech stack or key domain terms?** Name a few core technologies or terms your team uses. (These become Architecture + Glossary entries.)`,
     extractionGuidance: `After the user answers, extract:
@@ -7042,9 +7171,25 @@ Map to batch-capture entries:
 - keyTerms \u2192 glossary (1 per term)
 - keyDecisions \u2192 decisions (1 per decision)
 - tensions \u2192 tensions (1 per tension)`,
-    captureInstructions: `Call batch-capture with the extracted entries. Keep descriptions concise (1\u20132 sentences each). Prefer 8 good entries over 15 mediocre ones \u2014 quality over volume. If batch-capture returns failedEntries, tell the user and retry those individually.`,
-    qualityNote: `After capturing, call graph action=suggest on 2\u20133 key entries to build the graph. Present the drafts grouped by collection. Ask: "Commit all, or review first?" Only call commit-entry when the user confirms.`,
-    scanOffer: `After the interview capture, offer the Project Scan: "I can also scan your project files (README.md, package.json, .cursorrules) to extract more knowledge automatically. Want me to? It takes about 2 minutes and stays as drafts."`
+    captureInstructions: `Call batch-capture with the extracted entries. Omit \`autoCommit\` to follow workspace governance automatically, or pass \`autoCommit: false\` if the user wants a review-first pass. Keep descriptions concise (1\u20132 sentences each). Prefer 8 good entries over 15 mediocre ones \u2014 quality over volume. If batch-capture returns failedEntries, tell the user and retry those individually.`,
+    qualityNote: (
+      // FEAT-149: Retrieval-First Proof Moment.
+      // After capture, demonstrate retrieval instead of offering commit ceremony.
+      // The aha moment is the AI using the user's knowledge, not the user entering it.
+      `After capturing, silently call graph action=suggest on the strategy or architecture entry to build connections.
+
+**Then demonstrate the proof moment \u2014 this is the most important step:**
+Based on what the user told you, invent a specific, plausible development task they might actually do next (e.g. "add user authentication" for a SaaS app, "build the recommendation engine" for a marketplace, "set up the API layer" for a developer tool). Call \`context action=gather task="<your invented task>"\` to load their captured knowledge.
+
+Present the results conversationally:
+"Here's what I already know about your product that I didn't know 5 minutes ago \u2014 if you asked me to **<task>**, I'd bring this context:"
+
+Then list the key entries that context returned: their product vision, audience, tech decisions, glossary terms. Keep it concrete \u2014 entry names and one-line summaries, not abstract descriptions.
+
+End with: "**Try it \u2014 ask me to help with something on your product.** I'll use everything I just learned."`
+    ),
+    scanOffer: `After the proof moment, offer the codebase scan as a way to deepen the knowledge:
+"Want me to learn even more? I can scan your project files (README, package.json, source structure) and pick up technical decisions, conventions, and architecture that I missed. Takes about 2 minutes."`
   };
 }
 function buildInterviewResponse(workspaceName) {
@@ -7054,15 +7199,11 @@ function buildInterviewResponse(workspaceName) {
     "",
     instructions.systemPrompt,
     "",
-    "I'll ask you 1\u20132 questions. Your answers become the first entries in your knowledge graph \u2014 all pending until you confirm.",
+    "I'll ask you 1\u20132 questions. Your answers become the foundation of your product knowledge.",
     "",
     `**${instructions.question1}**`,
     "",
-    "_Take your time \u2014 a sentence or two is enough. I'll extract the structure from your answer._",
-    "",
-    `> ${instructions.scanOffer}`,
-    "",
-    "_Everything stays pending until you confirm._"
+    "_Take your time \u2014 a sentence or two is enough. I'll extract the structure from your answer._"
   ].join("\n");
 }
 
@@ -7087,7 +7228,7 @@ function registerStartTools(server) {
     "start",
     {
       title: "Start Product Brain",
-      description: "The zero-friction entry point. Say 'start PB' to begin.\n\n- **Fresh workspace (blank)**: scans your codebase and seeds knowledge from what it finds.\n- **Early workspace (seeded)**: picks up where you left off with the top gaps to fill.\n- **Active workspace (grounded/connected)**: standup briefing with recent activity and open items.\n\nUse this as your first call. Replaces the need to call orient or health separately.",
+      description: "The zero-friction entry point. Say 'start PB' to begin.\n\n- **Fresh workspace (blank)**: asks what you're building, captures the essentials, and can scan your codebase if useful.\n- **Early workspace (seeded)**: picks up where you left off with the top gaps to fill.\n- **Active workspace (grounded/connected)**: standup briefing with recent activity and open items.\n\nUse this as your first call. Replaces the need to call orient or health separately.",
       inputSchema: startSchema,
       annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false }
     },
@@ -7192,14 +7333,15 @@ function buildBlankResponse(wsCtx, sessionCtx) {
     instructions.extractionGuidance,
     "",
     instructions.captureInstructions,
-    "Omit `autoCommit` \u2014 the capture tool auto-commits in Open mode and creates drafts in consensus/role mode.",
+    "Omit `autoCommit` \u2014 capture tools auto-commit in Open mode and create drafts in consensus/role mode.",
+    "",
+    instructions.qualityNote,
     "",
-    "**Then offer the codebase scan with context:**",
-    `"Now that I know what you're building, I can scan your project files and find technical decisions, features, and conventions that are relevant to **your** product. Want me to?"`,
+    instructions.scanOffer,
     "",
     "If they say yes, scan README.md, package.json/pyproject.toml/Cargo.toml, and top-level source dirs.",
     "Infer entries WITH the product context you now have. Present as a numbered list for confirmation.",
-    "Capture confirmed entries (auto-committed in Open mode).",
+    "Do not capture anything until the user confirms what to keep. Then capture only the confirmed entries and let normal workspace governance apply.",
     "",
     "## Path 2: Scan first",
     "",
@@ -7209,17 +7351,18 @@ function buildBlankResponse(wsCtx, sessionCtx) {
     "3. Top-level source directories and their purpose",
     "",
     "Infer 5\u20138 product knowledge entries (product name, tech decisions, features, conventions).",
-    "Present as a numbered list. Ask which to keep. Capture confirmed entries (auto-committed in Open mode).",
+    "Present as a numbered list. Ask which to keep. Only after confirmation, capture the confirmed entries and let normal workspace governance apply.",
     "",
     "**If the codebase is sparse** (no README, empty project): fall back to Path 1 (ask the user about their product).",
     "",
     "_Prefer 5 specific entries over 8 generic ones. Skip anything that would apply to any codebase._",
     "",
-    "## Path 3: Preset",
+    "**After scan capture, run the proof moment (same as Path 1):**",
+    instructions.qualityNote,
     "",
-    "If the user picks a preset, call `start` again with `preset: '<chosen-preset>'`.",
+    "## Path 3: Preset",
     "",
-    instructions.qualityNote
+    "If the user picks a preset, call `start` again with `preset: '<chosen-preset>'`."
   ].join("\n");
   return {
     text,
@@ -7256,6 +7399,19 @@ async function buildSeededResponse(wsCtx, readiness, agentSessionId) {
   } else {
     lines.push("No gaps detected \u2014 your workspace is filling up nicely. What would you like to work on?");
   }
+  const knowledgeGaps = getTopGaps(3);
+  if (knowledgeGaps.length > 0) {
+    lines.push("");
+    lines.push("### Learning Opportunities");
+    lines.push("_Topics agents recently looked for but aren't on the Chain yet:_");
+    lines.push("");
+    for (const gap of knowledgeGaps) {
+      const freq = gap.count > 1 ? ` _(${gap.count}x)_` : "";
+      lines.push(`- **${gap.query}**${freq}`);
+    }
+    lines.push("");
+    lines.push("_Capturing these will make future sessions more effective._");
+  }
   const { oriented, orientationStatus } = await tryMarkOriented(agentSessionId);
   const next = gaps.length > 0 ? [{ tool: "capture", description: `Fill gap: ${gaps[0].label}`, parameters: {} }] : [];
   return {
@@ -7395,6 +7551,7 @@ async function buildOrientResponse(wsCtx, agentSessionId, errors) {
   const isLowReadiness = readiness !== null && readiness.score < 50;
   const isHighReadiness = readiness !== null && readiness.score >= 50;
   const stage = readiness?.stage ?? null;
+  const captureBehaviorNote = wsFullCtx.governanceMode === "open" ? "_In Open mode, user-authored captures commit immediately unless you ask me to keep them as drafts._" : "_Everything I capture stays pending until you confirm._";
   lines.push(`# ${wsCtx.workspaceName}`);
   lines.push("_Product Brain is ready._");
   lines.push("");
@@ -7415,7 +7572,7 @@ async function buildOrientResponse(wsCtx, agentSessionId, errors) {
       lines.push("");
       lines.push(nextAction.cta);
       lines.push("");
-      lines.push("_Everything I capture stays pending until you confirm._");
+      lines.push(captureBehaviorNote);
       lines.push("");
       const remainingGaps = (readiness.gaps ?? []).length - 1;
       if (remainingGaps > 0 || openTensions.length > 0) {
@@ -9957,6 +10114,7 @@ function registerHealthTools(server) {
       if (isLowReadiness) {
         lines.push(`**Brain stage: ${orientStage}.**`);
         lines.push("");
+        const captureBehaviorNote = (readiness?.governanceMode ?? wsCtx?.governanceMode ?? "open") === "open" ? "_In Open mode, user-authored captures commit immediately unless you ask me to keep them as drafts._" : '_Everything stays as a draft until you confirm. Say "commit" or "looks good" to promote to the Chain._';
         const gaps = readiness.gaps ?? [];
         if (gaps.length > 0) {
           const gap = gaps[0];
@@ -9966,7 +10124,7 @@ function registerHealthTools(server) {
           lines.push("");
           lines.push(cta);
           lines.push("");
-          lines.push('_Everything stays as a draft until you confirm. Say "commit" or "looks good" to promote to the Chain._');
+          lines.push(captureBehaviorNote);
           lines.push("");
           const remainingGaps = gaps.length - 1;
           if (remainingGaps > 0 || openTensions.length > 0) {
@@ -11353,7 +11511,7 @@ If ready, ask the user to confirm. If not, suggest specific improvements.
   );
   server.prompt(
     "project-scan",
-    "Scan local project files to extract structured knowledge for Product Brain. The IDE agent reads README.md, package.json, .cursorrules, folder structure, and recent git history, then extracts vision, tech stack, key terms, and decisions into batch-capture entries. All entries land as drafts \u2014 the user reviews and commits.",
+    "Scan local project files to extract structured knowledge for Product Brain. The IDE agent reads README.md, package.json, .cursorrules, folder structure, and recent git history, then extracts vision, tech stack, key terms, and decisions into batch-capture entries. The trust boundary is confirmation before capture: only capture entries the user explicitly keeps, then let normal workspace governance apply.",
     {
       workspaceContext: z21.string().optional().describe("Optional context about the workspace preset and existing collections (paste from start/orient output)")
     },
@@ -11431,6 +11589,9 @@ Before calling batch-capture, check your extraction:
 
 If validation fails for any entry, drop it rather than sending malformed data.
 
+Then present the inferred entries as a numbered list. Ask which to keep, and do NOT call batch-capture yet.
+Only after the user confirms which entries to keep should you capture the confirmed entries.
+
 ## Step 4: Map to batch-capture
 
 Map your extracted data to entries using these rules:
@@ -11448,19 +11609,22 @@ ${exampleOutput}
 
 ## Step 5: Call batch-capture
 
+After the user confirms which entries to keep, call batch-capture with only those confirmed entries.
+Omit \`autoCommit\` to let normal workspace governance apply.
+
 \`\`\`
-batch-capture entries=[...your mapped entries...]
+batch-capture entries=[...your confirmed entries...]
 \`\`\`
 
 If \`failed > 0\` in the response, inspect \`failedEntries\` and retry those individually.
 
-## Step 6: Connect + Review
+## Step 6: Connect + Prove Value
 
 After capture:
 1. Call \`graph action=suggest\` on 2\u20133 key entries (vision, architecture, a decision)
-2. Present entries grouped by collection
-3. Ask: "Commit all, or would you like to review first?"
-4. Only call \`commit-entry\` when the user confirms
+2. Invent a plausible next task and call \`context action=gather task="<that task>"\`
+3. Present what Product Brain now knows in that task context \u2014 this is the proof moment
+4. Then show one clear result summary so the user sees exactly what was added
 
 **Begin with Step 1 now.** Read the files, then report what you found before extracting.`
           }
@@ -11581,4 +11745,4 @@ export {
   SERVER_VERSION,
   createProductBrainServer
 };
-//# sourceMappingURL=chunk-MH5MYP76.js.map
+//# sourceMappingURL=chunk-GKMXGRJW.js.map