@productbrain/mcp 0.0.1-beta.156 → 0.0.1-beta.157

package/dist/{chunk-GMSHWOXT.js → chunk-NRP3DF6E.js}

@@ -12,8 +12,11 @@ import {
   trackKnowledgeGap,
   trackQualityCheck,
   trackQualityVerdict,
-  trackToolCall
-} from "./chunk-X3S5UTTZ.js";
+  trackSessionCaptureRate,
+  trackToolCall,
+  trackWriteBackHintServed,
+  trackZeroCaptureAuditFired
+} from "./chunk-WYVQARYT.js";
 
 // src/auth.ts
 import { AsyncLocalStorage } from "async_hooks";
@@ -7260,6 +7263,30 @@ 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.");
   }
+  if (data.captureAudit) {
+    lines.push("");
+    lines.push("### Capture Audit");
+    lines.push("");
+    lines.push(`_${data.captureAudit.message}_`);
+    if (data.captureAudit.suggestions.length > 0) {
+      lines.push("");
+      lines.push("**What to consider capturing:**");
+      for (const s of data.captureAudit.suggestions) {
+        lines.push(`- **${s.collectionSlug}**: ${s.hint}`);
+      }
+    }
+    lines.push("");
+  }
+  lines.push("");
+  lines.push(`> **${data.closeNudge}**`);
+  if (data.captureAudit) {
+    const wsCtx = await getWorkspaceContext();
+    if (wsCtx) {
+      trackZeroCaptureAuditFired(wsCtx.workspaceId, {
+        suggestion_count: data.captureAudit.suggestions.length
+      });
+    }
+  }
   const gapCount = getSessionGaps().length;
   return { text: lines.join("\n"), data, suggestions, gapCount, coherenceVerdict, persistentGaps };
 }
@@ -7583,13 +7610,22 @@ async function handleClose() {
   }
   await closeAgentSession();
   clearSessionGaps();
+  const created = session?.entriesCreated?.length ?? 0;
+  const modified = session?.entriesModified?.length ?? 0;
+  const relations = session?.relationsCreated ?? 0;
+  const wsCtx = await getWorkspaceContext();
+  if (wsCtx) {
+    trackSessionCaptureRate(wsCtx.workspaceId, {
+      entries_created: created,
+      entries_modified: modified,
+      relations_created: relations,
+      had_captures: created > 0
+    });
+  }
   const lines = [
     `Session ${sessionId} closed.`,
     ""
   ];
