@productbrain/mcp 0.0.1-beta.984 → 0.0.1-beta.997

package/dist/{chunk-JJJO3SDX.js → chunk-CIHITLKC.js}

@@ -1802,7 +1802,7 @@ var captureSchema = z2.object({
   canonicalKey: z2.string().optional().describe("Semantic type (e.g. 'decision', 'tension', 'vision'). Auto-assigned from collection if omitted."),
   data: z2.record(z2.unknown()).optional().describe("Explicit field values when you know the schema (e.g. canonical_key, cardinality_rule, required_fields). Merged with inferred values; user-provided wins."),
   links: z2.array(z2.object({
-    to: z2.string().describe("Target entry ID (e.g. 'BR-64', 'ARCH-8')"),
+    to: z2.string().describe("Target entry ID (e.g. '<PREFIX>-<n>')"),
     type: z2.string().describe("Relation type (e.g. 'governs', 'related_to', 'informs')")
   })).optional().describe("Relations to create after capture. Skips auto-link discovery when provided."),
   autoCommit: z2.boolean().optional().describe(
@@ -1823,7 +1823,8 @@ var captureSchema = z2.object({
 });
 var batchCaptureSchema = z2.object({
   entries: z2.array(z2.object({
-    collection: z2.string().optional().describe("Collection slug. Optional \u2014 auto-classified via LLM when omitted (FEAT-160)."),
+    // FEAT-160
+    collection: z2.string().optional().describe("Collection slug. Optional \u2014 auto-classified via LLM when omitted."),
     name: z2.string().describe("Display name"),
     description: z2.string().describe("Full context / definition"),
     entryId: entryIdSchema,
@@ -2259,7 +2260,8 @@ function registerSmartCaptureTools(server) {
         return {
           content: [{
             type: "text",
-            text: `# BR-111: entryId Not Allowed
+            // BR-111
+            text: `# entryId Not Allowed
 
 \`entryId\` is only valid for \`business-rules\` and \`standards\` collections. For \`${resolvedCollection}\`, omit \`entryId\` \u2014 IDs are auto-generated.`
           }],
@@ -3041,7 +3043,7 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
     "batch-capture",
     {
       title: "Batch Capture",
-      description: "Create multiple knowledge entries in one call. Ideal for workspace setup, document ingestion, or any scenario where you need to capture many entries at once.\n\nCollection is optional per entry \u2014 omit it and the LLM classifier auto-routes (FEAT-160). High/medium confidence entries are created; low confidence entries are skipped and returned with suggested collections for manual review.\n\nEach entry is created independently \u2014 if one fails, the others still succeed. Returns a compact summary instead of per-entry quality scorecards.\n\nAuto-linking runs per entry but contradiction checks and readiness hints are skipped for speed. Use `quality action=check` on individual entries afterward if needed.\n\nPass `autoCommit: false` to keep the whole batch draft-first. If omitted, Open mode workspaces commit by default and consensus/role modes keep drafts.",
+      description: "Create multiple knowledge entries in one call. Ideal for workspace setup, document ingestion, or any scenario where you need to capture many entries at once.\n\nCollection is optional per entry \u2014 omit it and the LLM classifier auto-routes. High/medium confidence entries are created; low confidence entries are skipped and returned with suggested collections for manual review.\n\nEach entry is created independently \u2014 if one fails, the others still succeed. Returns a compact summary instead of per-entry quality scorecards.\n\nAuto-linking runs per entry but contradiction checks and readiness hints are skipped for speed. Use `quality action=check` on individual entries afterward if needed.\n\nPass `autoCommit: false` to keep the whole batch draft-first. If omitted, Open mode workspaces commit by default and consensus/role modes keep drafts.",
       inputSchema: batchCaptureSchema.shape,
       annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
     },
@@ -3149,7 +3151,8 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
             classifiedBy,
             confidence,
             confidenceTier,
-            error: `BR-111: entryId only allowed for business-rules and standards. Omit for ${resolvedSlug}.`
+            // BR-111
+            error: `entryId only allowed for business-rules and standards. Omit for ${resolvedSlug}.`
           });
           continue;
         }
@@ -3843,7 +3846,7 @@ var WORKFLOW_STATUS_VALUES = [
 ];
 var LEGACY_WORKFLOW_STATUSES = new Set(WORKFLOW_STATUS_VALUES);
 var updateEntrySchema = z3.object({
-  entryId: z3.string().describe("Entry ID to update, e.g. 'T-SUPPLIER', 'BR-001'"),
+  entryId: z3.string().describe("Entry ID to update, e.g. 'T-SUPPLIER', '<PREFIX>-<n>'"),
   name: z3.string().optional().describe("New display name"),
   status: z3.union([
     z3.enum(["draft", "active", "deprecated", "archived"]),
@@ -3854,15 +3857,15 @@ 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'). 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'")
+  entryId: z3.string().describe("Entry ID, e.g. 'T-SUPPLIER', '<PREFIX>-<n>'")
 });
 var commitEntrySchema = z3.object({
-  entryId: z3.string().describe("Entry ID to commit, e.g. 'TEN-abc123', 'GT-019'"),
+  entryId: z3.string().describe("Entry ID to commit, e.g. 'TEN-abc123', '<PREFIX>-<n>'"),
   // WP-316 S3: Preview gate — dry-run mode. Returns would-succeed result, no DB writes.
   preview: z3.boolean().optional().describe("If true, validates the commit without writing. Returns what would happen. Default false.")
 });
@@ -4287,7 +4290,7 @@ var entriesSchema = z4.object({
   action: z4.enum(ENTRIES_ACTIONS).describe(
     "'list': browse entries with filters. 'get': fetch one entry by ID. 'batch': fetch multiple entries. 'search': full-text search."
   ),
-  entryId: z4.string().optional().describe("Entry ID for get action, e.g. 'DEC-42', 'BR-001'"),
+  entryId: z4.string().optional().describe("Entry ID for get action, e.g. '<PREFIX>-<n>'"),
   entryIds: z4.array(z4.string()).min(1).max(20).optional().describe("Entry IDs for batch action, e.g. ['TYPE-strategy', 'STR-jljeg7']"),
   collection: z4.string().optional().describe("Collection slug for list/search, e.g. 'glossary', 'tracking-events', 'business-rules'"),
   status: z4.string().optional().describe("Filter: draft | active | deprecated | archived"),
@@ -4296,7 +4299,7 @@ var entriesSchema = z4.object({
   query: z4.string().optional().describe("Search text for search action (min 2 characters)")
 });
 var moveEntrySchema = z4.object({
-  entryId: z4.string().describe("Entry ID to move, e.g. 'DEC-42', 'BR-001'"),
+  entryId: z4.string().describe("Entry ID to move, e.g. '<PREFIX>-<n>'"),
   toCollection: z4.string().describe("Target collection slug, e.g. 'decisions', 'architecture'")
 });
 var entriesGetOutputSchema = z4.object({
@@ -4404,7 +4407,7 @@ function registerEntriesTools(server) {
     "move-entry",
     {
       title: "Move Entry",
-      description: 'Move an entry to a different collection. Use when the classifier misrouted or the user wants to reclassify.\n\nExample: `move-entry entryId="DEC-42" toCollection="tensions"` reclassifies DEC-42 into the tensions collection.',
+      description: 'Move an entry to a different collection. Use when the classifier misrouted or the user wants to reclassify.\n\nExample: `move-entry entryId="<PREFIX>-<n>" toCollection="tensions"` reclassifies the entry into the tensions collection.',
       inputSchema: moveEntrySchema,
       annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false }
     },
@@ -4804,7 +4807,7 @@ var graphSchema = z5.object({
   action: z5.enum(GRAPH_ACTIONS).describe(
     "'find': traverse relations from an entry (graph walk). 'suggest': discover potential connections for an entry."
   ),
-  entryId: z5.string().describe("Entry ID, e.g. 'GT-019', 'FEAT-001'"),
+  entryId: z5.string().describe("Entry ID, e.g. '<PREFIX>-<n>'"),
   direction: z5.enum(["incoming", "outgoing", "both"]).default("both").optional().describe("For find: 'incoming' = what references this, 'outgoing' = what this references"),
   limit: z5.number().min(1).max(20).default(10).optional().describe("For suggest: max suggestions to return"),
   depth: z5.number().min(1).max(3).default(2).optional().describe("For suggest: graph traversal depth")
@@ -5351,12 +5354,13 @@ function epistemicCollectionHint(collectionName) {
 }
 var CONTEXT_ACTIONS = ["gather", "build", "neighborhood", "changes", "chain", "cross-cut", "incremental", "brief"];
 var contextSchema = z7.object({
+  // provenance: neighborhood BET-142; changes/chain/cross-cut/incremental/brief BET-239 (E4, E6)
   action: z7.enum(CONTEXT_ACTIONS).describe(
-    "'gather': assemble knowledge context (entry graph, task auto-load, journey mode, or graph mode). 'build': structured build spec for an entry. 'neighborhood': typed graph neighborhood for an entry \u2014 blocking chain, dependencies, parent context, tensions, staleness (BET-142). 'changes': entries modified and relations created since a timestamp (BET-239). Requires 'since' parameter. 'chain': directed traversal along one relation type to depth 4 (BET-239). Requires entryId. Optional: direction, relationType, maxHops (1-4). 'cross-cut': structural aggregation \u2014 all relations of a given type grouped by source collection (BET-239). Requires 'relationType' parameter. 'incremental': delta since last brief run for a skill (BET-239 E4). Requires 'skill' parameter. Returns only entries changed since the skill's last brief. 'brief': compound intelligence query (BET-239 E6). Requires 'briefType' parameter: 'steering' (changes + structure + delta + readiness), 'confidence' (changes + active bets + tensions), or 'delta' (changes + relations since timestamp). Optional 'since' for delta type."
+    "'gather': assemble knowledge context (entry graph, task auto-load, journey mode, or graph mode). 'build': structured build spec for an entry. 'neighborhood': typed graph neighborhood for an entry \u2014 blocking chain, dependencies, parent context, tensions, staleness. 'changes': entries modified and relations created since a timestamp. Requires 'since' parameter. 'chain': directed traversal along one relation type to depth 4. Requires entryId. Optional: direction, relationType, maxHops (1-4). 'cross-cut': structural aggregation \u2014 all relations of a given type grouped by source collection. Requires 'relationType' parameter. 'incremental': delta since last brief run for a skill. Requires 'skill' parameter. Returns only entries changed since the skill's last brief. 'brief': compound intelligence query. Requires 'briefType' parameter: 'steering' (changes + structure + delta + readiness), 'confidence' (changes + active bets + tensions), or 'delta' (changes + relations since timestamp). Optional 'since' for delta type."
   ),
-  entryId: z7.string().optional().describe("Entry ID for graph traversal or build, e.g. 'FEAT-001', 'GT-019'"),
+  entryId: z7.string().optional().describe("Entry ID for graph traversal or build, e.g. '<PREFIX>-<n>'"),
   mapEntryId: z7.string().optional().describe(
-    "Journey map entry ID for journey-aware context (gather only). Returns context organised by journey stage. Takes precedence over entryId when both are supplied. Example: 'MAP-1'."
+    "Journey map entry ID for journey-aware context (gather only). Returns context organised by journey stage. Takes precedence over entryId when both are supplied. Example: '<PREFIX>-<n>'."
   ),
   task: z7.string().optional().describe("Natural-language task description for loading task-relevant governance, binding constraints, and supporting context (gather only)"),
   since: z7.string().optional().describe(
@@ -5382,7 +5386,7 @@ function registerContextTools(server) {
     "context",
     {
       title: "Context",
-      description: "Assemble knowledge context in one call. Six actions:\n\n- **gather**: Three modes \u2014 (1) By entry: traverse the graph around a specific entry. (2) By task: load task-relevant governance, binding constraints, and supporting domain knowledge for a natural-language task. (3) Graph mode (entryId + mode='graph'): enhanced traversal with provenance paths.\n- **build**: Structured build spec for any entry \u2014 data, related entries, business rules, glossary terms, chain refs. Use when starting a build. Requires active session.\n- **neighborhood**: Typed graph neighborhood \u2014 blocking chain (what this blocks, 3 hops), dependency chain (what blocks this), parent context (sibling count), related tensions, staleness signal, isolation signal. Fast indexed lookups. Requires entryId.\n- **changes**: Detect entries modified and relations created since a timestamp. Use for incremental updates instead of full traversal. Requires 'since' (ISO 8601). Returns grouped counts by collection. Cap: 200 entries. (BET-239)\n- **chain**: Directed deep traversal along one relation type to depth 4 (BET-239). Use for dependency analysis, governance chains, strategic alignment. Requires entryId. Optional: direction (outgoing/incoming), relationType, maxHops (1-4). Cycle detection, fan-out cap 10/hop, total cap 100 nodes. Returns tree + edges.\n- **cross-cut**: Structural aggregation \u2014 all relations of a given type across the workspace, grouped by source collection. Use to answer 'show me everything connected by part_of'. Requires 'relationType'. Cap: 500 entries. (BET-239)\n- **incremental**: Delta since last brief run for a skill. Returns only entries changed since the skill's last brief, filtering out previously surfaced entries. Requires 'skill' parameter. Use for steering briefs that need incremental awareness. (BET-239 E4)\n- **brief**: Compound intelligence query composing multiple primitives. Requires 'briefType': 'steering' (7d changes + structure + delta + readiness), 'confidence' (7d changes + active bets + tensions), or 'delta' (changes since custom timestamp). Auto-records brief run for steering. (BET-239 E6)",
+      description: "Assemble knowledge context in one call. Six actions:\n\n- **gather**: Three modes \u2014 (1) By entry: traverse the graph around a specific entry. (2) By task: load task-relevant governance, binding constraints, and supporting domain knowledge for a natural-language task. (3) Graph mode (entryId + mode='graph'): enhanced traversal with provenance paths.\n- **build**: Structured build spec for any entry \u2014 data, related entries, business rules, glossary terms, chain refs. Use when starting a build. Requires active session.\n- **neighborhood**: Typed graph neighborhood \u2014 blocking chain (what this blocks, 3 hops), dependency chain (what blocks this), parent context (sibling count), related tensions, staleness signal, isolation signal. Fast indexed lookups. Requires entryId.\n- **changes**: Detect entries modified and relations created since a timestamp. Use for incremental updates instead of full traversal. Requires 'since' (ISO 8601). Returns grouped counts by collection. Cap: 200 entries.\n- **chain**: Directed deep traversal along one relation type to depth 4. Use for dependency analysis, governance chains, strategic alignment. Requires entryId. Optional: direction (outgoing/incoming), relationType, maxHops (1-4). Cycle detection, fan-out cap 10/hop, total cap 100 nodes. Returns tree + edges.\n- **cross-cut**: Structural aggregation \u2014 all relations of a given type across the workspace, grouped by source collection. Use to answer 'show me everything connected by part_of'. Requires 'relationType'. Cap: 500 entries.\n- **incremental**: Delta since last brief run for a skill. Returns only entries changed since the skill's last brief, filtering out previously surfaced entries. Requires 'skill' parameter. Use for steering briefs that need incremental awareness.\n- **brief**: Compound intelligence query composing multiple primitives. Requires 'briefType': 'steering' (7d changes + structure + delta + readiness), 'confidence' (7d changes + active bets + tensions), or 'delta' (changes since custom timestamp). Auto-records brief run for steering.",
       inputSchema: contextSchema,
       annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false }
     },
@@ -6427,13 +6431,18 @@ var fieldSchema = z8.object({
   displayHint: z8.enum(["hero", "badge", "meta", "section", "hidden", "inline-meta"]).optional().describe("V2 rendering hint: how the field should be displayed in Cortex"),
   zone: z8.enum(["header", "body", "meta"]).optional().describe("V2 layout zone: where the field appears in the entry view"),
   colorMap: z8.record(z8.string()).optional().describe("V2 value-to-semantic-color mapping, e.g. { critical: 'danger', low: 'success' }"),
-  accentSource: z8.boolean().optional().describe("ENT-61: when true, this field's colorMap value drives the card-level accent styling"),
-  iconMap: z8.record(z8.string(), z8.string()).optional().describe("ENT-61: maps field values to icons (emoji/symbol), prepended to badge text"),
+  // ENT-61
+  accentSource: z8.boolean().optional().describe("When true, this field's colorMap value drives the card-level accent styling"),
+  // ENT-61
+  iconMap: z8.record(z8.string(), z8.string()).optional().describe("Maps field values to icons (emoji/symbol), prepended to badge text"),
   helpText: z8.string().optional().describe("Help text shown in editors and describe output"),
   optionDescriptions: z8.record(z8.string()).optional().describe("Per-option guidance for select fields"),
-  semanticRole: z8.enum(["problem", "appetite", "elements", "architecture", "done_when", "risks", "exclusions"]).optional().describe("BET-136: Semantic role for schema-driven consumers \u2014 enables field-key-independent validation and rendering"),
-  maxLength: z8.number().optional().describe("BET-196: Maximum character length for field values. Three-tier resolution: explicit > displayHint > type fallback."),
-  minLength: z8.number().optional().describe("BET-196: Minimum character length for field values. Only explicit \u2014 no defaults.")
+  // BET-136
+  semanticRole: z8.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: z8.number().optional().describe("Maximum character length for field values. Three-tier resolution: explicit > displayHint > type fallback."),
+  // BET-196
+  minLength: z8.number().optional().describe("Minimum character length for field values. Only explicit \u2014 no defaults.")
 });
 var collectionsSchema = z8.object({
   action: z8.enum(COLLECTIONS_ACTIONS).describe(
@@ -6446,13 +6455,19 @@ var collectionsSchema = z8.object({
   icon: z8.string().optional().describe("Emoji icon for the collection"),
   navGroup: z8.enum(["daily", "strategic", "governance", "reference", "collections"]).optional().describe("Sidebar placement: 'daily', 'strategic', 'governance', 'reference', 'collections'"),
   fields: z8.array(fieldSchema).optional().describe("Field definitions for create, or replacement schema for update (replaces all fields)"),
-  defaultCanonicalKey: z8.string().optional().describe("ENT-62: The canonical_key entries in this collection default to (e.g. 'decision', 'insight'). Consumers read from collection doc; code map is fallback."),
-  defaultWorkflowStatus: z8.string().optional().describe("ENT-67: Default workflowStatus for new entries. Must be in validWorkflowStatuses when set (e.g. 'hypothesis' for insights)."),
-  validWorkflowStatuses: z8.array(z8.string()).optional().describe("ENT-65: The allowed workflowStatus values for entries in this collection. New entries are validated against this list. Empty array means no constraint."),
-  classificationCheck: z8.string().optional().describe("ENT-65 FEAT-200: LLM decision-tree check for this collection (3\u2013500 chars). Guides the classifier in routing entries here."),
-  classificationPriority: z8.number().optional().describe("ENT-65 FEAT-200: Classifier priority (1\u20139, lower = higher priority). Used with classificationCheck to order the decision tree."),
+  // ENT-62
+  defaultCanonicalKey: z8.string().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: z8.string().optional().describe("Default workflowStatus for new entries. Must be in validWorkflowStatuses when set (e.g. 'hypothesis' for insights)."),
+  // ENT-65
+  validWorkflowStatuses: z8.array(z8.string()).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: z8.string().optional().describe("LLM decision-tree check for this collection (3\u2013500 chars). Guides the classifier in routing entries here."),
+  // ENT-65, FEAT-200
+  classificationPriority: z8.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.
-  qualityCriteria: z8.array(qualityCriterionSchema).optional().describe("FEAT-257: Per-collection commit gate rules. 'required' rule hard-blocks commits on empty fields; 'min_length'/'pattern' rules warn. Pass an empty array to clear all criteria."),
+  // FEAT-257
+  qualityCriteria: z8.array(qualityCriterionSchema).optional().describe("Per-collection commit gate rules. 'required' rule hard-blocks commits on empty fields; 'min_length'/'pattern' rules warn. Pass an empty array to clear all criteria."),
   usageGuidance: z8.string().optional().describe("Plain-text guidance shown to agents and users: when to use this collection, when not to, and what makes a good entry.")
 });
 function registerCollectionsTools(server) {
@@ -6960,7 +6975,8 @@ var REGISTRY_MANIFEST = [
     id: "classification-map",
     path: "convex/lib/seedClassificationRegistry.ts",
     exportName: "SEED_CLASSIFICATION_REGISTRY",
-    description: "Seed-only (ENT-65): governance, nav group, ID prefix. Runtime reads from DB collection doc.",
+    // ENT-65
+    description: "Seed-only: governance, nav group, ID prefix. Runtime reads from DB collection doc.",
     expectedCoverage: "curated",
     keyExtraction: "array-slug"
   }
@@ -8159,7 +8175,7 @@ var qualitySchema = z12.object({
   action: z12.enum(QUALITY_ACTIONS).describe(
     "'check': score an entry against quality criteria. 're-evaluate': trigger fresh evaluation."
   ),
-  entryId: z12.string().describe("Entry ID, e.g. 'TEN-graph-db', 'GT-019', 'SOS-006'"),
+  entryId: z12.string().describe("Entry ID, e.g. 'TEN-graph-db', '<PREFIX>-<n>'"),
   context: z12.enum(["capture", "commit", "review"]).default("review").optional().describe("For re-evaluate: evaluation context")
 });
 var qualityCheckOutputSchema = z12.object({
@@ -10348,7 +10364,7 @@ var verifySchema = z15.object({
   mode: z15.enum(["report", "fix"]).default("report").describe("'report' = read-only trust report. 'fix' = also update drifted codeMapping statuses.")
 });
 var verifyEntrySchema = z15.object({
-  entryId: z15.string().describe("Human entry ID (e.g. 'INS-33') to mark as verified")
+  entryId: z15.string().describe("Human entry ID (e.g. '<PREFIX>-<n>') to mark as verified")
 });
 function registerVerifyTools(server) {
   const verifyTool = server.registerTool(
@@ -11391,7 +11407,10 @@ function registerStartPbTools(server) {
     "start_pb",
     {
       title: "Start Product Brain",
-      description: "Universal session opener \u2014 say 'Start PB' to begin every session (PAT-227).\n\nStage-aware delivery:\n- **Fresh workspace (blank/seeded)**: returns the canonical SKILL-pb-setup body verbatim. The skill drives the install-to-activation flow.\n- **Active workspace (grounded/connected)**: standup briefing with active bets, governance, and recent activity.\n\nAlways call this first. It starts a session, stamps the surface, and loads the right guidance for your stage. Replaces both the former `start` tool and the former chat-only `start_pb` bootstrap.",
+      description: (
+        // PAT-227
+        "Universal session opener \u2014 say 'Start PB' to begin every session.\n\nStage-aware delivery:\n- **Fresh workspace (blank/seeded)**: returns the canonical SKILL-pb-setup body verbatim. The skill drives the install-to-activation flow.\n- **Active workspace (grounded/connected)**: standup briefing with active bets, governance, and recent activity.\n\nAlways call this first. It starts a session, stamps the surface, and loads the right guidance for your stage. Replaces both the former `start` tool and the former chat-only `start_pb` bootstrap."
+      ),
       inputSchema: startPbSchema,
       annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false }
     },
@@ -13890,13 +13909,13 @@ function registerHealthTools(server) {
 import { z as z23 } from "zod";
 var recordActivationSchema = z23.object({
   confirmedEntryCount: z23.number().int().min(0).describe(
-    "Confirmed-entry count from the Phase 4 capture loop. The mutation enforces >=10 (DEC-994)."
+    "Confirmed-entry count from the Phase 4 capture loop. The mutation enforces >=10."
   ),
   entriesAcrossCollections: z23.number().int().min(0).describe(
-    "Number of distinct collections those entries span. The mutation enforces >=2 (DEC-994 diversity soft-gate)."
+    "Number of distinct collections those entries span. The mutation enforces >=2 (diversity soft-gate)."
   ),
   retrievalDemoConfirmed: z23.boolean().describe(
-    "True if the BR-141 retrieval round-trip ran successfully in Phase 4. The mutation rejects false."
+    "True if the retrieval round-trip ran successfully in Phase 4. The mutation rejects false."
   )
 });
 function registerRecordActivationTools(server) {
@@ -13904,7 +13923,10 @@ function registerRecordActivationTools(server) {
     "record_activation",
     {
       title: "Record activation receipt \u2014 chat-only",
-      description: "Writes the per-user activation receipt that closes the WP-431 install-to-activation arc for chat-only surfaces (Cursor Desktop, Claude Desktop, ChatGPT). The skill body's Phase 5 calls this AFTER Phase 4 gates pass: confirmedEntryCount>=10, entriesAcrossCollections>=2, retrievalDemoConfirmed=true. surfaceCapability is hardcoded to 'chat-only' \u2014 this tool is NOT for CLI agents (CLI uses the gateway directly). Idempotent: a re-run after activation returns alreadyActivated=true.",
+      description: (
+        // WP-431
+        "Writes the per-user activation receipt that closes the install-to-activation arc for chat-only surfaces (Cursor Desktop, Claude Desktop, ChatGPT). The skill body's Phase 5 calls this AFTER Phase 4 gates pass: confirmedEntryCount>=10, entriesAcrossCollections>=2, retrievalDemoConfirmed=true. surfaceCapability is hardcoded to 'chat-only' \u2014 this tool is NOT for CLI agents (CLI uses the gateway directly). Idempotent: a re-run after activation returns alreadyActivated=true."
+      ),
       inputSchema: recordActivationSchema,
       annotations: { readOnlyHint: false, idempotentHint: true, openWorldHint: false, destructiveHint: false }
     },
@@ -13967,7 +13989,7 @@ var auditSchema = z24.object({
   action: z24.enum(AUDIT_ACTIONS).describe(
     "'run': run the hygiene audit for a bet entry."
   ),
-  entryId: z24.string().describe("Bet entry ID to audit, e.g. 'BET-182'"),
+  entryId: z24.string().describe("Bet entry ID to audit, e.g. '<PREFIX>-<n>'"),
   phase: z24.enum(["shaping", "handoff"]).default("shaping").optional().describe(
     "'shaping': check shaping-phase fields only. 'handoff': check all required fields including buildContract/buildSequence/exclusions/risks. Default: shaping."
   )
@@ -14995,7 +15017,7 @@ Domain: ${domain}
 Existing rules in this domain:
 ${existingContext}
 
-Draft the rule with these fields (do not specify entryId \u2014 Convex assigns sequential IDs automatically, e.g. SOS-7):
+Draft the rule with these fields (do not specify entryId \u2014 Convex assigns sequential IDs automatically, e.g. <PREFIX>-<n>):
 1. **name**: Concise rule title
 2. **data.description**: What the rule states
 3. **data.rationale**: Why this rule matters
@@ -15268,4 +15290,4 @@ export {
   createProductBrainServer,
   initFeatureFlags
 };
-//# sourceMappingURL=chunk-JJJO3SDX.js.map
+//# sourceMappingURL=chunk-CIHITLKC.js.map