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

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

@@ -996,326 +996,6 @@ var FIELD_TYPE_DEFAULTS = {
   "date": null
 };
 
-// src/lib/collectionRoutingClassifier.ts
-var CLASSIFIABLE_COLLECTIONS = [
-  "decisions",
-  "tensions",
-  "glossary",
-  "insights",
-  "features",
-  "architecture",
-  "business-rules",
-  // tracking-events: removed (Tier 1 Hierarchy — 0 entries, collection deprecated)
-  "landscape",
-  "standards",
-  "principles",
-  "assumptions",
-  "work-packages",
-  "patterns",
-  // BET-274: Capabilities collection
-  "capabilities"
-];
-var SIGNAL_WEIGHT = 10;
-var MIN_SCORE_FLOOR = 10;
-var MAX_MATCHES_PER_SIGNAL = 2;
-var MAX_REASON_COUNT = 3;
-var ENTRY_ID_PATTERN = /\b[A-Z]{2,}-\d+\b/g;
-var COLLECTION_SIGNALS = {
-  decisions: [
-    "decide",
-    "decision",
-    "chose",
-    "chosen",
-    "choice",
-    "resolved",
-    "we will",
-    "we should",
-    "approved",
-    "replaces",
-    "instead of",
-    "go with",
-    "criteria",
-    "adopted",
-    "reposition",
-    "scoring framework",
-    "review",
-    // BET-124: tune recall 35%→≥50% — match abstained/misclassified fixture entries
-    "guard level",
-    "mcp-native",
-    "pure functions",
-    "intentional debt",
-    "read allowlist",
-    "safe-by-default",
-    "map ingredients",
-    "never per-seat",
-    "neighborhood-first",
-    "locked at",
-    "ssot"
-  ],
-  tensions: [
-    "problem",
-    "issue",
-    "blocked",
-    "blocker",
-    "friction",
-    "pain",
-    "bottleneck",
-    "struggle",
-    "missing",
-    "breaks",
-    "regression",
-    "unclear",
-    "no way to",
-    "scope creep",
-    "coupled",
-    "trapped",
-    "ambiguous",
-    "no batch",
-    "undetectable",
-    "coordination gap",
-    // BET-124: tune recall 40%→≥50% — match abstained/misclassified fixture entries
-    "methodology wall",
-    "feature flag gap",
-    "doesn't bridge",
-    "cap limits",
-    "trapped in",
-    "no pan",
-    "no zoom",
-    "no interaction",
-    "accuracy regression",
-    "response bloat"
-  ],
-  glossary: [
-    "definition",
-    "define",
-    "term",
-    "means",
-    "refers to",
-    "defined as",
-    "is a term for",
-    "is called",
-    "vocabulary",
-    "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",
-    // BET-124: tune recall 46.7%→≥50% — definitional language, name-is-term pattern
-    "constraint"
-  ],
-  insights: [
-    "insight",
-    "learned",
-    "observed",
-    "trend",
-    "found that",
-    "discovery",
-    "validates",
-    "validated",
-    "saturates",
-    "convergence",
-    "signals from",
-    "signals",
-    "converge",
-    "tam",
-    // BET-124: tune recall 26.7%→≥40% — research/data/learning language
-    "thesis",
-    "decay",
-    "learnings",
-    "aha moment",
-    "data informs"
-  ],
-  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: removed (Tier 1 Hierarchy — 0 entries, collection deprecated)
-  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"
-  ],
-  patterns: [
-    "pattern",
-    "anti-pattern",
-    "best practice",
-    "reusable solution",
-    "design pattern",
-    "recurring solution",
-    "template",
-    "proven approach"
-  ],
-  capabilities: [
-    "capability",
-    "capabilities",
-    "can do",
-    "supply-side",
-    "product capability",
-    "what the product does",
-    "mature",
-    "emerging",
-    "declining",
-    "platform capability",
-    "infrastructure capability"
-  ],
-  "work-packages": [
-    "appetite",
-    "elements",
-    "no-gos",
-    "no gos",
-    "problem",
-    "solution",
-    "done when",
-    "doneWhen",
-    "rabbit hole",
-    "rabbit holes",
-    "build sequence",
-    "build contract",
-    "slice",
-    "bet",
-    "shaping",
-    "shape up"
-  ]
-};
-function escapeRegExp(text) {
-  return text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-function countSignalMatches(text, signal) {
-  const trimmed = signal.trim().toLowerCase();
-  if (!trimmed) return 0;
-  const words = trimmed.split(/\s+/).map(escapeRegExp);
-  const pattern = `\\b${words.join("\\s+")}\\b`;
-  const regex = new RegExp(pattern, "g");
-  const matches = text.match(regex);
-  return matches?.length ?? 0;
-}
-function classifyCollection(name, description) {
-  const text = `${name} ${description}`.replace(ENTRY_ID_PATTERN, "").toLowerCase();
-  const rawScores = [];
-  for (const collection of CLASSIFIABLE_COLLECTIONS) {
-    const signals = COLLECTION_SIGNALS[collection];
-    const reasons = [];
-    let score = 0;
-    for (const signal of signals) {
-      const matches = countSignalMatches(text, signal);
-      if (matches <= 0) continue;
-      const cappedMatches = Math.min(matches, MAX_MATCHES_PER_SIGNAL);
-      score += cappedMatches * SIGNAL_WEIGHT;
-      if (reasons.length < MAX_REASON_COUNT) {
-        const capNote = matches > cappedMatches ? ` (capped at ${cappedMatches})` : "";
-        reasons.push(`matched "${signal}" x${matches}${capNote}`);
-      }
-    }
-    rawScores.push({ collection, score, reasons });
-  }
-  rawScores.sort((left, right) => right.score - left.score);
-  const top = rawScores[0];
-  const second = rawScores[1];
-  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 {
-    collection: top.collection,
-    topConfidence: confidence,
-    confidence,
-    reasons: top.reasons,
-    scoreMargin: margin,
-    candidates: rawScores.filter((candidate) => candidate.score > 0).slice(0, 3).map((candidate) => ({
-      collection: candidate.collection,
-      signalScore: Math.min(99, candidate.score),
-      confidence: Math.min(99, candidate.score)
-    }))
-  };
-}
-
 // src/tools/smart-capture.ts
 function normalizeMatchText(value) {
   return value.toLowerCase().replace(/[^a-z0-9]+/g, " ").replace(/\s+/g, " ").trim();
@@ -2021,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."
@@ -3198,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;
@@ -3777,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'")
@@ -3794,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 };
@@ -3833,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 });
@@ -6154,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)."),
@@ -6180,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"),
@@ -6203,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 }
     },
