@productbrain/mcp 0.0.1-beta.205 → 0.0.1-beta.207

package/dist/{chunk-LXESYNJ6.js → chunk-DNZQANRI.js}

@@ -478,6 +478,13 @@ async function getWorkspaceContext() {
     governanceMode: s.workspaceGovernanceMode ?? "open"
   };
 }
+async function refreshWorkspaceGovernanceMode() {
+  const workspace = await kernelCall("resolveWorkspace", {});
+  const mode = workspace?.governanceMode ?? "open";
+  const s = state();
+  s.workspaceGovernanceMode = mode;
+  return mode;
+}
 async function kernelQuery(fn, args = {}) {
   const workspaceId = await getWorkspaceId();
   return kernelCall(fn, { ...args, workspaceId });
@@ -2425,19 +2432,19 @@ ${groundingReport.governance.map((g) => `- **${g.entryId}** ${g.name} [${g.colle
         }
       }
       canonicalizeSelects(data, col.fields ?? [], isBetCapture);
-      const status = "draft";
       const agentId = getAgentSessionId();
       let finalEntryId;
       let internalId;
       let normalizationMeta;
       let formativeHints = [];
       let relationSuggestionsFromCreate = [];
+      let wasAutoCommittedServerSide = false;
       try {
         const result = await kernelMutation("chain.createEntry", {
           collectionSlug: resolvedCollection,
           entryId: entryId ?? void 0,
           name,
-          status,
+          // DEC-896 / BR-76: omit status — server resolves from governanceMode (Open→active, else draft).
           data,
           canonicalKey,
           createdBy: agentId ? `agent:${agentId}` : "capture",
@@ -2486,6 +2493,9 @@ No DB writes \u2014 call without \`preview:true\` to capture for real.${result.w
         relationSuggestionsFromCreate = result.relationSuggestions ?? [];
         formativeHints = result.qualityHints ?? [];
         resolveGapsForEntry(name, result.entryId);
+        if (result.status === "active") {
+          wasAutoCommittedServerSide = true;
+        }
       } catch (error) {
         const msg = error instanceof Error ? error.message : String(error);
         if (msg.includes("Duplicate") || msg.includes("already exists")) {
@@ -2682,7 +2692,8 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
         } catch {
         }
       }
-      const shouldAutoCommit = shouldAutoCommitCapture(autoCommit, wsCtx.governanceMode);
+      const freshGovernanceMode = await refreshWorkspaceGovernanceMode();
+      const shouldAutoCommit = shouldAutoCommitCapture(autoCommit, freshGovernanceMode);
       if (shouldAutoCommit && finalEntryId && conflictCandidates.length === 0) {
         try {
           const conflictResults = await kernelQuery("chain.searchEntries", { query: name });
@@ -2692,7 +2703,16 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
       }
       let finalStatus = "draft";
       let commitError = null;
-      if (shouldAutoCommit && finalEntryId) {
+      if (wasAutoCommittedServerSide) {
+        finalStatus = "committed";
+        await recordSessionActivity({ entryModified: internalId });
+        trackChainEntryCommitted(wsCtx.workspaceId, {
+          entry_id: finalEntryId,
+          collection: resolvedCollection,
+          commit_method: "auto",
+          surface: "mcp_capture"
+        });
+      } else if (shouldAutoCommit && finalEntryId) {
         try {
           const semanticConflicts = await runSemanticConflictPreflight(name, description, resolvedCollection);
           const blockingConflicts = semanticConflicts.filter(
@@ -2719,6 +2739,8 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
           }
         } catch (e) {
           commitError = e instanceof Error ? e.message : "unknown error";
+          finalStatus = "draft_on_failure";
+          await recordCommitFailure({ entryId: finalEntryId, error: e, sessionId: agentId, server });
         }
       }
       const lines = [
@@ -2770,7 +2792,7 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
         for (const r of userLinkResults) lines.push(`- ${r.label}`);
       }
       if (finalStatus === "committed") {
-        const wasAutoCommitted = autoCommit === void 0 && wsCtx.governanceMode === "open";
+        const wasAutoCommitted = autoCommit === void 0 && freshGovernanceMode === "open";
         lines.push("");
         lines.push(`## Committed: ${finalEntryId}`);
         if (wasAutoCommitted) {
@@ -3026,7 +3048,8 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
       const agentId = getAgentSessionId();
       const createdBy = agentId ? `agent:${agentId}` : "capture";
       const wsCtx = await getWorkspaceContext();
-      const autoCommitApplied = shouldAutoCommitCapture(autoCommit, wsCtx.governanceMode);
+      const freshGovernanceModeForBatch = await refreshWorkspaceGovernanceMode();
+      const autoCommitApplied = shouldAutoCommitCapture(autoCommit, freshGovernanceModeForBatch);
       const needsClassification = entries.map((e, i) => ({ ...e, index: i })).filter((e) => !e.collection);
       let classificationMap = /* @__PURE__ */ new Map();
       if (needsClassification.length > 0) {
@@ -3194,11 +3217,13 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
             collectionSlug: resolvedSlug,
             entryId: entry.entryId ?? void 0,
             name: entry.name,
-            status: "draft",
+            // DEC-896 / BR-76: omit status — server resolves from governanceMode (Open→active, else draft).
             data,
             createdBy,
             sessionId: agentId ?? void 0,
             canonicalKey: entry.canonicalKey ?? void 0,
+            // BR-76 S2: Distinguish batch provenance in retrospective metrics (path a).
+            originDetailOverride: "mcp-batch-capture",
             ...entry.sourceRef ? { sourceRef: entry.sourceRef } : {},
             ...entry.sourceExcerpt ? { sourceExcerpt: entry.sourceExcerpt } : {},
             ...preview ? { preview: true } : {}
@@ -3210,8 +3235,18 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
             ...result.warnings ?? []
           ];
           resolveGapsForEntry(entry.name, result.entryId);
-          let finalStatus = "draft";
+          const batchWasAutoCommittedServerSide = result.status === "active";
+          let finalStatus = batchWasAutoCommittedServerSide ? "committed" : "draft";
           let commitError;
+          if (batchWasAutoCommittedServerSide) {
+            await recordSessionActivity({ entryModified: internalId });
+            trackChainEntryCommitted(wsCtx.workspaceId, {
+              entry_id: finalEntryId,
+              collection: resolvedSlug ?? void 0,
+              commit_method: "auto",
+              surface: "mcp_capture"
+            });
+          }
           let autoLinkCount = 0;
           let entryOverlapCount = 0;
           const searchQuery = extractSearchTerms(entry.name, entry.description);
@@ -3241,7 +3276,7 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
             } catch {
             }
           }
-          if (autoCommitApplied) {
+          if (autoCommitApplied && !batchWasAutoCommittedServerSide) {
             try {
               const semanticConflicts = await runSemanticConflictPreflight(entry.name, entry.description, resolvedSlug);
               const blockingConflicts = semanticConflicts.filter(
@@ -3268,6 +3303,8 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
               }
             } catch (error) {
               commitError = error instanceof Error ? error.message : String(error);
+              finalStatus = "draft_on_failure";
+              await recordCommitFailure({ entryId: finalEntryId, error, sessionId: agentId, server });
             }
           }
           const entryNorm = result.normalization;
@@ -3310,7 +3347,7 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
       const committed = created.filter((r) => r.status === "committed");
       const proposed = created.filter((r) => r.status === "proposed");
       const drafts = created.filter((r) => r.status === "draft");
-      const commitFailures = created.filter((r) => r.commitError);
+      const commitFailed = created.filter((r) => r.status === "draft_on_failure");
       const classifiedCount = created.filter((r) => r.classifiedBy && r.classifiedBy !== "explicit").length;
       await server.sendLoggingMessage({
         level: "info",
@@ -3333,8 +3370,9 @@ Use \`entries action=get\` to inspect the existing entry, or \`update-entry\` to
         lines.push("");
       }
       if (created.length > 0) {
+        const commitFailedSegment = commitFailed.length > 0 ? `, ${commitFailed.length} commit-failed` : "";
         lines.push(
-          `**Statuses:** ${committed.length} committed, ${proposed.length} proposed, ${drafts.length} draft.`
+          `**Statuses:** ${committed.length} committed, ${proposed.length} proposed, ${drafts.length} draft${commitFailedSegment}.`
         );
         lines.push("");
       }
@@ -3378,10 +3416,10 @@ _Use \`move-entry\` to correct any misclassified entries._`);
         lines.push("");
         lines.push("_Re-capture these with an explicit `collection` or use the suggested collection._");
       }
-      if (commitFailures.length > 0) {
+      if (commitFailed.length > 0) {
         lines.push("");
         lines.push("## Saved as draft");
-        for (const r of commitFailures) {
+        for (const r of commitFailed) {
           lines.push(`- **${r.entryId}**: ${r.name} [${r.collection}] \u2014 ${r.commitError}`);
         }
       }
@@ -3432,7 +3470,8 @@ _Use \`move-entry\` to correct any misclassified entries._`);
       }
       const skippedNote = skippedLowConfidence.length > 0 ? `, ${skippedLowConfidence.length} skipped (low confidence)` : "";
       const classifiedNote = classifiedCount > 0 ? `, ${classifiedCount} auto-classified` : "";
-      const summary = failed.length > 0 || skippedLowConfidence.length > 0 ? `Batch captured ${created.length}/${entries.length} entries (${failed.length} failed${skippedNote}, ${committed.length} committed, ${proposed.length} proposed, ${drafts.length} draft${classifiedNote}).` : `Batch captured ${created.length} entries successfully (${committed.length} committed, ${proposed.length} proposed, ${drafts.length} draft${classifiedNote}).`;
+      const commitFailedNote = commitFailed.length > 0 ? `, ${commitFailed.length} commit-failed` : "";
+      const summary = failed.length > 0 || skippedLowConfidence.length > 0 || commitFailed.length > 0 ? `Batch captured ${created.length}/${entries.length} entries (${failed.length} failed${skippedNote}, ${committed.length} committed, ${proposed.length} proposed, ${drafts.length} draft${commitFailedNote}${classifiedNote}).` : `Batch captured ${created.length} entries successfully (${committed.length} committed, ${proposed.length} proposed, ${drafts.length} draft${classifiedNote}).`;
       const firstDraft = drafts[0];
       const next = [];
       if (created.length > 0) {
@@ -3464,13 +3503,15 @@ _Use \`move-entry\` to correct any misclassified entries._`);
                 ...r.confidence != null ? { confidence: r.confidence } : {},
                 ...r.confidenceTier ? { confidenceTier: r.confidenceTier } : {},
                 ...r.warnings?.length ? { warnings: r.warnings } : {},
-                ...r.normalization ? { normalization: r.normalization } : {}
+                ...r.normalization ? { normalization: r.normalization } : {},
+                ...r.commitError ? { commitError: r.commitError } : {}
               })),
               total: created.length,
               failed: failed.length,
               committed: committed.length,
               proposed: proposed.length,
               drafts: drafts.length,
+              ...commitFailed.length > 0 ? { commitFailed: commitFailed.length } : {},
               ...classifiedCount > 0 ? { classified: classifiedCount } : {},
               autoCommitApplied,
               ...skippedLowConfidence.length > 0 && {
@@ -3500,6 +3541,35 @@ _Use \`move-entry\` to correct any misclassified entries._`);
   );
   trackWriteTool(batchCaptureTool);
 }
