@productbrain/mcp 0.0.1-beta.47 → 0.0.1-beta.49

package/dist/{chunk-FMEZXUP5.js → chunk-IGQLZI32.js}

@@ -2,10 +2,13 @@ import {
   batchCaptureSchema,
   captureSchema,
   checkEntryQuality,
+  classifyCollection,
   closeAgentSession,
+  deriveEpistemicStatus,
   extractPreview,
   failure,
   failureResult,
+  formatEpistemicLine,
   formatRubricCoaching,
   formatRubricVerdictSection,
   getAgentSessionId,
@@ -29,12 +32,13 @@ import {
   startAgentSession,
   success,
   successResult,
+  toEpistemicInput,
   trackWriteTool,
   translateStaleToolNames,
   unknownAction,
   validationResult,
   withEnvelope
-} from "./chunk-FYFF4QKF.js";
+} from "./chunk-ED3KCWZE.js";
 import {
   trackQualityCheck,
   trackQualityVerdict
@@ -228,7 +232,7 @@ ${formatted}` }],
     },
     withEnvelope(async ({ entryId }) => {
       requireWriteAccess();
-      const { runContradictionCheck } = await import("./smart-capture-XLBFE252.js");
+      const { runContradictionCheck } = await import("./smart-capture-2IM2565I.js");
       const entry = await mcpQuery("chain.getEntry", { entryId });
       if (!entry) {
         return notFoundResult(entryId, `Entry '${entryId}' not found. Try search to find the right ID.`);
@@ -252,9 +256,11 @@ ${formatted}` }],
         sessionId: getAgentSessionId() ?? void 0
       });
       const docId = result?._id ?? entry._id;
-      await recordSessionActivity({ entryModified: docId });
       const wsCtx = await getWorkspaceContext();
       const isProposal = result?.status === "proposal_created";
+      if (!isProposal) {
+        await recordSessionActivity({ entryModified: docId });
+      }
       let lines;
       if (isProposal) {
         lines = [
@@ -308,6 +314,14 @@ ${formatted}` }],
           }
         }
       }
+      const epistemic = deriveEpistemicStatus(toEpistemicInput(entry));
+      if (epistemic && (epistemic.level === "hypothesis" || epistemic.level === "untested")) {
+        lines.push("");
+        lines.push(`\u26A0 ${formatEpistemicLine(epistemic)}`);
+        if (epistemic.action) {
+          lines.push(`  \u2192 ${epistemic.action}`);
+        }
+      }
       const next = isProposal ? [
         { tool: "entries", description: "View entry", parameters: { action: "get", entryId } }
       ] : [
@@ -325,7 +339,8 @@ ${formatted}` }],
             outcome: isProposal ? "proposal_created" : "committed",
             qualityVerdict: coachingResult?.verdict ?? void 0,
             source: coachingResult?.source ?? void 0,
-            contradictions: warnings.length
+            contradictions: warnings.length,
+            ...epistemic ? { epistemicStatus: epistemic } : {}
           },
           next
         )
@@ -337,6 +352,13 @@ ${formatted}` }],
 
 // src/tools/entries.ts
 import { z as z2 } from "zod";
+function sanitizeEntryData(data) {
+  if (!data || typeof data !== "object") return void 0;
+  const filtered = Object.fromEntries(
+    Object.entries(data).filter(([key]) => !key.startsWith("_"))
+  );
+  return Object.keys(filtered).length > 0 ? filtered : void 0;
+}
 var ENTRIES_ACTIONS = ["list", "get", "batch", "search"];
 var entriesSchema = z2.object({
   action: z2.enum(ENTRIES_ACTIONS).describe(
@@ -441,6 +463,7 @@ async function handleGet(entryId) {
     return notFoundResult(entryId, `Entry '${entryId}' not found. Try search to find the right ID.`);
   }
   const e = entry;
+  const epistemic = deriveEpistemicStatus(toEpistemicInput(e));
   const lines = [
     `## Get Result`,
     "",
@@ -449,9 +472,13 @@ async function handleGet(entryId) {
     `**Status:** ${e.status}${e.workflowStatus ? ` / ${e.workflowStatus}` : ""}`,
     `**Type:** ${e.canonicalKey ?? "untyped"}`
   ];