-  const created = session?.entriesCreated?.length ?? 0;
-  const modified = session?.entriesModified?.length ?? 0;
-  const relations = session?.relationsCreated ?? 0;
   const gates = session?.gateFailures ?? 0;
   const warnings = session?.contradictionWarnings ?? 0;
   if (session) {
@@ -8370,7 +8406,7 @@ var IMPLEMENTATION_REVIEW_WORKFLOW_DESCRIPTOR = {
 
 ## Your Behavior
 
-1. **Tool-heavy, not chat-heavy.** Each round calls specific tools: orient, quality, verify, chain-review, context action=gather, review-against-rules. Use Context7 (query-docs) for relevant testing and framework docs \u2014 not for Chain truth.
+1. **Tool-heavy, not chat-heavy.** Each round calls specific tools: orient, quality, verify, chain-review, context action=gather, review-against-rules. Use Context7 **CLI** (\`npx ctx7@latest library\` then \`docs\`) for relevant testing and framework docs \u2014 not for Chain truth. Do not use Context7 MCP.
 2. **Spawn sub-agents** for parallel review: (a) code/architecture review, (b) test honesty (did we edit tests to pass or do they validate real behavior?). Max 2 agents in parallel, 30s budget each. **Constrain each sub-agent to the stated review scope only.**
 3. **Fix-as-you-go (FEAT-172).** When you find a HIGH or MEDIUM issue: fix it immediately, verify (lints, types), then proceed. The user sees clean work, not a list of issues. Only defer if estimated >5 min \u2014 capture deferred items as tensions. If user says "skip", capture as tension and continue.
 4. **Chain is SSOT.** Call orient or start first. Use entries action=search and context action=gather to load relevant BETs, DECs, BRs. If findings conflict with Chain entries, report the conflict and cite the entry ID.
@@ -8387,7 +8423,7 @@ var IMPLEMENTATION_REVIEW_WORKFLOW_DESCRIPTOR = {
 - \`verify\` \u2014 glossary code mappings, cross-references vs codebase
 - \`review-against-rules\` (domain) \u2014 business rule compliance
 - \`context action=gather task="implementation review for [BET-ID]"\` \u2014 related knowledge
-- Context7 \`query-docs\` \u2014 relevant testing and framework best practices (resolve-library-id first)
+- Context7 CLI \u2014 \`npx ctx7@latest library\` then \`npx ctx7@latest docs\` for framework/testing docs (not Chain truth)
 - \`session-wrapup\` \u2014 before close
 
 ## Sub-Agent Classification (for test failures)
@@ -8439,7 +8475,7 @@ This block is the final deliverable of the review. Everything else is supporting
       label: "Code & Test Honesty",
       type: "open",
       instruction: "Spawn sub-agents to review implementation and tests for the stated scope only. Fix every HIGH/MEDIUM finding before proceeding. Did we meet high standards? Are tests validating real behavior or did we edit them just to pass?",
-      facilitatorGuidance: "Restrict all review to the scope stated in Round 01 (by default, work in this conversation only). Spawn 1\u20132 sub-agents in parallel: (1) explore agent \u2014 code review, architecture boundaries, type-safety for scoped files only. (2) explore agent \u2014 test review for scoped code: are tests asserting real behavior or were they edited to pass? Pass the scope (files/BET) explicitly to sub-agents so they do not touch other work. Use Context7 (query-docs) for relevant testing and framework best practices if needed. Classify any test failures: staleness, regression, or flaky. **Fix-as-you-go (FEAT-172):** For every HIGH/MEDIUM finding: fix immediately, run lints, verify types. Only defer fixes estimated >5 min \u2014 capture deferred items as tensions on the Chain. After fixing, do a boy-scout pass on each scoped file: clean imports, improve naming, remove dead code. **Counter-Metric Mandate (STD-19):** When reporting test coverage, accuracy, or any quantitative result, include the denominator, what was excluded, and at least one counter-metric. Never report accuracy without recall. Never report pass rate without coverage. Synthesize: findings, fixes applied, implementation grade, test honesty verdict.",
+      facilitatorGuidance: "Restrict all review to the scope stated in Round 01 (by default, work in this conversation only). Spawn 1\u20132 sub-agents in parallel: (1) explore agent \u2014 code review, architecture boundaries, type-safety for scoped files only. (2) explore agent \u2014 test review for scoped code: are tests asserting real behavior or were they edited to pass? Pass the scope (files/BET) explicitly to sub-agents so they do not touch other work. Use Context7 CLI (npx ctx7 library/docs) for relevant testing and framework best practices if needed. Classify any test failures: staleness, regression, or flaky. **Fix-as-you-go (FEAT-172):** For every HIGH/MEDIUM finding: fix immediately, run lints, verify types. Only defer fixes estimated >5 min \u2014 capture deferred items as tensions on the Chain. After fixing, do a boy-scout pass on each scoped file: clean imports, improve naming, remove dead code. **Counter-Metric Mandate (STD-19):** When reporting test coverage, accuracy, or any quantitative result, include the denominator, what was excluded, and at least one counter-metric. Never report accuracy without recall. Never report pass rate without coverage. Synthesize: findings, fixes applied, implementation grade, test honesty verdict.",
       outputSchema: {
         field: "codeAndTests",
         description: "Implementation grade, test honesty, refactor suggestions",
@@ -8515,7 +8551,7 @@ This block is the final deliverable of the review. Everything else is supporting
 
 1. **Tool failure**: Explain what failed. Continue with what you have. The conversation is the record.
 2. **Sub-agent timeout**: Proceed without that agent's output. Note what wasn't checked.
-3. **Context7 unavailable**: Skip library doc validation. Rely on Chain and codebase review.
+3. **Context7 CLI unavailable** (e.g. auth/network): Skip library doc validation. Rely on Chain and codebase review.
 4. **MCP unreachable**: Run from conversation knowledge. Summarize findings. Offer to capture manually later.
 
 The review must never fail silently. Always end with BET/chain IDs.`
@@ -13249,6 +13285,15 @@ function registerOrientTool(server) {
       } catch {
       }
       const hasTaskGrounding = Boolean(task && orientEntries?.taskContext?.context?.length > 0);
+      if (wsCtx && hasTaskGrounding && orientEntries?.writeBackHints) {
+        const hints = Array.isArray(orientEntries.writeBackHints) ? orientEntries.writeBackHints : [];
+        if (hints.length > 0) {
+          trackWriteBackHintServed(wsCtx.workspaceId, {
+            hint_count: hints.length,
+            has_task: !!task
+          });
+        }
+      }
       let openTensions = [];
       try {
         const tensions = await mcpQuery("chain.listEntries", { collectionSlug: "tensions" });
@@ -13327,6 +13372,13 @@ function registerOrientTool(server) {
         if (orientEntries?.taskContext && orientEntries.taskContext.context.length > 0) {
           lines.push(`Task context: ${orientEntries.taskContext.totalFound} relevant entries (${orientEntries.taskContext.confidence} confidence).`);
         }
+        if (orientEntries?.writeBackHints && orientEntries.writeBackHints.length > 0) {
+          lines.push("");
+          lines.push("Write-back hints (what to capture this session):");
+          for (const h of orientEntries.writeBackHints) {
+            lines.push(`  ${h.collectionSlug}: ${h.hint}`);
+          }
+        }
         if (orientEntries?.activeBets?.length > 0) {
           for (const e of orientEntries.activeBets) {
             const tensions = e.linkedTensions;
@@ -13574,6 +13626,16 @@ function registerOrientTool(server) {
               orientEntries.taskContext.constellationBetName
             ));
           }
+          if (orientEntries?.writeBackHints && orientEntries.writeBackHints.length > 0) {
+            lines.push("");
+            lines.push("## Write-Back Hints");
+            lines.push("_What to capture this session (derived from task context):_");
+            lines.push("");
+            for (const h of orientEntries.writeBackHints) {
+              lines.push(`- **${h.collectionSlug}**: ${h.hint}`);
+            }
+            lines.push("");
+          }
           if (orientEntries) {
             const result = await runAlignmentCheck(
               task,
@@ -15319,4 +15381,4 @@ export {
   SERVER_VERSION,
   createProductBrainServer
 };
-//# sourceMappingURL=chunk-GMSHWOXT.js.map
+//# sourceMappingURL=chunk-NRP3DF6E.js.map