+async function recordCommitFailure({
+  entryId,
+  error,
+  sessionId,
+  server
+}) {
+  const errorMessage = error instanceof Error ? error.message : String(error);
+  const logLine = `commitEntry failed for ${entryId}: ${errorMessage}${sessionId ? ` (session: ${sessionId})` : ""}`;
+  try {
+    await server.sendLoggingMessage({ level: "error", data: logLine, logger: "product-brain" });
+  } catch {
+  }
+  if (sessionId) {
+    try {
+      const tenName = `commitEntry failed for ${entryId} \u2014 ${errorMessage}`.slice(0, 250);
+      await kernelMutation("chain.createEntry", {
+        collectionSlug: "tensions",
+        name: tenName,
+        // Failure audit TENs intentionally stay draft — they need explicit human review,
+        // not auto-commit, even in Open mode.
+        status: "draft",
+        data: {},
+        createdBy: `agent:${sessionId}`,
+        sessionId
+      });
+    } catch {
+    }
+  }
+}
 var STOP_WORDS = /* @__PURE__ */ new Set([
   "the",
   "and",
@@ -7849,8 +7919,8 @@ function registerSessionTools(server) {
   server.registerTool(
     "session",
     {
-      title: "Session",
-      description: "Manage agent session lifecycle. Three actions:\n\n- **start**: Begin a tracked session. Creates attribution for this workspace. If a session is already active, it gets superseded. Write tools available after orient.\n- **close**: End the current session. Records structured data (entries created, modified, relations). If uncommitted drafts exist and wrapup hasn't run, shows a review summary. Run session-wrapup before closing.\n- **status**: Check current session \u2014 active or not, oriented, activity counts.",
+      title: "Session \u2014 Low-Level Lifecycle",
+      description: "Low-level session lifecycle management. **For user-facing 'begin a session', call `start_pb` instead** \u2014 it is the canonical opener and handles session start automatically.\n\nThree actions:\n\n- **start**: Low-level \u2014 begin a tracked session for attribution. Most agents should NOT call this directly; use `start_pb` which wraps it with stage-aware context. Use `session start` only for explicit session control (e.g. supersession after CLI work).\n- **close**: End the current session. Records structured data (entries created, modified, relations). If uncommitted drafts exist and wrapup hasn't run, shows a review summary. Run session-wrapup before closing.\n- **status**: Check current session \u2014 active or not, oriented, activity counts.",
       inputSchema: sessionSchema,
       annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
     },
@@ -10436,128 +10506,41 @@ function registerVerifyTools(server) {
   trackWriteTool(verifyEntryTool);
 }
 
-// src/tools/start.ts
+// src/tools/start_pb.ts
 import { z as z17 } from "zod";
 
-// src/presets/collections.ts
-var GOVERNANCE_CORE = [
-  {
-    slug: "principles",
-    name: "Principles",
-    description: "Higher-level beliefs that guide decision-making \u2014 the 'why' behind rules and standards. You reason from a principle.",
-    idPrefix: "PRI",
-    fields: [
-      { key: "description", label: "Description", type: "string", required: true, searchable: true },
-      { key: "rationale", label: "Rationale", type: "string", searchable: true },
-      { key: "category", label: "Category", type: "select", options: ["Product", "Engineering", "Design", "Business", "Operations"] },
-      { key: "severity", label: "Weight", type: "select", options: ["foundational", "high", "medium"] }
-    ]
-  },
-  {
-    slug: "standards",
-    name: "Standards",
-    description: "Conventions and norms about how work is done \u2014 naming patterns, coding styles, process steps. You lint for a standard.",
-    idPrefix: "STD",
-    fields: [
-      { key: "description", label: "Description", type: "string", required: true, searchable: true },
-      { key: "domain", label: "Domain", type: "string" },
-      { key: "severity", label: "Severity", type: "select", options: ["low", "medium", "high"] }
-    ]
-  },
-  {
-    slug: "business-rules",
-    name: "Business Rules",
-    description: "Concrete, enforceable constraints about how the system behaves \u2014 testable, specific, tied to code. You test for a rule.",
-    idPrefix: "BR",
-    fields: [
-      { key: "description", label: "Description", type: "string", required: true, searchable: true },
-      { key: "rationale", label: "Rationale", type: "string", searchable: true },
-      { key: "domain", label: "Domain", type: "string" },
-      { key: "severity", label: "Severity", type: "select", options: ["low", "medium", "high", "critical"] },
-      { key: "platforms", label: "Platforms", type: "array" }
-    ]
-  }
-];
-var COLLECTION_PRESETS = [
-  {
-    id: "software-product",
-    name: "Software Product",
-    description: "For teams building software products \u2014 glossary, features, architecture, tech debt, and API endpoints",
-    collections: [
-      ...GOVERNANCE_CORE,
-      { slug: "glossary", name: "Glossary", description: "Canonical terminology for the product domain", idPrefix: "GLO", fields: [{ key: "canonical", label: "Canonical", type: "string", required: true, searchable: true }, { key: "category", label: "Category", type: "select", options: ["Platform & Architecture", "Knowledge Management", "AI & Developer Tools", "Governance & Process"] }, { key: "confusedWith", label: "Confused With", type: "array" }] },
-      { slug: "features", name: "Features", description: "Product features and capabilities", idPrefix: "FEAT", fields: [{ key: "description", label: "Description", type: "string", required: true, searchable: true }, { key: "scope", label: "Scope", type: "string" }, { key: "area", label: "Area", type: "string" }, { key: "status", label: "Status", type: "select", options: ["proposed", "in-progress", "shipped", "deprecated"] }] },
-      { slug: "architecture", name: "Architecture", description: "System architecture layers and components", idPrefix: "ARCH", fields: [{ key: "description", label: "Description", type: "string", required: true, searchable: true }, { key: "layer", label: "Layer", type: "string" }, { key: "dependencies", label: "Dependencies", type: "array" }] },
-      { slug: "tech-debt", name: "Tech Debt", description: "Technical debt items to track and address", fields: [{ key: "description", label: "Description", type: "string", required: true, searchable: true }, { key: "severity", label: "Severity", type: "select", options: ["low", "medium", "high", "critical"] }, { key: "area", label: "Area", type: "string" }, { key: "effort", label: "Effort", type: "select", options: ["small", "medium", "large"] }] },
-      { slug: "api-endpoints", name: "API Endpoints", description: "REST/GraphQL endpoints and their contracts", fields: [{ key: "description", label: "Description", type: "string", required: true, searchable: true }, { key: "method", label: "Method", type: "select", options: ["GET", "POST", "PUT", "PATCH", "DELETE"] }, { key: "path", label: "Path", type: "string" }, { key: "auth", label: "Auth Required", type: "select", options: ["none", "api-key", "bearer", "session"] }] },
-      { slug: "decisions", name: "Decisions", description: "Significant decisions with rationale and context", idPrefix: "DEC", fields: [{ key: "rationale", label: "Rationale", type: "string", required: true, searchable: true }, { key: "date", label: "Date", type: "string" }, { key: "decidedBy", label: "Decided By", type: "string" }, { key: "alternatives", label: "Alternatives", type: "string" }] },
-      { slug: "tensions", name: "Tensions", description: "Friction points, pain points, and unmet needs", idPrefix: "TEN", fields: [{ key: "description", label: "Description", type: "string", required: true, searchable: true }, { key: "priority", label: "Priority", type: "select", options: ["low", "medium", "high", "critical"] }, { key: "severity", label: "Severity", type: "select", options: ["low", "medium", "high", "critical"] }] }
-    ]
-  },
-  {
-    id: "content-business",
-    name: "Content Business",
-    description: "For content creators, publishers, and media companies \u2014 topics, audience segments, content calendar, and brand voice",
-    collections: [
-      ...GOVERNANCE_CORE,
-      { slug: "glossary", name: "Glossary", description: "Industry terminology and brand language", fields: [{ key: "canonical", label: "Canonical", type: "string", required: true, searchable: true }, { key: "category", label: "Category", type: "string" }] },
-      { slug: "topics", name: "Topics", description: "Content topics and themes", fields: [{ key: "description", label: "Description", type: "string", required: true, searchable: true }, { key: "pillar", label: "Content Pillar", type: "string" }, { key: "stage", label: "Stage", type: "select", options: ["idea", "researching", "drafting", "published", "evergreen"] }] },
-      { slug: "audience-segments", name: "Audience Segments", description: "Target reader/viewer personas", fields: [{ key: "description", label: "Description", type: "string", required: true, searchable: true }, { key: "painPoints", label: "Pain Points", type: "string" }, { key: "channels", label: "Channels", type: "array" }] },
-      { slug: "brand-voice", name: "Brand Voice", description: "Tone, style, and voice guidelines", fields: [{ key: "description", label: "Description", type: "string", required: true, searchable: true }, { key: "doThis", label: "Do This", type: "string" }, { key: "notThis", label: "Not This", type: "string" }] },
-      { slug: "decisions", name: "Decisions", description: "Editorial and strategic decisions", fields: [{ key: "rationale", label: "Rationale", type: "string", required: true, searchable: true }, { key: "date", label: "Date", type: "string" }, { key: "decidedBy", label: "Decided By", type: "string" }] },
-      { slug: "tensions", name: "Tensions", description: "Content gaps, audience friction, and unmet needs", fields: [{ key: "description", label: "Description", type: "string", required: true, searchable: true }, { key: "priority", label: "Priority", type: "select", options: ["low", "medium", "high", "critical"] }] }
-    ]
-  },
-  {
-    id: "agency",
-    name: "Agency",
-    description: "For agencies managing multiple clients \u2014 client profiles, project scopes, deliverables, and processes",
-    collections: [
-      ...GOVERNANCE_CORE,
-      { slug: "glossary", name: "Glossary", description: "Agency and client terminology", fields: [{ key: "canonical", label: "Canonical", type: "string", required: true, searchable: true }, { key: "category", label: "Category", type: "string" }] },
-      { slug: "clients", name: "Clients", description: "Client profiles and relationship context", fields: [{ key: "description", label: "Description", type: "string", required: true, searchable: true }, { key: "industry", label: "Industry", type: "string" }, { key: "contact", label: "Primary Contact", type: "string" }] },
-      { slug: "deliverables", name: "Deliverables", description: "Standard deliverable types and templates", fields: [{ key: "description", label: "Description", type: "string", required: true, searchable: true }, { key: "type", label: "Type", type: "string" }, { key: "estimatedHours", label: "Estimated Hours", type: "string" }] },
-      { slug: "processes", name: "Processes", description: "Standard operating procedures and workflows", fields: [{ key: "description", label: "Description", type: "string", required: true, searchable: true }, { key: "steps", label: "Steps", type: "string" }, { key: "owner", label: "Owner", type: "string" }] },
-      { slug: "decisions", name: "Decisions", description: "Strategic and operational decisions", fields: [{ key: "rationale", label: "Rationale", type: "string", required: true, searchable: true }, { key: "date", label: "Date", type: "string" }] },
-      { slug: "tensions", name: "Tensions", description: "Process bottlenecks and client friction", fields: [{ key: "description", label: "Description", type: "string", required: true, searchable: true }, { key: "priority", label: "Priority", type: "select", options: ["low", "medium", "high", "critical"] }] }
-    ]
-  },
-  {
-    id: "saas-api",
-    name: "SaaS API",
-    description: "For API-first SaaS products \u2014 endpoints, schemas, rate limits, changelog, and integration guides",
-    collections: [
-      ...GOVERNANCE_CORE,
-      { slug: "glossary", name: "Glossary", description: "API and domain terminology", fields: [{ key: "canonical", label: "Canonical", type: "string", required: true, searchable: true }, { key: "category", label: "Category", type: "string" }] },
-      { slug: "api-endpoints", name: "API Endpoints", description: "API routes and contracts", fields: [{ key: "description", label: "Description", type: "string", required: true, searchable: true }, { key: "method", label: "Method", type: "select", options: ["GET", "POST", "PUT", "PATCH", "DELETE"] }, { key: "path", label: "Path", type: "string" }, { key: "auth", label: "Auth", type: "select", options: ["none", "api-key", "bearer", "oauth"] }] },
-      { slug: "schemas", name: "Schemas", description: "Data models and API schemas", fields: [{ key: "description", label: "Description", type: "string", required: true, searchable: true }, { key: "format", label: "Format", type: "select", options: ["json", "protobuf", "graphql", "openapi"] }, { key: "version", label: "Version", type: "string" }] },
-      { slug: "rate-limits", name: "Rate Limits", description: "Rate limiting policies and tiers", fields: [{ key: "description", label: "Description", type: "string", required: true, searchable: true }, { key: "tier", label: "Tier", type: "string" }, { key: "limit", label: "Limit", type: "string" }] },
-      { slug: "changelog", name: "Changelog", description: "API version history and breaking changes", fields: [{ key: "description", label: "Description", type: "string", required: true, searchable: true }, { key: "version", label: "Version", type: "string" }, { key: "date", label: "Date", type: "string" }, { key: "breaking", label: "Breaking", type: "select", options: ["yes", "no"] }] },
-      { slug: "decisions", name: "Decisions", description: "API design decisions and rationale", fields: [{ key: "rationale", label: "Rationale", type: "string", required: true, searchable: true }, { key: "date", label: "Date", type: "string" }] }
-    ]
-  },
-  {
-    id: "general",
-    name: "General",
-    description: "A minimal starter set \u2014 glossary, decisions, tensions, and governance. Add more collections as you need them.",
-    collections: [
-      ...GOVERNANCE_CORE,
-      { slug: "glossary", name: "Glossary", description: "Canonical terminology", fields: [{ key: "canonical", label: "Canonical", type: "string", required: true, searchable: true }, { key: "category", label: "Category", type: "string" }] },
-      { slug: "decisions", name: "Decisions", description: "Decisions with rationale", fields: [{ key: "rationale", label: "Rationale", type: "string", required: true, searchable: true }, { key: "date", label: "Date", type: "string" }, { key: "decidedBy", label: "Decided By", type: "string" }] },
-      { slug: "tensions", name: "Tensions", description: "Friction points and unmet needs", fields: [{ key: "description", label: "Description", type: "string", required: true, searchable: true }, { key: "priority", label: "Priority", type: "select", options: ["low", "medium", "high", "critical"] }] }
-    ]
-  }
-];
-function getPreset(id) {
-  return COLLECTION_PRESETS.find((p) => p.id === id);
-}
-function listPresets() {
-  return COLLECTION_PRESETS.map((p) => ({
-    id: p.id,
-    name: p.name,
-    description: p.description,
-    collectionCount: p.collections.length
-  }));
+// src/tools/skills.ts
+import { z as z16 } from "zod";
+var skillsSchema = z16.object({
+  entryId: z16.string().min(1).describe(
+    "Workspace-scoped skill entry id (e.g. 'SKILL-pb-setup'). The tool refuses non-skill entries (canonicalKey !== 'skill') with INVALID_KIND."
+  )
+});
+async function loadSkillBody(entryId) {
+  const workspaceId = await getWorkspaceId();
+  return await kernelQuery("setup.getSkillBody", {
+    workspaceId,
+    entryId
+  });
+}
+function registerSkillsTools(server) {
+  server.registerTool(
+    "skills",
+    {
+      title: "Load workspace skill body",
+      description: "Loads the markdown body of a SKILL-* entry from the current workspace. Generic loader: works for ANY skill in your workspace \u2014 no allow-list, no pb-setup-specific behavior. Use this when an agent or MCP client needs the canonical body of a skill (e.g. SKILL-pb-setup, SKILL-shape, SKILL-review). Returns markdown plus name + retrievedAt for caching.",
+      inputSchema: skillsSchema,
+      annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false }
+    },
+    thinWrapper(async ({ entryId }) => {
+      const result = await loadSkillBody(entryId);
+      const summary = `Loaded ${result.entryId} (${result.body.length} chars).`;
+      return {
+        content: textContent(result.body),
+        structuredContent: success(summary, result)
+      };
+    })
+  );
 }
 
 // src/tools/planned-work.ts
@@ -11015,75 +10998,6 @@ function formatWhatNeedsAttentionBrief(wna) {
   return lines;
 }
 
-// src/tools/start-interview.ts
-import { z as z16 } from "zod";
-var interviewExtractionSchema = z16.object({
-  vision: z16.string().min(10).describe("What they're building \u2014 concise product purpose statement"),
-  audience: z16.string().optional().describe("Who it's for \u2014 primary user or customer segment"),
-  techStack: z16.array(z16.string()).optional().describe("Key technologies, frameworks, or platforms (e.g. ['SvelteKit', 'Convex', 'PostgreSQL'])"),
-  keyTerms: z16.array(z16.string()).optional().describe("Domain-specific terms that belong in the glossary"),
-  keyDecisions: z16.array(z16.string()).optional().describe("Recent significant decisions made (each as a concise statement)"),
-  tensions: z16.array(z16.string()).optional().describe("Pain points or friction the product is solving")
-});
-function getInterviewInstructions(workspaceName) {
-  return {
-    systemPrompt: `You are activating the **${workspaceName}** Product Brain. Ask 1\u20132 focused questions, then extract structured knowledge and batch-capture it. Let the user talk naturally \u2014 you do the structuring. In Open governance mode, entries commit automatically. In consensus/role mode, they stay as drafts for review.`,
-    question1: `**What are you building, and who is it for?** A sentence or two is plenty \u2014 I'll pull out the structure.`,
-    question2: `**What's one word or phrase that would trip someone up if they didn't know your world?** (That becomes your first glossary term \u2014 the one that saves explanations later.)`,
-    extractionGuidance: `After the user answers, extract:
-- vision: the core product purpose (required)
-- audience: who it's for (optional)
-- techStack: technologies mentioned (optional, array)
-- keyTerms: domain terms \u2014 Q2 answer goes here (optional, array)
-- keyDecisions: any decisions stated (optional, array)
-- tensions: any pain points stated (optional, array)
-
-Map to batch-capture entries:
-- vision \u2192 strategy ("Product Vision")
-- audience \u2192 audiences (1 entry)
-- techStack \u2192 architecture ("Tech Stack") + top 3 terms \u2192 glossary
-- keyTerms \u2192 glossary (1 per term)
-- keyDecisions \u2192 decisions (1 per decision)
-- tensions \u2192 tensions (1 per tension)`,
-    captureInstructions: `Call batch-capture with the extracted entries. Omit \`autoCommit\` to follow workspace governance automatically, or pass \`autoCommit: false\` if the user wants review-first. Keep descriptions concise (1\u20132 sentences each). Prefer 8 good entries over 15 mediocre ones \u2014 quality over volume. If batch-capture returns failedEntries, tell the user and retry individually.`,
-    qualityNote: (
-      // FEAT-149: Retrieval-First Proof Moment.
-      // The aha is friction elimination ("I'll never have to explain this again"),
-      // not recognition ("it remembered me"). Simulate a FUTURE session, not a recap.
-      `After capturing, silently call graph action=suggest on the strategy or architecture entry to build connections.
-
-**Then demonstrate the proof moment \u2014 this is the most important step:**
-Based on what the user told you, invent a specific, plausible development task they might actually do next (e.g. "add user authentication" for a SaaS app, "build the recommendation engine" for a marketplace, "set up the API layer" for a developer tool). Call \`context action=gather task="<your invented task>"\` to load their captured knowledge.
-
-Present with the "tomorrow" framing \u2014 simulate a future session, not a recap:
-"Okay \u2014 let me show you what just changed. Tomorrow, if you open a new tab and ask me to help with **<task>**, I'd already know:
-- [vision applied to that task \u2014 one sentence]
-- [ICP applied \u2014 who this feature is for in their context]
-- [any key term that matters for this task]
-
-That's context you won't have to explain again."
-
-End with: "**Try it right now** \u2014 ask me something you'd normally have to re-explain first. I'll answer like I've known your product for months."`
-    ),
-    scanOffer: `After the proof moment, offer the codebase scan:
-"Want me to learn more? I can read your project files \u2014 README, package.json, source structure \u2014 and pick up technical decisions, conventions, and architecture I missed. Takes about two minutes."`
-  };
-}
-function buildInterviewResponse(workspaceName) {
-  const instructions = getInterviewInstructions(workspaceName);
-  return [
-    "## Let's get to know your product",
-    "",
-    instructions.systemPrompt,
-    "",
-    "I'll ask you one or two questions. Your answers become the foundation of your Brain.",
-    "",
-    instructions.question1,
-    "",
-    "_Take your time \u2014 I'll pull out the structure from whatever you say._"
-  ].join("\n");
-}
-
 // src/lib/gapToPrompt.ts
 function cleanLabel(label) {
   return label.replace(/ has entries$/i, "").replace(/ coverage$/i, "").replace(/^Strategy — /i, "");
@@ -11111,28 +11025,19 @@ function formatTopGapPrompt(gap, remaining, ctx) {
   ];
   return lines.join("\n");
 }
-function formatGapList(gaps, limit = 3) {
-  const topGaps = gaps.slice(0, limit);
-  if (topGaps.length === 0) return [];
-  const lines = [
-    "Here's where your Brain would benefit most:",
-    ""
-  ];
-  for (let i = 0; i < topGaps.length; i++) {
-    const gap = topGaps[i];
-    const prompt = gap.capabilityGuidance ?? gap.guidance;
-    const label = cleanLabel(gap.label);
-    lines.push(`${i + 1}. **${label}** \u2014 ${prompt}`);
-  }
-  return lines;
-}
 function formatGapOneLiner(gap) {
   if (!gap) return null;
   const prompt = gap.capabilityGuidance ?? gap.guidance;
   return `Next gap: ${prompt}`;
 }
 
-// src/tools/start.ts
+// src/tools/start_pb.ts
+var startPbSchema = z17.object({
+  task: z17.string().optional().describe(
+    "What you're about to work on (e.g. 'implementing auth middleware'). Grounded/connected workspaces: filters governance to show relevant principles, standards, and business rules. Blank/seeded workspaces: ignored (setup flow takes over)."
+  )
+});
+var PB_SETUP_SKILL_ENTRY_ID = "SKILL-pb-setup";
 async function tryMarkOriented(agentSessionId, coherenceSnapshot) {
   if (!agentSessionId) return { oriented: false, orientationStatus: "no_session" };
   try {
@@ -11155,312 +11060,16 @@ async function tryMarkOriented(agentSessionId, coherenceSnapshot) {
     }
   }
 }
-var startSchema = z17.object({
-  preset: z17.string().optional().describe(
-    "Collection preset ID to seed (e.g. 'software-product', 'content-business', 'agency', 'saas-api', 'general'). Only used for fresh workspaces. If omitted on a fresh workspace, returns the preset menu."
-  ),
-  task: z17.string().optional().describe(
-    "What you're about to work on (e.g. 'implementing auth middleware', 'refactoring the API layer'). Filters governance to show only relevant principles, standards, and business rules."
-  )
-});
-function registerStartTools(server) {
-  server.registerTool(
-    "start",
-    {
-      title: "Start Product Brain",
-      description: "The zero-friction entry point. Say 'start PB' to begin.\n\n- **Fresh workspace (blank)**: asks what you're building, captures the essentials, and can scan your codebase if useful.\n- **Early workspace (seeded)**: picks up where you left off with the top gaps to fill.\n- **Active workspace (grounded/connected)**: standup briefing with recent activity and open items.\n\nUse this as your first call. Replaces the need to call orient or health separately.",
-      inputSchema: startSchema,
-      annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false }
-    },
-    thinWrapper(async ({ preset, task }) => {
-      const errors = [];
-      const agentSessionId = getAgentSessionId();
-      let wsCtx = null;
-      try {
-        wsCtx = await getWorkspaceContext();
-      } catch (e) {
-        errors.push(`Workspace: ${e instanceof Error ? e.message : String(e)}`);
-      }
-      if (!wsCtx) {
-        const text = "# Could not connect to Product Brain\n\n" + (errors.length > 0 ? errors.map((e) => `- ${e}`).join("\n") : "Check your API key and CONVEX_SITE_URL.");
-        return {
-          content: [{ type: "text", text }],
-          structuredContent: failure(
-            "BACKEND_UNAVAILABLE",
-            "Could not connect to Product Brain.",
-            "Check your API key and CONVEX_SITE_URL."
-          )
-        };
-      }
-      let stage = null;
-      let readiness = null;
-      try {
-        readiness = await kernelQuery("chain.workspaceReadiness");
-        stage = readiness?.stage ?? "blank";
-      } catch {
-        errors.push("Readiness check unavailable \u2014 showing workspace summary.");
-      }
-      if (stage === "blank" && preset) {
-        const result = await seedPreset(wsCtx, preset, agentSessionId);
-        return {
-          content: [{ type: "text", text: result.text }],
-          structuredContent: result.structuredContent
-        };
-      }
-      if (stage === "blank") {
-        const { oriented, orientationStatus } = await tryMarkOriented(agentSessionId);
-        const blankResult = buildBlankResponse(wsCtx, {
-          oriented,
-          orientationStatus,
-          ...agentSessionId ? { sessionId: agentSessionId } : {}
-        });
-        return {
-          content: [{ type: "text", text: blankResult.text }],
-          structuredContent: blankResult.structuredContent
-        };
-      }
-      if (stage === "seeded") {
-        const result = await buildSeededResponse(wsCtx, readiness, agentSessionId);
-        void kernelMutation("chain.setOnboardingCompleted", {}).catch(() => {
-        });
-        return {
-          content: [{ type: "text", text: result.text }],
-          structuredContent: result.structuredContent
-        };
-      }
-      if (stage === "grounded" || stage === "connected") {
-        void kernelMutation("chain.setOnboardingCompleted", {}).catch(() => {
-        });
-      }
-      const orientResult = await buildOrientResponse(wsCtx, agentSessionId, errors, task);
-      return {
-        content: [{ type: "text", text: orientResult.text }],
-        structuredContent: orientResult.structuredContent
-      };
-    })
-  );
-}
-function buildBlankResponse(wsCtx, sessionCtx) {
-  const instructions = getInterviewInstructions(wsCtx.workspaceName);
-  const presetList = listPresets();
-  const presets = presetList.map((p) => p.id).join(", ");
-  const text = [
-    // ── User-facing welcome — present this to the user ─────────────────
-    `# Welcome to ${wsCtx.workspaceName}`,
-    "",
-    "Your workspace is fresh. Let's bring it to life.",
-    "",
-    "Tell me what you're building \u2014 paste a doc, describe it in a sentence, or say **scan my codebase**.",
-    "",
-    "_Powered by [Product Brain](https://productbrain.io) \u2014 your AI's product context layer._",
-    "",
-    "---",
-    "",
-    // ── Agent instructions — follow these exactly, do not present them ──
-    "## Agent Instructions",
-    "",
-    "### Step 1 \u2014 Open with their name (FLO-1)",
-    `Ask: _"What should I call you?"_ before asking about the product. Use their name throughout.`,
-    "",
-    "### Step 2 \u2014 Detect path from their first response (no menu, no numbered options)",
-    "",
-    "Read signals from the user's first substantive message and branch silently:",
-    "",
-    "**document** \u2014 paste >200 words, markdown headers, or says 'here's my doc/brief/spec'",
-    "\u2192 Extract vision, audience, keyTerms, keyDecisions, tensions from the document.",
-    "\u2192 Present a numbered confirmation list before capturing. Capture only confirmed entries.",
-    "\u2192 Fallback: if sparse or unclear, switch to interview path.",
-    "",
-    "**codebase** \u2014 mentions 'scan', 'codebase', README, or provides a file path",
-    `\u2192 First ask: _"Tell me one thing about this product that's not obvious from the code \u2014 what's it actually for?"_`,
-    "\u2192 Then read: README.md, package.json / pyproject.toml / Cargo.toml, top-level source dirs.",
-    "\u2192 Infer 5\u20138 entries. Present numbered list for confirmation. Capture only confirmed entries.",
-    "\u2192 Fallback: if no README or empty project, immediately switch to interview path.",
-    "",
-    `**preset** \u2014 mentions a domain keyword (SaaS, agency, content business, API)`,
-    `\u2192 Confirm which preset fits. Available: ${presets}.`,
-    "\u2192 Call `start` with `preset: '<chosen-preset>'`.",
-    "\u2192 Fallback: if no preset matches or seeding fails, switch to interview path.",
-    "",
-    "**interview** (default \u2014 1\u20135 sentence description or anything else)",
-    `\u2192 ${instructions.systemPrompt}`,
-    `\u2192 Q1: ${instructions.question1}`,
-    `\u2192 Q2 (optional): _"What's one word or phrase that would trip someone up if they didn't know your context?"_ (This becomes their first glossary term.)`,
-    instructions.extractionGuidance,
-    `\u2192 ${instructions.captureInstructions}`,
-    "\u2192 Omit `autoCommit` \u2014 workspace governance applies automatically.",
-    "",
-    "### Step 3 \u2014 Proof moment (most important \u2014 run after every path)",
-    "",
-    instructions.qualityNote,
-    "",
-    "### Step 4 \u2014 Deepen (offer after proof moment)",
-    "",
-    instructions.scanOffer,
-    "If they say yes, scan README.md, package.json/pyproject.toml/Cargo.toml, and top-level source dirs.",
-    "Infer entries with the product context you now have. Present as a numbered list for confirmation.",
-    "Capture only confirmed entries."
-  ].join("\n");
-  return {
-    text,
-    structuredContent: success(
-      "Workspace is blank. Ready for activation \u2014 interview, document, codebase scan, or preset.",
-      {
-        stage: "blank",
-        interviewSchema: {
-          fields: ["vision", "audience", "techStack", "keyTerms", "keyDecisions", "tensions"],
-          mapping: {
-            vision: "strategy",
-            audience: "audiences",
-            techStack: "architecture + top 3 terms \u2192 glossary",
-            keyTerms: "glossary",
-            keyDecisions: "decisions",
-            tensions: "tensions"
-          }
-        },
-        availablePresets: presetList.map((p) => ({ id: p.id, name: p.name })),
-        ...sessionCtx
-      },
-      [
-        { tool: "capture", description: "Capture product knowledge", parameters: {} },
-        { tool: "start", description: "Seed with a preset", parameters: { preset: "software-product" } }
-      ]
-    )
-  };
-}
-async function buildSeededResponse(wsCtx, readiness, agentSessionId) {
-  const stage = readiness?.stage ?? "seeded";
-  const score = readiness?.score ?? null;
-  const gaps = readiness?.gaps ?? [];
-  const lines = [
-    `# ${wsCtx.workspaceName}`,
-    "_Picking up where you left off._",
-    ""
-  ];
-  if (gaps.length > 0) {
-    const gapLines = formatGapList(gaps, 3);
-    lines.push(...gapLines);
-    lines.push("");
-    lines.push("Pick any to start \u2014 or begin with **#1** and I'll guide you through it.");
-  } else {
-    lines.push("No gaps detected \u2014 your workspace is filling up nicely. What would you like to work on?");
-  }
-  const knowledgeGaps = getTopGaps(3);
-  if (knowledgeGaps.length > 0) {
-    lines.push("");
-    lines.push("### Learning Opportunities");
-    lines.push("_Topics agents recently looked for but aren't on the Chain yet:_");
-    lines.push("");
-    for (const gap of knowledgeGaps) {
-      const freq = gap.count > 1 ? ` _(${gap.count}x)_` : "";
-      lines.push(`- **${gap.query}**${freq}`);
-    }
-    lines.push("");
-    lines.push("_Capturing these will make future sessions more effective._");
-  }
-  const { oriented, orientationStatus } = await tryMarkOriented(agentSessionId);
-  const next = gaps.length > 0 ? [{ tool: "capture", description: `Fill gap: ${gaps[0].label}`, parameters: {} }] : [];
-  return {
-    text: lines.join("\n"),
-    structuredContent: success(
-      gaps.length > 0 ? `Workspace seeded. ${gaps.length} gap${gaps.length === 1 ? "" : "s"} to fill. Top: ${gaps[0].label}.` : `Workspace seeded. No gaps detected.`,
-      {
-        stage,
-        readinessScore: score ?? null,
-        totalGaps: gaps.length,
-        topGapLabels: gaps.slice(0, 3).map((g) => g.label),
-        oriented,
-        orientationStatus,
-        ...agentSessionId ? { sessionId: agentSessionId } : {}
-      },
-      next.length > 0 ? next : void 0
-    )
-  };
-}
-async function seedPreset(wsCtx, presetId, agentSessionId) {
-  const preset = getPreset(presetId);
-  if (!preset) {
-    return {
-      text: `Preset "${presetId}" not found.
-
-Available presets: ${listPresets().map((p) => `\`${p.id}\``).join(", ")}`,
-      structuredContent: failure(
-        "NOT_FOUND",
-        `Preset '${presetId}' not found.`,
-        `Available presets: ${listPresets().map((p) => p.id).join(", ")}.`,
-        [{ tool: "start", description: "Start with a preset", parameters: { preset: "software-product" } }]
-      )
-    };
-  }
-  const seeded = [];
-  const skipped = [];
-  for (const col of preset.collections) {
-    try {
-      const purpose = col.purpose ?? col.description;
-      await kernelCall("chain.createCollection", {
-        slug: col.slug,
-        name: col.name,
-        description: col.description,
-        purpose,
-        icon: col.icon,
-        idPrefix: col.idPrefix,
-        fields: col.fields,
-        createdBy: "preset:" + presetId
-      });
-      seeded.push(col.name);
-    } catch {
-      skipped.push(`${col.name} (already exists)`);
-    }
-  }
-  const { oriented, orientationStatus } = await tryMarkOriented(agentSessionId);
-  const lines = [
-    `# ${wsCtx.workspaceName} is ready`,
-    "",
-    `Seeded **${preset.name}** preset with ${seeded.length} collection${seeded.length === 1 ? "" : "s"}:`,
-    ""
-  ];
-  for (const name of seeded) {
-    lines.push(`- ${name}`);
-  }
-  if (skipped.length > 0) {
-    lines.push("", "Skipped (already exist):");
-    for (const name of skipped) {
-      lines.push(`- ${name}`);
-    }
-  }
-  lines.push(
-    "",
-    buildInterviewResponse(wsCtx.workspaceName),
-    "",
-    "_You can also customize your collections anytime \u2014 just ask._"
-  );
-  return {
-    text: lines.join("\n"),
-    structuredContent: success(
-      `Seeded '${preset.name}' preset with ${seeded.length} collection${seeded.length === 1 ? "" : "s"}.`,
-      {
-        stage: "blank",
-        preset: presetId,
-        seededCollections: seeded,
-        skippedCollections: skipped,
-        oriented,
-        orientationStatus,
-        ...agentSessionId ? { sessionId: agentSessionId } : {}
-      },
-      [{ tool: "capture", description: "Capture your first entry", parameters: {} }]
-    )
-  };
+function isActiveNowBet(e) {
+  const status = e.status ?? e.data?.status;
+  const horizon = e.data?.horizon;
+  return status === "active" && horizon === "now";
 }
 function computeWorkspaceAge(createdAt) {
   if (!createdAt) return { ageDays: 0, isNeglected: false };
   const ageDays = Math.floor((Date.now() - createdAt) / (1e3 * 60 * 60 * 24));
   return { ageDays, isNeglected: ageDays >= 30 };
 }
-function isActiveNowBet(e) {
-  const status = e.status ?? e.data?.status;
-  const horizon = e.data?.horizon;
-  return status === "active" && horizon === "now";
-}
 function pickNextTensionPrompt(openTensions) {
   if (openTensions.length === 0) return null;
   const t = openTensions[0];
@@ -11469,9 +11078,32 @@ function pickNextTensionPrompt(openTensions) {
     cta: "Want to discuss this tension or capture a decision about it?"
   };
 }
+async function buildSetupResponse(agentSessionId) {
+  await kernelMutation(
+    "setup.stampMcpOnlySurface",
+    {}
+  );
+  const skill = await loadSkillBody(PB_SETUP_SKILL_ENTRY_ID);
+  const { oriented, orientationStatus } = await tryMarkOriented(agentSessionId);
+  return {
+    text: skill.body,
+    structuredContent: success(
+      `pb-setup ready. Delivering SKILL-pb-setup body (${skill.body.length} chars).`,
+      {
+        bootstrap: "pb-setup",
+        skillEntryId: skill.entryId,
+        skillBody: skill.body,
+        stage: "setup",
+        oriented,
+        orientationStatus,
+        ...agentSessionId ? { sessionId: agentSessionId } : {},
+        instructions: "Read skillBody and follow it; use commit-entry/entries/orient MCP tools per PAT-227."
+      }
+    )
+  };
+}
 async function buildOrientResponse(wsCtx, agentSessionId, errors, task) {
-  const wsFullCtx = await getWorkspaceContext();
-  const { ageDays, isNeglected } = computeWorkspaceAge(wsFullCtx.createdAt);
+  const { ageDays, isNeglected } = computeWorkspaceAge(wsCtx.createdAt ?? null);
   let priorSessions = [];
   let recoveryBlock = null;
   try {
@@ -11496,7 +11128,7 @@ async function buildOrientResponse(wsCtx, agentSessionId, errors, task) {
   const isLowReadiness = readiness !== null && readiness.score < 50;
   const isHighReadiness = readiness !== null && readiness.score >= 50;
   const stage = readiness?.stage ?? null;
-  const captureBehaviorNote = wsFullCtx.governanceMode === "open" ? "_In Open mode, user-authored captures commit immediately unless you ask me to keep them as drafts._" : "_Everything I capture stays pending until you confirm._";
+  const captureBehaviorNote = wsCtx.governanceMode === "open" ? "_In Open mode, user-authored captures commit immediately unless you ask me to keep them as drafts._" : "_Everything I capture stays pending until you confirm._";
   const coherence = buildCoherenceSection();
   let allCollections = [];
   try {
@@ -11695,6 +11327,61 @@ async function buildOrientResponse(wsCtx, agentSessionId, errors, task) {
     )
   };
 }
+function registerStartPbTools(server) {
+  server.registerTool(
+    "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.",
+      inputSchema: startPbSchema,
+      annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false }
+    },
+    thinWrapper(async ({ task }) => {
+      const errors = [];
+      const agentSessionId = getAgentSessionId();
+      let wsCtx = null;
+      try {
+        wsCtx = await getWorkspaceContext();
+      } catch (e) {
+        errors.push(`Workspace: ${e instanceof Error ? e.message : String(e)}`);
+      }
+      if (!wsCtx) {
+        const text = "# Could not connect to Product Brain\n\n" + (errors.length > 0 ? errors.map((e) => `- ${e}`).join("\n") : "Check your API key and CONVEX_SITE_URL.");
+        return {
+          content: [{ type: "text", text }],
+          structuredContent: failure(
+            "BACKEND_UNAVAILABLE",
+            "Could not connect to Product Brain.",
+            "Check your API key and CONVEX_SITE_URL."
+          )
+        };
+      }
+      let stage = null;
+      try {
+        const readiness = await kernelQuery("chain.workspaceReadiness");
+        stage = readiness?.stage ?? "blank";
+      } catch {
+        errors.push("Readiness check unavailable \u2014 showing workspace summary.");
+      }
+      if (stage === "blank" || stage === "seeded") {
+        const result = await buildSetupResponse(agentSessionId);
+        return {
+          content: textContent(result.text),
+          structuredContent: result.structuredContent
+        };
+      }
+      if (stage === "grounded" || stage === "connected") {
+        void kernelMutation("chain.setOnboardingCompleted", {}).catch(() => {
+        });
+      }
+      const orientResult = await buildOrientResponse(wsCtx, agentSessionId, errors, task);
+      return {
+        content: [{ type: "text", text: orientResult.text }],
+        structuredContent: orientResult.structuredContent
+      };
+    })
+  );
+}
 
 // src/tools/usage.ts
 import { z as z18 } from "zod";
@@ -13062,139 +12749,141 @@ ${nodeDetail}${flowLines}`
       return unknownAction(action, ["show", "explore", "flow"]);
     })
   );
-  const archAdminTool = server.registerTool(
-    "architecture-admin",
-    {
-      title: "Architecture Admin",
-      description: "Architecture maintenance \u2014 seed the default architecture data or run a dependency health check.\n\nActions:\n- `seed`: Populate the architecture collection with the default Product OS map. Safe to re-run.\n- `check`: Scan the codebase for dependency direction violations against layer rules.",
-      inputSchema: architectureAdminSchema,
-      annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false }
-    },
-    thinWrapper(async ({ action }) => {
-      if (action === "seed") {
-        await ensureCollection();
-        const existing = await listArchEntries();
-        const existingIds = new Set(existing.map((e) => e.entryId));
-        let created = 0;
-        let updated = 0;
-        let unchanged = 0;
-        const allWarnings = [];
-        const allSeeds = [
-          { ...SEED_TEMPLATE, order: 0, status: "active" },
-          ...SEED_LAYERS.map((l) => ({ ...l, status: "active" })),
-          ...SEED_NODES.map((n) => ({ ...n, status: "active" })),
-          ...SEED_FLOWS.map((f) => ({ ...f, status: "active" }))
-        ];
-        for (const seed of allSeeds) {
-          if (existingIds.has(seed.entryId)) {
-            const existingEntry = existing.find((e) => e.entryId === seed.entryId);
-            const existingData = existingEntry?.data ?? {};
-            const seedData = seed.data;
-            const hasChanges = Object.keys(seedData).some(
-              (k) => seedData[k] !== void 0 && existingData[k] !== seedData[k]
-            );
-            if (hasChanges) {
-              const mergedData = { ...existingData, ...seedData };
-              const updateResult = await kernelMutation("chain.updateEntry", { entryId: seed.entryId, data: mergedData });
-              if (updateResult.normalizationWarnings.length > 0 || updateResult.validationWarnings.length > 0) {
-                allWarnings.push({
-                  entryId: seed.entryId,
-                  normalizationWarnings: updateResult.normalizationWarnings,
-                  validationWarnings: updateResult.validationWarnings
-                });
+  if (process.env.PB_INTERNAL === "true") {
+    const archAdminTool = server.registerTool(
+      "architecture-admin",
+      {
+        title: "Architecture Admin",
+        description: "Architecture maintenance \u2014 seed the default architecture data or run a dependency health check.\n\nActions:\n- `seed`: Populate the architecture collection with the default Product OS map. Safe to re-run.\n- `check`: Scan the codebase for dependency direction violations against layer rules.",
+        inputSchema: architectureAdminSchema,
+        annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: false }
+      },
+      thinWrapper(async ({ action }) => {
+        if (action === "seed") {
+          await ensureCollection();
+          const existing = await listArchEntries();
+          const existingIds = new Set(existing.map((e) => e.entryId));
+          let created = 0;
+          let updated = 0;
+          let unchanged = 0;
+          const allWarnings = [];
+          const allSeeds = [
+            { ...SEED_TEMPLATE, order: 0, status: "active" },
+            ...SEED_LAYERS.map((l) => ({ ...l, status: "active" })),
+            ...SEED_NODES.map((n) => ({ ...n, status: "active" })),
+            ...SEED_FLOWS.map((f) => ({ ...f, status: "active" }))
+          ];
+          for (const seed of allSeeds) {
+            if (existingIds.has(seed.entryId)) {
+              const existingEntry = existing.find((e) => e.entryId === seed.entryId);
+              const existingData = existingEntry?.data ?? {};
+              const seedData = seed.data;
+              const hasChanges = Object.keys(seedData).some(
+                (k) => seedData[k] !== void 0 && existingData[k] !== seedData[k]
+              );
+              if (hasChanges) {
+                const mergedData = { ...existingData, ...seedData };
+                const updateResult = await kernelMutation("chain.updateEntry", { entryId: seed.entryId, data: mergedData });
+                if (updateResult.normalizationWarnings.length > 0 || updateResult.validationWarnings.length > 0) {
+                  allWarnings.push({
+                    entryId: seed.entryId,
+                    normalizationWarnings: updateResult.normalizationWarnings,
+                    validationWarnings: updateResult.validationWarnings
+                  });
+                }
+                updated++;
+              } else {
+                unchanged++;
               }
-              updated++;
-            } else {
-              unchanged++;
+              continue;
             }
-            continue;
-          }
-          const createResult = await kernelMutation("chain.createEntry", {
-            collectionSlug: COLLECTION_SLUG,
-            entryId: seed.entryId,
-            name: seed.name,
-            status: seed.status,
-            data: seed.data,
-            order: seed.order ?? 0
-          });
-          if (createResult.normalizationWarnings.length > 0 || createResult.validationWarnings.length > 0) {
-            allWarnings.push({
+            const createResult = await kernelMutation("chain.createEntry", {
+              collectionSlug: COLLECTION_SLUG,
               entryId: seed.entryId,
-              normalizationWarnings: createResult.normalizationWarnings,
-              validationWarnings: createResult.validationWarnings
+              name: seed.name,
+              status: seed.status,
+              data: seed.data,
+              order: seed.order ?? 0
             });
+            if (createResult.normalizationWarnings.length > 0 || createResult.validationWarnings.length > 0) {
+              allWarnings.push({
+                entryId: seed.entryId,
+                normalizationWarnings: createResult.normalizationWarnings,
+                validationWarnings: createResult.validationWarnings
+              });
+            }
+            created++;
           }
-          created++;
-        }
-        let responseText = `# Architecture Seeded
+          let responseText = `# Architecture Seeded
 
 **Created:** ${created} entries
 **Updated:** ${updated} (merged new fields)
 **Unchanged:** ${unchanged}
 
 Use \`architecture action=show\` to view the map.`;
-        if (allWarnings.length > 0) {
-          responseText += "\n\n---\n\n\u26A0\uFE0F **Seed warnings:**";
-          for (const w of allWarnings) {
-            for (const nw of w.normalizationWarnings) {
-              responseText += `
+          if (allWarnings.length > 0) {
+            responseText += "\n\n---\n\n\u26A0\uFE0F **Seed warnings:**";
+            for (const w of allWarnings) {
+              for (const nw of w.normalizationWarnings) {
+                responseText += `
   - **${w.entryId}** (normalization): ${nw}`;
-            }
-            for (const vw of w.validationWarnings) {
-              responseText += `
+              }
+              for (const vw of w.validationWarnings) {
+                responseText += `
   - **${w.entryId}** (validation): ${vw}`;
+              }
             }
           }
-        }
-        return {
-          content: [{
-            type: "text",
-            text: responseText
-          }],
-          structuredContent: success(
-            `Architecture seeded: ${created} created, ${updated} updated, ${unchanged} unchanged.`,
-            { created, updated, unchanged },
-            [{ tool: "architecture", description: "View the map", parameters: { action: "show" } }]
-          )
-        };
-      }
-      if (action === "check") {
-        const projectRoot = resolveProjectRoot();
-        if (!projectRoot) {
           return {
             content: [{
               type: "text",
-              text: "# Scan Failed\n\nCannot find project root (looked for `convex/schema.ts` in cwd and parent). Set `WORKSPACE_PATH` env var to the absolute path of the Product OS project root."
+              text: responseText
             }],
-            structuredContent: failure(
-              "VALIDATION_ERROR",
-              "Cannot find project root.",
-              "Set WORKSPACE_PATH env var to the absolute path of the Product OS project root."
+            structuredContent: success(
+              `Architecture seeded: ${created} created, ${updated} updated, ${unchanged} unchanged.`,
+              { created, updated, unchanged },
+              [{ tool: "architecture", description: "View the map", parameters: { action: "show" } }]
             )
           };
         }
-        await ensureCollection();
-        const all = await listArchEntries();
-        const layers = byTag(all, "layer");
-        const nodes = byTag(all, "node");
-        const result = scanDependencies(projectRoot, layers, nodes);
-        return {
-          content: [{ type: "text", text: formatScanReport(result) }],
-          structuredContent: success(
-            result.violations.length === 0 ? `Health check passed: 0 violations across ${result.filesScanned} files.` : `Health check found ${result.violations.length} violation(s) across ${result.filesScanned} files.`,
-            {
-              violations: result.violations.length,
-              filesScanned: result.filesScanned,
-              importsChecked: result.importsChecked,
-              unmappedImports: result.unmappedImports
-            }
-          )
-        };
-      }
-      return unknownAction(action, ["seed", "check"]);
-    })
-  );
-  trackWriteTool(archAdminTool);
+        if (action === "check") {
+          const projectRoot = resolveProjectRoot();
+          if (!projectRoot) {
+            return {
+              content: [{
+                type: "text",
+                text: "# Scan Failed\n\nCannot find project root (looked for `convex/schema.ts` in cwd and parent). Set `WORKSPACE_PATH` env var to the absolute path of the Product OS project root."
+              }],
+              structuredContent: failure(
+                "VALIDATION_ERROR",
+                "Cannot find project root.",
+                "Set WORKSPACE_PATH env var to the absolute path of the Product OS project root."
+              )
+            };
+          }
+          await ensureCollection();
+          const all = await listArchEntries();
+          const layers = byTag(all, "layer");
+          const nodes = byTag(all, "node");
+          const result = scanDependencies(projectRoot, layers, nodes);
+          return {
+            content: [{ type: "text", text: formatScanReport(result) }],
+            structuredContent: success(
+              result.violations.length === 0 ? `Health check passed: 0 violations across ${result.filesScanned} files.` : `Health check found ${result.violations.length} violation(s) across ${result.filesScanned} files.`,
+              {
+                violations: result.violations.length,
+                filesScanned: result.filesScanned,
+                importsChecked: result.importsChecked,
+                unmappedImports: result.unmappedImports
+              }
+            )
+          };
+        }
+        return unknownAction(action, ["seed", "check"]);
+      })
+    );
+    trackWriteTool(archAdminTool);
+  }
 }
 function scanDependencies(projectRoot, layers, nodes) {
   const layerMap = /* @__PURE__ */ new Map();
@@ -13429,29 +13118,6 @@ async function markOrientedWithSnapshotFallback(agentSessionId, coherenceSnapsho
     }
   }
 }