-  if (e.data && typeof e.data === "object") {
+  if (epistemic) {
+    lines.push(formatEpistemicLine(epistemic));
+  }
+  const visibleData = sanitizeEntryData(e.data);
+  if (visibleData) {
     lines.push("");
-    for (const [key, val] of Object.entries(e.data)) {
+    for (const [key, val] of Object.entries(visibleData)) {
       const display = typeof val === "string" ? val : JSON.stringify(val);
       lines.push(`**${key}:** ${display}`);
     }
@@ -484,8 +511,9 @@ async function handleGet(entryId) {
     collection: String(e.canonicalKey ?? ""),
     status: String(e.status ?? ""),
     ...e.workflowStatus ? { workflowStatus: String(e.workflowStatus) } : {},
+    ...epistemic ? { epistemicStatus: epistemic } : {},
     entries: [{ entryId: e.entryId, name: e.name, status: e.status, ...e.workflowStatus ? { workflowStatus: e.workflowStatus } : {}, collectionName: String(e.collectionName ?? e.canonicalKey ?? "\u2014") }],
-    ...e.data && typeof e.data === "object" ? { data: e.data } : {},
+    ...visibleData ? { data: visibleData } : {},
     ...Array.isArray(e.relations) && e.relations.length > 0 ? {
       relations: e.relations.map((r) => ({
         ...r.otherEntryId ? { entryId: r.otherEntryId } : {},
@@ -526,9 +554,10 @@ async function handleBatch(entryIds) {
     lines.push("");
     lines.push(`**Status:** ${entry.status}${entry.workflowStatus ? ` / ${entry.workflowStatus}` : ""}`);
     lines.push(`**Type:** ${entry.canonicalKey ?? "untyped"}`);
-    if (entry.data && typeof entry.data === "object") {
+    const visibleData = sanitizeEntryData(entry.data);
+    if (visibleData) {
       lines.push("");
-      for (const [key, val] of Object.entries(entry.data)) {
+      for (const [key, val] of Object.entries(visibleData)) {
         const display = typeof val === "string" ? val : JSON.stringify(val);
         lines.push(`**${key}:** ${display}`);
       }
@@ -565,7 +594,7 @@ async function handleBatch(entryIds) {
       collection: String(entry.canonicalKey ?? ""),
       status: String(entry.status ?? ""),
       ...entry.workflowStatus ? { workflowStatus: String(entry.workflowStatus) } : {},
-      ...entry.data && typeof entry.data === "object" ? { data: entry.data } : {}
+      ...sanitizeEntryData(entry.data) ? { data: sanitizeEntryData(entry.data) } : {}
     };
   });
   const total = structuredEntries.length;
@@ -601,7 +630,8 @@ async function handleList(collection, status, tag, label) {
   const formatted = entries.map((e) => {
     const id = e.entryId ? `**${e.entryId}:** ` : "";
     const statusDisplay = e.workflowStatus ? `${e.status} / ${e.workflowStatus}` : e.status;
-    const dataPreview = e.data ? Object.entries(e.data).slice(0, 4).map(([k, v]) => `  ${k}: ${typeof v === "string" ? v.substring(0, 120) : JSON.stringify(v)}`).join("\n") : "";
+    const visibleData = sanitizeEntryData(e.data);
+    const dataPreview = visibleData ? Object.entries(visibleData).slice(0, 4).map(([k, v]) => `  ${k}: ${typeof v === "string" ? v.substring(0, 120) : JSON.stringify(v)}`).join("\n") : "";
     return `- ${id}${e.name} \`${statusDisplay}\`${dataPreview ? `
 ${dataPreview}` : ""}`;
   }).join("\n\n");
@@ -1009,13 +1039,14 @@ function registerRelationsTools(server) {
 }
 async function handleCreate(from, to, type, score) {
   requireWriteAccess();
+  const agentSessionId = getAgentSessionId();
   const result = await mcpMutation("chain.createEntryRelation", {
     fromEntryId: from,
     toEntryId: to,
     type,
-    suggestionScore: score ?? void 0
+    suggestionScore: score ?? void 0,
+    sessionId: agentSessionId ?? void 0
   });
-  await recordSessionActivity({ relationCreated: result?.status !== "proposal_created" });
   const wsCtx = await getWorkspaceContext();
   if (result?.status === "proposal_created") {
     const existingNote = result.existing ? " (existing proposal reused)" : "";
@@ -1035,32 +1066,49 @@ The relation was **not applied** \u2014 it will be created when the proposal is
       }],
       structuredContent: success(
         `Proposal created for ${from} \u2192 ${to} (${type}). Awaiting consent.`,
-        { status: "proposal_created", from, to, type, proposalId: result.proposalId },
-        [{ tool: "entries", description: "Check proposal", parameters: { action: "get", entryId: result.proposalId } }]
+        { status: "proposal_created", from, to, type, proposalId: result.proposalId }
       )
     };
   }
+  const lines = [
+    `# Relation Created`,
+    "",
+    `**${from}** \u2014[${type}]\u2192 **${to}**`,
+    `**Workspace:** ${wsCtx.workspaceSlug} (${wsCtx.workspaceId})`
+  ];
+  const suggested = result?.suggestedType;
+  if (suggested) {
+    lines.push("");
+    lines.push(`**Type suggestion:** \`${suggested.type}\` may be more precise (${suggested.confidence}% confidence).`);
+    lines.push(`_${suggested.reasoning}_`);
+    lines.push(`To use instead: \`relations action=create from="${from}" to="${to}" type="${suggested.type}"\``);
+  }
   return {
-    content: [{ type: "text", text: `# Relation Created
-
-**${from}** \u2014[${type}]\u2192 **${to}**
-**Workspace:** ${wsCtx.workspaceSlug} (${wsCtx.workspaceId})` }],
+    content: [{ type: "text", text: lines.join("\n") }],
     structuredContent: success(
       `Created relation ${from} \u2192 ${to} (${type}).`,
-      { status: "created", from, to, type },
+      {
+        status: "created",
+        from,
+        to,
+        type,
+        ...suggested && { suggestedType: suggested }
+      },
       [{ tool: "graph", description: "See connections", parameters: { action: "find", entryId: from } }]
     )
   };
 }
 async function handleBatchCreate(relations) {
   requireWriteAccess();
+  const agentSessionId = getAgentSessionId();
   const results = [];
   for (const rel of relations) {
     try {
       const result = await mcpMutation("chain.createEntryRelation", {
         fromEntryId: rel.from,
         toEntryId: rel.to,
-        type: rel.type
+        type: rel.type,
+        sessionId: agentSessionId ?? void 0
       });
       results.push({
         ...rel,
@@ -1075,9 +1123,6 @@ async function handleBatchCreate(relations) {
   const created = results.filter((r) => r.ok && !r.proposalCreated);
   const proposals = results.filter((r) => r.ok && r.proposalCreated);
   const failed = results.filter((r) => !r.ok);
-  for (let i = 0; i < created.length; i++) {
-    await recordSessionActivity({ relationCreated: true });
-  }
   const lines = [`# Batch Link Results
 `];
   lines.push(`**${created.length}** created, **${proposals.length}** proposals, **${failed.length}** failed out of ${relations.length} total.
@@ -1141,6 +1186,12 @@ function annotateStaleNames(text) {
   const footnote = translateStaleToolNames(text);
   return footnote ? text + footnote : text;
 }
+function epistemicCollectionHint(collectionName) {
+  const lc = collectionName.toLowerCase();
+  if (lc === "insights") return " \u2014 _verify confidence with `entries action=get`_";
+  if (lc === "assumptions") return " \u2014 _check evidence strength with `entries action=get`_";
+  return "";
+}
 var CONTEXT_ACTIONS = ["gather", "build"];
 var contextSchema = z5.object({
   action: z5.enum(CONTEXT_ACTIONS).describe(
@@ -1233,7 +1284,7 @@ Use \`graph action=suggest\` to discover potential connections.`
       ""
     ];
     for (const [collName, entries] of byCollection2) {
-      lines2.push(`## ${collName} (${entries.length})`);
+      lines2.push(`## ${collName} (${entries.length})${epistemicCollectionHint(collName)}`);
       for (const e of entries) {
         const arrow = e.relationDirection === "outgoing" ? "\u2192" : "\u2190";
         const id = e.entryId ? `${e.entryId}: ` : "";
@@ -1315,7 +1366,7 @@ _Consider capturing domain knowledge discovered during this task via \`capture\`
       ""
     ];
     for (const [collName, entries] of byCollection2) {
-      lines2.push(`### ${collName} (${entries.length})`);
+      lines2.push(`### ${collName} (${entries.length})${epistemicCollectionHint(collName)}`);
       for (const e of entries) {
         const arrow = e.relationDirection === "outgoing" ? "\u2192" : "\u2190";
         const id = e.entryId ? `**${e.entryId}:** ` : "";
@@ -1378,7 +1429,7 @@ Use \`graph action=suggest\` to discover potential connections, or \`relations a
     ""
   ];
   for (const [collName, entries] of byCollection) {
-    lines.push(`## ${collName} (${entries.length})`);
+    lines.push(`## ${collName} (${entries.length})${epistemicCollectionHint(collName)}`);
     for (const e of entries) {
       const arrow = e.relationDirection === "outgoing" ? "\u2192" : "\u2190";
       const hopLabel = e.hop > 1 ? ` (hop ${e.hop})` : "";
@@ -1995,17 +2046,27 @@ async function runWrapupReview() {
 async function runWrapupCommitAll(data, cachedSuggestions) {
   requireWriteAccess();
   const sessionId = getAgentSessionId();
-  if (!sessionId) return "No active session.";
+  if (!sessionId) {
+    return { text: "No active session.", committed: 0, proposalsCreated: 0, linksCreated: 0, failed: 0 };
+  }
   const results = [];
   let linksCreated = 0;
+  let proposalsCreated = 0;
   for (const draft of data.drafts) {
     try {
-      await mcpMutation("chain.commitEntry", {
+      const result = await mcpMutation("chain.commitEntry", {
         entryId: draft.entryId,
-        author: "agent (wrapup)"
+        author: `agent:${sessionId}`,
+        sessionId
       });
-      await recordSessionActivity({ entryModified: draft.docId });
-      results.push({ entryId: draft.entryId, ok: true });
+      const proposed = result?.status === "proposal_created";
+      if (!proposed) {
+        await recordSessionActivity({ entryModified: draft.docId });
+      }
+      if (proposed) {
+        proposalsCreated++;
+      }
+      results.push({ entryId: draft.entryId, ok: true, proposed });
     } catch (err) {
       const msg = err instanceof Error ? err.message : String(err);
       results.push({ entryId: draft.entryId, ok: false, error: msg });
@@ -2016,19 +2077,25 @@ async function runWrapupCommitAll(data, cachedSuggestions) {
       (e) => (data.connectionCounts[e.entryId] ?? 0) < 2
     ).slice(0, 10)
   );
-  for (const s of suggestionsToApply.slice(0, 15)) {
+  const linkableSourceIds = /* @__PURE__ */ new Set([
+    ...data.committed.map((entry) => entry.entryId),
+    ...results.filter((r) => r.ok && !r.proposed).map((r) => r.entryId)
+  ]);
+  for (const s of suggestionsToApply.filter((s2) => linkableSourceIds.has(s2.fromEntryId)).slice(0, 15)) {
     try {
-      await mcpMutation("chain.createEntryRelation", {
+      const result = await mcpMutation("chain.createEntryRelation", {
         fromEntryId: s.fromEntryId,
         toEntryId: s.toEntryId,
-        type: s.type
+        type: s.type,
+        sessionId
       });
-      await recordSessionActivity({ relationCreated: true });
-      linksCreated++;
+      if (result?.status !== "proposal_created") {
+        linksCreated++;
+      }
     } catch {
     }
   }
-  const committed = results.filter((r) => r.ok).length;
+  const committed = results.filter((r) => r.ok && !r.proposed).length;
   const failed = results.filter((r) => !r.ok);
   await mcpCall("agent.recordWrapup", {
     sessionId,
@@ -2039,7 +2106,7 @@ async function runWrapupCommitAll(data, cachedSuggestions) {
   const lines = [
     "## Wrapup Complete",
     "",
-    `**${committed}** drafts committed, **${linksCreated}** links created.`
+    `**${committed}** drafts committed, **${proposalsCreated}** proposals created, **${linksCreated}** links created.`
   ];
   if (failed.length > 0) {
     lines.push("");
@@ -2049,7 +2116,13 @@ async function runWrapupCommitAll(data, cachedSuggestions) {
     }
     lines.push("_These remain as drafts for next session._");
   }
-  return lines.join("\n");
+  return {
+    text: lines.join("\n"),
+    committed,
+    proposalsCreated,
+    linksCreated,
+    failed: failed.length
+  };
 }
 var WRAPUP_TOOL_DESCRIPTION = "Review your session before closing. Shows uncommitted drafts with quality scores, suggests links for low-connection entries, and offers batch commit. Run this before `session action=close` to ensure nothing is left behind. If you call `session action=close` without running wrapup first, you'll get a review-only nudge.";
 var wrapupSchema = z8.object({
@@ -2060,6 +2133,7 @@ var wrapupSchema = z8.object({
 function registerWrapupTools(server) {
   let lastReviewData = null;
   let lastReviewSuggestions = [];
+  let lastReviewSessionId = null;
   const wrapupHandler = async ({ action }) => {
     if (action === "commit-all") {
       const sessionId = getAgentSessionId();
@@ -2072,18 +2146,30 @@ function registerWrapupTools(server) {
           [{ tool: "session", description: "Start a session", parameters: { action: "start" } }]
         );
       }
-      const data2 = lastReviewData ?? await mcpCall("agent.getSessionWrapup", { sessionId });
+      const useCachedReview = lastReviewSessionId === sessionId;
+      const data2 = useCachedReview && lastReviewData ? lastReviewData : await mcpCall("agent.getSessionWrapup", { sessionId });
       if (data2.drafts.length === 0) {
         return failureResult("No uncommitted drafts to commit.", "NOT_FOUND", "No uncommitted drafts to commit.", "Nothing to commit.");
       }
-      const result = await runWrapupCommitAll(data2, lastReviewSuggestions);
+      const result = await runWrapupCommitAll(data2, useCachedReview ? lastReviewSuggestions : []);
       lastReviewData = null;
       lastReviewSuggestions = [];
-      return successResult(result, "Wrapup complete. Committed drafts and created links.", { committed: true });
+      lastReviewSessionId = null;
+      return successResult(
+        result.text,
+        `Wrapup processed: ${result.committed} committed, ${result.proposalsCreated} proposals, ${result.linksCreated} links.`,
+        {
+          committed: result.committed,
+          proposalsCreated: result.proposalsCreated,
+          linksCreated: result.linksCreated,
+          failed: result.failed
+        }
+      );
     }
     const { text, data, suggestions, failureCode } = await runWrapupReview();
     lastReviewData = data;
     lastReviewSuggestions = suggestions;
+    lastReviewSessionId = getAgentSessionId();
     const fullText = data && (data.drafts.length > 0 || data.committed.length > 0) ? `## Session Wrapup
 
 ${text}` : text;
@@ -3915,16 +4001,11 @@ function computeCommitBlockers(opts) {
   const { betEntryId, betDocId, relations, hasStrategyLink, betData, sessionDrafts } = opts;
   const blockers = [];
   const str = (key) => (betData[key] ?? "").trim();
-  const hasDirectionalCommitsTo = relations.some((r) => {
-    if (r.type !== "commits_to") return false;
-    return r.fromId === betDocId && r.toId !== betDocId;
-  });
-  const strategyLinked = hasStrategyLink ?? hasDirectionalCommitsTo;
-  if (!strategyLinked) {
+  if (!hasStrategyLink) {
     blockers.push({
       entryId: betEntryId,
       blocker: "Missing strategy link",
-      fix: `relations action=create from=${betEntryId} to=<strategy> type=commits_to`
+      fix: `relations action=create from=${betEntryId} to=<strategy> type=related_to`
     });
   }
   const MIN_FIELD_LENGTH = 20;
@@ -4028,6 +4109,21 @@ var facilitateSchema = z12.object({
     z12.array(captureItemSchema).max(15)
   ]).optional().describe("Entry or entries to capture alongside the respond action. Accepts a single object or an array (max 15) for batch capture.")
 });
+async function hasStrategyLinkForEntry(entryDocId, relations) {
+  const relatedDocIds = /* @__PURE__ */ new Set();
+  for (const rel of relations) {
+    if (rel.fromId === entryDocId && rel.toId) relatedDocIds.add(rel.toId);
+    if (rel.toId === entryDocId && rel.fromId) relatedDocIds.add(rel.fromId);
+  }
+  for (const docId of relatedDocIds) {
+    try {
+      const related = await mcpQuery("chain.getEntry", { id: docId });
+      if (related?.collectionSlug === "strategy") return true;
+    } catch {
+    }
+  }
+  return false;
+}
 function registerFacilitateTools(server) {
   server.registerTool(
     "facilitate",
@@ -4332,7 +4428,7 @@ async function searchChain(text, opts = {}) {
     return [];
   }
 }
-async function findAndLinkExisting(name, collectionSlug, betEntryId, relationType) {
+async function findAndLinkExisting(name, collectionSlug, betEntryId, relationType, agentSessionId) {
   try {
     const results = await mcpQuery(
       "chain.searchEntries",
@@ -4346,9 +4442,9 @@ async function findAndLinkExisting(name, collectionSlug, betEntryId, relationTyp
       await mcpMutation("chain.createEntryRelation", {
         fromEntryId: match.entryId,
         toEntryId: betEntryId,
-        type: relationType
+        type: relationType,
+        sessionId: agentSessionId ?? void 0
       });
-      await recordSessionActivity({ relationCreated: true });
       return { entryId: match.entryId, linked: true };
     } catch {
       return { entryId: match.entryId, linked: false };
@@ -4461,7 +4557,6 @@ async function processCaptures(opts) {
       );
       capturedEntryId = result.entryId;
       entriesCreated.push(result.entryId);
-      await recordSessionActivity({ entryCreated: result.docId });
     } catch (createErr) {
       const msg = createErr instanceof Error ? createErr.message : String(createErr);
       if (msg.includes("Duplicate entry") || msg.includes("already exists")) {
@@ -4469,7 +4564,8 @@ async function processCaptures(opts) {
           item.name,
           mapping.slug,
           betEntryId,
-          mapping.relationType
+          mapping.relationType,
+          capAgentId
         );
         if (fallback) {
           capturedEntryId = fallback.entryId;
@@ -4491,10 +4587,10 @@ async function processCaptures(opts) {
       await mcpMutation("chain.createEntryRelation", {
         fromEntryId: capturedEntryId,
         toEntryId: betEntryId,
-        type: mapping.relationType
+        type: mapping.relationType,
+        sessionId: capAgentId ?? void 0
       });
       relationsCreated++;
-      await recordSessionActivity({ relationCreated: true });
     } catch (relErr) {
       const msg = relErr instanceof Error ? relErr.message : String(relErr);
       if (!msg.includes("already exists") && !msg.includes("Duplicate")) {
@@ -4673,10 +4769,15 @@ async function computeAndUpdateScores(opts) {
   }
   let commitBlockers;
   if (captureReady) {
+    const hasStrategyLink = await hasStrategyLinkForEntry(
+      refreshedBet?._id ?? betEntry._id,
+      refreshedConstellation.relations
+    );
     commitBlockers = computeCommitBlockers({
       betEntryId,
       betDocId: refreshedBet?._id ?? betEntry._id,
       relations: refreshedConstellation.relations,
+      hasStrategyLink,
       betData: refreshedData,
       sessionDrafts
     });
@@ -4841,7 +4942,6 @@ async function handleRespond(args) {
         }
       );
       betId = result.entryId;
-      await recordSessionActivity({ entryCreated: result.docId });
     } catch (err) {
       const msg = err instanceof Error ? err.message : String(err);
       return {
@@ -4977,10 +5077,12 @@ async function handleScore(args) {
     lines.push("");
     lines.push(`**Session drafts (${sessionDrafts.length}):** ${sessionDrafts.map((d) => `\`${d.entryId}\` ${d.name}`).join(", ")}`);
   }
+  const hasStrategyLink = await hasStrategyLinkForEntry(betEntry._id, constellation.relations);
   const commitBlockers = computeCommitBlockers({
     betEntryId: betId,
     betDocId: betEntry._id,
     relations: constellation.relations,
+    hasStrategyLink,
     betData,
     sessionDrafts
   });
@@ -5154,21 +5256,7 @@ async function handleCommitConstellation(args) {
   const relations = await mcpQuery("chain.listEntryRelations", {
     entryId: betId
   });
-  const hasStrategyLink = await (async () => {
-    const relatedDocIds = /* @__PURE__ */ new Set();
-    for (const rel of relations) {
-      if (rel.fromId === betEntry._id && rel.toId) relatedDocIds.add(rel.toId);
-      if (rel.toId === betEntry._id && rel.fromId) relatedDocIds.add(rel.fromId);
-    }
-    for (const docId of relatedDocIds) {
-      try {
-        const related = await mcpQuery("chain.getEntry", { id: docId });
-        if (related?.collectionSlug === "strategy") return true;
-      } catch {
-      }
-    }
-    return false;
-  })();
+  const hasStrategyLink = await hasStrategyLinkForEntry(betEntry._id, relations);
   const sessionDrafts = await loadSessionDrafts(betId, betEntry._id);
   const commitBlockerItems = computeCommitBlockers({
     betEntryId: betId,
@@ -5207,7 +5295,7 @@ async function handleCommitConstellation(args) {
   }
   let contradictionWarnings = [];
   try {
-    const { runContradictionCheck } = await import("./smart-capture-XLBFE252.js");
+    const { runContradictionCheck } = await import("./smart-capture-2IM2565I.js");
     const descField = betData.problem ?? betData.description ?? "";
     contradictionWarnings = await runContradictionCheck(
       betEntry.name ?? betId,
@@ -5268,12 +5356,11 @@ No constellation entries were committed.`
   const lines = [];
   const hasIssues = result.failedIds.length > 0 || result.conflictIds.length > 0;
   if (result.proposalCreated) {
-    const linkedCount = result.committedIds.filter((id) => id !== betId).length;
     lines.push(
       hasIssues ? `# Proposal created with issues` : `# Proposal created`,
       "",
       `Workspace uses consent-based governance. \`${betId}\` was submitted as a proposal \u2014 it will be committed when approved.`,
-      `**${linkedCount} linked entries** were committed directly (proposals apply to the bet only).`
+      `No linked entries were committed because the bet itself is still awaiting approval.`
     );
   } else {
     lines.push(
@@ -5284,7 +5371,13 @@ No constellation entries were committed.`
     );
   }
   if (contradictionWarnings.length > 0) {
-    lines.push("", `\u26A0 **Contradiction warnings** (advisory):`, ...contradictionWarnings.map((w) => `- ${w}`));
+    lines.push(
+      "",
+      `\u26A0 **Contradiction warnings** (advisory):`,
+      ...contradictionWarnings.map(
+        (w) => `- \`${w.entryId}\` ${w.name} [${w.collection}] (${w.governsCount} governs relation${w.governsCount === 1 ? "" : "s"})`
+      )
+    );
   }
   if (result.committedIds.length > 0) {
     lines.push("", `**Committed:** ${result.committedIds.join(", ")}`);
@@ -5762,35 +5855,39 @@ function listPresets() {
 }
 
 // src/tools/planned-work.ts
-async function queryPlannedWork() {
+function buildPlannedWork(allEntries) {
   const result = {
     uncommittedDrafts: [],
     inProgressEntries: [],
     openTensions: []
   };
+  for (const entry of allEntries) {
+    if (entry.stratum === "system") continue;
+    const collection = entry.collectionSlug ?? entry.collection ?? "unknown";
+    if (entry.status === "draft") {
+      result.uncommittedDrafts.push({ name: entry.name, collection });
+    }
+    if (collection === "tensions" && entry.workflowStatus === "open") {
+      result.openTensions.push({ name: entry.name, entryId: entry.entryId ?? entry._id });
+    }
+    if (entry.workflowStatus === "in-progress") {
+      result.inProgressEntries.push({
+        name: entry.name,
+        collection,
+        entryId: entry.entryId ?? entry._id
+      });
+    }
+  }
+  return result;
+}
+async function queryPlannedWork() {
   try {
     const allEntries = await mcpQuery("chain.listEntries", {});
-    if (!allEntries) return result;
-    for (const entry of allEntries) {
-      if (entry.stratum === "system") continue;
-      const collection = entry.collectionSlug ?? entry.collection ?? "unknown";
-      if (entry.status === "draft") {
-        result.uncommittedDrafts.push({ name: entry.name, collection });
-      }
-      if (collection === "tensions" && entry.workflowStatus === "open") {
-        result.openTensions.push({ name: entry.name, entryId: entry.entryId ?? entry._id });
-      }
-      if (entry.workflowStatus === "in-progress") {
-        result.inProgressEntries.push({
-          name: entry.name,
-          collection,
-          entryId: entry.entryId ?? entry._id
-        });
-      }
-    }
+    if (!allEntries) return { uncommittedDrafts: [], inProgressEntries: [], openTensions: [] };
+    return buildPlannedWork(allEntries);
   } catch {
+    return { uncommittedDrafts: [], inProgressEntries: [], openTensions: [] };
   }
-  return result;
 }
 function hasPlannedWork(work) {
   return work.uncommittedDrafts.length > 0 || work.inProgressEntries.length > 0 || work.openTensions.length > 0;
@@ -7694,1960 +7791,2154 @@ Use \`map-slot action=add mapEntryId="${mapEntryId}" slotId="..." ingredientEntr
 }
 
 // src/tools/architecture.ts
-import { existsSync as existsSync2, readFileSync as readFileSync2, readdirSync, statSync } from "fs";
-import { resolve as resolve2, relative, dirname, normalize } from "path";
+import { existsSync as existsSync3, readFileSync as readFileSync2, readdirSync, statSync } from "fs";
+import { resolve as resolve3, relative, dirname as dirname2, normalize } from "path";
 import { z as z19 } from "zod";
-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" }
+
+// 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 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 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;
     }
-    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
-  });
-}
-async function listArchEntries() {
-  return mcpQuery("chain.listEntries", { collectionSlug: COLLECTION_SLUG });
-}
-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));
+  return null;
 }
-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("");
+function renderMissingUiView(uri) {
   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>`;
+<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>`;
 }
-function escHtml(s) {
-  return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+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 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 ?? ""}
+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.
 
-${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"])
+` + 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."
+    );
   }
-};
-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}
+  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\`.
 
-${textLayers}${textFlows}`;
-        const html = renderArchitectureHtml(layers, nodes, flows, templateName);
-        return {
-          content: [
-            { type: "text", text },
-            { type: "resource", resource: { uri: `ui://product-os/architecture`, mimeType: "text/html", 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
+` + 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
 
-${target.data?.description ?? ""}${depRule}${layerRationale}
-**${nodes.length} components**
+## 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 |
 
-${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
+## 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)
 
-**Created:** ${created} entries
-**Updated:** ${updated} (merged new fields)
-**Unchanged:** ${unchanged}
+## 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
 
-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"]);
+## 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"
+      }]
     })
   );
-  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);
-          }
+  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.");
       }
-    }
-    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);
+      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.");
       }
+      return {
+        contents: [{ uri: uri.href, text: lines.join("\n\n---\n\n"), mimeType: "text/markdown" }]
+      };
     }
-    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 (!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);
+  );
+  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" }]
+      };
     }
-  };
-  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]);
+  );
+  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"
+        }]
+      };
     }
-    return imports;
-  } catch {
-    return [];
-  }
-}
-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;
-}
-function resolveImport(imp, fromFile, root) {
-  let rel = null;
-  if (imp.startsWith("$lib/")) rel = imp.replace("$lib/", "src/lib/");
-  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 = dirname(fromFile);
-    const abs2 = resolve2(fromDir, imp);
-    rel = relative(root, abs2);
-  }
-  if (!rel) return null;
-  const abs = resolve2(root, rel);
-  const actual = tryResolveWithExtension(abs);
-  return actual ? relative(root, actual) : rel;
-}
-function findNodeByPath(filePath, prefixes) {
-  const normalized = normalize(filePath);
-  for (const { prefix, node } of prefixes) {
-    if (normalized.startsWith(prefix)) return node;
-  }
-  return null;
-}
-function formatScanReport(result) {
-  const lines = [];
-  if (result.violations.length === 0) {
-    lines.push(
-      `# Architecture Health Check Passed`,
-      "",
-      `**0 violations** across ${result.filesScanned} files (${result.importsChecked} imports checked, ${result.unmappedImports} unmapped).`,
-      "",
-      "All imports respect the layer dependency rules."
-    );
-  } else {
-    lines.push(
-      `# Architecture Health Check \u2014 ${result.violations.length} Violation${result.violations.length === 1 ? "" : "s"}`,
-      "",
-      `Scanned ${result.filesScanned} files, checked ${result.importsChecked} imports, found **${result.violations.length} violation${result.violations.length === 1 ? "" : "s"}** (${result.unmappedImports} unmapped).`,
-      ""
-    );
-    const byNode = /* @__PURE__ */ new Map();
-    for (const v of result.violations) {
-      if (!byNode.has(v.sourceNode)) byNode.set(v.sourceNode, []);
-      byNode.get(v.sourceNode).push(v);
+  );
+  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 (ungrouped.length > 0) {
+        lines.push("## Ungrouped");
+        for (const l of ungrouped) {
+          lines.push(`- \`${l.slug}\` ${l.name}${l.color ? ` (${l.color})` : ""}`);
+        }
+      }
+      return {
+        contents: [{ uri: uri.href, text: `# Workspace Labels (${labels.length})
+
+${lines.join("\n")}`, mimeType: "text/markdown" }]
+      };
     }
-    for (const [nodeName, vs] of byNode) {
-      lines.push(`## ${nodeName} (${vs[0].sourceLayer})`);
-      for (const v of vs) {
-        lines.push(`- \`${v.sourceFile}\` imports \`${v.importPath}\` \u2192 **${v.targetNode}** (${v.targetLayer}) \u2014 ${v.rule}`);
+  );
+  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);
+        }
       }
-      lines.push("");
+    }),
+    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}`);
+          }
+        }
+        lines.push("");
+      }
+      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 (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" }]
+      };
     }
-  }
-  lines.push("---", "");
-  const nodeEntries = [...result.nodeResults.entries()];
-  const cleanCount = nodeEntries.filter(([, r]) => r.violations.length === 0 && r.filesScanned > 0).length;
-  const dirtyCount = nodeEntries.filter(([, r]) => r.violations.length > 0).length;
-  const emptyCount = nodeEntries.filter(([, r]) => r.filesScanned === 0).length;
-  lines.push(
-    `**Summary:** ${cleanCount} clean nodes, ${dirtyCount} with violations, ${emptyCount} with no files.`
   );
-  return lines.join("\n");
-}
-
-// src/tools/health.ts
-var CALL_CATEGORIES = {
-  "chain.getEntry": "read",
-  "chain.batchGetEntries": "read",
-  "chain.listEntries": "read",
-  "chain.listEntryHistory": "read",
-  "chain.listEntryRelations": "read",
-  "chain.listEntriesByLabel": "read",
-  "chain.searchEntries": "search",
-  "chain.createEntry": "write",
-  "chain.updateEntry": "write",
-  "chain.createEntryRelation": "write",
-  "chain.applyLabel": "label",
-  "chain.removeLabel": "label",
-  "chain.createLabel": "label",
-  "chain.updateLabel": "label",
-  "chain.deleteLabel": "label",
-  "chain.createCollection": "write",
-  "chain.updateCollection": "write",
-  "chain.listCollections": "meta",
-  "chain.getCollection": "meta",
-  "chain.listLabels": "meta",
-  "resolveWorkspace": "meta"
-};
-function categorize(fn) {
-  return CALL_CATEGORIES[fn] ?? "meta";
-}
-function formatDuration(ms) {
-  if (ms < 6e4) return `${Math.round(ms / 1e3)}s`;
-  const mins = Math.floor(ms / 6e4);
-  const secs = Math.round(ms % 6e4 / 1e3);
-  return `${mins}m ${secs}s`;
-}
-function buildSessionSummary(log) {
-  if (log.length === 0) return "";
-  const byCategory = /* @__PURE__ */ new Map();
-  let errorCount = 0;
-  let writeCreates = 0;
-  let writeUpdates = 0;
-  for (const entry of log) {
-    const cat = categorize(entry.fn);
-    if (!byCategory.has(cat)) byCategory.set(cat, /* @__PURE__ */ new Map());
-    const fnCounts = byCategory.get(cat);
-    fnCounts.set(entry.fn, (fnCounts.get(entry.fn) ?? 0) + 1);
-    if (entry.status === "error") errorCount++;
-    if (entry.fn === "chain.createEntry" && entry.status === "ok") writeCreates++;
-    if (entry.fn === "chain.updateEntry" && entry.status === "ok") writeUpdates++;
-  }
-  const firstTs = new Date(log[0].ts).getTime();
-  const lastTs = new Date(log[log.length - 1].ts).getTime();
-  const duration = formatDuration(lastTs - firstTs);
-  const lines = [`# Session Summary (${duration})
-`];
-  const categoryLabels = [
-    ["read", "Reads"],
-    ["search", "Searches"],
-    ["write", "Writes"],
-    ["label", "Labels"],
-    ["meta", "Meta"]
-  ];
-  for (const [cat, label] of categoryLabels) {
-    const fnCounts = byCategory.get(cat);
-    if (!fnCounts || fnCounts.size === 0) continue;
-    const total = [...fnCounts.values()].reduce((a, b) => a + b, 0);
-    const detail = [...fnCounts.entries()].sort((a, b) => b[1] - a[1]).map(([fn, count]) => `${fn.replace("chain.", "")} x${count}`).join(", ");
-    lines.push(`- **${label}:** ${total} call${total === 1 ? "" : "s"} (${detail})`);
-  }
-  lines.push(`- **Errors:** ${errorCount}`);
-  if (writeCreates > 0 || writeUpdates > 0) {
-    lines.push("");
-    lines.push("## Knowledge Contribution");
-    if (writeCreates > 0) lines.push(`- ${writeCreates} entr${writeCreates === 1 ? "y" : "ies"} created`);
-    if (writeUpdates > 0) lines.push(`- ${writeUpdates} entr${writeUpdates === 1 ? "y" : "ies"} updated`);
-  }
-  return lines.join("\n");
-}
-function extractSessionEntryIds(priorSessions) {
-  const allSeen = /* @__PURE__ */ new Set();
-  const all = [];
-  let lastSessionOnly = [];
-  for (let i = 0; i < priorSessions.length; i++) {
-    const s = priorSessions[i];
-    const ids = [...s.entriesCreated ?? [], ...s.entriesModified ?? []].filter((id) => id);
-    if (i === 0) {
-      lastSessionOnly = [...new Set(ids)].slice(0, 5);
-    }
-    for (const id of ids) {
-      if (!allSeen.has(id)) {
-        allSeen.add(id);
-        all.push(id);
-        if (all.length >= 10) break;
+  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}`);
+        }
+        lines.push("");
+      }
+      return {
+        contents: [{ uri: uri.href, text: lines.join("\n"), mimeType: "text/markdown" }]
+      };
     }
-    if (all.length >= 10) break;
-  }
-  return { all, lastSessionOnly };
-}
-async function handleHealthCheck() {
-  const start = Date.now();
-  const errors = [];
-  let workspaceId;
-  try {
-    workspaceId = await getWorkspaceId();
-  } catch (e) {
-    errors.push(`Workspace resolution failed: ${e instanceof Error ? e.message : String(e)}`);
-  }
-  let collections = [];
-  try {
-    collections = await mcpQuery("chain.listCollections");
-  } catch (e) {
-    errors.push(`Collection fetch failed: ${e instanceof Error ? e.message : String(e)}`);
-  }
-  let totalEntries = 0;
-  if (collections.length > 0) {
-    try {
-      const entries = await mcpQuery("chain.listEntries", {});
-      totalEntries = entries.length;
-    } catch (e) {
-      errors.push(`Entry count failed: ${e instanceof Error ? e.message : String(e)}`);
-    }
-  }
-  let wsCtx = null;
-  try {
-    wsCtx = await getWorkspaceContext();
-  } catch {
-  }
-  const durationMs = Date.now() - start;
-  const healthy = errors.length === 0;
-  const lines = [
-    `# ${healthy ? "Healthy" : "Degraded"}`,
-    "",
-    `**Workspace:** ${workspaceId ?? "unresolved"}`,
-    `**Workspace Slug:** ${wsCtx?.workspaceSlug ?? "unknown"}`,
-    `**Workspace Name:** ${wsCtx?.workspaceName ?? "unknown"}`,
-    `**Collections:** ${collections.length}`,
-    `**Entries:** ${totalEntries}`,
-    `**Latency:** ${durationMs}ms`
-  ];
-  if (errors.length > 0) {
-    lines.push("", "## Errors");
-    for (const err of errors) {
-      lines.push(`- ${err}`);
-    }
-  }
-  const healthData = {
-    healthy,
-    collections: collections.length,
-    entries: totalEntries,
-    latencyMs: durationMs,
-    workspace: workspaceId ?? "unresolved"
-  };
-  return {
-    content: [{ type: "text", text: lines.join("\n") }],
-    structuredContent: success(
-      healthy ? `Healthy. ${collections.length} collections, ${totalEntries} entries, ${durationMs}ms.` : `Degraded. ${errors.length} error(s).`,
-      healthData
-    )
-  };
-}
-async function handleWhoami() {
-  const ctx = await getWorkspaceContext();
-  const sessionId = getAgentSessionId();
-  const scope = getApiKeyScope();
-  const oriented = isSessionOriented();
-  const lines = [
-    `# Session Identity`,
-    "",
-    `**Workspace ID:** ${ctx.workspaceId}`,
-    `**Workspace Slug:** ${ctx.workspaceSlug}`,
-    `**Workspace Name:** ${ctx.workspaceName}`
-  ];
-  return {
-    content: [{ type: "text", text: lines.join("\n") }],
-    structuredContent: success(
-      `Session: ${ctx.workspaceName} (${scope}). ${oriented ? "Oriented." : "Not oriented."}`,
-      { workspaceId: ctx.workspaceId, workspaceName: ctx.workspaceName, scope, sessionId, oriented }
-    )
-  };
-}
-var STAGE_LABELS = {
-  blank: "Blank",
-  seeded: "Seeded",
-  grounded: "Grounded",
-  connected: "Connected"
-};
-var STAGE_DESCRIPTIONS = {
-  blank: "No knowledge captured yet.",
-  seeded: "Early knowledge is in place \u2014 keep building.",
-  grounded: "Solid foundations \u2014 a few gaps remain.",
-  connected: "Well-connected knowledge graph \u2014 your Brain is useful."
-};
-async function handleWorkspaceStatus() {
-  const result = await mcpQuery("chain.workspaceReadiness");
-  const { score, totalChecks, passedChecks, checks, gaps, stats, governanceMode } = result;
-  const scoringVersion = result.scoringVersion ?? "v1";
-  const stage = result.stage ?? "seeded";
-  const stageLabel = STAGE_LABELS[stage] ?? stage;
-  const stageDescription = STAGE_DESCRIPTIONS[stage] ?? "";
-  const scoreBar = "\u2588".repeat(Math.round(score / 10)) + "\u2591".repeat(10 - Math.round(score / 10));
-  const lines = [
-    `# Brain Status: ${stageLabel}`,
-    `_${stageDescription}_`,
-    "",
-    `${scoreBar} ${stageLabel} \xB7 ${score}%`,
-    `**Governance:** ${governanceMode ?? "open"}${(governanceMode ?? "open") !== "open" ? " (commits require proposal)" : ""}`,
-    "",
-    "## Stats",
-    `- **Entries:** ${stats.totalEntries} (${stats.activeCount} active, ${stats.draftCount} draft)`,
-    `- **Relations:** ${stats.totalRelations}`,
-    `- **Collections:** ${stats.collectionCount}`,
-    `- **Orphaned:** ${stats.orphanedCount} committed entries with no relations`,
-    ""
-  ];
-  if (gaps.length > 0) {
-    lines.push("## Gaps");
-    for (const gap of gaps) {
-      const action = gap.capabilityGuidance ?? gap.guidance;
-      lines.push(`- [ ] **${gap.label}**`);
-      lines.push(`  _${action}_`);
-    }
-    lines.push("");
-  }
-  const passed = checks.filter((c) => c.passed);
-  if (passed.length > 0) {
-    lines.push("## Passing checks");
-    for (const check of passed) {
-      lines.push(`- [x] ${check.label} (${check.current}/${check.required})`);
-    }
-  }
-  const statusData = {
-    stage,
-    scoringVersion,
-    readinessScore: score,
-    activeEntries: stats.activeCount,
-    totalRelations: stats.totalRelations,
-    orphanedEntries: stats.orphanedCount,
-    gaps: gaps.map((g) => ({
-      id: g.id,
-      label: g.label,
-      guidance: g.capabilityGuidance ?? g.guidance
-    }))
-  };
-  return {
-    content: [{ type: "text", text: lines.join("\n") }],
-    structuredContent: success(
-      `Brain: ${stageLabel} (${score}%). ${stats.activeCount} active entries, ${gaps.length} gap(s).`,
-      statusData
-    )
-  };
-}
-async function handleAudit(limit) {
-  const log = getAuditLog();
-  const recent = log.slice(-limit);
-  if (recent.length === 0) {
-    return successResult("No calls recorded yet this session.", "No calls recorded yet this session.", { totalCalls: 0, calls: [] });
-  }
-  const summary = buildSessionSummary(log);
-  const logLines = [`# Audit Log (last ${recent.length} of ${log.length} total)
-`];
-  for (const entry of recent) {
-    const icon = entry.status === "ok" ? "\u2713" : "\u2717";
-    const errPart = entry.error ? ` \u2014 ${entry.error}` : "";
-    const toolPart = entry.toolContext ? ` [${entry.toolContext.tool}${entry.toolContext.action ? ` action=${entry.toolContext.action}` : ""}]` : "";
-    logLines.push(`${icon} \`${entry.fn}\`${toolPart} ${entry.durationMs}ms ${entry.status}${errPart}`);
-  }
-  const auditData = {
-    totalCalls: log.length,
-    calls: recent.map((entry) => ({
-      tool: entry.fn,
-      ...entry.toolContext?.action && { action: entry.toolContext.action },
-      timestamp: entry.ts,
-      ...entry.durationMs != null && { durationMs: entry.durationMs }
-    }))
-  };
-  return {
-    content: [{ type: "text", text: `${summary}
-
----
-
-${logLines.join("\n")}` }],
-    structuredContent: success(
-      `Audit: ${log.length} total calls, showing last ${recent.length}.`,
-      auditData
-    )
-  };
-}
-var HEALTH_ACTIONS = ["check", "whoami", "status", "audit", "self-test"];
-var healthSchema = z20.object({
-  action: z20.enum(HEALTH_ACTIONS).describe(
-    "'check': connectivity and workspace stats. 'whoami': session identity. 'status': workspace readiness. 'audit': session audit log. 'self-test': validate all tool schemas."
-  ),
-  limit: z20.number().min(1).max(50).default(20).optional().describe("For audit: how many recent calls to show (max 50)")
-});
-var orientSchema = z20.object({
-  mode: z20.enum(["full", "brief"]).optional().default("full").describe("full = full context (default). brief = compact summary for mid-session re-orientation."),
-  task: z20.string().optional().describe("Natural-language task description for task-scoped context. When provided, orient returns scored, relevant entries for the task.")
-});
-var healthCheckOutputSchema = z20.object({
-  healthy: z20.boolean(),
-  collections: z20.number(),
-  entries: z20.number(),
-  latencyMs: z20.number(),
-  workspace: z20.string()
-});
-var healthStatusOutputSchema = z20.object({
-  // Optional with defaults — older backends that don't return these fields won't fail.
-  stage: z20.enum(["blank", "seeded", "grounded", "connected"]).optional().default("seeded"),
-  scoringVersion: z20.enum(["v1", "v2"]).optional().default("v1"),
-  readinessScore: z20.number(),
-  activeEntries: z20.number(),
-  totalRelations: z20.number(),
-  orphanedEntries: z20.number(),
-  gaps: z20.array(z20.object({ id: z20.string(), label: z20.string(), guidance: z20.string() }))
-});
-var healthAuditOutputSchema = z20.object({
-  totalCalls: z20.number(),
-  calls: z20.array(z20.object({
-    tool: z20.string(),
-    action: z20.string().optional(),
-    timestamp: z20.string(),
-    durationMs: z20.number().optional()
-  }))
-});
-var healthWhoamiOutputSchema = z20.object({
-  workspaceId: z20.string(),
-  workspaceName: z20.string(),
-  scope: z20.string(),
-  sessionId: z20.union([z20.string(), z20.null()]),
-  oriented: z20.boolean()
-});
-var ALL_TOOL_SCHEMAS = [
-  { name: "entries", schema: entriesSchema },
-  { name: "relations", schema: relationsSchema },
-  { name: "graph", schema: graphSchema },
-  { name: "context", schema: contextSchema },
-  { name: "collections", schema: collectionsSchema },
-  { name: "session", schema: sessionSchema },
-  { name: "health", schema: healthSchema },
-  { name: "orient", schema: orientSchema },
-  { name: "quality", schema: qualitySchema },
-  { name: "workflows", schema: workflowsSchema },
-  { name: "session-wrapup", schema: wrapupSchema },
-  { name: "labels", schema: labelsSchema },
-  { name: "verify", schema: verifySchema },
-  { name: "capture", schema: captureSchema },
-  { name: "batch-capture", schema: batchCaptureSchema },
-  { name: "update-entry", schema: updateEntrySchema },
-  { name: "get-history", schema: getHistorySchema },
-  { name: "commit-entry", schema: commitEntrySchema },
-  { name: "start", schema: startSchema },
-  { name: "get-usage-summary", schema: usageSummarySchema },
-  { name: "chain", schema: chainSchema },
-  { name: "chain-version", schema: chainVersionSchema },
-  { name: "chain-branch", schema: chainBranchSchema },
-  { name: "chain-review", schema: chainReviewSchema },
-  { name: "create-audience-map-set", schema: createAudienceMapSetSchema },
-  { name: "map", schema: mapSchema },
-  { name: "map-slot", schema: mapSlotSchema },
-  { name: "map-version", schema: mapVersionSchema },
-  { name: "map-suggest", schema: mapSuggestSchema },
-  { name: "architecture", schema: architectureSchema },
-  { name: "architecture-admin", schema: architectureAdminSchema },
-  { name: "facilitate", schema: facilitateSchema }
-];
-var selfTestOutputSchema = z20.object({
-  passed: z20.number(),
-  failed: z20.number(),
-  total: z20.number(),
-  results: z20.array(z20.object({
-    tool: z20.string(),
-    valid: z20.boolean(),
-    error: z20.string().optional()
-  }))
-});
-function handleSelfTest() {
-  const results = [];
-  for (const { name, schema } of ALL_TOOL_SCHEMAS) {
-    try {
-      if (!schema || typeof schema.safeParse !== "function") {
-        results.push({ tool: name, valid: false, error: "Schema is not a valid Zod object" });
-        continue;
+  );
+  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 test = schema.safeParse({});
-      if (test.success || test.error) {
-        results.push({ tool: name, valid: true });
+      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})`);
       }
-    } catch (e) {
-      results.push({ tool: name, valid: false, error: e instanceof Error ? e.message : String(e) });
+      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
+        }]
+      };
+    });
   }
-  const passed = results.filter((r) => r.valid).length;
-  const failed = results.filter((r) => !r.valid).length;
-  const total = results.length;
-  const lines = [
-    `# Self-Test: Tool Schema Validation`,
-    `**Result:** ${failed === 0 ? "ALL PASS" : `${failed} FAILED`}`,
-    `**Schemas validated:** ${passed}/${total}`,
-    ""
-  ];
-  if (failed > 0) {
-    lines.push("## Failures");
-    for (const r of results.filter((r2) => !r2.valid)) {
-      lines.push(`- **${r.tool}**: ${r.error}`);
+}
+
+// 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
+      });
     }
-    lines.push("");
-  }
-  lines.push("## All Tools");
-  for (const r of results) {
-    lines.push(`- ${r.valid ? "PASS" : "FAIL"} \`${r.tool}\``);
+    return;
   }
-  return {
-    content: [{ type: "text", text: lines.join("\n") }],
-    structuredContent: success(
-      failed === 0 ? `Self-test: all ${total} schemas valid.` : `Self-test: ${failed}/${total} schemas failed.`,
-      { passed, failed, total, results }
-    )
-  };
+  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 registerHealthTools(server) {
-  server.registerTool(
-    "health",
-    {
-      title: "Health",
-      description: "Diagnostics and session identity. Four actions:\n\n- **check**: Verify connectivity \u2014 workspace, collections, entries, latency.\n- **whoami**: Session identity \u2014 workspace ID, slug, name.\n- **status**: Workspace readiness \u2014 score, gaps, stats (entries, relations, orphans).\n- **audit**: Session audit log \u2014 last N backend calls with summary.",
-      inputSchema: healthSchema,
-      annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false }
-    },
-    withEnvelope(async (args) => {
-      const parsed = parseOrFail(healthSchema, args);
-      if (!parsed.ok) return parsed.result;
-      const { action, limit } = parsed.data;
-      return runWithToolContext({ tool: "health", action }, async () => {
-        if (action === "check") return handleHealthCheck();
-        if (action === "whoami") return handleWhoami();
-        if (action === "status") return handleWorkspaceStatus();
-        if (action === "audit") return handleAudit(limit ?? 20);
-        if (action === "self-test") return handleSelfTest();
-        return unknownAction(action, HEALTH_ACTIONS);
-      });
-    })
-  );
+async function listArchEntries() {
+  return mcpQuery("chain.listEntries", { collectionSlug: COLLECTION_SLUG });
+}
+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 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 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_"}`;
+}
+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(
-    "orient",
+    "architecture",
     {
-      title: "Orient \u2014 Start Here",
-      description: "The single entry point for starting a session. Returns workspace context with a single recommended next action for low-readiness workspaces, or a standup-style briefing for established workspaces.\n\nUse this FIRST. One call to orient replaces 3\u20135 individual tool calls.\n\nCompleting orientation unlocks write tools for the active session.\n\n**mode:** `full` (default) returns full context. `brief` returns only vision, bet/tension counts, readiness, active bet names, and last-session summary \u2014 use for mid-session re-orientation.\n\n**task:** Optional natural-language task description. When provided, returns task-scoped context (scored, relevant entries) in addition to standard orient sections.",
-      inputSchema: orientSchema,
+      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 ({ mode = "full", task } = {}) => {
-      const errors = [];
-      const agentSessionId = getAgentSessionId();
-      if (isSessionOriented() && mode === "brief" && !task) {
+    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: "Already oriented. Session active, writes unlocked. Use `orient mode='full'` or `orient task='...'` for full context." }],
+          content: [
+            { type: "text", text },
+            { type: "resource", resource: { uri: `ui://product-os/architecture`, mimeType: UI_RESOURCE_MIME_TYPE, text: html } }
+          ],
           structuredContent: success(
-            "Already oriented. Session active, writes unlocked.",
-            { alreadyOriented: true, sessionId: agentSessionId }
+            `Showing ${templateName}: ${layers.length} layers, ${nodes.length} nodes, ${flows.length} flows.`,
+            { templateName, layerCount: layers.length, nodeCount: nodes.length, flowCount: flows.length }
           )
         };
       }
-      let wsCtx = null;
-      try {
-        wsCtx = await getWorkspaceContext();
-      } catch (e) {
-        errors.push(`Workspace: ${e instanceof Error ? e.message : String(e)}`);
-      }
-      let priorSessions = [];
-      let recoveryBlock = null;
-      if (wsCtx) {
-        try {
-          const sessionsResult = await mcpQuery("agent.recentSessions", { limit: 3 });
-          priorSessions = sessionsResult?.sessions ?? [];
-          recoveryBlock = sessionsResult?.recoveryBlock ?? null;
-        } catch {
+      if (action === "explore") {
+        if (!layer) {
+          return validationResult("A `layer` is required for explore.");
         }
-      }
-      const { all: sessionEntryIds, lastSessionOnly } = extractSessionEntryIds(priorSessions);
-      let orientEntries = null;
-      try {
-        const orientArgs = {};
-        if (task) orientArgs.task = task;
-        if (sessionEntryIds.length > 0) orientArgs.sessionEntryIds = sessionEntryIds;
-        if (lastSessionOnly.length > 0) orientArgs.lastSessionEntryIds = lastSessionOnly;
-        orientEntries = await mcpQuery("chain.getOrientEntries", orientArgs);
-      } catch {
-      }
-      let openTensions = [];
-      try {
-        const tensions = await mcpQuery("chain.listEntries", { collectionSlug: "tensions" });
-        openTensions = (tensions ?? []).filter((e) => e.workflowStatus === "open");
-      } catch {
-      }
-      let readiness = null;
-      try {
-        readiness = await mcpQuery("chain.workspaceReadiness");
-      } catch (e) {
-        errors.push(`Readiness: ${e instanceof Error ? e.message : String(e)}`);
-      }
-      if (readiness?.stage === "blank") {
-        const scanLines = [
-          `# Welcome to ${wsCtx?.workspaceName ?? "your workspace"}`,
-          "",
-          "Your workspace is fresh \u2014 let's set it up.",
-          "",
-          "**Recommended:** call the `start` tool instead of `orient` for the best first-run experience.",
-          "It will guide you through setting up your workspace \u2014 you can tell me about your product, scan your codebase, or use a preset.",
-          "",
-          "Or tell me about your product and I'll start capturing knowledge directly."
-        ];
-        let oriented = false;
-        let orientationStatus = "no_session";
-        if (agentSessionId) {
-          try {
-            await mcpCall("agent.markOriented", { sessionId: agentSessionId });
-            setSessionOriented(true);
-            oriented = true;
-            orientationStatus = "complete";
-          } catch {
-            orientationStatus = "failed";
-          }
+        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: scanLines.join("\n") }],
+          content: [{
+            type: "text",
+            text: `# ${target.data?.icon ?? ""} ${target.name} Layer
+
+${target.data?.description ?? ""}${depRule}${layerRationale}
+**${nodes.length} components**
+
+${nodeDetail}${flowLines}`
+          }],
           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: {} }]
+            `${target.name} layer: ${nodes.length} components, ${flows.length} connected flows.`,
+            { layerName: target.name, entryId: target.entryId, nodeCount: nodes.length, flowCount: flows.length }
           )
         };
       }
-      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 (action === "flow") {
+        if (!flow) {
+          return validationResult("A `flow` name or entry ID is required.");
         }
-        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));
+        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}`
+            )
+          };
         }
-        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._");
+        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 (errors.length > 0) {
-          lines.push("");
-          for (const err of errors) lines.push(`- ${err}`);
+        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(
-            `Oriented (brief). Stage: ${readiness?.stage ?? "unknown"}.`,
-            { mode: "brief", stage: readiness?.stage ?? "unknown", oriented: isSessionOriented(), sessionId: agentSessionId }
+            `${target.name}: ${source?.name ?? "?"} \u2192 ${dest?.name ?? "?"}.`,
+            { flowName: target.name, entryId: target.entryId, source: source?.name, target: dest?.name }
           )
         };
       }
-      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 (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("");
+      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;
           }
-          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
+          await mcpMutation("chain.createEntry", {
+            collectionSlug: COLLECTION_SLUG,
+            entryId: seed.entryId,
+            name: seed.name,
+            status: seed.status,
+            data: seed.data,
+            order: seed.order ?? 0
           });
-          lines.push(...buildOperatingProtocol({
-            principles: (orientEntries.principles ?? []).map(mapGovernanceEntry),
-            standards: (orientEntries.standards ?? []).map(mapGovernanceEntry),
-            businessRules: (orientEntries.businessRules ?? []).map(mapGovernanceEntry)
-          }, task));
+          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."
+            )
+          };
         }
-        const plannedWork = await queryPlannedWork();
-        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}`);
+        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
             }
-            lines.push("");
+          )
+        };
+      }
+      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;
           }
-          if (recoveryBlock) {
-            lines.push("");
-            lines.push(...formatRecoveryBlock(recoveryBlock));
+          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("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("");
+    }
+    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);
       }
-      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" }
-          });
-        } catch (err) {
-          process.stderr.write(`[MCP] recordSessionSignal failed: ${err.message}
-`);
-        }
-      } else {
-        lines.push("---");
-        lines.push("_No active agent session. Call `session action=start` to begin a tracked session._");
+    }
+    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;
+  }
+  return null;
+}
+function resolveImport(imp, fromFile, root) {
+  let rel = null;
+  if (imp.startsWith("$lib/")) rel = imp.replace("$lib/", "src/lib/");
+  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);
+    rel = relative(root, abs2);
+  }
+  if (!rel) return null;
+  const abs = resolve3(root, rel);
+  const actual = tryResolveWithExtension(abs);
+  return actual ? relative(root, actual) : rel;
+}
+function findNodeByPath(filePath, prefixes) {
+  const normalized = normalize(filePath);
+  for (const { prefix, node } of prefixes) {
+    if (normalized.startsWith(prefix)) return node;
+  }
+  return null;
+}
+function formatScanReport(result) {
+  const lines = [];
+  if (result.violations.length === 0) {
+    lines.push(
+      `# Architecture Health Check Passed`,
+      "",
+      `**0 violations** across ${result.filesScanned} files (${result.importsChecked} imports checked, ${result.unmappedImports} unmapped).`,
+      "",
+      "All imports respect the layer dependency rules."
+    );
+  } else {
+    lines.push(
+      `# Architecture Health Check \u2014 ${result.violations.length} Violation${result.violations.length === 1 ? "" : "s"}`,
+      "",
+      `Scanned ${result.filesScanned} files, checked ${result.importsChecked} imports, found **${result.violations.length} violation${result.violations.length === 1 ? "" : "s"}** (${result.unmappedImports} unmapped).`,
+      ""
+    );
+    const byNode = /* @__PURE__ */ new Map();
+    for (const v of result.violations) {
+      if (!byNode.has(v.sourceNode)) byNode.set(v.sourceNode, []);
+      byNode.get(v.sourceNode).push(v);
+    }
+    for (const [nodeName, vs] of byNode) {
+      lines.push(`## ${nodeName} (${vs[0].sourceLayer})`);
+      for (const v of vs) {
+        lines.push(`- \`${v.sourceFile}\` imports \`${v.importPath}\` \u2192 **${v.targetNode}** (${v.targetLayer}) \u2014 ${v.rule}`);
       }
-      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 }
-        )
-      };
-    })
+      lines.push("");
+    }
+  }
+  lines.push("---", "");
+  const nodeEntries = [...result.nodeResults.entries()];
+  const cleanCount = nodeEntries.filter(([, r]) => r.violations.length === 0 && r.filesScanned > 0).length;
+  const dirtyCount = nodeEntries.filter(([, r]) => r.violations.length > 0).length;
+  const emptyCount = nodeEntries.filter(([, r]) => r.filesScanned === 0).length;
+  lines.push(
+    `**Summary:** ${cleanCount} clean nodes, ${dirtyCount} with violations, ${emptyCount} with no files.`
   );
+  return lines.join("\n");
 }
 
-// src/resources/index.ts
-import { readFile } from "fs/promises";
-import { join, resolve as resolve3 } from "path";
-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"
+// src/tools/health.ts
+var CALL_CATEGORIES = {
+  "chain.getEntry": "read",
+  "chain.batchGetEntries": "read",
+  "chain.listEntries": "read",
+  "chain.listEntryHistory": "read",
+  "chain.listEntryRelations": "read",
+  "chain.listEntriesByLabel": "read",
+  "chain.searchEntries": "search",
+  "chain.createEntry": "write",
+  "chain.updateEntry": "write",
+  "chain.createEntryRelation": "write",
+  "chain.applyLabel": "label",
+  "chain.removeLabel": "label",
+  "chain.createLabel": "label",
+  "chain.updateLabel": "label",
+  "chain.deleteLabel": "label",
+  "chain.createCollection": "write",
+  "chain.updateCollection": "write",
+  "chain.listCollections": "meta",
+  "chain.getCollection": "meta",
+  "chain.listLabels": "meta",
+  "resolveWorkspace": "meta"
 };
-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)}`);
+function categorize(fn) {
+  return CALL_CATEGORIES[fn] ?? "meta";
+}
+function formatDuration(ms) {
+  if (ms < 6e4) return `${Math.round(ms / 1e3)}s`;
+  const mins = Math.floor(ms / 6e4);
+  const secs = Math.round(ms % 6e4 / 1e3);
+  return `${mins}m ${secs}s`;
+}
+function buildSessionSummary(log) {
+  if (log.length === 0) return "";
+  const byCategory = /* @__PURE__ */ new Map();
+  let errorCount = 0;
+  let writeCreates = 0;
+  let writeUpdates = 0;
+  for (const entry of log) {
+    const cat = categorize(entry.fn);
+    if (!byCategory.has(cat)) byCategory.set(cat, /* @__PURE__ */ new Map());
+    const fnCounts = byCategory.get(cat);
+    fnCounts.set(entry.fn, (fnCounts.get(entry.fn) ?? 0) + 1);
+    if (entry.status === "error") errorCount++;
+    if (entry.fn === "chain.createEntry" && entry.status === "ok") writeCreates++;
+    if (entry.fn === "chain.updateEntry" && entry.status === "ok") writeUpdates++;
+  }
+  const firstTs = new Date(log[0].ts).getTime();
+  const lastTs = new Date(log[log.length - 1].ts).getTime();
+  const duration = formatDuration(lastTs - firstTs);
+  const lines = [`# Session Summary (${duration})
+`];
+  const categoryLabels = [
+    ["read", "Reads"],
+    ["search", "Searches"],
+    ["write", "Writes"],
+    ["label", "Labels"],
+    ["meta", "Meta"]
+  ];
+  for (const [cat, label] of categoryLabels) {
+    const fnCounts = byCategory.get(cat);
+    if (!fnCounts || fnCounts.size === 0) continue;
+    const total = [...fnCounts.values()].reduce((a, b) => a + b, 0);
+    const detail = [...fnCounts.entries()].sort((a, b) => b[1] - a[1]).map(([fn, count]) => `${fn.replace("chain.", "")} x${count}`).join(", ");
+    lines.push(`- **${label}:** ${total} call${total === 1 ? "" : "s"} (${detail})`);
+  }
+  lines.push(`- **Errors:** ${errorCount}`);
+  if (writeCreates > 0 || writeUpdates > 0) {
+    lines.push("");
+    lines.push("## Knowledge Contribution");
+    if (writeCreates > 0) lines.push(`- ${writeCreates} entr${writeCreates === 1 ? "y" : "ies"} created`);
+    if (writeUpdates > 0) lines.push(`- ${writeUpdates} entr${writeUpdates === 1 ? "y" : "ies"} updated`);
+  }
+  return lines.join("\n");
+}
+function extractSessionEntryIds(priorSessions) {
+  const allSeen = /* @__PURE__ */ new Set();
+  const all = [];
+  let lastSessionOnly = [];
+  for (let i = 0; i < priorSessions.length; i++) {
+    const s = priorSessions[i];
+    const ids = [...s.entriesCreated ?? [], ...s.entriesModified ?? []].filter((id) => id);
+    if (i === 0) {
+      lastSessionOnly = [...new Set(ids)].slice(0, 5);
+    }
+    for (const id of ids) {
+      if (!allSeen.has(id)) {
+        allSeen.add(id);
+        all.push(id);
+        if (all.length >= 10) break;
       }
     }
+    if (all.length >= 10) break;
+  }
+  return { all, lastSessionOnly };
+}
+function computeOrganisationHealth(entries) {
+  let agreements = 0;
+  let disagreements = 0;
+  let abstentions = 0;
+  const flagMap = /* @__PURE__ */ new Map();
+  for (const entry of entries) {
+    const slug = entry.collectionSlug ?? entry.collection ?? "unknown";
+    const description = typeof entry.data?.description === "string" ? entry.data.description : "";
+    const result = classifyCollection(entry.name, description);
+    if (!result) {
+      abstentions++;
+      continue;
+    }
+    if (result.collection === slug) {
+      agreements++;
+    } else {
+      disagreements++;
+      if (!flagMap.has(slug)) flagMap.set(slug, /* @__PURE__ */ new Map());
+      const suggestions = flagMap.get(slug);
+      suggestions.set(result.collection, (suggestions.get(result.collection) ?? 0) + 1);
+    }
+  }
+  const opinionated = agreements + disagreements;
+  const agreementRate = opinionated > 0 ? Math.round(agreements / opinionated * 100) : 100;
+  const flags = [...flagMap.entries()].map(([collection, suggestions]) => {
+    const total = [...suggestions.values()].reduce((a, b) => a + b, 0);
+    const topSuggested = [...suggestions.entries()].sort((a, b) => b[1] - a[1])[0];
+    return { collection, count: total, suggestedCollection: topSuggested?.[0] ?? "unknown" };
+  }).sort((a, b) => b.count - a.count).slice(0, 3);
+  return { reviewed: entries.length, agreements, disagreements, abstentions, agreementRate, flags };
+}
+function formatOrgHealthLines(orgHealth, maxFlags = 3) {
+  const lines = [];
+  if (orgHealth.disagreements > 0) {
+    lines.push(
+      `${orgHealth.disagreements} of ${orgHealth.reviewed} entries flagged for review (${orgHealth.agreementRate}% classifier agreement).`
+    );
+    for (const flag of orgHealth.flags.slice(0, maxFlags)) {
+      lines.push(`- **${flag.collection}**: ${flag.count} entries may belong in \`${flag.suggestedCollection}\``);
+    }
+  } else if (orgHealth.reviewed > 0) {
+    lines.push(`All ${orgHealth.reviewed - orgHealth.abstentions} classified entries agree with stored collection (${orgHealth.abstentions} without coverage).`);
+  }
+  return lines;
+}
+async function fetchOrganisationHealth() {
+  try {
+    const allEntries = await mcpQuery("chain.listEntries", { status: "active" });
+    if (!allEntries || allEntries.length === 0) return null;
+    return computeOrganisationHealth(allEntries);
+  } catch (err) {
+    process.stderr.write(`[MCP] fetchOrganisationHealth failed: ${err.message}
+`);
+    return null;
+  }
+}
+async function handleHealthCheck() {
+  const start = Date.now();
+  const errors = [];
+  let workspaceId;
+  try {
+    workspaceId = await getWorkspaceId();
+  } catch (e) {
+    errors.push(`Workspace resolution failed: ${e instanceof Error ? e.message : String(e)}`);
+  }
+  let collections = [];
+  try {
+    collections = await mcpQuery("chain.listCollections");
+  } catch (e) {
+    errors.push(`Collection fetch failed: ${e instanceof Error ? e.message : String(e)}`);
+  }
+  let totalEntries = 0;
+  if (collections.length > 0) {
+    try {
+      const entries = await mcpQuery("chain.listEntries", {});
+      totalEntries = entries.length;
+    } catch (e) {
+      errors.push(`Entry count failed: ${e instanceof Error ? e.message : String(e)}`);
+    }
+  }
+  let wsCtx = null;
+  try {
+    wsCtx = await getWorkspaceContext();
+  } catch {
+  }
+  const durationMs = Date.now() - start;
+  const healthy = errors.length === 0;
+  const lines = [
+    `# ${healthy ? "Healthy" : "Degraded"}`,
+    "",
+    `**Workspace:** ${workspaceId ?? "unresolved"}`,
+    `**Workspace Slug:** ${wsCtx?.workspaceSlug ?? "unknown"}`,
+    `**Workspace Name:** ${wsCtx?.workspaceName ?? "unknown"}`,
+    `**Collections:** ${collections.length}`,
+    `**Entries:** ${totalEntries}`,
+    `**Latency:** ${durationMs}ms`
+  ];
+  if (errors.length > 0) {
+    lines.push("", "## Errors");
+    for (const err of errors) {
+      lines.push(`- ${err}`);
+    }
+  }
+  const healthData = {
+    healthy,
+    collections: collections.length,
+    entries: totalEntries,
+    latencyMs: durationMs,
+    workspace: workspaceId ?? "unresolved"
+  };
+  return {
+    content: [{ type: "text", text: lines.join("\n") }],
+    structuredContent: success(
+      healthy ? `Healthy. ${collections.length} collections, ${totalEntries} entries, ${durationMs}ms.` : `Degraded. ${errors.length} error(s).`,
+      healthData
+    )
+  };
+}
+async function handleWhoami() {
+  const ctx = await getWorkspaceContext();
+  const sessionId = getAgentSessionId();
+  const scope = getApiKeyScope();
+  const oriented = isSessionOriented();
+  const lines = [
+    `# Session Identity`,
+    "",
+    `**Workspace ID:** ${ctx.workspaceId}`,
+    `**Workspace Slug:** ${ctx.workspaceSlug}`,
+    `**Workspace Name:** ${ctx.workspaceName}`
+  ];
+  return {
+    content: [{ type: "text", text: lines.join("\n") }],
+    structuredContent: success(
+      `Session: ${ctx.workspaceName} (${scope}). ${oriented ? "Oriented." : "Not oriented."}`,
+      { workspaceId: ctx.workspaceId, workspaceName: ctx.workspaceName, scope, sessionId, oriented }
+    )
+  };
+}
+var STAGE_LABELS = {
+  blank: "Blank",
+  seeded: "Seeded",
+  grounded: "Grounded",
+  connected: "Connected"
+};
+var STAGE_DESCRIPTIONS = {
+  blank: "No knowledge captured yet.",
+  seeded: "Early knowledge is in place \u2014 keep building.",
+  grounded: "Solid foundations \u2014 a few gaps remain.",
+  connected: "Well-connected knowledge graph \u2014 your Brain is useful."
+};
+async function handleWorkspaceStatus() {
+  const result = await mcpQuery("chain.workspaceReadiness");
+  const { score, totalChecks, passedChecks, checks, gaps, stats, governanceMode } = result;
+  const scoringVersion = result.scoringVersion ?? "v1";
+  const stage = result.stage ?? "seeded";
+  const stageLabel = STAGE_LABELS[stage] ?? stage;
+  const stageDescription = STAGE_DESCRIPTIONS[stage] ?? "";
+  const scoreBar = "\u2588".repeat(Math.round(score / 10)) + "\u2591".repeat(10 - Math.round(score / 10));
+  const lines = [
+    `# Brain Status: ${stageLabel}`,
+    `_${stageDescription}_`,
+    "",
+    `${scoreBar} ${stageLabel} \xB7 ${score}%`,
+    `**Governance:** ${governanceMode ?? "open"}${(governanceMode ?? "open") !== "open" ? " (commits require proposal)" : ""}`,
+    "",
+    "## Stats",
+    `- **Entries:** ${stats.totalEntries} (${stats.activeCount} active, ${stats.draftCount} draft)`,
+    `- **Relations:** ${stats.totalRelations}`,
+    `- **Collections:** ${stats.collectionCount}`,
+    `- **Orphaned:** ${stats.orphanedCount} committed entries with no relations`,
+    ""
+  ];
+  if (gaps.length > 0) {
+    lines.push("## Gaps");
+    for (const gap of gaps) {
+      const action = gap.capabilityGuidance ?? gap.guidance;
+      lines.push(`- [ ] **${gap.label}**`);
+      lines.push(`  _${action}_`);
+    }
+    lines.push("");
   }
-  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" });
+  const passed = checks.filter((c) => c.passed);
+  if (passed.length > 0) {
+    lines.push("## Passing checks");
+    for (const check of passed) {
+      lines.push(`- [x] ${check.label} (${check.current}/${check.required})`);
+    }
+    lines.push("");
   }
-  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" });
+  const orgHealth = await fetchOrganisationHealth();
+  if (orgHealth && orgHealth.reviewed > 0) {
+    lines.push("## Organisation Health");
+    lines.push(...formatOrgHealthLines(orgHealth));
+    lines.push("");
   }
-  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" });
+  const statusData = {
+    stage,
+    scoringVersion,
+    readinessScore: score,
+    activeEntries: stats.activeCount,
+    totalRelations: stats.totalRelations,
+    orphanedEntries: stats.orphanedCount,
+    gaps: gaps.map((g) => ({
+      id: g.id,
+      label: g.label,
+      guidance: g.capabilityGuidance ?? g.guidance
+    })),
+    ...orgHealth && { organisationHealth: orgHealth }
+  };
+  return {
+    content: [{ type: "text", text: lines.join("\n") }],
+    structuredContent: success(
+      `Brain: ${stageLabel} (${score}%). ${stats.activeCount} active entries, ${gaps.length} gap(s).`,
+      statusData
+    )
+  };
+}
+async function handleAudit(limit) {
+  const log = getAuditLog();
+  const recent = log.slice(-limit);
+  if (recent.length === 0) {
+    return successResult("No calls recorded yet this session.", "No calls recorded yet this session.", { totalCalls: 0, calls: [] });
   }
-  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."
-    );
+  const summary = buildSessionSummary(log);
+  const logLines = [`# Audit Log (last ${recent.length} of ${log.length} total)
+`];
+  for (const entry of recent) {
+    const icon = entry.status === "ok" ? "\u2713" : "\u2717";
+    const errPart = entry.error ? ` \u2014 ${entry.error}` : "";
+    const toolPart = entry.toolContext ? ` [${entry.toolContext.tool}${entry.toolContext.action ? ` action=${entry.toolContext.action}` : ""}]` : "";
+    logLines.push(`${icon} \`${entry.fn}\`${toolPart} ${entry.durationMs}ms ${entry.status}${errPart}`);
   }
