@productbrain/mcp 0.0.1-beta.7300 → 0.0.1-beta.7319

package/dist/{chunk-GMV452CF.js → chunk-ONWBWDTM.js}

@@ -4022,7 +4022,7 @@ async function handleGet(entryId) {
     `# ${e.entryId ? `${e.entryId}: ` : ""}${e.name}`,
     "",
     `**Status:** ${e.status}${e.workflowStatus ? ` / ${e.workflowStatus}` : ""}`,
-    `**Type:** ${e.canonicalKey ?? "untyped"}`
+    `**Collection:** ${e.collectionSlug ?? "unknown"}`
   ];
   if (typeof e.capturedAt === "number") lines.push(`**Captured at:** ${new Date(e.capturedAt).toISOString()}`);
   if (e.origin) {
@@ -4129,7 +4129,7 @@ async function handleBatch(entryIds) {
     lines.push(`## ${entry.entryId ? `${entry.entryId}: ` : ""}${entry.name}`);
     lines.push("");
     lines.push(`**Status:** ${entry.status}${entry.workflowStatus ? ` / ${entry.workflowStatus}` : ""}`);
-    lines.push(`**Type:** ${entry.canonicalKey ?? "untyped"}`);
+    lines.push(`**Collection:** ${entry.collectionSlug ?? "unknown"}`);
     if (typeof entry.capturedAt === "number") {
       lines.push(`**Captured at:** ${new Date(entry.capturedAt).toISOString()}`);
     }
@@ -4308,11 +4308,10 @@ async function handleSearch(server, query, collection, status2) {
     const statusDisplay = e.workflowStatus ? `${e.status} / ${e.workflowStatus}` : e.status;
     const slug = collMap.get(e.collectionId ?? "");
     const colTag = slug ? ` [${slug}]` : "";
-    const typeTag = e.canonicalKey ? ` (${e.canonicalKey})` : "";
     const desc = extractPreview(e.data, 150);
     const preview = desc ? `
   ${desc}` : "";
-    return `- ${id}${e.name} \`${statusDisplay}\`${colTag}${typeTag}${preview}`;
+    return `- ${id}${e.name} \`${statusDisplay}\`${colTag}${preview}`;
   }).join("\n");
   const header = `## Search Result
 
@@ -6313,6 +6312,8 @@ var COLLECTIONS_ACTIONS = [
   "label-apply",
   "label-remove"
 ];
+var STATUS_CATEGORIES = ["draft", "current", "past", "discarded"];
+var statusListEntrySchema = z16.object({ label: z16.string().max(200), category: z16.enum(STATUS_CATEGORIES) });
 var qualityCriterionSchema = z16.object({
   field: z16.string().max(200).describe("Entry data field key this criterion applies to, e.g. 'description', 'owner'"),
   // WP-480 S1: `max_length` — must mirror the Convex rule union, or the tool rejects a
@@ -6330,17 +6331,12 @@ var fieldSchema = z16.object({
   displayHint: z16.enum(["hero", "badge", "meta", "section", "hidden", "inline-meta"]).optional().describe("V2 rendering hint: how the field should be displayed in Cortex"),
   zone: z16.enum(["header", "body", "meta"]).optional().describe("V2 layout zone: where the field appears in the entry view"),
   colorMap: z16.record(z16.string().max(50)).optional().describe("V2 value-to-semantic-color mapping, e.g. { critical: 'danger', low: 'success' }"),
-  // ENT-61
   accentSource: z16.boolean().optional().describe("When true, this field's colorMap value drives the card-level accent styling"),
-  // ENT-61
   iconMap: z16.record(z16.string(), z16.string().max(50)).optional().describe("Maps field values to icons (emoji/symbol), prepended to badge text"),
   helpText: z16.string().max(2e3).optional().describe("Help text shown in editors and describe output"),
   optionDescriptions: z16.record(z16.string().max(500)).optional().describe("Per-option guidance for select fields"),
-  // BET-136
   semanticRole: z16.enum(["problem", "appetite", "elements", "architecture", "done_when", "risks", "exclusions"]).optional().describe("Semantic role for schema-driven consumers \u2014 enables field-key-independent validation and rendering"),
-  // BET-196
   maxLength: z16.number().optional().describe("Maximum character length for field values. Three-tier resolution: explicit > displayHint > type fallback."),
-  // BET-196
   minLength: z16.number().optional().describe("Minimum character length for field values. Only explicit \u2014 no defaults.")
 });
 var collectionsSchema = z16.object({
@@ -6356,20 +6352,15 @@ var collectionsSchema = z16.object({
   fields: z16.array(fieldSchema).max(200).optional().describe("Field definitions for create, or replacement schema for update (replaces all fields)"),
   axis: z16.enum(["work", "none", "pending"]).optional().describe("REQUIRED for create: 'work' (needs stageLabelMap + validWorkflowStatuses), 'none', or 'pending'. For update: only settable on a non-system-stratum (custom) collection \u2014 the repair path for a legacy collection that predates the axis contract."),
   stageLabelMap: z16.record(z16.string(), z16.enum(["open", "in_progress", "done", "stopped", "tag"])).optional().describe("Required when axis is 'work': maps each valid workflowStatus to a canonical stage."),
-  // ENT-62
   defaultCanonicalKey: z16.string().max(200).optional().describe("The canonical_key entries in this collection default to (e.g. 'decision', 'insight'). Consumers read from collection doc; code map is fallback."),
-  // ENT-67
   defaultWorkflowStatus: z16.string().max(200).optional().describe("Default workflowStatus for new entries. Must be in validWorkflowStatuses when set (e.g. 'hypothesis' for insights)."),
-  // ENT-65
   validWorkflowStatuses: z16.array(z16.string().max(200)).max(50).optional().describe("The allowed workflowStatus values for entries in this collection. New entries are validated against this list. Empty array means no constraint."),
   // ENT-65, FEAT-200
   classificationCheck: z16.string().max(500).optional().describe("LLM decision-tree check for this collection (3\u2013500 chars). Guides the classifier in routing entries here."),
-  // ENT-65, FEAT-200
   classificationPriority: z16.number().optional().describe("Classifier priority (1\u20139, lower = higher priority). Used with classificationCheck to order the decision tree."),
-  // FEAT-301 Slice 2: quality gate criteria and usage guidance.
-  // FEAT-257
   qualityCriteria: z16.array(qualityCriterionSchema).max(50).optional().describe("Per-collection accept gate rules. 'required' rule hard-blocks accepts on empty fields; 'min_length'/'pattern' rules warn. Pass an empty array to clear all criteria."),
   usageGuidance: z16.string().max(2e4).optional().describe("Plain-text guidance shown to agents and users: when to use this collection, when not to, and what makes a good entry."),
+  statusList: z16.array(statusListEntrySchema).max(50).optional().describe(`Ordered status vocabulary: {label, category}[] (draft/current/past/discarded); draft first, exactly one 'discarded' labeled "discarded", labels unique. Re-validated server-side.`),
   // For label-*
   color: z16.string().max(50).optional().describe("For label-create/label-update: hex color, e.g. '#ef4444'."),
   parentSlug: z16.string().max(200).optional().describe("For label-create: parent group slug for label hierarchy."),
@@ -6397,7 +6388,8 @@ var collectionsUpdateVariant = z16.object({
   classificationCheck: z16.string().max(500).optional(),
   classificationPriority: z16.number().optional(),
   qualityCriteria: z16.array(qualityCriterionSchema).optional(),
-  usageGuidance: z16.string().max(2e4).optional()
+  usageGuidance: z16.string().max(2e4).optional(),
+  statusList: z16.array(statusListEntrySchema).optional()
 });
 var collectionsAuditVariant = z16.object({ action: z16.literal("audit") });
 var collectionsExportVariant = z16.object({ action: z16.literal("export") });
@@ -6440,7 +6432,7 @@ var collectionsActionUnion = z16.discriminatedUnion("action", [
 var COLLECTIONS_ACTION_SPECS = {
   list: { params: [], description: "Browse all collections; no params." },
   describe: { params: ["slug"], description: "slug is required." },
-  update: { params: ["slug", "name", "description", "purpose", "icon", "navGroup", "fields", "axis", "stageLabelMap", "defaultCanonicalKey", "defaultWorkflowStatus", "validWorkflowStatuses", "classificationCheck", "classificationPriority", "qualityCriteria", "usageGuidance"], description: "slug is required; at least one other field must be provided. axis/stageLabelMap are only settable on a non-system-stratum collection (the repair path for a legacy custom collection missing its axis declaration)." },
+  update: { params: ["slug", "name", "description", "purpose", "icon", "navGroup", "fields", "axis", "stageLabelMap", "defaultCanonicalKey", "defaultWorkflowStatus", "validWorkflowStatuses", "classificationCheck", "classificationPriority", "qualityCriteria", "usageGuidance", "statusList"], description: "slug is required; at least one other field must be provided. axis/stageLabelMap are only settable on a non-system-stratum collection (the repair path for a legacy custom collection missing its axis declaration)." },
   audit: { params: [], description: "Health report for all collections; no params." },
   export: { params: [], description: "Full system_collection_definitions export; no params. Admin only." },
   "label-list": { params: [], description: "List all labels; no params." },
@@ -6455,9 +6447,9 @@ function registerCollectionsTools(server) {
     list: () => handleList2(),
     describe: (data) => handleDescribe(data.slug),
     update: (data) => {
-      const hasChanges = data.name || data.description || data.purpose || data.icon || data.navGroup || data.fields || data.axis !== void 0 || data.stageLabelMap !== void 0 || data.defaultCanonicalKey !== void 0 || data.defaultWorkflowStatus !== void 0 || data.validWorkflowStatuses !== void 0 || data.classificationCheck !== void 0 || data.classificationPriority !== void 0 || data.qualityCriteria !== void 0 || data.usageGuidance !== void 0;
+      const hasChanges = data.name || data.description || data.purpose || data.icon || data.navGroup || data.fields || data.axis !== void 0 || data.stageLabelMap !== void 0 || data.defaultCanonicalKey !== void 0 || data.defaultWorkflowStatus !== void 0 || data.validWorkflowStatuses !== void 0 || data.classificationCheck !== void 0 || data.classificationPriority !== void 0 || data.qualityCriteria !== void 0 || data.usageGuidance !== void 0 || data.statusList;
       if (!hasChanges) {
-        return Promise.resolve(validationResult("Provide at least one field to update (name, description, purpose, icon, navGroup, fields, axis, stageLabelMap, defaultCanonicalKey, defaultWorkflowStatus, validWorkflowStatuses, classificationCheck, classificationPriority, qualityCriteria, or usageGuidance)."));
+        return Promise.resolve(validationResult("Provide at least one field to update (name, description, purpose, icon, navGroup, fields, axis, stageLabelMap, defaultCanonicalKey, defaultWorkflowStatus, validWorkflowStatuses, classificationCheck, classificationPriority, qualityCriteria, usageGuidance, or statusList)."));
       }
       return handleUpdate(
         data.slug,
@@ -6467,7 +6459,7 @@ function registerCollectionsTools(server) {
         data.icon,
         data.navGroup,
         data.fields,
-        { axis: data.axis, stageLabelMap: data.stageLabelMap, defaultCanonicalKey: data.defaultCanonicalKey, defaultWorkflowStatus: data.defaultWorkflowStatus, validWorkflowStatuses: data.validWorkflowStatuses, classificationCheck: data.classificationCheck, classificationPriority: data.classificationPriority, qualityCriteria: data.qualityCriteria, usageGuidance: data.usageGuidance }
+        { axis: data.axis, stageLabelMap: data.stageLabelMap, defaultCanonicalKey: data.defaultCanonicalKey, defaultWorkflowStatus: data.defaultWorkflowStatus, validWorkflowStatuses: data.validWorkflowStatuses, classificationCheck: data.classificationCheck, classificationPriority: data.classificationPriority, qualityCriteria: data.qualityCriteria, usageGuidance: data.usageGuidance, statusList: data.statusList }
       );
     },
     audit: () => handleAudit(),
@@ -6483,7 +6475,7 @@ function registerCollectionsTools(server) {
     "collections",
     {
       title: "Collections",
-      description: "Manage knowledge collections and workspace labels. Eleven 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- **update**: Update an existing collection's name, description, purpose, icon, navGroup, fields, or (non-system collections only) axis/stageLabelMap. Only provide the fields you want to change. Creating a NEW collection is not offered here \u2014 ask a platform admin to provision it, or enable the module ontology pack that owns the drawer.\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, governanceFunction, etc.). Admin only.\n- **label-list/label-create/label-update/label-delete/label-apply/label-remove**: manage workspace labels (absorbs the `labels` tool) \u2014 list all labels, create/update/delete a label, or apply/remove a label on an entry. Labels can be applied to any entry across any collection for cross-domain filtering.",
+      description: "Manage knowledge collections and workspace labels. Eleven 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- **update**: Update an existing collection's name, description, purpose, icon, navGroup, fields, statusList, or (non-system collections only) axis/stageLabelMap. Only provide the fields you want to change. Creating a NEW collection is not offered here \u2014 ask a platform admin to provision it, or enable the module ontology pack that owns the drawer.\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, governanceFunction, etc.). Admin only.\n- **label-list/label-create/label-update/label-delete/label-apply/label-remove**: manage workspace labels (absorbs the `labels` tool) \u2014 list all labels, create/update/delete a label, or apply/remove a label on an entry. Labels can be applied to any entry across any collection for cross-domain filtering.",
       inputSchema: collectionsSchema,
       annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false }
     },
@@ -6538,6 +6530,12 @@ Valid \`workflowStatus\` values for entries in this collection:
 ${col.validWorkflowStatuses.map((s) => `- ${s}`).join("\n")}`
     );
   }
