@productbrain/mcp 0.0.1-beta.55 → 0.0.1-beta.56

package/dist/{chunk-HQLEMADT.js → chunk-VKO3MWSQ.js}

@@ -423,8 +423,7 @@ function registerEntriesTools(server) {
       title: "Entries",
       description: 'Read entries from the Chain. One tool for all entry reading.\n\n- **list**: Browse entries with optional filters (collection, status, tag, label). Use collections action=list first to discover slugs.\n- **get**: Fetch a single entry by ID \u2014 full record with data, labels, relations, history.\n- **batch**: Fetch multiple entries (max 20) in one call. Same shape as get per entry.\n- **search**: Full-text search across entries. Scope by collection or filter by status.\n\nUse `entries action=get entryId="..."` to fetch one. Use `entries action=search query="..."` to discover.',
       inputSchema: entriesSchema,
-      annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
-      _meta: { ui: { resourceUri: "ui://entries/entry-cards.html" } }
+      annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false }
     },
     withEnvelope(async (args) => {
       const parsed = parseOrFail(entriesSchema, args);
@@ -776,8 +775,7 @@ function registerGraphTools(server) {
       title: "Graph",
       description: "Read from the knowledge graph. Two actions:\n\n- **find**: Traverse relations from a specific entry \u2014 shows incoming/outgoing connections. Use after entries action=get to explore connections. This is NOT full-text search (use entries action=search).\n- **suggest**: Discover potential relations for an entry using graph-aware intelligence. Returns ranked suggestions with confidence scores. Use relations action=create or relations action=batch-create to create the ones that make sense.",
       inputSchema: graphSchema,
-      annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
-      _meta: { ui: { resourceUri: "ui://graph/constellation.html" } }
+      annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false }
     },
     withEnvelope(async (args) => {
       const parsed = parseOrFail(graphSchema, args);
@@ -1213,8 +1211,7 @@ function registerContextTools(server) {
       title: "Context",
       description: "Assemble knowledge context in one call. Two actions:\n\n- **gather**: Three modes \u2014 (1) By entry: traverse the graph around a specific entry. (2) By task: auto-load relevant domain knowledge for a natural-language task. (3) Graph mode (entryId + mode='graph'): enhanced traversal with provenance paths.\n- **build**: Structured build spec for any entry \u2014 data, related entries, business rules, glossary terms, chain refs. Use when starting a build. Requires active session.",
       inputSchema: contextSchema,
-      annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
-      _meta: { ui: { resourceUri: "ui://graph/constellation.html" } }
+      annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false }
     },
     withEnvelope(async (args) => {
       const parsed = parseOrFail(contextSchema, args);
@@ -3249,7 +3246,11 @@ When reviewing test results: (a) test staleness \u2014 code changed, test not up
     summaryCapture: {
       createsPrimaryRecord: true,
       nameTemplate: "Implementation Review \u2014 {date}",
-      descriptionField: "description"
+      descriptionField: "description",
+      descriptionSource: {
+        mode: "step-output-field",
+        field: "synthesis"
+      }
     }
   },
   runtime: {
@@ -3367,7 +3368,11 @@ var PROCESS_CHANGE_WORKFLOW_DESCRIPTOR = {
     },
     summaryCapture: {
       createsPrimaryRecord: true,
-      nameTemplate: "{whatAndWhy}"
+      nameTemplate: "{whatAndWhy}",
+      descriptionSource: {
+        mode: "step-output-field",
+        field: "whatAndWhy"
+      }
     }
   },
   runtime: {
@@ -3472,7 +3477,8 @@ var workflowsSchema = z11.object({
   isFinal: z11.boolean().optional().describe("If true, finalize an existing durable workflow run from its terminal round and create the summary chain entry."),
   restart: z11.boolean().optional().describe("If true, start a new durable run from the workflow's first round in the current session."),
   summaryName: z11.string().optional().describe("Optional name for final chain entry. If omitted, the workflow summary template is used."),
-  summaryDescription: z11.string().optional().describe("Optional override for the final chain entry description. Defaults to the final round output text.")
+  summaryDescription: z11.string().optional().describe("Optional override for the final chain entry description. Defaults to the final round output text."),
+  summaryEntryId: z11.string().optional().describe("Link an existing entry as the run's summary instead of creating one. Used by facilitated workflows (e.g. shape) where the primary record is created by the specialized tool.")
 });
 function formatWorkflowCard(wf) {
   const roundList = wf.rounds.map((r) => `  ${r.num}. ${r.label} (${r.type}, ~${r.maxDurationHint ?? "?"})`).join("\n");
@@ -3519,7 +3525,8 @@ function registerWorkflowTools(server) {
         isFinal,
         restart,
         summaryName,
-        summaryDescription
+        summaryDescription,
+        summaryEntryId
       } = parsed.data;
       return runWithToolContext({ tool: "workflows", action }, async () => {
         if (action === "list") {
@@ -3546,7 +3553,8 @@ function registerWorkflowTools(server) {
             isFinal,
             restart,
             summaryName,
-            summaryDescription
+            summaryDescription,
+            summaryEntryId
           );
         }
         return unknownAction(action, WORKFLOWS_ACTIONS);
@@ -3654,7 +3662,7 @@ async function handleGetRun(runId, workflowId) {
     )
   };
 }
-async function handleCheckpoint(workflowId, roundId, output, isFinal, restart, summaryName, summaryDescription) {
+async function handleCheckpoint(workflowId, roundId, output, isFinal, restart, summaryName, summaryDescription, summaryEntryId) {
   const wf = getWorkflow(workflowId);
   if (!wf) {
     return {
@@ -3727,9 +3735,9 @@ This checkpoint was NOT saved. The conversation context is preserved \u2014 cont
       descriptionField: wf.kbOutputTemplate.descriptionField,
       descriptionSource: "final-output-text"
     } : null;
-    if (!summaryCapture) {
+    if (!summaryCapture && !summaryEntryId) {
       return validationResult(
-        `Workflow '${workflowId}' does not support final summary capture through workflows.checkpoint. Follow the workflow guidance and use capture directly for its primary record.`
+        `Workflow '${workflowId}' does not support final summary capture through workflows.checkpoint. Follow the workflow guidance and use capture directly for its primary record, or pass summaryEntryId to link an existing entry.`
       );
     }
     requireWriteAccess();
@@ -3739,6 +3747,17 @@ This checkpoint was NOT saved. The conversation context is preserved \u2014 cont
         "Active agent session required for workflow checkpoint persistence."
       );
     }
+    if (summaryEntryId && !summaryCapture) {
+      return handleFacilitatedFinalization(
+        wf,
+        descriptor,
+        roundId,
+        normalizedOutput,
+        agentSessionId,
+        summaryEntryId,
+        lines
+      );
+    }
     const existingRun = await mcpQuery(
       "chainwork.getLatestWorkflowRun",
       {
@@ -3868,7 +3887,8 @@ This checkpoint was NOT saved. The conversation context is preserved \u2014 cont
           output: normalizedOutput,
           recordedAt: (/* @__PURE__ */ new Date()).toISOString()
         },
-        restart
+        restart,
+        ...summaryEntryId ? { summaryEntryId } : {}
       });
       lines.push(
         `Round ${round.num} output recorded.`,
@@ -3877,7 +3897,12 @@ This checkpoint was NOT saved. The conversation context is preserved \u2014 cont
       );
       const nextWorkflowRound = checkpointResult.projection.currentRoundId ? wf.rounds.find((workflowRound) => workflowRound.id === checkpointResult.projection.currentRoundId) : void 0;
       const nextRound = nextWorkflowRound ? { id: nextWorkflowRound.id, num: nextWorkflowRound.num, label: nextWorkflowRound.label } : void 0;
-      if (nextWorkflowRound) {
+      if (checkpointResult.summary?.linked) {
+        lines.push(
+          "",
+          `**Run completed.** Summary linked to existing entry \`${checkpointResult.summary.entryId}\`.`
+        );
+      } else if (nextWorkflowRound) {
         lines.push(
           "",
           `**Next**: Round ${nextWorkflowRound.num} \u2014 ${nextWorkflowRound.label}`,
@@ -3927,6 +3952,81 @@ This checkpoint was NOT saved. The conversation context is preserved \u2014 cont
     }
   }
 }
+async function handleFacilitatedFinalization(wf, descriptor, roundId, normalizedOutput, agentSessionId, summaryEntryId, lines) {
+  const template = descriptor ? getWorkflowTemplateMetadata(descriptor) : { slug: wf.id, name: wf.name };
+  try {
+    const checkpointResult = await mcpMutation("chainwork.recordWorkflowCheckpoint", {
+      agentSessionId,
+      workflowId: wf.id,
+      workflowName: wf.name,
+      templateSlug: template.slug,
+      templateName: template.name,
+      steps: wf.rounds.map((workflowRound) => ({
+        roundId: workflowRound.id,
+        num: workflowRound.num,
+        label: workflowRound.label,
+        type: workflowRound.type,
+        outputField: workflowRound.outputSchema.field,
+        outputFormat: workflowRound.outputSchema.format
+      })),
+      checkpoint: {
+        roundId,
+        output: normalizedOutput,
+        recordedAt: (/* @__PURE__ */ new Date()).toISOString()
+      },
+      summaryEntryId
+    });
+    const linked = checkpointResult.summary?.linked ?? false;
+    lines.push(
+      `**Run finalized**: Linked to existing entry \`${summaryEntryId}\`.`,
+      `Status: ${checkpointResult.run.status}`,
+      `Progress: ${checkpointResult.projection.completedCount}/${checkpointResult.projection.totalCount}`
+    );
+    if (!linked && checkpointResult.run.status !== "completed") {
+      lines.push(
+        "",
+        `Note: The run is not yet completed \u2014 the summary will be linked when all rounds are checkpointed.`
+      );
+    }
+    return {
+      content: [{ type: "text", text: lines.join("\n") }],
+      structuredContent: success(
+        `Workflow ${wf.id} finalized with linked entry ${summaryEntryId}.`,
+        {
+          entryId: summaryEntryId,
+          workflowId: wf.id,
+          roundId,
+          isFinal: true,
+          runId: checkpointResult.runId,
+          linked,
+          runStatus: checkpointResult.run.status
+        },
+        [
+          {
+            tool: "graph",
+            description: "Discover connections",
+            parameters: { action: "suggest", entryId: summaryEntryId }
+          }
+        ]
+      )
+    };
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    lines.push(
+      `**Finalization failed**: ${msg}`,
+      "",
+      `The workflow output is preserved in this conversation.`
+    );
+    return {
+      content: [{ type: "text", text: lines.join("\n") }],
+      structuredContent: failure(
+        "BACKEND_ERROR",
+        `Facilitated finalization failed: ${msg}.`,
+        "The facilitate tool's state is preserved \u2014 retry the checkpoint or continue in conversation."
+      )
+    };
+  }
+}
 function coerceWorkflowRunOutput(round, output) {
   if (typeof output !== "string") {
     assertWorkflowRunOutputMatchesRound(round, output);
@@ -8572,1118 +8672,527 @@ Use \`map-slot action=add mapEntryId="${mapEntryId}" slotId="..." ingredientEntr
 }
 
 // src/tools/architecture.ts
-import { existsSync as existsSync3, readFileSync as readFileSync2, readdirSync, statSync } from "fs";
-import { resolve as resolve3, relative, dirname as dirname2, normalize } from "path";
+import { existsSync as existsSync2, readFileSync as readFileSync2, readdirSync, statSync } from "fs";
+import { resolve as resolve2, relative, dirname, normalize } from "path";
 import { z as z19 } from "zod";
-
-// src/resources/index.ts
-import { existsSync as existsSync2 } from "fs";
-import { readFile } from "fs/promises";
-import { dirname, join, resolve as resolve2 } from "path";
-import { fileURLToPath } from "url";
-import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
-var UI_VIEWS = {
-  "ui://entries/entry-cards.html": "src/entry-cards/index.html",
-  "ui://graph/constellation.html": "src/graph-constellation/index.html"
-};
-var UI_RESOURCE_MIME_TYPE = "text/html;profile=mcp-app";
-var MODULE_DIR = dirname(fileURLToPath(import.meta.url));
-var UI_VIEW_BASE_CANDIDATES = [
-  resolve2(MODULE_DIR, "views"),
-  resolve2(MODULE_DIR, "..", "views"),
-  resolve2(MODULE_DIR, "..", "..", "dist", "views"),
-  resolve2(MODULE_DIR, "..", "..", "..", "mcp-views", "dist")
+var COLLECTION_SLUG = "architecture";
+var COLLECTION_FIELDS = [
+  { key: "archType", label: "Architecture Type", type: "select", required: true, options: ["template", "layer", "node", "flow"], searchable: true },
+  { key: "templateRef", label: "Template Entry ID", type: "text", searchable: false },
+  { key: "layerRef", label: "Layer Entry ID", type: "text", searchable: false },
+  { key: "description", label: "Description", type: "text", searchable: true },
+  { key: "color", label: "Color", type: "text" },
+  { key: "icon", label: "Icon", type: "text" },
+  { key: "sourceNode", label: "Source Node (flows)", type: "text" },
+  { key: "targetNode", label: "Target Node (flows)", type: "text" },
+  { key: "filePaths", label: "File Paths", type: "text", searchable: true },
+  { key: "owner", label: "Owner (circle/role)", type: "text", searchable: true },
+  { key: "layerOrder", label: "Layer Order (for templates)", type: "text" },
+  { key: "rationale", label: "Why Here? (placement rationale)", type: "text", searchable: true },
+  { key: "dependsOn", label: "Allowed Dependencies (layers this can import from)", type: "text" }
 ];
-function resolveUiViewPath(filePath, options) {
-  const moduleDir = options?.moduleDir ?? MODULE_DIR;
-  const pathExists = options?.pathExists ?? existsSync2;
-  const candidateBases = options?.moduleDir ? [
-    resolve2(moduleDir, "views"),
-    resolve2(moduleDir, "..", "views"),
-    resolve2(moduleDir, "..", "..", "dist", "views"),
-    resolve2(moduleDir, "..", "..", "..", "mcp-views", "dist")
-  ] : UI_VIEW_BASE_CANDIDATES;
-  for (const candidateBase of candidateBases) {
-    const candidatePath = join(candidateBase, filePath);
-    if (pathExists(candidatePath)) {
-      return candidatePath;
+var ARCHITECTURE_CANONICAL_KEY = "architecture_note";
+async function ensureCollection() {
+  const collections = await mcpQuery("chain.listCollections");
+  const existing = collections.find((c) => c.slug === COLLECTION_SLUG);
+  if (existing) {
+    if (!existing.defaultCanonicalKey) {
+      await mcpMutation("chain.updateCollection", {
+        slug: COLLECTION_SLUG,
+        defaultCanonicalKey: ARCHITECTURE_CANONICAL_KEY
+      });
     }
+    return;
   }
-  return null;
+  await mcpMutation("chain.createCollection", {
+    slug: COLLECTION_SLUG,
+    name: "Architecture",
+    icon: "\u{1F3D7}\uFE0F",
+    description: "System architecture map \u2014 templates, layers, nodes, and flows. Visualized in the Architecture Explorer and via MCP architecture tools.",
+    fields: COLLECTION_FIELDS
+  });
 }
-function renderMissingUiView(uri) {
-  return `<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8" />
-  <meta name="viewport" content="width=device-width, initial-scale=1" />
-  <title>Product Brain View Unavailable</title>
-  <style>
-    body {
-      margin: 0;
-      padding: 20px;
-      font-family: system-ui, sans-serif;
-      background: #0f172a;
-      color: #e2e8f0;
-    }
-    .panel {
-      max-width: 720px;
-      margin: 0 auto;
-      padding: 20px;
-      border: 1px solid #334155;
-      border-radius: 12px;
-      background: #111827;
-    }
-    h1 {
-      margin: 0 0 12px;
-      font-size: 18px;
-    }
-    p {
-      margin: 0 0 10px;
-      line-height: 1.5;
-    }
-    code {
-      font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
-      color: #93c5fd;
-    }
-  </style>
-</head>
-<body>
-  <main class="panel">
-    <h1>Product Brain view unavailable</h1>
-    <p>The UI resource <code>${uri}</code> could not be loaded.</p>
-    <p>If this is a local checkout, rebuild the MCP views bundle. If this is an installed package, the published package is missing its bundled views.</p>
-  </main>
-</body>
-</html>`;
+async function listArchEntries() {
+  return mcpQuery("chain.listEntries", { collectionSlug: COLLECTION_SLUG });
 }
-function formatEntryMarkdown(entry) {
-  const id = entry.entryId ? `${entry.entryId}: ` : "";
-  const lines = [`## ${id}${entry.name} [${entry.status}]`];
-  if (entry.data && typeof entry.data === "object") {
-    for (const [key, val] of Object.entries(entry.data)) {
-      if (val && key !== "rawData") {
-        lines.push(`**${key}**: ${typeof val === "string" ? val : JSON.stringify(val)}`);
-      }
-    }
-  }
-  return lines.join("\n");
+function byTag(entries, archType) {
+  return entries.filter((e) => e.tags?.includes(`archType:${archType}`) || e.data?.archType === archType).sort((a, b) => (a.order ?? 0) - (b.order ?? 0));
 }
-function buildOrientationMarkdown(collections, trackingEvents, standards, businessRules, principles) {
-  const sections = ["# Product Brain \u2014 Orientation"];
-  sections.push(
-    "## About Product Brain (PB)\nPB is a knowledge management system used by many product teams. This section describes how PB works \u2014 not your product.\n\n### How PB Organizes Its Tools\n- **Tools** = actions with side-effects or dynamic computation (capture, commit, search).\n- **Resources** = stable, read-only data (orientation, terminology, collection schemas).\n- **Prompts** = multi-step choreography (workflows, guided capture, deep dives).\n- Every tool, resource, and prompt works for ANY workspace \u2014 no bespoke logic.\n- Resource templates (URI params) serve workspace-specific data through generic patterns.\n- Compound tools with `action` enums keep the tool count minimal.\n\n### How PB Handles Your Data\n- **Draft-first**: all writes create drafts. SSOT requires explicit user confirmation.\n- **Empty-workspace safe**: every operation handles zero entries and fresh workspaces.\n- **Advisory, not blocking**: quality scores, contradiction checks, and coaching never prevent operations.\n- **Workspace-agnostic**: PB is a product for many teams \u2014 no workspace-specific logic.\n- **Self-documenting**: orient and server instructions teach agents how PB works."
-  );
-  const wsRules = [];
-  for (const p of (principles ?? []).filter((e) => e.status === "active" || e.status === "verified")) {
-    wsRules.push({ id: p.entryId ?? "", name: p.name, severity: p.data?.severity ?? void 0, source: "principles" });
-  }
-  for (const s of (standards ?? []).filter((e) => e.status === "active" || e.status === "verified")) {
-    wsRules.push({ id: s.entryId ?? "", name: s.name, severity: s.data?.severity ?? void 0, source: "standards" });
-  }
-  for (const r of (businessRules ?? []).filter((e) => e.status === "active" || e.status === "verified")) {
-    wsRules.push({ id: r.entryId ?? "", name: r.name, severity: r.data?.severity ?? void 0, source: "business-rules" });
-  }
-  if (wsRules.length > 0) {
-    const ruleLines = wsRules.map((r) => {
-      const sev = r.severity ? ` [${r.severity}]` : "";
-      return `- **${r.id}**: ${r.name}${sev}`;
-    }).join("\n");
-    sections.push(
-      `## Your Workspace Principles & Rules (${wsRules.length} active)
-These are principles, standards, and rules your team has committed to the Chain. Respect them during implementation.
+function formatLayerText(layer, nodes) {
+  const layerNodes = nodes.filter((n) => n.data?.layerRef === layer.entryId);
+  const nodeList = layerNodes.map((n) => {
+    const desc = n.data?.description ? ` \u2014 ${n.data.description}` : "";
+    const owner = n.data?.owner ? ` (${n.data.owner})` : "";
+    return `  - ${n.data?.icon ?? "\u25FB"} **${n.name}**${desc}${owner}`;
+  }).join("\n");
+  return `### ${layer.name}
+${layer.data?.description ?? ""}
 
-` + ruleLines + '\n\nUse `entries action=get entryId="<ID>"` to drill into any rule before making changes in that area.'
-    );
-  } else {
-    sections.push(
-      "## Your Workspace Principles & Rules\nNo active principles, standards, or business rules on the Chain yet.\nUse `capture` with collection `principles`, `standards`, or `business-rules` to add your team's guardrails.\nOnce committed, they appear here at orient time \u2014 so every agent session starts with your rules visible."
-    );
+${nodeList || "  _No components_"}`;
+}
+var SEED_TEMPLATE = {
+  entryId: "ARCH-tpl-product-os",
+  name: "Product OS Default",
+  data: {
+    archType: "template",
+    description: "Default 4-layer architecture: Auth \u2192 Infrastructure \u2192 Core \u2192 Features, with an outward Integration layer",
+    layerOrder: JSON.stringify(["auth", "infrastructure", "core", "features", "integration"])
   }
-  sections.push(
-    "## Core Product Architecture\nThe Chain is a versioned, connected, compounding knowledge base \u2014 the SSOT for a product team.\nEverything on the Chain is one of **three primitives**:\n\n- **Entry** (atom) \u2014 a discrete knowledge unit: target audience, business rule, glossary term, metric, tension. Lives in a collection.\n- **Process** (authored) \u2014 a narrative chain with named links (Strategy Coherence, IDM Proposal). Content is inline text. Collection: `chains`.\n- **Map** (composed) \u2014 a framework assembled by reference (Lean Canvas, Empathy Map). Slots point to ingredient entries. Collection: `maps`.\n\nEntries are atoms. Processes author narrative from atoms. Maps compose frameworks from atoms.\nAll three share the same versioning, branching, gating, and relation system.\n\nThe Chain compounds: each new relation makes entries discoverable from more starting points \u2192 context gathering returns richer results \u2192 AI processes have more context \u2192 quality scores improve \u2192 next commit is smarter than the last."
-  );
-  sections.push(
-    "## Architecture\n```\nCursor (stdio) \u2192 MCP Server (mcp-server/src/index.ts)\n  \u2192 POST /api/mcp with Bearer token\n  \u2192 Convex HTTP Action (convex/http.ts)\n  \u2192 internalQuery / internalMutation (convex/mcpKnowledge.ts)\n  \u2192 Convex DB (workspace-scoped)\n```\nSecurity: API key auth on every request, workspace-scoped data, internal functions blocked from external clients.\nKey files: `packages/mcp-server/src/client.ts` (HTTP client + audit), `convex/schema.ts` (schema)."
-  );
-  if (collections) {
-    const collList = collections.map((c) => {
-      const prefix = c.icon ? `${c.icon} ` : "";
-      return `- ${prefix}**${c.name}** (\`${c.slug}\`) \u2014 ${c.description || "no description"}`;
-    }).join("\n");
-    sections.push(
-      `## Data Model (${collections.length} collections)
-Unified entries model: collections define field schemas, entries hold data in a flexible \`data\` field.
-The \`data\` field is polymorphic: plain fields for generic entries, \`ChainData\` (chainTypeId + links) for processes, \`MapData\` (templateId + slots) for maps.
-Tags for filtering (e.g. \`severity:high\`), relations via \`entryRelations\`, versions via \`entryVersions\`, labels via \`labels\` + \`entryLabels\`.
+};
+var SEED_LAYERS = [
+  { entryId: "ARCH-layer-auth", name: "Auth", order: 0, data: { archType: "layer", templateRef: "ARCH-tpl-product-os", color: "#22c55e", description: "Authentication, user management, and workspace-scoped access control", icon: "\u{1F510}", dependsOn: "none", rationale: "Foundation layer. Auth depends on nothing \u2014 it is the first gate. No layer may bypass auth. All other layers depend on auth to know who the user is and which workspace they belong to." } },
+  { entryId: "ARCH-layer-infra", name: "Infrastructure", order: 1, data: { archType: "layer", templateRef: "ARCH-tpl-product-os", color: "#ec4899", description: "Real-time data, event tracking, and AI model infrastructure", icon: "\u2699\uFE0F", dependsOn: "Auth", rationale: "Infrastructure sits on top of Auth. It provides the database, analytics, and AI plumbing that Core and Features consume. Infra may import from Auth (needs workspace context) but never from Core or Features." } },
+  { entryId: "ARCH-layer-core", name: "Core", order: 2, data: { archType: "layer", templateRef: "ARCH-tpl-product-os", color: "#8b5cf6", description: "Business logic, knowledge graph, workflow engines, and MCP tooling", icon: "\u{1F9E0}", dependsOn: "Auth, Infrastructure", rationale: "Core contains business logic and engines that are UI-agnostic. It may import from Auth and Infra. Features depend on Core, but Core must never depend on Features \u2014 this is what keeps engines reusable across different UIs." } },
+  { entryId: "ARCH-layer-features", name: "Features", order: 3, data: { archType: "layer", templateRef: "ARCH-tpl-product-os", color: "#6366f1", description: "User-facing pages, components, and feature modules", icon: "\u2726", dependsOn: "Auth, Infrastructure, Core", rationale: "Features are the user-facing layer \u2014 SvelteKit routes, components, and page-level logic. Features may import from any lower layer but nothing above may import from Features. This is the outermost application layer." } },
+  { entryId: "ARCH-layer-integration", name: "Integration", order: 4, data: { archType: "layer", templateRef: "ARCH-tpl-product-os", color: "#f59e0b", description: "Outward connections to external tools, IDEs, and services", icon: "\u{1F50C}", dependsOn: "Core", rationale: "Integration is a lateral/outward layer \u2014 it connects to external systems (IDE, GitHub, Linear). It depends on Core (to expose knowledge) but sits outside the main stack. External tools call into Core via Integration, never directly into Features." } }
+];
+var SEED_NODES = [
+  // Auth layer
+  { entryId: "ARCH-node-clerk", name: "Clerk", order: 0, data: { archType: "node", layerRef: "ARCH-layer-auth", color: "#22c55e", icon: "\u{1F511}", description: "Authentication provider \u2014 sign-in/sign-up pages, session management, organization-level access control. UserSync.svelte is cross-cutting layout glue (not mapped here).", filePaths: "src/routes/sign-in/, src/routes/sign-up/", owner: "Platform", rationale: "Auth layer because Clerk is the identity gate. Every request flows through auth first. No other layer provides identity." } },
+  { entryId: "ARCH-node-workspace", name: "Workspace Scoping", order: 1, data: { archType: "node", layerRef: "ARCH-layer-auth", color: "#22c55e", icon: "\u{1F3E2}", description: "Multi-tenancy anchor \u2014 all data is workspace-scoped via workspaceId", filePaths: "src/lib/stores/workspace.ts, convex/workspaces.ts", owner: "Platform", rationale: "Auth layer because workspace scoping is the second gate after identity. All queries require workspaceId, making this foundational." } },
+  // Infrastructure layer
+  { entryId: "ARCH-node-convex", name: "Convex", order: 0, data: { archType: "node", layerRef: "ARCH-layer-infra", color: "#ec4899", icon: "\u26A1", description: "Reactive database with real-time sync, serverless functions, and type-safe API generation. Unified Collections + Entries model", filePaths: "convex/schema.ts, convex/entries.ts, convex/http.ts", owner: "Platform", rationale: "Infrastructure because Convex is raw persistence and reactivity plumbing. It stores data but has no business logic opinions. Core and Features consume it." } },
+  { entryId: "ARCH-node-posthog", name: "PostHog", order: 1, data: { archType: "node", layerRef: "ARCH-layer-infra", color: "#ec4899", icon: "\u{1F4CA}", description: "Product analytics \u2014 workspace-scoped events, feature flags, session replay", filePaths: "src/lib/analytics.ts, src/lib/components/PostHogWorkspaceSync.svelte", owner: "Platform", rationale: "Infrastructure because PostHog is analytics plumbing \u2014 event collection and aggregation. It has no knowledge of business domains." } },
+  { entryId: "ARCH-node-openrouter", name: "OpenRouter", order: 2, data: { archType: "node", layerRef: "ARCH-layer-infra", color: "#ec4899", icon: "\u{1F916}", description: "AI model routing for ChainWork artifact generation \u2014 streaming responses with format-aware prompts", filePaths: "src/routes/api/chainwork/generate/+server.ts", owner: "ChainWork", rationale: "Infrastructure because OpenRouter is an AI model gateway \u2014 it routes prompts to models. The strategy logic lives in ChainWork Engine (Core); this is just the pipe." } },
+  // Core layer
+  { entryId: "ARCH-node-mcp", name: "MCP Server", order: 0, data: { archType: "node", layerRef: "ARCH-layer-core", color: "#8b5cf6", icon: "\u{1F527}", description: "~19 modular tools exposing the knowledge graph as AI-consumable operations \u2014 capture, context assembly, verification, quality checks", filePaths: "packages/mcp-server/src/index.ts, packages/mcp-server/src/tools/", owner: "AI DX", rationale: "Core layer because the MCP server encodes business operations \u2014 capture with auto-linking, quality scoring, governance rules. It depends on Infra (Convex) but never touches UI routes. Why not Infrastructure? Because it has domain opinions. Why not Features? Because it has no UI \u2014 any client (Cursor, CLI, API) can call it." } },
+  { entryId: "ARCH-node-knowledge-graph", name: "Knowledge Graph", order: 1, data: { archType: "node", layerRef: "ARCH-layer-core", color: "#8b5cf6", icon: "\u{1F578}\uFE0F", description: "20 collections, 170+ entries with typed cross-collection relations. Smart capture, auto-linking, quality scoring", filePaths: "convex/mcpKnowledge.ts, convex/entries.ts", owner: "Knowledge", rationale: "Core layer because the knowledge graph IS the domain model \u2014 collections, entries, relations, versioning, quality scoring. Glossary DATA, business rules DATA, tension DATA all live here. Why not Features? Because the data model exists independently of any page. The Glossary page in Features is just one way to visualize terms that Core owns. Think: Core owns the dictionary, Features owns the dictionary app." } },
+  { entryId: "ARCH-node-governance", name: "Governance Engine", order: 2, data: { archType: "node", layerRef: "ARCH-layer-core", color: "#8b5cf6", icon: "\u2696\uFE0F", description: "Circles, roles, consent-based decision-making, tension processing with IDM-inspired async workflows", filePaths: "convex/versioning.ts, src/lib/components/versioning/", owner: "Governance", rationale: "Core layer because governance logic (draft\u2192publish workflows, consent-based decisions, tension status rules) is business process that multiple UIs consume. Why not Features? Because the versioning system and proposal flow are reusable engines \u2014 the Governance Pages in Features are just one rendering of these rules." } },
+  { entryId: "ARCH-node-chainwork-engine", name: "ChainWork Engine", order: 3, data: { archType: "node", layerRef: "ARCH-layer-core", color: "#8b5cf6", icon: "\u26D3", description: "Guided strategy creation through 5-step coherence chain \u2014 AI-generated artifacts with scoring and achievements", filePaths: "src/lib/components/chainwork/config.ts, src/lib/components/chainwork/scoring.ts", owner: "ChainWork", rationale: "Core layer because the coherence chain logic, scoring algorithm, and quality gates are business rules. config.ts defines chain steps, scoring.ts computes quality \u2014 these could power a CLI or API. Why not Features? Because the ChainWork UI wizard in Features is just one skin over this engine." } },
+  // Features layer
+  { entryId: "ARCH-node-command-center", name: "Command Center", order: 0, data: { archType: "node", layerRef: "ARCH-layer-features", color: "#6366f1", icon: "\u2B21", description: "Calm home screen \u2014 daily orientation, triage mode, pulse metrics, momentum tracking", filePaths: "src/routes/+page.svelte, src/lib/components/command-center/", owner: "Command Center", rationale: "Features layer because the Command Center is a SvelteKit page \u2014 PulseMetrics, NeedsAttention, DailyBriefing are UI components that assemble data from Core queries. Why not Core? Because it has no reusable business logic or engines \u2014 it is pure layout and presentation. If you deleted this page, no business rule would break." } },
+  { entryId: "ARCH-node-chainwork-ui", name: "ChainWork UI", order: 1, data: { archType: "node", layerRef: "ARCH-layer-features", color: "#6366f1", icon: "\u26D3", description: "Multi-step wizard for strategy artifact creation \u2014 setup, chain steps, quality gates, output", filePaths: "src/routes/chainwork/, src/lib/components/chainwork/", owner: "ChainWork", rationale: "Features layer because the ChainWork UI is the wizard interface \u2014 step navigation, form inputs, output rendering. Why not Core? Because the scoring logic and chain config ARE in Core (ChainWork Engine). This is the presentation skin over that engine. Delete this page and the engine still works via MCP." } },
+  { entryId: "ARCH-node-glossary", name: "Glossary", order: 2, data: { archType: "node", layerRef: "ARCH-layer-features", color: "#6366f1", icon: "Aa", description: "Canonical vocabulary management \u2014 term detail, code drift detection, inline term linking", filePaths: "src/routes/glossary/, src/lib/components/glossary/", owner: "Knowledge", rationale: "Features layer \u2014 NOT Core or Infrastructure \u2014 because this is the Glossary PAGE: the SvelteKit route for browsing, editing, and viewing terms. Why not Core? Because Core owns the glossary DATA (Knowledge Graph) and term-linking logic. The MCP server also accesses glossary terms without any page. Why not Infrastructure? Because glossary is domain-specific vocabulary, not generic plumbing. The page is one consumer of the data \u2014 Core owns the dictionary, Features owns the dictionary app." } },
+  { entryId: "ARCH-node-tensions", name: "Tensions", order: 3, data: { archType: "node", layerRef: "ARCH-layer-features", color: "#6366f1", icon: "\u26A1", description: "Tension capture and processing \u2014 raise, triage, resolve through governance workflow", filePaths: "src/routes/tensions/, src/lib/components/tensions/", owner: "Governance", rationale: "Features layer because this is the Tensions PAGE \u2014 the UI for raising, listing, and viewing tensions. Why not Core? Because tension data, status rules (SOS-020), and processing logic already live in Core (Governance Engine). This page is a form + list view that reads from and writes to Core. Delete it and the governance engine still processes tensions via MCP." } },
+  { entryId: "ARCH-node-strategy", name: "Strategy", order: 4, data: { archType: "node", layerRef: "ARCH-layer-features", color: "#6366f1", icon: "\u25A3", description: "Product strategy pages \u2014 vision, ecosystem, product areas, decision frameworks, sequencing", filePaths: "src/routes/strategy/, src/routes/bridge/, src/routes/topology/", owner: "Strategy", rationale: "Features layer because Strategy is a set of SvelteKit pages (strategy, bridge, topology) that visualize strategy entries. Why not Core? Because the strategy data (vision, principles, ecosystem layers) lives in the Knowledge Graph (Core). These pages render and allow inline editing \u2014 they consume Core downward." } },
+  { entryId: "ARCH-node-governance-ui", name: "Governance Pages", order: 5, data: { archType: "node", layerRef: "ARCH-layer-features", color: "#6366f1", icon: "\u25C8", description: "Roles, circles, principles, policies, decisions, proposals, business rules", filePaths: "src/routes/roles/, src/routes/circles/, src/routes/decisions/, src/routes/proposals/", owner: "Governance", rationale: "Features layer because these are governance PAGES \u2014 list views and detail views for roles, circles, decisions, proposals. Why not Core? Because the governance ENGINE (versioning, consent, IDM) IS in Core. These pages are the user-facing window into governance data. The logic doesn't live here, only the rendering." } },
+  { entryId: "ARCH-node-artifacts", name: "Artifacts", order: 6, data: { archType: "node", layerRef: "ARCH-layer-features", color: "#6366f1", icon: "\u{1F4C4}", description: "Strategy artifacts from ChainWork \u2014 pitches, briefs, one-pagers linked to the knowledge graph", filePaths: "src/routes/artifacts/", owner: "ChainWork", rationale: "Features layer because the Artifacts page is a list/detail view for strategy artifacts produced by ChainWork. Why not Core? Because artifact data and scoring live in Core (ChainWork Engine). This page just renders the output and links back to the knowledge graph." } },
+  // Integration layer
+  { entryId: "ARCH-node-cursor", name: "Cursor IDE", order: 0, data: { archType: "node", layerRef: "ARCH-layer-integration", color: "#f59e0b", icon: "\u{1F5A5}\uFE0F", description: "AI-assisted development with MCP-powered knowledge context \u2014 smart capture, verification, context assembly in the editor", filePaths: ".cursor/mcp.json, .cursor/rules/", owner: "AI DX", rationale: "Integration layer because Cursor is an external tool that connects INTO our system via MCP. Why not Core or Features? Because Cursor itself is not our code \u2014 it's a consumer. The .cursor/ config files define how it talks to us, but Cursor lives outside our deployment boundary." } },
+  { entryId: "ARCH-node-github", name: "GitHub", order: 1, data: { archType: "node", layerRef: "ARCH-layer-integration", color: "#f59e0b", icon: "\u{1F419}", description: "Code repository, PR reviews with governance context, CI/CD", owner: "Platform", rationale: "Integration layer because GitHub is an external service. Why not Infrastructure? Because Infra is about plumbing we control (database, analytics). GitHub is a third-party that hooks into our Core (PR reviews checking governance rules) but is not part of our deployed application." } },
+  { entryId: "ARCH-node-linear", name: "Linear (planned)", order: 2, data: { archType: "node", layerRef: "ARCH-layer-integration", color: "#f59e0b", icon: "\u{1F4D0}", description: "Issue tracking, roadmap sync, tension-to-issue pipeline (planned integration)", owner: "Platform", rationale: "Integration layer because Linear is an external issue tracker. Why not Infrastructure? Because Infra is generic plumbing we run. Linear is a third-party tool we connect to. The planned pipeline bridges tensions (Core) to Linear issues \u2014 a classic outward integration pattern." } }
+];
+var SEED_FLOWS = [
+  { entryId: "ARCH-flow-smart-capture", name: "Capture Flow", order: 0, data: { archType: "flow", sourceNode: "ARCH-node-cursor", targetNode: "ARCH-node-knowledge-graph", description: "Developer/AI calls capture via MCP \u2192 entry created with auto-linking and quality score \u2192 stored in Knowledge Graph", color: "#8b5cf6" } },
+  { entryId: "ARCH-flow-governance", name: "Governance Flow", order: 1, data: { archType: "flow", sourceNode: "ARCH-node-tensions", targetNode: "ARCH-node-governance", description: "Tension raised \u2192 appears in Command Center \u2192 triaged \u2192 processed via IDM \u2192 decision logged", color: "#6366f1" } },
+  { entryId: "ARCH-flow-chainwork", name: "ChainWork Strategy Flow", order: 2, data: { archType: "flow", sourceNode: "ARCH-node-chainwork-ui", targetNode: "ARCH-node-artifacts", description: "Leader opens ChainWork \u2192 walks coherence chain \u2192 AI generates artifact \u2192 scored and published to knowledge graph", color: "#f59e0b" } },
+  { entryId: "ARCH-flow-knowledge-trust", name: "Knowledge Trust Flow", order: 3, data: { archType: "flow", sourceNode: "ARCH-node-mcp", targetNode: "ARCH-node-glossary", description: "MCP verify tool checks entries against codebase \u2192 file existence, schema references validated \u2192 trust scores updated", color: "#22c55e" } },
+  { entryId: "ARCH-flow-analytics", name: "Analytics Flow", order: 4, data: { archType: "flow", sourceNode: "ARCH-node-command-center", targetNode: "ARCH-node-posthog", description: "Feature views and actions tracked \u2192 workspace-scoped events \u2192 PostHog group analytics \u2192 Command Center metrics", color: "#ec4899" } }
+];
+var architectureSchema = z19.object({
+  action: z19.enum(["show", "explore", "flow"]).describe("Action: show full map, explore a layer, or visualize a flow"),
+  template: z19.string().optional().describe("Template entry ID to filter by (for show)"),
+  layer: z19.string().optional().describe("Layer name or entry ID (for explore), e.g. 'Core' or 'ARCH-layer-core'"),
+  flow: z19.string().optional().describe("Flow name or entry ID (for flow), e.g. 'Smart Capture Flow'")
+});
+var architectureAdminSchema = z19.object({
+  action: z19.enum(["seed", "check"]).describe("Action: seed default architecture data, or check dependency health")
+});
+function registerArchitectureTools(server) {
+  server.registerTool(
+    "architecture",
+    {
+      title: "Architecture",
+      description: "Explore the system architecture \u2014 show the full map, explore a specific layer, or visualize a data flow.\n\nActions:\n- `show`: Render the layered architecture map (Auth \u2192 Infra \u2192 Core \u2192 Features \u2192 Integration)\n- `explore`: Drill into a layer to see nodes, ownership, file paths\n- `flow`: Visualize a data flow path between nodes",
+      inputSchema: architectureSchema,
+      annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false }
+    },
+    withEnvelope(async ({ action, template, layer, flow }) => {
+      await ensureCollection();
+      const all = await listArchEntries();
+      if (action === "show") {
+        const templates = byTag(all, "template");
+        const activeTemplate = template ? templates.find((t) => t.entryId === template) : templates[0];
+        const templateName = activeTemplate?.name ?? "System Architecture";
+        const templateId = activeTemplate?.entryId;
+        const layers = byTag(all, "layer").filter((l) => !templateId || l.data?.templateRef === templateId);
+        const nodes = byTag(all, "node");
+        const flows = byTag(all, "flow");
+        if (layers.length === 0) {
+          return {
+            content: [{
+              type: "text",
+              text: "# Architecture Explorer\n\nNo architecture data found. Use `architecture-admin action=seed` to populate the default architecture."
+            }],
+            structuredContent: failure(
+              "NOT_FOUND",
+              "No architecture data found.",
+              "Seed the default architecture first.",
+              [{ tool: "architecture-admin", description: "Seed architecture", parameters: { action: "seed" } }]
+            )
+          };
+        }
+        const textLayers = layers.map((l) => formatLayerText(l, nodes)).join("\n\n");
+        const textFlows = flows.length > 0 ? "\n\n---\n\n## Data Flows\n\n" + flows.map(
+          (f) => `- **${f.name}**: ${f.data?.description ?? ""}`
+        ).join("\n") : "";
+        const text = `# ${templateName}
 
-` + collList + "\n\nUse `collections action=list` for field schemas, `entries action=get` for full records."
-    );
-  } else {
-    sections.push(
-      "## Data Model\nCould not load collections \u2014 use `collections action=list` to browse manually."
-    );
-  }
-  const rulesCount = businessRules ? `${businessRules.length} entries` : "not loaded \u2014 collection may not exist yet";
-  sections.push(
-    `## Business Rules
-Collection: \`business-rules\` (${rulesCount}).
-Find rules: \`entries action=search\` for text search, \`entries action=list collection=business-rules\` to browse.
-Check compliance: use the \`review-against-rules\` prompt (pass a domain).
-Draft a new rule: use the \`draft-rule-from-context\` prompt.`
-  );
-  const eventsCount = trackingEvents ? `${trackingEvents.length} events` : "not loaded \u2014 collection may not exist yet";
-  const conventionNote = standards ? "Naming convention: `object_action` in snake_case with past-tense verbs (from standards collection)." : "Naming convention: `object_action` in snake_case with past-tense verbs.";
-  sections.push(
-    `## Analytics & Tracking
-Event catalog: \`tracking-events\` collection (${eventsCount}).
-${conventionNote}
-Implementation: \`src/lib/analytics.ts\`. Workspace-scoped events MUST use \`withWorkspaceGroup()\`.
-Browse: \`entries action=list collection=tracking-events\`.`
-  );
-  sections.push(
-    "## Knowledge Graph\nEntries are connected via typed relations (`entryRelations` table). Relations are bidirectional and collection-agnostic \u2014 any entry can link to any other entry.\n\n**Recommended relation types** (extensible \u2014 any string accepted):\n- `governs` \u2014 a rule constrains behavior of a feature\n- `defines_term_for` \u2014 a glossary term is canonical vocabulary for a feature/area\n- `belongs_to` \u2014 a feature belongs to a product area or parent concept\n- `informs` \u2014 a decision or insight informs a feature\n- `fills_slot` \u2014 an ingredient entry fills a slot in a map\n- `surfaces_tension_in` \u2014 a tension exists within a feature area\n- `related_to`, `depends_on`, `replaces`, `conflicts_with`, `references`, `confused_with`\n\nEach relation type is defined as a glossary entry (prefix `GT-REL-*`) to prevent terminology drift.\n\n**Tools:**\n- `context action=gather` \u2014 get the full context around any entry (multi-hop graph traversal)\n- `graph action=suggest` \u2014 discover potential connections for an entry\n- `relations action=create` \u2014 create a typed link between two entries\n- `graph action=find` \u2014 list direct relations for an entry\n\n**Convention:** When creating or updating entries in governed collections, always use `graph action=suggest` to discover and create relevant relations."
-  );
-  sections.push(
-    "## Creating Knowledge\n**Entries:** Use `capture` as the primary tool for creating new entries. It handles the full workflow in one call:\n1. Creates the entry with collection-aware defaults (auto-fills dates, infers domains, sets priority)\n2. Auto-links related entries from across the chain (up to 5 confident matches)\n3. Returns a quality scorecard (X/10) with actionable improvement suggestions\n\n**Smart profiles** exist for: `tensions`, `business-rules`, `glossary`, `decisions`, `features`, `audiences`, `strategy`, `standards`, `maps`, `chains`, `tracking-events`.\nAll other collections use the `ENT-{random}` fallback profile.\n\n**Processes:** Use `chain action=create` with a template (e.g., `strategy-coherence`, `idm-proposal`). Fill links with `chain action=edit`.\n\n**Maps:** Use `map action=create` with a template (e.g., `lean-canvas`). Fill slots with `map-slot action=add`. Commit with `map-version action=commit`.\nNote: committing a map version creates a snapshot but does NOT change the entry status. To activate: `update-entry entryId=MAP-xxx status=active autoPublish=true`.\nUse `map-suggest` to discover ingredients for empty slots.\n\n**Prompts** (invoke via MCP prompt protocol):\n- `name-check` \u2014 verify a name against glossary conventions\n- `draft-decision-record` \u2014 scaffold a decision entry\n- `review-against-rules` \u2014 check work against business rules for a domain\n- `draft-rule-from-context` \u2014 create a new business rule from context\n- `run-workflow` \u2014 run a structured ceremony (e.g., retrospective)\n\nUse `quality action=check` to score existing entries retroactively.\nUse `update-entry` for post-creation adjustments (status changes, field updates, deprecation)."
-  );
-  sections.push(
-    "## Where to Go Next\n- **Create entry** \u2192 `capture` tool (auto-links + quality score in one call)\n- **Full context** \u2192 `context action=gather` (by entry ID or task description)\n- **Discover links** \u2192 `graph action=suggest`\n- **Quality audit** \u2192 `quality action=check`\n- **Terminology** \u2192 `name-check` prompt or `productbrain://terminology` resource\n- **Schema details** \u2192 `productbrain://collections` resource or `collections action=list`\n- **Labels** \u2192 `productbrain://labels` resource or `labels` tool\n- **Any collection** \u2192 `productbrain://{slug}/entries` resource\n- **Log a decision** \u2192 `draft-decision-record` prompt\n- **Build a map** \u2192 `map action=create` + `map-slot action=add` + `map-version action=commit`\n- **Architecture map** \u2192 `architecture action=show` tool (layered system visualization)\n- **Explore a layer** \u2192 `architecture action=explore` tool (drill into Auth, Core, Features, etc.)\n- **Growth funnel** \u2192 `productbrain://growth-funnel` resource or `entries action=list collection=strategy status=draft`\n- **Audiences** \u2192 `productbrain://audiences/entries` resource or `entries action=list collection=audiences`\n- **Session identity** \u2192 `health action=whoami`\n- **Health check** \u2192 `health action=check`\n- **Debug MCP calls** \u2192 `health action=audit`"
-  );
-  return sections.join("\n\n---\n\n");
-}
-var AGENT_CHEATSHEET = `# Product Brain \u2014 Agent Cheatsheet
-
-## Core Tools
-| Tool | Purpose | Key params |
-|---|---|---|
-| \`orient\` | Workspace context, governance, active bets | \u2014 (call at session start) |
-| \`capture\` | Create entry (draft) | \`collection\`, \`name\`, \`description\`, optional \`data\` |
-| \`entries\` | List / get / batch / search entries | \`action\` + \`entryId\` / \`query\` / \`collection\` |
-| \`update-entry\` | Update fields on an entry | \`entryId\`, optional \`name\`, \`status\`, \`workflowStatus\`, \`data\`, \`changeNote\` |
-| \`commit-entry\` | Promote draft \u2192 SSOT | \`entryId\` |
-| \`graph\` | Suggest / find relations | \`action\` + \`entryId\` |
-| \`relations\` | Create / batch-create / delete links | \`from\`, \`to\`, \`type\` |
-| \`context\` | Gather related knowledge | \`entryId\` or \`task\` |
-| \`collections\` | List / create / update collections | \`action\` |
-| \`labels\` | List / create / apply / remove labels | \`action\` |
-| \`quality\` | Score an entry | \`entryId\` |
-| \`session\` | Start / close agent session | \`action\` |
-| \`health\` | Check / audit / whoami | \`action\` |
-| \`facilitate\` | Shaping workflows | \`action\`: start, respond, status |
-
-## Collection Prefixes
-GLO (glossary), BR (business-rules), PRI (principles), STD (standards),
-DEC (decisions), STR (strategy), TEN (tensions), FEAT (features),
-BET (bets), INS (insights), ARCH (architecture), CIR (circles),
-ROL (roles), MAP (maps), MTRC (tracking-events), ST (semantic-types)
-
-## Valid Relation Types (21)
-informs, governs, surfaces_tension_in, defines_term_for, belongs_to,
-references, related_to, fills_slot, commits_to, informed_by, depends_on,
-conflicts_with, confused_with, replaces, part_of, constrains,
-governed_by, alternative_to, has_proposal, requests_promotion_of, resolves
-
-## Lifecycle Status
-All entries: \`draft\` | \`active\` | \`deprecated\` | \`archived\`
-
-## Workflow Status (per collection)
-- **tensions:** open \u2192 processing \u2192 decided \u2192 closed
-- **decisions:** pending \u2192 decided
-- **bets:** shaped \u2192 bet \u2192 building \u2192 shipped
-- **business-rules:** active | conflict | review
-
-## Key Patterns
-- **Capture flow:** \`capture\` \u2192 \`graph action=suggest\` \u2192 \`relations action=batch-create\` \u2192 \`commit-entry\`
-- Use \`workflowStatus\` (not \`status\`) for domain workflow state
-- \`data\` param is merged (not replaced) \u2014 safe for partial updates
-`;
-function registerResources(server) {
-  server.resource(
-    "agent-cheatsheet",
-    "productbrain://agent-cheatsheet",
-    async (uri) => ({
-      contents: [{
-        uri: uri.href,
-        text: AGENT_CHEATSHEET,
-        mimeType: "text/markdown"
-      }]
-    })
-  );
-  server.resource(
-    "chain-orientation",
-    "productbrain://orientation",
-    async (uri) => {
-      const [collectionsResult, eventsResult, standardsResult, rulesResult, principlesResult] = await Promise.allSettled([
-        mcpQuery("chain.listCollections"),
-        mcpQuery("chain.listEntries", { collectionSlug: "tracking-events" }),
-        mcpQuery("chain.listEntries", { collectionSlug: "standards" }),
-        mcpQuery("chain.listEntries", { collectionSlug: "business-rules" }),
-        mcpQuery("chain.listEntries", { collectionSlug: "principles" })
-      ]);
-      const collections = collectionsResult.status === "fulfilled" ? collectionsResult.value : null;
-      const trackingEvents = eventsResult.status === "fulfilled" ? eventsResult.value : null;
-      const standards = standardsResult.status === "fulfilled" ? standardsResult.value : null;
-      const businessRules = rulesResult.status === "fulfilled" ? rulesResult.value : null;
-      const principles = principlesResult.status === "fulfilled" ? principlesResult.value : null;
-      return {
-        contents: [{
-          uri: uri.href,
-          text: buildOrientationMarkdown(collections, trackingEvents, standards, businessRules, principles),
-          mimeType: "text/markdown"
-        }]
-      };
-    }
-  );
-  server.resource(
-    "chain-terminology",
-    "productbrain://terminology",
-    async (uri) => {
-      const [glossaryResult, standardsResult] = await Promise.allSettled([
-        mcpQuery("chain.listEntries", { collectionSlug: "glossary" }),
-        mcpQuery("chain.listEntries", { collectionSlug: "standards" })
-      ]);
-      const lines = ["# Product Brain \u2014 Terminology"];
-      if (glossaryResult.status === "fulfilled") {
-        const glossary = glossaryResult.value ?? [];
-        if (glossary.length > 0) {
-          const terms = glossary.map((t) => `- **${t.name}** (${t.entryId ?? "\u2014"}) [${t.status}]: ${t.data?.canonical ?? t.data?.description ?? ""}`).join("\n");
-          lines.push(`## Glossary (${glossary.length} terms)
-
-${terms}`);
-        } else {
-          lines.push("## Glossary\n\nNo glossary terms yet. Use `capture` with collection `glossary` to add terms.");
-        }
-      } else {
-        lines.push("## Glossary\n\nCould not load glossary \u2014 use `entries action=list collection=glossary` to browse manually.");
+${textLayers}${textFlows}`;
+        return {
+          content: [{ type: "text", text }],
+          structuredContent: success(
+            `Showing ${templateName}: ${layers.length} layers, ${nodes.length} nodes, ${flows.length} flows.`,
+            { templateName, layerCount: layers.length, nodeCount: nodes.length, flowCount: flows.length }
+          )
+        };
       }
-      if (standardsResult.status === "fulfilled") {
-        const standards = standardsResult.value ?? [];
-        if (standards.length > 0) {
-          const stds = standards.map((s) => `- **${s.name}** (${s.entryId ?? "\u2014"}) [${s.status}]: ${s.data?.description ?? ""}`).join("\n");
-          lines.push(`## Standards (${standards.length} entries)
-
-${stds}`);
-        } else {
-          lines.push("## Standards\n\nNo standards yet. Use `capture` with collection `standards` to add standards.");
+      if (action === "explore") {
+        if (!layer) {
+          return validationResult("A `layer` is required for explore.");
         }
-      } else {
-        lines.push("## Standards\n\nCould not load standards \u2014 use `entries action=list collection=standards` to browse manually.");
-      }
-      return {
-        contents: [{ uri: uri.href, text: lines.join("\n\n---\n\n"), mimeType: "text/markdown" }]
-      };
-    }
-  );
-  server.resource(
-    "chain-collections",
-    "productbrain://collections",
-    async (uri) => {
-      const collections = await mcpQuery("chain.listCollections") ?? [];
-      if (collections.length === 0) {
-        return { contents: [{ uri: uri.href, text: "No collections in this workspace. Use `collections action=create` or `start` with a preset to get started.", mimeType: "text/markdown" }] };
-      }
-      const formatted = collections.map((c) => {
-        const fieldList = (c.fields ?? []).map((f) => `  - \`${f.key}\` (${f.type}${f.required ? ", required" : ""}${f.searchable ? ", searchable" : ""})`).join("\n");
-        return `## ${c.icon ?? ""} ${c.name} (\`${c.slug}\`)
-${c.description || ""}
+        const layers = byTag(all, "layer");
+        const target = layers.find(
+          (l) => l.name.toLowerCase() === layer.toLowerCase() || l.entryId === layer
+        );
+        if (!target) {
+          const available = layers.map((l) => `\`${l.name}\``).join(", ");
+          return {
+            content: [{ type: "text", text: `Layer "${layer}" not found. Available layers: ${available}` }],
+            structuredContent: failure(
+              "NOT_FOUND",
+              `Layer "${layer}" not found.`,
+              `Available layers: ${available}`
+            )
+          };
+        }
+        const nodes = byTag(all, "node").filter((n) => n.data?.layerRef === target.entryId);
+        const flows = byTag(all, "flow").filter(
+          (f) => nodes.some((n) => n.entryId === f.data?.sourceNode || n.entryId === f.data?.targetNode)
+        );
+        const depRule = target.data?.dependsOn ? `
+**Dependency rule:** May import from ${target.data.dependsOn === "none" ? "nothing (foundation layer)" : target.data.dependsOn}.
+` : "";
+        const layerRationale = target.data?.rationale ? `
+> ${target.data.rationale}
+` : "";
+        const nodeDetail = nodes.map((n) => {
+          const lines = [`#### ${n.data?.icon ?? "\u25FB"} ${n.name}`];
+          if (n.data?.description) lines.push(String(n.data.description));
+          if (n.data?.owner) lines.push(`**Owner:** ${n.data.owner}`);
+          if (n.data?.filePaths) lines.push(`**Files:** \`${n.data.filePaths}\``);
+          if (n.data?.rationale) lines.push(`
+**Why here?** ${n.data.rationale}`);
+          return lines.join("\n");
+        }).join("\n\n");
+        const flowLines = flows.length > 0 ? "\n\n### Connected Flows\n\n" + flows.map((f) => `- ${f.name}: ${f.data?.description ?? ""}`).join("\n") : "";
+        return {
+          content: [{
+            type: "text",
+            text: `# ${target.data?.icon ?? ""} ${target.name} Layer
 
-**Fields:**
-${fieldList}`;
-      }).join("\n\n---\n\n");
-      return {
-        contents: [{ uri: uri.href, text: `# Knowledge Collections (${collections.length})
+${target.data?.description ?? ""}${depRule}${layerRationale}
+**${nodes.length} components**
 
-${formatted}`, mimeType: "text/markdown" }]
-      };
-    }
-  );
-  server.resource(
-    "chain-collection-entries",
-    new ResourceTemplate("productbrain://{slug}/entries", {
-      list: async () => {
-        const collections = await mcpQuery("chain.listCollections") ?? [];
-        return {
-          resources: collections.map((c) => ({
-            uri: `productbrain://${c.slug}/entries`,
-            name: `${c.icon ?? ""} ${c.name}`.trim()
-          }))
+${nodeDetail}${flowLines}`
+          }],
+          structuredContent: success(
+            `${target.name} layer: ${nodes.length} components, ${flows.length} connected flows.`,
+            { layerName: target.name, entryId: target.entryId, nodeCount: nodes.length, flowCount: flows.length }
+          )
         };
       }
-    }),
-    async (uri, { slug }) => {
-      const entries = await mcpQuery("chain.listEntries", { collectionSlug: slug }) ?? [];
-      const formatted = entries.map(formatEntryMarkdown).join("\n\n---\n\n");
-      return {
-        contents: [{
-          uri: uri.href,
-          text: formatted || "No entries in this collection.",
-          mimeType: "text/markdown"
-        }]
-      };
-    }
-  );
-  server.resource(
-    "chain-labels",
-    "productbrain://labels",
-    async (uri) => {
-      const labels = await mcpQuery("chain.listLabels") ?? [];
-      if (labels.length === 0) {
-        return { contents: [{ uri: uri.href, text: "No labels in this workspace.", mimeType: "text/markdown" }] };
-      }
-      const groups = labels.filter((l) => l.isGroup);
-      const ungrouped = labels.filter((l) => !l.isGroup && !l.parentId);
-      const children = (parentId) => labels.filter((l) => l.parentId === parentId);
-      const lines = [];
-      for (const group of groups) {
-        lines.push(`## ${group.name}`);
-        for (const child of children(group._id)) {
-          lines.push(`- \`${child.slug}\` ${child.name}${child.color ? ` (${child.color})` : ""}`);
+      if (action === "flow") {
+        if (!flow) {
+          return validationResult("A `flow` name or entry ID is required.");
         }
-      }
-      if (ungrouped.length > 0) {
-        lines.push("## Ungrouped");
-        for (const l of ungrouped) {
-          lines.push(`- \`${l.slug}\` ${l.name}${l.color ? ` (${l.color})` : ""}`);
+        const flows = byTag(all, "flow");
+        const target = flows.find(
+          (f) => f.name.toLowerCase() === flow.toLowerCase() || f.entryId === flow
+        );
+        if (!target) {
+          const available = flows.map((f) => `\`${f.name}\``).join(", ");
+          return {
+            content: [{ type: "text", text: `Flow "${flow}" not found. Available flows: ${available}` }],
+            structuredContent: failure(
+              "NOT_FOUND",
+              `Flow "${flow}" not found.`,
+              `Available flows: ${available}`
+            )
+          };
         }
-      }
-      return {
-        contents: [{ uri: uri.href, text: `# Workspace Labels (${labels.length})
-
-${lines.join("\n")}`, mimeType: "text/markdown" }]
-      };
-    }
-  );
-  server.resource(
-    "chain-entry",
-    new ResourceTemplate("productbrain://entries/{entryId}", {
-      complete: {
-        entryId: async (value) => {
-          if (!value || value.length < 1) return [];
-          const entries = await mcpQuery("chain.searchEntries", { query: value }) ?? [];
-          return entries.slice(0, 10).map((e) => e.entryId ?? e._id);
+        const nodes = byTag(all, "node");
+        const source = nodes.find((n) => n.entryId === target.data?.sourceNode);
+        const dest = nodes.find((n) => n.entryId === target.data?.targetNode);
+        const lines = [
+          `# ${target.name}`,
+          "",
+          `**${source?.data?.icon ?? "?"} ${source?.name ?? "Unknown"}** \u2192 **${dest?.data?.icon ?? "?"} ${dest?.name ?? "Unknown"}**`,
+          "",
+          String(target.data?.description ?? "")
+        ];
+        if (source) {
+          lines.push("", `### Source: ${source.name}`, String(source.data?.description ?? ""));
+          if (source.data?.filePaths) lines.push(`Files: \`${source.data.filePaths}\``);
         }
+        if (dest) {
+          lines.push("", `### Target: ${dest.name}`, String(dest.data?.description ?? ""));
+          if (dest.data?.filePaths) lines.push(`Files: \`${dest.data.filePaths}\``);
+        }
+        return {
+          content: [{ type: "text", text: lines.join("\n") }],
+          structuredContent: success(
+            `${target.name}: ${source?.name ?? "?"} \u2192 ${dest?.name ?? "?"}.`,
+            { flowName: target.name, entryId: target.entryId, source: source?.name, target: dest?.name }
+          )
+        };
       }
-    }),
-    async (uri, { entryId }) => {
-      const [entry, collections] = await Promise.all([
-        mcpQuery("chain.getEntry", { entryId }),
-        mcpQuery("chain.listCollections")
-      ]);
-      if (!entry) {
-        return { contents: [{ uri: uri.href, text: `Entry "${entryId}" not found.`, mimeType: "text/markdown" }] };
-      }
-      const collectionMap = new Map((collections ?? []).map((c) => [c._id, c]));
-      const col = collectionMap.get(entry.collectionId);
-      const collLabel = col?.name ?? entry.collectionName ?? entry.collectionSlug ?? "unknown";
-      const lines = [
-        `# ${entry.entryId}: ${entry.name}`,
-        `**Collection:** ${collLabel}`,
-        `**Status:** ${entry.status}`,
-        ""
-      ];
-      if (entry.data && typeof entry.data === "object") {
-        lines.push("## Data");
-        for (const [key, val] of Object.entries(entry.data)) {
-          if (val && key !== "rawData") {
-            const str = typeof val === "string" ? val : JSON.stringify(val, null, 2);
-            lines.push(`**${key}:** ${str}`);
+      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 }
+    },
+    withEnvelope(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 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 };
+              await mcpMutation("chain.updateEntry", { entryId: seed.entryId, data: mergedData });
+              updated++;
+            } else {
+              unchanged++;
+            }
+            continue;
           }
+          await mcpMutation("chain.createEntry", {
+            collectionSlug: COLLECTION_SLUG,
+            entryId: seed.entryId,
+            name: seed.name,
+            status: seed.status,
+            data: seed.data,
+            order: seed.order ?? 0
+          });
+          created++;
         }
-        lines.push("");
+        return {
+          content: [{
+            type: "text",
+            text: `# Architecture Seeded
+
+**Created:** ${created} entries
+**Updated:** ${updated} (merged new fields)
+**Unchanged:** ${unchanged}
+
+Use \`architecture action=show\` to view the map.`
+          }],
+          structuredContent: success(
+            `Architecture seeded: ${created} created, ${updated} updated, ${unchanged} unchanged.`,
+            { created, updated, unchanged },
+            [{ tool: "architecture", description: "View the map", parameters: { action: "show" } }]
+          )
+        };
       }
-      if (entry.relations && entry.relations.length > 0) {
-        lines.push("## Relations");
-        for (const rel of entry.relations) {
-          const arrow = rel.direction === "outgoing" ? "\u2192" : "\u2190";
-          const id = rel.otherEntryId ?? "";
-          const name = rel.otherName ?? "(unknown)";
-          lines.push(`- ${arrow} **${rel.type}** ${id}: ${name}`);
+      if (action === "check") {
+        const projectRoot = resolveProjectRoot2();
+        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."
+            )
+          };
         }
-        lines.push("");
-      }
-      if (entry.labels && entry.labels.length > 0) {
-        lines.push(`## Labels
-${entry.labels.map((l) => `- ${l.name ?? l.slug}`).join("\n")}`);
+        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 {
-        contents: [{ uri: uri.href, text: lines.join("\n"), mimeType: "text/markdown" }]
-      };
-    }
+      return unknownAction(action, ["seed", "check"]);
+    })
   );
-  server.resource(
-    "chain-context",
-    new ResourceTemplate("productbrain://context/{entryId}", {
-      complete: {
-        entryId: async (value) => {
-          if (!value || value.length < 1) return [];
-          const entries = await mcpQuery("chain.searchEntries", { query: value }) ?? [];
-          return entries.slice(0, 10).map((e) => e.entryId ?? e._id);
-        }
-      }
-    }),
-    async (uri, { entryId }) => {
-      const result = await mcpQuery("chain.gatherContext", {
-        entryId,
-        maxHops: 2
-      });
-      if (!result?.root) {
-        return { contents: [{ uri: uri.href, text: `Entry "${entryId}" not found.`, mimeType: "text/markdown" }] };
-      }
-      const lines = [
-        `# Context: ${result.root.entryId}: ${result.root.name}`,
-        `_${result.totalRelations} related entries (${result.hopsTraversed} hops)_`,
-        ""
-      ];
-      const byCollection = /* @__PURE__ */ new Map();
-      for (const entry of result.related ?? []) {
-        const key = entry.collectionName;
-        if (!byCollection.has(key)) byCollection.set(key, []);
-        byCollection.get(key).push(entry);
-      }
-      for (const [collName, entries] of byCollection) {
-        lines.push(`## ${collName} (${entries.length})`);
-        for (const e of entries) {
-          const arrow = e.relationDirection === "outgoing" ? "\u2192" : "\u2190";
-          const hopLabel = e.hop > 1 ? ` (hop ${e.hop})` : "";
-          const id = e.entryId ? `${e.entryId}: ` : "";
-          lines.push(`- ${arrow} **${e.relationType}** ${id}${e.name}${hopLabel}`);
+  trackWriteTool(archAdminTool);
+}
+function resolveProjectRoot2() {
+  const candidates = [
+    process.env.WORKSPACE_PATH,
+    process.cwd(),
+    resolve2(process.cwd(), "..")
+  ].filter(Boolean);
+  for (const dir of candidates) {
+    const resolved = resolve2(dir);
+    if (existsSync2(resolve2(resolved, "convex/schema.ts"))) return resolved;
+  }
+  return null;
+}
+function scanDependencies(projectRoot, layers, nodes) {
+  const layerMap = /* @__PURE__ */ new Map();
+  for (const l of layers) layerMap.set(l.entryId, l);
+  const allowedDeps = buildAllowedDeps(layers);
+  const nodePathPrefixes = buildNodePrefixes(nodes);
+  const violations = [];
+  const nodeResults = /* @__PURE__ */ new Map();
+  let totalFiles = 0;
+  let totalImports = 0;
+  let unmapped = 0;
+  for (const node of nodes) {
+    const layerRef = String(node.data?.layerRef ?? "");
+    const layer = layerMap.get(layerRef);
+    if (!layer) continue;
+    const filePaths = parseFilePaths(node);
+    const nodeViolations = [];
+    let nodeFileCount = 0;
+    for (const fp of filePaths) {
+      const absPath = resolve2(projectRoot, fp);
+      const files = collectFiles(absPath);
+      for (const file of files) {
+        nodeFileCount++;
+        totalFiles++;
+        const relFile = relative(projectRoot, file);
+        const imports = parseImports(file);
+        for (const imp of imports) {
+          totalImports++;
+          const resolved = resolveImport(imp, file, projectRoot);
+          if (!resolved) {
+            unmapped++;
+            continue;
+          }
+          const targetNode = findNodeByPath(resolved, nodePathPrefixes);
+          if (!targetNode) {
+            unmapped++;
+            continue;
+          }
+          const targetLayerRef = String(targetNode.data?.layerRef ?? "");
+          const targetLayer = layerMap.get(targetLayerRef);
+          if (!targetLayer) continue;
+          if (targetLayerRef === layerRef) continue;
+          const allowed = allowedDeps.get(layerRef);
+          if (allowed && !allowed.has(targetLayerRef)) {
+            const v = {
+              sourceNode: node.name,
+              sourceLayer: layer.name,
+              sourceFile: relFile,
+              importPath: imp,
+              targetNode: targetNode.name,
+              targetLayer: targetLayer.name,
+              rule: `${layer.name} cannot import from ${targetLayer.name}`
+            };
+            violations.push(v);
+            nodeViolations.push(v);
+          }
         }
-        lines.push("");
       }
-      return {
-        contents: [{ uri: uri.href, text: lines.join("\n"), mimeType: "text/markdown" }]
-      };
     }
-  );
-  server.resource(
-    "chain-search",
-    new ResourceTemplate("productbrain://search/{query}", {
-      complete: {
-        query: async (value) => {
-          if (!value) return ["glossary:", "business-rules:", "decisions:", "tensions:"];
-          return [];
-        }
-      }
-    }),
-    async (uri, { query }) => {
-      const results = await mcpQuery("chain.searchEntries", { query });
-      if (!results || results.length === 0) {
-        return { contents: [{ uri: uri.href, text: `No results for "${query}".`, mimeType: "text/markdown" }] };
-      }
-      const lines = [
-        `# Search: "${query}"`,
-        `_${results.length} results_`,
-        ""
-      ];
-      for (const entry of results) {
-        const id = entry.entryId ? `**${entry.entryId}:** ` : "";
-        const coll = entry.collectionName ?? entry.collectionSlug ?? "";
-        lines.push(`- ${id}${entry.name} [${coll}] (${entry.status})`);
+    nodeResults.set(node.entryId, { violations: nodeViolations, filesScanned: nodeFileCount });
+  }
+  return { violations, filesScanned: totalFiles, importsChecked: totalImports, unmappedImports: unmapped, nodeResults };
+}
+function buildAllowedDeps(layers) {
+  const nameToId = /* @__PURE__ */ new Map();
+  for (const l of layers) nameToId.set(l.name.toLowerCase(), l.entryId);
+  const allowed = /* @__PURE__ */ new Map();
+  for (const layer of layers) {
+    const deps = String(layer.data?.dependsOn ?? "none");
+    const set = /* @__PURE__ */ new Set();
+    if (deps !== "none") {
+      for (const dep of deps.split(",").map((d) => d.trim().toLowerCase())) {
+        const id = nameToId.get(dep);
+        if (id) set.add(id);
       }
-      return {
-        contents: [{ uri: uri.href, text: lines.join("\n"), mimeType: "text/markdown" }]
-      };
     }
-  );
-  for (const [uri, filePath] of Object.entries(UI_VIEWS)) {
-    server.resource(`ui-view-${uri.replace(/[^a-z0-9]/gi, "-")}`, uri, async (uriObj) => {
-      const viewPath = resolveUiViewPath(filePath);
-      if (viewPath) {
-        try {
-          const html = await readFile(viewPath, "utf-8");
-          return {
-            contents: [{ uri: uriObj.href, text: html, mimeType: UI_RESOURCE_MIME_TYPE }]
-          };
-        } catch {
-        }
-      }
-      return {
-        contents: [{
-          uri: uriObj.href,
-          text: renderMissingUiView(uriObj.href),
-          mimeType: UI_RESOURCE_MIME_TYPE
-        }]
-      };
-    });
+    allowed.set(layer.entryId, set);
   }
+  return allowed;
 }
-
-// src/tools/architecture.ts
-var COLLECTION_SLUG = "architecture";
-var COLLECTION_FIELDS = [
-  { key: "archType", label: "Architecture Type", type: "select", required: true, options: ["template", "layer", "node", "flow"], searchable: true },
-  { key: "templateRef", label: "Template Entry ID", type: "text", searchable: false },
-  { key: "layerRef", label: "Layer Entry ID", type: "text", searchable: false },
-  { key: "description", label: "Description", type: "text", searchable: true },
-  { key: "color", label: "Color", type: "text" },
-  { key: "icon", label: "Icon", type: "text" },
-  { key: "sourceNode", label: "Source Node (flows)", type: "text" },
-  { key: "targetNode", label: "Target Node (flows)", type: "text" },
-  { key: "filePaths", label: "File Paths", type: "text", searchable: true },
-  { key: "owner", label: "Owner (circle/role)", type: "text", searchable: true },
-  { key: "layerOrder", label: "Layer Order (for templates)", type: "text" },
-  { key: "rationale", label: "Why Here? (placement rationale)", type: "text", searchable: true },
-  { key: "dependsOn", label: "Allowed Dependencies (layers this can import from)", type: "text" }
-];
-var ARCHITECTURE_CANONICAL_KEY = "architecture_note";
-async function ensureCollection() {
-  const collections = await mcpQuery("chain.listCollections");
-  const existing = collections.find((c) => c.slug === COLLECTION_SLUG);
-  if (existing) {
-    if (!existing.defaultCanonicalKey) {
-      await mcpMutation("chain.updateCollection", {
-        slug: COLLECTION_SLUG,
-        defaultCanonicalKey: ARCHITECTURE_CANONICAL_KEY
-      });
+function buildNodePrefixes(nodes) {
+  const entries = [];
+  for (const node of nodes) {
+    for (const fp of parseFilePaths(node)) {
+      entries.push({ prefix: normalize(fp), node });
     }
-    return;
   }
-  await mcpMutation("chain.createCollection", {
-    slug: COLLECTION_SLUG,
-    name: "Architecture",
-    icon: "\u{1F3D7}\uFE0F",
-    description: "System architecture map \u2014 templates, layers, nodes, and flows. Visualized in the Architecture Explorer and via MCP architecture tools.",
-    fields: COLLECTION_FIELDS
-  });
+  entries.sort((a, b) => b.prefix.length - a.prefix.length);
+  return entries;
 }
-async function listArchEntries() {
-  return mcpQuery("chain.listEntries", { collectionSlug: COLLECTION_SLUG });
+function parseFilePaths(node) {
+  const raw = node.data?.filePaths;
+  if (!raw || typeof raw !== "string") return [];
+  return raw.split(",").map((p) => p.trim()).filter(Boolean);
 }
-function byTag(entries, archType) {
-  return entries.filter((e) => e.tags?.includes(`archType:${archType}`) || e.data?.archType === archType).sort((a, b) => (a.order ?? 0) - (b.order ?? 0));
+function collectFiles(absPath) {
+  if (!existsSync2(absPath)) return [];
+  const stat = statSync(absPath);
+  if (stat.isFile()) {
+    return isScannableFile(absPath) ? [absPath] : [];
+  }
+  if (!stat.isDirectory()) return [];
+  const results = [];
+  const walk = (dir) => {
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+      if (entry.name.startsWith(".") || entry.name === "node_modules") continue;
+      const full = resolve2(dir, entry.name);
+      if (entry.isDirectory()) walk(full);
+      else if (isScannableFile(full)) results.push(full);
+    }
+  };
+  walk(absPath);
+  return results;
 }
-function renderArchitectureHtml(layers, nodes, flows, templateName) {
-  const layerHtml = layers.map((layer) => {
-    const layerNodes = nodes.filter(
-      (n) => n.data?.layerRef === layer.entryId
-    );
-    const nodeCards = layerNodes.map((n) => `
-      <div class="node" title="${escHtml(String(n.data?.description ?? ""))}">
-        <span class="node-icon">${escHtml(String(n.data?.icon ?? "\u25FB"))}</span>
-        <span class="node-name">${escHtml(n.name)}</span>
-      </div>
-    `).join("");
-    return `
-      <div class="layer" style="--layer-color: ${escHtml(String(layer.data?.color ?? "#666"))}">
-        <div class="layer-label">
-          <span class="layer-dot"></span>
-          <span class="layer-name">${escHtml(layer.name)}</span>
-          <span class="layer-count">${layerNodes.length}</span>
-        </div>
-        <div class="layer-desc">${escHtml(String(layer.data?.description ?? ""))}</div>
-        <div class="nodes">${nodeCards || '<span class="empty">No components</span>'}</div>
-      </div>
-    `;
-  }).join("");
-  return `<!DOCTYPE html>
-<html><head><meta charset="utf-8"><style>
-*{margin:0;padding:0;box-sizing:border-box}
-body{font-family:-apple-system,system-ui,sans-serif;background:#1a1a2e;color:#e0e0e0;padding:16px}
-h1{font-size:14px;font-weight:600;color:#a0a0c0;margin-bottom:12px;letter-spacing:.04em}
-.layer{border-left:3px solid var(--layer-color);padding:8px 12px;margin-bottom:8px;background:rgba(255,255,255,.03);border-radius:0 6px 6px 0}
-.layer-label{display:flex;align-items:center;gap:8px;margin-bottom:4px}
-.layer-dot{width:8px;height:8px;border-radius:50%;background:var(--layer-color)}
-.layer-name{font-size:12px;font-weight:600;color:#fff;letter-spacing:.03em}
-.layer-count{font-size:10px;color:var(--layer-color);background:rgba(255,255,255,.06);padding:1px 6px;border-radius:8px}
-.layer-desc{font-size:11px;color:#888;margin-bottom:6px}
-.nodes{display:flex;flex-wrap:wrap;gap:6px}
-.node{display:flex;align-items:center;gap:4px;background:rgba(255,255,255,.06);border:1px solid rgba(255,255,255,.08);border-radius:4px;padding:4px 8px;font-size:11px;cursor:default;transition:border-color .15s}
-.node:hover{border-color:var(--layer-color)}
-.node-icon{font-size:12px}
-.node-name{color:#ddd}
-.empty{font-size:11px;color:#555;font-style:italic}
-.flows{margin-top:12px;border-top:1px solid rgba(255,255,255,.06);padding-top:8px}
-.flow{font-size:11px;color:#888;padding:2px 0}
-.flow-arrow{color:#6366f1;margin:0 4px}
-</style></head><body>
-<h1>${escHtml(templateName)}</h1>
-${layerHtml}
-${flows.length > 0 ? `<div class="flows"><div style="font-size:10px;color:#666;margin-bottom:4px;letter-spacing:.06em">DATA FLOWS</div>${flows.map((f) => `<div class="flow">${escHtml(f.name)}<span class="flow-arrow">\u2192</span><span style="color:#aaa">${escHtml(String(f.data?.description ?? ""))}</span></div>`).join("")}</div>` : ""}
-</body></html>`;
-}
-function escHtml(s) {
-  return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+function isScannableFile(p) {
+  return /\.(ts|js|svelte)$/.test(p) && !p.endsWith(".d.ts");
 }
-function formatLayerText(layer, nodes) {
-  const layerNodes = nodes.filter((n) => n.data?.layerRef === layer.entryId);
-  const nodeList = layerNodes.map((n) => {
-    const desc = n.data?.description ? ` \u2014 ${n.data.description}` : "";
-    const owner = n.data?.owner ? ` (${n.data.owner})` : "";
-    return `  - ${n.data?.icon ?? "\u25FB"} **${n.name}**${desc}${owner}`;
-  }).join("\n");
-  return `### ${layer.name}
-${layer.data?.description ?? ""}
-
-${nodeList || "  _No components_"}`;
+function parseImports(filePath) {
+  try {
+    const content = readFileSync2(filePath, "utf-8");
+    const re = /(?:^|\n)\s*import\s+(?:[\s\S]*?\s+from\s+)?['"]([^'"]+)['"]/g;
+    const imports = [];
+    let match;
+    while ((match = re.exec(content)) !== null) {
+      imports.push(match[1]);
+    }
+    return imports;
+  } catch {
+    return [];
+  }
 }
-var SEED_TEMPLATE = {
-  entryId: "ARCH-tpl-product-os",
-  name: "Product OS Default",
-  data: {
-    archType: "template",
-    description: "Default 4-layer architecture: Auth \u2192 Infrastructure \u2192 Core \u2192 Features, with an outward Integration layer",
-    layerOrder: JSON.stringify(["auth", "infrastructure", "core", "features", "integration"])
-  }
-};
-var SEED_LAYERS = [
-  { entryId: "ARCH-layer-auth", name: "Auth", order: 0, data: { archType: "layer", templateRef: "ARCH-tpl-product-os", color: "#22c55e", description: "Authentication, user management, and workspace-scoped access control", icon: "\u{1F510}", dependsOn: "none", rationale: "Foundation layer. Auth depends on nothing \u2014 it is the first gate. No layer may bypass auth. All other layers depend on auth to know who the user is and which workspace they belong to." } },
-  { entryId: "ARCH-layer-infra", name: "Infrastructure", order: 1, data: { archType: "layer", templateRef: "ARCH-tpl-product-os", color: "#ec4899", description: "Real-time data, event tracking, and AI model infrastructure", icon: "\u2699\uFE0F", dependsOn: "Auth", rationale: "Infrastructure sits on top of Auth. It provides the database, analytics, and AI plumbing that Core and Features consume. Infra may import from Auth (needs workspace context) but never from Core or Features." } },
-  { entryId: "ARCH-layer-core", name: "Core", order: 2, data: { archType: "layer", templateRef: "ARCH-tpl-product-os", color: "#8b5cf6", description: "Business logic, knowledge graph, workflow engines, and MCP tooling", icon: "\u{1F9E0}", dependsOn: "Auth, Infrastructure", rationale: "Core contains business logic and engines that are UI-agnostic. It may import from Auth and Infra. Features depend on Core, but Core must never depend on Features \u2014 this is what keeps engines reusable across different UIs." } },
-  { entryId: "ARCH-layer-features", name: "Features", order: 3, data: { archType: "layer", templateRef: "ARCH-tpl-product-os", color: "#6366f1", description: "User-facing pages, components, and feature modules", icon: "\u2726", dependsOn: "Auth, Infrastructure, Core", rationale: "Features are the user-facing layer \u2014 SvelteKit routes, components, and page-level logic. Features may import from any lower layer but nothing above may import from Features. This is the outermost application layer." } },
-  { entryId: "ARCH-layer-integration", name: "Integration", order: 4, data: { archType: "layer", templateRef: "ARCH-tpl-product-os", color: "#f59e0b", description: "Outward connections to external tools, IDEs, and services", icon: "\u{1F50C}", dependsOn: "Core", rationale: "Integration is a lateral/outward layer \u2014 it connects to external systems (IDE, GitHub, Linear). It depends on Core (to expose knowledge) but sits outside the main stack. External tools call into Core via Integration, never directly into Features." } }
-];
-var SEED_NODES = [
-  // Auth layer
-  { entryId: "ARCH-node-clerk", name: "Clerk", order: 0, data: { archType: "node", layerRef: "ARCH-layer-auth", color: "#22c55e", icon: "\u{1F511}", description: "Authentication provider \u2014 sign-in/sign-up pages, session management, organization-level access control. UserSync.svelte is cross-cutting layout glue (not mapped here).", filePaths: "src/routes/sign-in/, src/routes/sign-up/", owner: "Platform", rationale: "Auth layer because Clerk is the identity gate. Every request flows through auth first. No other layer provides identity." } },
-  { entryId: "ARCH-node-workspace", name: "Workspace Scoping", order: 1, data: { archType: "node", layerRef: "ARCH-layer-auth", color: "#22c55e", icon: "\u{1F3E2}", description: "Multi-tenancy anchor \u2014 all data is workspace-scoped via workspaceId", filePaths: "src/lib/stores/workspace.ts, convex/workspaces.ts", owner: "Platform", rationale: "Auth layer because workspace scoping is the second gate after identity. All queries require workspaceId, making this foundational." } },
-  // Infrastructure layer
-  { entryId: "ARCH-node-convex", name: "Convex", order: 0, data: { archType: "node", layerRef: "ARCH-layer-infra", color: "#ec4899", icon: "\u26A1", description: "Reactive database with real-time sync, serverless functions, and type-safe API generation. Unified Collections + Entries model", filePaths: "convex/schema.ts, convex/entries.ts, convex/http.ts", owner: "Platform", rationale: "Infrastructure because Convex is raw persistence and reactivity plumbing. It stores data but has no business logic opinions. Core and Features consume it." } },
-  { entryId: "ARCH-node-posthog", name: "PostHog", order: 1, data: { archType: "node", layerRef: "ARCH-layer-infra", color: "#ec4899", icon: "\u{1F4CA}", description: "Product analytics \u2014 workspace-scoped events, feature flags, session replay", filePaths: "src/lib/analytics.ts, src/lib/components/PostHogWorkspaceSync.svelte", owner: "Platform", rationale: "Infrastructure because PostHog is analytics plumbing \u2014 event collection and aggregation. It has no knowledge of business domains." } },
-  { entryId: "ARCH-node-openrouter", name: "OpenRouter", order: 2, data: { archType: "node", layerRef: "ARCH-layer-infra", color: "#ec4899", icon: "\u{1F916}", description: "AI model routing for ChainWork artifact generation \u2014 streaming responses with format-aware prompts", filePaths: "src/routes/api/chainwork/generate/+server.ts", owner: "ChainWork", rationale: "Infrastructure because OpenRouter is an AI model gateway \u2014 it routes prompts to models. The strategy logic lives in ChainWork Engine (Core); this is just the pipe." } },
-  // Core layer
-  { entryId: "ARCH-node-mcp", name: "MCP Server", order: 0, data: { archType: "node", layerRef: "ARCH-layer-core", color: "#8b5cf6", icon: "\u{1F527}", description: "~19 modular tools exposing the knowledge graph as AI-consumable operations \u2014 capture, context assembly, verification, quality checks", filePaths: "packages/mcp-server/src/index.ts, packages/mcp-server/src/tools/", owner: "AI DX", rationale: "Core layer because the MCP server encodes business operations \u2014 capture with auto-linking, quality scoring, governance rules. It depends on Infra (Convex) but never touches UI routes. Why not Infrastructure? Because it has domain opinions. Why not Features? Because it has no UI \u2014 any client (Cursor, CLI, API) can call it." } },
-  { entryId: "ARCH-node-knowledge-graph", name: "Knowledge Graph", order: 1, data: { archType: "node", layerRef: "ARCH-layer-core", color: "#8b5cf6", icon: "\u{1F578}\uFE0F", description: "20 collections, 170+ entries with typed cross-collection relations. Smart capture, auto-linking, quality scoring", filePaths: "convex/mcpKnowledge.ts, convex/entries.ts", owner: "Knowledge", rationale: "Core layer because the knowledge graph IS the domain model \u2014 collections, entries, relations, versioning, quality scoring. Glossary DATA, business rules DATA, tension DATA all live here. Why not Features? Because the data model exists independently of any page. The Glossary page in Features is just one way to visualize terms that Core owns. Think: Core owns the dictionary, Features owns the dictionary app." } },
-  { entryId: "ARCH-node-governance", name: "Governance Engine", order: 2, data: { archType: "node", layerRef: "ARCH-layer-core", color: "#8b5cf6", icon: "\u2696\uFE0F", description: "Circles, roles, consent-based decision-making, tension processing with IDM-inspired async workflows", filePaths: "convex/versioning.ts, src/lib/components/versioning/", owner: "Governance", rationale: "Core layer because governance logic (draft\u2192publish workflows, consent-based decisions, tension status rules) is business process that multiple UIs consume. Why not Features? Because the versioning system and proposal flow are reusable engines \u2014 the Governance Pages in Features are just one rendering of these rules." } },
-  { entryId: "ARCH-node-chainwork-engine", name: "ChainWork Engine", order: 3, data: { archType: "node", layerRef: "ARCH-layer-core", color: "#8b5cf6", icon: "\u26D3", description: "Guided strategy creation through 5-step coherence chain \u2014 AI-generated artifacts with scoring and achievements", filePaths: "src/lib/components/chainwork/config.ts, src/lib/components/chainwork/scoring.ts", owner: "ChainWork", rationale: "Core layer because the coherence chain logic, scoring algorithm, and quality gates are business rules. config.ts defines chain steps, scoring.ts computes quality \u2014 these could power a CLI or API. Why not Features? Because the ChainWork UI wizard in Features is just one skin over this engine." } },
-  // Features layer
-  { entryId: "ARCH-node-command-center", name: "Command Center", order: 0, data: { archType: "node", layerRef: "ARCH-layer-features", color: "#6366f1", icon: "\u2B21", description: "Calm home screen \u2014 daily orientation, triage mode, pulse metrics, momentum tracking", filePaths: "src/routes/+page.svelte, src/lib/components/command-center/", owner: "Command Center", rationale: "Features layer because the Command Center is a SvelteKit page \u2014 PulseMetrics, NeedsAttention, DailyBriefing are UI components that assemble data from Core queries. Why not Core? Because it has no reusable business logic or engines \u2014 it is pure layout and presentation. If you deleted this page, no business rule would break." } },
-  { entryId: "ARCH-node-chainwork-ui", name: "ChainWork UI", order: 1, data: { archType: "node", layerRef: "ARCH-layer-features", color: "#6366f1", icon: "\u26D3", description: "Multi-step wizard for strategy artifact creation \u2014 setup, chain steps, quality gates, output", filePaths: "src/routes/chainwork/, src/lib/components/chainwork/", owner: "ChainWork", rationale: "Features layer because the ChainWork UI is the wizard interface \u2014 step navigation, form inputs, output rendering. Why not Core? Because the scoring logic and chain config ARE in Core (ChainWork Engine). This is the presentation skin over that engine. Delete this page and the engine still works via MCP." } },
-  { entryId: "ARCH-node-glossary", name: "Glossary", order: 2, data: { archType: "node", layerRef: "ARCH-layer-features", color: "#6366f1", icon: "Aa", description: "Canonical vocabulary management \u2014 term detail, code drift detection, inline term linking", filePaths: "src/routes/glossary/, src/lib/components/glossary/", owner: "Knowledge", rationale: "Features layer \u2014 NOT Core or Infrastructure \u2014 because this is the Glossary PAGE: the SvelteKit route for browsing, editing, and viewing terms. Why not Core? Because Core owns the glossary DATA (Knowledge Graph) and term-linking logic. The MCP server also accesses glossary terms without any page. Why not Infrastructure? Because glossary is domain-specific vocabulary, not generic plumbing. The page is one consumer of the data \u2014 Core owns the dictionary, Features owns the dictionary app." } },
-  { entryId: "ARCH-node-tensions", name: "Tensions", order: 3, data: { archType: "node", layerRef: "ARCH-layer-features", color: "#6366f1", icon: "\u26A1", description: "Tension capture and processing \u2014 raise, triage, resolve through governance workflow", filePaths: "src/routes/tensions/, src/lib/components/tensions/", owner: "Governance", rationale: "Features layer because this is the Tensions PAGE \u2014 the UI for raising, listing, and viewing tensions. Why not Core? Because tension data, status rules (SOS-020), and processing logic already live in Core (Governance Engine). This page is a form + list view that reads from and writes to Core. Delete it and the governance engine still processes tensions via MCP." } },
-  { entryId: "ARCH-node-strategy", name: "Strategy", order: 4, data: { archType: "node", layerRef: "ARCH-layer-features", color: "#6366f1", icon: "\u25A3", description: "Product strategy pages \u2014 vision, ecosystem, product areas, decision frameworks, sequencing", filePaths: "src/routes/strategy/, src/routes/bridge/, src/routes/topology/", owner: "Strategy", rationale: "Features layer because Strategy is a set of SvelteKit pages (strategy, bridge, topology) that visualize strategy entries. Why not Core? Because the strategy data (vision, principles, ecosystem layers) lives in the Knowledge Graph (Core). These pages render and allow inline editing \u2014 they consume Core downward." } },
-  { entryId: "ARCH-node-governance-ui", name: "Governance Pages", order: 5, data: { archType: "node", layerRef: "ARCH-layer-features", color: "#6366f1", icon: "\u25C8", description: "Roles, circles, principles, policies, decisions, proposals, business rules", filePaths: "src/routes/roles/, src/routes/circles/, src/routes/decisions/, src/routes/proposals/", owner: "Governance", rationale: "Features layer because these are governance PAGES \u2014 list views and detail views for roles, circles, decisions, proposals. Why not Core? Because the governance ENGINE (versioning, consent, IDM) IS in Core. These pages are the user-facing window into governance data. The logic doesn't live here, only the rendering." } },
-  { entryId: "ARCH-node-artifacts", name: "Artifacts", order: 6, data: { archType: "node", layerRef: "ARCH-layer-features", color: "#6366f1", icon: "\u{1F4C4}", description: "Strategy artifacts from ChainWork \u2014 pitches, briefs, one-pagers linked to the knowledge graph", filePaths: "src/routes/artifacts/", owner: "ChainWork", rationale: "Features layer because the Artifacts page is a list/detail view for strategy artifacts produced by ChainWork. Why not Core? Because artifact data and scoring live in Core (ChainWork Engine). This page just renders the output and links back to the knowledge graph." } },
-  // Integration layer
-  { entryId: "ARCH-node-cursor", name: "Cursor IDE", order: 0, data: { archType: "node", layerRef: "ARCH-layer-integration", color: "#f59e0b", icon: "\u{1F5A5}\uFE0F", description: "AI-assisted development with MCP-powered knowledge context \u2014 smart capture, verification, context assembly in the editor", filePaths: ".cursor/mcp.json, .cursor/rules/", owner: "AI DX", rationale: "Integration layer because Cursor is an external tool that connects INTO our system via MCP. Why not Core or Features? Because Cursor itself is not our code \u2014 it's a consumer. The .cursor/ config files define how it talks to us, but Cursor lives outside our deployment boundary." } },
-  { entryId: "ARCH-node-github", name: "GitHub", order: 1, data: { archType: "node", layerRef: "ARCH-layer-integration", color: "#f59e0b", icon: "\u{1F419}", description: "Code repository, PR reviews with governance context, CI/CD", owner: "Platform", rationale: "Integration layer because GitHub is an external service. Why not Infrastructure? Because Infra is about plumbing we control (database, analytics). GitHub is a third-party that hooks into our Core (PR reviews checking governance rules) but is not part of our deployed application." } },
-  { entryId: "ARCH-node-linear", name: "Linear (planned)", order: 2, data: { archType: "node", layerRef: "ARCH-layer-integration", color: "#f59e0b", icon: "\u{1F4D0}", description: "Issue tracking, roadmap sync, tension-to-issue pipeline (planned integration)", owner: "Platform", rationale: "Integration layer because Linear is an external issue tracker. Why not Infrastructure? Because Infra is generic plumbing we run. Linear is a third-party tool we connect to. The planned pipeline bridges tensions (Core) to Linear issues \u2014 a classic outward integration pattern." } }
-];
-var SEED_FLOWS = [
-  { entryId: "ARCH-flow-smart-capture", name: "Capture Flow", order: 0, data: { archType: "flow", sourceNode: "ARCH-node-cursor", targetNode: "ARCH-node-knowledge-graph", description: "Developer/AI calls capture via MCP \u2192 entry created with auto-linking and quality score \u2192 stored in Knowledge Graph", color: "#8b5cf6" } },
-  { entryId: "ARCH-flow-governance", name: "Governance Flow", order: 1, data: { archType: "flow", sourceNode: "ARCH-node-tensions", targetNode: "ARCH-node-governance", description: "Tension raised \u2192 appears in Command Center \u2192 triaged \u2192 processed via IDM \u2192 decision logged", color: "#6366f1" } },
-  { entryId: "ARCH-flow-chainwork", name: "ChainWork Strategy Flow", order: 2, data: { archType: "flow", sourceNode: "ARCH-node-chainwork-ui", targetNode: "ARCH-node-artifacts", description: "Leader opens ChainWork \u2192 walks coherence chain \u2192 AI generates artifact \u2192 scored and published to knowledge graph", color: "#f59e0b" } },
-  { entryId: "ARCH-flow-knowledge-trust", name: "Knowledge Trust Flow", order: 3, data: { archType: "flow", sourceNode: "ARCH-node-mcp", targetNode: "ARCH-node-glossary", description: "MCP verify tool checks entries against codebase \u2192 file existence, schema references validated \u2192 trust scores updated", color: "#22c55e" } },
-  { entryId: "ARCH-flow-analytics", name: "Analytics Flow", order: 4, data: { archType: "flow", sourceNode: "ARCH-node-command-center", targetNode: "ARCH-node-posthog", description: "Feature views and actions tracked \u2192 workspace-scoped events \u2192 PostHog group analytics \u2192 Command Center metrics", color: "#ec4899" } }
-];
-var architectureSchema = z19.object({
-  action: z19.enum(["show", "explore", "flow"]).describe("Action: show full map, explore a layer, or visualize a flow"),
-  template: z19.string().optional().describe("Template entry ID to filter by (for show)"),
-  layer: z19.string().optional().describe("Layer name or entry ID (for explore), e.g. 'Core' or 'ARCH-layer-core'"),
-  flow: z19.string().optional().describe("Flow name or entry ID (for flow), e.g. 'Smart Capture Flow'")
-});
-var architectureAdminSchema = z19.object({
-  action: z19.enum(["seed", "check"]).describe("Action: seed default architecture data, or check dependency health")
-});
-function registerArchitectureTools(server) {
-  server.registerTool(
-    "architecture",
-    {
-      title: "Architecture",
-      description: "Explore the system architecture \u2014 show the full map, explore a specific layer, or visualize a data flow.\n\nActions:\n- `show`: Render the layered architecture map (Auth \u2192 Infra \u2192 Core \u2192 Features \u2192 Integration)\n- `explore`: Drill into a layer to see nodes, ownership, file paths\n- `flow`: Visualize a data flow path between nodes",
-      inputSchema: architectureSchema,
-      annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false }
-    },
-    withEnvelope(async ({ action, template, layer, flow }) => {
-      await ensureCollection();
-      const all = await listArchEntries();
-      if (action === "show") {
-        const templates = byTag(all, "template");
-        const activeTemplate = template ? templates.find((t) => t.entryId === template) : templates[0];
-        const templateName = activeTemplate?.name ?? "System Architecture";
-        const templateId = activeTemplate?.entryId;
-        const layers = byTag(all, "layer").filter((l) => !templateId || l.data?.templateRef === templateId);
-        const nodes = byTag(all, "node");
-        const flows = byTag(all, "flow");
-        if (layers.length === 0) {
-          return {
-            content: [{
-              type: "text",
-              text: "# Architecture Explorer\n\nNo architecture data found. Use `architecture-admin action=seed` to populate the default architecture."
-            }],
-            structuredContent: failure(
-              "NOT_FOUND",
-              "No architecture data found.",
-              "Seed the default architecture first.",
-              [{ tool: "architecture-admin", description: "Seed architecture", parameters: { action: "seed" } }]
-            )
-          };
-        }
-        const textLayers = layers.map((l) => formatLayerText(l, nodes)).join("\n\n");
-        const textFlows = flows.length > 0 ? "\n\n---\n\n## Data Flows\n\n" + flows.map(
-          (f) => `- **${f.name}**: ${f.data?.description ?? ""}`
-        ).join("\n") : "";
-        const text = `# ${templateName}
-
-${textLayers}${textFlows}`;
-        const html = renderArchitectureHtml(layers, nodes, flows, templateName);
-        return {
-          content: [
-            { type: "text", text },
-            { type: "resource", resource: { uri: `ui://product-os/architecture`, mimeType: UI_RESOURCE_MIME_TYPE, text: html } }
-          ],
-          structuredContent: success(
-            `Showing ${templateName}: ${layers.length} layers, ${nodes.length} nodes, ${flows.length} flows.`,
-            { templateName, layerCount: layers.length, nodeCount: nodes.length, flowCount: flows.length }
-          )
-        };
-      }
-      if (action === "explore") {
-        if (!layer) {
-          return validationResult("A `layer` is required for explore.");
-        }
-        const layers = byTag(all, "layer");
-        const target = layers.find(
-          (l) => l.name.toLowerCase() === layer.toLowerCase() || l.entryId === layer
-        );
-        if (!target) {
-          const available = layers.map((l) => `\`${l.name}\``).join(", ");
-          return {
-            content: [{ type: "text", text: `Layer "${layer}" not found. Available layers: ${available}` }],
-            structuredContent: failure(
-              "NOT_FOUND",
-              `Layer "${layer}" not found.`,
-              `Available layers: ${available}`
-            )
-          };
-        }
-        const nodes = byTag(all, "node").filter((n) => n.data?.layerRef === target.entryId);
-        const flows = byTag(all, "flow").filter(
-          (f) => nodes.some((n) => n.entryId === f.data?.sourceNode || n.entryId === f.data?.targetNode)
-        );
-        const depRule = target.data?.dependsOn ? `
-**Dependency rule:** May import from ${target.data.dependsOn === "none" ? "nothing (foundation layer)" : target.data.dependsOn}.
-` : "";
-        const layerRationale = target.data?.rationale ? `
-> ${target.data.rationale}
-` : "";
-        const nodeDetail = nodes.map((n) => {
-          const lines = [`#### ${n.data?.icon ?? "\u25FB"} ${n.name}`];
-          if (n.data?.description) lines.push(String(n.data.description));
-          if (n.data?.owner) lines.push(`**Owner:** ${n.data.owner}`);
-          if (n.data?.filePaths) lines.push(`**Files:** \`${n.data.filePaths}\``);
-          if (n.data?.rationale) lines.push(`
-**Why here?** ${n.data.rationale}`);
-          return lines.join("\n");
-        }).join("\n\n");
-        const flowLines = flows.length > 0 ? "\n\n### Connected Flows\n\n" + flows.map((f) => `- ${f.name}: ${f.data?.description ?? ""}`).join("\n") : "";
-        return {
-          content: [{
-            type: "text",
-            text: `# ${target.data?.icon ?? ""} ${target.name} Layer
-
-${target.data?.description ?? ""}${depRule}${layerRationale}
-**${nodes.length} components**
-
-${nodeDetail}${flowLines}`
-          }],
-          structuredContent: success(
-            `${target.name} layer: ${nodes.length} components, ${flows.length} connected flows.`,
-            { layerName: target.name, entryId: target.entryId, nodeCount: nodes.length, flowCount: flows.length }
-          )
-        };
-      }
-      if (action === "flow") {
-        if (!flow) {
-          return validationResult("A `flow` name or entry ID is required.");
-        }
-        const flows = byTag(all, "flow");
-        const target = flows.find(
-          (f) => f.name.toLowerCase() === flow.toLowerCase() || f.entryId === flow
-        );
-        if (!target) {
-          const available = flows.map((f) => `\`${f.name}\``).join(", ");
-          return {
-            content: [{ type: "text", text: `Flow "${flow}" not found. Available flows: ${available}` }],
-            structuredContent: failure(
-              "NOT_FOUND",
-              `Flow "${flow}" not found.`,
-              `Available flows: ${available}`
-            )
-          };
-        }
-        const nodes = byTag(all, "node");
-        const source = nodes.find((n) => n.entryId === target.data?.sourceNode);
-        const dest = nodes.find((n) => n.entryId === target.data?.targetNode);
-        const lines = [
-          `# ${target.name}`,
-          "",
-          `**${source?.data?.icon ?? "?"} ${source?.name ?? "Unknown"}** \u2192 **${dest?.data?.icon ?? "?"} ${dest?.name ?? "Unknown"}**`,
-          "",
-          String(target.data?.description ?? "")
-        ];
-        if (source) {
-          lines.push("", `### Source: ${source.name}`, String(source.data?.description ?? ""));
-          if (source.data?.filePaths) lines.push(`Files: \`${source.data.filePaths}\``);
-        }
-        if (dest) {
-          lines.push("", `### Target: ${dest.name}`, String(dest.data?.description ?? ""));
-          if (dest.data?.filePaths) lines.push(`Files: \`${dest.data.filePaths}\``);
-        }
-        return {
-          content: [{ type: "text", text: lines.join("\n") }],
-          structuredContent: success(
-            `${target.name}: ${source?.name ?? "?"} \u2192 ${dest?.name ?? "?"}.`,
-            { flowName: target.name, entryId: target.entryId, source: source?.name, target: dest?.name }
-          )
-        };
-      }
-      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 }
-    },
-    withEnvelope(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 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 };
-              await mcpMutation("chain.updateEntry", { entryId: seed.entryId, data: mergedData });
-              updated++;
-            } else {
-              unchanged++;
-            }
-            continue;
-          }
-          await mcpMutation("chain.createEntry", {
-            collectionSlug: COLLECTION_SLUG,
-            entryId: seed.entryId,
-            name: seed.name,
-            status: seed.status,
-            data: seed.data,
-            order: seed.order ?? 0
-          });
-          created++;
-        }
-        return {
-          content: [{
-            type: "text",
-            text: `# Architecture Seeded
-
-**Created:** ${created} entries
-**Updated:** ${updated} (merged new fields)
-**Unchanged:** ${unchanged}
-
-Use \`architecture action=show\` to view the map.`
-          }],
-          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 = resolveProjectRoot2();
-        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 resolveProjectRoot2() {
-  const candidates = [
-    process.env.WORKSPACE_PATH,
-    process.cwd(),
-    resolve3(process.cwd(), "..")
-  ].filter(Boolean);
-  for (const dir of candidates) {
-    const resolved = resolve3(dir);
-    if (existsSync3(resolve3(resolved, "convex/schema.ts"))) return resolved;
-  }
-  return null;
-}
-function scanDependencies(projectRoot, layers, nodes) {
-  const layerMap = /* @__PURE__ */ new Map();
-  for (const l of layers) layerMap.set(l.entryId, l);
-  const allowedDeps = buildAllowedDeps(layers);
-  const nodePathPrefixes = buildNodePrefixes(nodes);
-  const violations = [];
-  const nodeResults = /* @__PURE__ */ new Map();
-  let totalFiles = 0;
-  let totalImports = 0;
-  let unmapped = 0;
-  for (const node of nodes) {
-    const layerRef = String(node.data?.layerRef ?? "");
-    const layer = layerMap.get(layerRef);
-    if (!layer) continue;
-    const filePaths = parseFilePaths(node);
-    const nodeViolations = [];
-    let nodeFileCount = 0;
-    for (const fp of filePaths) {
-      const absPath = resolve3(projectRoot, fp);
-      const files = collectFiles(absPath);
-      for (const file of files) {
-        nodeFileCount++;
-        totalFiles++;
-        const relFile = relative(projectRoot, file);
-        const imports = parseImports(file);
-        for (const imp of imports) {
-          totalImports++;
-          const resolved = resolveImport(imp, file, projectRoot);
-          if (!resolved) {
-            unmapped++;
-            continue;
-          }
-          const targetNode = findNodeByPath(resolved, nodePathPrefixes);
-          if (!targetNode) {
-            unmapped++;
-            continue;
-          }
-          const targetLayerRef = String(targetNode.data?.layerRef ?? "");
-          const targetLayer = layerMap.get(targetLayerRef);
-          if (!targetLayer) continue;
-          if (targetLayerRef === layerRef) continue;
-          const allowed = allowedDeps.get(layerRef);
-          if (allowed && !allowed.has(targetLayerRef)) {
-            const v = {
-              sourceNode: node.name,
-              sourceLayer: layer.name,
-              sourceFile: relFile,
-              importPath: imp,
-              targetNode: targetNode.name,
-              targetLayer: targetLayer.name,
-              rule: `${layer.name} cannot import from ${targetLayer.name}`
-            };
-            violations.push(v);
-            nodeViolations.push(v);
-          }
-        }
-      }
-    }
-    nodeResults.set(node.entryId, { violations: nodeViolations, filesScanned: nodeFileCount });
-  }
-  return { violations, filesScanned: totalFiles, importsChecked: totalImports, unmappedImports: unmapped, nodeResults };
-}
-function buildAllowedDeps(layers) {
-  const nameToId = /* @__PURE__ */ new Map();
-  for (const l of layers) nameToId.set(l.name.toLowerCase(), l.entryId);
-  const allowed = /* @__PURE__ */ new Map();
-  for (const layer of layers) {
-    const deps = String(layer.data?.dependsOn ?? "none");
-    const set = /* @__PURE__ */ new Set();
-    if (deps !== "none") {
-      for (const dep of deps.split(",").map((d) => d.trim().toLowerCase())) {
-        const id = nameToId.get(dep);
-        if (id) set.add(id);
-      }
-    }
-    allowed.set(layer.entryId, set);
-  }
-  return allowed;
-}
-function buildNodePrefixes(nodes) {
-  const entries = [];
-  for (const node of nodes) {
-    for (const fp of parseFilePaths(node)) {
-      entries.push({ prefix: normalize(fp), node });
-    }
-  }
-  entries.sort((a, b) => b.prefix.length - a.prefix.length);
-  return entries;
-}
-function parseFilePaths(node) {
-  const raw = node.data?.filePaths;
-  if (!raw || typeof raw !== "string") return [];
-  return raw.split(",").map((p) => p.trim()).filter(Boolean);
-}
-function collectFiles(absPath) {
-  if (!existsSync3(absPath)) return [];
-  const stat = statSync(absPath);
-  if (stat.isFile()) {
-    return isScannableFile(absPath) ? [absPath] : [];
-  }
-  if (!stat.isDirectory()) return [];
-  const results = [];
-  const walk = (dir) => {
-    for (const entry of readdirSync(dir, { withFileTypes: true })) {
-      if (entry.name.startsWith(".") || entry.name === "node_modules") continue;
-      const full = resolve3(dir, entry.name);
-      if (entry.isDirectory()) walk(full);
-      else if (isScannableFile(full)) results.push(full);
-    }
-  };
-  walk(absPath);
-  return results;
-}
-function isScannableFile(p) {
-  return /\.(ts|js|svelte)$/.test(p) && !p.endsWith(".d.ts");
-}
-function parseImports(filePath) {
-  try {
-    const content = readFileSync2(filePath, "utf-8");
-    const re = /(?:^|\n)\s*import\s+(?:[\s\S]*?\s+from\s+)?['"]([^'"]+)['"]/g;
-    const imports = [];
-    let match;
-    while ((match = re.exec(content)) !== null) {
-      imports.push(match[1]);
-    }
-    return imports;
-  } catch {
-    return [];
-  }
-}
-var EXTENSIONS = [".ts", ".js", ".svelte", "/index.ts", "/index.js", "/index.svelte"];
-function tryResolveWithExtension(absPath) {
-  if (existsSync3(absPath) && statSync(absPath).isFile()) return absPath;
-  for (const ext of EXTENSIONS) {
-    const withExt = absPath + ext;
-    if (existsSync3(withExt)) return withExt;
+var EXTENSIONS = [".ts", ".js", ".svelte", "/index.ts", "/index.js", "/index.svelte"];
+function tryResolveWithExtension(absPath) {
+  if (existsSync2(absPath) && statSync(absPath).isFile()) return absPath;
+  for (const ext of EXTENSIONS) {
+    const withExt = absPath + ext;
+    if (existsSync2(withExt)) return withExt;
   }
   return null;
 }
@@ -9693,12 +9202,12 @@ function resolveImport(imp, fromFile, root) {
   else if (imp.startsWith("$convex/")) rel = imp.replace("$convex/", "convex/");
   else if (imp.startsWith("$env/") || imp.startsWith("$app/")) return null;
   else if (imp.startsWith("./") || imp.startsWith("../")) {
-    const fromDir = dirname2(fromFile);
-    const abs2 = resolve3(fromDir, imp);
+    const fromDir = dirname(fromFile);
+    const abs2 = resolve2(fromDir, imp);
     rel = relative(root, abs2);
   }
   if (!rel) return null;
-  const abs = resolve3(root, rel);
+  const abs = resolve2(root, rel);
   const actual = tryResolveWithExtension(abs);
   return actual ? relative(root, actual) : rel;
 }
@@ -10349,376 +9858,819 @@ function registerHealthTools(server) {
           }
         }
         return {
-          content: [{ type: "text", text: scanLines.join("\n") }],
+          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, redirectHint: "Use the `start` tool for the full guided setup experience." },
+            [{ tool: "start", description: "Guided workspace setup", parameters: {} }]
+          )
+        };
+      }
+      const lines = [];
+      const isLowReadiness = readiness && readiness.score < 50;
+      if (wsCtx) {
+        lines.push(`# ${wsCtx.workspaceName}`);
+        lines.push(`_Workspace \`${wsCtx.workspaceSlug}\` \u2014 Product Brain is healthy._`);
+      } else {
+        lines.push("# Workspace");
+        lines.push("_Could not resolve workspace._");
+      }
+      lines.push("");
+      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 (sc.vision) lines.push(`Vision: ${sc.vision}`);
+          if (sc.purpose) lines.push(`Purpose: ${sc.purpose}`);
+          if (sc.productAreaCount != null && sc.productAreaCount > 0) {
+            lines.push(`Product areas (${sc.productAreaCount}): ${(sc.productAreas ?? []).join(", ")}`);
+          }
+          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 (orientEntries?.activeBets?.length > 0) {
+          for (const e of orientEntries.activeBets) {
+            const tensions = e.linkedTensions;
+            const tensionPart = tensions?.length ? ` \u2014 ${tensions.map((t) => `${t.entryId ?? t.name} (${t.severity ?? "\u2014"})`).join(", ")}` : "";
+            lines.push(`- \`${e.entryId ?? e._id}\` ${e.name}${tensionPart}`);
+          }
+        }
+        if (recoveryBlock) {
+          lines.push("");
+          lines.push(...formatRecoveryBlock(recoveryBlock));
+        } else if (priorSessions.length > 0) {
+          const last = priorSessions[0];
+          const date = new Date(last.startedAt).toISOString().split("T")[0];
+          const created = Array.isArray(last.entriesCreated) ? last.entriesCreated.length : last.entriesCreated ?? 0;
+          const modified = Array.isArray(last.entriesModified) ? last.entriesModified.length : last.entriesModified ?? 0;
+          lines.push(`Last session (${date}): ${created} created, ${modified} modified`);
+        }
+        if (orientEntries) {
+          const mapGovernanceEntry = (e) => ({
+            entryId: e.entryId,
+            name: e.name,
+            description: typeof e.preview === "string" ? e.preview : void 0
+          });
+          lines.push("");
+          lines.push(...buildOperatingProtocol({
+            principles: (orientEntries.principles ?? []).map(mapGovernanceEntry),
+            standards: (orientEntries.standards ?? []).map(mapGovernanceEntry),
+            businessRules: (orientEntries.businessRules ?? []).map(mapGovernanceEntry)
+          }, task));
+        }
+        if (agentSessionId) {
+          try {
+            await mcpCall("agent.markOriented", { sessionId: agentSessionId });
+            setSessionOriented(true);
+          } catch {
+          }
+          lines.push("---");
+          lines.push(`Orientation complete. Session ${agentSessionId}.`);
+        } else {
+          lines.push("---");
+          lines.push("_No active agent session. Call `session action=start` to begin._");
+        }
+        if (errors.length > 0) {
+          lines.push("");
+          for (const err of errors) lines.push(`- ${err}`);
+        }
+        return {
+          content: [{ type: "text", text: lines.join("\n") }],
           structuredContent: success(
-            "Workspace is blank. Use the start tool for guided setup.",
-            { stage: "blank", readinessScore: readiness?.score ?? 0, oriented, orientationStatus, redirectHint: "Use the `start` tool for the full guided setup experience." },
-            [{ tool: "start", description: "Guided workspace setup", parameters: {} }]
+            `Oriented (brief). Stage: ${readiness?.stage ?? "unknown"}.`,
+            { mode: "brief", stage: readiness?.stage ?? "unknown", oriented: isSessionOriented(), sessionId: agentSessionId }
           )
         };
       }
-      const lines = [];
-      const isLowReadiness = readiness && readiness.score < 50;
-      if (wsCtx) {
-        lines.push(`# ${wsCtx.workspaceName}`);
-        lines.push(`_Workspace \`${wsCtx.workspaceSlug}\` \u2014 Product Brain is healthy._`);
-      } else {
-        lines.push("# Workspace");
-        lines.push("_Could not resolve workspace._");
+      const orientStage = readiness?.stage ?? "seeded";
+      if (isLowReadiness && wsCtx?.createdAt) {
+        const ageDays = Math.floor((Date.now() - wsCtx.createdAt) / (1e3 * 60 * 60 * 24));
+        if (ageDays >= 30) {
+          lines.push(`Your workspace has been around for ${ageDays} days and is still at the **${orientStage}** stage.`);
+          lines.push("Let's close the gaps \u2014 or if the current structure doesn't fit, we can reshape it.");
+          lines.push("");
+        }
       }
-      lines.push("");
-      if (mode === "brief") {
-        const briefStage = readiness?.stage ?? (readiness?.score != null ? readiness.score < 50 ? "seeded" : "grounded" : "unknown");
-        lines.push(`Brain stage: ${briefStage}`);
+      if (isLowReadiness) {
+        lines.push(`**Brain stage: ${orientStage}.**`);
+        lines.push("");
+        const gaps = readiness.gaps ?? [];
+        if (gaps.length > 0) {
+          const gap = gaps[0];
+          const cta = gap.capabilityGuidance ?? gap.guidance ?? `Tell me about your ${gap.label.toLowerCase()} and I'll capture it.`;
+          lines.push("## Recommended next step");
+          lines.push(`**${gap.label}**`);
+          lines.push("");
+          lines.push(cta);
+          lines.push("");
+          lines.push('_Everything stays as a draft until you confirm. Say "commit" or "looks good" to promote to the Chain._');
+          lines.push("");
+          const remainingGaps = gaps.length - 1;
+          if (remainingGaps > 0 || openTensions.length > 0) {
+            lines.push(`_${remainingGaps > 0 ? `${remainingGaps} more gap${remainingGaps === 1 ? "" : "s"}` : ""}${remainingGaps > 0 && openTensions.length > 0 ? " and " : ""}${openTensions.length > 0 ? `${openTensions.length} open tension${openTensions.length === 1 ? "" : "s"}` : ""} \u2014 ask "show full status" for details._`);
+            lines.push("");
+          }
+        }
+        lines.push("_Need a collection that doesn't exist yet (e.g. audiences, personas, metrics)?_");
+        lines.push("_Use `collections action=create` to add it, or ask me to propose collections for your domain._");
+        lines.push("");
+      } else if (readiness) {
+        lines.push(`**Brain stage: ${orientStage}.**`);
+        lines.push("");
         if (orientEntries?.strategicContext) {
           const sc = orientEntries.strategicContext;
-          if (sc.vision) lines.push(`Vision: ${sc.vision}`);
-          if (sc.purpose) lines.push(`Purpose: ${sc.purpose}`);
+          lines.push("## Strategic Context");
+          if (sc.vision) lines.push(`**Vision:** ${sc.vision}`);
+          if (sc.purpose) lines.push(`**Purpose:** ${sc.purpose}`);
           if (sc.productAreaCount != null && sc.productAreaCount > 0) {
-            lines.push(`Product areas (${sc.productAreaCount}): ${(sc.productAreas ?? []).join(", ")}`);
+            lines.push(`**Product areas (${sc.productAreaCount}):** ${(sc.productAreas ?? []).join(", ")}`);
           }
-          lines.push(`${sc.activeBetCount} active bet(s), ${sc.activeTensionCount} tension(s).`);
+          const betLine = sc.currentBet ? `**Current bet:** ${sc.currentBet}. ${sc.activeBetCount} active bet(s).` : "No active bets.";
+          lines.push(`${betLine} ${sc.activeTensionCount} open tension(s).`);
+          lines.push("");
+        }
+        if (orientEntries?.continuingFrom && orientEntries.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) {
+            const id = e.entryId ?? e.name;
+            const type = e.canonicalKey ?? "generic";
+            const coll = e.collectionSlug ? ` [${e.collectionSlug}]` : "";
+            lines.push(`- \`${id}\` (score ${e.score}) [${type}]${coll} \u2014 ${e.name}`);
+            if (e.reasoning) lines.push(`  _${e.reasoning}_`);
+          }
+          lines.push("");
+        }
+        if (orientEntries?.lastSessionTouched && orientEntries.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) {
+            const id = e.entryId ?? e.name;
+            const type = e.canonicalKey ?? "generic";
+            const coll = e.collectionSlug ? ` [${e.collectionSlug}]` : "";
+            lines.push(`- \`${id}\` [${type}]${coll} \u2014 ${e.name}`);
+          }
+          lines.push("");
         }
         if (orientEntries?.taskContext && orientEntries.taskContext.context.length > 0) {
-          lines.push(`Task context: ${orientEntries.taskContext.totalFound} relevant entries (${orientEntries.taskContext.confidence} confidence).`);
+          const tc = orientEntries.taskContext;
+          lines.push("## Task Context");
+          lines.push(`_Task-scoped entries (${tc.confidence} confidence, ${tc.totalFound} relevant)`);
+          lines.push("");
+          for (const e of tc.context) {
+            const id = e.entryId ?? e.name;
+            const coll = e.collectionSlug ? ` [${e.collectionSlug}]` : "";
+            lines.push(`- \`${id}\` (score ${e.score})${coll}${e.name !== id ? ` \u2014 ${e.name}` : ""}`);
+          }
+          lines.push("");
         }
-        if (orientEntries?.activeBets?.length > 0) {
-          for (const e of orientEntries.activeBets) {
-            const tensions = e.linkedTensions;
-            const tensionPart = tensions?.length ? ` \u2014 ${tensions.map((t) => `${t.entryId ?? t.name} (${t.severity ?? "\u2014"})`).join(", ")}` : "";
-            lines.push(`- \`${e.entryId ?? e._id}\` ${e.name}${tensionPart}`);
+        if (task && orientEntries) {
+          const result = runAlignmentCheck(
+            task,
+            orientEntries.activeBets ?? [],
+            orientEntries.taskContext?.context
+          );
+          lines.push(...buildAlignmentCheckLines(result));
+        }
+        if (orientEntries) {
+          const fmt = (e) => {
+            const type = e.canonicalKey ?? "generic";
+            const stratum = e.stratum ?? "?";
+            return `- \`${e.entryId ?? e._id}\` [${type} \xB7 ${stratum}] ${e.name}`;
+          };
+          if (orientEntries.activeBets?.length > 0) {
+            lines.push("## Active bets \u2014 current scope");
+            lines.push("_These define what you're building now. Work outside these bets requires explicit user confirmation before designing._");
+            lines.push("");
+            for (const e of orientEntries.activeBets) {
+              lines.push(fmt(e));
+              const tensions = e.linkedTensions;
+              if (tensions?.length) {
+                const tensionLines = tensions.map((t) => {
+                  const meta = [t.severity, t.priority].filter(Boolean).join(", ");
+                  return `\`${t.entryId ?? t.name}\` (${t.name}${meta ? `, ${meta}` : ""})`;
+                });
+                lines.push(`  Tensions: ${tensionLines.join("; ")}`);
+              } else {
+                lines.push(`  Tensions: No linked tensions`);
+              }
+            }
+            lines.push("");
+          }
+          if (orientEntries.activeGoals.length > 0) {
+            lines.push("## Active goals");
+            orientEntries.activeGoals.forEach((e) => lines.push(fmt(e)));
+            lines.push("");
+          }
+          if (orientEntries.recentDecisions.length > 0) {
+            lines.push("## Recent decisions");
+            orientEntries.recentDecisions.forEach((e) => lines.push(fmt(e)));
+            lines.push("");
+          }
+          if (orientEntries.recentlySuperseded.length > 0) {
+            lines.push("## Recently superseded");
+            orientEntries.recentlySuperseded.forEach((e) => lines.push(fmt(e)));
+            lines.push("");
+          }
+          if (orientEntries.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("");
+          }
+          const hasPrinciples = orientEntries.principles?.length > 0;
+          const hasStandards = orientEntries.standards?.length > 0;
+          const hasBusinessRules = orientEntries.businessRules.length > 0;
+          if (hasPrinciples || hasStandards || hasBusinessRules) {
+            lines.push("## Workspace Governance \u2014 constraints");
+            lines.push("_These constrain what you build. If your proposal conflicts with any of these, stop and flag it. Do not design around them without explicit user confirmation._");
+            lines.push("");
+            if (hasPrinciples) {
+              lines.push("**Principles** \u2014 beliefs that guide decisions:");
+              orientEntries.principles.forEach((e) => lines.push(fmt(e)));
+              lines.push("");
+            }
+            if (hasStandards) {
+              lines.push("**Standards** \u2014 conventions for how work is done:");
+              orientEntries.standards.forEach((e) => lines.push(fmt(e)));
+              lines.push("");
+            }
+            if (hasBusinessRules) {
+              lines.push("**Business Rules** \u2014 system constraints:");
+              orientEntries.businessRules.forEach((e) => lines.push(fmt(e)));
+              lines.push("");
+            }
+          }
+          if (orientEntries.architectureNotes.length > 0) {
+            lines.push("## Architecture notes");
+            orientEntries.architectureNotes.forEach((e) => lines.push(fmt(e)));
+            lines.push("");
+          }
+          const mapGovernanceEntry = (e) => ({
+            entryId: e.entryId,
+            name: e.name,
+            description: typeof e.preview === "string" ? e.preview : void 0
+          });
+          lines.push(...buildOperatingProtocol({
+            principles: (orientEntries.principles ?? []).map(mapGovernanceEntry),
+            standards: (orientEntries.standards ?? []).map(mapGovernanceEntry),
+            businessRules: (orientEntries.businessRules ?? []).map(mapGovernanceEntry)
+          }, task));
+        }
+        let allEntries = [];
+        try {
+          allEntries = await mcpQuery("chain.listEntries", {}) ?? [];
+        } catch {
+        }
+        const plannedWork = buildPlannedWork(allEntries);
+        if (hasPlannedWork(plannedWork)) {
+          lines.push(...buildPlannedWorkSection(plannedWork, priorSessions, recoveryBlock));
+        } else {
+          const briefingItems = [];
+          if (priorSessions.length > 0 && !recoveryBlock) {
+            const last = priorSessions[0];
+            const date = new Date(last.startedAt).toISOString().split("T")[0];
+            const created = Array.isArray(last.entriesCreated) ? last.entriesCreated.length : last.entriesCreated ?? 0;
+            const modified = Array.isArray(last.entriesModified) ? last.entriesModified.length : last.entriesModified ?? 0;
+            briefingItems.push(`**Last session** (${date}): ${created} created, ${modified} modified`);
+          }
+          if (readiness.gaps?.length > 0) {
+            briefingItems.push(`**${readiness.gaps.length} gap${readiness.gaps.length === 1 ? "" : "s"}** remaining`);
+          }
+          if (briefingItems.length > 0) {
+            lines.push("## Briefing");
+            for (const item of briefingItems) {
+              lines.push(`- ${item}`);
+            }
+            lines.push("");
+          }
+          if (recoveryBlock) {
+            lines.push("");
+            lines.push(...formatRecoveryBlock(recoveryBlock));
           }
         }
-        if (recoveryBlock) {
+        const activeEntries = allEntries.filter((e) => e.status === "active");
+        if (activeEntries.length > 0) {
+          const orgHealth = computeOrganisationHealth(activeEntries);
+          if (orgHealth.disagreements > 0) {
+            lines.push("## Organisation Health");
+            lines.push(...formatOrgHealthLines(orgHealth, 3));
+            lines.push("");
+          }
+        }
+        const epistemicEntries = activeEntries.filter(
+          (e) => e.collectionSlug === "insights" || e.collectionSlug === "assumptions"
+        );
+        if (epistemicEntries.length > 0) {
+          let validated = 0;
+          let evidenced = 0;
+          let hypotheses = 0;
+          let untested = 0;
+          for (const e of epistemicEntries) {
+            const ws = e.workflowStatus;
+            if (ws === "validated") validated++;
+            else if (ws === "evidenced") evidenced++;
+            else if (ws === "testing") evidenced++;
+            else if (ws === "invalidated") validated++;
+            else if (e.collectionSlug === "assumptions") untested++;
+            else hypotheses++;
+          }
+          const parts = [];
+          if (validated > 0) parts.push(`${validated} validated`);
+          if (evidenced > 0) parts.push(`${evidenced} evidenced`);
+          if (hypotheses > 0) parts.push(`${hypotheses} hypotheses`);
+          if (untested > 0) parts.push(`${untested} untested`);
+          lines.push(`**Epistemic health:** ${parts.join(" \xB7 ")} _(${epistemicEntries.length} claim-carrying entries)_`);
           lines.push("");
-          lines.push(...formatRecoveryBlock(recoveryBlock));
-        } else if (priorSessions.length > 0) {
-          const last = priorSessions[0];
-          const date = new Date(last.startedAt).toISOString().split("T")[0];
-          const created = Array.isArray(last.entriesCreated) ? last.entriesCreated.length : last.entriesCreated ?? 0;
-          const modified = Array.isArray(last.entriesModified) ? last.entriesModified.length : last.entriesModified ?? 0;
-          lines.push(`Last session (${date}): ${created} created, ${modified} modified`);
         }
-        if (orientEntries) {
-          const mapGovernanceEntry = (e) => ({
-            entryId: e.entryId,
-            name: e.name,
-            description: typeof e.preview === "string" ? e.preview : void 0
+        lines.push("What would you like to work on?");
+        lines.push("");
+      }
+      if (errors.length > 0) {
+        lines.push("## Errors");
+        for (const err of errors) lines.push(`- ${err}`);
+        lines.push("");
+      }
+      if (agentSessionId) {
+        try {
+          await mcpCall("agent.markOriented", { sessionId: agentSessionId });
+          setSessionOriented(true);
+          lines.push("---");
+          lines.push(`Orientation complete. Session ${agentSessionId}. Write tools available.`);
+        } catch {
+          lines.push("---");
+          lines.push("_Warning: Could not mark session as oriented. Write tools may be restricted._");
+        }
+        try {
+          await mcpMutation("chain.recordSessionSignal", {
+            sessionId: agentSessionId,
+            signalType: "immediate_context_load",
+            metadata: { source: "orient" }
           });
-          lines.push("");
-          lines.push(...buildOperatingProtocol({
-            principles: (orientEntries.principles ?? []).map(mapGovernanceEntry),
-            standards: (orientEntries.standards ?? []).map(mapGovernanceEntry),
-            businessRules: (orientEntries.businessRules ?? []).map(mapGovernanceEntry)
-          }, task));
+        } catch (err) {
+          process.stderr.write(`[MCP] recordSessionSignal failed: ${err.message}
+`);
         }
-        if (agentSessionId) {
-          try {
-            await mcpCall("agent.markOriented", { sessionId: agentSessionId });
-            setSessionOriented(true);
-          } catch {
-          }
-          lines.push("---");
-          lines.push(`Orientation complete. Session ${agentSessionId}.`);
+      } else {
+        lines.push("---");
+        lines.push("_No active agent session. Call `session action=start` to begin a tracked session._");
+      }
+      return {
+        content: [{ type: "text", text: lines.join("\n") }],
+        structuredContent: success(
+          `Oriented (full). Stage: ${orientStage}. ${isLowReadiness ? "Low readiness \u2014 gaps remain." : "Ready."}`,
+          { mode: "full", stage: orientStage, oriented: isSessionOriented(), sessionId: agentSessionId }
+        )
+      };
+    })
+  );
+}
+
+// src/resources/index.ts
+import { existsSync as existsSync3 } from "fs";
+import { dirname as dirname2, join, resolve as resolve3 } from "path";
+import { fileURLToPath } from "url";
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+var MODULE_DIR = dirname2(fileURLToPath(import.meta.url));
+var UI_VIEW_BASE_CANDIDATES = [
+  resolve3(MODULE_DIR, "views"),
+  resolve3(MODULE_DIR, "..", "views"),
+  resolve3(MODULE_DIR, "..", "..", "dist", "views"),
+  resolve3(MODULE_DIR, "..", "..", "..", "mcp-views", "dist")
+];
+function formatEntryMarkdown(entry) {
+  const id = entry.entryId ? `${entry.entryId}: ` : "";
+  const lines = [`## ${id}${entry.name} [${entry.status}]`];
+  if (entry.data && typeof entry.data === "object") {
+    for (const [key, val] of Object.entries(entry.data)) {
+      if (val && key !== "rawData") {
+        lines.push(`**${key}**: ${typeof val === "string" ? val : JSON.stringify(val)}`);
+      }
+    }
+  }
+  return lines.join("\n");
+}
+function buildOrientationMarkdown(collections, trackingEvents, standards, businessRules, principles) {
+  const sections = ["# Product Brain \u2014 Orientation"];
+  sections.push(
+    "## About Product Brain (PB)\nPB is a knowledge management system used by many product teams. This section describes how PB works \u2014 not your product.\n\n### How PB Organizes Its Tools\n- **Tools** = actions with side-effects or dynamic computation (capture, commit, search).\n- **Resources** = stable, read-only data (orientation, terminology, collection schemas).\n- **Prompts** = multi-step choreography (workflows, guided capture, deep dives).\n- Every tool, resource, and prompt works for ANY workspace \u2014 no bespoke logic.\n- Resource templates (URI params) serve workspace-specific data through generic patterns.\n- Compound tools with `action` enums keep the tool count minimal.\n\n### How PB Handles Your Data\n- **Draft-first**: all writes create drafts. SSOT requires explicit user confirmation.\n- **Empty-workspace safe**: every operation handles zero entries and fresh workspaces.\n- **Advisory, not blocking**: quality scores, contradiction checks, and coaching never prevent operations.\n- **Workspace-agnostic**: PB is a product for many teams \u2014 no workspace-specific logic.\n- **Self-documenting**: orient and server instructions teach agents how PB works."
+  );
+  const wsRules = [];
+  for (const p of (principles ?? []).filter((e) => e.status === "active" || e.status === "verified")) {
+    wsRules.push({ id: p.entryId ?? "", name: p.name, severity: p.data?.severity ?? void 0, source: "principles" });
+  }
+  for (const s of (standards ?? []).filter((e) => e.status === "active" || e.status === "verified")) {
+    wsRules.push({ id: s.entryId ?? "", name: s.name, severity: s.data?.severity ?? void 0, source: "standards" });
+  }
+  for (const r of (businessRules ?? []).filter((e) => e.status === "active" || e.status === "verified")) {
+    wsRules.push({ id: r.entryId ?? "", name: r.name, severity: r.data?.severity ?? void 0, source: "business-rules" });
+  }
+  if (wsRules.length > 0) {
+    const ruleLines = wsRules.map((r) => {
+      const sev = r.severity ? ` [${r.severity}]` : "";
+      return `- **${r.id}**: ${r.name}${sev}`;
+    }).join("\n");
+    sections.push(
+      `## Your Workspace Principles & Rules (${wsRules.length} active)
+These are principles, standards, and rules your team has committed to the Chain. Respect them during implementation.
+
+` + ruleLines + '\n\nUse `entries action=get entryId="<ID>"` to drill into any rule before making changes in that area.'
+    );
+  } else {
+    sections.push(
+      "## Your Workspace Principles & Rules\nNo active principles, standards, or business rules on the Chain yet.\nUse `capture` with collection `principles`, `standards`, or `business-rules` to add your team's guardrails.\nOnce committed, they appear here at orient time \u2014 so every agent session starts with your rules visible."
+    );
+  }
+  sections.push(
+    "## Core Product Architecture\nThe Chain is a versioned, connected, compounding knowledge base \u2014 the SSOT for a product team.\nEverything on the Chain is one of **three primitives**:\n\n- **Entry** (atom) \u2014 a discrete knowledge unit: target audience, business rule, glossary term, metric, tension. Lives in a collection.\n- **Process** (authored) \u2014 a narrative chain with named links (Strategy Coherence, IDM Proposal). Content is inline text. Collection: `chains`.\n- **Map** (composed) \u2014 a framework assembled by reference (Lean Canvas, Empathy Map). Slots point to ingredient entries. Collection: `maps`.\n\nEntries are atoms. Processes author narrative from atoms. Maps compose frameworks from atoms.\nAll three share the same versioning, branching, gating, and relation system.\n\nThe Chain compounds: each new relation makes entries discoverable from more starting points \u2192 context gathering returns richer results \u2192 AI processes have more context \u2192 quality scores improve \u2192 next commit is smarter than the last."
+  );
+  sections.push(
+    "## Architecture\n```\nCursor (stdio) \u2192 MCP Server (mcp-server/src/index.ts)\n  \u2192 POST /api/mcp with Bearer token\n  \u2192 Convex HTTP Action (convex/http.ts)\n  \u2192 internalQuery / internalMutation (convex/mcpKnowledge.ts)\n  \u2192 Convex DB (workspace-scoped)\n```\nSecurity: API key auth on every request, workspace-scoped data, internal functions blocked from external clients.\nKey files: `packages/mcp-server/src/client.ts` (HTTP client + audit), `convex/schema.ts` (schema)."
+  );
+  if (collections) {
+    const collList = collections.map((c) => {
+      const prefix = c.icon ? `${c.icon} ` : "";
+      return `- ${prefix}**${c.name}** (\`${c.slug}\`) \u2014 ${c.description || "no description"}`;
+    }).join("\n");
+    sections.push(
+      `## Data Model (${collections.length} collections)
+Unified entries model: collections define field schemas, entries hold data in a flexible \`data\` field.
+The \`data\` field is polymorphic: plain fields for generic entries, \`ChainData\` (chainTypeId + links) for processes, \`MapData\` (templateId + slots) for maps.
+Tags for filtering (e.g. \`severity:high\`), relations via \`entryRelations\`, versions via \`entryVersions\`, labels via \`labels\` + \`entryLabels\`.
+
+` + collList + "\n\nUse `collections action=list` for field schemas, `entries action=get` for full records."
+    );
+  } else {
+    sections.push(
+      "## Data Model\nCould not load collections \u2014 use `collections action=list` to browse manually."
+    );
+  }
+  const rulesCount = businessRules ? `${businessRules.length} entries` : "not loaded \u2014 collection may not exist yet";
+  sections.push(
+    `## Business Rules
+Collection: \`business-rules\` (${rulesCount}).
+Find rules: \`entries action=search\` for text search, \`entries action=list collection=business-rules\` to browse.
+Check compliance: use the \`review-against-rules\` prompt (pass a domain).
+Draft a new rule: use the \`draft-rule-from-context\` prompt.`
+  );
+  const eventsCount = trackingEvents ? `${trackingEvents.length} events` : "not loaded \u2014 collection may not exist yet";
+  const conventionNote = standards ? "Naming convention: `object_action` in snake_case with past-tense verbs (from standards collection)." : "Naming convention: `object_action` in snake_case with past-tense verbs.";
+  sections.push(
+    `## Analytics & Tracking
+Event catalog: \`tracking-events\` collection (${eventsCount}).
+${conventionNote}
+Implementation: \`src/lib/analytics.ts\`. Workspace-scoped events MUST use \`withWorkspaceGroup()\`.
+Browse: \`entries action=list collection=tracking-events\`.`
+  );
+  sections.push(
+    "## Knowledge Graph\nEntries are connected via typed relations (`entryRelations` table). Relations are bidirectional and collection-agnostic \u2014 any entry can link to any other entry.\n\n**Recommended relation types** (extensible \u2014 any string accepted):\n- `governs` \u2014 a rule constrains behavior of a feature\n- `defines_term_for` \u2014 a glossary term is canonical vocabulary for a feature/area\n- `belongs_to` \u2014 a feature belongs to a product area or parent concept\n- `informs` \u2014 a decision or insight informs a feature\n- `fills_slot` \u2014 an ingredient entry fills a slot in a map\n- `surfaces_tension_in` \u2014 a tension exists within a feature area\n- `related_to`, `depends_on`, `replaces`, `conflicts_with`, `references`, `confused_with`\n\nEach relation type is defined as a glossary entry (prefix `GT-REL-*`) to prevent terminology drift.\n\n**Tools:**\n- `context action=gather` \u2014 get the full context around any entry (multi-hop graph traversal)\n- `graph action=suggest` \u2014 discover potential connections for an entry\n- `relations action=create` \u2014 create a typed link between two entries\n- `graph action=find` \u2014 list direct relations for an entry\n\n**Convention:** When creating or updating entries in governed collections, always use `graph action=suggest` to discover and create relevant relations."
+  );
+  sections.push(
+    "## Creating Knowledge\n**Entries:** Use `capture` as the primary tool for creating new entries. It handles the full workflow in one call:\n1. Creates the entry with collection-aware defaults (auto-fills dates, infers domains, sets priority)\n2. Auto-links related entries from across the chain (up to 5 confident matches)\n3. Returns a quality scorecard (X/10) with actionable improvement suggestions\n\n**Smart profiles** exist for: `tensions`, `business-rules`, `glossary`, `decisions`, `features`, `audiences`, `strategy`, `standards`, `maps`, `chains`, `tracking-events`.\nAll other collections use the `ENT-{random}` fallback profile.\n\n**Processes:** Use `chain action=create` with a template (e.g., `strategy-coherence`, `idm-proposal`). Fill links with `chain action=edit`.\n\n**Maps:** Use `map action=create` with a template (e.g., `lean-canvas`). Fill slots with `map-slot action=add`. Commit with `map-version action=commit`.\nNote: committing a map version creates a snapshot but does NOT change the entry status. To activate: `update-entry entryId=MAP-xxx status=active autoPublish=true`.\nUse `map-suggest` to discover ingredients for empty slots.\n\n**Prompts** (invoke via MCP prompt protocol):\n- `name-check` \u2014 verify a name against glossary conventions\n- `draft-decision-record` \u2014 scaffold a decision entry\n- `review-against-rules` \u2014 check work against business rules for a domain\n- `draft-rule-from-context` \u2014 create a new business rule from context\n- `run-workflow` \u2014 run a structured ceremony (e.g., retrospective)\n\nUse `quality action=check` to score existing entries retroactively.\nUse `update-entry` for post-creation adjustments (status changes, field updates, deprecation)."
+  );
+  sections.push(
+    "## Where to Go Next\n- **Create entry** \u2192 `capture` tool (auto-links + quality score in one call)\n- **Full context** \u2192 `context action=gather` (by entry ID or task description)\n- **Discover links** \u2192 `graph action=suggest`\n- **Quality audit** \u2192 `quality action=check`\n- **Terminology** \u2192 `name-check` prompt or `productbrain://terminology` resource\n- **Schema details** \u2192 `productbrain://collections` resource or `collections action=list`\n- **Labels** \u2192 `productbrain://labels` resource or `labels` tool\n- **Any collection** \u2192 `productbrain://{slug}/entries` resource\n- **Log a decision** \u2192 `draft-decision-record` prompt\n- **Build a map** \u2192 `map action=create` + `map-slot action=add` + `map-version action=commit`\n- **Architecture map** \u2192 `architecture action=show` tool (layered system visualization)\n- **Explore a layer** \u2192 `architecture action=explore` tool (drill into Auth, Core, Features, etc.)\n- **Growth funnel** \u2192 `productbrain://growth-funnel` resource or `entries action=list collection=strategy status=draft`\n- **Audiences** \u2192 `productbrain://audiences/entries` resource or `entries action=list collection=audiences`\n- **Session identity** \u2192 `health action=whoami`\n- **Health check** \u2192 `health action=check`\n- **Debug MCP calls** \u2192 `health action=audit`"
+  );
+  return sections.join("\n\n---\n\n");
+}
+var AGENT_CHEATSHEET = `# Product Brain \u2014 Agent Cheatsheet
+
+## Core Tools
+| Tool | Purpose | Key params |
+|---|---|---|
+| \`orient\` | Workspace context, governance, active bets | \u2014 (call at session start) |
+| \`capture\` | Create entry (draft) | \`collection\`, \`name\`, \`description\`, optional \`data\` |
+| \`entries\` | List / get / batch / search entries | \`action\` + \`entryId\` / \`query\` / \`collection\` |
+| \`update-entry\` | Update fields on an entry | \`entryId\`, optional \`name\`, \`status\`, \`workflowStatus\`, \`data\`, \`changeNote\` |
+| \`commit-entry\` | Promote draft \u2192 SSOT | \`entryId\` |
+| \`graph\` | Suggest / find relations | \`action\` + \`entryId\` |
+| \`relations\` | Create / batch-create / delete links | \`from\`, \`to\`, \`type\` |
+| \`context\` | Gather related knowledge | \`entryId\` or \`task\` |
+| \`collections\` | List / create / update collections | \`action\` |
+| \`labels\` | List / create / apply / remove labels | \`action\` |
+| \`quality\` | Score an entry | \`entryId\` |
+| \`session\` | Start / close agent session | \`action\` |
+| \`health\` | Check / audit / whoami | \`action\` |
+| \`facilitate\` | Shaping workflows | \`action\`: start, respond, status |
+
+## Collection Prefixes
+GLO (glossary), BR (business-rules), PRI (principles), STD (standards),
+DEC (decisions), STR (strategy), TEN (tensions), FEAT (features),
+BET (bets), INS (insights), ARCH (architecture), CIR (circles),
+ROL (roles), MAP (maps), MTRC (tracking-events), ST (semantic-types)
+
+## Valid Relation Types (21)
+informs, governs, surfaces_tension_in, defines_term_for, belongs_to,
+references, related_to, fills_slot, commits_to, informed_by, depends_on,
+conflicts_with, confused_with, replaces, part_of, constrains,
+governed_by, alternative_to, has_proposal, requests_promotion_of, resolves
+
+## Lifecycle Status
+All entries: \`draft\` | \`active\` | \`deprecated\` | \`archived\`
+
+## Workflow Status (per collection)
+- **tensions:** open \u2192 processing \u2192 decided \u2192 closed
+- **decisions:** pending \u2192 decided
+- **bets:** shaped \u2192 bet \u2192 building \u2192 shipped
+- **business-rules:** active | conflict | review
+
+## Key Patterns
+- **Capture flow:** \`capture\` \u2192 \`graph action=suggest\` \u2192 \`relations action=batch-create\` \u2192 \`commit-entry\`
+- Use \`workflowStatus\` (not \`status\`) for domain workflow state
+- \`data\` param is merged (not replaced) \u2014 safe for partial updates
+`;
+function registerResources(server) {
+  server.resource(
+    "agent-cheatsheet",
+    "productbrain://agent-cheatsheet",
+    async (uri) => ({
+      contents: [{
+        uri: uri.href,
+        text: AGENT_CHEATSHEET,
+        mimeType: "text/markdown"
+      }]
+    })
+  );
+  server.resource(
+    "chain-orientation",
+    "productbrain://orientation",
+    async (uri) => {
+      const [collectionsResult, eventsResult, standardsResult, rulesResult, principlesResult] = await Promise.allSettled([
+        mcpQuery("chain.listCollections"),
+        mcpQuery("chain.listEntries", { collectionSlug: "tracking-events" }),
+        mcpQuery("chain.listEntries", { collectionSlug: "standards" }),
+        mcpQuery("chain.listEntries", { collectionSlug: "business-rules" }),
+        mcpQuery("chain.listEntries", { collectionSlug: "principles" })
+      ]);
+      const collections = collectionsResult.status === "fulfilled" ? collectionsResult.value : null;
+      const trackingEvents = eventsResult.status === "fulfilled" ? eventsResult.value : null;
+      const standards = standardsResult.status === "fulfilled" ? standardsResult.value : null;
+      const businessRules = rulesResult.status === "fulfilled" ? rulesResult.value : null;
+      const principles = principlesResult.status === "fulfilled" ? principlesResult.value : null;
+      return {
+        contents: [{
+          uri: uri.href,
+          text: buildOrientationMarkdown(collections, trackingEvents, standards, businessRules, principles),
+          mimeType: "text/markdown"
+        }]
+      };
+    }
+  );
+  server.resource(
+    "chain-terminology",
+    "productbrain://terminology",
+    async (uri) => {
+      const [glossaryResult, standardsResult] = await Promise.allSettled([
+        mcpQuery("chain.listEntries", { collectionSlug: "glossary" }),
+        mcpQuery("chain.listEntries", { collectionSlug: "standards" })
+      ]);
+      const lines = ["# Product Brain \u2014 Terminology"];
+      if (glossaryResult.status === "fulfilled") {
+        const glossary = glossaryResult.value ?? [];
+        if (glossary.length > 0) {
+          const terms = glossary.map((t) => `- **${t.name}** (${t.entryId ?? "\u2014"}) [${t.status}]: ${t.data?.canonical ?? t.data?.description ?? ""}`).join("\n");
+          lines.push(`## Glossary (${glossary.length} terms)
+
+${terms}`);
         } else {
-          lines.push("---");
-          lines.push("_No active agent session. Call `session action=start` to begin._");
-        }
-        if (errors.length > 0) {
-          lines.push("");
-          for (const err of errors) lines.push(`- ${err}`);
+          lines.push("## Glossary\n\nNo glossary terms yet. Use `capture` with collection `glossary` to add terms.");
         }
-        return {
-          content: [{ type: "text", text: lines.join("\n") }],
-          structuredContent: success(
-            `Oriented (brief). Stage: ${readiness?.stage ?? "unknown"}.`,
-            { mode: "brief", stage: readiness?.stage ?? "unknown", oriented: isSessionOriented(), sessionId: agentSessionId }
-          )
-        };
+      } else {
+        lines.push("## Glossary\n\nCould not load glossary \u2014 use `entries action=list collection=glossary` to browse manually.");
       }
-      const orientStage = readiness?.stage ?? "seeded";
-      if (isLowReadiness && wsCtx?.createdAt) {
-        const ageDays = Math.floor((Date.now() - wsCtx.createdAt) / (1e3 * 60 * 60 * 24));
-        if (ageDays >= 30) {
-          lines.push(`Your workspace has been around for ${ageDays} days and is still at the **${orientStage}** stage.`);
-          lines.push("Let's close the gaps \u2014 or if the current structure doesn't fit, we can reshape it.");
-          lines.push("");
+      if (standardsResult.status === "fulfilled") {
+        const standards = standardsResult.value ?? [];
+        if (standards.length > 0) {
+          const stds = standards.map((s) => `- **${s.name}** (${s.entryId ?? "\u2014"}) [${s.status}]: ${s.data?.description ?? ""}`).join("\n");
+          lines.push(`## Standards (${standards.length} entries)
+
+${stds}`);
+        } else {
+          lines.push("## Standards\n\nNo standards yet. Use `capture` with collection `standards` to add standards.");
         }
+      } else {
+        lines.push("## Standards\n\nCould not load standards \u2014 use `entries action=list collection=standards` to browse manually.");
       }
-      if (isLowReadiness) {
-        lines.push(`**Brain stage: ${orientStage}.**`);
-        lines.push("");
-        const gaps = readiness.gaps ?? [];
-        if (gaps.length > 0) {
-          const gap = gaps[0];
-          const cta = gap.capabilityGuidance ?? gap.guidance ?? `Tell me about your ${gap.label.toLowerCase()} and I'll capture it.`;
-          lines.push("## Recommended next step");
-          lines.push(`**${gap.label}**`);
-          lines.push("");
-          lines.push(cta);
-          lines.push("");
-          lines.push('_Everything stays as a draft until you confirm. Say "commit" or "looks good" to promote to the Chain._');
-          lines.push("");
-          const remainingGaps = gaps.length - 1;
-          if (remainingGaps > 0 || openTensions.length > 0) {
-            lines.push(`_${remainingGaps > 0 ? `${remainingGaps} more gap${remainingGaps === 1 ? "" : "s"}` : ""}${remainingGaps > 0 && openTensions.length > 0 ? " and " : ""}${openTensions.length > 0 ? `${openTensions.length} open tension${openTensions.length === 1 ? "" : "s"}` : ""} \u2014 ask "show full status" for details._`);
-            lines.push("");
-          }
-        }
-        lines.push("_Need a collection that doesn't exist yet (e.g. audiences, personas, metrics)?_");
-        lines.push("_Use `collections action=create` to add it, or ask me to propose collections for your domain._");
-        lines.push("");
-      } else if (readiness) {
-        lines.push(`**Brain stage: ${orientStage}.**`);
-        lines.push("");
-        if (orientEntries?.strategicContext) {
-          const sc = orientEntries.strategicContext;
-          lines.push("## Strategic Context");
-          if (sc.vision) lines.push(`**Vision:** ${sc.vision}`);
-          if (sc.purpose) lines.push(`**Purpose:** ${sc.purpose}`);
-          if (sc.productAreaCount != null && sc.productAreaCount > 0) {
-            lines.push(`**Product areas (${sc.productAreaCount}):** ${(sc.productAreas ?? []).join(", ")}`);
-          }
-          const betLine = sc.currentBet ? `**Current bet:** ${sc.currentBet}. ${sc.activeBetCount} active bet(s).` : "No active bets.";
-          lines.push(`${betLine} ${sc.activeTensionCount} open tension(s).`);
-          lines.push("");
-        }
-        if (orientEntries?.continuingFrom && orientEntries.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) {
-            const id = e.entryId ?? e.name;
-            const type = e.canonicalKey ?? "generic";
-            const coll = e.collectionSlug ? ` [${e.collectionSlug}]` : "";
-            lines.push(`- \`${id}\` (score ${e.score}) [${type}]${coll} \u2014 ${e.name}`);
-            if (e.reasoning) lines.push(`  _${e.reasoning}_`);
-          }
-          lines.push("");
-        }
-        if (orientEntries?.lastSessionTouched && orientEntries.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) {
-            const id = e.entryId ?? e.name;
-            const type = e.canonicalKey ?? "generic";
-            const coll = e.collectionSlug ? ` [${e.collectionSlug}]` : "";
-            lines.push(`- \`${id}\` [${type}]${coll} \u2014 ${e.name}`);
-          }
-          lines.push("");
-        }
-        if (orientEntries?.taskContext && orientEntries.taskContext.context.length > 0) {
-          const tc = orientEntries.taskContext;
-          lines.push("## Task Context");
-          lines.push(`_Task-scoped entries (${tc.confidence} confidence, ${tc.totalFound} relevant)`);
-          lines.push("");
-          for (const e of tc.context) {
-            const id = e.entryId ?? e.name;
-            const coll = e.collectionSlug ? ` [${e.collectionSlug}]` : "";
-            lines.push(`- \`${id}\` (score ${e.score})${coll}${e.name !== id ? ` \u2014 ${e.name}` : ""}`);
-          }
-          lines.push("");
-        }
-        if (task && orientEntries) {
-          const result = runAlignmentCheck(
-            task,
-            orientEntries.activeBets ?? [],
-            orientEntries.taskContext?.context
-          );
-          lines.push(...buildAlignmentCheckLines(result));
-        }
-        if (orientEntries) {
-          const fmt = (e) => {
-            const type = e.canonicalKey ?? "generic";
-            const stratum = e.stratum ?? "?";
-            return `- \`${e.entryId ?? e._id}\` [${type} \xB7 ${stratum}] ${e.name}`;
-          };
-          if (orientEntries.activeBets?.length > 0) {
-            lines.push("## Active bets \u2014 current scope");
-            lines.push("_These define what you're building now. Work outside these bets requires explicit user confirmation before designing._");
-            lines.push("");
-            for (const e of orientEntries.activeBets) {
-              lines.push(fmt(e));
-              const tensions = e.linkedTensions;
-              if (tensions?.length) {
-                const tensionLines = tensions.map((t) => {
-                  const meta = [t.severity, t.priority].filter(Boolean).join(", ");
-                  return `\`${t.entryId ?? t.name}\` (${t.name}${meta ? `, ${meta}` : ""})`;
-                });
-                lines.push(`  Tensions: ${tensionLines.join("; ")}`);
-              } else {
-                lines.push(`  Tensions: No linked tensions`);
-              }
-            }
-            lines.push("");
-          }
-          if (orientEntries.activeGoals.length > 0) {
-            lines.push("## Active goals");
-            orientEntries.activeGoals.forEach((e) => lines.push(fmt(e)));
-            lines.push("");
-          }
-          if (orientEntries.recentDecisions.length > 0) {
-            lines.push("## Recent decisions");
-            orientEntries.recentDecisions.forEach((e) => lines.push(fmt(e)));
-            lines.push("");
-          }
-          if (orientEntries.recentlySuperseded.length > 0) {
-            lines.push("## Recently superseded");
-            orientEntries.recentlySuperseded.forEach((e) => lines.push(fmt(e)));
-            lines.push("");
-          }
-          if (orientEntries.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("");
-          }
-          const hasPrinciples = orientEntries.principles?.length > 0;
-          const hasStandards = orientEntries.standards?.length > 0;
-          const hasBusinessRules = orientEntries.businessRules.length > 0;
-          if (hasPrinciples || hasStandards || hasBusinessRules) {
-            lines.push("## Workspace Governance \u2014 constraints");
-            lines.push("_These constrain what you build. If your proposal conflicts with any of these, stop and flag it. Do not design around them without explicit user confirmation._");
-            lines.push("");
-            if (hasPrinciples) {
-              lines.push("**Principles** \u2014 beliefs that guide decisions:");
-              orientEntries.principles.forEach((e) => lines.push(fmt(e)));
-              lines.push("");
-            }
-            if (hasStandards) {
-              lines.push("**Standards** \u2014 conventions for how work is done:");
-              orientEntries.standards.forEach((e) => lines.push(fmt(e)));
-              lines.push("");
-            }
-            if (hasBusinessRules) {
-              lines.push("**Business Rules** \u2014 system constraints:");
-              orientEntries.businessRules.forEach((e) => lines.push(fmt(e)));
-              lines.push("");
-            }
-          }
-          if (orientEntries.architectureNotes.length > 0) {
-            lines.push("## Architecture notes");
-            orientEntries.architectureNotes.forEach((e) => lines.push(fmt(e)));
-            lines.push("");
-          }
-          const mapGovernanceEntry = (e) => ({
-            entryId: e.entryId,
-            name: e.name,
-            description: typeof e.preview === "string" ? e.preview : void 0
-          });
-          lines.push(...buildOperatingProtocol({
-            principles: (orientEntries.principles ?? []).map(mapGovernanceEntry),
-            standards: (orientEntries.standards ?? []).map(mapGovernanceEntry),
-            businessRules: (orientEntries.businessRules ?? []).map(mapGovernanceEntry)
-          }, task));
-        }
-        let allEntries = [];
-        try {
-          allEntries = await mcpQuery("chain.listEntries", {}) ?? [];
-        } catch {
+      return {
+        contents: [{ uri: uri.href, text: lines.join("\n\n---\n\n"), mimeType: "text/markdown" }]
+      };
+    }
+  );
+  server.resource(
+    "chain-collections",
+    "productbrain://collections",
+    async (uri) => {
+      const collections = await mcpQuery("chain.listCollections") ?? [];
+      if (collections.length === 0) {
+        return { contents: [{ uri: uri.href, text: "No collections in this workspace. Use `collections action=create` or `start` with a preset to get started.", mimeType: "text/markdown" }] };
+      }
+      const formatted = collections.map((c) => {
+        const fieldList = (c.fields ?? []).map((f) => `  - \`${f.key}\` (${f.type}${f.required ? ", required" : ""}${f.searchable ? ", searchable" : ""})`).join("\n");
+        return `## ${c.icon ?? ""} ${c.name} (\`${c.slug}\`)
+${c.description || ""}
+
+**Fields:**
+${fieldList}`;
+      }).join("\n\n---\n\n");
+      return {
+        contents: [{ uri: uri.href, text: `# Knowledge Collections (${collections.length})
+
+${formatted}`, mimeType: "text/markdown" }]
+      };
+    }
+  );
+  server.resource(
+    "chain-collection-entries",
+    new ResourceTemplate("productbrain://{slug}/entries", {
+      list: async () => {
+        const collections = await mcpQuery("chain.listCollections") ?? [];
+        return {
+          resources: collections.map((c) => ({
+            uri: `productbrain://${c.slug}/entries`,
+            name: `${c.icon ?? ""} ${c.name}`.trim()
+          }))
+        };
+      }
+    }),
+    async (uri, { slug }) => {
+      const entries = await mcpQuery("chain.listEntries", { collectionSlug: slug }) ?? [];
+      const formatted = entries.map(formatEntryMarkdown).join("\n\n---\n\n");
+      return {
+        contents: [{
+          uri: uri.href,
+          text: formatted || "No entries in this collection.",
+          mimeType: "text/markdown"
+        }]
+      };
+    }
+  );
+  server.resource(
+    "chain-labels",
+    "productbrain://labels",
+    async (uri) => {
+      const labels = await mcpQuery("chain.listLabels") ?? [];
+      if (labels.length === 0) {
+        return { contents: [{ uri: uri.href, text: "No labels in this workspace.", mimeType: "text/markdown" }] };
+      }
+      const groups = labels.filter((l) => l.isGroup);
+      const ungrouped = labels.filter((l) => !l.isGroup && !l.parentId);
+      const children = (parentId) => labels.filter((l) => l.parentId === parentId);
+      const lines = [];
+      for (const group of groups) {
+        lines.push(`## ${group.name}`);
+        for (const child of children(group._id)) {
+          lines.push(`- \`${child.slug}\` ${child.name}${child.color ? ` (${child.color})` : ""}`);
         }
-        const plannedWork = buildPlannedWork(allEntries);
-        if (hasPlannedWork(plannedWork)) {
-          lines.push(...buildPlannedWorkSection(plannedWork, priorSessions, recoveryBlock));
-        } else {
-          const briefingItems = [];
-          if (priorSessions.length > 0 && !recoveryBlock) {
-            const last = priorSessions[0];
-            const date = new Date(last.startedAt).toISOString().split("T")[0];
-            const created = Array.isArray(last.entriesCreated) ? last.entriesCreated.length : last.entriesCreated ?? 0;
-            const modified = Array.isArray(last.entriesModified) ? last.entriesModified.length : last.entriesModified ?? 0;
-            briefingItems.push(`**Last session** (${date}): ${created} created, ${modified} modified`);
-          }
-          if (readiness.gaps?.length > 0) {
-            briefingItems.push(`**${readiness.gaps.length} gap${readiness.gaps.length === 1 ? "" : "s"}** remaining`);
-          }
-          if (briefingItems.length > 0) {
-            lines.push("## Briefing");
-            for (const item of briefingItems) {
-              lines.push(`- ${item}`);
-            }
-            lines.push("");
-          }
-          if (recoveryBlock) {
-            lines.push("");
-            lines.push(...formatRecoveryBlock(recoveryBlock));
-          }
+      }
+      if (ungrouped.length > 0) {
+        lines.push("## Ungrouped");
+        for (const l of ungrouped) {
+          lines.push(`- \`${l.slug}\` ${l.name}${l.color ? ` (${l.color})` : ""}`);
         }
-        const activeEntries = allEntries.filter((e) => e.status === "active");
-        if (activeEntries.length > 0) {
-          const orgHealth = computeOrganisationHealth(activeEntries);
-          if (orgHealth.disagreements > 0) {
-            lines.push("## Organisation Health");
-            lines.push(...formatOrgHealthLines(orgHealth, 3));
-            lines.push("");
-          }
+      }
+      return {
+        contents: [{ uri: uri.href, text: `# Workspace Labels (${labels.length})
+
+${lines.join("\n")}`, mimeType: "text/markdown" }]
+      };
+    }
+  );
+  server.resource(
+    "chain-entry",
+    new ResourceTemplate("productbrain://entries/{entryId}", {
+      complete: {
+        entryId: async (value) => {
+          if (!value || value.length < 1) return [];
+          const entries = await mcpQuery("chain.searchEntries", { query: value }) ?? [];
+          return entries.slice(0, 10).map((e) => e.entryId ?? e._id);
         }
-        const epistemicEntries = activeEntries.filter(
-          (e) => e.collectionSlug === "insights" || e.collectionSlug === "assumptions"
-        );
-        if (epistemicEntries.length > 0) {
-          let validated = 0;
-          let evidenced = 0;
-          let hypotheses = 0;
-          let untested = 0;
-          for (const e of epistemicEntries) {
-            const ws = e.workflowStatus;
-            if (ws === "validated") validated++;
-            else if (ws === "evidenced") evidenced++;
-            else if (ws === "testing") evidenced++;
-            else if (ws === "invalidated") validated++;
-            else if (e.collectionSlug === "assumptions") untested++;
-            else hypotheses++;
+      }
+    }),
+    async (uri, { entryId }) => {
+      const [entry, collections] = await Promise.all([
+        mcpQuery("chain.getEntry", { entryId }),
+        mcpQuery("chain.listCollections")
+      ]);
+      if (!entry) {
+        return { contents: [{ uri: uri.href, text: `Entry "${entryId}" not found.`, mimeType: "text/markdown" }] };
+      }
+      const collectionMap = new Map((collections ?? []).map((c) => [c._id, c]));
+      const col = collectionMap.get(entry.collectionId);
+      const collLabel = col?.name ?? entry.collectionName ?? entry.collectionSlug ?? "unknown";
+      const lines = [
+        `# ${entry.entryId}: ${entry.name}`,
+        `**Collection:** ${collLabel}`,
+        `**Status:** ${entry.status}`,
+        ""
+      ];
+      if (entry.data && typeof entry.data === "object") {
+        lines.push("## Data");
+        for (const [key, val] of Object.entries(entry.data)) {
+          if (val && key !== "rawData") {
+            const str = typeof val === "string" ? val : JSON.stringify(val, null, 2);
+            lines.push(`**${key}:** ${str}`);
           }
-          const parts = [];
-          if (validated > 0) parts.push(`${validated} validated`);
-          if (evidenced > 0) parts.push(`${evidenced} evidenced`);
-          if (hypotheses > 0) parts.push(`${hypotheses} hypotheses`);
-          if (untested > 0) parts.push(`${untested} untested`);
-          lines.push(`**Epistemic health:** ${parts.join(" \xB7 ")} _(${epistemicEntries.length} claim-carrying entries)_`);
-          lines.push("");
         }
-        lines.push("What would you like to work on?");
         lines.push("");
       }
-      if (errors.length > 0) {
-        lines.push("## Errors");
-        for (const err of errors) lines.push(`- ${err}`);
+      if (entry.relations && entry.relations.length > 0) {
+        lines.push("## Relations");
+        for (const rel of entry.relations) {
+          const arrow = rel.direction === "outgoing" ? "\u2192" : "\u2190";
+          const id = rel.otherEntryId ?? "";
+          const name = rel.otherName ?? "(unknown)";
+          lines.push(`- ${arrow} **${rel.type}** ${id}: ${name}`);
+        }
         lines.push("");
       }
-      if (agentSessionId) {
-        try {
-          await mcpCall("agent.markOriented", { sessionId: agentSessionId });
-          setSessionOriented(true);
-          lines.push("---");
-          lines.push(`Orientation complete. Session ${agentSessionId}. Write tools available.`);
-        } catch {
-          lines.push("---");
-          lines.push("_Warning: Could not mark session as oriented. Write tools may be restricted._");
+      if (entry.labels && entry.labels.length > 0) {
+        lines.push(`## Labels
+${entry.labels.map((l) => `- ${l.name ?? l.slug}`).join("\n")}`);
+      }
+      return {
+        contents: [{ uri: uri.href, text: lines.join("\n"), mimeType: "text/markdown" }]
+      };
+    }
+  );
+  server.resource(
+    "chain-context",
+    new ResourceTemplate("productbrain://context/{entryId}", {
+      complete: {
+        entryId: async (value) => {
+          if (!value || value.length < 1) return [];
+          const entries = await mcpQuery("chain.searchEntries", { query: value }) ?? [];
+          return entries.slice(0, 10).map((e) => e.entryId ?? e._id);
         }
-        try {
-          await mcpMutation("chain.recordSessionSignal", {
-            sessionId: agentSessionId,
-            signalType: "immediate_context_load",
-            metadata: { source: "orient" }
-          });
-        } catch (err) {
-          process.stderr.write(`[MCP] recordSessionSignal failed: ${err.message}
-`);
+      }
+    }),
+    async (uri, { entryId }) => {
+      const result = await mcpQuery("chain.gatherContext", {
+        entryId,
+        maxHops: 2
+      });
+      if (!result?.root) {
+        return { contents: [{ uri: uri.href, text: `Entry "${entryId}" not found.`, mimeType: "text/markdown" }] };
+      }
+      const lines = [
+        `# Context: ${result.root.entryId}: ${result.root.name}`,
+        `_${result.totalRelations} related entries (${result.hopsTraversed} hops)_`,
+        ""
+      ];
+      const byCollection = /* @__PURE__ */ new Map();
+      for (const entry of result.related ?? []) {
+        const key = entry.collectionName;
+        if (!byCollection.has(key)) byCollection.set(key, []);
+        byCollection.get(key).push(entry);
+      }
+      for (const [collName, entries] of byCollection) {
+        lines.push(`## ${collName} (${entries.length})`);
+        for (const e of entries) {
+          const arrow = e.relationDirection === "outgoing" ? "\u2192" : "\u2190";
+          const hopLabel = e.hop > 1 ? ` (hop ${e.hop})` : "";
+          const id = e.entryId ? `${e.entryId}: ` : "";
+          lines.push(`- ${arrow} **${e.relationType}** ${id}${e.name}${hopLabel}`);
         }
-      } else {
-        lines.push("---");
-        lines.push("_No active agent session. Call `session action=start` to begin a tracked session._");
+        lines.push("");
       }
       return {
-        content: [{ type: "text", text: lines.join("\n") }],
-        structuredContent: success(
-          `Oriented (full). Stage: ${orientStage}. ${isLowReadiness ? "Low readiness \u2014 gaps remain." : "Ready."}`,
-          { mode: "full", stage: orientStage, oriented: isSessionOriented(), sessionId: agentSessionId }
-        )
+        contents: [{ uri: uri.href, text: lines.join("\n"), mimeType: "text/markdown" }]
       };
-    })
+    }
+  );
+  server.resource(
+    "chain-search",
+    new ResourceTemplate("productbrain://search/{query}", {
+      complete: {
+        query: async (value) => {
+          if (!value) return ["glossary:", "business-rules:", "decisions:", "tensions:"];
+          return [];
+        }
+      }
+    }),
+    async (uri, { query }) => {
+      const results = await mcpQuery("chain.searchEntries", { query });
+      if (!results || results.length === 0) {
+        return { contents: [{ uri: uri.href, text: `No results for "${query}".`, mimeType: "text/markdown" }] };
+      }
+      const lines = [
+        `# Search: "${query}"`,
+        `_${results.length} results_`,
+        ""
+      ];
+      for (const entry of results) {
+        const id = entry.entryId ? `**${entry.entryId}:** ` : "";
+        const coll = entry.collectionName ?? entry.collectionSlug ?? "";
+        lines.push(`- ${id}${entry.name} [${coll}] (${entry.status})`);
+      }
+      return {
+        contents: [{ uri: uri.href, text: lines.join("\n"), mimeType: "text/markdown" }]
+      };
+    }
   );
 }
 
@@ -10943,8 +10895,11 @@ Use one of these IDs to run a workflow.`
       } catch {
         kbContext = "\n_Could not load chain context \u2014 proceed without it._";
       }
-      const roundsPlan = wf.rounds.map(
-        (r) => `### Round ${r.num}: ${r.label}
+      const isFacilitated = descriptor?.runtime.kind === "facilitated";
+      const roundsPlan = wf.rounds.map((r, index) => {
+        const isLastRound = index === wf.rounds.length - 1;
+        const checkpointLine = isFacilitated ? isLastRound ? `**Checkpoint**: After completing this round, persist with \`workflows action="checkpoint" workflowId="${wf.id}" roundId="${r.id}" summaryEntryId=<betEntryId>\` to finalize the durable run and link the bet.` : `**Checkpoint**: After completing this round via \`facilitate\`, also persist with \`workflows action="checkpoint" workflowId="${wf.id}" roundId="${r.id}"\`` : `**Checkpoint**: Immediately persist this round with \`workflows action="checkpoint" workflowId="${wf.id}" roundId="${r.id}"\``;
+        return `### Round ${r.num}: ${r.label}
 **Type**: ${r.type} | **Duration**: ~${r.maxDurationHint ?? "5 min"}
 **Instruction**: ${r.instruction}
 **Facilitator guidance**: ${r.facilitatorGuidance}
@@ -10953,8 +10908,8 @@ Use one of these IDs to run a workflow.`
 ` + (q.options ? q.options.map((o) => `  - ${o.id}: ${o.label}`).join("\n") : "  _(open response)_")
         ).join("\n") : "") + `
 **Output**: Capture to \`${r.outputSchema.field}\` (${r.outputSchema.format})
-**Checkpoint**: Immediately persist this round with \`workflows action="checkpoint" workflowId="${wf.id}" roundId="${r.id}"\``
-      ).join("\n\n---\n\n");
+` + checkpointLine;
+      }).join("\n\n---\n\n");
       const contextLine = context ? `
 The participant provided this context: "${context}"
 Use it \u2014 don't make them repeat themselves.
@@ -10975,7 +10930,15 @@ Description field: ${summaryCapture.descriptionField ?? "collection default"}
 ` : `Primary output: ${outputDescription}
 Use the workflow guidance to capture the primary record directly rather than relying on final summary auto-capture.
 `;
-      const checkpointingBlock = `## Checkpointing & Resume
+      const checkpointingBlock = isFacilitated ? `## Checkpointing & Resume (Facilitated Workflow)
+
+This workflow uses \`${descriptor?.runtime.primaryTool ?? "facilitate"}\` as its primary tool, with durable workflow runs for tracking and observability.
+1. Before starting, check for an existing run with \`workflows action="get-run" workflowId="${wf.id}"\`.
+2. The \`${descriptor?.runtime.primaryTool ?? "facilitate"}\` tool drives the session. Use it for scoring, coaching, capture, and constellation management.
+3. After completing EACH round via \`${descriptor?.runtime.primaryTool ?? "facilitate"}\`, also call \`workflows action="checkpoint" workflowId="${wf.id}" roundId="<round-id>" output=<round-output>\` to mirror progress to the durable run.
+4. On the final round, pass \`summaryEntryId=<betEntryId>\` to link the bet as the run's summary. Do NOT use \`isFinal: true\` \u2014 the run auto-completes when all rounds are checkpointed.
+5. If a checkpoint fails, continue the session \u2014 \`${descriptor?.runtime.primaryTool ?? "facilitate"}\` state is preserved independently.
+` : `## Checkpointing & Resume
 
 This workflow now supports durable workflow runs.
 1. Before starting, check for an existing run in the current session with \`workflows action="get-run" workflowId="${wf.id}"\`.
@@ -11618,4 +11581,4 @@ export {
   SERVER_VERSION,
   createProductBrainServer
 };
-//# sourceMappingURL=chunk-HQLEMADT.js.map
+//# sourceMappingURL=chunk-VKO3MWSQ.js.map