-  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\`.
+  const auditData = {
+    totalCalls: log.length,
+    calls: recent.map((entry) => ({
+      tool: entry.fn,
+      ...entry.toolContext?.action && { action: entry.toolContext.action },
+      timestamp: entry.ts,
+      ...entry.durationMs != null && { durationMs: entry.durationMs }
+    }))
+  };
+  return {
+    content: [{ type: "text", text: `${summary}
 
-` + 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."
-    );
+---
+
+${logLines.join("\n")}` }],
+    structuredContent: success(
+      `Audit: ${log.length} total calls, showing last ${recent.length}.`,
+      auditData
+    )
+  };
+}
+var HEALTH_ACTIONS = ["check", "whoami", "status", "audit", "self-test"];
+var healthSchema = z20.object({
+  action: z20.enum(HEALTH_ACTIONS).describe(
+    "'check': connectivity and workspace stats. 'whoami': session identity. 'status': workspace readiness. 'audit': session audit log. 'self-test': validate all tool schemas."
+  ),
+  limit: z20.number().min(1).max(50).default(20).optional().describe("For audit: how many recent calls to show (max 50)")
+});
+var orientSchema = z20.object({
+  mode: z20.enum(["full", "brief"]).optional().default("full").describe("full = full context (default). brief = compact summary for mid-session re-orientation."),
+  task: z20.string().optional().describe("Natural-language task description for task-scoped context. When provided, orient returns scored, relevant entries for the task.")
+});
+var healthCheckOutputSchema = z20.object({
+  healthy: z20.boolean(),
+  collections: z20.number(),
+  entries: z20.number(),
+  latencyMs: z20.number(),
+  workspace: z20.string()
+});
+var organisationHealthSchema = z20.object({
+  reviewed: z20.number(),
+  agreements: z20.number(),
+  disagreements: z20.number(),
+  abstentions: z20.number(),
+  agreementRate: z20.number(),
+  flags: z20.array(z20.object({
+    collection: z20.string(),
+    count: z20.number(),
+    suggestedCollection: z20.string()
+  }))
+});
+var healthStatusOutputSchema = z20.object({
+  stage: z20.enum(["blank", "seeded", "grounded", "connected"]).optional().default("seeded"),
+  scoringVersion: z20.enum(["v1", "v2"]).optional().default("v1"),
+  readinessScore: z20.number(),
+  activeEntries: z20.number(),
+  totalRelations: z20.number(),
+  orphanedEntries: z20.number(),
+  gaps: z20.array(z20.object({ id: z20.string(), label: z20.string(), guidance: z20.string() })),
+  organisationHealth: organisationHealthSchema.optional()
+});
+var healthAuditOutputSchema = z20.object({
+  totalCalls: z20.number(),
+  calls: z20.array(z20.object({
+    tool: z20.string(),
+    action: z20.string().optional(),
+    timestamp: z20.string(),
+    durationMs: z20.number().optional()
+  }))
+});
+var healthWhoamiOutputSchema = z20.object({
+  workspaceId: z20.string(),
+  workspaceName: z20.string(),
+  scope: z20.string(),
+  sessionId: z20.union([z20.string(), z20.null()]),
+  oriented: z20.boolean()
+});
+var ALL_TOOL_SCHEMAS = [
+  { name: "entries", schema: entriesSchema },
+  { name: "relations", schema: relationsSchema },
+  { name: "graph", schema: graphSchema },
+  { name: "context", schema: contextSchema },
+  { name: "collections", schema: collectionsSchema },
+  { name: "session", schema: sessionSchema },
+  { name: "health", schema: healthSchema },
+  { name: "orient", schema: orientSchema },
+  { name: "quality", schema: qualitySchema },
+  { name: "workflows", schema: workflowsSchema },
+  { name: "session-wrapup", schema: wrapupSchema },
+  { name: "labels", schema: labelsSchema },
+  { name: "verify", schema: verifySchema },
+  { name: "capture", schema: captureSchema },
+  { name: "batch-capture", schema: batchCaptureSchema },
+  { name: "update-entry", schema: updateEntrySchema },
+  { name: "get-history", schema: getHistorySchema },
+  { name: "commit-entry", schema: commitEntrySchema },
+  { name: "start", schema: startSchema },
+  { name: "get-usage-summary", schema: usageSummarySchema },
+  { name: "chain", schema: chainSchema },
+  { name: "chain-version", schema: chainVersionSchema },
+  { name: "chain-branch", schema: chainBranchSchema },
+  { name: "chain-review", schema: chainReviewSchema },
+  { name: "create-audience-map-set", schema: createAudienceMapSetSchema },
+  { name: "map", schema: mapSchema },
+  { name: "map-slot", schema: mapSlotSchema },
+  { name: "map-version", schema: mapVersionSchema },
+  { name: "map-suggest", schema: mapSuggestSchema },
+  { name: "architecture", schema: architectureSchema },
+  { name: "architecture-admin", schema: architectureAdminSchema },
+  { name: "facilitate", schema: facilitateSchema }
+];
+var selfTestOutputSchema = z20.object({
+  passed: z20.number(),
+  failed: z20.number(),
+  total: z20.number(),
+  results: z20.array(z20.object({
+    tool: z20.string(),
+    valid: z20.boolean(),
+    error: z20.string().optional()
+  }))
+});
+function handleSelfTest() {
+  const results = [];
+  for (const { name, schema } of ALL_TOOL_SCHEMAS) {
+    try {
+      if (!schema || typeof schema.safeParse !== "function") {
+        results.push({ tool: name, valid: false, error: "Schema is not a valid Zod object" });
+        continue;
+      }
+      const test = schema.safeParse({});
+      if (test.success || test.error) {
+        results.push({ tool: name, valid: true });
+      }
+    } catch (e) {
+      results.push({ tool: name, valid: false, error: e instanceof Error ? e.message : String(e) });
+    }
   }
-  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");
+  const passed = results.filter((r) => r.valid).length;
+  const failed = results.filter((r) => !r.valid).length;
+  const total = results.length;
+  const lines = [
+    `# Self-Test: Tool Schema Validation`,
+    `**Result:** ${failed === 0 ? "ALL PASS" : `${failed} FAILED`}`,
+    `**Schemas validated:** ${passed}/${total}`,
+    ""
+  ];
+  if (failed > 0) {
+    lines.push("## Failures");
+    for (const r of results.filter((r2) => !r2.valid)) {
+      lines.push(`- **${r.tool}**: ${r.error}`);
+    }
+    lines.push("");
+  }
+  lines.push("## All Tools");
+  for (const r of results) {
+    lines.push(`- ${r.valid ? "PASS" : "FAIL"} \`${r.tool}\``);
+  }
+  return {
+    content: [{ type: "text", text: lines.join("\n") }],
+    structuredContent: success(
+      failed === 0 ? `Self-test: all ${total} schemas valid.` : `Self-test: ${failed}/${total} schemas failed.`,
+      { passed, failed, total, results }
+    )
+  };
 }