@@ -6237,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);
       });
     })
@@ -6465,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";
@@ -6603,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",
@@ -6627,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",
@@ -6698,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"
   }
 ];
 
@@ -13323,9 +12946,23 @@ function extractSessionEntryIds(priorSessions) {
   }
   return { all, lastSessionOnly };
 }
+var VALID_TASK_DOMAINS = [
+  "auth",
+  "governance",
+  "architecture",
+  "product",
+  "data-foundation",
+  "chainwork",
+  "capture-pipeline",
+  "ingestion",
+  "intelligence-and-operations",
+  "review-and-learning",
+  "general"
+];
 var orientSchema = z22.object({
   mode: z22.enum(["full", "brief"]).optional().default("full").describe("full = full context (default). brief = compact summary for mid-session re-orientation."),
-  task: z22.string().optional().describe("Natural-language task description for task-scoped context. When provided, orient returns scored, relevant entries for the task.")
+  task: z22.string().optional().describe("Natural-language task description for task-scoped context. When provided, orient returns scored, relevant entries for the task."),
+  scope: z22.enum(VALID_TASK_DOMAINS).optional().describe(`Optional domain scope to filter governance to entries relevant for this domain. Valid values: ${VALID_TASK_DOMAINS.join(", ")}.`)
 });
 function taskGroundingWarningLines(task, hasTaskGrounding = false) {
   if (hasTaskGrounding) return [];
@@ -13351,12 +12988,15 @@ function registerOrientTool(server) {
     "orient",
     {
       title: "Orient \u2014 Start Here",
-      description: "The single entry point for starting a session. Returns workspace context with a single recommended next action for low-readiness workspaces, or a standup-style briefing for established workspaces.\n\nUse this FIRST. One call to orient replaces 3\u20135 individual tool calls.\n\nCompleting orientation unlocks write tools for the active session.\n\n**mode:** `full` (default) returns full context. `brief` returns only vision, bet/tension counts, readiness, active bet names, and last-session summary \u2014 use for mid-session re-orientation.\n\n**task:** Optional natural-language task description. When provided, returns task-scoped context (scored, relevant entries) in addition to standard orient sections.",
+      description: "The single entry point for starting a session. Returns workspace context with a single recommended next action for low-readiness workspaces, or a standup-style briefing for established workspaces.\n\nUse this FIRST. One call to orient replaces 3\u20135 individual tool calls.\n\nCompleting orientation unlocks write tools for the active session.\n\n**mode:** `full` (default) returns full context. `brief` returns only vision, bet/tension counts, readiness, active bet names, and last-session summary \u2014 use for mid-session re-orientation.\n\n**task:** Optional natural-language task description. When provided, returns task-scoped context (scored, relevant entries) in addition to standard orient sections.\n\n**scope:** Optional domain scope. Filters governance entries to those relevant for the specified domain. Valid values: auth, governance, architecture, product, data-foundation, chainwork, capture-pipeline, ingestion, intelligence-and-operations, review-and-learning, general.",
       inputSchema: orientSchema,
       annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false }
     },
-    withEnvelope(async ({ mode = "full", task } = {}) => {
+    withEnvelope(async ({ mode = "full", task, scope }) => {
       const errors = [];
+      if (scope && !task) {
+        errors.push("--scope requires --task to filter governance. Scope was ignored.");
+      }
       const agentSessionId = getAgentSessionId();
       if (isSessionOriented() && mode === "brief" && !task) {
         return {
@@ -13397,6 +13037,7 @@ function registerOrientTool(server) {
       try {
         const orientArgs = {};
         if (task) orientArgs.task = task;
+        if (scope) orientArgs.scope = scope;
         if (sessionEntryIds.length > 0) orientArgs.sessionEntryIds = sessionEntryIds;
         if (lastSessionOnly.length > 0) orientArgs.lastSessionEntryIds = lastSessionOnly;
         orientEntries = await mcpQuery("chain.getOrientEntries", orientArgs);
@@ -14043,16 +13684,15 @@ function buildSessionSummary(log) {
   }
   return lines.join("\n");
 }
-function computeOrganisationHealth(entries) {
+function computeOrganisationHealth(entries, classifications) {
   let agreements = 0;
   let disagreements = 0;
   let abstentions = 0;
   const flagMap = /* @__PURE__ */ new Map();
-  for (const entry of entries) {
-    const slug = entry.collectionSlug ?? entry.collection ?? "unknown";
-    const description = typeof entry.data?.description === "string" ? entry.data.description : "";
-    const result = classifyCollection(entry.name, description);
-    if (!result) {
+  for (let i = 0; i < entries.length; i++) {
+    const slug = entries[i].collectionSlug ?? entries[i].collection ?? "unknown";
+    const result = classifications[i];
+    if (!result?.collection) {
       abstentions++;
       continue;
     }
@@ -14092,7 +13732,15 @@ async function fetchOrganisationHealth() {
   try {
     const allEntries = await mcpQuery("chain.listEntries", { status: "active" });
     if (!allEntries || allEntries.length === 0) return null;
-    return computeOrganisationHealth(allEntries);
+    const classifyInput = allEntries.map((e) => ({
+      name: e.name ?? "",
+      description: typeof e.data?.description === "string" ? e.data.description : ""
+    }));
+    const classifications = await mcpQuery(
+      "chain.batchClassifyHeuristic",
+      { entries: classifyInput }
+    );
+    return computeOrganisationHealth(allEntries, classifications);
   } catch (err) {
     process.stderr.write(`[MCP] fetchOrganisationHealth failed: ${err.message}
 `);
@@ -14260,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) {
@@ -14453,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);
       });
@@ -15464,4 +15112,4 @@ export {
   SERVER_VERSION,
   createProductBrainServer
 };
-//# sourceMappingURL=chunk-OQM6LBPX.js.map
+//# sourceMappingURL=chunk-CDBSOVW7.js.map