@productbrain/mcp 0.0.1-beta.137 → 0.0.1-beta.139

package/dist/{chunk-YKDHYK3Q.js → chunk-CDBSOVW7.js}

@@ -1701,7 +1701,9 @@ var batchCaptureSchema = z2.object({
     description: z2.string().describe("Full context / definition"),
     entryId: entryIdSchema,
     data: z2.record(z2.unknown()).optional().describe("Explicit field values (e.g. urgency, status, assignee). Merged with inferred values; user-provided wins."),
-    canonicalKey: z2.string().optional().describe("Semantic type (e.g. 'decision', 'tension', 'work_package'). Enables work-package redirect in createEntry when collection is 'chains'.")
+    canonicalKey: z2.string().optional().describe("Semantic type (e.g. 'decision', 'tension', 'work_package'). Enables work-package redirect in createEntry when collection is 'chains'."),
+    sourceRef: z2.string().optional().describe("URI or path of the source document backing this entry (e.g. 'meeting-2026-03-28.md', 'import://batch-5'). Stored as top-level entry field, not in data."),
+    sourceExcerpt: z2.string().optional().describe("Verbatim excerpt from the source that backs this entry's claims. Stored as top-level entry field, not in data.")
   })).min(1).max(50).describe("Array of entries to capture"),
   autoCommit: z2.boolean().optional().describe(
     "If true, commits created entries immediately after linking. If omitted, Open mode workspaces commit by default and consensus/role modes stay draft-first."
@@ -2878,7 +2880,9 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
             data,
             createdBy,
             sessionId: agentId ?? void 0,
-            canonicalKey: entry.canonicalKey ?? void 0
+            canonicalKey: entry.canonicalKey ?? void 0,
+            ...entry.sourceRef ? { sourceRef: entry.sourceRef } : {},
+            ...entry.sourceExcerpt ? { sourceExcerpt: entry.sourceExcerpt } : {}
           });
           const internalId = result.docId;
           const finalEntryId = result.entryId;
@@ -3457,7 +3461,9 @@ var updateEntrySchema = z3.object({
   order: z3.number().optional().describe("New sort order"),
   canonicalKey: z3.string().optional().describe("Semantic type (e.g. 'decision', 'tension'). Only changeable on draft/uncommitted entries."),
   autoPublish: z3.boolean().optional().default(false).describe("Only true when user explicitly asks to publish. Default false = draft. Never auto-publish without user confirmation."),
-  changeNote: z3.string().optional().describe("Strongly recommended: short human-readable rationale for WHY this change was made (e.g. 'Aligned description with F1-themed copy per BET-238'). Surfaces in activity feed and pb get. If omitted, falls back to session purpose or auto-generated field summary.")
+  changeNote: z3.string().optional().describe("Strongly recommended: short human-readable rationale for WHY this change was made (e.g. 'Aligned description with F1-themed copy per BET-238'). Surfaces in activity feed and pb get. If omitted, falls back to session purpose or auto-generated field summary."),
+  sourceRef: z3.string().optional().describe("URI or path of the source document backing this entry. Write-once: can only be set if currently empty."),
+  sourceExcerpt: z3.string().optional().describe("Verbatim excerpt from the source that backs this entry's claims. Write-once: can only be set if currently empty.")
 });
 var getHistorySchema = z3.object({
   entryId: z3.string().describe("Entry ID, e.g. 'T-SUPPLIER', 'BR-001'")
@@ -3474,7 +3480,7 @@ function registerKnowledgeTools(server) {
       inputSchema: updateEntrySchema,
       annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false }
     },
-    withEnvelope(async ({ entryId, name, status: rawStatus, workflowStatus: rawWorkflowStatus, data, order, canonicalKey, autoPublish, changeNote }) => {
+    withEnvelope(async ({ entryId, name, status: rawStatus, workflowStatus: rawWorkflowStatus, data, order, canonicalKey, autoPublish, changeNote, sourceRef, sourceExcerpt }) => {
       requireWriteAccess();
       const PROMOTED_FIELDS = ["status", "workflowStatus", "name", "order", "canonicalKey"];
       const topLevelByField = { status: rawStatus, workflowStatus: rawWorkflowStatus, name, order, canonicalKey };
@@ -3513,7 +3519,9 @@ function registerKnowledgeTools(server) {
         canonicalKey,
         autoPublish,
         changeNote,
-        changedBy: getAgentSessionId() ? `agent:${getAgentSessionId()}` : void 0
+        changedBy: getAgentSessionId() ? `agent:${getAgentSessionId()}` : void 0,
+        ...sourceRef ? { sourceRef } : {},
+        ...sourceExcerpt ? { sourceExcerpt } : {}
       });
       const id = updateResult.id;
       await recordSessionActivity({ entryModified: id });
@@ -5834,7 +5842,7 @@ function formatTimeAgo(ms) {
 
 // src/tools/collections.ts
 import { z as z8 } from "zod";
-var COLLECTIONS_ACTIONS = ["list", "create", "update", "describe"];
+var COLLECTIONS_ACTIONS = ["list", "create", "update", "describe", "audit"];
 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)."),
@@ -5860,7 +5868,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."
+    "'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."
   ),
   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"),
@@ -5883,7 +5891,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.",
+      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.",
       inputSchema: collectionsSchema,
       annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false }
     },
@@ -5917,6 +5925,9 @@ function registerCollectionsTools(server) {
           }
           return handleUpdate(slug, name, description, purpose, icon, navGroup, fields, { defaultCanonicalKey, defaultWorkflowStatus, validWorkflowStatuses, classificationCheck, classificationPriority, qualityCriteria, usageGuidance });
         }