-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"
-      }]
+function registerHealthTools(server) {
+  server.registerTool(
+    "health",
+    {
+      title: "Health",
+      description: "Diagnostics and session identity. Four actions:\n\n- **check**: Verify connectivity \u2014 workspace, collections, entries, latency.\n- **whoami**: Session identity \u2014 workspace ID, slug, name.\n- **status**: Workspace readiness \u2014 score, gaps, stats (entries, relations, orphans).\n- **audit**: Session audit log \u2014 last N backend calls with summary.",
+      inputSchema: healthSchema,
+      annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false }
+    },
+    withEnvelope(async (args) => {
+      const parsed = parseOrFail(healthSchema, args);
+      if (!parsed.ok) return parsed.result;
+      const { action, limit } = parsed.data;
+      return runWithToolContext({ tool: "health", action }, async () => {
+        if (action === "check") return handleHealthCheck();
+        if (action === "whoami") return handleWhoami();
+        if (action === "status") return handleWorkspaceStatus();
+        if (action === "audit") return handleAudit(limit ?? 20);
+        if (action === "self-test") return handleSelfTest();
+        return unknownAction(action, HEALTH_ACTIONS);
+      });
     })
   );
-  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.");
+  server.registerTool(
+    "orient",
+    {
+      title: "Orient \u2014 Start Here",
+      description: "The single entry point for starting a session. Returns workspace context with a single recommended next action for low-readiness workspaces, or a standup-style briefing for established workspaces.\n\nUse this FIRST. One call to orient replaces 3\u20135 individual tool calls.\n\nCompleting orientation unlocks write tools for the active session.\n\n**mode:** `full` (default) returns full context. `brief` returns only vision, bet/tension counts, readiness, active bet names, and last-session summary \u2014 use for mid-session re-orientation.\n\n**task:** Optional natural-language task description. When provided, returns task-scoped context (scored, relevant entries) in addition to standard orient sections.",
+      inputSchema: orientSchema,
+      annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false }
+    },
+    withEnvelope(async ({ mode = "full", task } = {}) => {
+      const errors = [];
+      const agentSessionId = getAgentSessionId();
+      if (isSessionOriented() && mode === "brief" && !task) {
+        return {
+          content: [{ type: "text", text: "Already oriented. Session active, writes unlocked. Use `orient mode='full'` or `orient task='...'` for full context." }],
+          structuredContent: success(
+            "Already oriented. Session active, writes unlocked.",
+            { alreadyOriented: true, sessionId: agentSessionId }
+          )
+        };
+      }
+      let wsCtx = null;
+      try {
+        wsCtx = await getWorkspaceContext();
+      } catch (e) {
+        errors.push(`Workspace: ${e instanceof Error ? e.message : String(e)}`);
+      }
+      let priorSessions = [];
+      let recoveryBlock = null;
+      if (wsCtx) {
+        try {
+          const sessionsResult = await mcpQuery("agent.recentSessions", { limit: 3 });
+          priorSessions = sessionsResult?.sessions ?? [];
+          recoveryBlock = sessionsResult?.recoveryBlock ?? null;
+        } catch {
+        }
+      }
+      const { all: sessionEntryIds, lastSessionOnly } = extractSessionEntryIds(priorSessions);
+      let orientEntries = null;
+      try {
+        const orientArgs = {};
+        if (task) orientArgs.task = task;
+        if (sessionEntryIds.length > 0) orientArgs.sessionEntryIds = sessionEntryIds;
+        if (lastSessionOnly.length > 0) orientArgs.lastSessionEntryIds = lastSessionOnly;
+        orientEntries = await mcpQuery("chain.getOrientEntries", orientArgs);
+      } catch {
+      }
+      let openTensions = [];
+      try {
+        const tensions = await mcpQuery("chain.listEntries", { collectionSlug: "tensions" });
+        openTensions = (tensions ?? []).filter((e) => e.workflowStatus === "open");
+      } catch {
+      }
+      let readiness = null;
+      try {
+        readiness = await mcpQuery("chain.workspaceReadiness");
+      } catch (e) {
+        errors.push(`Readiness: ${e instanceof Error ? e.message : String(e)}`);
+      }
+      if (readiness?.stage === "blank") {
+        const scanLines = [
+          `# Welcome to ${wsCtx?.workspaceName ?? "your workspace"}`,
+          "",
+          "Your workspace is fresh \u2014 let's set it up.",
+          "",
+          "**Recommended:** call the `start` tool instead of `orient` for the best first-run experience.",
+          "It will guide you through setting up your workspace \u2014 you can tell me about your product, scan your codebase, or use a preset.",
+          "",
+          "Or tell me about your product and I'll start capturing knowledge directly."
+        ];
+        let oriented = false;
+        let orientationStatus = "no_session";
+        if (agentSessionId) {
+          try {
+            await mcpCall("agent.markOriented", { sessionId: agentSessionId });
+            setSessionOriented(true);
+            oriented = true;
+            orientationStatus = "complete";
+          } catch {
+            orientationStatus = "failed";
+          }
+        }
+        return {
+          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).`);
         }
-      } else {
-        lines.push("## Glossary\n\nCould not load glossary \u2014 use `entries action=list collection=glossary` to browse manually.");
-      }
-      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}`);
+        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("## Standards\n\nNo standards yet. Use `capture` with collection `standards` to add standards.");
+          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}`);
         }
-      } 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 || ""}
-
-**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()
-          }))
+          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 }
+          )
         };
       }
-    }),
-    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 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("");
+        }
       }
-      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 (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));
         }
-      }
-      if (ungrouped.length > 0) {
-        lines.push("## Ungrouped");
-        for (const l of ungrouped) {
-          lines.push(`- \`${l.slug}\` ${l.name}${l.color ? ` (${l.color})` : ""}`);
+        let allEntries = [];
+        try {
+          allEntries = await mcpQuery("chain.listEntries", {}) ?? [];
+        } catch {
         }
