@productbrain/mcp 0.0.1-beta.149 → 0.0.1-beta.150

package/dist/{chunk-H7XBZ4H3.js → chunk-ML7BPLBX.js}

@@ -6,14 +6,21 @@ import {
   trackCaptureQualityHints,
   trackCaptureRelationSuggestions,
   trackChainEntryCommitted,
+  trackCollectionClassified,
+  trackFieldGuidanceApplied,
+  trackFieldQualityWarning,
   trackKnowledgeGap,
   trackQualityCheck,
   trackQualityVerdict,
   trackToolCall
-} from "./chunk-MOPOQUJP.js";
+} from "./chunk-X3S5UTTZ.js";
 
 // src/auth.ts
 import { AsyncLocalStorage } from "async_hooks";
+import { createHash } from "crypto";
+function hashKey(key) {
+  return createHash("sha256").update(key).digest("hex").slice(0, 16);
+}
 var requestStore = new AsyncLocalStorage();
 function runWithAuth(auth, fn) {
   return requestStore.run(auth, fn);
@@ -996,6 +1003,21 @@ var FIELD_TYPE_DEFAULTS = {
   "date": null
 };
 
+// src/lib/formatFieldGuidance.ts
+function formatFieldGuidance(fields) {
+  const guidedFields = fields.filter((f) => f.writingGuidance);
+  if (guidedFields.length === 0) return "";
+  const lines = ["## Writing Guidance"];
+  for (const field of guidedFields) {
+    const displayName = field.label || field.key;
+    lines.push(`- ${displayName}: ${field.writingGuidance}`);
+    if (field.writingExamples && field.writingExamples.length > 0) {
+      lines.push(`  Examples: ${field.writingExamples.join(" | ")}`);
+    }
+  }
+  return lines.join("\n");
+}
+
 // src/lib/collectionCache.ts
 var cachedCollections = null;
 var cachedBySlug = null;
@@ -1908,6 +1930,20 @@ function buildClassifierMeta(resolved, overrides = {}) {
     ...overrides
   };
 }
+function emitClassificationTelemetry(resolved, workspaceId, opts) {
+  const topAlt = resolved.alternatives?.[0] ?? null;
+  trackCollectionClassified(workspaceId, {
+    collection_slug: resolved.collection,
+    thinking_layer: resolved.thinkingLayer ?? null,
+    confidence: resolved.confidence,
+    classified_by: resolved.classifiedBy,
+    confidence_tier: resolved.tier,
+    alternative_slug: topAlt?.collection ?? null,
+    alternative_confidence: topAlt?.confidence ?? null,
+    explicit_collection_provided: opts.explicitCollectionProvided,
+    auto_routed: opts.autoRouted
+  });
+}
 async function resolveCaptureCollection(params) {
   const {
     collection,
@@ -1929,6 +1965,10 @@ async function resolveCaptureCollection(params) {
           overrideCommand: `capture collection="${resolved2.collection}"`
         }
       });