+        if (action === "audit") {
+          return handleAudit();
+        }
         return unknownAction(action, COLLECTIONS_ACTIONS);
       });
     })
@@ -6145,6 +6156,44 @@ Use \`collections action=list\` to verify the result.`
     )
   };
 }
+async function handleAudit() {
+  const data = await mcpQuery("chain.auditCollections");
+  const lines = [];
+  lines.push(`# Collection Audit Report`);
+  lines.push(`
+**Total:** ${data.total} \xB7 **Healthy:** ${data.healthy} \xB7 **With issues:** ${data.withIssues}`);
+  if (data.withIssues === 0) {
+    lines.push(`
+All collections are healthy.`);
+  } else {
+    const problematic = data.collections.filter((c) => c.issues.length > 0);
+    lines.push(`
+## Collections With Issues
+`);
+    for (const col of problematic) {
+      const icon = col.icon ?? "\u2014";
+      lines.push(`### ${icon} ${col.name} (\`${col.slug}\`) \u2014 ${col.issues.length} issue(s)`);
+      for (const issue of col.issues) {
+        lines.push(`- **[${issue.code}]** ${issue.message}`);
+      }
+      lines.push("");
+    }
+  }
+  const healthyCollections = data.collections.filter((c) => c.issues.length === 0);
+  if (healthyCollections.length > 0) {
+    lines.push(`
+## Healthy Collections
+`);
+    lines.push(healthyCollections.map((c) => `- ${c.icon ?? "\u2014"} \`${c.slug}\``).join("\n"));
+  }
+  return {
+    content: [{ type: "text", text: lines.join("\n") }],
+    structuredContent: success(
+      `Audit complete. ${data.total} collections: ${data.healthy} healthy, ${data.withIssues} with issues.`,
+      data
+    )
+  };
+}
 
 // src/tools/labels.ts
 import { z as z9 } from "zod";