-      }
-      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 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));
+          }
         }
-      }
-    }),
-    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 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("");
           }
         }
-        lines.push("");
-      }
-      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}`);
+        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("What would you like to work on?");
         lines.push("");
       }
-      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);
-        }
-      }
-    }),
-    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}`);
-        }
+      if (errors.length > 0) {
+        lines.push("## Errors");
+        for (const err of errors) lines.push(`- ${err}`);
         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 [];
+      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._");
         }
-      }
-    }),
-    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})`);
+        try {
+          await mcpMutation("chain.recordSessionSignal", {
+            sessionId: agentSessionId,
+            signalType: "immediate_context_load",
+            metadata: { source: "orient" }
+          });
+        } catch (err) {
+          process.stderr.write(`[MCP] recordSessionSignal failed: ${err.message}
+`);
+        }
+      } else {
+        lines.push("---");
+        lines.push("_No active agent session. Call `session action=start` to begin a tracked session._");
       }
       return {
-        contents: [{ uri: uri.href, text: lines.join("\n"), mimeType: "text/markdown" }]
+        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 }
+        )
       };
-    }
+    })
   );
-  const viewsBase = resolve3(process.cwd(), "packages", "mcp-views", "dist");
-  for (const [uri, filePath] of Object.entries(UI_VIEWS)) {
-    server.resource(`ui-view-${uri.replace(/[^a-z0-9]/gi, "-")}`, uri, async (uriObj) => {
-      try {
-        const html = await readFile(join(viewsBase, filePath), "utf-8");
-        return { contents: [{ uri: uriObj.href, text: html, mimeType: "text/html" }] };
-      } catch {
-        return {
-          contents: [{
-            uri: uriObj.href,
-            text: "View not found. Run npm run build in packages/mcp-views.",
-            mimeType: "text/plain"
-          }]
-        };
-      }
-    });
-  }
 }
 
 // src/prompts/index.ts
@@ -10516,4 +10807,4 @@ export {
   SERVER_VERSION,
   createProductBrainServer
 };
-//# sourceMappingURL=chunk-FMEZXUP5.js.map
+//# sourceMappingURL=chunk-IGQLZI32.js.map