-function extractSessionEntryIds(priorSessions) {
-  const allSeen = /* @__PURE__ */ new Set();
-  const all = [];
-  let lastSessionOnly = [];
-  for (let i = 0; i < priorSessions.length; i++) {
-    const s = priorSessions[i];
-    const created = Array.isArray(s.entriesCreated) ? s.entriesCreated : [];
-    const modified = Array.isArray(s.entriesModified) ? s.entriesModified : [];
-    const ids = [...created, ...modified].filter((id) => typeof id === "string" && id.length > 0);
-    if (i === 0) {
-      lastSessionOnly = [...new Set(ids)].slice(0, 5);
-    }
-    for (const id of ids) {
-      if (!allSeen.has(id)) {
-        allSeen.add(id);
-        all.push(id);
-        if (all.length >= 10) break;
-      }
-    }
-    if (all.length >= 10) break;
-  }
-  return { all, lastSessionOnly };
-}
 var VALID_TASK_DOMAINS = [
   "auth",
   "strategy",
@@ -13509,8 +13175,8 @@ function registerOrientTool(server) {
   server.registerTool(
     "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**tier:** Controls payload depth. `standard` (default, ~256 KB) is the recommended default. `summary` (~10 KB) for quick mid-session re-orientation. `full` for complete payload when deep context is needed.\n\n**mode:** `full` (default) returns full context. `brief` returns compact summary \u2014 mapped to tier=summary internally. Prefer `tier` for explicit depth control.\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. Authority roots include strategy, product, product-design, engineering, architecture, data, governance, and go-to-market. Child scopes such as product-design/ux, engineering/frontend, data/analytics, and governance/principles are accepted. Legacy internal scopes remain accepted.",
+      title: "Orient \u2014 Task Grounding",
+      description: "Task-grounded context loader. Use AFTER `start_pb` (the canonical session opener) to load governance and context for a specific task. Returns workspace context with a single recommended next action for low-readiness workspaces, or a standup-style briefing for established workspaces.\n\n**Not the session opener.** For 'how do I begin a session' or 'Start PB', call `start_pb` instead. `orient` is for refreshing or scoping context once a session is already underway.\n\nCompleting orientation unlocks write tools for the active session.\n\n**tier:** Controls payload depth. `standard` (default, ~256 KB) is the recommended default. `summary` (~10 KB) for quick mid-session re-orientation. `full` for complete payload when deep context is needed.\n\n**mode:** `full` (default) returns full context. `brief` returns compact summary \u2014 mapped to tier=summary internally. Prefer `tier` for explicit depth control.\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. Authority roots include strategy, product, product-design, engineering, architecture, data, governance, and go-to-market. Child scopes such as product-design/ux, engineering/frontend, data/analytics, and governance/principles are accepted. Legacy internal scopes remain accepted.",
       inputSchema: orientSchema,
       annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false }
     },
@@ -13547,29 +13213,22 @@ function registerOrientTool(server) {
       }
       let priorSessions = [];
       let recoveryBlock = null;
-      if (wsCtx) {
-        try {
-          const sessionsResult = await kernelQuery("agent.recentSessions", { limit: 3 });
-          priorSessions = sessionsResult?.sessions ?? [];
-          recoveryBlock = sessionsResult?.recoveryBlock ?? null;
-        } catch {
-        }
-      }
-      const { all: sessionEntryIds, lastSessionOnly } = extractSessionEntryIds(priorSessions);
-      let orientEntries = null;
+      let orientView = null;
       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;
         orientArgs.tier = effectiveTier;
-        orientEntries = await kernelQuery("chain.getOrientEntries", orientArgs);
+        orientView = await kernelQuery("chain.getOrientView", orientArgs);
       } catch {
       }