+      emitClassificationTelemetry(resolved2, workspaceId, {
+        explicitCollectionProvided: true,
+        autoRouted: false
+      });
       if (!agrees) {
         trackClassifierTelemetry({
           workspaceId,
@@ -1975,6 +2015,10 @@ async function resolveCaptureCollection(params) {
   }
   const autoRoute = resolved.tier !== "low";
   const classifierMeta = buildClassifierMeta(resolved, { autoRouted: autoRoute });
+  emitClassificationTelemetry(resolved, workspaceId, {
+    explicitCollectionProvided,
+    autoRouted: autoRoute
+  });
   if (!autoRoute) {
     trackClassifierTelemetry({
       workspaceId,
@@ -2260,7 +2304,8 @@ Or use \`collections action=list\` to see available collections.`
       const colMeta = await getCollectionBySlug(resolvedCollection);
       const isBetCapture = canonicalKey === "work_package" || colMeta?.defaultCanonicalKey === "work_package";
       let entryWarnings = [];
-      const shouldDecompose = (resolvedCollection === "strategy" || isBetCapture) && description.trim().length > 0;
+      const isStrategyCapture = colMeta?.thinkingLayer === "strategy";
+      const shouldDecompose = (isStrategyCapture || isBetCapture) && description.trim().length > 0;
       if (shouldDecompose) {
         try {
           const decomposed = await mcpCall(
@@ -2270,7 +2315,8 @@ Or use \`collections action=list\` to see available collections.`
               entryName: name,
               description,
               existingData: data,
-              ...isBetCapture ? { canonicalKey: "work_package" } : {}
+              ...isBetCapture ? { canonicalKey: "work_package" } : {},
+              ...colMeta?.thinkingLayer ? { thinkingLayer: colMeta.thinkingLayer } : {}
             }
           );
           if (decomposed?.decomposed) {
@@ -2630,6 +2676,16 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
         lines.push("");
         lines.push(`_To improve: \`update-entry entryId="${finalEntryId}"\` to fill missing fields._`);
       }
+      const fieldGuidanceSection = formatFieldGuidance(col.fields ?? []);
+      if (fieldGuidanceSection) {
+        lines.push("");
+        lines.push(fieldGuidanceSection);
+        const guidedFieldCount = (col.fields ?? []).filter((f) => f.writingGuidance).length;
+        trackFieldGuidanceApplied(wsCtx.workspaceId, {
+          collection: resolvedCollection,
+          guided_field_count: guidedFieldCount
+        });
+      }
       if (formativeHints.length > 0) {
         lines.push("");
         lines.push("## Quality Hints (advisory)");
@@ -2852,6 +2908,12 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
           classifiedBy = "explicit";
         } else {
           const resolved = classificationMap.get(entryIdx);
+          if (resolved) {
+            emitClassificationTelemetry(resolved, wsCtx.workspaceId, {
+              explicitCollectionProvided: false,
+              autoRouted: resolved.tier !== "low"
+            });
+          }
           if (!resolved || resolved.tier === "low") {
             skippedLowConfidence.push({
               index: entryIdx,
@@ -2933,7 +2995,8 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
           }
         }
         const batchIsBet = resolvedSlug === "work-packages" || entry.canonicalKey === "work_package";
-        const shouldDecomposeBatch = (resolvedSlug === "strategy" || batchIsBet) && entry.description?.trim();
+        const batchIsStrategy = col?.thinkingLayer === "strategy";
+        const shouldDecomposeBatch = (batchIsStrategy || batchIsBet) && entry.description?.trim();
         let batchDecomposeWarning;
         if (shouldDecomposeBatch) {
           try {
@@ -2944,7 +3007,8 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
                 entryName: entry.name,
                 description: entry.description,
                 existingData: data,
-                ...batchIsBet ? { canonicalKey: "work_package" } : {}
+                ...batchIsBet ? { canonicalKey: "work_package" } : {},
+                ...col?.thinkingLayer ? { thinkingLayer: col.thinkingLayer } : {}
               }
             );
             if (decomposed?.decomposed) {
@@ -3855,6 +3919,20 @@ ${formatted}` }],
           }
         }
       }
+      const guidanceWarnings = result?.guidanceWarnings;
+      if (guidanceWarnings && guidanceWarnings.length > 0) {
+        lines.push("");
+        lines.push("## Field Guidance Warnings (advisory)");
+        for (const w of guidanceWarnings) {
+          lines.push(`- **${w.field}:** ${w.message}`);
+        }
+        lines.push(`_These are advisory \u2014 the entry was committed. Use \`update-entry entryId="${entryId}"\` to address them._`);
+        const uniqueTypes = [...new Set(guidanceWarnings.map((w) => w.warningType))];
+        trackFieldQualityWarning(wsCtx.workspaceId, {
+          warning_count: guidanceWarnings.length,
+          warning_types: uniqueTypes
+        });
+      }
       const epistemic = deriveEpistemicStatus(toEpistemicInput(entry));
       if (epistemic && (epistemic.level === "hypothesis" || epistemic.level === "untested")) {
         lines.push("");
@@ -5930,7 +6008,7 @@ function formatTimeAgo(ms) {
 
 // src/tools/collections.ts
 import { z as z8 } from "zod";
-var COLLECTIONS_ACTIONS = ["list", "create", "update", "describe", "audit"];
+var COLLECTIONS_ACTIONS = ["list", "create", "update", "describe", "audit", "export"];
 var qualityCriterionSchema = z8.object({
   field: z8.string().describe("Entry data field key this criterion applies to, e.g. 'description', 'owner'"),
   rule: z8.enum(["required", "min_length", "pattern"]).describe("'required': field must be non-empty (blocks commit). 'min_length': minimum string length (warns). 'pattern': regex match (warns)."),
@@ -5956,7 +6034,7 @@ var fieldSchema = z8.object({
 });
 var collectionsSchema = z8.object({
   action: z8.enum(COLLECTIONS_ACTIONS).describe(
-    "'list': browse all collections. 'create': create a new collection. 'update': update an existing collection. 'describe': full documentation for one collection \u2014 fields, option guides, usage guidance, examples. 'audit': health report for all collections \u2014 missing classification, icon, displayHint coverage, and field schema gaps."
+    "'list': browse all collections. 'create': create a new collection. 'update': update an existing collection. 'describe': full documentation for one collection \u2014 fields, option guides, usage guidance, examples. 'audit': health report for all collections \u2014 missing classification, icon, displayHint coverage, and field schema gaps. 'export': full system_collection_definitions export with classification metadata (thinkingLayer, classificationPriority, classificationCheck, classificationSignals, governanceRole, timelineRole, canBeElementOf, descriptionFieldKey). Admin only."
   ),
   slug: z8.string().optional().describe("URL-safe identifier for create/update, e.g. 'glossary', 'tech-debt'"),
   name: z8.string().optional().describe("Display name for create, or new name for update"),
@@ -5979,7 +6057,7 @@ function registerCollectionsTools(server) {
     "collections",
     {
       title: "Collections",
-      description: "Manage knowledge collections. Four actions:\n\n- **list**: Browse all collections \u2014 glossary, business rules, tracking events, etc. Returns slug, name, description, and field schema. Use before capture to see what exists.\n- **describe**: Full documentation for a single collection. Returns field help text, option decision guides, usage guidance, examples, and cross-references. Use when you need to understand a collection's purpose, field semantics, or option values.\n- **create**: Create a new collection. Provide slug, name, and field schema. Use when setting up a workspace or tracking a new type of knowledge.\n- **update**: Update an existing collection's name, description, purpose, icon, navGroup, or fields. Only provide the fields you want to change.\n- **audit**: Health report for all workspace collections. Checks classification metadata, icon presence, displayHint coverage per field, and field schema gaps vs system definitions. Returns total collections, count with issues, and per-collection issue list.",
+      description: "Manage knowledge collections. Four actions:\n\n- **list**: Browse all collections \u2014 glossary, business rules, tracking events, etc. Returns slug, name, description, and field schema. Use before capture to see what exists.\n- **describe**: Full documentation for a single collection. Returns field help text, option decision guides, usage guidance, examples, and cross-references. Use when you need to understand a collection's purpose, field semantics, or option values.\n- **create**: Create a new collection. Provide slug, name, and field schema. Use when setting up a workspace or tracking a new type of knowledge.\n- **update**: Update an existing collection's name, description, purpose, icon, navGroup, or fields. Only provide the fields you want to change.\n- **audit**: Health report for all workspace collections. Checks classification metadata, icon presence, displayHint coverage per field, and field schema gaps vs system definitions. Returns total collections, count with issues, and per-collection issue list.\n- **export**: Full system_collection_definitions export as JSON. Includes all classification metadata (thinkingLayer, classificationPriority, classificationCheck, timelineRole, governanceRole, etc.). Admin only.",
       inputSchema: collectionsSchema,
       annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false }
     },
@@ -6016,6 +6094,9 @@ function registerCollectionsTools(server) {
         if (action === "audit") {
           return handleAudit();
         }
+        if (action === "export") {
+          return handleExport();
+        }
         return unknownAction(action, COLLECTIONS_ACTIONS);
       });
     })
@@ -6282,6 +6363,16 @@ All collections are healthy.`);
     )
   };
 }
+async function handleExport() {
+  const definitions = await mcpQuery("chain.exportDefinitions");
+  return {
+    content: [{ type: "text", text: JSON.stringify(definitions, null, 2) }],
+    structuredContent: success(
+      `Exported ${definitions.length} system collection definitions with full classification metadata.`,
+      { definitions, total: definitions.length }
+    )
+  };
+}
 
 // src/tools/labels.ts
 import { z as z9 } from "zod";
@@ -15214,6 +15305,7 @@ function createProductBrainServer() {
 }
 
 export {
+  hashKey,
   runWithAuth,
   getAgentSessionId,
   startAgentSession,
@@ -15226,4 +15318,4 @@ export {
   SERVER_VERSION,
   createProductBrainServer
 };
-//# sourceMappingURL=chunk-H7XBZ4H3.js.map
+//# sourceMappingURL=chunk-ML7BPLBX.js.map