@productbrain/mcp 0.0.1-beta.30 → 0.0.1-beta.31

package/dist/{chunk-P5KVCIYN.js → chunk-3JSR5JCU.js}

@@ -1,5 +1,4 @@
 import {
-  trackQualityCheck,
   trackQualityVerdict,
   trackToolCall
 } from "./chunk-SJ2ODB3Y.js";
@@ -7,6 +6,9 @@ import {
 // src/tools/smart-capture.ts
 import { z } from "zod";
 
+// src/client.ts
+import { AsyncLocalStorage as AsyncLocalStorage2 } from "async_hooks";
+
 // src/auth.ts
 import { AsyncLocalStorage } from "async_hooks";
 var requestStore = new AsyncLocalStorage();
@@ -58,6 +60,13 @@ function evictStale() {
 }
 
 // src/client.ts
+var toolContextStore = new AsyncLocalStorage2();
+function runWithToolContext(ctx, fn) {
+  return toolContextStore.run(ctx, fn);
+}
+function getToolContext() {
+  return toolContextStore.getStore() ?? null;
+}
 var DEFAULT_CLOUD_URL = "https://trustworthy-kangaroo-277.convex.site";
 var CACHE_TTL_MS = 6e4;
 var CACHEABLE_FNS = [
@@ -130,6 +139,9 @@ function isSessionOriented() {
 function setSessionOriented(value) {
   state().sessionOriented = value;
 }
+function getApiKeyScope() {
+  return state().apiKeyScope;
+}
 async function startAgentSession() {
   const workspaceId = await getWorkspaceId();
   const s = state();
@@ -144,6 +156,7 @@ async function startAgentSession() {
   s.apiKeyScope = result.toolsScope;
   s.sessionOriented = false;
   s.sessionClosed = false;
+  resetTouchThrottle();
   return result;
 }
 async function closeAgentSession() {
@@ -174,14 +187,22 @@ async function orphanAgentSession() {
     s.sessionOriented = false;
   }
 }
+var _lastTouchAt = 0;
+var TOUCH_THROTTLE_MS = 5e3;
 function touchSessionActivity() {
   const s = state();
   if (!s.agentSessionId) return;
+  const now = Date.now();
+  if (now - _lastTouchAt < TOUCH_THROTTLE_MS) return;
+  _lastTouchAt = now;
   mcpCall("agent.touchSession", {
     sessionId: s.agentSessionId
   }).catch(() => {
   });
 }
+function resetTouchThrottle() {
+  _lastTouchAt = 0;
+}
 async function recordSessionActivity(activity) {
   const s = state();
   if (!s.agentSessionId) return;
@@ -218,8 +239,10 @@ function shouldLogAudit(status) {
 function audit(fn, status, durationMs, errorMsg) {
   const ts = (/* @__PURE__ */ new Date()).toISOString();
   const workspace = state().workspaceId ?? "unresolved";
+  const toolCtx = getToolContext();
   const entry = { ts, fn, workspace, status, durationMs };
   if (errorMsg) entry.error = errorMsg;
+  if (toolCtx) entry.toolContext = toolCtx;
   auditBuffer.push(entry);
   if (auditBuffer.length > AUDIT_BUFFER_SIZE) auditBuffer.shift();
   trackToolCall(fn, status, durationMs, workspace, errorMsg);
@@ -341,12 +364,12 @@ function requireActiveSession() {
   const s = state();
   if (!s.agentSessionId) {
     throw new Error(
-      "Active session required (SOS-iszqu7). Call `agent-start` then `orient` first."
+      "Active session required (SOS-iszqu7). Call `session action=start` then `orient` first."
     );
   }
   if (s.sessionClosed) {
     throw new Error(
-      "Session has been closed (SOS-iszqu7). Start a new session with `agent-start`."
+      "Session has been closed (SOS-iszqu7). Start a new session with `session action=start`."
     );
   }
   if (!s.sessionOriented) {
@@ -359,7 +382,7 @@ function requireWriteAccess() {
   const s = state();
   if (!s.agentSessionId) {
     throw new Error(
-      "Agent session required for write operations. Call `agent-start` first."
+      "Agent session required for write operations. Call `session action=start` first."
     );
   }
   if (s.sessionClosed) {
@@ -393,6 +416,78 @@ async function recoverSessionState() {
   }
 }
 
+// src/tools/knowledge-helpers.ts
+function extractPreview(data, maxLen) {
+  if (!data || typeof data !== "object") return "";
+  const d = data;
+  const raw = d.description ?? d.canonical ?? d.detail ?? d.rule ?? "";
+  if (typeof raw !== "string" || !raw) return "";
+  return raw.length > maxLen ? raw.substring(0, maxLen) + "..." : raw;
+}
+var TOOL_NAME_MIGRATIONS = /* @__PURE__ */ new Map([
+  ["list-entries", 'entries action="list"'],
+  ["get-entry", 'entries action="get"'],
+  ["batch-get", 'entries action="batch"'],
+  ["search", 'entries action="search"'],
+  ["relate-entries", 'relations action="create"'],
+  ["batch-relate", 'relations action="batch-create"'],
+  ["find-related", 'graph action="find"'],
+  ["suggest-links", 'graph action="suggest"'],
+  ["gather-context", 'context action="gather"'],
+  ["get-build-context", 'context action="build"'],
+  ["list-collections", 'collections action="list"'],
+  ["create-collection", 'collections action="create"'],
+  ["update-collection", 'collections action="update"'],
+  ["agent-start", 'session action="start"'],
+  ["agent-close", 'session action="close"'],
+  ["agent-status", 'session action="status"'],
+  ["workspace-status", 'health action="status"'],
+  ["mcp-audit", 'health action="audit"'],
+  ["quality-check", 'quality action="check"'],
+  ["re-evaluate", 'quality action="re-evaluate"'],
+  ["list-workflows", 'workflows action="list"'],
+  ["workflow-checkpoint", 'workflows action="checkpoint"'],
+  ["wrapup", "session-wrapup"],
+  ["finish", "session-wrapup"]
+]);
+function translateStaleToolNames(text) {
+  const found = [];
+  for (const [old, current] of TOOL_NAME_MIGRATIONS) {
+    const pattern = new RegExp(`\\b${old.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\b`, "g");
+    if (pattern.test(text)) {
+      found.push(`\`${old}\` \u2192 \`${current}\``);
+    }
+  }
+  if (found.length === 0) return null;
+  return `
+
+---
+_Tool name translations (these references use deprecated names):_
+${found.map((f) => `- ${f}`).join("\n")}`;
+}
+
+// src/tool-surface.ts
+var _server = null;
+var _writeTools = [];
+function initToolSurface(server) {
+  _server = server;
+}
+function trackWriteTool(tool) {
+  _writeTools.push(tool);
+}
+function setWriteToolsEnabled(enabled) {
+  let changed = false;
+  for (const tool of _writeTools) {
+    if (tool.enabled !== enabled) {
+      tool.enabled = enabled;
+      changed = true;
+    }
+  }
+  if (changed && _server) {
+    _server.sendToolListChanged();
+  }
+}
+
 // src/tools/smart-capture.ts
 var AREA_KEYWORDS = {
   "Architecture": ["convex", "schema", "database", "migration", "api", "backend", "infrastructure", "scaling", "performance"],
@@ -436,7 +531,7 @@ var COMMON_CHECKS = {
     id: "has-relations",
     label: "At least 1 relation created",
     check: (ctx) => ctx.linksCreated.length >= 1,
-    suggestion: () => "Use `suggest-links` and `relate-entries` to add more connections."
+    suggestion: () => "Use `graph action=suggest` and `relations action=create` to add more connections."
   },
   diverseRelations: {
     id: "diverse-relations",
@@ -697,6 +792,44 @@ var PROFILES = /* @__PURE__ */ new Map([
       COMMON_CHECKS.hasDescription
     ]
   }],
+  ["principles", {
+    governedDraft: true,
+    descriptionField: "description",
+    defaults: [
+      { key: "severity", value: "high" },
+      { key: "category", value: "infer" }
+    ],
+    recommendedRelationTypes: ["governs", "informs", "references", "related_to"],
+    inferField: (ctx) => {
+      const fields = {};
+      const area = inferArea(`${ctx.name} ${ctx.description}`);
+      if (area) {
+        const categoryMap = {
+          "Architecture": "Engineering",
+          "Chain": "Product",
+          "AI & MCP Integration": "Engineering",
+          "Developer Experience": "Engineering",
+          "Governance & Decision-Making": "Business",
+          "Analytics & Tracking": "Product",
+          "Security": "Engineering"
+        };
+        fields.category = categoryMap[area] ?? "Product";
+      }
+      return fields;
+    },
+    qualityChecks: [
+      COMMON_CHECKS.clearName,
+      COMMON_CHECKS.hasDescription,
+      COMMON_CHECKS.hasRelations,
+      COMMON_CHECKS.hasType,
+      {
+        id: "has-rationale",
+        label: "Rationale provided \u2014 why this principle matters",
+        check: (ctx) => typeof ctx.data.rationale === "string" && ctx.data.rationale.length > 20,
+        suggestion: () => "Explain why this principle exists and what goes wrong without it."
+      }
+    ]
+  }],
   ["standards", {
     governedDraft: true,
     descriptionField: "description",
@@ -871,7 +1004,7 @@ async function checkEntryQuality(entryId) {
     const failedChecks = quality.checks.filter((c) => !c.passed && c.suggestion);
     if (failedChecks.length > 0) {
       lines.push("");
-      lines.push(`_To improve: use \`update-entry\` to fill missing fields, or \`relate-entries\` to add connections._`);
+      lines.push(`_To improve: use \`update-entry\` to fill missing fields, or \`relations action=create\` to add connections._`);
     }
   }
   return { text: lines.join("\n"), quality };
@@ -887,22 +1020,48 @@ var GOVERNED_COLLECTIONS = /* @__PURE__ */ new Set([
 var AUTO_LINK_CONFIDENCE_THRESHOLD = 35;
 var MAX_AUTO_LINKS = 5;
 var MAX_SUGGESTIONS = 5;
+var captureSchema = z.object({
+  collection: z.string().describe("Collection slug, e.g. 'tensions', 'business-rules', 'glossary', 'decisions'"),
+  name: z.string().describe("Display name \u2014 be specific (e.g. 'Convex adjacency list won't scale for graph traversal')"),
+  description: z.string().describe("Full context \u2014 what's happening, why it matters, what you observed"),
+  context: z.string().optional().describe("Optional additional context (e.g. 'Observed during context gather calls taking 700ms+')"),
+  entryId: z.string().optional().describe("Optional custom entry ID (e.g. 'TEN-my-id'). Auto-generated if omitted."),
+  canonicalKey: z.string().optional().describe("Semantic type (e.g. 'decision', 'tension', 'vision'). Auto-assigned from collection if omitted."),
+  data: z.record(z.unknown()).optional().describe("Explicit field values when you know the schema (e.g. canonical_key, cardinality_rule, required_fields). Merged with inferred values; user-provided wins.")
+});
+var batchCaptureSchema = z.object({
+  entries: z.array(z.object({
+    collection: z.string().describe("Collection slug"),
+    name: z.string().describe("Display name"),
+    description: z.string().describe("Full context / definition"),
+    entryId: z.string().optional().describe("Optional custom entry ID")
+  })).min(1).max(50).describe("Array of entries to capture")
+});
+var captureOutputSchema = z.object({
+  entryId: z.string(),
+  collection: z.string(),
+  name: z.string(),
+  status: z.literal("draft"),
+  qualityScore: z.number().optional(),
+  qualityVerdict: z.record(z.unknown()).optional()
+});
+var batchCaptureOutputSchema = z.object({
+  captured: z.array(z.object({
+    entryId: z.string(),
+    collection: z.string(),
+    name: z.string()
+  })),
+  total: z.number(),
+  failed: z.number()
+});
 function registerSmartCaptureTools(server) {
-  server.registerTool(
+  const captureTool = server.registerTool(
     "capture",
     {
       title: "Capture",
       description: "The single tool for creating knowledge entries. Creates an entry, auto-links related entries, and returns a quality scorecard \u2014 all in one call. Provide a collection, name, and description \u2014 everything else is inferred or auto-filled.\n\nSupported collections with smart profiles: tensions, business-rules, glossary, decisions, features, audiences, strategy, standards, maps, chains, tracking-events.\nAll other collections get an ENT-{random} ID and sensible defaults.\n\n**Explicit data:** When you know the schema, pass `data: { field: value }` to set fields directly. Top-level `name` and `description` always win for those fields. `data` wins over inference for all other fields.\n\nAlways creates as 'draft' for governed collections. Use `update-entry` for post-creation adjustments.",
-      inputSchema: {
-        collection: z.string().describe("Collection slug, e.g. 'tensions', 'business-rules', 'glossary', 'decisions'"),
-        name: z.string().describe("Display name \u2014 be specific (e.g. 'Convex adjacency list won't scale for graph traversal')"),
-        description: z.string().describe("Full context \u2014 what's happening, why it matters, what you observed"),
-        context: z.string().optional().describe("Optional additional context (e.g. 'Observed during gather-context calls taking 700ms+')"),
-        entryId: z.string().optional().describe("Optional custom entry ID (e.g. 'TEN-my-id'). Auto-generated if omitted."),
-        canonicalKey: z.string().optional().describe("Semantic type (e.g. 'decision', 'tension', 'vision'). Auto-assigned from collection if omitted."),
-        data: z.record(z.unknown()).optional().describe("Explicit field values when you know the schema (e.g. canonical_key, cardinality_rule, required_fields). Merged with inferred values; user-provided wins.")
-      },
-      annotations: { destructiveHint: false }
+      inputSchema: captureSchema.shape,
+      annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
     },
     async ({ collection, name, description, context, entryId, canonicalKey, data: userData }) => {
       requireWriteAccess();
@@ -917,10 +1076,10 @@ function registerSmartCaptureTools(server) {
 
 **To create it**, run:
 \`\`\`
-create-collection slug="${collection}" name="${displayName}" description="..."
+collections action=create slug="${collection}" name="${displayName}" description="..."
 \`\`\`
 
-Or use \`list-collections\` to see available collections.`
+Or use \`collections action=list\` to see available collections.`
           }]
         };
       }
@@ -996,7 +1155,7 @@ Or use \`list-collections\` to see available collections.`
 
 ${msg}
 
-Use \`get-entry\` to inspect the existing entry, or \`update-entry\` to modify it.`
+Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to modify it.`
             }]
           };
         }
@@ -1135,7 +1294,7 @@ Use \`get-entry\` to inspect the existing entry, or \`update-entry\` to modify i
       }
       if (linksSuggested.length > 0) {
         lines.push("");
-        lines.push("## Suggested links (review and use relate-entries)");
+        lines.push("## Suggested links (review and use `relations action=create`)");
         for (let i = 0; i < linksSuggested.length; i++) {
           const s = linksSuggested[i];
           const preview = s.preview ? ` \u2014 ${s.preview}` : "";
@@ -1154,7 +1313,7 @@ Use \`get-entry\` to inspect the existing entry, or \`update-entry\` to modify i
       if (isBetOrGoal && !hasStrategyLink) {
         lines.push("");
         lines.push(
-          `**Strategy link:** This ${collection === "bets" ? "bet" : "goal"} doesn't connect to any strategy entry. Consider linking before commit. Use \`suggest-links entryId="${finalEntryId}"\` to find strategy entries to connect to.`
+          `**Strategy link:** This ${collection === "bets" ? "bet" : "goal"} doesn't connect to any strategy entry. Consider linking before commit. Use \`graph action=suggest entryId="${finalEntryId}"\` to find strategy entries to connect to.`
         );
         await recordSessionActivity({ strategyLinkWarnedForEntryId: internalId });
       }
@@ -1168,7 +1327,7 @@ Use \`get-entry\` to inspect the existing entry, or \`update-entry\` to modify i
         for (const w of contradictionWarnings) {
           lines.push(`- ${w.name} (${w.collection}, ${w.entryId}) \u2014 has 'governs' relation to ${w.governsCount} entries`);
         }
-        lines.push("Run gather-context on these entries before committing.");
+        lines.push("Run `context action=gather` on these entries before committing.");
       }
       if (coachingSection) {
         lines.push("");
@@ -1177,7 +1336,7 @@ Use \`get-entry\` to inspect the existing entry, or \`update-entry\` to modify i
       lines.push("");
       lines.push("## Next Steps");
       const eid = finalEntryId || "(check entry ID)";
-      lines.push(`1. **Connect it:** \`suggest-links entryId="${eid}"\` \u2014 discover what this should link to`);
+      lines.push(`1. **Connect it:** \`graph action=suggest entryId="${eid}"\` \u2014 discover what this should link to`);
       lines.push(`2. **Commit it:** \`commit-entry entryId="${eid}"\` \u2014 promote from draft to SSOT on the Chain`);
       if (failedChecks.length > 0) {
         lines.push(`3. **Improve quality:** \`update-entry entryId="${eid}"\` \u2014 fill missing fields`);
@@ -1196,37 +1355,51 @@ Use \`get-entry\` to inspect the existing entry, or \`update-entry\` to modify i
       }
       const toolResult = {
         content: [{ type: "text", text: lines.join("\n") }],
-        structuredContent: verdictResult?.verdict ? { qualityVerdict: verdictResult.verdict, source: verdictResult.source ?? "heuristic" } : void 0
+        structuredContent: {
+          entryId: finalEntryId,
+          collection,
+          name,
+          status: "draft",
+          qualityScore: quality.score,
+          qualityVerdict: verdictResult?.verdict ? { ...verdictResult.verdict, source: verdictResult.source ?? "heuristic" } : void 0
+        }
       };
       return toolResult;
     }
   );
-  server.registerTool(
+  trackWriteTool(captureTool);
+  const batchCaptureTool = server.registerTool(
     "batch-capture",
     {
       title: "Batch Capture",
-      description: "Create multiple knowledge entries in one call. Ideal for workspace setup, document ingestion, or any scenario where you need to capture many entries at once.\n\nEach entry is created independently \u2014 if one fails, the others still succeed. Returns a compact summary instead of per-entry quality scorecards.\n\nAuto-linking runs per entry but contradiction checks and readiness hints are skipped for speed. Use `quality-check` on individual entries afterward if needed.",
-      inputSchema: {
-        entries: z.array(z.object({
-          collection: z.string().describe("Collection slug"),
-          name: z.string().describe("Display name"),
-          description: z.string().describe("Full context / definition"),
-          entryId: z.string().optional().describe("Optional custom entry ID")
-        })).min(1).max(50).describe("Array of entries to capture")
-      },
-      annotations: { destructiveHint: false }
+      description: "Create multiple knowledge entries in one call. Ideal for workspace setup, document ingestion, or any scenario where you need to capture many entries at once.\n\nEach entry is created independently \u2014 if one fails, the others still succeed. Returns a compact summary instead of per-entry quality scorecards.\n\nAuto-linking runs per entry but contradiction checks and readiness hints are skipped for speed. Use `quality action=check` on individual entries afterward if needed.",
+      inputSchema: batchCaptureSchema.shape,
+      annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
     },
     async ({ entries }) => {
       requireWriteAccess();
       const agentId = getAgentSessionId();
       const createdBy = agentId ? `agent:${agentId}` : "capture";
       const results = [];
+      await server.sendLoggingMessage({
+        level: "info",
+        data: `Batch capturing ${entries.length} entries...`,
+        logger: "product-brain"
+      });
       const allCollections = await mcpQuery("chain.listCollections");
       const collCache = /* @__PURE__ */ new Map();
       for (const c of allCollections) collCache.set(c.slug, c);
       const collIdToSlug = /* @__PURE__ */ new Map();
       for (const c of allCollections) collIdToSlug.set(c._id, c.slug);
-      for (const entry of entries) {
+      for (let entryIdx = 0; entryIdx < entries.length; entryIdx++) {
+        const entry = entries[entryIdx];
+        if (entryIdx > 0 && entryIdx % 5 === 0) {
+          await server.sendLoggingMessage({
+            level: "info",
+            data: `Captured ${entryIdx}/${entries.length} entries...`,
+            logger: "product-brain"
+          });
+        }
         const profile = PROFILES.get(entry.collection) ?? FALLBACK_PROFILE;
         const col = collCache.get(entry.collection);
         if (!col) {
@@ -1320,6 +1493,11 @@ Use \`get-entry\` to inspect the existing entry, or \`update-entry\` to modify i
       }
       const created = results.filter((r) => r.ok);
       const failed = results.filter((r) => !r.ok);
+      await server.sendLoggingMessage({
+        level: "info",
+        data: `Batch complete. ${created.length} succeeded, ${failed.length} failed.`,
+        logger: "product-brain"
+      });
       const totalAutoLinks = created.reduce((sum, r) => sum + r.autoLinks, 0);
       const byCollection = /* @__PURE__ */ new Map();
       for (const r of created) {
@@ -1356,120 +1534,21 @@ Use \`get-entry\` to inspect the existing entry, or \`update-entry\` to modify i
       if (entryIds.length > 0) {
         lines.push("");
         lines.push("## Next Steps");
-        lines.push(`- **Connect:** Run \`suggest-links\` on key entries to build the knowledge graph`);
+        lines.push(`- **Connect:** Run \`graph action=suggest\` on key entries to build the knowledge graph`);
         lines.push(`- **Commit:** Use \`commit-entry\` to promote drafts to SSOT`);
-        lines.push(`- **Quality:** Run \`quality-check\` on individual entries to assess completeness`);
+        lines.push(`- **Quality:** Run \`quality action=check\` on individual entries to assess completeness`);
       }
-      return { content: [{ type: "text", text: lines.join("\n") }] };
-    }
-  );
-  server.registerTool(
-    "quality-check",
-    {
-      title: "Quality Check",
-      description: "Score an existing knowledge entry against collection-specific quality criteria. Returns a scorecard (X/10) with specific, actionable suggestions for improvement \u2014 including concrete link suggestions from graph analysis when relations are missing.\n\nChecks: name clarity, description completeness, relation connectedness, and collection-specific fields.\n\nUse after creating entries to assess their quality, or to audit existing entries.",
-      inputSchema: {
-        entryId: z.string().describe("Entry ID to check, e.g. 'TEN-graph-db', 'GT-019', 'SOS-006'")
-      },
-      annotations: { readOnlyHint: true }
-    },
-    async ({ entryId }) => {
-      const result = await checkEntryQuality(entryId);
-      const needsRelations = result.quality.checks.some(
-        (c) => !c.passed && (c.id === "has-relations" || c.id === "diverse-relations")
-      );
-      if (needsRelations) {
-        try {
-          const suggestions = await mcpQuery("chain.graphSuggestLinks", {
-            entryId,
-            maxHops: 2,
-            limit: 3
-          });
-          if (suggestions?.suggestions?.length > 0) {
-            const linkHints = suggestions.suggestions.map((s) => `  \u2192 \`relate-entries from='${entryId}' to='${s.entryId}' type='${s.recommendedRelationType}'\` \u2014 ${s.name} [${s.collectionSlug}] (${s.score}/100)`).join("\n");
-            result.text += `
-
-## Suggested Links to Improve Quality
-${linkHints}`;
-          }
-        } catch {
-        }
-      }
-      try {
-        const verdict = await mcpQuery("quality.getLatestVerdictForEntry", { entryId });
-        if (verdict && verdict.criteria?.length > 0) {
-          result.text += "\n\n" + formatRubricVerdictSection(verdict);
-          try {
-            const wsForTracking = await getWorkspaceContext();
-            trackQualityCheck(wsForTracking.workspaceId, {
-              entry_id: entryId,
-              entry_type: verdict.canonicalKey ?? "",
-              tier: verdict.tier,
-              passed: verdict.passed,
-              source: verdict.source,
-              llm_status: verdict.llmStatus,
-              llm_duration_ms: verdict.llmDurationMs,
-              llm_error: verdict.llmError,
-              has_roger_martin: !!verdict.rogerMartin
-            });
-          } catch {
-          }
+      return {
+        content: [{ type: "text", text: lines.join("\n") }],
+        structuredContent: {
+          captured: created.map((r) => ({ entryId: r.entryId, collection: r.collection, name: r.name })),
+          total: created.length,
+          failed: failed.length
         }
-      } catch {
-      }
-      return { content: [{ type: "text", text: result.text }] };
-    }
-  );
-  server.registerTool(
-    "re-evaluate",
-    {
-      title: "Re-evaluate Entry Quality",
-      description: "Trigger a fresh quality evaluation on an existing entry without creating a new one. Useful for canary testing or re-assessing after edits. Returns the heuristic verdict immediately and schedules LLM evaluation in the background.",
-      inputSchema: {
-        entryId: z.string().describe("Entry ID to re-evaluate, e.g. 'VIS-001', 'STR-012'"),
-        context: z.enum(["capture", "commit", "review"]).default("review").describe("Evaluation context")
-      }
-    },
-    async ({ entryId, context }) => {
-      const ws = await getWorkspaceContext();
-      const result = await mcpMutation("quality.reEvaluateEntry", {
-        entryId,
-        context: context ?? "review"
-      });
-      if (!result) {
-        return { content: [{ type: "text", text: `Entry \`${entryId}\` not found or has no rubric.` }] };
-      }
-      const llmScheduled = result.verdict.tier !== "passive";
-      const lines = [`Re-evaluated \`${entryId}\` in \`${context ?? "review"}\` context.`];
-      lines.push("");
-      lines.push(formatRubricVerdictSection({
-        ...result.verdict,
-        source: result.source,
-        llmStatus: llmScheduled ? "pending" : "skipped"
-      }));
-      try {
-        trackQualityVerdict(ws.workspaceId, {
-          entry_id: entryId,
-          entry_type: result.verdict.canonicalKey ?? "",
-          tier: result.verdict.tier,
-          context: context ?? "review",
-          passed: result.verdict.passed,
-          source: "heuristic",
-          criteria_total: result.verdict.criteria?.length ?? 0,
-          criteria_failed: result.verdict.criteria?.filter((c) => !c.passed).length ?? 0,
-          llm_scheduled: llmScheduled
-        });
-      } catch {
-      }
-      return { content: [{ type: "text", text: lines.join("\n") }] };
+      };
     }
   );
-}
-function extractPreview(data, maxLen) {
-  if (!data || typeof data !== "object") return "";
-  const raw = data.description ?? data.canonical ?? data.detail ?? data.rule ?? "";
-  if (typeof raw !== "string" || !raw) return "";
-  return raw.length > maxLen ? raw.substring(0, maxLen) + "..." : raw;
+  trackWriteTool(batchCaptureTool);
 }
 var STOP_WORDS = /* @__PURE__ */ new Set([
   "the",
@@ -1560,7 +1639,7 @@ async function runContradictionCheck(name, description) {
     const text = `${name} ${description}`.toLowerCase();
     const keyTerms = text.split(/\s+/).filter((w) => w.length >= 4 && !STOP_WORDS.has(w)).slice(0, 8);
     if (keyTerms.length === 0) return warnings;
-    const searchQuery = keyTerms.slice(0, 3).join(" ");
+    const searchQuery = keyTerms.slice(0, 5).join(" ");
     const [govResults, archResults] = await Promise.all([
       mcpQuery("chain.searchEntries", { query: searchQuery, collectionSlug: "business-rules" }),
       mcpQuery("chain.searchEntries", { query: searchQuery, collectionSlug: "architecture" })
@@ -1569,7 +1648,7 @@ async function runContradictionCheck(name, description) {
     for (const entry of allGov) {
       const entryText = `${entry.name} ${entry.data?.description ?? ""}`.toLowerCase();
       const matched = keyTerms.filter((t) => entryText.includes(t));
-      if (matched.length < 2) continue;
+      if (matched.length < 3) continue;
       let governsCount = 0;
       try {
         const relations = await mcpQuery("chain.listEntryRelations", {
@@ -1667,9 +1746,11 @@ function formatRubricVerdictSection(verdict) {
 
 export {
   runWithAuth,
+  runWithToolContext,
   getAgentSessionId,
   isSessionOriented,
   setSessionOriented,
+  getApiKeyScope,
   startAgentSession,
   closeAgentSession,
   orphanAgentSession,
@@ -1685,10 +1766,20 @@ export {
   requireActiveSession,
   requireWriteAccess,
   recoverSessionState,
+  extractPreview,
+  translateStaleToolNames,
+  initToolSurface,
+  trackWriteTool,
+  setWriteToolsEnabled,
   formatQualityReport,
   checkEntryQuality,
+  captureSchema,
+  batchCaptureSchema,
+  captureOutputSchema,
+  batchCaptureOutputSchema,
   registerSmartCaptureTools,
   runContradictionCheck,
-  formatRubricCoaching
+  formatRubricCoaching,
+  formatRubricVerdictSection
 };
-//# sourceMappingURL=chunk-P5KVCIYN.js.map
+//# sourceMappingURL=chunk-3JSR5JCU.js.map