-      const hasTaskGrounding = Boolean(task && orientEntries?.taskContext?.context?.length > 0);
-      if (wsCtx && hasTaskGrounding && orientEntries?.writeBackHints) {
-        const hints = Array.isArray(orientEntries.writeBackHints) ? orientEntries.writeBackHints : [];
+      if (orientView) {
+        priorSessions = orientView.priorSessions ?? [];
+        recoveryBlock = orientView.recoveryBlock ?? null;
+      }
+      const hasTaskGrounding = Boolean(task && orientView?.taskContext?.context?.length > 0);
+      if (wsCtx && hasTaskGrounding && orientView?.writeBackHints) {
+        const hints = Array.isArray(orientView.writeBackHints) ? orientView.writeBackHints : [];
         if (hints.length > 0) {
           trackWriteBackHintServed(wsCtx.workspaceId, {
             hint_count: hints.length,
@@ -13620,9 +13279,9 @@ function registerOrientTool(server) {
         const blankResult = {
           content: [{ type: "text", text: scanLines.join("\n") }],
           structuredContent: success(
-            "Workspace is blank. Use the start tool for guided setup.",
-            { stage: "blank", readinessScore: readiness?.score ?? 0, oriented, orientationStatus: orientationStatus2, redirectHint: "Use the `start` tool for the full guided setup experience." },
-            [{ tool: "start", description: "Guided workspace setup", parameters: {} }]
+            "Workspace is blank. Use the start_pb tool for guided setup.",
+            { stage: "blank", readinessScore: readiness?.score ?? 0, oriented, orientationStatus: orientationStatus2, redirectHint: "Use the `start_pb` tool for the full guided setup experience." },
+            [{ tool: "start_pb", description: "Guided workspace setup", parameters: {} }]
           )
         };
         reportOrientWrapperBytes(blankResult, false);
@@ -13642,8 +13301,8 @@ function registerOrientTool(server) {
       if (mode === "brief") {
         const briefStage = readiness?.stage ?? (readiness?.score != null ? readiness.score < 50 ? "seeded" : "grounded" : "unknown");
         lines.push(`Brain stage: ${briefStage}`);
-        if (orientEntries?.strategicContext) {
-          const sc = orientEntries.strategicContext;
+        if (orientView?.strategicContext) {
+          const sc = orientView.strategicContext;
           if (sc.vision) lines.push(`Vision: ${sc.vision}`);
           if (sc.purpose) lines.push(`Purpose: ${sc.purpose}`);
           if (sc.productAreaCount != null && sc.productAreaCount > 0) {
@@ -13654,11 +13313,11 @@ function registerOrientTool(server) {
           }
           lines.push(`${sc.activeBetCount} active bet(s), ${sc.activeTensionCount} tension(s).`);
         }
-        if (orientEntries?.taskContext && orientEntries.taskContext.context.length > 0) {
-          lines.push(`Task context: ${orientEntries.taskContext.totalFound} relevant entries (${orientEntries.taskContext.confidence} confidence).`);
+        if (orientView?.taskContext && orientView.taskContext.context.length > 0) {
+          lines.push(`Task context: ${orientView.taskContext.totalFound} relevant entries (${orientView.taskContext.confidence} confidence).`);
         }
-        if (orientEntries?.startup?.domainRetrieval) {
-          const retrieval = orientEntries.startup.domainRetrieval;
+        if (orientView?.startup?.domainRetrieval) {
+          const retrieval = orientView.startup.domainRetrieval;
           const scopedTo = retrieval.resolvedDomainSlug ? ` (${retrieval.resolvedDomainSlug})` : "";
           lines.push(`Domain retrieval: ${retrieval.state}${scopedTo}`);
           if (retrieval.activeSource) lines.push(`Active source: ${retrieval.activeSource}`);
@@ -13669,29 +13328,29 @@ function registerOrientTool(server) {
             lines.push(`Domain relation evidence: ${retrieval.directRatifiedCount ?? 0} direct, ${retrieval.inheritedRatifiedCount ?? 0} inherited, ${retrieval.orgFallbackCount ?? 0} org fallback`);
           }
         }
-        if (orientEntries?.writeBackHints && orientEntries.writeBackHints.length > 0) {
+        if (orientView?.writeBackHints && orientView.writeBackHints.length > 0) {
           lines.push("");
           lines.push("Write-back hints (what to capture this session):");
-          for (const h of orientEntries.writeBackHints) {
+          for (const h of orientView.writeBackHints) {
             lines.push(`  ${h.collectionSlug}: ${h.hint}`);
           }
         }
-        if (orientEntries?.activeBets?.length > 0) {
-          for (const e of orientEntries.activeBets) {
+        if (orientView?.activeBets?.length > 0) {
+          for (const e of orientView.activeBets) {
             const tensions = e.linkedTensions;
             const tensionPart = tensions?.length ? ` \u2014 ${tensions.map((t) => `${t.entryId ?? t.name} (${t.severity ?? "\u2014"})`).join(", ")}` : "";
             const originPart = e.origin ? ` (origin: ${e.origin})` : "";
             lines.push(`- \`${e.entryId ?? e._id}\` ${e.name}${originPart}${tensionPart}`);
           }
         }
-        if (orientEntries?.trustMetrics) {
-          const tm = orientEntries.trustMetrics;
+        if (orientView?.trustMetrics) {
+          const tm = orientView.trustMetrics;
           if (tm.unverified > 0 || tm.verified > 0) {
             const capNote = tm.scannedCap ? "+" : "";
             lines.push(`Trust: ${tm.verified} verified, ${tm.unverified} unverified, ${tm.noStatus} no-status (${tm.total}${capNote} scanned).`);
           }
         }
-        const briefWna = formatWhatNeedsAttentionBrief(orientEntries?.whatNeedsAttention);
+        const briefWna = formatWhatNeedsAttentionBrief(orientView?.whatNeedsAttention);
         if (briefWna.length > 0) {
           lines.push("");
           lines.push(...briefWna);
@@ -13728,7 +13387,7 @@ function registerOrientTool(server) {
             lines.push(...docCompleteness.lines);
           }
         }
-        if (orientEntries) {
+        if (orientView) {
           lines.push("");
           if (task) {
             const mapGovernanceEntry = (e) => ({
@@ -13737,10 +13396,11 @@ function registerOrientTool(server) {
               description: typeof e.preview === "string" ? e.preview : void 0,
               tier: typeof e.tier === "number" ? e.tier : void 0
             });
+            const gov = orientView.governance ?? { principles: [], standards: [], businessRules: [] };
             lines.push(...buildOperatingProtocol({
-              principles: (orientEntries.principles ?? []).map(mapGovernanceEntry),
-              standards: (orientEntries.standards ?? []).map(mapGovernanceEntry),
-              businessRules: (orientEntries.businessRules ?? []).map(mapGovernanceEntry)
+              principles: (gov.principles ?? []).map(mapGovernanceEntry),
+              standards: (gov.standards ?? []).map(mapGovernanceEntry),
+              businessRules: (gov.businessRules ?? []).map(mapGovernanceEntry)
             }, task));
           } else {
             lines.push(...buildOperatingProtocol());
@@ -13766,9 +13426,9 @@ function registerOrientTool(server) {
           lines.push("---");
           lines.push("_No active agent session. Call `session action=start` to begin._");
         }
-        const briefTruncated = orientEntries?._budget?.truncated ?? orientEntries?._truncated ?? false;
+        const briefTruncated = orientView?._budget?.truncated ?? orientView?._truncated ?? false;
         if (briefTruncated) {
-          const reasons = orientEntries?._budget?.truncationReasons;
+          const reasons = orientView?._budget?.truncationReasons;
           lines.push("");
           if (reasons && reasons.length > 0) {
             lines.push(`_Context truncated to fit tier budget: ${reasons.join(", ")}. Use tier=full for complete payload._`);
@@ -13793,7 +13453,7 @@ function registerOrientTool(server) {
               taskGroundingRequired: !hasTaskGrounding,
               orientationStatus: orientationStatus2,
               nextStep: hasTaskGrounding ? void 0 : 'Run `orient task="describe the work"` before substantive work.',
-              ...orientEntries?._budget ? { _budget: orientEntries._budget } : {}
+              ...orientView?._budget ? { _budget: orientView._budget } : {}
             }
           )
         };
@@ -13852,8 +13512,8 @@ function registerOrientTool(server) {
         if (task) {
           lines.push(`**Brain stage: ${orientStage}.** Working on: **${task}**`);
           lines.push("");
-          if (orientEntries?.strategicContext) {
-            const sc = orientEntries.strategicContext;
+          if (orientView?.strategicContext) {
+            const sc = orientView.strategicContext;
             lines.push("## Strategic Context");
             if (sc.vision) lines.push(`**Vision:** ${sc.vision}`);
             if (sc.purpose) lines.push(`**Purpose:** ${sc.purpose}`);
@@ -13867,11 +13527,11 @@ function registerOrientTool(server) {
             lines.push(`${betLine} ${sc.activeTensionCount} open tension(s).`);
             lines.push("");
           }
-          if (orientEntries?.continuingFrom && orientEntries.continuingFrom.length > 0) {
+          if (orientView?.continuingFrom && orientView.continuingFrom.length > 0) {
             lines.push("## Continuing from");
             lines.push("_Prior-session entries most relevant to your task._");
             lines.push("");
-            for (const e of orientEntries.continuingFrom) {
+            for (const e of orientView.continuingFrom) {
               const id = e.entryId ?? e.name;
               const type = e.canonicalKey ?? "generic";
               const coll = e.collectionSlug ? ` [${e.collectionSlug}]` : "";
@@ -13890,11 +13550,11 @@ function registerOrientTool(server) {
             }
             lines.push("");
           }
-          if (orientEntries?.lastSessionTouched && orientEntries.lastSessionTouched.length > 0) {
+          if (orientView?.lastSessionTouched && orientView.lastSessionTouched.length > 0) {
             lines.push("## Last session touched");
             lines.push("_Entries created or modified in your most recent session._");
             lines.push("");
-            for (const e of orientEntries.lastSessionTouched) {
+            for (const e of orientView.lastSessionTouched) {
               const id = e.entryId ?? e.name;
               const type = e.canonicalKey ?? "generic";
               const coll = e.collectionSlug ? ` [${e.collectionSlug}]` : "";
@@ -13912,11 +13572,11 @@ function registerOrientTool(server) {
             }
             lines.push("");
           }
-          if (orientEntries?.taskContext && orientEntries.taskContext.context.length > 0) {
-            const tc = orientEntries.taskContext;
+          if (orientView?.taskContext && orientView.taskContext.context.length > 0) {
+            const tc = orientView.taskContext;
             lines.push("## Task Context");
-            if (orientEntries.startup?.domainRetrieval) {
-              const retrieval = orientEntries.startup.domainRetrieval;
+            if (orientView.startup?.domainRetrieval) {
+              const retrieval = orientView.startup.domainRetrieval;
               const scopedTo = retrieval.resolvedDomainSlug ? ` (${retrieval.resolvedDomainSlug})` : "";
               lines.push(`_Domain retrieval: ${retrieval.state}${scopedTo}_`);
               if (retrieval.activeSource) lines.push(`_Active source: ${retrieval.activeSource}_`);
@@ -13936,34 +13596,34 @@ function registerOrientTool(server) {
             }
             lines.push("");
           }
-          if (orientEntries?.taskContext?.constellationEntries && orientEntries.taskContext.constellationEntries.length > 0) {
+          if (orientView?.taskContext?.constellationEntries && orientView.taskContext.constellationEntries.length > 0) {
             lines.push(...formatBetConstellationLines(
-              orientEntries.taskContext.constellationEntries,
-              orientEntries.taskContext.constellationBetName
+              orientView.taskContext.constellationEntries,
+              orientView.taskContext.constellationBetName
             ));
           }
-          if (orientEntries?.writeBackHints && orientEntries.writeBackHints.length > 0) {
+          if (orientView?.writeBackHints && orientView.writeBackHints.length > 0) {
             lines.push("");
             lines.push("## Write-Back Hints");
             lines.push("_What to capture this session (derived from task context):_");
             lines.push("");
-            for (const h of orientEntries.writeBackHints) {
+            for (const h of orientView.writeBackHints) {
               lines.push(`- **${h.collectionSlug}**: ${h.hint}`);
             }
             lines.push("");
           }
-          if (orientEntries) {
+          if (orientView) {
             const result = await runAlignmentCheck(
               task,
-              orientEntries.activeBets ?? [],
-              orientEntries.taskContext?.context
+              orientView.activeBets ?? [],
+              orientView.taskContext?.context
             );
             lines.push(...buildAlignmentCheckLines(result));
-            lines.push(...formatInitiativeStatusLines(orientEntries.initiativeStatus));
-            lines.push(...formatWorkstreamHealthLines(orientEntries.workstreamHealth));
-            lines.push(...formatWhatNeedsAttentionLines(orientEntries.whatNeedsAttention));
-            if (orientEntries.trustMetrics) {
-              const tm = orientEntries.trustMetrics;
+            lines.push(...formatInitiativeStatusLines(orientView.initiativeStatus));
+            lines.push(...formatWorkstreamHealthLines(orientView.workstreamHealth));
+            lines.push(...formatWhatNeedsAttentionLines(orientView.whatNeedsAttention));
+            if (orientView.trustMetrics) {
+              const tm = orientView.trustMetrics;
               if (tm.verified > 0 || tm.unverified > 0) {
                 const capNote = tm.scannedCap ? " (capped at 500)" : "";
                 lines.push("## Trust metrics");
@@ -13986,12 +13646,12 @@ function registerOrientTool(server) {
               lines.push(...docCompleteness.lines);
             }
           }
-          if (orientEntries) {
-            if (orientEntries.activeBets?.length > 0) {
+          if (orientView) {
+            if (orientView.activeBets?.length > 0) {
               lines.push("## Active bets \u2014 current scope");
               lines.push("_Work outside these bets requires explicit user confirmation._");
               lines.push("");
-              for (const e of orientEntries.activeBets) {
+              for (const e of orientView.activeBets) {
                 lines.push(fmt(e));
                 const tensions = e.linkedTensions;
                 if (tensions?.length) {
@@ -14004,44 +13664,44 @@ function registerOrientTool(server) {
               }
               lines.push("");
             }
-            if (orientEntries.activeGoals?.length > 0) {
+            if (orientView.activeGoals?.length > 0) {
               lines.push("## Active goals");
-              orientEntries.activeGoals.forEach((e) => lines.push(fmt(e)));
+              orientView.activeGoals.forEach((e) => lines.push(fmt(e)));
               lines.push("");
             }
-            if (orientEntries.strategyHighlights?.length > 0) {
+            if (orientView.strategyHighlights?.length > 0) {
               lines.push("## Strategy highlights");
               lines.push("_One-sentence strategy, positioning, moat, business model, GTM \u2014 high-level strategic context._");
               lines.push("");
-              orientEntries.strategyHighlights.forEach((e) => lines.push(fmt(e)));
+              orientView.strategyHighlights.forEach((e) => lines.push(fmt(e)));
               lines.push("");
             }
-            if (orientEntries.playingField?.length > 0) {
+            if (orientView.playingField?.length > 0) {
               lines.push("## Playing field");
               lines.push("_Products and opportunities in the strategic landscape._");
               lines.push("");
-              orientEntries.playingField.forEach((e) => lines.push(fmt(e)));
+              orientView.playingField.forEach((e) => lines.push(fmt(e)));
               lines.push("");
             }
-            if (orientEntries.recentDecisions?.length > 0) {
+            if (orientView.recentDecisions?.length > 0) {
               lines.push("## Recent decisions");
-              orientEntries.recentDecisions.forEach((e) => lines.push(fmt(e)));
+              orientView.recentDecisions.forEach((e) => lines.push(fmt(e)));
               lines.push("");
             }
-            if (orientEntries.recentlySuperseded?.length > 0) {
+            if (orientView.recentlySuperseded?.length > 0) {
               lines.push("## Recently superseded");
-              orientEntries.recentlySuperseded.forEach((e) => lines.push(fmt(e)));
+              orientView.recentlySuperseded.forEach((e) => lines.push(fmt(e)));
               lines.push("");
             }
-            if (orientEntries.staleEntries?.length > 0) {
+            if (orientView.staleEntries?.length > 0) {
               lines.push("## Needs confirmation");
-              lines.push(`_Domain stratum entries not confirmed in ${orientEntries.stalenessThresholdDays} days._`);
-              orientEntries.staleEntries.forEach((e) => lines.push(fmt(e)));
+              lines.push(`_Domain stratum entries not confirmed in ${orientView.stalenessThresholdDays} days._`);
+              orientView.staleEntries.forEach((e) => lines.push(fmt(e)));
               lines.push("");
             }
-            if (orientEntries.architectureNotes?.length > 0) {
+            if (orientView.architectureNotes?.length > 0) {
               lines.push("## Architecture notes");
-              orientEntries.architectureNotes.forEach((e) => lines.push(fmt(e)));
+              orientView.architectureNotes.forEach((e) => lines.push(fmt(e)));
               lines.push("");
             }
             const mapGovernanceEntry = (e) => ({
@@ -14050,10 +13710,11 @@ function registerOrientTool(server) {
               description: typeof e.preview === "string" ? e.preview : void 0,
               tier: typeof e.tier === "number" ? e.tier : void 0
             });
+            const gov = orientView.governance ?? { principles: [], standards: [], businessRules: [] };
             lines.push(...buildOperatingProtocol({
-              principles: (orientEntries.principles ?? []).map(mapGovernanceEntry),
-              standards: (orientEntries.standards ?? []).map(mapGovernanceEntry),
-              businessRules: (orientEntries.businessRules ?? []).map(mapGovernanceEntry)
+              principles: (gov.principles ?? []).map(mapGovernanceEntry),
+              standards: (gov.standards ?? []).map(mapGovernanceEntry),
+              businessRules: (gov.businessRules ?? []).map(mapGovernanceEntry)
             }, task));
           }
           let allEntries = [];
@@ -14070,20 +13731,20 @@ function registerOrientTool(server) {
         } else {
           lines.push(`**Brain stage: ${orientStage}.**`);
           lines.push("");
-          if (orientEntries?.activeBets?.length) {
+          if (orientView?.activeBets?.length) {
             lines.push("## Active bets \u2014 current scope");
             lines.push("_Work outside these bets requires explicit user confirmation._");
             lines.push("");
-            for (const e of orientEntries.activeBets) {
+            for (const e of orientView.activeBets) {
               lines.push(fmt(e));
             }
             lines.push("");
           }
-          lines.push(...formatInitiativeStatusLines(orientEntries?.initiativeStatus));
-          lines.push(...formatWorkstreamHealthLines(orientEntries?.workstreamHealth));
-          lines.push(...formatWhatNeedsAttentionLines(orientEntries?.whatNeedsAttention));
-          if (orientEntries?.trustMetrics) {
-            const tm = orientEntries.trustMetrics;
+          lines.push(...formatInitiativeStatusLines(orientView?.initiativeStatus));
+          lines.push(...formatWorkstreamHealthLines(orientView?.workstreamHealth));
+          lines.push(...formatWhatNeedsAttentionLines(orientView?.whatNeedsAttention));
+          if (orientView?.trustMetrics) {
+            const tm = orientView.trustMetrics;
             if (tm.verified > 0 || tm.unverified > 0) {
               const capNote = tm.scannedCap ? " (capped at 500)" : "";
               lines.push("## Trust metrics");
@@ -14166,9 +13827,9 @@ function registerOrientTool(server) {
         lines.push("---");
         lines.push("_No active agent session. Call `session action=start` to begin a tracked session._");
       }
-      const fullTruncated = orientEntries?._budget?.truncated ?? orientEntries?._truncated ?? false;
+      const fullTruncated = orientView?._budget?.truncated ?? orientView?._truncated ?? false;
       if (fullTruncated) {
-        const reasons = orientEntries?._budget?.truncationReasons;
+        const reasons = orientView?._budget?.truncationReasons;
         lines.push("");
         if (reasons && reasons.length > 0) {
           lines.push(`_Context truncated to fit tier budget: ${reasons.join(", ")}. Use tier=full for complete payload._`);
@@ -14187,10 +13848,10 @@ function registerOrientTool(server) {
             sessionId: agentSessionId,
             taskGroundingStatus: hasTaskGrounding ? "task_scoped" : task ? "missing_task_context" : "workspace_only",
             taskGroundingRequired: !hasTaskGrounding,
-            domainRetrieval: orientEntries?.startup?.domainRetrieval,
+            domainRetrieval: orientView?.startup?.domainRetrieval,
             orientationStatus,
             nextStep: hasTaskGrounding ? void 0 : 'Run `orient task="describe the work"` before substantive work.',
-            ...orientEntries?._budget ? { _budget: orientEntries._budget } : {}
+            ...orientView?._budget ? { _budget: orientView._budget } : {}
           }
         )
       };
@@ -14609,7 +14270,7 @@ var ALL_TOOL_SCHEMAS = [
   { name: "update-entry", schema: updateEntrySchema },
   { name: "get-history", schema: getHistorySchema },
   { name: "commit-entry", schema: commitEntrySchema },
-  { name: "start", schema: startSchema },
+  { name: "start_pb", schema: startPbSchema },
   { name: "get-usage-summary", schema: usageSummarySchema },
   { name: "chain", schema: chainSchema },
   { name: "chain-version", schema: chainVersionSchema },
@@ -14703,15 +14364,61 @@ function registerHealthTools(server) {
   );
 }
 
-// src/tools/audit.ts
+// src/tools/record_activation.ts
 import { z as z24 } from "zod";
+var recordActivationSchema = z24.object({
+  confirmedEntryCount: z24.number().int().min(0).describe(
+    "Confirmed-entry count from the Phase 4 capture loop. The mutation enforces >=10 (DEC-994)."
+  ),
+  entriesAcrossCollections: z24.number().int().min(0).describe(
+    "Number of distinct collections those entries span. The mutation enforces >=2 (DEC-994 diversity soft-gate)."
+  ),
+  retrievalDemoConfirmed: z24.boolean().describe(
+    "True if the BR-141 retrieval round-trip ran successfully in Phase 4. The mutation rejects false."
+  )
+});
+function registerRecordActivationTools(server) {
+  server.registerTool(
+    "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.",
+      inputSchema: recordActivationSchema,
+      annotations: { readOnlyHint: false, idempotentHint: true, openWorldHint: false, destructiveHint: false }
+    },
+    thinWrapper(async ({ confirmedEntryCount, entriesAcrossCollections, retrievalDemoConfirmed }) => {
+      const mutationResult = await kernelMutation(
+        "setup.recordActivationReceipt",
+        {
+          surfaceCapability: "chat-only",
+          confirmedEntryCount,
+          entriesAcrossCollections,
+          retrievalDemoConfirmed
+        }
+      );
+      const result = {
+        activated: true,
+        alreadyActivated: mutationResult.alreadyActivated,
+        receiptId: mutationResult.receiptId ?? null
+      };
+      const summary = mutationResult.alreadyActivated ? "Activation receipt already recorded \u2014 chat-only flow short-circuits." : "Activation recorded \u2014 chat-only flow complete.";
+      return {
+        content: textContent(summary),
+        structuredContent: success(summary, result)
+      };
+    })
+  );
+}
+
+// src/tools/audit.ts
+import { z as z25 } from "zod";
 var AUDIT_ACTIONS = ["run"];
-var auditSchema = z24.object({
-  action: z24.enum(AUDIT_ACTIONS).describe(
+var auditSchema = z25.object({
+  action: z25.enum(AUDIT_ACTIONS).describe(
     "'run': run the STD-113 hygiene audit for a bet entry."
   ),
-  entryId: z24.string().describe("Bet entry ID to audit, e.g. 'BET-182'"),
-  phase: z24.enum(["shaping", "handoff"]).default("shaping").optional().describe(
+  entryId: z25.string().describe("Bet entry ID to audit, e.g. 'BET-182'"),
+  phase: z25.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."
   )
 });
@@ -14720,7 +14427,7 @@ function registerAuditTools(server) {
     "audit",
     {
       title: "Audit",
-      description: "Run STD-113 hygiene audit on a bet entry. Checks 13 gates covering:\n\n- **Relations**: intentional links, no auto-link noise, strategic anchoring\n- **Risk/Tension**: risks in correct collection, tensions linked\n- **Field completeness**: mandatory fields populated for current phase\n- **Elements**: correct collection, committed status\n- **Acceptance criteria**: doneWhen populated and verifiable\n- **Structural**: no circular relations, appetite consistency\n\nUse `phase=shaping` (default) before starting implementation. Use `phase=handoff` before handing off to AI Engineer.",
+      description: "Run STD-113 hygiene audit on a bet entry. Checks 13 gates (shaping) / 18 gates (handoff) covering:\n\n- **Relations**: intentional links, no auto-link noise, strategic anchoring\n- **Risk/Tension**: risks in correct collection, tensions linked\n- **Field completeness**: mandatory fields populated for current phase\n- **Elements**: correct collection, committed status\n- **Acceptance criteria**: doneWhen populated and verifiable\n- **Structural**: no circular relations, appetite consistency\n\nUse `phase=shaping` (default) before starting implementation. Use `phase=handoff` before handing off to AI Engineer.",
       inputSchema: auditSchema,
       annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
     },
@@ -14822,13 +14529,13 @@ async function handleAuditRun(entryId, phase) {
 }
 
 // src/tools/governance.ts
-import { z as z25 } from "zod";
-var governanceSchema = z25.object({
-  action: z25.enum(["list", "respond", "count"]).describe("Action: list open proposals, respond to a proposal, or count open proposals"),
-  proposalId: z25.string().optional().describe("Proposal ID (required for respond action)"),
-  verdict: z25.enum(["approve", "reject"]).optional().describe("Verdict for respond action: approve or reject"),
-  reason: z25.string().optional().describe("Reason for the verdict (required when rejecting)"),
-  status: z25.enum(["open", "approved", "objected", "expired"]).optional().describe("Filter proposals by status (default: open). Only used with list action.")
+import { z as z26 } from "zod";
+var governanceSchema = z26.object({
+  action: z26.enum(["list", "respond", "count"]).describe("Action: list open proposals, respond to a proposal, or count open proposals"),
+  proposalId: z26.string().optional().describe("Proposal ID (required for respond action)"),
+  verdict: z26.enum(["approve", "reject"]).optional().describe("Verdict for respond action: approve or reject"),
+  reason: z26.string().optional().describe("Reason for the verdict (required when rejecting)"),
+  status: z26.enum(["open", "approved", "objected", "expired"]).optional().describe("Filter proposals by status (default: open). Only used with list action.")
 });
 function registerGovernanceTools(server) {
   const tool = server.registerTool(
@@ -14954,16 +14661,16 @@ function registerGovernanceTools(server) {
 }
 
 // src/tools/documents.ts
-import { z as z26 } from "zod";
+import { z as z27 } from "zod";
 var DOCUMENTS_ACTIONS = ["get-last-verified-brief"];
-var documentsSchema = z26.object({
-  action: z26.enum(DOCUMENTS_ACTIONS).describe(
+var documentsSchema = z27.object({
+  action: z27.enum(DOCUMENTS_ACTIONS).describe(
     "'get-last-verified-brief': fetch the most recent verified brief snapshot for a (templateId, scopeKey) pair. Returns the verified summary so agents can build delta narratives ('since you last verified, X workstreams advanced')."
   ),
-  templateId: z26.string().describe(
+  templateId: z27.string().describe(
     "Brief template identifier \u2014 currently 'steering-brief' is the only registered template."
   ),
-  scopeKey: z26.string().describe(
+  scopeKey: z27.string().describe(
     "Canonical scope key. Use 'workspace:<workspaceId>' for the full workspace brief, or 'initiative:<INI-ID>' for an initiative-scoped brief. The same formula is applied at write time (chainwork/docKernel/scopeKey.ts), so passing the wrong shape returns exists:false."
   )
 });
@@ -15561,12 +15268,12 @@ ${entry.labels.map((l) => `- ${l.name ?? l.slug}`).join("\n")}`);
 }
 
 // src/prompts/index.ts
-import { z as z27 } from "zod";
+import { z as z28 } from "zod";
 function registerPrompts(server) {
   server.prompt(
     "review-against-rules",
     "Review code or a design decision against all business rules for a given domain. Fetches the rules and asks you to do a structured compliance review.",
-    { domain: z27.string().describe("Business rule domain (e.g. 'Identity & Access', 'Governance & Decision-Making')") },
+    { domain: z28.string().describe("Business rule domain (e.g. 'Identity & Access', 'Governance & Decision-Making')") },
     async ({ domain }) => {
       const entries = await kernelQuery("chain.listEntries", { collectionSlug: "business-rules" });
       const rules = entries.filter((e) => e.data?.domain === domain);
@@ -15619,7 +15326,7 @@ Provide a structured review with a compliance status for each rule (COMPLIANT /
   server.prompt(
     "name-check",
     "Check variable names, field names, or API names against the glossary for terminology alignment. Flags drift from canonical terms.",
-    { names: z27.string().describe("Comma-separated list of names to check (e.g. 'vendor_id, compliance_level, formulator_type')") },
+    { names: z28.string().describe("Comma-separated list of names to check (e.g. 'vendor_id, compliance_level, formulator_type')") },
     async ({ names }) => {
       const terms = await kernelQuery("chain.listEntries", { collectionSlug: "glossary" });
       const glossaryContext = terms.map(
@@ -15655,7 +15362,7 @@ Format as a table: Name | Status | Canonical Form | Action Needed`
   server.prompt(
     "draft-decision-record",
     "Draft a structured decision record from a description of what was decided. Includes context from recent decisions and relevant rules.",
-    { context: z27.string().describe("Description of the decision (e.g. 'We decided to use MRSL v3.1 as the conformance baseline because...')") },
+    { context: z28.string().describe("Description of the decision (e.g. 'We decided to use MRSL v3.1 as the conformance baseline because...')") },
     async ({ context }) => {
       const recentDecisions = await kernelQuery("chain.listEntries", { collectionSlug: "decisions" });
       const sorted = [...recentDecisions].sort((a, b) => (b.data?.date ?? "") > (a.data?.date ?? "") ? 1 : -1).slice(0, 5);
@@ -15693,8 +15400,8 @@ After drafting, I can log it using the capture tool with collection "decisions".
     "draft-rule-from-context",
     "Draft a new business rule from an observation or discovery made while coding. Fetches existing rules for the domain to ensure consistency.",
     {
-      observation: z27.string().describe("What you observed or discovered (e.g. 'Suppliers can have multiple org types in Gateway')"),
-      domain: z27.string().describe("Which domain this rule belongs to (e.g. 'Governance & Decision-Making')")
+      observation: z28.string().describe("What you observed or discovered (e.g. 'Suppliers can have multiple org types in Gateway')"),
+      domain: z28.string().describe("Which domain this rule belongs to (e.g. 'Governance & Decision-Making')")
     },
     async ({ observation, domain }) => {
       const allRules = await kernelQuery("chain.listEntries", { collectionSlug: "business-rules" });
@@ -15772,7 +15479,7 @@ var INSTRUCTIONS = [
   "",
   "## Workflow",
   "",
-  "  1. Start: call `start` to begin \u2014 it starts a session automatically, detects your workspace stage, and returns the right guidance. Fresh workspaces get a guided setup; active workspaces get a standup briefing.",
+  "  1. Start: call `start_pb` to begin \u2014 it starts a session automatically, detects your workspace stage, and returns the right guidance. Fresh workspaces get the pb-setup skill body; active workspaces get a standup briefing.",
   "  2. Re-orient: call `orient` mid-session for task-scoped context or a compact status refresh.",
   "  3. Discover: use `entries action=search` to find entries, or `entries action=list` to browse.",
   '  4. Drill in: use `entries action=get entryId="..."` for full details \u2014 data, labels, relations, history.',
@@ -15784,7 +15491,7 @@ var INSTRUCTIONS = [
   "  10. Close: call `session action=close` when done \u2014 records session activity. Auto-nudges if wrapup was skipped.",
   "",
   "Write tools (capture, update-entry, relations, commit-entry) require:",
-  "  - Call `start` to begin (starts session + loads context). Call `orient` mid-session for a refresh.",
+  "  - Call `start_pb` to begin (starts session + loads context). Call `orient` mid-session for a refresh.",
   "  - A readwrite API key scope",
   "",
   "Commit-on-confirm: always capture as draft first and show the user what was captured.",
@@ -15833,7 +15540,9 @@ function createProductBrainServer() {
   if (enabledModules.has("gitchain")) registerGitChainTools(server);
   if (enabledModules.has("gitchain")) registerMapTools(server);
   if (enabledModules.has("arch")) registerArchitectureTools(server);
-  registerStartTools(server);
+  registerSkillsTools(server);
+  registerStartPbTools(server);
+  registerRecordActivationTools(server);
   registerUsageTools(server);
   registerFacilitateTools(server);
   registerAuditTools(server);
@@ -15870,6 +15579,11 @@ var WS = {
   RANDY_PROD_PRIMARY: "mx784e9jjdqhsk2r0098bpvtes84e792",
   RANDY_PROD_SECONDARY: "mx74q0mkwn4r920q2837qk7dsx84pq60"
 };
+var USR = {
+  RANDY: "user_3C31UK8CWugoDXUj2RGu1HDudas",
+  /** Niels — full MVP unlock in any workspace (Clerk JWT `sub` / `FlagCtx.clerkUserId`). */
+  NIELS: "user_3DOKRUaiY9KS3RKtC7shak3nB0N"
+};
 var FLAGS = {
   // WP-355 — MVP unlock: full Spine navigation (all modes + access patterns visible)
   "mvp-unlock-spine": {
@@ -15879,7 +15593,8 @@ var FLAGS = {
       WS.RANDY_DEV_SECONDARY,
       WS.RANDY_PROD_PRIMARY,
       WS.RANDY_PROD_SECONDARY
-    ]
+    ],
+    userAllow: [USR.NIELS]
   },
   // WP-355 — MVP unlock: Bridge full view (beyond locked /bridge dashboard)
   "mvp-unlock-bridge-full": {
@@ -15889,7 +15604,8 @@ var FLAGS = {
       WS.RANDY_DEV_SECONDARY,
       WS.RANDY_PROD_PRIMARY,
       WS.RANDY_PROD_SECONDARY
-    ]
+    ],
+    userAllow: [USR.NIELS]
   },
   // WP-355 — MVP unlock: Rail full context (beyond Rail context-only mode)
   "mvp-unlock-rail-full": {
@@ -15899,7 +15615,8 @@ var FLAGS = {
       WS.RANDY_DEV_SECONDARY,
       WS.RANDY_PROD_PRIMARY,
       WS.RANDY_PROD_SECONDARY
-    ]
+    ],
+    userAllow: [USR.NIELS]
   },
   // WP-355 — MVP unlock: Import surface enabled
   "mvp-unlock-import": {
@@ -15909,9 +15626,10 @@ var FLAGS = {
       WS.RANDY_DEV_SECONDARY,
       WS.RANDY_PROD_PRIMARY,
       WS.RANDY_PROD_SECONDARY
-    ]
+    ],
+    userAllow: [USR.NIELS]
   },
-  // WP-355 — Brain Chat: withheld from MVP by default; allowlisted for Randy's workspaces.
+  // WP-355 — Brain Chat: off by default; same workspace + user allowlists as other mvp-unlock flags.
   "mvp-unlock-brain-chat": {
     default: false,
     workspaceAllow: [
@@ -15919,7 +15637,8 @@ var FLAGS = {
       WS.RANDY_DEV_SECONDARY,
       WS.RANDY_PROD_PRIMARY,
       WS.RANDY_PROD_SECONDARY
-    ]
+    ],
+    userAllow: [USR.NIELS]
   },
   // WP-373 E3 — Routing Resolver SSOT killswitch.
   // When true, the new pure resolver short-circuits and mount sites execute the
@@ -15955,4 +15674,4 @@ export {
   createProductBrainServer,
   initFeatureFlags
 };
-//# sourceMappingURL=chunk-LXESYNJ6.js.map
+//# sourceMappingURL=chunk-DNZQANRI.js.map