+  if (col.statusList && col.statusList.length > 0) {
+    sections.push(`
+## Status Vocabulary
+
+${col.statusList.map((s) => `- \`${s.label}\` \u2192 ${s.category}`).join("\n")}`);
+  }
   if (col.fields.length > 0) {
     const fieldDocs = col.fields.map((f) => {
       const parts = [];
@@ -6587,6 +6585,8 @@ ${refList}`);
         usageGuidance: col.usageGuidance ?? null,
         // WP-480 S2: null = unconstrained by design (STD-34), not "unknown".
         validWorkflowStatuses: col.validWorkflowStatuses && col.validWorkflowStatuses.length > 0 ? col.validWorkflowStatuses : null,
+        statusList: col.statusList && col.statusList.length > 0 ? col.statusList : null,
+        // T2: same null-means-undeclared posture
         fieldCount: col.fields.length,
         fields: col.fields.map((f) => ({
           key: f.key,
@@ -6660,7 +6660,7 @@ async function handleUpdate(slug, name, description, purpose, icon, navGroup, fi
   invalidateCollectionCacheForScope();
   invalidateProfileCacheForScope();
   invalidateHubCacheForScope();
-  const changes = [name && "name", description && "description", purpose && "purpose", icon && "icon", navGroup && "navGroup", fields && "fields", meta.axis !== void 0 && "axis", meta.stageLabelMap !== void 0 && "stageLabelMap", meta.defaultCanonicalKey !== void 0 && "defaultCanonicalKey", meta.defaultWorkflowStatus !== void 0 && "defaultWorkflowStatus", meta.validWorkflowStatuses !== void 0 && "validWorkflowStatuses", meta.classificationCheck !== void 0 && "classificationCheck", meta.classificationPriority !== void 0 && "classificationPriority", meta.qualityCriteria !== void 0 && "qualityCriteria", meta.usageGuidance !== void 0 && "usageGuidance"].filter(Boolean).join(", ");
+  const changes = [name && "name", description && "description", purpose && "purpose", icon && "icon", navGroup && "navGroup", fields && "fields", meta.axis !== void 0 && "axis", meta.stageLabelMap !== void 0 && "stageLabelMap", meta.defaultCanonicalKey !== void 0 && "defaultCanonicalKey", meta.defaultWorkflowStatus !== void 0 && "defaultWorkflowStatus", meta.validWorkflowStatuses !== void 0 && "validWorkflowStatuses", meta.classificationCheck !== void 0 && "classificationCheck", meta.classificationPriority !== void 0 && "classificationPriority", meta.qualityCriteria !== void 0 && "qualityCriteria", meta.usageGuidance !== void 0 && "usageGuidance", meta.statusList !== void 0 && "statusList"].filter(Boolean).join(", ");
   return {
     content: [{
       type: "text",
@@ -14224,28 +14224,12 @@ All entries: \`draft\` | \`active\` | \`deprecated\` | \`archived\`
 - \`data\` param is merged (not replaced) \u2014 safe for partial updates
 `;
 
-// src/resources/index.ts
-var MODULE_DIR = dirname(fileURLToPath(import.meta.url));
-var UI_VIEW_BASE_CANDIDATES = [
-  resolve4(MODULE_DIR, "views"),
-  resolve4(MODULE_DIR, "..", "views"),
-  resolve4(MODULE_DIR, "..", "..", "dist", "views"),
-  resolve4(MODULE_DIR, "..", "..", "..", "mcp-views", "dist")
-];
-function formatEntryMarkdown(entry) {
-  const id = entry.entryId ? `${entry.entryId}: ` : "";
-  const lines = [`## ${id}${entry.name} [${entry.status}]`];
-  if (entry.data && typeof entry.data === "object") {
-    for (const [key, val] of Object.entries(entry.data)) {
-      if (val && key !== "rawData") {
-        lines.push(`**${key}**: ${typeof val === "string" ? val : JSON.stringify(val)}`);
-      }
-    }
-  }
-  return lines.join("\n");
-}
-function buildOrientationMarkdown(collections, standards, businessRules, principles) {
+// src/resources/orientationMarkdown.ts
+function buildOrientationMarkdown(collections, standards, businessRules, principles, directionLines) {
   const sections = ["# Product Brain \u2014 Orientation"];
+  if (directionLines && directionLines.length > 0) {
+    sections.push(directionLines.join("\n"));
+  }
   sections.push(
     "## About Product Brain (PB)\nPB is a knowledge management system used by many product teams. This section describes how PB works \u2014 not your product.\n\n### How PB Organizes Its Tools\n- **Tools** = actions with side-effects or dynamic computation (capture, accept, search).\n- **Resources** = stable, read-only data (orientation, terminology, collection schemas).\n- **Prompts** = multi-step choreography (workflows, guided capture, deep dives).\n- Every tool, resource, and prompt works for ANY workspace \u2014 no bespoke logic.\n- Resource templates (URI params) serve workspace-specific data through generic patterns.\n- Compound tools with `action` enums keep the tool count minimal.\n\n" + DATA_HANDLING_SECTION
   );
@@ -14336,6 +14320,47 @@ Use \`entries action=update\` for post-creation adjustments (status changes, fie
   );
   return sections.join("\n\n---\n\n");
 }
+async function buildOrientationResourceText(kernelQuery2) {
+  const [collectionsResult, standardsResult, rulesResult, principlesResult, orientViewResult] = await Promise.allSettled([
+    kernelQuery2("chain.listCollections"),
+    kernelQuery2("chain.listEntries", { collectionSlug: "standards" }),
+    kernelQuery2("chain.listEntries", { collectionSlug: "business-rules" }),
+    kernelQuery2("chain.listEntries", { collectionSlug: "principles" }),
+    kernelQuery2("chain.getOrientView", {
+      tier: "summary",
+      renderMode: "json",
+      invocationPath: "unknown"
+    })
+  ]);
+  const collections = collectionsResult.status === "fulfilled" ? collectionsResult.value : null;
+  const standards = standardsResult.status === "fulfilled" ? standardsResult.value : null;
+  const businessRules = rulesResult.status === "fulfilled" ? rulesResult.value : null;
+  const principles = principlesResult.status === "fulfilled" ? principlesResult.value : null;
+  const orientView = orientViewResult.status === "fulfilled" ? orientViewResult.value : null;
+  const directionLines = buildDirectionLines(orientView);
+  return buildOrientationMarkdown(collections, standards, businessRules, principles, directionLines);
+}
+
+// src/resources/index.ts
+var MODULE_DIR = dirname(fileURLToPath(import.meta.url));
+var UI_VIEW_BASE_CANDIDATES = [
+  resolve4(MODULE_DIR, "views"),
+  resolve4(MODULE_DIR, "..", "views"),
+  resolve4(MODULE_DIR, "..", "..", "dist", "views"),
+  resolve4(MODULE_DIR, "..", "..", "..", "mcp-views", "dist")
+];
+function formatEntryMarkdown(entry) {
+  const id = entry.entryId ? `${entry.entryId}: ` : "";
+  const lines = [`## ${id}${entry.name} [${entry.status}]`];
+  if (entry.data && typeof entry.data === "object") {
+    for (const [key, val] of Object.entries(entry.data)) {
+      if (val && key !== "rawData") {
+        lines.push(`**${key}**: ${typeof val === "string" ? val : JSON.stringify(val)}`);
+      }
+    }
+  }
+  return lines.join("\n");
+}
 function registerResources(server) {
   server.resource(
     "agent-cheatsheet",
@@ -14351,35 +14376,9 @@ function registerResources(server) {
   server.resource(
     "chain-orientation",
     "productbrain://orientation",
-    async (uri) => {
-      const [collectionsResult, standardsResult, rulesResult, principlesResult] = await Promise.allSettled([
-        kernelQuery("chain.listCollections"),
-        kernelQuery("chain.listEntries", { collectionSlug: "standards" }),
-        kernelQuery("chain.listEntries", { collectionSlug: "business-rules" }),
-        kernelQuery("chain.listEntries", { collectionSlug: "principles" })
-      ]);
-      const collections = collectionsResult.status === "fulfilled" ? collectionsResult.value : null;
-      const standards = standardsResult.status === "fulfilled" ? standardsResult.value : null;
-      const businessRules = rulesResult.status === "fulfilled" ? rulesResult.value : null;
-      const principles = principlesResult.status === "fulfilled" ? principlesResult.value : null;
-      return {
-        contents: [{
-          uri: uri.href,
-          // `chain.listEntries`'s real return is a union (raw EntryDoc[] vs Record<string,
-          // unknown>[] depending on field projection, see wrapup.ts's own doc comment on this
-          // recurring residual) — `EntryListItem` only reads a documented subset of fields
-          // present on both union branches; cast rather than widen the render helper's
-          // signature to the full server union (PR #395, Lane C S3b annotation pass).
-          text: buildOrientationMarkdown(
-            collections,
-            standards,
-            businessRules,
-            principles
-          ),
-          mimeType: "text/markdown"
-        }]
-      };
-    }
+    async (uri) => ({
+      contents: [{ uri: uri.href, text: await buildOrientationResourceText(kernelQuery), mimeType: "text/markdown" }]
+    })
   );
   server.resource(
     "chain-terminology",
@@ -14991,4 +14990,4 @@ export {
   createProductBrainServer,
   initFeatureFlags
 };
-//# sourceMappingURL=chunk-GMV452CF.js.map
+//# sourceMappingURL=chunk-ONWBWDTM.js.map