@productbrain/mcp 0.0.1-beta.47 → 0.0.1-beta.49

package/dist/{chunk-FYFF4QKF.js → chunk-ED3KCWZE.js}

@@ -159,22 +159,27 @@ async function startAgentSession() {
     workspaceId,
     apiKeyId: s.apiKeyId
   });
+  if (s.agentSessionId) {
+    resetTouchThrottle(s.agentSessionId);
+  }
   s.agentSessionId = result.sessionId;
   s.apiKeyScope = result.toolsScope;
   s.sessionOriented = false;
   s.sessionClosed = false;
-  resetTouchThrottle();
+  resetTouchThrottle(result.sessionId);
   return result;
 }
 async function closeAgentSession() {
   const s = state();
   if (!s.agentSessionId) return;
+  const sessionId = s.agentSessionId;
   try {
     await mcpCall("agent.closeSession", {
-      sessionId: s.agentSessionId,
+      sessionId,
       status: "closed"
     });
   } finally {
+    resetTouchThrottle(sessionId);
     s.sessionClosed = true;
     s.agentSessionId = null;
     s.sessionOriented = false;
@@ -183,32 +188,40 @@ async function closeAgentSession() {
 async function orphanAgentSession() {
   const s = state();
   if (!s.agentSessionId) return;
+  const sessionId = s.agentSessionId;
   try {
     await mcpCall("agent.closeSession", {
-      sessionId: s.agentSessionId,
+      sessionId,
       status: "orphaned"
     });
   } catch {
   } finally {
+    resetTouchThrottle(sessionId);
     s.agentSessionId = null;
     s.sessionOriented = false;
   }
 }
-var _lastTouchAt = 0;
+var _lastTouchAtBySession = /* @__PURE__ */ new Map();
 var TOUCH_THROTTLE_MS = 5e3;
 function touchSessionActivity() {
   const s = state();
-  if (!s.agentSessionId) return;
+  const sessionId = s.agentSessionId;
+  if (!sessionId) return;
   const now = Date.now();
-  if (now - _lastTouchAt < TOUCH_THROTTLE_MS) return;
-  _lastTouchAt = now;
+  const lastTouchAt = _lastTouchAtBySession.get(sessionId) ?? 0;
+  if (now - lastTouchAt < TOUCH_THROTTLE_MS) return;
+  _lastTouchAtBySession.set(sessionId, now);
   mcpCall("agent.touchSession", {
-    sessionId: s.agentSessionId
+    sessionId
   }).catch(() => {
   });
 }
-function resetTouchThrottle() {
-  _lastTouchAt = 0;
+function resetTouchThrottle(sessionId) {
+  if (sessionId) {
+    _lastTouchAtBySession.delete(sessionId);
+    return;
+  }
+  _lastTouchAtBySession.clear();
 }
 async function recordSessionActivity(activity) {
   const s = state();
@@ -302,7 +315,14 @@ async function mcpCall(fn, args = {}) {
     setCached(fn, args, data);
   }
   const s = state();
-  const TOUCH_EXCLUDED = /* @__PURE__ */ new Set(["agent.touchSession", "agent.startSession", "agent.markOriented"]);
+  const TOUCH_EXCLUDED = /* @__PURE__ */ new Set([
+    "agent.touchSession",
+    "agent.startSession",
+    "agent.markOriented",
+    "agent.recordActivity",
+    "agent.recordWrapup",
+    "agent.closeSession"
+  ]);
   if (s.agentSessionId && !TOUCH_EXCLUDED.has(fn)) {
     touchSessionActivity();
   }
@@ -428,6 +448,58 @@ async function recoverSessionState() {
 }
 
 // src/tools/knowledge-helpers.ts
+var EPISTEMIC_COLLECTIONS = /* @__PURE__ */ new Set(["insights", "assumptions"]);
+function deriveEpistemicStatus(entry) {
+  const coll = entry.collectionName?.toLowerCase();
+  if (!coll || !EPISTEMIC_COLLECTIONS.has(coll)) return null;
+  const relations = entry.relations ?? [];
+  const hasValidates = relations.some(
+    (r) => r.type === "validates" && r.direction === "incoming"
+  );
+  const hasInvalidates = relations.some(
+    (r) => r.type === "invalidates" && r.direction === "incoming"
+  );
+  const evidenceCount = relations.filter(
+    (r) => (r.type === "validates" || r.type === "invalidates") && r.direction === "incoming"
+  ).length;
+  if (coll === "assumptions") {
+    const ws2 = entry.workflowStatus;
+    if (ws2 === "invalidated" || hasInvalidates) {
+      return { level: "invalidated", reason: "Disproved by linked counter-evidence" };
+    }
+    if (ws2 === "validated" || hasValidates && ws2 !== "untested") {
+      return { level: "validated", reason: `${evidenceCount} evidence link${evidenceCount !== 1 ? "s" : ""}` };
+    }
+    if (ws2 === "testing") {
+      return { level: "testing", reason: "Experiment in progress" };
+    }
+    return { level: "untested", reason: "No evidence linked", action: 'Link evidence via `relations action=create type="validates"`' };
+  }
+  const ws = entry.workflowStatus;
+  if (ws === "validated" && hasValidates) {
+    return { level: "validated", reason: `${evidenceCount} evidence link${evidenceCount !== 1 ? "s" : ""}` };
+  }
+  if (ws === "evidenced" || hasValidates) {
+    return { level: "evidenced", reason: `${evidenceCount} evidence link${evidenceCount !== 1 ? "s" : ""}` };
+  }
+  return {
+    level: "hypothesis",
+    reason: "No linked evidence",
+    action: 'Link proof via `relations action=create type="validates"`'
+  };
+}
+function formatEpistemicLine(es) {
+  const icon = es.level === "validated" ? "\u2713" : es.level === "evidenced" ? "\u25CE" : es.level === "hypothesis" ? "\u25B3" : es.level === "untested" ? "?" : es.level === "testing" ? "\u25CE" : "\u2715";
+  const suffix = es.action ? ` ${es.action}` : "";
+  return `**Confidence:** ${icon} ${es.level} \u2014 ${es.reason}.${suffix}`;
+}
+function toEpistemicInput(entry) {
+  return {
+    collectionName: typeof entry.collectionName === "string" ? entry.collectionName : void 0,
+    workflowStatus: typeof entry.workflowStatus === "string" ? entry.workflowStatus : void 0,
+    relations: Array.isArray(entry.relations) ? entry.relations.map((r) => ({ type: r.type, direction: r.direction })) : void 0
+  };
+}
 function extractPreview(data, maxLen) {
   if (!data || typeof data !== "object") return "";
   const d = data;
@@ -546,11 +618,27 @@ async function isFeatureEnabled(flag, workspaceId, workspaceSlug) {
 // src/tools/smart-capture-routing.ts
 var CLASSIFIER_AUTO_ROUTE_THRESHOLD = 70;
 var CLASSIFIER_AMBIGUITY_MARGIN = 15;
-var STARTER_COLLECTIONS = ["decisions", "tensions", "glossary", "insights", "bets"];
+var CLASSIFIABLE_COLLECTIONS = [
+  "decisions",
+  "tensions",
+  "glossary",
+  "insights",
+  "bets",
+  "features",
+  "architecture",
+  "business-rules",
+  "tracking-events",
+  "landscape",
+  "standards",
+  "principles",
+  "assumptions"
+];
+var STARTER_COLLECTIONS = CLASSIFIABLE_COLLECTIONS;
 var SIGNAL_WEIGHT = 10;
+var MIN_SCORE_FLOOR = 10;
 var MAX_MATCHES_PER_SIGNAL = 2;
 var MAX_REASON_COUNT = 3;
-var STARTER_COLLECTION_SIGNALS = {
+var COLLECTION_SIGNALS = {
   decisions: [
     "decide",
     "decision",
@@ -560,7 +648,15 @@ var STARTER_COLLECTION_SIGNALS = {
     "resolved",
     "we will",
     "we should",
-    "approved"
+    "approved",
+    "replaces",
+    "instead of",
+    "go with",
+    "criteria",
+    "adopted",
+    "reposition",
+    "scoring framework",
+    "review"
   ],
   tensions: [
     "problem",
@@ -569,10 +665,20 @@ var STARTER_COLLECTION_SIGNALS = {
     "blocker",
     "friction",
     "pain",
-    "risk",
-    "constraint",
     "bottleneck",
-    "struggle"
+    "struggle",
+    "missing",
+    "breaks",
+    "regression",
+    "unclear",
+    "no way to",
+    "scope creep",
+    "coupled",
+    "trapped",
+    "ambiguous",
+    "no batch",
+    "undetectable",
+    "coordination gap"
   ],
   glossary: [
     "definition",
@@ -582,28 +688,151 @@ var STARTER_COLLECTION_SIGNALS = {
     "refers to",
     "is called",
     "vocabulary",
-    "terminology"
+    "terminology",
+    "a governance mechanism",
+    "a workspace",
+    "a tracked",
+    "the atom",
+    "the action of",
+    "the versioned",
+    "a field on",
+    "one of the",
+    "a constraint on",
+    "a hard data",
+    "a single"
   ],
   insights: [
     "insight",
     "learned",
     "observed",
-    "pattern",
     "trend",
-    "signal",
     "found that",
-    "evidence"
+    "discovery",
+    "validates",
+    "saturates",
+    "convergence",
+    "signals from",
+    "converge",
+    "TAM"
   ],
   bets: [
-    "bet",
     "appetite",
-    "scope",
-    "elements",
     "rabbit hole",
     "no-go",
-    "shape",
-    "shaping",
-    "done when"
+    "shape up",
+    "done when",
+    "shaping session",
+    "from static",
+    "from storage",
+    "from passive",
+    "the chain learns",
+    "stage-aware",
+    "commit friction",
+    "interactive knowledge",
+    "capture without",
+    "front door",
+    "response envelope",
+    "knowledge organisation",
+    "graveyard",
+    "remote MCP",
+    "coaching service"
+  ],
+  features: [
+    "feature",
+    "capability",
+    "user can",
+    "navigation",
+    "palette",
+    "modal",
+    "smart capture",
+    "suggest-links",
+    "command palette",
+    "auto-commit",
+    "collection-optional",
+    "organisation intelligence",
+    "consolidation"
+  ],
+  architecture: [
+    "architecture",
+    "layer",
+    "data model",
+    "infrastructure",
+    "system design",
+    "L1",
+    "L2",
+    "L3",
+    "L4",
+    "L5",
+    "L6",
+    "L7",
+    "guard infrastructure",
+    "data layer",
+    "intelligence layer",
+    "MCP layer",
+    "core layer"
+  ],
+  "business-rules": [
+    "guard",
+    "enforce",
+    "integrity",
+    "prevents",
+    "excludes",
+    "permitted",
+    "policy",
+    "feature gate",
+    "must not",
+    "only permitted",
+    "closed enum",
+    "write guard",
+    "never imports",
+    "requires active session",
+    "readiness excludes"
+  ],
+  "tracking-events": [
+    "track",
+    "tracking",
+    "analytics",
+    "trigger",
+    "posthog",
+    "instrument",
+    "fires when"
+  ],
+  landscape: [
+    "competitor",
+    "alternative tool",
+    "alternative platform",
+    "competing product",
+    "landscape",
+    "comparison"
+  ],
+  standards: [
+    "standard",
+    "convention",
+    "trunk-based",
+    "alignment-first",
+    "structured bet",
+    "system fixes",
+    "patches"
+  ],
+  principles: [
+    "we believe",
+    "principle",
+    "compounds",
+    "philosophy",
+    "simplicity compounds",
+    "trust through",
+    "evidence over",
+    "compensate for",
+    "honest by default"
+  ],
+  assumptions: [
+    "assume",
+    "assumption",
+    "hypothesis",
+    "untested",
+    "we think",
+    "we assume",
+    "needs validation"
   ]
 };
 function escapeRegExp(text) {
@@ -618,11 +847,12 @@ function countSignalMatches(text, signal) {
   const matches = text.match(regex);
   return matches?.length ?? 0;
 }
-function classifyStarterCollection(name, description) {
-  const text = `${name} ${description}`.toLowerCase();
+var ENTRY_ID_PATTERN = /\b[A-Z]{2,}-\d+\b/g;
+function classifyCollection(name, description) {
+  const text = `${name} ${description}`.replace(ENTRY_ID_PATTERN, "").toLowerCase();
   const rawScores = [];
-  for (const collection of STARTER_COLLECTIONS) {
-    const signals = STARTER_COLLECTION_SIGNALS[collection];
+  for (const collection of CLASSIFIABLE_COLLECTIONS) {
+    const signals = COLLECTION_SIGNALS[collection];
     const reasons = [];
     let score = 0;
     for (const signal of signals) {
@@ -640,8 +870,9 @@ function classifyStarterCollection(name, description) {
   rawScores.sort((a, b) => b.score - a.score);
   const top = rawScores[0];
   const second = rawScores[1];
-  if (!top || top.score <= 0) return null;
+  if (!top || top.score < MIN_SCORE_FLOOR) return null;
   const margin = Math.max(0, top.score - (second?.score ?? 0));
+  if (margin === 0 && top.score <= MIN_SCORE_FLOOR) return null;
   const baseConfidence = Math.min(90, top.score);
   const confidence = Math.min(99, baseConfidence + Math.min(20, margin));
   return {
@@ -665,6 +896,7 @@ function shouldAutoRouteClassification(result) {
 function isClassificationAmbiguous(result) {
   return result.scoreMargin < CLASSIFIER_AMBIGUITY_MARGIN;
 }
+var classifyStarterCollection = classifyCollection;
 
 // src/envelope.ts
 import { z } from "zod";
@@ -935,6 +1167,33 @@ var COMMON_CHECKS = {
     suggestion: () => "Classify this entry with a canonical type for better context assembly. Use update-entry to set canonicalKey."
   }
 };
+var STRATEGY_CATEGORY_INFERENCE_THRESHOLD = 2;
+var STRATEGY_CATEGORY_SIGNALS = [
+  ["business-model", [/pricing/, /revenue/, /unit economics/, /cost structure/, /monetiz/, /margin/, /per.?seat/, /subscription/, /freemium/]],
+  ["vision", [/vision/, /aspirational/, /future state/, /world where/]],
+  ["purpose", [/purpose/, /why we exist/, /mission/, /reason for being/]],
+  ["goal", [/goal/, /metric/, /target/, /kpi/, /okr/, /critical number/, /measur/]],
+  ["principle", [/we believe/, /guiding principle/, /core belief/, /philosophy/]],
+  ["product-area", [/product area/, /module/, /surface/, /capability area/]],
+  ["audience", [/audience/, /persona/, /user segment/, /icp/, /target market/]],
+  ["insight", [/insight/, /we learned/, /we observed/, /pattern/]],
+  ["opportunity", [/opportunity/, /whitespace/, /gap/, /underserved/]]
+];
+function inferStrategyCategory(name, description) {
+  const text = `${name} ${description}`.toLowerCase();
+  let bestCategory = null;
+  let bestScore = 0;
+  for (const [cat, signals] of STRATEGY_CATEGORY_SIGNALS) {
+    const score = signals.reduce((s, rx) => s + (rx.test(text) ? 1 : 0), 0);
+    if (score > bestScore) {
+      bestScore = score;
+      bestCategory = cat;
+    }
+  }
+  if (bestCategory && bestScore >= STRATEGY_CATEGORY_INFERENCE_THRESHOLD) return bestCategory;
+  if (bestScore === 0) return "strategy";
+  return null;
+}
 var PROFILES = /* @__PURE__ */ new Map([
   ["tensions", {
     governedDraft: false,
@@ -1150,6 +1409,11 @@ var PROFILES = /* @__PURE__ */ new Map([
     descriptionField: "description",
     defaults: [],
     recommendedRelationTypes: ["informs", "governs", "belongs_to", "related_to"],
+    inferField: (ctx) => {
+      if (ctx.data?.category) return {};
+      const category = inferStrategyCategory(ctx.name, ctx.description);
+      return category ? { category } : {};
+    },
     qualityChecks: [
       COMMON_CHECKS.clearName,
       COMMON_CHECKS.hasDescription,
@@ -1302,6 +1566,36 @@ var PROFILES = /* @__PURE__ */ new Map([
         suggestion: () => "Describe how this assumption could be tested or validated."
       }
     ]
+  }],
+  ["architecture", {
+    governedDraft: true,
+    descriptionField: "description",
+    defaults: [],
+    recommendedRelationTypes: ["belongs_to", "depends_on", "governs", "references", "related_to"],
+    qualityChecks: [
+      COMMON_CHECKS.clearName,
+      COMMON_CHECKS.hasDescription,
+      COMMON_CHECKS.hasRelations,
+      COMMON_CHECKS.hasType,
+      {
+        id: "has-layer",
+        label: "Architecture layer identified",
+        check: (ctx) => !!ctx.data?.layer && String(ctx.data.layer).length > 0,
+        suggestion: () => "Specify which architecture layer this belongs to (L1-L7)."
+      }
+    ]
+  }],
+  ["landscape", {
+    governedDraft: false,
+    descriptionField: "description",
+    defaults: [],
+    recommendedRelationTypes: ["references", "related_to", "fills_slot"],
+    qualityChecks: [
+      COMMON_CHECKS.clearName,
+      COMMON_CHECKS.hasDescription,
+      COMMON_CHECKS.hasRelations,
+      COMMON_CHECKS.hasType
+    ]
   }]
 ]);
 var FALLBACK_PROFILE = {
@@ -1466,7 +1760,8 @@ var GOVERNED_COLLECTIONS = /* @__PURE__ */ new Set([
   "principles",
   "standards",
   "strategy",
-  "features"
+  "features",
+  "architecture"
 ]);
 var AUTO_LINK_CONFIDENCE_THRESHOLD = 35;
 var MAX_AUTO_LINKS = 5;
@@ -1497,18 +1792,20 @@ var batchCaptureSchema = z2.object({
 var captureClassifierSchema = z2.object({
   enabled: z2.boolean(),
   autoRouted: z2.boolean(),
+  agrees: z2.boolean(),
+  abstained: z2.boolean(),
   topConfidence: z2.number(),
-  // Backward-compatible alias for topConfidence.
   confidence: z2.number(),
   reasons: z2.array(z2.string()),
   candidates: z2.array(
     z2.object({
-      collection: z2.enum(STARTER_COLLECTIONS),
+      collection: z2.enum(CLASSIFIABLE_COLLECTIONS),
       signalScore: z2.number(),
-      // Backward-compatible alias for signalScore.
       confidence: z2.number()
     })
-  )
+  ),
+  agentProvidedCollection: z2.string().optional(),
+  overrideCommand: z2.string().optional()
 });
 function trackClassifierTelemetry(params) {
   const telemetry = {
@@ -1550,12 +1847,12 @@ function buildClassifierUnknownResult() {
       "Could not infer collection from input.",
       "Provide collection explicitly, or rewrite with clearer intent.",
       [{ tool: "collections", description: "List available collections", parameters: { action: "list" } }],
-      { classifier: { enabled: true, autoRouted: false, topConfidence: 0, confidence: 0, candidates: [] } }
+      { classifier: { enabled: true, autoRouted: false, agrees: false, abstained: true, topConfidence: 0, confidence: 0, reasons: [], candidates: [] } }
     )
   };
 }
 function buildProvisionedCollectionSuggestions(candidates) {
-  return candidates.length ? candidates.map((c) => `- \`${c.collection}\` (${c.signalScore}% signal score)`).join("\n") : "- No provisioned starter collection candidates were inferred confidently.";
+  return candidates.length ? candidates.map((c) => `- \`${c.collection}\` (${c.signalScore}% signal score)`).join("\n") : "- No provisioned collection candidates were inferred confidently.";
 }
 function buildUnsupportedProvisioningResult(classified, provisionedCandidates) {
   const suggestions = buildProvisionedCollectionSuggestions(provisionedCandidates);
@@ -1579,6 +1876,8 @@ Correction path: rerun with explicit \`collection\`.`;
         classifier: {
           enabled: true,
           autoRouted: false,
+          agrees: false,
+          abstained: false,
           topConfidence: classified.topConfidence,
           confidence: classified.confidence,
           reasons: classified.reasons,
@@ -1612,17 +1911,17 @@ Correction path: if this was close, rerun with your chosen \`collection\`.`;
     )
   };
 }
-async function getProvisionedStarterCollectionCandidates(classified, supportedStarterCollections) {
+async function getProvisionedCollectionCandidates(classified, supportedCollections) {
   const allCollections = await mcpQuery("chain.listCollections");
-  const provisionedStarterCollections = new Set(
+  const provisionedCollections = new Set(
     (allCollections ?? []).map((collection) => collection.slug).filter(
-      (slug) => supportedStarterCollections.has(slug)
+      (slug) => supportedCollections.has(slug)
     )
   );
   const provisionedCandidates = classified.candidates.filter(
-    (candidate) => provisionedStarterCollections.has(candidate.collection)
+    (candidate) => provisionedCollections.has(candidate.collection)
   );
-  return { provisionedStarterCollections, provisionedCandidates };
+  return { provisionedCollections, provisionedCandidates };
 }
 async function resolveCaptureCollection(params) {
   const {
@@ -1630,17 +1929,60 @@ async function resolveCaptureCollection(params) {
     name,
     description,
     classifierFlagOn,
-    supportedStarterCollections,
+    supportedCollections,
     workspaceId,
     explicitCollectionProvided
   } = params;
   if (collection) {
-    return { resolvedCollection: collection };
+    const classified2 = classifyCollection(name, description);
+    if (classified2) {
+      const agrees = classified2.collection === collection;
+      const classifierMeta2 = {
+        enabled: true,
+        autoRouted: false,
+        agrees,
+        abstained: false,
+        topConfidence: classified2.topConfidence,
+        confidence: classified2.confidence,
+        reasons: classified2.reasons,
+        candidates: classified2.candidates.slice(0, 3),
+        agentProvidedCollection: collection,
+        ...!agrees && {
+          overrideCommand: `capture collection="${classified2.collection}"`
+        }
+      };
+      if (!agrees) {
+        trackClassifierTelemetry({
+          workspaceId,
+          predictedCollection: classified2.collection,
+          confidence: classified2.confidence,
+          autoRouted: false,
+          reasonCategory: "low-confidence",
+          explicitCollectionProvided: true,
+          outcome: "fallback"
+        });
+      }
+      return { resolvedCollection: collection, classifierMeta: classifierMeta2 };
+    }
+    return {
+      resolvedCollection: collection,
+      classifierMeta: {
+        enabled: true,
+        autoRouted: false,
+        agrees: false,
+        abstained: true,
+        topConfidence: 0,
+        confidence: 0,
+        reasons: [],
+        candidates: [],
+        agentProvidedCollection: collection
+      }
+    };
   }
   if (!classifierFlagOn) {
     return { earlyResult: buildCollectionRequiredResult() };
   }
-  const classified = classifyStarterCollection(name, description);
+  const classified = classifyCollection(name, description);
   if (!classified) {
     trackClassifierTelemetry({
       workspaceId,
@@ -1653,8 +1995,8 @@ async function resolveCaptureCollection(params) {
     });
     return { earlyResult: buildClassifierUnknownResult() };
   }
-  const { provisionedStarterCollections, provisionedCandidates } = await getProvisionedStarterCollectionCandidates(classified, supportedStarterCollections);
-  if (!provisionedStarterCollections.has(classified.collection)) {
+  const { provisionedCollections, provisionedCandidates } = await getProvisionedCollectionCandidates(classified, supportedCollections);
+  if (!provisionedCollections.has(classified.collection)) {
     trackClassifierTelemetry({
       workspaceId,
       predictedCollection: classified.collection,
@@ -1673,6 +2015,8 @@ async function resolveCaptureCollection(params) {
   const classifierMeta = {
     enabled: true,
     autoRouted: autoRoute,
+    agrees: true,
+    abstained: false,
     topConfidence: classified.topConfidence,
     confidence: classified.confidence,
     reasons: classified.reasons,
@@ -1711,7 +2055,7 @@ var captureSuccessOutputSchema = z2.object({
   entryId: z2.string(),
   collection: z2.string(),
   name: z2.string(),
-  status: z2.enum(["draft", "committed"]),
+  status: z2.enum(["draft", "committed", "proposed"]),
   qualityScore: z2.number(),
   qualityVerdict: z2.record(z2.unknown()).optional(),
   classifier: captureClassifierSchema.optional(),
@@ -1740,14 +2084,14 @@ var batchCaptureOutputSchema = z2.object({
   })).optional()
 });
 function registerSmartCaptureTools(server) {
-  const supportedStarterCollections = new Set(
-    STARTER_COLLECTIONS.filter((slug) => PROFILES.has(slug))
+  const supportedCollections = new Set(
+    CLASSIFIABLE_COLLECTIONS.filter((slug) => PROFILES.has(slug))
   );
   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 name and description; `collection` is optional when `capture-without-thinking` is enabled.\n\nSupported collections with smart profiles: tensions, business-rules, glossary, decisions, features, audiences, strategy, standards, maps, bets, insights, assumptions, principles, 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\n**Compound capture:** Pass `links` to create relations in the same call (skips auto-link discovery). Pass `autoCommit: true` to promote the entry from draft to SSOT immediately after linking. Governed collections (glossary, business-rules, principles, standards, strategy, features) will warn but still commit \u2014 use only when you're certain.\n\nAlways creates as 'draft' unless `autoCommit` is true. Use `update-entry` for post-creation adjustments.",
+      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 name and description; `collection` is optional when `capture-without-thinking` is enabled.\n\nSupported collections with smart profiles: tensions, business-rules, glossary, decisions, features, audiences, strategy, standards, maps, bets, insights, assumptions, principles, 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\n**Compound capture:** Pass `links` to create relations in the same call (skips auto-link discovery). Pass `autoCommit: true` to promote the entry from draft to SSOT immediately after linking. Governed collections (glossary, business-rules, principles, standards, strategy, features, architecture) will warn but still commit \u2014 use only when you're certain.\n\nAlways creates as 'draft' unless `autoCommit` is true. Use `update-entry` for post-creation adjustments.",
       inputSchema: captureSchema.shape,
       annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
     },
@@ -1765,7 +2109,7 @@ function registerSmartCaptureTools(server) {
         name,
         description,
         classifierFlagOn,
-        supportedStarterCollections,
+        supportedCollections,
         workspaceId: wsCtx.workspaceId,
         explicitCollectionProvided
       });
@@ -1849,10 +2193,10 @@ Or use \`collections action=list\` to see available collections.`
       }
       data[profile.descriptionField || "description"] = description;
       const status = "draft";
+      const agentId = getAgentSessionId();
       let finalEntryId;
       let internalId;
       try {
-        const agentId = getAgentSessionId();
         const result = await mcpMutation("chain.createEntry", {
           collectionSlug: resolvedCollection,
           entryId: entryId ?? void 0,
@@ -1865,7 +2209,6 @@ Or use \`collections action=list\` to see available collections.`
         });
         internalId = result.docId;
         finalEntryId = result.entryId;
-        await recordSessionActivity({ entryCreated: internalId });
       } catch (error) {
         const msg = error instanceof Error ? error.message : String(error);
         if (msg.includes("Duplicate") || msg.includes("already exists")) {
@@ -1921,7 +2264,8 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
             await mcpMutation("chain.createEntryRelation", {
               fromEntryId: finalEntryId,
               toEntryId: c.entryId,
-              type: relationType
+              type: relationType,
+              sessionId: agentId ?? void 0
             });
             linksCreated.push({
               targetEntryId: c.entryId,
@@ -1955,7 +2299,8 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
             await mcpMutation("chain.createEntryRelation", {
               fromEntryId: finalEntryId,
               toEntryId: link.to,
-              type: link.type
+              type: link.type,
+              sessionId: agentId ?? void 0
             });
             userLinkResults.push({ label: `\u2713 ${link.type} \u2192 ${link.to}`, ok: true });
             linksCreated.push({
@@ -2036,9 +2381,15 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
       let commitError = null;
       if (shouldAutoCommit && finalEntryId) {
         try {
-          await mcpMutation("chain.commitEntry", { entryId: finalEntryId });
-          finalStatus = "committed";
-          await recordSessionActivity({ entryModified: internalId });
+          const commitResult = await mcpMutation("chain.commitEntry", {
+            entryId: finalEntryId,
+            author: agentId ? `agent:${agentId}` : void 0,
+            sessionId: agentId ?? void 0
+          });
+          finalStatus = commitResult?.status === "proposal_created" ? "proposed" : "committed";
+          if (finalStatus === "committed") {
+            await recordSessionActivity({ entryModified: internalId });
+          }
         } catch (e) {
           commitError = e instanceof Error ? e.message : "unknown error";
         }
@@ -2048,14 +2399,29 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
         `**${name}** added to \`${resolvedCollection}\` as \`${finalStatus}\``,
         `**Workspace:** ${wsCtx.workspaceSlug} (${wsCtx.workspaceId})`
       ];
-      if (classifierMeta?.autoRouted) {
+      if (classifierMeta) {
         lines.push("");
-        lines.push("## Collection routing");
-        lines.push(`Auto-routed to \`${resolvedCollection}\` (${classifierMeta.topConfidence}% top confidence).`);
-        if (classifierMeta.reasons.length > 0) {
-          lines.push(`Reason: ${classifierMeta.reasons.join("; ")}.`);
+        lines.push("## Classification");
+        if (classifierMeta.abstained) {
+          lines.push(`No classifier coverage for \`${resolvedCollection}\` \u2014 entry accepted as-is.`);
+        } else if (classifierMeta.autoRouted) {
+          lines.push(`Auto-routed to \`${resolvedCollection}\` (${classifierMeta.topConfidence}% confidence).`);
+          if (classifierMeta.reasons.length > 0) {
+            lines.push(`Reason: ${classifierMeta.reasons.join("; ")}.`);
+          }
+          lines.push(`Override: rerun with explicit \`collection\` if wrong.`);
+        } else if (classifierMeta.agrees) {
+          lines.push(`Classifier confirms \`${resolvedCollection}\` (${classifierMeta.topConfidence}% confidence).`);
+        } else {
+          const suggested = classifierMeta.candidates[0]?.collection ?? "unknown";
+          lines.push(`Classifier suggests \`${suggested}\` (${classifierMeta.topConfidence}% confidence) \u2014 review classification.`);
+          if (classifierMeta.reasons.length > 0) {
+            lines.push(`Reason: ${classifierMeta.reasons.join("; ")}.`);
+          }
+          if (classifierMeta.overrideCommand) {
+            lines.push(`Override: \`${classifierMeta.overrideCommand}\``);
+          }
         }
-        lines.push("Correction path: rerun capture with explicit `collection` if this routing is wrong.");
       }
       const appUrl = process.env.PRODUCTBRAIN_APP_URL ?? "https://productbrain.io";
       const studioUrl = resolvedCollection === "bets" ? `${appUrl.replace(/\/$/, "")}/w/${wsCtx.workspaceSlug}/studio/${internalId}` : void 0;
@@ -2088,6 +2454,10 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
         if (GOVERNED_COLLECTIONS.has(resolvedCollection)) {
           lines.push(`_Note: \`${resolvedCollection}\` is a governed collection \u2014 ensure this entry has been reviewed._`);
         }
+      } else if (finalStatus === "proposed") {
+        lines.push("");
+        lines.push(`## Proposal created: ${finalEntryId}`);
+        lines.push(`**${name}** requires consent before it can be committed, so a proposal was created instead of publishing directly.`);
       } else if (commitError) {
         lines.push("");
         lines.push("## Commit failed");
@@ -2142,6 +2512,11 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
         if (failedChecks.length > 0) {
           lines.push(`2. **Improve quality:** \`update-entry entryId="${eid}"\` \u2014 fill missing fields`);
         }
+      } else if (finalStatus === "proposed") {
+        lines.push(`1. **Connect it:** \`graph action=suggest entryId="${eid}"\` \u2014 discover additional links to support the proposal`);
+        if (failedChecks.length > 0) {
+          lines.push(`2. **Improve quality:** \`update-entry entryId="${eid}"\` \u2014 strengthen the entry before approval`);
+        }
       } else {
         if (userLinkResults.length === 0) {
           lines.push(`1. **Connect it:** \`graph action=suggest entryId="${eid}"\` \u2014 discover what this should link to`);
@@ -2166,13 +2541,15 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
       const next = [];
       if (finalStatus === "committed") {
         next.push({ tool: "graph", description: "Discover connections", parameters: { action: "suggest", entryId: finalEntryId } });
+      } else if (finalStatus === "proposed") {
+        next.push({ tool: "graph", description: "Discover connections", parameters: { action: "suggest", entryId: finalEntryId } });
       } else {
         if (userLinkResults.length === 0) {
           next.push({ tool: "graph", description: "Discover links", parameters: { action: "suggest", entryId: finalEntryId } });
         }
         next.push({ tool: "commit-entry", description: "Commit to Chain", parameters: { entryId: finalEntryId } });
       }
-      const summary = finalStatus === "committed" ? `Captured and committed ${finalEntryId} (${name}) to ${resolvedCollection}. Quality ${quality.score}/10.` : `Captured ${finalEntryId} (${name}) as draft in ${resolvedCollection}. Quality ${quality.score}/10.`;
+      const summary = finalStatus === "committed" ? `Captured and committed ${finalEntryId} (${name}) to ${resolvedCollection}. Quality ${quality.score}/10.` : finalStatus === "proposed" ? `Captured ${finalEntryId} (${name}) in ${resolvedCollection} and created a proposal for commit. Quality ${quality.score}/10.` : `Captured ${finalEntryId} (${name}) as draft in ${resolvedCollection}. Quality ${quality.score}/10.`;
       const toolResult = {
         content: [{ type: "text", text: lines.join("\n") }],
         structuredContent: success(
@@ -2301,7 +2678,8 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
                   await mcpMutation("chain.createEntryRelation", {
                     fromEntryId: finalEntryId,
                     toEntryId: c.entryId,
-                    type: relationType
+                    type: relationType,
+                    sessionId: agentId ?? void 0
                   });
                   autoLinkCount++;
                 } catch {
@@ -2311,7 +2689,6 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
             }
           }
           results.push({ name: entry.name, collection: entry.collection, entryId: finalEntryId, ok: true, autoLinks: autoLinkCount });
-          await recordSessionActivity({ entryCreated: internalId });
         } catch (error) {
           const msg = error instanceof Error ? error.message : String(error);
           results.push({ name: entry.name, collection: entry.collection, entryId: "", ok: false, autoLinks: 0, error: msg });
@@ -2613,15 +2990,20 @@ export {
   requireActiveSession,
   requireWriteAccess,
   recoverSessionState,
+  deriveEpistemicStatus,
+  formatEpistemicLine,
+  toEpistemicInput,
   extractPreview,
   translateStaleToolNames,
   initToolSurface,
   trackWriteTool,
   initFeatureFlags,
   CLASSIFIER_AUTO_ROUTE_THRESHOLD,
+  CLASSIFIABLE_COLLECTIONS,
   STARTER_COLLECTIONS,
-  classifyStarterCollection,
+  classifyCollection,
   isClassificationAmbiguous,
+  classifyStarterCollection,
   success,
   failure,
   parseOrFail,
@@ -2631,6 +3013,7 @@ export {
   notFoundResult,
   validationResult,
   withEnvelope,
+  inferStrategyCategory,
   formatQualityReport,
   checkEntryQuality,
   captureSchema,
@@ -2643,4 +3026,4 @@ export {
   formatRubricCoaching,
   formatRubricVerdictSection
 };
-//# sourceMappingURL=chunk-FYFF4QKF.js.map
+//# sourceMappingURL=chunk-ED3KCWZE.js.map