@@ -6283,14 +6332,7 @@ import { z as z10 } from "zod";
 // src/lib/coherence/data.ts
 var REGISTRY_MANIFEST = [
   // ── Canonical UI registries ──────────────────────────────────────
-  {
-    id: "ui-colors",
-    path: "src/lib/utils/collection-colors.ts",
-    exportName: "COLLECTION_COLORS",
-    description: "CSS color mapping for UI components",
-    expectedCoverage: "curated",
-    keyExtraction: "object-keys"
-  },
+  // BET-143 Slice 4: ui-colors removed — color is now a field on collection docs (schema.ts).
   {
     id: "routes",
     path: "src/lib/navigation.ts",
@@ -6307,56 +6349,11 @@ var REGISTRY_MANIFEST = [
     expectedCoverage: "curated",
     keyExtraction: "object-keys"
   },
-  {
-    id: "sidebar-collections",
-    path: "src/lib/navigation.ts",
-    exportName: "SIDEBAR_COLLECTION_SLUGS",
-    description: "Collection slugs with dedicated sidebar entries",
-    expectedCoverage: "subset",
-    keyExtraction: "set-values"
-  },
-  {
-    id: "display-fields",
-    path: "src/lib/components/EntryPreviewModal.svelte",
-    exportName: "DISPLAY_FIELDS",
-    description: "Fields displayed in entry preview modal per collection",
-    expectedCoverage: "curated",
-    keyExtraction: "object-keys"
-  },
-  // ── Brain Chat registries ────────────────────────────────────────
-  {
-    id: "brain-colors",
-    path: "src/lib/components/brain/brain-types.ts",
-    exportName: "COLLECTION_COLORS",
-    description: "Brain Chat collection color palette",
-    expectedCoverage: "subset",
-    keyExtraction: "object-keys"
-  },
-  {
-    id: "brain-icons",
-    path: "src/lib/components/brain/brain-types.ts",
-    exportName: "COLLECTION_ICONS",
-    description: "Brain Chat collection icons",
-    expectedCoverage: "subset",
-    keyExtraction: "object-keys"
-  },
+  // BET-280 S3: display-fields removed — DISPLAY_FIELDS constant deleted, field display is now schema-driven.
+  // BET-280 S3: brain-icons removed — COLLECTION_ICONS unexported, getCollectionIcon() is a local rendering fallback only.
   // ── Graph visualization registries ───────────────────────────────
-  {
-    id: "graph-colors",
-    path: "src/lib/utils/graphToVisNetwork.ts",
-    exportName: "GRAPH_COLLECTION_COLORS",
-    description: "Graph visualization hex color palette",
-    expectedCoverage: "subset",
-    keyExtraction: "object-keys"
-  },
-  {
-    id: "graph-type-colors",
-    path: "src/lib/components/graph/graph.types.ts",
-    exportName: "COLLECTION_COLORS",
-    description: "Chain Graph collection colors (distinct palette)",
-    expectedCoverage: "subset",
-    keyExtraction: "object-keys"
-  },
+  // BET-143 Slice 4: graph-colors and graph-type-colors removed.
+  // Graph rendering uses local fallback palettes (canvas needs resolved hex/CSS vars, not DB reads).
   // ── Cortex registries ────────────────────────────────────────────
   {
     id: "renderers",
@@ -6378,71 +6375,17 @@ var REGISTRY_MANIFEST = [
   // TEN-598: default-collections removed. Collection definitions live in system_collection_definitions (DB).
 ];
 var COLLECTION_REGISTRY_RULES = [
-  // ── Coverage: downstream registries should cover important collections ──
-  {
-    id: "coverage-ui-colors",
-    type: "coverage",
-    description: "UI colors should cover collections that have sidebar routes",
-    subject: "ui-colors",
-    reference: "routes"
-  },
   // ── Subset: specialized registries should only reference known collections ──
-  {
-    id: "subset-brain-colors",
-    type: "subset",
-    description: "Brain colors should only reference classified collections",
-    subject: "brain-colors",
-    reference: "classification-map"
-  },
-  {
-    id: "subset-brain-icons",
-    type: "subset",
-    description: "Brain icons should only reference classified collections",
-    subject: "brain-icons",
-    reference: "classification-map"
-  },
+  // BET-143 Slice 4: brain-colors, graph-colors, graph-type-colors rules removed —
+  // those registries were deleted when color moved to collection docs.
+  // BET-280 S3: brain-icons rule removed — COLLECTION_ICONS unexported, no longer a registry.
+  // BET-280 S3: display-fields rule removed — DISPLAY_FIELDS deleted, field display is schema-driven.
   {
     id: "subset-renderers",
     type: "subset",
     description: "Renderers should only reference classified collections",
     subject: "renderers",
     reference: "classification-map"
-  },
-  {
-    id: "subset-display-fields",
-    type: "subset",
-    description: "Display fields should only reference classified collections",
-    subject: "display-fields",
-    reference: "classification-map"
-  },
-  {
-    id: "subset-graph-colors",
-    type: "subset",
-    description: "Graph colors should only reference classified collections",
-    subject: "graph-colors",
-    reference: "classification-map"
-  },
-  {
-    id: "subset-graph-type-colors",
-    type: "subset",
-    description: "Graph type colors should only reference classified collections",
-    subject: "graph-type-colors",
-    reference: "classification-map"
-  },
-  // ── Implication: presence in one registry implies presence in another ──
-  {
-    id: "implication-routes-need-colors",
-    type: "implication",
-    description: "Collections with routes should also have UI colors",
-    subject: "routes",
-    reference: "ui-colors"
-  },
-  {
-    id: "implication-sidebar-needs-route",
-    type: "implication",
-    description: "Sidebar collections should have a route defined",
-    subject: "sidebar-collections",
-    reference: "routes"
   }
 ];
 
@@ -13965,7 +13908,7 @@ async function handleWorkspaceStatus() {
     )
   };
 }
-async function handleAudit(limit) {
+async function handleAudit2(limit) {
   const log = getAuditLog();
   const recent = log.slice(-limit);
   if (recent.length === 0) {
@@ -14158,7 +14101,7 @@ function registerHealthTools(server) {
         if (action === "check") return handleHealthCheck();
         if (action === "whoami") return handleWhoami();
         if (action === "status") return handleWorkspaceStatus();
-        if (action === "audit") return handleAudit(limit ?? 20);
+        if (action === "audit") return handleAudit2(limit ?? 20);
         if (action === "self-test") return handleSelfTest();
         return unknownAction(action, HEALTH_ACTIONS);
       });
@@ -15169,4 +15112,4 @@ export {
   SERVER_VERSION,
   createProductBrainServer
 };
-//# sourceMappingURL=chunk-YKDHYK3Q.js.map
+//# sourceMappingURL=chunk-CDBSOVW7.js.map