@productbrain/mcp 0.0.1-beta.2 → 0.0.1-beta.21

package/dist/chunk-N47IMYAQ.js

@@ -0,0 +1,4546 @@
+import {
+  closeAgentSession,
+  getAgentSessionId,
+  getAuditLog,
+  getWorkspaceContext,
+  getWorkspaceId,
+  isSessionOriented,
+  mcpCall,
+  mcpMutation,
+  mcpQuery,
+  recordSessionActivity,
+  registerSmartCaptureTools,
+  requireWriteAccess,
+  setSessionOriented,
+  startAgentSession
+} from "./chunk-CXYNWTRQ.js";
+
+// src/server.ts
+import { McpServer as McpServer2 } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+// src/tools/knowledge.ts
+import { z } from "zod";
+function extractPreview(data, maxLen) {
+  if (!data || typeof data !== "object") return "";
+  const raw = data.description ?? data.canonical ?? data.detail ?? "";
+  if (typeof raw !== "string" || !raw) return "";
+  return raw.length > maxLen ? raw.substring(0, maxLen) + "..." : raw;
+}
+function registerKnowledgeTools(server) {
+  server.registerTool(
+    "list-collections",
+    {
+      title: "Browse Collections",
+      description: "List every knowledge collection in the workspace \u2014 glossary, business rules, tracking events, standards, etc. Returns each collection's slug, name, description, and field schema. Start here before capture so you know which collections exist and what fields they expect.",
+      annotations: { readOnlyHint: true }
+    },
+    async () => {
+      const collections = await mcpQuery("chain.listCollections");
+      if (collections.length === 0) {
+        return { content: [{ type: "text", text: "No collections found in this workspace." }] };
+      }
+      const formatted = collections.map((c) => {
+        const fieldList = c.fields.map((f) => `  - \`${f.key}\` (${f.type}${f.required ? ", required" : ""}${f.searchable ? ", searchable" : ""})`).join("\n");
+        const meta = [
+          c.description || "_No description_",
+          c.purpose ? `**Purpose:** ${c.purpose}` : null,
+          c.navGroup ? `**Nav group:** ${c.navGroup}` : null
+        ].filter(Boolean).join("\n");
+        return `## ${c.name} (\`${c.slug}\`)
+${meta}
+
+**Fields:**
+${fieldList}`;
+      }).join("\n\n---\n\n");
+      return {
+        content: [{ type: "text", text: `# Knowledge Collections (${collections.length})
+
+${formatted}` }]
+      };
+    }
+  );
+  server.registerTool(
+    "list-entries",
+    {
+      title: "Browse Entries",
+      description: "List entries in a collection, with optional filters for status, tag, or label. Returns entry IDs, names, status, and a data preview. Use list-collections first to discover available collection slugs.",
+      inputSchema: {
+        collection: z.string().optional().describe("Collection slug, e.g. 'glossary', 'tracking-events', 'business-rules'"),
+        status: z.string().optional().describe("Filter: draft | active | verified | deprecated"),
+        tag: z.string().optional().describe("Filter by internal tag, e.g. 'health:ambiguous'"),
+        label: z.string().optional().describe("Filter by label slug \u2014 matches entries across all collections")
+      },
+      annotations: { readOnlyHint: true }
+    },
+    async ({ collection, status, tag, label }) => {
+      let entries;
+      if (label) {
+        entries = await mcpQuery("chain.listEntriesByLabel", { labelSlug: label });
+        if (status) entries = entries.filter((e) => e.status === status);
+      } else {
+        entries = await mcpQuery("chain.listEntries", {
+          collectionSlug: collection,
+          status,
+          tag
+        });
+      }
+      if (entries.length === 0) {
+        return { content: [{ type: "text", text: "No entries match the given filters." }] };
+      }
+      const formatted = entries.map((e) => {
+        const id = e.entryId ? `**${e.entryId}:** ` : "";
+        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") : "";
+        return `- ${id}${e.name} \`${e.status}\`${dataPreview ? `
+${dataPreview}` : ""}`;
+      }).join("\n\n");
+      const scope = collection ? ` in \`${collection}\`` : "";
+      return {
+        content: [{ type: "text", text: `# Entries${scope} (${entries.length})
+
+${formatted}` }]
+      };
+    }
+  );
+  server.registerTool(
+    "get-entry",
+    {
+      title: "Look Up Entry",
+      description: "Retrieve a single knowledge entry by its human-readable ID (e.g. 'T-SUPPLIER', 'BR-001', 'EVT-workspace_created'). Returns the full record: all data fields, labels, relations, and change history. Use search or list-entries first to discover entry IDs.",
+      inputSchema: {
+        entryId: z.string().describe("Entry ID, e.g. 'T-SUPPLIER', 'BR-001', 'EVT-workspace_created'")
+      },
+      annotations: { readOnlyHint: true }
+    },
+    async ({ entryId }) => {
+      const entry = await mcpQuery("chain.getEntry", { entryId });
+      if (!entry) {
+        return { content: [{ type: "text", text: `Entry \`${entryId}\` not found. Try search to find the right ID.` }] };
+      }
+      const lines = [
+        `# ${entry.entryId ? `${entry.entryId}: ` : ""}${entry.name}`,
+        "",
+        `**Status:** ${entry.status}`,
+        `**Type:** ${entry.canonicalKey ?? "untyped"}`
+      ];
+      if (entry.data && typeof entry.data === "object") {
+        lines.push("");
+        for (const [key, val] of Object.entries(entry.data)) {
+          const display = typeof val === "string" ? val : JSON.stringify(val);
+          lines.push(`**${key}:** ${display}`);
+        }
+      }
+      if (entry.tags?.length > 0) {
+        lines.push("", `**Tags:** ${entry.tags.join(", ")}`);
+      }
+      if (entry.labels?.length > 0) {
+        lines.push("", `**Labels:** ${entry.labels.map((l) => `\`${l.slug ?? l.name}\``).join(", ")}`);
+      }
+      if (entry.relations?.length > 0) {
+        lines.push("", "## Relations");
+        for (const r of entry.relations) {
+          const arrow = r.direction === "outgoing" ? "\u2192" : "\u2190";
+          const other = r.otherEntryId ? `${r.otherEntryId}: ${r.otherName}` : r.otherName ?? "unknown";
+          lines.push(`- ${arrow} **${r.type}** ${other}`);
+        }
+      }
+      if (entry.history?.length > 0) {
+        lines.push("", "## History (last 10)");
+        for (const h of entry.history.slice(-10)) {
+          const date = new Date(h.timestamp).toISOString().split("T")[0];
+          lines.push(`- ${date}: ${h.event}${h.changedBy ? ` _(${h.changedBy})_` : ""}`);
+        }
+      }
+      return { content: [{ type: "text", text: lines.join("\n") }] };
+    }
+  );
+  server.registerTool(
+    "update-entry",
+    {
+      title: "Update Entry",
+      description: "Update an existing entry by its human-readable ID. Only provide the fields you want to change \u2014 data fields are merged with existing values. Creates a draft version by default. **Never use autoPublish=true unless the user explicitly asks to publish** \u2014 same rule as commit-entry. Use get-entry first to see current values.",
+      inputSchema: {
+        entryId: z.string().describe("Entry ID to update, e.g. 'T-SUPPLIER', 'BR-001'"),
+        name: z.string().optional().describe("New display name"),
+        status: z.string().optional().describe("New status: draft | active | verified | deprecated"),
+        data: z.record(z.unknown()).optional().describe("Fields to update (merged with existing data)"),
+        order: z.number().optional().describe("New sort order"),
+        canonicalKey: z.string().optional().describe("Semantic type (e.g. 'decision', 'tension'). Only changeable on draft/uncommitted entries."),
+        autoPublish: z.boolean().optional().default(false).describe("Only true when user explicitly asks to publish. Default false = draft. Never auto-publish without user confirmation."),
+        changeNote: z.string().optional().describe("Short human-readable summary for history (e.g. 'Updated description to F1-themed copy'). If omitted, a friendly default is generated from fields changed.")
+      },
+      annotations: { idempotentHint: true, destructiveHint: false }
+    },
+    async ({ entryId, name, status, data, order, canonicalKey, autoPublish, changeNote }) => {
+      requireWriteAccess();
+      const id = await mcpMutation("chain.updateEntry", {
+        entryId,
+        name,
+        status,
+        data,
+        order,
+        canonicalKey,
+        autoPublish,
+        changeNote,
+        changedBy: getAgentSessionId() ? `agent:${getAgentSessionId()}` : void 0
+      });
+      await recordSessionActivity({ entryModified: id });
+      const wsCtx = await getWorkspaceContext();
+      const mode = autoPublish ? "published" : "saved as draft";
+      return {
+        content: [{ type: "text", text: `# Entry Updated
+
+**${entryId}** has been ${mode}.
+
+Internal ID: ${id}
+**Workspace:** ${wsCtx.workspaceSlug} (${wsCtx.workspaceId})` }]
+      };
+    }
+  );
+  server.registerTool(
+    "search",
+    {
+      title: "Search the Chain",
+      description: "Full-text search across all entries on the Chain. Returns entry names, collection, status, and a description preview. Scope results to a specific collection (e.g. collection='business-rules') or filter by status (e.g. status='active'). Use this to discover entries before calling get-entry for full details.",
+      inputSchema: {
+        query: z.string().describe("Search text (min 2 characters)"),
+        collection: z.string().optional().describe("Scope to a collection slug, e.g. 'business-rules', 'glossary', 'tracking-events'"),
+        status: z.string().optional().describe("Filter by status: draft | active | verified | deprecated")
+      },
+      annotations: { readOnlyHint: true, openWorldHint: true }
+    },
+    async ({ query, collection, status }) => {
+      const scope = collection ? ` in \`${collection}\`` : "";
+      await server.sendLoggingMessage({ level: "info", data: `Searching${scope} for "${query}"...`, logger: "product-os" });
+      const [results, collections] = await Promise.all([
+        mcpQuery("chain.searchEntries", { query, collectionSlug: collection, status }),
+        mcpQuery("chain.listCollections")
+      ]);
+      if (results.length === 0) {
+        return { content: [{ type: "text", text: `No results for "${query}"${scope}. Try a broader search or check list-collections for available data.` }] };
+      }
+      const collMap = /* @__PURE__ */ new Map();
+      for (const c of collections) {
+        collMap.set(c._id, { name: c.name, slug: c.slug });
+      }
+      const countsBySlug = /* @__PURE__ */ new Map();
+      for (const e of results) {
+        const col = collMap.get(e.collectionId);
+        const slug = col?.slug ?? "unknown";
+        countsBySlug.set(slug, (countsBySlug.get(slug) ?? 0) + 1);
+      }
+      const collSummary = [...countsBySlug.entries()].sort((a, b) => b[1] - a[1]).map(([slug, count]) => `${count} ${slug}`).join(", ");
+      const formatted = results.map((e) => {
+        const id = e.entryId ? `**${e.entryId}:** ` : "";
+        const col = collMap.get(e.collectionId);
+        const colTag = col ? ` [${col.slug}]` : "";
+        const typeTag = e.canonicalKey ? ` (${e.canonicalKey})` : "";
+        const desc = extractPreview(e.data, 150);
+        const preview = desc ? `
+  ${desc}` : "";
+        return `- ${id}${e.name} \`${e.status}\`${colTag}${typeTag}${preview}`;
+      }).join("\n");
+      const header = `# Search Results for "${query}"${scope} (${results.length} match${results.length === 1 ? "" : "es"})
+
+**By collection:** ${collSummary}`;
+      const footer = `_Tip: Use \`collection\` param to scope search. Use get-entry with an entry ID for full details._`;
+      return {
+        content: [{ type: "text", text: `${header}
+
+${formatted}
+
+${footer}` }]
+      };
+    }
+  );
+  server.registerTool(
+    "get-history",
+    {
+      title: "Entry Change History",
+      description: "Get the audit trail for an entry \u2014 when it was created, updated, status-changed, etc. Returns timestamped events with change details.",
+      inputSchema: {
+        entryId: z.string().describe("Entry ID, e.g. 'T-SUPPLIER', 'BR-001'")
+      },
+      annotations: { readOnlyHint: true }
+    },
+    async ({ entryId }) => {
+      const history = await mcpQuery("chain.listEntryHistory", { entryId });
+      if (history.length === 0) {
+        return { content: [{ type: "text", text: `No history found for \`${entryId}\`.` }] };
+      }
+      const formatted = history.map((h) => {
+        const date = new Date(h.timestamp).toISOString();
+        const changes = h.changes ? ` \u2014 ${JSON.stringify(h.changes)}` : "";
+        return `- **${date}** ${h.event}${h.changedBy ? ` _(${h.changedBy})_` : ""}${changes}`;
+      }).join("\n");
+      return {
+        content: [{ type: "text", text: `# History for \`${entryId}\` (${history.length} events)
+
+${formatted}` }]
+      };
+    }
+  );
+  server.registerTool(
+    "relate-entries",
+    {
+      title: "Link Two Entries",
+      description: "Create a typed relation between two entries, building the knowledge graph. Use get-entry to see existing relations before adding new ones.\n\nRecommended relation types (extensible \u2014 any string is accepted):\n- related_to, depends_on, replaces, conflicts_with, references, confused_with\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- surfaces_tension_in \u2014 a tension exists within a feature area\n\nCheck glossary for relation type definitions if unsure which to use.",
+      inputSchema: {
+        from: z.string().describe("Source entry ID, e.g. 'T-SUPPLIER'"),
+        to: z.string().describe("Target entry ID, e.g. 'BR-001'"),
+        type: z.string().describe("Relation type \u2014 use a recommended type or any descriptive string"),
+        score: z.number().optional().describe("Suggestion score from suggest-links (improves feedback for weight tuning)")
+      },
+      annotations: { destructiveHint: false }
+    },
+    async ({ from, to, type, score }) => {
+      requireWriteAccess();
+      const result = await mcpMutation("chain.createEntryRelation", {
+        fromEntryId: from,
+        toEntryId: to,
+        type,
+        suggestionScore: score ?? 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)" : "";
+        return {
+          content: [{
+            type: "text",
+            text: `# Proposal Created \u2014 Governs Relation
+
+**${result.fromEntryId ?? from}** \u2014[${type}]\u2192 **${result.toEntryId ?? to}**
+
+${result.message ?? "Governs relation requires async consent. A proposal was created for review."}
+
+**Proposal ID:** \`${result.proposalId}\`${existingNote}
+**Workspace:** ${wsCtx.workspaceSlug} (${wsCtx.workspaceId})
+
+The relation was **not applied** \u2014 it will be created when the proposal is approved.`
+          }]
+        };
+      }
+      return {
+        content: [{ type: "text", text: `# Relation Created
+
+**${from}** \u2014[${type}]\u2192 **${to}**
+**Workspace:** ${wsCtx.workspaceSlug} (${wsCtx.workspaceId})` }]
+      };
+    }
+  );
+  server.registerTool(
+    "batch-relate",
+    {
+      title: "Batch Link Entries",
+      description: "Create multiple relations in one call. Accepts an array of {from, to, type} objects. Use after suggest-links to apply several suggestions at once instead of calling relate-entries repeatedly.\n\nEach relation is created independently \u2014 if one fails, the others still succeed. Returns a summary of created and failed relations.",
+      inputSchema: {
+        relations: z.array(z.object({
+          from: z.string().describe("Source entry ID"),
+          to: z.string().describe("Target entry ID"),
+          type: z.string().describe("Relation type")
+        })).min(1).max(20).describe("Array of relations to create")
+      },
+      annotations: { destructiveHint: false }
+    },
+    async ({ relations }) => {
+      requireWriteAccess();
+      const results = [];
+      for (const rel of relations) {
+        try {
+          const result = await mcpMutation("chain.createEntryRelation", {
+            fromEntryId: rel.from,
+            toEntryId: rel.to,
+            type: rel.type
+          });
+          results.push({
+            ...rel,
+            ok: true,
+            proposalCreated: result?.status === "proposal_created",
+            proposalId: result?.proposalId
+          });
+        } catch (e) {
+          results.push({ ...rel, ok: false, error: e.message || "Unknown error" });
+        }
+      }
+      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);
+      const lines = [`# Batch Link Results
+`];
+      lines.push(`**${created.length}** created, **${proposals.length}** proposals, **${failed.length}** failed out of ${relations.length} total.
+`);
+      if (created.length > 0) {
+        lines.push("## Created");
+        for (const r of created) {
+          lines.push(`- **${r.from}** \u2014[${r.type}]\u2192 **${r.to}**`);
+        }
+      }
+      if (proposals.length > 0) {
+        lines.push("");
+        lines.push("## Proposals (governs \u2014 not yet applied)");
+        for (const r of proposals) {
+          lines.push(`- **${r.from}** \u2014[${r.type}]\u2192 **${r.to}** \u2014 proposal \`${r.proposalId}\``);
+        }
+      }
+      if (failed.length > 0) {
+        lines.push("");
+        lines.push("## Failed");
+        for (const r of failed) {
+          lines.push(`- **${r.from}** \u2192 **${r.to}** (${r.type}): _${r.error}_`);
+        }
+      }
+      return { content: [{ type: "text", text: lines.join("\n") }] };
+    }
+  );
+  server.registerTool(
+    "find-related",
+    {
+      title: "Find Related Entries",
+      description: "Navigate the knowledge graph \u2014 find all entries related to a given entry. Shows incoming references (what points to this entry), outgoing references (what this entry points to), or both. Use after get-entry to explore connections, or to answer 'what depends on X?' or 'what references Y?'",
+      inputSchema: {
+        entryId: z.string().describe("Entry ID, e.g. 'GT-019', 'SOS-006'"),
+        direction: z.enum(["incoming", "outgoing", "both"]).default("both").describe("Filter: 'incoming' = what references this entry, 'outgoing' = what this entry references")
+      },
+      annotations: { readOnlyHint: true }
+    },
+    async ({ entryId, direction }) => {
+      const relations = await mcpQuery("chain.listEntryRelations", { entryId });
+      if (relations.length === 0) {
+        return { content: [{ type: "text", text: `No relations found for \`${entryId}\`. Use relate-entries to create connections.` }] };
+      }
+      const sourceEntry = await mcpQuery("chain.getEntry", { entryId });
+      if (!sourceEntry) {
+        return { content: [{ type: "text", text: `Entry \`${entryId}\` not found. Try search to find the right ID.` }] };
+      }
+      const sourceInternalId = sourceEntry._id;
+      const MAX_RELATIONS = 25;
+      const truncated = relations.length > MAX_RELATIONS;
+      const capped = relations.slice(0, MAX_RELATIONS);
+      const otherIds = /* @__PURE__ */ new Set();
+      for (const r of capped) {
+        const otherId = r.fromId === sourceInternalId ? r.toId : r.fromId;
+        otherIds.add(otherId);
+      }
+      const otherEntries = /* @__PURE__ */ new Map();
+      for (const id of otherIds) {
+        const entry = await mcpQuery("chain.getEntry", { id });
+        if (entry) {
+          otherEntries.set(entry._id, { entryId: entry.entryId, name: entry.name, collectionId: entry.collectionId });
+        }
+      }
+      const collections = await mcpQuery("chain.listCollections");
+      const collMap = /* @__PURE__ */ new Map();
+      for (const c of collections) collMap.set(c._id, c.slug);
+      const lines = [`# Relations for ${entryId}: ${sourceEntry.name}`, ""];
+      const enriched = capped.map((r) => {
+        const isOutgoing = r.fromId === sourceInternalId;
+        const otherId = isOutgoing ? r.toId : r.fromId;
+        const other = otherEntries.get(otherId);
+        const otherLabel = other?.entryId ? `${other.entryId}: ${other.name}` : other?.name ?? "(deleted)";
+        const colSlug = other ? collMap.get(other.collectionId) ?? "unknown" : "unknown";
+        return { isOutgoing, type: r.type, otherLabel, colSlug };
+      });
+      const outgoing = enriched.filter((r) => r.isOutgoing);
+      const incoming = enriched.filter((r) => !r.isOutgoing);
+      if ((direction === "outgoing" || direction === "both") && outgoing.length > 0) {
+        lines.push(`## Outgoing (${outgoing.length})`);
+        for (const r of outgoing) {
+          lines.push(`- \u2192 **${r.type}** ${r.otherLabel} [${r.colSlug}]`);
+        }
+        lines.push("");
+      }
+      if ((direction === "incoming" || direction === "both") && incoming.length > 0) {
+        lines.push(`## Incoming (${incoming.length})`);
+        for (const r of incoming) {
+          lines.push(`- \u2190 **${r.type}** ${r.otherLabel} [${r.colSlug}]`);
+        }
+        lines.push("");
+      }
+      const shown = direction === "outgoing" ? outgoing : direction === "incoming" ? incoming : enriched;
+      if (shown.length === 0) {
+        lines.push(`No ${direction} relations found for \`${entryId}\`.`);
+      }
+      if (truncated) {
+        lines.push(`_Showing first ${MAX_RELATIONS} of ${relations.length} relations. Use get-entry for the full picture._`);
+      }
+      return { content: [{ type: "text", text: lines.join("\n") }] };
+    }
+  );
+  server.registerTool(
+    "gather-context",
+    {
+      title: "Gather Context",
+      description: "Assemble knowledge context in one call. Three modes:\n\n1. **By entry** (entryId): Traverse the knowledge graph around a specific entry. Returns all related entries grouped by collection.\n2. **By task** (task): Auto-load relevant domain knowledge for a natural-language task. Searches the chain, traverses the graph, and returns ranked entries with confidence scores.\n3. **Graph mode** (entryId + mode='graph'): Enhanced graph traversal with provenance \u2014 each entry includes the full path that led to it (via what relations, from what starting point).\n\nUse mode 1/3 when you have a specific entry ID. Use mode 2 at the start of a conversation to ground the agent in domain context before writing code or making recommendations.",
+      inputSchema: {
+        entryId: z.string().optional().describe("Entry ID for graph traversal, e.g. 'FEAT-001', 'GT-019'"),
+        task: z.string().optional().describe("Natural-language task description for auto-loading relevant context"),
+        mode: z.enum(["search", "graph"]).default("search").optional().describe("'search' (default, backward-compatible) or 'graph' (enhanced with provenance paths)"),
+        maxHops: z.number().min(1).max(3).default(2).describe("How many relation hops to traverse (1=direct only, 2=default, 3=wide net)"),
+        maxResults: z.number().min(1).max(25).default(10).optional().describe("Max entries to return in task mode (default 10)")
+      },
+      annotations: { readOnlyHint: true }
+    },
+    async ({ entryId, task, mode, maxHops, maxResults }) => {
+      if (!entryId && !task) {
+        return { content: [{ type: "text", text: "Provide either `entryId` (graph traversal) or `task` (auto-load context for a task)." }] };
+      }
+      if (entryId && mode === "graph") {
+        const result2 = await mcpQuery("chain.graphGatherContext", {
+          entryId,
+          maxHops: maxHops ?? 2
+        });
+        if (!result2?.root) {
+          return { content: [{ type: "text", text: `Entry \`${entryId}\` not found. Try search to find the right ID.` }] };
+        }
+        if (result2.context.length === 0) {
+          return {
+            content: [{
+              type: "text",
+              text: `# Context for ${result2.root.entryId}: ${result2.root.name}
+
+_No relations found._ This entry is not yet connected to the knowledge graph.
+
+Use \`suggest-links\` to discover potential connections.`
+            }]
+          };
+        }
+        const byCollection2 = /* @__PURE__ */ new Map();
+        for (const entry of result2.context) {
+          const key = entry.collectionName;
+          if (!byCollection2.has(key)) byCollection2.set(key, []);
+          byCollection2.get(key).push(entry);
+        }
+        const lines2 = [
+          `# Context for ${result2.root.entryId}: ${result2.root.name} (graph mode)`,
+          `_${result2.totalFound} related entries across ${byCollection2.size} collections (${result2.hopsTraversed} hops)_`,
+          ""
+        ];
+        for (const [collName, entries] of byCollection2) {
+          lines2.push(`## ${collName} (${entries.length})`);
+          for (const e of entries) {
+            const arrow = e.relationDirection === "outgoing" ? "\u2192" : "\u2190";
+            const id = e.entryId ? `${e.entryId}: ` : "";
+            const hopLabel = e.hop > 1 ? ` (hop ${e.hop})` : "";
+            const scoreLabel = typeof e.score === "number" ? `  ${e.score}` : "";
+            const flagsLabel = e.scoreFlags?.length ? ` [${e.scoreFlags.join(", ")}]` : "";
+            const provenancePath = e.provenance && e.provenance.length > 1 ? `
+  _Path: ${e.provenance.map((p) => `${p.entryId ?? p.name} [${p.relationType}]`).join(" \u2192 ")}_` : "";
+            const preview = e.preview ? `
+  ${e.preview.substring(0, 120)}` : "";
+            lines2.push(`- ${arrow} **${e.relationType}** ${id}${e.name}${hopLabel}${scoreLabel}${flagsLabel}${provenancePath}${preview}`);
+          }
+          lines2.push("");
+        }
+        return { content: [{ type: "text", text: lines2.join("\n") }] };
+      }
+      if (task && !entryId) {
+        await server.sendLoggingMessage({
+          level: "info",
+          data: `Loading context for task: "${task.substring(0, 80)}..."`,
+          logger: "product-brain"
+        });
+        const result2 = await mcpQuery("chain.taskAwareGatherContext", {
+          task,
+          maxHops: maxHops ?? 2,
+          maxResults: maxResults ?? 15
+        });
+        if (!result2 || result2.totalFound === 0) {
+          return {
+            content: [{
+              type: "text",
+              text: `# Context Loaded
+
+**Confidence:** None
+
+No context found for this task. The chain may not cover this area yet.
+
+_Consider capturing domain knowledge discovered during this task via \`capture\`._`
+            }]
+          };
+        }
+        const byCollection2 = /* @__PURE__ */ new Map();
+        for (const entry of result2.context) {
+          const key = entry.collectionName;
+          if (!byCollection2.has(key)) byCollection2.set(key, []);
+          byCollection2.get(key).push(entry);
+        }
+        const lines2 = [
+          `# Context Loaded`,
+          `**Confidence:** ${result2.confidence.charAt(0).toUpperCase() + result2.confidence.slice(1)}`,
+          `**Matched:** ${result2.totalFound} entries across ${byCollection2.size} collection${byCollection2.size === 1 ? "" : "s"}`,
+          `**Seeds:** ${result2.seeds?.map((s) => s.entryId ?? s.name).join(", ") ?? "none"}`,
+          ""
+        ];
+        for (const [collName, entries] of byCollection2) {
+          lines2.push(`### ${collName} (${entries.length})`);
+          for (const e of entries) {
+            const arrow = e.relationDirection === "outgoing" ? "\u2192" : "\u2190";
+            const id = e.entryId ? `**${e.entryId}:** ` : "";
+            const scoreLabel = typeof e.score === "number" ? `  ${e.score}` : "";
+            const flagsLabel = e.scoreFlags?.length ? ` [${e.scoreFlags.join(", ")}]` : "";
+            const hopLabel = e.hop > 0 ? ` _(hop ${e.hop}, ${arrow} ${e.relationType})_` : "";
+            lines2.push(`- ${id}${e.name}${scoreLabel}${flagsLabel}${hopLabel}`);
+          }
+          lines2.push("");
+        }
+        lines2.push(`_Use \`get-entry\` for full details on any entry._`);
+        return { content: [{ type: "text", text: lines2.join("\n") }] };
+      }
+      const result = await mcpQuery("chain.gatherContext", { entryId, maxHops });
+      if (!result?.root) {
+        return { content: [{ type: "text", text: `Entry \`${entryId}\` not found. Try search to find the right ID.` }] };
+      }
+      if (result.related.length === 0) {
+        return {
+          content: [{
+            type: "text",
+            text: `# Context for ${result.root.entryId}: ${result.root.name}
+
+_No relations found._ This entry is not yet connected to the knowledge graph.
+
+Use \`suggest-links\` to discover potential connections, or \`relate-entries\` to link manually.`
+          }]
+        };
+      }
+      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);
+      }
+      const lines = [
+        `# Context for ${result.root.entryId}: ${result.root.name}`,
+        `_${result.totalRelations} related entries across ${byCollection.size} collections (${result.hopsTraversed} hops traversed)_`,
+        ""
+      ];
+      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 { content: [{ type: "text", text: lines.join("\n") }] };
+    }
+  );
+  server.registerTool(
+    "suggest-links",
+    {
+      title: "Suggest Links",
+      description: "Discover potential connections for an entry using graph-aware intelligence. Accepts an entry ID (e.g. 'FEAT-001') OR an entry name (e.g. 'Chain Intelligence'). Traverses the knowledge graph (2-hop BFS) and scores candidates by graph distance, text similarity, and relation type fit. Also finds text-similar entries not yet in the graph.\n\nReturns ranked suggestions with confidence scores, recommended relation types, and graph-path reasoning explaining WHY each connection matters.\n\nThis is a discovery tool \u2014 review suggestions and use relate-entries to create the ones that make sense.",
+      inputSchema: {
+        entryId: z.string().describe("Entry ID (e.g. 'FEAT-001') or entry name (e.g. 'Chain Intelligence') to find suggestions for"),
+        limit: z.number().min(1).max(20).default(10).describe("Max number of suggestions to return"),
+        depth: z.number().min(1).max(3).default(2).describe("Graph traversal depth: 1=direct neighbors only, 2=default, 3=wide net")
+      },
+      annotations: { readOnlyHint: true }
+    },
+    async ({ entryId, limit, depth }) => {
+      const result = await mcpQuery("chain.graphSuggestLinks", {
+        entryId,
+        maxHops: depth ?? 2,
+        limit: limit ?? 10
+      });
+      if (!result || !result.suggestions || result.suggestions.length === 0) {
+        return { content: [{ type: "text", text: `No suggestions found for \`${entryId}\` \u2014 it may already be well-connected, or no similar entries exist.` }] };
+      }
+      const resolved = result.resolvedEntry;
+      const resolvedLabel = resolved ? `\`${resolved.entryId ?? resolved.name}\` (${resolved.name})` : `\`${entryId}\``;
+      const suggestions = result.suggestions;
+      const graphCount = suggestions.filter((s) => s.graphDistance > 0).length;
+      const textCount = suggestions.filter((s) => s.graphDistance === -1).length;
+      const sourceId = resolved?.entryId ?? entryId;
+      const lines = [
+        `# Link Suggestions for ${resolvedLabel}`,
+        `_${suggestions.length} potential connections (${graphCount} via graph, ${textCount} via text similarity)._`,
+        ""
+      ];
+      const top3 = suggestions.slice(0, 3);
+      lines.push("## Quick Wins (top 3)");
+      const batchArgs = [];
+      for (const s of top3) {
+        const tid = s.entryId ?? "(no ID)";
+        const relType = s.recommendedRelationType || "related_to";
+        lines.push(`- **${tid}**: ${s.name} [${s.collectionSlug}] \u2014 ${s.score}/100 \u2192 \`${relType}\``);
+        if (s.entryId) batchArgs.push(`{from:"${sourceId}",to:"${tid}",type:"${relType}"}`);
+      }
+      lines.push("");
+      if (batchArgs.length > 0) {
+        lines.push(`**Link all 3:** \`batch-relate relations=[${batchArgs.join(",")}]\``);
+        lines.push("");
+      }
+      if (suggestions.length > 3) {
+        lines.push("## All Suggestions");
+        for (let i = 0; i < suggestions.length; i++) {
+          const s = suggestions[i];
+          const scoreBar = "\u2588".repeat(Math.round(s.score / 10)) + "\u2591".repeat(10 - Math.round(s.score / 10));
+          const hopLabel = s.graphDistance > 0 ? `${s.graphDistance}-hop` : "text";
+          const recType = s.recommendedRelationType !== "related_to" ? ` \u2192 \`${s.recommendedRelationType}\`` : "";
+          lines.push(`${i + 1}. **${s.entryId ?? "(no ID)"}**: ${s.name} [${s.collectionSlug}] (${hopLabel})`);
+          lines.push(`   ${scoreBar} ${s.score}/100${recType}`);
+          if (s.preview) {
+            lines.push(`   ${s.preview}`);
+          }
+          lines.push(`   _${s.reasoning}_`);
+        }
+      }
+      lines.push("");
+      lines.push(`**To link one:** \`relate-entries from="${sourceId}" to="{target_id}" type="{type}"\``);
+      lines.push(`**To dismiss:** \`dismiss-suggestion from="${sourceId}" to="{target_id}" type="{type}"\``);
+      return { content: [{ type: "text", text: lines.join("\n") }] };
+    }
+  );
+  server.registerTool(
+    "dismiss-suggestion",
+    {
+      title: "Dismiss Link Suggestion",
+      description: "Record that a suggested link is not relevant. This negative feedback improves future suggestion quality through the weekly weight-tuning cron.\n\nUse after reviewing suggest-links output when a suggestion doesn't make sense.",
+      inputSchema: {
+        from: z.string().describe("Source entry ID"),
+        to: z.string().describe("Suggested target entry ID that was not relevant"),
+        type: z.string().default("related_to").describe("The recommended relation type that was dismissed"),
+        score: z.number().optional().describe("The suggestion score (from suggest-links output)")
+      },
+      annotations: { destructiveHint: false }
+    },
+    async ({ from, to, type, score }) => {
+      requireWriteAccess();
+      const fromEntry = await mcpQuery("chain.getEntry", { entryId: from });
+      if (!fromEntry) {
+        return { content: [{ type: "text", text: `Entry \`${from}\` not found.` }] };
+      }
+      const toEntry = await mcpQuery("chain.getEntry", { entryId: to });
+      if (!toEntry) {
+        return { content: [{ type: "text", text: `Entry \`${to}\` not found.` }] };
+      }
+      await mcpMutation("chain.dismissSuggestion", {
+        fromEntryId: fromEntry._id,
+        suggestedEntryId: toEntry._id,
+        recommendedType: type ?? "related_to",
+        score: score ?? 0
+      });
+      return {
+        content: [{
+          type: "text",
+          text: `Dismissed suggestion: ${from} \u2192 ${to} (${type}). Feedback recorded for scoring improvements.`
+        }]
+      };
+    }
+  );
+  server.registerTool(
+    "create-collection",
+    {
+      title: "Create Collection",
+      description: "Create a new knowledge collection in the workspace. Collections define the structure for entries (like Notion databases or Capacity boards). Provide a slug, name, and field schema.\n\nUse this when setting up a workspace or when the user wants to track a new type of knowledge. Use `list-collections` first to see what already exists.\n\n**Tip:** Provide `purpose` and `navGroup` to improve sidebar placement and AI retrieval quality.",
+      inputSchema: {
+        slug: z.string().describe("URL-safe identifier, e.g. 'glossary', 'tech-debt', 'api-endpoints'"),
+        name: z.string().describe("Display name, e.g. 'Glossary', 'Tech Debt', 'API Endpoints'"),
+        description: z.string().optional().describe("What this collection is for \u2014 helps humans and AI understand the collection"),
+        purpose: z.string().optional().describe("Why this collection exists \u2014 the strategic reason for tracking this knowledge"),
+        icon: z.string().optional().describe("Emoji icon for the collection"),
+        navGroup: z.enum(["daily", "strategic", "governance", "reference", "collections"]).default("collections").describe("Sidebar placement: 'daily' (operational), 'strategic' (planning), 'governance' (authority), 'reference' (lookup), 'collections' (default)"),
+        fields: z.array(z.object({
+          key: z.string().describe("Field key, e.g. 'description', 'severity', 'status'"),
+          label: z.string().describe("Display label, e.g. 'Description', 'Severity'"),
+          type: z.string().describe("Field type: 'string', 'select', 'array', 'number', 'boolean'"),
+          required: z.boolean().optional().describe("Whether this field is required"),
+          options: z.array(z.string()).optional().describe("Options for 'select' type fields"),
+          searchable: z.boolean().optional().describe("Whether this field is included in full-text search")
+        })).describe("Field definitions for the collection schema")
+      },
+      annotations: { destructiveHint: false }
+    },
+    async ({ slug, name, description, purpose, icon, navGroup, fields }) => {
+      requireWriteAccess();
+      try {
+        await mcpMutation("chain.createCollection", {
+          slug,
+          name,
+          description,
+          purpose,
+          icon,
+          navGroup: navGroup ?? "collections",
+          fields,
+          createdBy: getAgentSessionId() ? `agent:${getAgentSessionId()}` : "mcp"
+        });
+        const fieldList = fields.map((f) => `  - \`${f.key}\` (${f.type}${f.required ? ", required" : ""}${f.searchable ? ", searchable" : ""})`).join("\n");
+        return {
+          content: [{
+            type: "text",
+            text: `# Collection Created: ${name}
+
+**Slug:** \`${slug}\`
+` + (description ? `**Description:** ${description}
+` : "") + (purpose ? `**Purpose:** ${purpose}
+` : "") + `**Nav group:** ${navGroup ?? "collections"}
+
+**Fields:**
+${fieldList}
+
+You can now capture entries: \`capture collection="${slug}" name="..." description="..."\``
+          }]
+        };
+      } catch (error) {
+        const msg = error instanceof Error ? error.message : String(error);
+        if (msg.includes("already exists")) {
+          return {
+            content: [{
+              type: "text",
+              text: `Collection \`${slug}\` already exists. Use \`update-collection\` to modify it, or choose a different slug.`
+            }]
+          };
+        }
+        throw error;
+      }
+    }
+  );
+  server.registerTool(
+    "update-collection",
+    {
+      title: "Update Collection",
+      description: "Update an existing collection's name, description, purpose, icon, navGroup, or field schema. Only provide the fields you want to change. Use `list-collections` to see current state.",
+      inputSchema: {
+        slug: z.string().describe("Collection slug to update, e.g. 'glossary', 'tech-debt'"),
+        name: z.string().optional().describe("New display name"),
+        description: z.string().optional().describe("New description"),
+        purpose: z.string().optional().describe("New purpose \u2014 why this collection exists"),
+        icon: z.string().optional().describe("New emoji icon"),
+        navGroup: z.enum(["daily", "strategic", "governance", "reference", "collections"]).optional().describe("New sidebar placement"),
+        fields: z.array(z.object({
+          key: z.string(),
+          label: z.string(),
+          type: z.string(),
+          required: z.boolean().optional(),
+          options: z.array(z.string()).optional(),
+          searchable: z.boolean().optional()
+        })).optional().describe("Replacement field schema (replaces all fields \u2014 include existing fields you want to keep)")
+      },
+      annotations: { destructiveHint: false }
+    },
+    async ({ slug, name, description, purpose, icon, navGroup, fields }) => {
+      requireWriteAccess();
+      await mcpMutation("chain.updateCollection", {
+        slug,
+        ...name !== void 0 && { name },
+        ...description !== void 0 && { description },
+        ...purpose !== void 0 && { purpose },
+        ...icon !== void 0 && { icon },
+        ...navGroup !== void 0 && { navGroup },
+        ...fields !== void 0 && { fields }
+      });
+      const changes = [name && "name", description && "description", purpose && "purpose", icon && "icon", navGroup && "navGroup", fields && "fields"].filter(Boolean).join(", ");
+      return {
+        content: [{
+          type: "text",
+          text: `# Collection Updated: \`${slug}\`
+
+Changed: ${changes || "no changes"}.
+
+Use \`list-collections\` to verify the result.`
+        }]
+      };
+    }
+  );
+  server.registerTool(
+    "commit-entry",
+    {
+      title: "Commit Entry to Chain",
+      description: "Promote a draft entry to committed status (SSOT on the Chain). Runs a keyword contradiction check against governance entries before committing. Warnings are advisory \u2014 they do not block the commit.\n\nUse after capture + suggest-links + relate-entries to finalize an entry.",
+      inputSchema: {
+        entryId: z.string().describe("Entry ID to commit, e.g. 'TEN-abc123', 'GT-019'")
+      },
+      annotations: { destructiveHint: false }
+    },
+    async ({ entryId }) => {
+      requireWriteAccess();
+      const { runContradictionCheck } = await import("./smart-capture-2N7E4OAJ.js");
+      const entry = await mcpQuery("chain.getEntry", { entryId });
+      if (!entry) {
+        return {
+          content: [{ type: "text", text: `Entry \`${entryId}\` not found. Try search to find the right ID.` }]
+        };
+      }
+      const descField = entry.data?.description ?? entry.data?.canonical ?? entry.data?.rationale ?? "";
+      const warnings = await runContradictionCheck(entry.name, descField);
+      if (warnings.length > 0) {
+        await recordSessionActivity({ contradictionWarning: true });
+      }
+      const result = await mcpMutation("chain.commitEntry", {
+        entryId,
+        author: getAgentSessionId() ? `agent:${getAgentSessionId()}` : void 0
+      });
+      const docId = result?._id ?? entry._id;
+      await recordSessionActivity({ entryModified: docId });
+      const wsCtx = await getWorkspaceContext();
+      let lines;
+      if (result?.status === "proposal_created") {
+        lines = [
+          `# Proposal created: ${result.entryId ?? entryId}`,
+          `**${result.name ?? entry.name}** \u2014 commit requires consent. A proposal was created instead of committing directly.`,
+          `**Workspace:** ${wsCtx.workspaceSlug} (${wsCtx.workspaceId})`,
+          "",
+          result.existing ? "An open proposal for this entry already exists." : "Affected owners will be notified. The entry will be committed when the consent window expires with no objections, or when all owners approve."
+        ];
+      } else {
+        lines = [
+          `# Committed: ${entryId}`,
+          `**${entry.name}** promoted to SSOT on the Chain.`,
+          `**Workspace:** ${wsCtx.workspaceSlug} (${wsCtx.workspaceId})`
+        ];
+      }
+      if (warnings.length > 0) {
+        lines.push("");
+        lines.push("\u26A0 Contradiction check: proposed entry matched existing governance entries:");
+        for (const w of warnings) {
+          lines.push(`- ${w.name} (${w.collection}, ${w.entryId}) \u2014 has 'governs' relation to ${w.governsCount} entries`);
+        }
+        lines.push("Run gather-context on these entries before committing.");
+      }
+      return { content: [{ type: "text", text: lines.join("\n") }] };
+    }
+  );
+}
+
+// src/tools/labels.ts
+import { z as z2 } from "zod";
+function registerLabelTools(server) {
+  server.registerTool(
+    "labels",
+    {
+      title: "Labels",
+      description: "Manage workspace labels \u2014 list, create, update, delete, apply to entries, or remove from entries. Labels can be applied to any entry across any collection for cross-domain filtering. Similar to labels in Linear or GitHub. Labels support hierarchy (groups with children).",
+      inputSchema: {
+        action: z2.enum(["list", "create", "update", "delete", "apply", "remove"]).describe("Action: list all labels, create/update/delete a label, or apply/remove a label on an entry"),
+        slug: z2.string().optional().describe("Label slug (required for create/update/delete/apply/remove)"),
+        name: z2.string().optional().describe("Display name (required for create)"),
+        color: z2.string().optional().describe("Hex color, e.g. '#ef4444'"),
+        description: z2.string().optional().describe("What this label means"),
+        parentSlug: z2.string().optional().describe("Parent group slug for label hierarchy"),
+        isGroup: z2.boolean().optional().describe("True if this is a group container, not a taggable label"),
+        order: z2.number().optional().describe("Sort order within its group"),
+        entryId: z2.string().optional().describe("Entry ID for apply/remove actions")
+      }
+    },
+    async ({ action, slug, name, color, description, parentSlug, isGroup, order, entryId }) => {
+      if (action === "list") {
+        const labels = await mcpQuery("chain.listLabels");
+        if (labels.length === 0) {
+          return { content: [{ type: "text", text: "No labels defined in this workspace yet." }] };
+        }
+        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 = ["# Workspace Labels"];
+        for (const group of groups) {
+          lines.push(`
+## ${group.name}`);
+          if (group.description) lines.push(`_${group.description}_`);
+          for (const child of children(group._id)) {
+            const c = child.color ? ` ${child.color}` : "";
+            lines.push(`  - \`${child.slug}\` ${child.name}${c}`);
+          }
+        }
+        if (ungrouped.length > 0) {
+          lines.push("\n## Ungrouped");
+          for (const label of ungrouped) {
+            const c = label.color ? ` ${label.color}` : "";
+            lines.push(`- \`${label.slug}\` ${label.name}${c}${label.description ? ` \u2014 _${label.description}_` : ""}`);
+          }
+        }
+        return { content: [{ type: "text", text: lines.join("\n") }] };
+      }
+      if (!slug) {
+        return { content: [{ type: "text", text: "A `slug` is required for this action." }] };
+      }
+      if (action === "create") {
+        if (!name) {
+          return { content: [{ type: "text", text: "Cannot create a label without a name." }] };
+        }
+        let parentId;
+        if (parentSlug) {
+          const labels = await mcpQuery("chain.listLabels");
+          const parent = labels.find((l) => l.slug === parentSlug);
+          if (!parent) {
+            return { content: [{ type: "text", text: `Parent label \`${parentSlug}\` not found. Use \`labels action=list\` to see available groups.` }] };
+          }
+          parentId = parent._id;
+        }
+        await mcpMutation("chain.createLabel", { slug, name, color, description, parentId, isGroup, order });
+        return { content: [{ type: "text", text: `# Label Created
+
+**${name}** (\`${slug}\`)` }] };
+      }
+      if (action === "update") {
+        await mcpMutation("chain.updateLabel", { slug, name, color, description, isGroup, order });
+        return { content: [{ type: "text", text: `# Label Updated
+
+\`${slug}\` has been updated.` }] };
+      }
+      if (action === "delete") {
+        await mcpMutation("chain.deleteLabel", { slug });
+        return { content: [{ type: "text", text: `# Label Deleted
+
+\`${slug}\` removed from all entries and deleted.` }] };
+      }
+      if (action === "apply" || action === "remove") {
+        if (!entryId) {
+          return { content: [{ type: "text", text: "An `entryId` is required for apply/remove actions." }] };
+        }
+        if (action === "apply") {
+          await mcpMutation("chain.applyLabel", { entryId, labelSlug: slug });
+          return { content: [{ type: "text", text: `Label \`${slug}\` applied to **${entryId}**.` }] };
+        }
+        await mcpMutation("chain.removeLabel", { entryId, labelSlug: slug });
+        return { content: [{ type: "text", text: `Label \`${slug}\` removed from **${entryId}**.` }] };
+      }
+      return { content: [{ type: "text", text: "Unknown action." }] };
+    }
+  );
+}
+
+// src/tools/health.ts
+import { z as z3 } from "zod";
+
+// src/tools/planned-work.ts
+async function queryPlannedWork() {
+  const result = {
+    uncommittedDrafts: [],
+    inProgressEntries: [],
+    openTensions: []
+  };
+  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") {
+        if (collection === "tensions") {
+          result.openTensions.push({ name: entry.name, entryId: entry.entryId ?? entry._id });
+        } else {
+          result.uncommittedDrafts.push({ name: entry.name, collection });
+        }
+      }
+      if (entry.status === "in-progress" || entry.status === "in_progress") {
+        result.inProgressEntries.push({
+          name: entry.name,
+          collection,
+          entryId: entry.entryId ?? entry._id
+        });
+      }
+    }
+  } catch {
+  }
+  return result;
+}
+function hasPlannedWork(work) {
+  return work.uncommittedDrafts.length > 0 || work.inProgressEntries.length > 0 || work.openTensions.length > 0;
+}
+function buildPlannedWorkSection(work, priorSessions) {
+  if (!hasPlannedWork(work) && priorSessions.length === 0) return [];
+  const lines = [];
+  lines.push("## Continue from where you left off");
+  lines.push("");
+  if (work.inProgressEntries.length > 0) {
+    const top = work.inProgressEntries[0];
+    lines.push(`- **Active: ${top.name}** (${top.collection}) \u2014 want to continue?`);
+    for (const entry of work.inProgressEntries.slice(1, 3)) {
+      lines.push(`- ${entry.name} (${entry.collection})`);
+    }
+    if (work.inProgressEntries.length > 3) {
+      lines.push(`- _...and ${work.inProgressEntries.length - 3} more in progress_`);
+    }
+  }
+  if (work.uncommittedDrafts.length > 0) {
+    const count = work.uncommittedDrafts.length;
+    const label = count === 1 ? "1 uncommitted draft" : `${count} uncommitted drafts`;
+    const topNames = work.uncommittedDrafts.slice(0, 3).map((d) => d.name).join(", ");
+    lines.push(`- **${label}** \u2014 ${topNames}${count > 3 ? ", ..." : ""}`);
+  }
+  if (work.openTensions.length > 0) {
+    const top = work.openTensions[0];
+    const count = work.openTensions.length;
+    if (count === 1) {
+      lines.push(`- **Open tension: ${top.name}** \u2014 discuss or capture a decision?`);
+    } else {
+      lines.push(`- **${count} open tensions** \u2014 top: ${top.name}`);
+    }
+  }
+  if (priorSessions.length > 0 && !hasPlannedWork(work)) {
+    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;
+    if (created > 0 || modified > 0) {
+      lines.push(`- **Last session** (${date}): ${created} created, ${modified} modified`);
+    }
+  }
+  lines.push("");
+  return lines;
+}
+
+// src/tools/health.ts
+var CALL_CATEGORIES = {
+  "chain.getEntry": "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 registerHealthTools(server) {
+  server.registerTool(
+    "health",
+    {
+      title: "Health Check",
+      description: "Verify that Product Brain is running and can reach its backend. Returns workspace status, collection count, entry count, and latency. Use this to confirm connectivity before doing real work.",
+      annotations: { readOnlyHint: true }
+    },
+    async () => {
+      const start = Date.now();
+      const errors = [];
+      let workspaceId;
+      try {
+        workspaceId = await getWorkspaceId();
+      } catch (e) {
+        errors.push(`Workspace resolution failed: ${e.message}`);
+      }
+      let collections = [];
+      try {
+        collections = await mcpQuery("chain.listCollections");
+      } catch (e) {
+        errors.push(`Collection fetch failed: ${e.message}`);
+      }
+      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.message}`);
+        }
+      }
+      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}`);
+        }
+      }
+      return { content: [{ type: "text", text: lines.join("\n") }] };
+    }
+  );
+  server.registerTool(
+    "whoami",
+    {
+      title: "Session Identity",
+      description: "Returns the current workspace and auth context for this MCP session. Use at the start of a session to confirm you're operating on the right workspace before making writes.",
+      annotations: { readOnlyHint: true }
+    },
+    async () => {
+      const ctx = await getWorkspaceContext();
+      const lines = [
+        `# Session Identity`,
+        "",
+        `**Workspace ID:** ${ctx.workspaceId}`,
+        `**Workspace Slug:** ${ctx.workspaceSlug}`,
+        `**Workspace Name:** ${ctx.workspaceName}`
+      ];
+      return { content: [{ type: "text", text: lines.join("\n") }] };
+    }
+  );
+  server.registerTool(
+    "workspace-status",
+    {
+      title: "Workspace Status",
+      description: "The 'Monday morning' tool \u2014 returns workspace readiness score, specific gaps with suggested next actions, and workspace stats (entries, relations, orphans, drafts).\n\nUse this to understand how ready the workspace is, what foundational knowledge is missing, and what to work on next. Great for starting a session or planning knowledge work.",
+      annotations: { readOnlyHint: true }
+    },
+    async () => {
+      const result = await mcpQuery("chain.workspaceReadiness");
+      const { score, totalChecks, passedChecks, checks, gaps, stats, governanceMode } = result;
+      const scoreBar = "\u2588".repeat(Math.round(score / 10)) + "\u2591".repeat(10 - Math.round(score / 10));
+      const lines = [
+        `# Workspace Readiness: ${score}%`,
+        `${scoreBar} ${passedChecks}/${totalChecks} requirements met`,
+        `
+**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 (action required)");
+        for (const gap of gaps) {
+          lines.push(`- [ ] **${gap.label}** \u2014 ${gap.description}`);
+          lines.push(`  ${gap.current}/${gap.required} | _${gap.guidance}_`);
+        }
+        lines.push("");
+      }
+      const passed = checks.filter((c) => c.passed);
+      if (passed.length > 0) {
+        lines.push("## Passed");
+        for (const check of passed) {
+          lines.push(`- [x] **${check.label}** (${check.current}/${check.required})`);
+        }
+      }
+      return { content: [{ type: "text", text: lines.join("\n") }] };
+    }
+  );
+  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.",
+      annotations: { readOnlyHint: true }
+    },
+    async () => {
+      const errors = [];
+      const agentSessionId = getAgentSessionId();
+      let wsCtx = null;
+      try {
+        wsCtx = await getWorkspaceContext();
+      } catch (e) {
+        errors.push(`Workspace: ${e.message}`);
+      }
+      let priorSessions = [];
+      if (wsCtx) {
+        try {
+          priorSessions = await mcpQuery("agent.recentSessions", { limit: 3 });
+        } catch {
+        }
+      }
+      let orientEntries = null;
+      try {
+        orientEntries = await mcpQuery("chain.getOrientEntries");
+      } catch {
+      }
+      let openTensions = [];
+      try {
+        const tensions = await mcpQuery("chain.listEntries", { collectionSlug: "tensions" });
+        openTensions = (tensions ?? []).filter((e) => e.status === "draft");
+      } catch {
+      }
+      let readiness = null;
+      try {
+        readiness = await mcpQuery("chain.workspaceReadiness");
+      } catch (e) {
+        errors.push(`Readiness: ${e.message}`);
+      }
+      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 (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 but is only ${readiness.score}% ready.`);
+          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(`Readiness: ${readiness.score}% (${readiness.passedChecks}/${readiness.totalChecks}).`);
+        lines.push("");
+        const gaps = readiness.gaps ?? [];
+        if (gaps.length > 0) {
+          const gap = gaps[0];
+          const ctaMap = {
+            "strategy-vision": "Tell me what you're building \u2014 your vision, mission, and north star \u2014 and I'll capture it.",
+            "architecture-layers": "Describe your architecture in a few sentences and I'll capture it.",
+            "glossary-foundation": "What are the key terms your team uses? Tell me a few and I'll add them to the glossary.",
+            "decisions-documented": "What's a recent significant decision your team made? I'll document it with the rationale.",
+            "tensions-tracked": "What's a friction point or pain point you're dealing with? I'll capture it as a tension."
+          };
+          const cta = ctaMap[gap.id] ?? `Tell me about your ${gap.label.toLowerCase()} and I'll capture it.`;
+          lines.push("## Recommended next step");
+          lines.push(`**${gap.label}** (${gap.current}/${gap.required})`);
+          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 `create-collection` to add it, or ask me to propose collections for your domain._");
+        lines.push("");
+      } else if (readiness) {
+        lines.push(`Readiness: ${readiness.score}% (${readiness.passedChecks}/${readiness.totalChecks}).`);
+        lines.push("");
+        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");
+            orientEntries.activeBets.forEach((e) => lines.push(fmt(e)));
+            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("");
+          }
+          if (orientEntries.businessRules.length > 0) {
+            lines.push("## Business rules");
+            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 plannedWork = await queryPlannedWork();
+        if (hasPlannedWork(plannedWork)) {
+          lines.push(...buildPlannedWorkSection(plannedWork, priorSessions));
+        } else {
+          const briefingItems = [];
+          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;
+            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("");
+          }
+        }
+        lines.push("What would you like to work on?");
+        lines.push("");
+      }
+      if (errors.length > 0) {
+        lines.push("## Errors");
+        for (const err of errors) lines.push(`- ${err}`);
+        lines.push("");
+      }
+      if (agentSessionId) {
+        try {
+          await mcpCall("agent.markOriented", { sessionId: agentSessionId });
+          setSessionOriented(true);
+          lines.push("---");
+          lines.push(`Orientation complete. Session ${agentSessionId}. Write tools available.`);
+        } catch {
+          lines.push("---");
+          lines.push("_Warning: Could not mark session as oriented. Write tools may be restricted._");
+        }
+        try {
+          await mcpMutation("chain.recordSessionSignal", {
+            sessionId: agentSessionId,
+            signalType: "immediate_context_load",
+            metadata: { source: "orient" }
+          });
+        } catch (err) {
+          process.stderr.write(`[MCP] recordSessionSignal failed: ${err.message}
+`);
+        }
+      } else {
+        lines.push("---");
+        lines.push("_No active agent session. Call `agent-start` to begin a tracked session._");
+      }
+      return { content: [{ type: "text", text: lines.join("\n") }] };
+    }
+  );
+  server.registerTool(
+    "mcp-audit",
+    {
+      title: "Session Audit Log",
+      description: "Show a session summary (reads, writes, searches, contributions) and the last N backend calls. Useful for debugging, tracing tool behavior, and seeing what you contributed to the chain.",
+      inputSchema: {
+        limit: z3.number().min(1).max(50).default(20).describe("How many recent calls to show (max 50)")
+      },
+      annotations: { readOnlyHint: true }
+    },
+    async ({ limit }) => {
+      const log = getAuditLog();
+      const recent = log.slice(-limit);
+      if (recent.length === 0) {
+        return { content: [{ type: "text", text: "No calls recorded yet this session." }] };
+      }
+      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}` : "";
+        logLines.push(`${icon} \`${entry.fn}\` ${entry.durationMs}ms ${entry.status}${errPart}`);
+      }
+      return {
+        content: [{ type: "text", text: `${summary}
+
+---
+
+${logLines.join("\n")}` }]
+      };
+    }
+  );
+}
+
+// src/tools/verify.ts
+import { existsSync, readFileSync } from "fs";
+import { resolve } from "path";
+import { z as z4 } from "zod";
+function resolveProjectRoot() {
+  const candidates = [
+    process.env.WORKSPACE_PATH,
+    process.cwd(),
+    resolve(process.cwd(), "..")
+  ].filter(Boolean);
+  for (const dir of candidates) {
+    const resolved = resolve(dir);
+    if (existsSync(resolve(resolved, "convex/schema.ts"))) return resolved;
+  }
+  return null;
+}
+function parseConvexSchema(schemaPath) {
+  const content = readFileSync(schemaPath, "utf-8");
+  const tables = /* @__PURE__ */ new Map();
+  let currentTable = null;
+  for (const line of content.split("\n")) {
+    const tableMatch = line.match(/^\t(\w+):\s*defineTable\(/);
+    if (tableMatch) {
+      currentTable = tableMatch[1];
+      tables.set(currentTable, /* @__PURE__ */ new Set());
+      continue;
+    }
+    if (currentTable && /^\t[}\)]/.test(line) && !/^\t\t/.test(line)) {
+      currentTable = null;
+      continue;
+    }
+    if (currentTable) {
+      const fieldMatch = line.match(/^\t\t(\w+):\s*v\./);
+      if (fieldMatch) tables.get(currentTable).add(fieldMatch[1]);
+    }
+  }
+  return tables;
+}
+function cleanFieldRef(field) {
+  return field.replace(/\s*\(.*\)\s*$/, "").replace(/\s*=\s*.*$/, "").trim();
+}
+function splitMultiRefs(field) {
+  if (field.includes(" + ")) return field.split(/\s*\+\s*/);
+  return [field];
+}
+var FILE_EXT_RE = /\.(ts|js|svelte|json|css|md|jsx|tsx|mjs|cjs)(?:\s|$)/i;
+function classifyRef(cleaned) {
+  if (cleaned.includes("/") || FILE_EXT_RE.test(cleaned) || /^\.\w+/.test(cleaned)) {
+    return "file";
+  }
+  if (/^\w+\.\w+$/.test(cleaned)) return "schema";
+  if (/^\w+\s+table$/i.test(cleaned)) return "schema";
+  return "conceptual";
+}
+function checkFileRef(ref, root) {
+  const filePart = ref.split(/\s+/)[0];
+  const fullPath = resolve(root, filePart);
+  if (existsSync(fullPath)) return { result: "verified", reason: "exists" };
+  return { result: "drifted", reason: `not found: ${filePart}` };
+}
+function checkSchemaRef(ref, schema) {
+  const tableOnlyMatch = ref.match(/^(\w+)\s+table$/i);
+  if (tableOnlyMatch) {
+    const table = tableOnlyMatch[1];
+    if (schema.has(table)) return { result: "verified", reason: `table "${table}" exists` };
+    return { result: "drifted", reason: `table "${table}" not found in schema` };
+  }
+  const dotIdx = ref.indexOf(".");
+  if (dotIdx > 0) {
+    const table = ref.slice(0, dotIdx);
+    const field = ref.slice(dotIdx + 1);
+    if (!schema.has(table)) return { result: "drifted", reason: `table "${table}" not found in schema` };
+    if (!schema.get(table).has(field)) return { result: "drifted", reason: `field "${field}" not found in table "${table}"` };
+    return { result: "verified", reason: `${table}.${field} exists` };
+  }
+  return { result: "unverifiable", reason: "could not parse schema reference" };
+}
+function formatTrustReport(collection, entryCount, mappings, refs, fixes, mode, schemaTableCount, projectRoot) {
+  const verified = mappings.filter((c) => c.result === "verified").length;
+  const drifted = mappings.filter((c) => c.result === "drifted").length;
+  const unverifiable = mappings.filter((c) => c.result === "unverifiable").length;
+  const refsValid = refs.filter((c) => c.found).length;
+  const refsBroken = refs.filter((c) => !c.found).length;
+  const totalChecks = mappings.length + refs.length;
+  const totalPassed = verified + refsValid;
+  const trustScore = totalChecks > 0 ? Math.round(totalPassed / totalChecks * 100) : 100;
+  const lines = [
+    `# Trust Report: ${collection} (${entryCount} entries scanned)`,
+    ""
+  ];
+  if (mappings.length > 0) {
+    lines.push(
+      "## Code Mapping Verification",
+      `- ${mappings.length} mappings checked`,
+      `- ${verified} verified (${Math.round(verified / mappings.length * 100)}%)`,
+      `- ${drifted} drifted (file/schema not found)`,
+      `- ${unverifiable} unverifiable (conceptual \u2014 skipped)`,
+      ""
+    );
+  }
+  if (drifted > 0) {
+    lines.push("### Drifted Mappings");
+    for (const mc of mappings.filter((c) => c.result === "drifted")) {
+      lines.push(`- **${mc.entryId}** (${mc.entryName}): \`${mc.field}\` \u2014 ${mc.reason}`);
+    }
+    lines.push("");
+  }
+  if (unverifiable > 0) {
+    lines.push("### Unverifiable (Conceptual)");
+    for (const mc of mappings.filter((c) => c.result === "unverifiable")) {
+      lines.push(`- **${mc.entryId}** (${mc.entryName}): \`${mc.field}\``);
+    }
+    lines.push("");
+  }
+  if (refs.length > 0) {
+    lines.push(
+      "## Cross-Reference Verification",
+      `- ${refs.length} references checked`,
+      `- ${refsValid} valid (${refs.length > 0 ? Math.round(refsValid / refs.length * 100) : 0}%)`,
+      `- ${refsBroken} broken`,
+      ""
+    );
+  }
+  if (refsBroken > 0) {
+    lines.push("### Broken References");
+    for (const rc of refs.filter((c) => !c.found)) {
+      lines.push(`- **${rc.entryId}** (${rc.entryName}): relatedRules \`${rc.refValue}\` \u2014 entry not found`);
+    }
+    lines.push("");
+  }
+  lines.push(`## Trust Score: ${trustScore}% (${totalPassed} of ${totalChecks} checks passed)`);
+  if (mode === "fix" && fixes.length > 0) {
+    lines.push(
+      "",
+      "## Applied Fixes",
+      `Updated codeMapping status from \`aligned\` \u2192 \`drifted\` on ${fixes.length} entr${fixes.length === 1 ? "y" : "ies"}:`
+    );
+    for (const eid of fixes) lines.push(`- ${eid}`);
+  } else if (mode === "report" && drifted > 0) {
+    const fixable = mappings.filter((c) => c.result === "drifted" && c.currentStatus === "aligned").length;
+    if (fixable > 0) {
+      lines.push("", `_${fixable} mapping(s) marked "aligned" but actually drifted. Run with mode="fix" to update._`);
+    }
+  }
+  lines.push("", "---", `_Schema: ${schemaTableCount} tables parsed from convex/schema.ts. Project root: ${projectRoot}_`);
+  return lines.join("\n");
+}
+function registerVerifyTools(server) {
+  server.registerTool(
+    "verify",
+    {
+      title: "Verify the Chain",
+      description: "Verify knowledge entries against the actual codebase. Checks glossary code mappings (do referenced files and schema fields still exist?) and validates cross-references (do relatedRules point to real entries?). Produces a trust report with a trust score. Use mode='fix' to auto-update drifted codeMapping statuses.",
+      inputSchema: {
+        collection: z4.string().default("glossary").describe("Collection slug to verify (default: glossary)"),
+        mode: z4.enum(["report", "fix"]).default("report").describe("'report' = read-only trust report. 'fix' = also update drifted codeMapping statuses.")
+      },
+      annotations: { readOnlyHint: false }
+    },
+    async ({ collection, mode }) => {
+      const projectRoot = resolveProjectRoot();
+      if (!projectRoot) {
+        return {
+          content: [{
+            type: "text",
+            text: "# Verification Failed\n\nCannot find project root (looked for `convex/schema.ts` in cwd and parent directory).\n\nSet `WORKSPACE_PATH` in `.env.mcp` to the absolute path of the Product Brain project root."
+          }]
+        };
+      }
+      const schema = parseConvexSchema(resolve(projectRoot, "convex/schema.ts"));
+      await server.sendLoggingMessage({
+        level: "info",
+        data: `Verifying "${collection}" against ${schema.size} schema tables at ${projectRoot}`,
+        logger: "product-os"
+      });
+      const scopedEntries = await mcpQuery("chain.listEntries", { collectionSlug: collection });
+      if (scopedEntries.length === 0) {
+        return {
+          content: [{ type: "text", text: `No entries found in \`${collection}\`. Nothing to verify.` }]
+        };
+      }
+      let allEntryIds;
+      try {
+        const allEntries = await mcpQuery("chain.listEntries", {});
+        allEntryIds = new Set(allEntries.map((e) => e.entryId).filter(Boolean));
+      } catch {
+        allEntryIds = new Set(scopedEntries.map((e) => e.entryId).filter(Boolean));
+      }
+      const mappingChecks = [];
+      const refChecks = [];
+      for (const entry of scopedEntries) {
+        const eid = entry.entryId ?? entry.name;
+        const ename = entry.name;
+        const codeMappings = entry.data?.codeMapping ?? [];
+        for (const cm of codeMappings) {
+          const rawField = cm.field ?? "";
+          for (const rawRef of splitMultiRefs(rawField)) {
+            const cleaned = cleanFieldRef(rawRef);
+            if (!cleaned) continue;
+            const kind = classifyRef(cleaned);
+            let result;
+            let reason;
+            if (kind === "file") {
+              ({ result, reason } = checkFileRef(cleaned, projectRoot));
+            } else if (kind === "schema") {
+              ({ result, reason } = checkSchemaRef(cleaned, schema));
+            } else {
+              result = "unverifiable";
+              reason = "conceptual reference";
+            }
+            mappingChecks.push({
+              entryId: eid,
+              entryName: ename,
+              field: rawRef.trim(),
+              kind,
+              result,
+              reason,
+              currentStatus: cm.status ?? "unknown"
+            });
+          }
+        }
+        const MAX_CROSS_REFS = 50;
+        const relatedRules = entry.data?.relatedRules ?? [];
+        for (const ruleId of relatedRules) {
+          if (refChecks.length >= MAX_CROSS_REFS) break;
+          refChecks.push({
+            entryId: eid,
+            entryName: ename,
+            refValue: ruleId,
+            found: allEntryIds.has(ruleId)
+          });
+        }
+      }
+      const fixes = [];
+      if (mode === "fix") {
+        const driftedByEntry = /* @__PURE__ */ new Map();
+        for (const mc of mappingChecks) {
+          if (mc.result === "drifted" && mc.currentStatus === "aligned") {
+            if (!driftedByEntry.has(mc.entryId)) driftedByEntry.set(mc.entryId, /* @__PURE__ */ new Set());
+            driftedByEntry.get(mc.entryId).add(mc.field);
+          }
+        }
+        for (const [eid, driftedFields] of driftedByEntry) {
+          const entry = scopedEntries.find((e) => (e.entryId ?? e.name) === eid);
+          if (!entry?.entryId) continue;
+          const updated = (entry.data?.codeMapping ?? []).map(
+            (cm) => cm.status === "aligned" && driftedFields.has(cm.field) ? { ...cm, status: "drifted" } : cm
+          );
+          await mcpMutation("chain.updateEntry", {
+            entryId: entry.entryId,
+            data: { codeMapping: updated }
+          });
+          fixes.push(entry.entryId);
+        }
+      }
+      const report = formatTrustReport(
+        collection,
+        scopedEntries.length,
+        mappingChecks,
+        refChecks,
+        fixes,
+        mode,
+        schema.size,
+        projectRoot
+      );
+      return { content: [{ type: "text", text: report }] };
+    }
+  );
+}
+
+// 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 { z as z5 } 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" }
+];
+var ARCHITECTURE_CANONICAL_KEY = "architecture_note";
+async function ensureCollection() {
+  const collections = await mcpQuery("chain.listCollections");
+  const existing = collections.find((c) => c.slug === COLLECTION_SLUG);
+  if (existing) {
+    if (!existing.defaultCanonicalKey) {
+      await mcpMutation("chain.updateCollection", {
+        slug: COLLECTION_SLUG,
+        defaultCanonicalKey: ARCHITECTURE_CANONICAL_KEY
+      });
+    }
+    return;
+  }
+  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));
+}
+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" } }
+];
+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: {
+        action: z5.enum(["show", "explore", "flow"]).describe("Action: show full map, explore a layer, or visualize a flow"),
+        template: z5.string().optional().describe("Template entry ID to filter by (for show)"),
+        layer: z5.string().optional().describe("Layer name or entry ID (for explore), e.g. 'Core' or 'ARCH-layer-core'"),
+        flow: z5.string().optional().describe("Flow name or entry ID (for flow), e.g. 'Smart Capture Flow'")
+      },
+      annotations: { readOnlyHint: true }
+    },
+    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."
+            }]
+          };
+        }
+        const textLayers = layers.map((l) => formatLayerText(l, nodes)).join("\n\n");
+        const textFlows = flows.length > 0 ? "\n\n---\n\n## Data Flows\n\n" + flows.map(
+          (f) => `- **${f.name}**: ${f.data?.description ?? ""}`
+        ).join("\n") : "";
+        const text = `# ${templateName}
+
+${textLayers}${textFlows}`;
+        const html = renderArchitectureHtml(layers, nodes, flows, templateName);
+        return {
+          content: [
+            { type: "text", text },
+            { type: "resource", resource: { uri: `ui://product-os/architecture`, mimeType: "text/html", text: html } }
+          ]
+        };
+      }
+      if (action === "explore") {
+        if (!layer) return { content: [{ type: "text", text: "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}` }] };
+        }
+        const nodes = byTag(all, "node").filter((n) => n.data?.layerRef === target.entryId);
+        const flows = byTag(all, "flow").filter(
+          (f) => nodes.some((n) => n.entryId === f.data?.sourceNode || n.entryId === f.data?.targetNode)
+        );
+        const depRule = target.data?.dependsOn ? `
+**Dependency rule:** May import from ${target.data.dependsOn === "none" ? "nothing (foundation layer)" : target.data.dependsOn}.
+` : "";
+        const layerRationale = target.data?.rationale ? `
+> ${target.data.rationale}
+` : "";
+        const nodeDetail = nodes.map((n) => {
+          const lines = [`#### ${n.data?.icon ?? "\u25FB"} ${n.name}`];
+          if (n.data?.description) lines.push(String(n.data.description));
+          if (n.data?.owner) lines.push(`**Owner:** ${n.data.owner}`);
+          if (n.data?.filePaths) lines.push(`**Files:** \`${n.data.filePaths}\``);
+          if (n.data?.rationale) lines.push(`
+**Why here?** ${n.data.rationale}`);
+          return lines.join("\n");
+        }).join("\n\n");
+        const flowLines = flows.length > 0 ? "\n\n### Connected Flows\n\n" + flows.map((f) => `- ${f.name}: ${f.data?.description ?? ""}`).join("\n") : "";
+        return {
+          content: [{
+            type: "text",
+            text: `# ${target.data?.icon ?? ""} ${target.name} Layer
+
+${target.data?.description ?? ""}${depRule}${layerRationale}
+**${nodes.length} components**
+
+${nodeDetail}${flowLines}`
+          }]
+        };
+      }
+      if (action === "flow") {
+        if (!flow) return { content: [{ type: "text", text: "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}` }] };
+        }
+        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") }] };
+      }
+      return { content: [{ type: "text", text: "Unknown action." }] };
+    }
+  );
+  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: {
+        action: z5.enum(["seed", "check"]).describe("Action: seed default architecture data, or check dependency health")
+      }
+    },
+    async ({ action }) => {
+      if (action === "seed") {
+        await ensureCollection();
+        const existing = await listArchEntries();
+        const existingIds = new Set(existing.map((e) => e.entryId));
+        let created = 0;
+        let updated = 0;
+        let unchanged = 0;
+        const allSeeds = [
+          { ...SEED_TEMPLATE, order: 0, status: "active" },
+          ...SEED_LAYERS.map((l) => ({ ...l, status: "active" })),
+          ...SEED_NODES.map((n) => ({ ...n, status: "active" })),
+          ...SEED_FLOWS.map((f) => ({ ...f, status: "active" }))
+        ];
+        for (const seed of allSeeds) {
+          if (existingIds.has(seed.entryId)) {
+            const existingEntry = existing.find((e) => e.entryId === seed.entryId);
+            const existingData = existingEntry?.data ?? {};
+            const seedData = seed.data;
+            const hasChanges = Object.keys(seedData).some(
+              (k) => seedData[k] !== void 0 && existingData[k] !== seedData[k]
+            );
+            if (hasChanges) {
+              const mergedData = { ...existingData, ...seedData };
+              await mcpMutation("chain.updateEntry", { entryId: seed.entryId, data: mergedData });
+              updated++;
+            } else {
+              unchanged++;
+            }
+            continue;
+          }
+          await mcpMutation("chain.createEntry", {
+            collectionSlug: COLLECTION_SLUG,
+            entryId: seed.entryId,
+            name: seed.name,
+            status: seed.status,
+            data: seed.data,
+            order: seed.order ?? 0
+          });
+          created++;
+        }
+        return {
+          content: [{
+            type: "text",
+            text: `# Architecture Seeded
+
+**Created:** ${created} entries
+**Updated:** ${updated} (merged new fields)
+**Unchanged:** ${unchanged}
+
+Use \`architecture action=show\` to view the map.`
+          }]
+        };
+      }
+      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."
+            }]
+          };
+        }
+        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) }] };
+      }
+      return { content: [{ type: "text", text: "Unknown action." }] };
+    }
+  );
+}
+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);
+          }
+        }
+      }
+    }
+    nodeResults.set(node.entryId, { violations: nodeViolations, filesScanned: nodeFileCount });
+  }
+  return { violations, filesScanned: totalFiles, importsChecked: totalImports, unmappedImports: unmapped, nodeResults };
+}
+function buildAllowedDeps(layers) {
+  const nameToId = /* @__PURE__ */ new Map();
+  for (const l of layers) nameToId.set(l.name.toLowerCase(), l.entryId);
+  const allowed = /* @__PURE__ */ new Map();
+  for (const layer of layers) {
+    const deps = String(layer.data?.dependsOn ?? "none");
+    const set = /* @__PURE__ */ new Set();
+    if (deps !== "none") {
+      for (const dep of deps.split(",").map((d) => d.trim().toLowerCase())) {
+        const id = nameToId.get(dep);
+        if (id) set.add(id);
+      }
+    }
+    allowed.set(layer.entryId, set);
+  }
+  return allowed;
+}
+function buildNodePrefixes(nodes) {
+  const entries = [];
+  for (const node of nodes) {
+    for (const fp of parseFilePaths(node)) {
+      entries.push({ prefix: normalize(fp), node });
+    }
+  }
+  entries.sort((a, b) => b.prefix.length - a.prefix.length);
+  return entries;
+}
+function parseFilePaths(node) {
+  const raw = node.data?.filePaths;
+  if (!raw || typeof raw !== "string") return [];
+  return raw.split(",").map((p) => p.trim()).filter(Boolean);
+}
+function collectFiles(absPath) {
+  if (!existsSync2(absPath)) return [];
+  const stat = statSync(absPath);
+  if (stat.isFile()) {
+    return isScannableFile(absPath) ? [absPath] : [];
+  }
+  if (!stat.isDirectory()) return [];
+  const results = [];
+  const walk = (dir) => {
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+      if (entry.name.startsWith(".") || entry.name === "node_modules") continue;
+      const full = resolve2(dir, entry.name);
+      if (entry.isDirectory()) walk(full);
+      else if (isScannableFile(full)) results.push(full);
+    }
+  };
+  walk(absPath);
+  return results;
+}
+function 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 (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);
+    }
+    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}`);
+      }
+      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/tools/workflows.ts
+import { z as z6 } from "zod";
+
+// src/workflows/definitions.ts
+var RETRO_WORKFLOW = {
+  id: "retro",
+  name: "Retrospective",
+  shortDescription: "Structured team retrospective \u2014 reflect, surface patterns, commit to actions. Commits a decision entry to the Chain.",
+  icon: "\u25CE",
+  facilitatorPreamble: `You are now in **Facilitator Mode**. You are not a coding assistant \u2014 you are a facilitator running a structured retrospective.
+
+## Your Behavior
+
+1. **Guide, don't solve.** Ask questions, reflect back, synthesize. Never jump to solutions.
+2. **One round at a time.** Complete each round fully before moving to the next. No skipping.
+3. **Use structured questions** (AskQuestion tool) for choices and multi-select. Use open conversation for reflection.
+4. **Create a Plan** at the start showing all rounds as tasks. Update it as you progress.
+5. **Synthesize between rounds.** After collecting input, reflect back what you heard before moving on.
+6. **Never go silent.** If something fails, say what happened and what to do next.
+7. **Commit to the Chain** at the end using the Product OS capture tool.
+8. **Match the energy.** Be warm but structured. This is a ceremony, not a checklist.
+
+## Communication Style
+
+- Start each round with its number, name, and a brief instruction
+- Use quotes and emphasis to reflect back what the participant said
+- End each round with a brief synthesis before transitioning
+- When a round is complete, mark it as done in the Plan
+- If the participant seems stuck, offer prompts \u2014 never pressure
+- If a tool call fails, explain what happened and offer an alternative path
+
+## Error Recovery
+
+If at any point a tool call or MCP operation fails:
+1. Tell the participant what you were trying to do
+2. Explain what went wrong (briefly, no stack traces)
+3. Offer a manual alternative (e.g., "I'll capture this in the conversation instead")
+4. Continue the workflow \u2014 never halt completely
+
+## Plan Structure
+
+Create a Cursor Plan with these rounds as tasks. Mark each in_progress as you enter it, completed when done.`,
+  rounds: [
+    {
+      id: "set-stage",
+      num: "01",
+      label: "Set the Stage",
+      type: "choice",
+      instruction: "Before we dive in, let's frame what we're reflecting on. What's the scope of this retro?",
+      facilitatorGuidance: "Start warm. Ask the participant to pick or describe what they're retro-ing. Confirm the scope before proceeding. If they gave context already in their initial message, use it \u2014 don't make them repeat.",
+      questions: [
+        {
+          id: "scope",
+          prompt: "What are we reflecting on? Pick one or describe your own.",
+          options: [
+            { id: "last-week", label: "Last week's work" },
+            { id: "last-sprint", label: "Last sprint/cycle" },
+            { id: "specific-project", label: "A specific project or feature" },
+            { id: "process", label: "A process or workflow" },
+            { id: "custom", label: "Something else \u2014 let me describe it" }
+          ]
+        }
+      ],
+      outputSchema: {
+        field: "scope",
+        description: "What timeframe or project is being retro'd",
+        format: "freetext"
+      },
+      maxDurationHint: "2 min"
+    },
+    {
+      id: "what-went-well",
+      num: "02",
+      label: "What Went Well",
+      type: "open",
+      instruction: "Let's start with the good. What went well? What are you proud of? What should we do more of?",
+      facilitatorGuidance: "Celebrate. Reflect back each win with genuine emphasis. Ask follow-ups like 'What made that work?' or 'Who else contributed to that?' Collect at least 3 items before synthesizing. Don't rush past the positive \u2014 teams skip this too fast.",
+      outputSchema: {
+        field: "wentWell",
+        description: "List of things that went well",
+        format: "list"
+      },
+      maxDurationHint: "5 min"
+    },
+    {
+      id: "what-didnt-go-well",
+      num: "03",
+      label: "What Didn't Go Well",
+      type: "open",
+      instruction: "Now the harder part. What didn't go well? What frustrated you? Where did things break down?",
+      facilitatorGuidance: "Create safety. Acknowledge that this is harder. Don't judge or immediately problem-solve \u2014 just listen and capture. Ask 'What was the impact of that?' and 'When did you first notice it?'. Reflect back without softening. Collect at least 3 items.",
+      outputSchema: {
+        field: "didntGoWell",
+        description: "List of things that didn't go well",
+        format: "list"
+      },
+      maxDurationHint: "5 min"
+    },
+    {
+      id: "patterns",
+      num: "04",
+      label: "Patterns & Insights",
+      type: "synthesis",
+      instruction: "Looking at what went well and what didn't \u2014 what patterns do you see? What's the deeper insight?",
+      facilitatorGuidance: "This is YOUR moment as facilitator. Synthesize what you've heard across rounds 2 and 3. Surface themes, connections, and contradictions. Propose 2-3 patterns and ask the participant to react. This round transforms raw observations into actionable insights. Don't let the participant skip the 'why' \u2014 push for root causes.",
+      outputSchema: {
+        field: "patterns",
+        description: "Synthesized patterns and insights",
+        format: "structured"
+      },
+      maxDurationHint: "5 min"
+    },
+    {
+      id: "actions",
+      num: "05",
+      label: "Actions & Commitments",
+      type: "commit",
+      instruction: "Based on these patterns, what will we actually change? Be specific \u2014 who does what, by when?",
+      facilitatorGuidance: "Push for specificity. 'Be better at X' is not an action. 'Randy will set up a 15-min weekly check-in by Friday' is. Each action needs an owner and a deadline. Aim for 2-4 concrete actions. Use AskQuestion to confirm the final list. These become the retro's output.",
+      questions: [
+        {
+          id: "action-confirm",
+          prompt: "Are these actions concrete enough to actually happen?",
+          options: [
+            { id: "yes", label: "Yes \u2014 these are clear and actionable" },
+            { id: "refine", label: "Let me refine some of these" },
+            { id: "add", label: "I want to add more" }
+          ]
+        }
+      ],
+      outputSchema: {
+        field: "actions",
+        description: "Committed actions with owners and deadlines",
+        format: "structured"
+      },
+      maxDurationHint: "5 min"
+    },
+    {
+      id: "close",
+      num: "06",
+      label: "Close & Capture",
+      type: "close",
+      instruction: "One last thing \u2014 in one sentence, what's the single most important thing you're taking away from this retro?",
+      facilitatorGuidance: "Keep it brief. One sentence reflection. Then summarize the entire retro: scope, key wins, key pain points, patterns identified, actions committed. Ask if they want to commit this to the Chain. If yes, use capture to create a decision/tension entry. Thank them for the retro.",
+      outputSchema: {
+        field: "takeaway",
+        description: "Single-sentence takeaway",
+        format: "freetext"
+      },
+      kbCollection: "decisions",
+      maxDurationHint: "2 min"
+    }
+  ],
+  kbOutputCollection: "decisions",
+  kbOutputTemplate: {
+    nameTemplate: "Retro: {scope} \u2014 {date}",
+    descriptionField: "rationale"
+  },
+  errorRecovery: `If anything goes wrong during the retro:
+
+1. **MCP tool failure**: Skip the chain commit step. Summarize everything in the conversation instead. Suggest the participant runs \`capture\` manually later.
+2. **AskQuestion not available**: Fall back to numbered options in plain text. "Reply with 1, 2, or 3."
+3. **Plan creation fails**: Continue without the Plan. The conversation IS the record.
+4. **Participant goes off-topic**: Gently redirect: "That's valuable \u2014 let's capture it. For now, let's stay with [current round]."
+5. **Participant wants to stop**: Respect it. Summarize what you have so far. Offer to commit partial results to the Chain.
+
+The retro must never fail silently. Always communicate state.`
+};
+var WORKFLOWS = /* @__PURE__ */ new Map([
+  ["retro", RETRO_WORKFLOW]
+]);
+function getWorkflow(id) {
+  return WORKFLOWS.get(id);
+}
+function listWorkflows() {
+  return Array.from(WORKFLOWS.values());
+}
+
+// src/tools/workflows.ts
+function formatWorkflowCard(wf) {
+  const roundList = wf.rounds.map((r) => `  ${r.num}. ${r.label} (${r.type}, ~${r.maxDurationHint ?? "?"})`).join("\n");
+  return `## ${wf.icon} ${wf.name}
+**ID**: \`${wf.id}\`
+${wf.shortDescription}
+
+**Rounds** (${wf.rounds.length}):
+${roundList}
+
+**Output**: Creates entries in \`${wf.kbOutputCollection}\` collection.
+_Use the \`run-workflow\` prompt with workflow="${wf.id}" to start._`;
+}
+function registerWorkflowTools(server) {
+  server.registerTool(
+    "list-workflows",
+    {
+      title: "List Workflows",
+      description: "List all available Chainwork workflows \u2014 retro, shape-a-bet, IDM, etc. Each workflow is a structured multi-round facilitation ceremony that the agent runs in Facilitator Mode. Use the `run-workflow` prompt to actually launch one.",
+      annotations: { readOnlyHint: true }
+    },
+    async () => {
+      const workflows = listWorkflows();
+      if (workflows.length === 0) {
+        return {
+          content: [{
+            type: "text",
+            text: "No workflows registered yet. Check back after the workflow definitions are configured."
+          }]
+        };
+      }
+      const cards = workflows.map(formatWorkflowCard).join("\n\n---\n\n");
+      return {
+        content: [{
+          type: "text",
+          text: `# Available Chainwork Workflows
+
+${workflows.length} workflow(s) available. Use the \`run-workflow\` prompt to launch one.
+
+---
+
+${cards}`
+        }]
+      };
+    }
+  );
+  server.registerTool(
+    "workflow-checkpoint",
+    {
+      title: "Workflow Checkpoint",
+      description: "Record the output of a workflow round. Captures the round's data to the Chain as a structured entry. Use this during Facilitator Mode after completing each round to persist progress \u2014 so if the conversation is interrupted, work is not lost.\n\nAt workflow completion, this tool can also generate the final summary entry.",
+      inputSchema: {
+        workflowId: z6.string().describe("Workflow ID (e.g., 'retro')"),
+        roundId: z6.string().describe("Round ID (e.g., 'what-went-well')"),
+        output: z6.string().describe("The round's output \u2014 synthesized by the facilitator from the conversation"),
+        isFinal: z6.boolean().optional().describe(
+          "If true, this is the final checkpoint and triggers the summary chain entry creation"
+        ),
+        summaryName: z6.string().optional().describe(
+          "Name for the final chain entry (required when isFinal=true)"
+        ),
+        summaryDescription: z6.string().optional().describe(
+          "Full description/rationale for the final chain entry (required when isFinal=true)"
+        )
+      },
+      annotations: { destructiveHint: false }
+    },
+    async ({ workflowId, roundId, output, isFinal, summaryName, summaryDescription }) => {
+      const wf = getWorkflow(workflowId);
+      if (!wf) {
+        return {
+          content: [{
+            type: "text",
+            text: `Workflow "${workflowId}" not found. Available: ${listWorkflows().map((w) => w.id).join(", ")}.
+
+This checkpoint was NOT saved. Continue the conversation \u2014 the facilitator has the context.`
+          }]
+        };
+      }
+      const round = wf.rounds.find((r) => r.id === roundId);
+      if (!round) {
+        return {
+          content: [{
+            type: "text",
+            text: `Round "${roundId}" not found in workflow "${workflowId}". Available rounds: ${wf.rounds.map((r) => r.id).join(", ")}.
+
+This checkpoint was NOT saved. The conversation context is preserved \u2014 continue facilitating.`
+          }]
+        };
+      }
+      const lines = [
+        `## Checkpoint: Round ${round.num} \u2014 ${round.label}`,
+        `Workflow: ${wf.name} (\`${wf.id}\`)`,
+        ""
+      ];
+      if (isFinal && summaryName && summaryDescription) {
+        try {
+          const entryId = await mcpMutation("chain.createEntry", {
+            collectionSlug: wf.kbOutputCollection,
+            name: summaryName,
+            status: "draft",
+            data: {
+              [wf.kbOutputTemplate.descriptionField]: summaryDescription,
+              workflowType: wf.id,
+              completedRound: roundId,
+              date: (/* @__PURE__ */ new Date()).toISOString().split("T")[0]
+            },
+            createdBy: `workflow:${wf.id}`
+          });
+          lines.push(
+            `**Entry Committed**: \`${entryId}\``,
+            `Collection: \`${wf.kbOutputCollection}\``,
+            `Name: ${summaryName}`,
+            "",
+            `The retro is now committed to the Chain. `,
+            `Use \`suggest-links\` on this entry to connect it to related knowledge.`
+          );
+        } catch (err) {
+          const msg = err instanceof Error ? err.message : String(err);
+          lines.push(
+            `**Chain commit failed**: ${msg}`,
+            "",
+            `The retro output is preserved in this conversation. `,
+            `You can manually create the entry later using \`capture\` with:`,
+            `- Collection: \`${wf.kbOutputCollection}\``,
+            `- Name: ${summaryName}`,
+            `- Description: (copy from the conversation summary above)`
+          );
+        }
+      } else {
+        lines.push(
+          `Round ${round.num} output recorded.`,
+          `Output: ${output.substring(0, 200)}${output.length > 200 ? "..." : ""}`
+        );
+        const currentIdx = wf.rounds.findIndex((r) => r.id === roundId);
+        if (currentIdx < wf.rounds.length - 1) {
+          const next = wf.rounds[currentIdx + 1];
+          lines.push(
+            "",
+            `**Next**: Round ${next.num} \u2014 ${next.label}`,
+            `_${next.instruction}_`
+          );
+        } else {
+          lines.push(
+            "",
+            `**All rounds complete.** Call this tool again with \`isFinal: true\` to commit to the Chain.`
+          );
+        }
+      }
+      return { content: [{ type: "text", text: lines.join("\n") }] };
+    }
+  );
+}
+
+// src/tools/session.ts
+function registerSessionTools(server) {
+  server.registerTool(
+    "agent-start",
+    {
+      title: "Start Agent Session",
+      description: "Start an agent session. Creates a tracked session for this workspace with full attribution. If a session is already active, it gets superseded (graceful handover). Write tools are available after calling orient.",
+      annotations: { readOnlyHint: false }
+    },
+    async () => {
+      try {
+        const result = await startAgentSession();
+        const lines = [];
+        if (result.superseded) {
+          lines.push(
+            `Previous session superseded. Session ${result.superseded.previousSessionId} (started ${result.superseded.startedAt}, initiated by ${result.superseded.initiatedBy}) was closed.`,
+            ""
+          );
+        }
+        lines.push(
+          `Session ${result.sessionId} active. Initiated by ${result.initiatedBy}. Workspace ${result.workspaceName}. Scope: ${result.toolsScope}. Write tools available after orient.`
+        );
+        return { content: [{ type: "text", text: lines.join("\n") }] };
+      } catch (err) {
+        return {
+          content: [{ type: "text", text: `Failed to start agent session: ${err.message}` }],
+          isError: true
+        };
+      }
+    }
+  );
+  server.registerTool(
+    "agent-close",
+    {
+      title: "Close Agent Session",
+      description: "Close the current agent session. Records structured session data (entries created, modified, relations, gate results). After this, write tools are blocked even if the MCP connection stays open.",
+      annotations: { readOnlyHint: false }
+    },
+    async () => {
+      try {
+        const sessionId = getAgentSessionId();
+        if (!sessionId) {
+          return {
+            content: [{ type: "text", text: "No active agent session to close." }]
+          };
+        }
+        const session = await mcpCall("agent.getSession", {
+          sessionId
+        });
+        await closeAgentSession();
+        const lines = [
+          `Session ${sessionId} closed.`,
+          ""
+        ];
+        if (session) {
+          const created = session.entriesCreated?.length ?? 0;
+          const modified = session.entriesModified?.length ?? 0;
+          const relations = session.relationsCreated ?? 0;
+          const gates = session.gateFailures ?? 0;
+          const warnings = session.contradictionWarnings ?? 0;
+          lines.push(
+            `| Metric | Count |`,
+            `|--------|-------|`,
+            `| Entries created | ${created} |`,
+            `| Entries modified | ${modified} |`,
+            `| Relations created | ${relations} |`,
+            `| Gate failures | ${gates} |`,
+            `| Contradiction warnings | ${warnings} |`
+          );
+        }
+        lines.push("", "Write tools are now blocked. Session data saved for future orientation.");
+        return { content: [{ type: "text", text: lines.join("\n") }] };
+      } catch (err) {
+        return {
+          content: [{ type: "text", text: `Failed to close agent session: ${err.message}` }],
+          isError: true
+        };
+      }
+    }
+  );
+  server.registerTool(
+    "agent-status",
+    {
+      title: "Agent Session Status",
+      description: "Check the current agent session status \u2014 whether a session is active, whether orientation is complete, and session activity so far.",
+      annotations: { readOnlyHint: true }
+    },
+    async () => {
+      try {
+        const sessionId = getAgentSessionId();
+        if (!sessionId) {
+          return {
+            content: [{ type: "text", text: "No active agent session. Call `agent-start` to begin." }]
+          };
+        }
+        const session = await mcpCall("agent.getSession", {
+          sessionId
+        });
+        if (!session) {
+          return {
+            content: [{ type: "text", text: "Session ID cached but not found in Convex. Call `agent-start` to create a new session." }]
+          };
+        }
+        const oriented = isSessionOriented();
+        const created = session.entriesCreated?.length ?? 0;
+        const modified = session.entriesModified?.length ?? 0;
+        const lines = [
+          `Session ${sessionId} ${session.status}.`,
+          `Initiated by ${session.initiatedBy}.`,
+          `Scope: ${session.toolsScope}.`,
+          `Oriented: ${oriented ? "yes" : "no"}.`,
+          "",
+          `| Metric | Value |`,
+          `|--------|-------|`,
+          `| Entries created | ${created} |`,
+          `| Entries modified | ${modified} |`,
+          `| Relations created | ${session.relationsCreated ?? 0} |`,
+          `| Started | ${new Date(session.startedAt).toISOString()} |`,
+          `| Expires | ${new Date(session.expiresAt).toISOString()} |`
+        ];
+        return { content: [{ type: "text", text: lines.join("\n") }] };
+      } catch (err) {
+        return {
+          content: [{ type: "text", text: `Failed to get session status: ${err.message}` }],
+          isError: true
+        };
+      }
+    }
+  );
+}
+
+// src/tools/gitchain.ts
+import { z as z7 } from "zod";
+function linkSummary(links) {
+  return Object.entries(links).map(([id, content]) => {
+    const filled = typeof content === "string" && content.length > 0;
+    const preview = filled ? content.substring(0, 80) + (content.length > 80 ? "..." : "") : "(empty)";
+    return `  - **${id}**: ${preview}`;
+  }).join("\n");
+}
+function registerGitChainTools(server) {
+  server.registerTool(
+    "chain",
+    {
+      title: "Chain",
+      description: "Manage processes \u2014 create, get, list, or edit process links. Processes are versioned knowledge artifacts that follow a process template (e.g. Strategy Coherence: Problem \u2192 Insight \u2192 Choice \u2192 Action \u2192 Outcome).",
+      inputSchema: {
+        action: z7.enum(["create", "get", "list", "edit"]).describe("Action: create a process, get process details, list all processes, or edit a process link"),
+        chainEntryId: z7.string().optional().describe("Chain entry ID (required for get/edit)"),
+        title: z7.string().optional().describe("Process title (required for create)"),
+        chainTypeId: z7.string().optional().default("strategy-coherence").describe("Process template slug for create: 'strategy-coherence', 'idm-proposal', or any custom template slug"),
+        description: z7.string().optional().describe("Description (for create)"),
+        linkId: z7.string().optional().describe("Link to edit (for edit action): problem, insight, choice, action, outcome"),
+        content: z7.string().optional().describe("New content for the link (for edit action)"),
+        status: z7.string().optional().describe("Filter by status for list: 'draft' or 'active'"),
+        author: z7.string().optional().describe("Who is performing the action. Defaults to 'mcp'.")
+      }
+    },
+    async ({ action, chainEntryId, title, chainTypeId, description, linkId, content, status, author }) => {
+      if (action === "create") {
+        if (!title) return { content: [{ type: "text", text: "A `title` is required to create a process." }] };
+        const result = await mcpMutation(
+          "gitchain.createChain",
+          { title, chainTypeId, description, author }
+        );
+        return {
+          content: [{
+            type: "text",
+            text: `# Process Created
+
+- **Entry ID:** \`${result.entryId}\`
+- **Title:** ${title}
+- **Type:** ${chainTypeId}
+- **Status:** draft
+
+Use \`chain action=edit chainEntryId="${result.entryId}" linkId="problem" content="..."\` to start filling in links.`
+          }]
+        };
+      }
+      if (action === "get") {
+        if (!chainEntryId) return { content: [{ type: "text", text: "A `chainEntryId` is required." }] };
+        const chain = await mcpQuery("gitchain.getChain", { chainEntryId });
+        if (!chain) {
+          return { content: [{ type: "text", text: `Process "${chainEntryId}" not found.` }] };
+        }
+        const scoreSection = chain.scores ? `
+## Coherence: ${chain.coherenceScore}%
+
+` + chain.scores.sections.map((s) => `- **${s.key}**: ${s.power}/100 (${"\u2605".repeat(Math.min(s.stars ?? 0, 5))}${"\u2606".repeat(Math.max(0, 5 - (s.stars ?? 0)))})`).join("\n") : "";
+        return {
+          content: [{
+            type: "text",
+            text: `# ${chain.name}
+
+- **Entry ID:** \`${chain.entryId}\`
+- **Type:** ${chain.chainTypeName}
+- **Status:** ${chain.status}
+- **Links filled:** ${chain.filledCount}/${chain.totalCount}
+- **Version:** ${chain.currentVersion}
+- **Created by:** ${chain.createdBy ?? "unknown"}
+- **History events:** ${chain.historyCount}
+` + scoreSection + `
+
+## Links
+
+` + linkSummary(chain.links)
+          }]
+        };
+      }
+      if (action === "list") {
+        const chains = await mcpQuery("gitchain.listChains", {
+          chainTypeId,
+          status
+        });
+        if (chains.length === 0) {
+          return { content: [{ type: "text", text: "No processes found. Use `chain action=create` to create one." }] };
+        }
+        const formatted = chains.map(
+          (c) => `- **\`${c.entryId}\`** ${c.name} \u2014 ${c.chainTypeId} \xB7 ${c.filledCount}/${c.totalCount} links \xB7 coherence: ${c.coherenceScore}% \xB7 status: ${c.status}`
+        ).join("\n");
+        return { content: [{ type: "text", text: `# Chains (${chains.length})
+
+${formatted}` }] };
+      }
+      if (action === "edit") {
+        if (!chainEntryId) return { content: [{ type: "text", text: "A `chainEntryId` is required." }] };
+        if (!linkId) return { content: [{ type: "text", text: "A `linkId` is required (e.g. problem, insight, choice, action, outcome)." }] };
+        if (!content) return { content: [{ type: "text", text: "The `content` for the link is required." }] };
+        const result = await mcpMutation("gitchain.editLink", { chainEntryId, linkId, content, author });
+        return {
+          content: [{
+            type: "text",
+            text: `# Link Updated
+
+- **Chain:** \`${result.entryId}\`
+- **Link:** ${result.linkId}
+- **Chain status:** ${result.status}
+- **Content length:** ${content.length} chars
+
+Use \`chain action=get\` to see the full chain with updated scores.`
+          }]
+        };
+      }
+      return { content: [{ type: "text", text: "Unknown action." }] };
+    }
+  );
+  server.registerTool(
+    "chain-version",
+    {
+      title: "Chain Version",
+      description: "Manage process versions \u2014 commit snapshots, list commits, view history, diff versions, or revert. Commits record all link content, compute coherence scores, and track changes.",
+      inputSchema: {
+        action: z7.enum(["commit", "list", "diff", "revert", "history"]).describe("Action: commit a snapshot, list commits, diff two versions, revert to a version, or view history"),
+        chainEntryId: z7.string().describe("The chain's entry ID"),
+        commitMessage: z7.string().optional().describe("Commit message (required for commit). Convention: type(link): description"),
+        versionA: z7.number().optional().describe("Earlier version for diff"),
+        versionB: z7.number().optional().describe("Later version for diff"),
+        toVersion: z7.number().optional().describe("Version number to revert to"),
+        author: z7.string().optional().describe("Who is performing the action. Defaults to 'mcp'.")
+      },
+      annotations: { readOnlyHint: false }
+    },
+    async ({ action, chainEntryId, commitMessage, versionA, versionB, toVersion, author }) => {
+      if (action === "commit") {
+        if (!commitMessage) return { content: [{ type: "text", text: "A `commitMessage` is required." }] };
+        const result = await mcpMutation("gitchain.commitChain", { chainEntryId, commitMessage, author });
+        const warning = result.commitLintWarning ? `
+
+> **Lint warning:** ${result.commitLintWarning}` : "";
+        return {
+          content: [{
+            type: "text",
+            text: `# Committed v${result.version}
+
+- **Chain:** \`${result.entryId}\`
+- **Version:** ${result.version}
+- **Message:** ${commitMessage}
+- **Coherence:** ${result.coherenceScore}%
+- **Links modified:** ${result.linksModified.length > 0 ? result.linksModified.join(", ") : "none"}
+` + warning
+          }]
+        };
+      }
+      if (action === "list") {
+        const commits = await mcpQuery("gitchain.listCommits", { chainEntryId });
+        if (commits.length === 0) {
+          return { content: [{ type: "text", text: `No commits found for chain "${chainEntryId}". Use \`chain-version action=commit\` to create the first snapshot.` }] };
+        }
+        const formatted = commits.map((c) => {
+          const date = new Date(c.createdAt).toISOString().replace("T", " ").substring(0, 19);
+          const msg = c.commitMessage ?? c.changeNote ?? "(no message)";
+          const links = c.linksModified?.length > 0 ? ` [${c.linksModified.join(", ")}]` : "";
+          return `- **v${c.version}** ${date} by ${c.author} \u2014 ${msg}${links} (${c.versionStatus})`;
+        }).join("\n");
+        return { content: [{ type: "text", text: `# Commits for ${chainEntryId} (${commits.length})
+
+${formatted}` }] };
+      }
+      if (action === "diff") {
+        if (versionA == null || versionB == null) {
+          return { content: [{ type: "text", text: "Both `versionA` and `versionB` are required for diff." }] };
+        }
+        const diff = await mcpMutation("gitchain.diffVersions", { chainEntryId, versionA, versionB });
+        let text = `# Diff: v${versionA} \u2192 v${versionB}
+
+- **Chain:** \`${diff.chainEntryId}\`
+- **Coherence:** ${diff.coherenceBefore}% \u2192 ${diff.coherenceAfter}% (${diff.coherenceDelta >= 0 ? "+" : ""}${diff.coherenceDelta})
+- **Links changed:** ${diff.linksChanged.length > 0 ? diff.linksChanged.join(", ") : "none"}
+`;
+        for (const ld of diff.linkDiffs) {
+          if (ld.status === "unchanged") continue;
+          text += `
+## ${ld.linkId} (${ld.status})
+
+`;
+          const wordDiff = diff.wordDiffs[ld.linkId];
+          if (wordDiff?.length > 0) {
+            for (const w of wordDiff) {
+              if (w.type === "delete") text += `~~${w.value.substring(0, 200)}~~`;
+              else if (w.type === "insert") text += `**${w.value.substring(0, 200)}**`;
+              else text += w.value.substring(0, 200);
+            }
+            text += "\n";
+          }
+        }
+        return { content: [{ type: "text", text }] };
+      }
+      if (action === "revert") {
+        if (toVersion == null) return { content: [{ type: "text", text: "A `toVersion` is required for revert." }] };
+        const result = await mcpMutation("gitchain.revertChain", { chainEntryId, toVersion, author });
+        return {
+          content: [{
+            type: "text",
+            text: `# Reverted
+
+- **Chain:** \`${result.entryId}\`
+- **Reverted to:** v${result.revertedTo}
+- **New version:** v${result.newVersion}
+- **Links affected:** ${result.linksModified.length > 0 ? result.linksModified.join(", ") : "none"}
+
+History is preserved \u2014 this created a new version, not a destructive reset.`
+          }]
+        };
+      }
+      if (action === "history") {
+        const history = await mcpQuery("gitchain.getHistory", { chainEntryId });
+        if (history.length === 0) {
+          return { content: [{ type: "text", text: `No history found for chain "${chainEntryId}".` }] };
+        }
+        const formatted = history.sort((a, b) => b.timestamp - a.timestamp).map((h) => {
+          const date = new Date(h.timestamp).toISOString().replace("T", " ").substring(0, 19);
+          return `- **${date}** [${h.event}] by ${h.changedBy ?? "unknown"} \u2014 ${h.note ?? ""}`;
+        }).join("\n");
+        return { content: [{ type: "text", text: `# History for ${chainEntryId} (${history.length} events)
+
+${formatted}` }] };
+      }
+      return { content: [{ type: "text", text: "Unknown action." }] };
+    }
+  );
+  server.registerTool(
+    "chain-branch",
+    {
+      title: "Chain Branch",
+      description: "Manage process branches \u2014 create a branch for isolated editing, list branches, merge a branch back into main, or check for conflicts.",
+      inputSchema: {
+        action: z7.enum(["create", "list", "merge", "conflicts"]).describe("Action: create a branch, list branches, merge a branch, or check for conflicts"),
+        chainEntryId: z7.string().describe("The chain's entry ID"),
+        branchName: z7.string().optional().describe("Branch name (required for merge/conflicts, optional for create)"),
+        strategy: z7.enum(["merge_commit", "squash"]).optional().describe("Merge strategy: 'merge_commit' (default) or 'squash'"),
+        author: z7.string().optional().describe("Who is performing the action. Defaults to 'mcp'.")
+      }
+    },
+    async ({ action, chainEntryId, branchName, strategy, author }) => {
+      if (action === "create") {
+        const result = await mcpMutation("gitchain.createBranch", { chainEntryId, name: branchName, author });
+        return {
+          content: [{
+            type: "text",
+            text: `# Branch Created
+
+- **Name:** ${result.name}
+- **Based on:** v${result.baseVersion}
+- **Chain:** \`${chainEntryId}\`
+
+Edit links and commit on this branch, then use \`chain-branch action=merge\` to land changes.`
+          }]
+        };
+      }
+      if (action === "list") {
+        const branches = await mcpMutation("gitchain.listBranches", { chainEntryId });
+        if (branches.length === 0) {
+          return { content: [{ type: "text", text: `No branches found for chain "${chainEntryId}".` }] };
+        }
+        const formatted = branches.map((b) => `- **${b.name}** (${b.status}) \u2014 based on v${b.baseVersion}, by ${b.createdBy}`).join("\n");
+        return { content: [{ type: "text", text: `# Branches for ${chainEntryId} (${branches.length})
+
+${formatted}` }] };
+      }
+      if (action === "merge") {
+        if (!branchName) return { content: [{ type: "text", text: "A `branchName` is required for merge." }] };
+        const result = await mcpMutation("gitchain.mergeBranch", { chainEntryId, branchName, strategy, author });
+        return {
+          content: [{
+            type: "text",
+            text: `# Branch Merged
+
+- **Chain:** \`${result.entryId}\`
+- **Branch:** ${result.branchName} (now closed)
+- **Version:** v${result.version}
+- **Strategy:** ${result.strategy}
+
+Main is now at v${result.version}. The branch has been closed.`
+          }]
+        };
+      }
+      if (action === "conflicts") {
+        if (!branchName) return { content: [{ type: "text", text: "A `branchName` is required for conflict check." }] };
+        const result = await mcpMutation("gitchain.checkConflicts", { chainEntryId, branchName });
+        if (!result.hasConflicts) {
+          return {
+            content: [{
+              type: "text",
+              text: `# No Conflicts
+
+Branch "${branchName}" on \`${chainEntryId}\` has no conflicts. Safe to merge.`
+            }]
+          };
+        }
+        const conflictLines = result.conflicts.map(
+          (c) => `- **${c.linkId}** \u2014 modified by: ${c.branches.map((b) => `${b.branchName} (${b.author})`).join(", ")}`
+        ).join("\n");
+        return {
+          content: [{
+            type: "text",
+            text: `# Conflicts Detected
+
+Branch "${branchName}" conflicts with other branches on these links:
+
+` + conflictLines + `
+
+Resolve conflicts before merging.`
+          }]
+        };
+      }
+      return { content: [{ type: "text", text: "Unknown action." }] };
+    }
+  );
+  server.registerTool(
+    "chain-review",
+    {
+      title: "Chain Review",
+      description: "Review process quality \u2014 run the coherence gate or manage comments on process versions. The gate checks: coherence score >= 70%, all links filled, commit message convention.",
+      inputSchema: {
+        action: z7.enum(["gate", "comment", "resolve-comment", "list-comments"]).describe("Action: run coherence gate, add a comment, resolve a comment, or list comments"),
+        chainEntryId: z7.string().describe("The chain's entry ID"),
+        commitMessage: z7.string().optional().describe("Commit message to lint (for gate action)"),
+        versionNumber: z7.number().optional().describe("Version to comment on or list comments for"),
+        linkId: z7.string().optional().describe("Link this comment targets (optional for comment)"),
+        body: z7.string().optional().describe("Comment text (required for comment action)"),
+        commentId: z7.string().optional().describe("Comment ID (required for resolve-comment)"),
+        author: z7.string().optional().describe("Who is performing the action. Defaults to 'mcp'.")
+      },
+      annotations: { readOnlyHint: false }
+    },
+    async ({ action, chainEntryId, commitMessage, versionNumber, linkId, body, commentId, author }) => {
+      if (action === "gate") {
+        const gate = await mcpQuery("gitchain.runGate", { chainEntryId, commitMessage });
+        const checkLines = gate.checks.map((c) => `- ${c.pass ? "PASS" : "FAIL"} **${c.name}**: ${c.detail}`).join("\n");
+        const icon = gate.pass ? "PASS" : "BLOCKED";
+        return {
+          content: [{
+            type: "text",
+            text: `# Gate: ${icon}
+
+- **Score:** ${gate.score}%
+- **Threshold:** ${gate.threshold}%
+
+## Checks
+
+${checkLines}`
+          }]
+        };
+      }
+      if (action === "comment") {
+        if (!versionNumber) return { content: [{ type: "text", text: "A `versionNumber` is required." }] };
+        if (!body) return { content: [{ type: "text", text: "A `body` is required." }] };
+        const result = await mcpMutation("gitchain.addComment", {
+          chainEntryId,
+          versionNumber,
+          linkId,
+          body,
+          author
+        });
+        return {
+          content: [{
+            type: "text",
+            text: `# Comment Added
+
+- **Chain:** \`${result.chainEntryId}\`
+- **Version:** v${result.versionNumber}
+` + (result.linkId ? `- **Link:** ${result.linkId}
+` : "") + `- **Body:** ${body.substring(0, 200)}`
+          }]
+        };
+      }
+      if (action === "resolve-comment") {
+        if (!commentId) return { content: [{ type: "text", text: "A `commentId` is required." }] };
+        await mcpMutation("gitchain.resolveComment", { commentId });
+        return { content: [{ type: "text", text: `Comment resolved.` }] };
+      }
+      if (action === "list-comments") {
+        const comments = await mcpMutation("gitchain.listComments", {
+          chainEntryId,
+          versionNumber
+        });
+        if (comments.length === 0) {
+          return { content: [{ type: "text", text: `No comments found for chain "${chainEntryId}"${versionNumber ? ` v${versionNumber}` : ""}.` }] };
+        }
+        const formatted = comments.map((c) => {
+          const date = new Date(c.createdAt).toISOString().replace("T", " ").substring(0, 19);
+          const resolved = c.resolved ? " (RESOLVED)" : "";
+          const link = c.linkId ? ` [${c.linkId}]` : "";
+          return `- **v${c.version}${link}** ${date} by ${c.author}${resolved}: ${c.body.substring(0, 150)}`;
+        }).join("\n");
+        const unresolvedCount = comments.filter((c) => !c.resolved).length;
+        return {
+          content: [{
+            type: "text",
+            text: `# Comments for ${chainEntryId} (${comments.length}, ${unresolvedCount} unresolved)
+
+${formatted}`
+          }]
+        };
+      }
+      return { content: [{ type: "text", text: "Unknown action." }] };
+    }
+  );
+}
+
+// src/tools/maps.ts
+import { z as z8 } from "zod";
+function slotSummary(slots) {
+  return Object.entries(slots).map(([id, refs]) => {
+    if (!refs || refs.length === 0) return `  - **${id}**: (empty)`;
+    const items = refs.map((r) => {
+      const name = r.ingredientName ?? r.label ?? r.entryId;
+      const version = r.pinnedVersion ? ` v${r.pinnedVersion}` : "";
+      const status = r.ingredientStatus ? ` [${r.ingredientStatus}]` : "";
+      return `${name}${version}${status}`;
+    }).join(", ");
+    return `  - **${id}**: ${items}`;
+  }).join("\n");
+}
+function registerMapTools(server) {
+  server.registerTool(
+    "map",
+    {
+      title: "Map",
+      description: "Manage composed framework maps \u2014 create, get, or list. Maps assemble ingredient entries into framework slots (e.g. Lean Canvas). Use map-slot to add/remove ingredients, map-version to commit and view history.",
+      inputSchema: {
+        action: z8.enum(["create", "get", "list"]).describe("Action: create a map, get map details, or list all maps"),
+        mapEntryId: z8.string().optional().describe("Map entry ID (for get)"),
+        title: z8.string().optional().describe("Map title (for create)"),
+        templateId: z8.string().optional().default("lean-canvas").describe("Template slug for create: 'lean-canvas' or any composed template"),
+        description: z8.string().optional().describe("Description (for create)"),
+        slotIds: z8.array(z8.string()).optional().describe("Slot IDs to initialize (for create; auto-populated from template if omitted)"),
+        status: z8.string().optional().describe("Filter by status for list")
+      }
+    },
+    async ({ action, mapEntryId, title, templateId, description, slotIds, status }) => {
+      if (action === "create") {
+        if (!title) {
+          return {
+            content: [
+              { type: "text", text: "A `title` is required to create a map." }
+            ]
+          };
+        }
+        const result = await mcpMutation(
+          "maps.createMap",
+          { title, templateId, description, slotIds }
+        );
+        const wsCtx = await getWorkspaceContext();
+        return {
+          content: [
+            {
+              type: "text",
+              text: `# Map Created
+
+- **Entry ID:** \`${result.entryId}\`
+- **Title:** ${title}
+- **Template:** ${templateId}
+- **Status:** draft
+- **Workspace:** ${wsCtx.workspaceSlug} (${wsCtx.workspaceId})
+
+Use \`map-slot action=add mapEntryId="${result.entryId}" slotId="problem" ingredientEntryId="..."\` to start filling slots.`
+            }
+          ]
+        };
+      }
+      if (action === "get") {
+        if (!mapEntryId) {
+          return {
+            content: [{ type: "text", text: "A `mapEntryId` is required." }]
+          };
+        }
+        const map = await mcpQuery("maps.getMap", { mapEntryId });
+        if (!map) {
+          return {
+            content: [{ type: "text", text: `Map "${mapEntryId}" not found.` }]
+          };
+        }
+        return {
+          content: [
+            {
+              type: "text",
+              text: `# ${map.name}
+
+- **Entry ID:** \`${map.entryId}\`
+- **Template:** ${map.templateName}
+- **Status:** ${map.status}
+- **Version:** ${map.currentVersion}
+- **Completion:** ${map.completionScore}% (${map.filledSlots}/${map.totalSlots} slots)
+
+## Slots
+
+` + slotSummary(map.slots)
+            }
+          ]
+        };
+      }
+      if (action === "list") {
+        const maps = await mcpQuery("maps.listMaps", {
+          templateId: templateId !== "lean-canvas" ? templateId : void 0,
+          status
+        });
+        if (!maps || maps.length === 0) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: 'No maps found. Create one with `map action=create title="My Canvas"`.'
+              }
+            ]
+          };
+        }
+        const lines = maps.map(
+          (m) => `- **${m.name}** (\`${m.entryId}\`) \u2014 ${m.templateId}, ${m.completionScore}% complete, v${m.currentVersion}`
+        );
+        return {
+          content: [
+            {
+              type: "text",
+              text: `# Maps (${maps.length})
+
+${lines.join("\n")}`
+            }
+          ]
+        };
+      }
+      return {
+        content: [{ type: "text", text: `Unknown action: ${action}` }]
+      };
+    }
+  );
+  server.registerTool(
+    "map-slot",
+    {
+      title: "Map Slot",
+      description: "Add, remove, or replace ingredient references in a map's slots. Ingredients are entries from any collection that fill a framework position.",
+      inputSchema: {
+        action: z8.enum(["add", "remove", "replace", "list"]).describe("Action: add/remove/replace an ingredient in a slot, or list slot contents"),
+        mapEntryId: z8.string().describe("Map entry ID"),
+        slotId: z8.string().optional().describe("Slot ID (e.g. 'problem', 'customer-segments')"),
+        ingredientEntryId: z8.string().optional().describe("Ingredient entry ID to add/remove"),
+        newIngredientEntryId: z8.string().optional().describe("New ingredient entry ID (for replace)"),
+        label: z8.string().optional().describe("Display label override"),
+        author: z8.string().optional().describe("Who is performing the action")
+      }
+    },
+    async ({
+      action,
+      mapEntryId,
+      slotId,
+      ingredientEntryId,
+      newIngredientEntryId,
+      label,
+      author
+    }) => {
+      if (action === "list") {
+        const map = await mcpQuery("maps.getMap", { mapEntryId });
+        if (!map) {
+          return {
+            content: [{ type: "text", text: `Map "${mapEntryId}" not found.` }]
+          };
+        }
+        if (slotId && map.slots[slotId]) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: `# Slot: ${slotId}
+
+` + (map.slots[slotId].length === 0 ? "(empty)" : map.slots[slotId].map(
+                  (r) => `- **${r.ingredientName ?? r.entryId}** (\`${r.entryId}\`)${r.pinnedVersion ? ` v${r.pinnedVersion}` : ""}`
+                ).join("\n"))
+              }
+            ]
+          };
+        }
+        return {
+          content: [
+            { type: "text", text: `## All Slots
+
+${slotSummary(map.slots)}` }
+          ]
+        };
+      }
+      if (action === "add") {
+        if (!slotId || !ingredientEntryId) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: "Both `slotId` and `ingredientEntryId` are required for add."
+              }
+            ]
+          };
+        }
+        await mcpMutation("maps.addToSlot", {
+          mapEntryId,
+          slotId,
+          ingredientEntryId,
+          label,
+          author
+        });
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Added \`${ingredientEntryId}\` to slot "${slotId}" on map \`${mapEntryId}\`.`
+            }
+          ]
+        };
+      }
+      if (action === "remove") {
+        if (!slotId || !ingredientEntryId) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: "Both `slotId` and `ingredientEntryId` are required for remove."
+              }
+            ]
+          };
+        }
+        await mcpMutation("maps.removeFromSlot", {
+          mapEntryId,
+          slotId,
+          ingredientEntryId,
+          author
+        });
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Removed \`${ingredientEntryId}\` from slot "${slotId}" on map \`${mapEntryId}\`.`
+            }
+          ]
+        };
+      }
+      if (action === "replace") {
+        if (!slotId || !ingredientEntryId || !newIngredientEntryId) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: "`slotId`, `ingredientEntryId`, and `newIngredientEntryId` are required for replace."
+              }
+            ]
+          };
+        }
+        await mcpMutation("maps.replaceInSlot", {
+          mapEntryId,
+          slotId,
+          oldIngredientEntryId: ingredientEntryId,
+          newIngredientEntryId,
+          label,
+          author
+        });
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Replaced \`${ingredientEntryId}\` with \`${newIngredientEntryId}\` in slot "${slotId}".`
+            }
+          ]
+        };
+      }
+      return {
+        content: [{ type: "text", text: `Unknown action: ${action}` }]
+      };
+    }
+  );
+  server.registerTool(
+    "map-version",
+    {
+      title: "Map Version",
+      description: "Commit a map (pins ingredient versions), list commit history, or view a specific commit.",
+      inputSchema: {
+        action: z8.enum(["commit", "list", "history"]).describe("Action: commit the map, list commits, or view commit history"),
+        mapEntryId: z8.string().describe("Map entry ID"),
+        commitMessage: z8.string().optional().describe("Commit message (for commit action)"),
+        author: z8.string().optional().describe("Who is committing")
+      }
+    },
+    async ({ action, mapEntryId, commitMessage, author }) => {
+      if (action === "commit") {
+        const result = await mcpMutation("maps.commitMap", {
+          mapEntryId,
+          commitMessage: commitMessage ?? "Map committed",
+          author
+        });
+        return {
+          content: [
+            {
+              type: "text",
+              text: `# Map Committed
+
+- **Version:** ${result.version}
+- **Completion:** ${result.completionScore}%
+- **Slots modified:** ${result.slotsModified.length > 0 ? result.slotsModified.join(", ") : "(none)"}
+
+All ingredient references have been pinned at their current versions.`
+            }
+          ]
+        };
+      }
+      if (action === "list" || action === "history") {
+        const commits = await mcpQuery("maps.listMapCommits", {
+          mapEntryId
+        });
+        if (!commits || commits.length === 0) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: `No commits yet for map \`${mapEntryId}\`. Use \`map-version action=commit\` to create the first snapshot.`
+              }
+            ]
+          };
+        }
+        const lines = commits.map(
+          (c) => `- **v${c.version}** (${new Date(c.createdAt).toLocaleDateString()}) \u2014 ${c.commitMessage ?? "(no message)"} \u2014 by ${c.author}` + (c.slotsModified.length > 0 ? `
+  Slots changed: ${c.slotsModified.join(", ")}` : "")
+        );
+        return {
+          content: [
+            {
+              type: "text",
+              text: `# Map History: \`${mapEntryId}\` (${commits.length} commits)
+
+${lines.join("\n")}`
+            }
+          ]
+        };
+      }
+      return {
+        content: [{ type: "text", text: `Unknown action: ${action}` }]
+      };
+    }
+  );
+  server.registerTool(
+    "map-suggest",
+    {
+      title: "Map Suggest",
+      description: "Given a map with empty slots, search the Chain for ingredients that could fill them. Uses keyword search and collection matching based on the template's suggested collections.",
+      inputSchema: {
+        mapEntryId: z8.string().describe("Map entry ID to suggest ingredients for"),
+        slotId: z8.string().optional().describe("Specific slot to find ingredients for (or all empty slots)"),
+        query: z8.string().optional().describe("Optional search query to narrow ingredient suggestions")
+      }
+    },
+    async ({ mapEntryId, slotId, query }) => {
+      const map = await mcpQuery("maps.getMap", { mapEntryId });
+      if (!map) {
+        return {
+          content: [{ type: "text", text: `Map "${mapEntryId}" not found.` }]
+        };
+      }
+      const emptySlots = slotId ? [slotId].filter((id) => (map.slots[id]?.length ?? 0) === 0) : Object.entries(map.slots).filter(([, refs]) => refs.length === 0).map(([id]) => id);
+      if (emptySlots.length === 0) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: slotId ? `Slot "${slotId}" already has ingredients.` : "All slots have ingredients. Nothing to suggest."
+            }
+          ]
+        };
+      }
+      const slotDefs = map.slotDefs ?? [];
+      const suggestions = [];
+      for (const sid of emptySlots) {
+        const def = slotDefs.find((s) => s.id === sid);
+        const searchQuery = query ?? def?.label ?? sid;
+        const results = await mcpQuery("knowledge.search", {
+          query: searchQuery,
+          limit: 5
+        });
+        if (results && results.length > 0) {
+          const items = results.map(
+            (r) => `  - **${r.name}** (\`${r.entryId}\`, ${r.collectionName ?? "unknown"}) \u2014 ${r.status}`
+          );
+          suggestions.push(
+            `### ${def?.label ?? sid}
+${def?.description ?? ""}
+
+${items.join("\n")}`
+          );
+        } else {
+          suggestions.push(
+            `### ${def?.label ?? sid}
+_No matching entries found. Create ingredients first._`
+          );
+        }
+      }
+      return {
+        content: [
+          {
+            type: "text",
+            text: `# Ingredient Suggestions for "${map.name}"
+
+` + suggestions.join("\n\n") + `
+
+Use \`map-slot action=add mapEntryId="${mapEntryId}" slotId="..." ingredientEntryId="..."\` to add ingredients.`
+          }
+        ]
+      };
+    }
+  );
+}
+
+// src/tools/start.ts
+import { z as z9 } from "zod";
+
+// src/presets/collections.ts
+var COLLECTION_PRESETS = [
+  {
+    id: "software-product",
+    name: "Software Product",
+    description: "For teams building software products \u2014 glossary, features, architecture, tech debt, and API endpoints",
+    collections: [
+      { slug: "glossary", name: "Glossary", description: "Canonical terminology for the product domain", fields: [{ key: "canonical", label: "Canonical", type: "string", required: true, searchable: true }, { key: "category", label: "Category", type: "select", options: ["Platform & Architecture", "Knowledge Management", "AI & Developer Tools", "Governance & Process"] }, { key: "confusedWith", label: "Confused With", type: "array" }] },
+      { slug: "features", name: "Features", description: "Product features and capabilities", fields: [{ key: "description", label: "Description", type: "string", required: true, searchable: true }, { key: "scope", label: "Scope", type: "string" }, { key: "area", label: "Area", type: "string" }, { key: "status", label: "Status", type: "select", options: ["proposed", "in-progress", "shipped", "deprecated"] }] },
+      { slug: "architecture", name: "Architecture", description: "System architecture layers and components", fields: [{ key: "description", label: "Description", type: "string", required: true, searchable: true }, { key: "layer", label: "Layer", type: "string" }, { key: "dependencies", label: "Dependencies", type: "array" }] },
+      { slug: "tech-debt", name: "Tech Debt", description: "Technical debt items to track and address", fields: [{ key: "description", label: "Description", type: "string", required: true, searchable: true }, { key: "severity", label: "Severity", type: "select", options: ["low", "medium", "high", "critical"] }, { key: "area", label: "Area", type: "string" }, { key: "effort", label: "Effort", type: "select", options: ["small", "medium", "large"] }] },
+      { slug: "api-endpoints", name: "API Endpoints", description: "REST/GraphQL endpoints and their contracts", fields: [{ key: "description", label: "Description", type: "string", required: true, searchable: true }, { key: "method", label: "Method", type: "select", options: ["GET", "POST", "PUT", "PATCH", "DELETE"] }, { key: "path", label: "Path", type: "string" }, { key: "auth", label: "Auth Required", type: "select", options: ["none", "api-key", "bearer", "session"] }] },
+      { slug: "decisions", name: "Decisions", description: "Significant decisions with rationale and context", fields: [{ key: "rationale", label: "Rationale", type: "string", required: true, searchable: true }, { key: "date", label: "Date", type: "string" }, { key: "decidedBy", label: "Decided By", type: "string" }, { key: "alternatives", label: "Alternatives", type: "string" }] },
+      { slug: "tensions", name: "Tensions", description: "Friction points, pain points, and unmet needs", fields: [{ key: "description", label: "Description", type: "string", required: true, searchable: true }, { key: "priority", label: "Priority", type: "select", options: ["low", "medium", "high", "critical"] }, { key: "severity", label: "Severity", type: "select", options: ["low", "medium", "high", "critical"] }] }
+    ]
+  },
+  {
+    id: "content-business",
+    name: "Content Business",
+    description: "For content creators, publishers, and media companies \u2014 topics, audience segments, content calendar, and brand voice",
+    collections: [
+      { slug: "glossary", name: "Glossary", description: "Industry terminology and brand language", fields: [{ key: "canonical", label: "Canonical", type: "string", required: true, searchable: true }, { key: "category", label: "Category", type: "string" }] },
+      { slug: "topics", name: "Topics", description: "Content topics and themes", fields: [{ key: "description", label: "Description", type: "string", required: true, searchable: true }, { key: "pillar", label: "Content Pillar", type: "string" }, { key: "stage", label: "Stage", type: "select", options: ["idea", "researching", "drafting", "published", "evergreen"] }] },
+      { slug: "audience-segments", name: "Audience Segments", description: "Target reader/viewer personas", fields: [{ key: "description", label: "Description", type: "string", required: true, searchable: true }, { key: "painPoints", label: "Pain Points", type: "string" }, { key: "channels", label: "Channels", type: "array" }] },
+      { slug: "brand-voice", name: "Brand Voice", description: "Tone, style, and voice guidelines", fields: [{ key: "description", label: "Description", type: "string", required: true, searchable: true }, { key: "doThis", label: "Do This", type: "string" }, { key: "notThis", label: "Not This", type: "string" }] },
+      { slug: "decisions", name: "Decisions", description: "Editorial and strategic decisions", fields: [{ key: "rationale", label: "Rationale", type: "string", required: true, searchable: true }, { key: "date", label: "Date", type: "string" }, { key: "decidedBy", label: "Decided By", type: "string" }] },
+      { slug: "tensions", name: "Tensions", description: "Content gaps, audience friction, and unmet needs", fields: [{ key: "description", label: "Description", type: "string", required: true, searchable: true }, { key: "priority", label: "Priority", type: "select", options: ["low", "medium", "high", "critical"] }] }
+    ]
+  },
+  {
+    id: "agency",
+    name: "Agency",
+    description: "For agencies managing multiple clients \u2014 client profiles, project scopes, deliverables, and processes",
+    collections: [
+      { slug: "glossary", name: "Glossary", description: "Agency and client terminology", fields: [{ key: "canonical", label: "Canonical", type: "string", required: true, searchable: true }, { key: "category", label: "Category", type: "string" }] },
+      { slug: "clients", name: "Clients", description: "Client profiles and relationship context", fields: [{ key: "description", label: "Description", type: "string", required: true, searchable: true }, { key: "industry", label: "Industry", type: "string" }, { key: "contact", label: "Primary Contact", type: "string" }] },
+      { slug: "deliverables", name: "Deliverables", description: "Standard deliverable types and templates", fields: [{ key: "description", label: "Description", type: "string", required: true, searchable: true }, { key: "type", label: "Type", type: "string" }, { key: "estimatedHours", label: "Estimated Hours", type: "string" }] },
+      { slug: "processes", name: "Processes", description: "Standard operating procedures and workflows", fields: [{ key: "description", label: "Description", type: "string", required: true, searchable: true }, { key: "steps", label: "Steps", type: "string" }, { key: "owner", label: "Owner", type: "string" }] },
+      { slug: "decisions", name: "Decisions", description: "Strategic and operational decisions", fields: [{ key: "rationale", label: "Rationale", type: "string", required: true, searchable: true }, { key: "date", label: "Date", type: "string" }] },
+      { slug: "tensions", name: "Tensions", description: "Process bottlenecks and client friction", fields: [{ key: "description", label: "Description", type: "string", required: true, searchable: true }, { key: "priority", label: "Priority", type: "select", options: ["low", "medium", "high", "critical"] }] }
+    ]
+  },
+  {
+    id: "saas-api",
+    name: "SaaS API",
+    description: "For API-first SaaS products \u2014 endpoints, schemas, rate limits, changelog, and integration guides",
+    collections: [
+      { slug: "glossary", name: "Glossary", description: "API and domain terminology", fields: [{ key: "canonical", label: "Canonical", type: "string", required: true, searchable: true }, { key: "category", label: "Category", type: "string" }] },
+      { slug: "api-endpoints", name: "API Endpoints", description: "API routes and contracts", fields: [{ key: "description", label: "Description", type: "string", required: true, searchable: true }, { key: "method", label: "Method", type: "select", options: ["GET", "POST", "PUT", "PATCH", "DELETE"] }, { key: "path", label: "Path", type: "string" }, { key: "auth", label: "Auth", type: "select", options: ["none", "api-key", "bearer", "oauth"] }] },
+      { slug: "schemas", name: "Schemas", description: "Data models and API schemas", fields: [{ key: "description", label: "Description", type: "string", required: true, searchable: true }, { key: "format", label: "Format", type: "select", options: ["json", "protobuf", "graphql", "openapi"] }, { key: "version", label: "Version", type: "string" }] },
+      { slug: "rate-limits", name: "Rate Limits", description: "Rate limiting policies and tiers", fields: [{ key: "description", label: "Description", type: "string", required: true, searchable: true }, { key: "tier", label: "Tier", type: "string" }, { key: "limit", label: "Limit", type: "string" }] },
+      { slug: "changelog", name: "Changelog", description: "API version history and breaking changes", fields: [{ key: "description", label: "Description", type: "string", required: true, searchable: true }, { key: "version", label: "Version", type: "string" }, { key: "date", label: "Date", type: "string" }, { key: "breaking", label: "Breaking", type: "select", options: ["yes", "no"] }] },
+      { slug: "decisions", name: "Decisions", description: "API design decisions and rationale", fields: [{ key: "rationale", label: "Rationale", type: "string", required: true, searchable: true }, { key: "date", label: "Date", type: "string" }] }
+    ]
+  },
+  {
+    id: "general",
+    name: "General",
+    description: "A minimal starter set \u2014 glossary, decisions, and tensions. Add more collections as you need them.",
+    collections: [
+      { slug: "glossary", name: "Glossary", description: "Canonical terminology", fields: [{ key: "canonical", label: "Canonical", type: "string", required: true, searchable: true }, { key: "category", label: "Category", type: "string" }] },
+      { slug: "decisions", name: "Decisions", description: "Decisions with rationale", fields: [{ key: "rationale", label: "Rationale", type: "string", required: true, searchable: true }, { key: "date", label: "Date", type: "string" }, { key: "decidedBy", label: "Decided By", type: "string" }] },
+      { slug: "tensions", name: "Tensions", description: "Friction points and unmet needs", fields: [{ key: "description", label: "Description", type: "string", required: true, searchable: true }, { key: "priority", label: "Priority", type: "select", options: ["low", "medium", "high", "critical"] }] }
+    ]
+  }
+];
+function getPreset(id) {
+  return COLLECTION_PRESETS.find((p) => p.id === id);
+}
+function listPresets() {
+  return COLLECTION_PRESETS.map((p) => ({
+    id: p.id,
+    name: p.name,
+    description: p.description,
+    collectionCount: p.collections.length
+  }));
+}
+
+// src/tools/start.ts
+function registerStartTools(server) {
+  server.registerTool(
+    "start",
+    {
+      title: "Start Product Brain",
+      description: "The zero-friction entry point. Say 'start PB' to begin.\n\n- **Fresh workspace**: asks what you're building, seeds tailored collections, and gets you ready to capture knowledge immediately.\n- **Existing workspace**: returns readiness score, recent activity, open tensions, and suggested next actions (same as orient).\n\nUse this as your first call. Replaces the need to call orient, workspace-status, or health separately.",
+      inputSchema: {
+        preset: z9.string().optional().describe(
+          "Collection preset ID to seed (e.g. 'software-product', 'content-business', 'agency', 'saas-api', 'general'). Only used for fresh workspaces. If omitted on a fresh workspace, returns the preset menu."
+        )
+      },
+      annotations: { readOnlyHint: false }
+    },
+    async ({ preset }) => {
+      const errors = [];
+      const agentSessionId = getAgentSessionId();
+      let wsCtx = null;
+      try {
+        wsCtx = await getWorkspaceContext();
+      } catch (e) {
+        errors.push(`Workspace: ${e.message}`);
+      }
+      if (!wsCtx) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: "# Could not connect to Product Brain\n\n" + (errors.length > 0 ? errors.map((e) => `- ${e}`).join("\n") : "Check your API key and CONVEX_SITE_URL.")
+            }
+          ]
+        };
+      }
+      const isFresh = await detectFreshWorkspace();
+      if (isFresh && !preset) {
+        return { content: [{ type: "text", text: buildPresetMenu(wsCtx) }] };
+      }
+      if (isFresh && preset) {
+        return { content: [{ type: "text", text: await seedPreset(wsCtx, preset, agentSessionId) }] };
+      }
+      return { content: [{ type: "text", text: await buildOrientResponse(wsCtx, agentSessionId, errors) }] };
+    }
+  );
+}
+async function detectFreshWorkspace() {
+  try {
+    const entries = await mcpQuery("chain.listEntries", {});
+    const nonSystem = (entries ?? []).filter((e) => e.stratum !== "system");
+    return nonSystem.length === 0;
+  } catch {
+    return false;
+  }
+}
+function buildPresetMenu(wsCtx) {
+  const presets = listPresets();
+  const lines = [
+    `# Welcome to ${wsCtx.workspaceName}`,
+    "",
+    "Your workspace is fresh \u2014 let's get it set up together.",
+    "",
+    "**Tell me: what are you building?** Describe it in a sentence or two and I'll help you pick the right structure. Or choose a preset to start from:",
+    ""
+  ];
+  for (const p of presets) {
+    lines.push(`- **${p.name}** (\`${p.id}\`) \u2014 ${p.description} (${p.collectionCount} collections)`);
+  }
+  lines.push(
+    "",
+    'Call `start` again with your choice, e.g.: `start preset="software-product"`',
+    "",
+    "_These are starting points. You can add, remove, or customize collections at any time using `create-collection` and `update-collection`._"
+  );
+  return lines.join("\n");
+}
+async function seedPreset(wsCtx, presetId, agentSessionId) {
+  const preset = getPreset(presetId);
+  if (!preset) {
+    return `Preset "${presetId}" not found.
+
+Available presets: ${listPresets().map((p) => `\`${p.id}\``).join(", ")}`;
+  }
+  const seeded = [];
+  const skipped = [];
+  for (const col of preset.collections) {
+    try {
+      await mcpCall("chain.createCollection", {
+        slug: col.slug,
+        name: col.name,
+        description: col.description,
+        icon: col.icon,
+        fields: col.fields,
+        stratum: "working",
+        createdBy: "preset:" + presetId
+      });
+      seeded.push(col.name);
+    } catch {
+      skipped.push(`${col.name} (already exists)`);
+    }
+  }
+  if (agentSessionId) {
+    try {
+      await mcpCall("agent.markOriented", { sessionId: agentSessionId });
+      setSessionOriented(true);
+    } catch {
+    }
+  }
+  const lines = [
+    `# ${wsCtx.workspaceName} is ready`,
+    "",
+    `Seeded **${preset.name}** preset with ${seeded.length} collection${seeded.length === 1 ? "" : "s"}:`,
+    ""
+  ];
+  for (const name of seeded) {
+    lines.push(`- ${name}`);
+  }
+  if (skipped.length > 0) {
+    lines.push("", "Skipped (already exist):");
+    for (const name of skipped) {
+      lines.push(`- ${name}`);
+    }
+  }
+  lines.push(
+    "",
+    "## Let's activate your workspace",
+    "",
+    "I'll help you load knowledge step by step. Everything stays as a draft until you confirm it.",
+    "",
+    "**First:** Tell me what you're building in one or two sentences. I'll capture it as your product vision.",
+    "",
+    `_After that, we'll add a few key terms to your glossary and any important decisions. Each entry is a draft \u2014 say "commit" or "looks good" when you're happy with it, and I'll promote it to the Chain (SSOT)._`,
+    "",
+    "You can also customize your structure anytime: `create-collection`, `update-collection`, or `list-collections`.",
+    "",
+    "---",
+    "Orientation complete. Write tools are available."
+  );
+  return lines.join("\n");
+}
+function computeWorkspaceAge(createdAt) {
+  if (!createdAt) return { ageDays: 0, isNeglected: false };
+  const ageDays = Math.floor((Date.now() - createdAt) / (1e3 * 60 * 60 * 24));
+  return { ageDays, isNeglected: ageDays >= 30 };
+}
+function pickNextAction(gaps, openTensions, priorSessions) {
+  if (gaps.length === 0 && openTensions.length === 0) return null;
+  if (gaps.length > 0) {
+    const gap = gaps[0];
+    const ctaMap = {
+      "strategy-vision": "Tell me what you're building \u2014 your vision, mission, and north star \u2014 and I'll capture it.",
+      "architecture-layers": "Describe your architecture in a few sentences and I'll capture it.",
+      "glossary-foundation": "What are the key terms your team uses? Tell me a few and I'll add them to the glossary.",
+      "decisions-documented": "What's a recent significant decision your team made? I'll document it with the rationale.",
+      "tensions-tracked": "What's a friction point or pain point you're dealing with? I'll capture it as a tension."
+    };
+    const cta = ctaMap[gap.id] ?? `Tell me about your ${gap.label.toLowerCase()} and I'll capture it.`;
+    return { action: gap.label, cta };
+  }
+  if (openTensions.length > 0) {
+    const t = openTensions[0];
+    return {
+      action: `Open tension: ${t.name}`,
+      cta: "Want to discuss this tension or capture a decision about it?"
+    };
+  }
+  return null;
+}
+async function buildOrientResponse(wsCtx, agentSessionId, errors) {
+  const wsFullCtx = await getWorkspaceContext();
+  const { ageDays, isNeglected } = computeWorkspaceAge(wsFullCtx.createdAt);
+  let priorSessions = [];
+  try {
+    priorSessions = await mcpQuery("agent.recentSessions", { limit: 3 });
+  } catch {
+  }
+  let openTensions = [];
+  try {
+    const tensions = await mcpQuery("chain.listEntries", { collectionSlug: "tensions" });
+    openTensions = (tensions ?? []).filter((e) => e.status === "draft");
+  } catch {
+  }
+  let readiness = null;
+  try {
+    readiness = await mcpQuery("chain.workspaceReadiness");
+  } catch (e) {
+    errors.push(`Readiness: ${e.message}`);
+  }
+  const lines = [];
+  const isLowReadiness = readiness && readiness.score < 50;
+  const isHighReadiness = readiness && readiness.score >= 50;
+  lines.push(`# ${wsCtx.workspaceName}`);
+  lines.push(`_Workspace \`${wsCtx.workspaceSlug}\` \u2014 Product Brain is healthy._`);
+  lines.push("");
+  if (isLowReadiness && isNeglected) {
+    lines.push(`Your workspace has been around for ${ageDays} days but is only ${readiness.score}% ready.`);
+    lines.push("Let's close the gaps \u2014 or if the current structure doesn't fit, we can reshape it.");
+    lines.push("");
+  } else if (isLowReadiness) {
+    lines.push(`Readiness: ${readiness.score}%. Let's get your workspace active.`);
+    lines.push("");
+  }
+  if (isLowReadiness) {
+    const nextAction = pickNextAction(readiness.gaps ?? [], openTensions, priorSessions);
+    if (nextAction) {
+      lines.push("## Recommended next step");
+      lines.push(`**${nextAction.action}**`);
+      lines.push("");
+      lines.push(nextAction.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 = (readiness.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 `create-collection` to add it, or ask me to propose collections for your domain._");
+    lines.push("");
+  } else if (isHighReadiness) {
+    if (readiness) {
+      lines.push(`Readiness: ${readiness.score}% (${readiness.passedChecks}/${readiness.totalChecks}).`);
+    }
+    const plannedWork = await queryPlannedWork();
+    if (hasPlannedWork(plannedWork)) {
+      lines.push("");
+      lines.push(...buildPlannedWorkSection(plannedWork, priorSessions));
+    } else {
+      const briefingItems = [];
+      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;
+        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("");
+        lines.push("## Briefing");
+        for (const item of briefingItems) {
+          lines.push(`- ${item}`);
+        }
+        lines.push("");
+      }
+    }
+    lines.push("What would you like to work on?");
+    lines.push("");
+  }
+  if (errors.length > 0) {
+    lines.push("## Errors");
+    for (const err of errors) lines.push(`- ${err}`);
+    lines.push("");
+  }
+  if (agentSessionId) {
+    try {
+      await mcpCall("agent.markOriented", { sessionId: agentSessionId });
+      setSessionOriented(true);
+      lines.push("---");
+      lines.push(
+        `Orientation complete. Session ${agentSessionId}. Write tools available.`
+      );
+    } catch {
+      lines.push("---");
+      lines.push("_Warning: Could not mark session as oriented. Write tools may be restricted._");
+    }
+  } else {
+    lines.push("---");
+    lines.push("_No active agent session. Call `agent-start` to begin a tracked session._");
+  }
+  return lines.join("\n");
+}
+
+// src/resources/index.ts
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+function formatEntryMarkdown(entry) {
+  const id = entry.entryId ? `${entry.entryId}: ` : "";
+  const lines = [`## ${id}${entry.name} [${entry.status}]`];
+  if (entry.data && typeof entry.data === "object") {
+    for (const [key, val] of Object.entries(entry.data)) {
+      if (val && key !== "rawData") {
+        lines.push(`**${key}**: ${typeof val === "string" ? val : JSON.stringify(val)}`);
+      }
+    }
+  }
+  return lines.join("\n");
+}
+function buildOrientationMarkdown(collections, trackingEvents, standards, businessRules) {
+  const sections = ["# Product Brain \u2014 Orientation"];
+  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 gather-context returns richer results \u2192 AI processes have more context \u2192 quality scores improve \u2192 next commit is smarter than the last."
+  );
+  sections.push(
+    "## Architecture\n```\nCursor (stdio) \u2192 MCP Server (mcp-server/src/index.ts)\n  \u2192 POST /api/mcp with Bearer token\n  \u2192 Convex HTTP Action (convex/http.ts)\n  \u2192 internalQuery / internalMutation (convex/mcpKnowledge.ts)\n  \u2192 Convex DB (workspace-scoped)\n```\nSecurity: API key auth on every request, workspace-scoped data, internal functions blocked from external clients.\nKey files: `packages/mcp-server/src/client.ts` (HTTP client + audit), `convex/schema.ts` (schema)."
+  );
+  if (collections) {
+    const collList = collections.map((c) => {
+      const prefix = c.icon ? `${c.icon} ` : "";
+      return `- ${prefix}**${c.name}** (\`${c.slug}\`) \u2014 ${c.description || "no description"}`;
+    }).join("\n");
+    sections.push(
+      `## Data Model (${collections.length} collections)
+Unified entries model: collections define field schemas, entries hold data in a flexible \`data\` field.
+The \`data\` field is polymorphic: plain fields for generic entries, \`ChainData\` (chainTypeId + links) for processes, \`MapData\` (templateId + slots) for maps.
+Tags for filtering (e.g. \`severity:high\`), relations via \`entryRelations\`, versions via \`entryVersions\`, labels via \`labels\` + \`entryLabels\`.
+
+` + collList + "\n\nUse `list-collections` for field schemas, `get-entry` for full records."
+    );
+  } else {
+    sections.push(
+      "## Data Model\nCould not load collections \u2014 use `list-collections` 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: \`search\` for text search, \`list-entries 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: \`list-entries 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- `gather-context` \u2014 get the full context around any entry (multi-hop graph traversal)\n- `suggest-links` \u2014 discover potential connections for an entry\n- `relate-entries` \u2014 create a typed link between two entries\n- `find-related` \u2014 list direct relations for an entry\n\n**Convention:** When creating or updating entries in governed collections, always use `suggest-links` 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-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 `gather-context` tool (by entry ID or task description)\n- **Discover links** \u2192 `suggest-links` tool\n- **Quality audit** \u2192 `quality-check` tool\n- **Terminology** \u2192 `name-check` prompt or `productbrain://terminology` resource\n- **Schema details** \u2192 `productbrain://collections` resource or `list-collections` tool\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 `list-entries collection=strategy status=draft`\n- **Audiences** \u2192 `productbrain://audiences/entries` resource or `list-entries collection=audiences`\n- **Session identity** \u2192 `whoami` tool (workspace + auth context)\n- **Health check** \u2192 `health` tool\n- **Debug MCP calls** \u2192 `mcp-audit` tool"
+  );
+  return sections.join("\n\n---\n\n");
+}
+function registerResources(server) {
+  server.resource(
+    "chain-orientation",
+    "productbrain://orientation",
+    async (uri) => {
+      const [collectionsResult, eventsResult, standardsResult, rulesResult] = await Promise.allSettled([
+        mcpQuery("chain.listCollections"),
+        mcpQuery("chain.listEntries", { collectionSlug: "tracking-events" }),
+        mcpQuery("chain.listEntries", { collectionSlug: "standards" }),
+        mcpQuery("chain.listEntries", { collectionSlug: "business-rules" })
+      ]);
+      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;
+      return {
+        contents: [{
+          uri: uri.href,
+          text: buildOrientationMarkdown(collections, trackingEvents, standards, businessRules),
+          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") {
+        if (glossaryResult.value.length > 0) {
+          const terms = glossaryResult.value.map((t) => `- **${t.name}** (${t.entryId ?? "\u2014"}) [${t.status}]: ${t.data?.canonical ?? t.data?.description ?? ""}`).join("\n");
+          lines.push(`## Glossary (${glossaryResult.value.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 `list-entries collection=glossary` to browse manually.");
+      }
+      if (standardsResult.status === "fulfilled") {
+        if (standardsResult.value.length > 0) {
+          const stds = standardsResult.value.map((s) => `- **${s.name}** (${s.entryId ?? "\u2014"}) [${s.status}]: ${s.data?.description ?? ""}`).join("\n");
+          lines.push(`## Standards (${standardsResult.value.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 `list-entries 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.", mimeType: "text/markdown" }] };
+      }
+      const formatted = collections.map((c) => {
+        const fieldList = c.fields.map((f) => `  - \`${f.key}\` (${f.type}${f.required ? ", required" : ""}${f.searchable ? ", searchable" : ""})`).join("\n");
+        return `## ${c.icon ?? ""} ${c.name} (\`${c.slug}\`)
+${c.description || ""}
+
+**Fields:**
+${fieldList}`;
+      }).join("\n\n---\n\n");
+      return {
+        contents: [{ uri: uri.href, text: `# Knowledge Collections (${collections.length})
+
+${formatted}`, mimeType: "text/markdown" }]
+      };
+    }
+  );
+  server.resource(
+    "chain-collection-entries",
+    new ResourceTemplate("productbrain://{slug}/entries", {
+      list: async () => {
+        const collections = await mcpQuery("chain.listCollections");
+        return {
+          resources: collections.map((c) => ({
+            uri: `productbrain://${c.slug}/entries`,
+            name: `${c.icon ?? ""} ${c.name}`.trim()
+          }))
+        };
+      }
+    }),
+    async (uri, { slug }) => {
+      const entries = await mcpQuery("chain.listEntries", { collectionSlug: slug });
+      const formatted = entries.map(formatEntryMarkdown).join("\n\n---\n\n");
+      return {
+        contents: [{
+          uri: uri.href,
+          text: formatted || "No entries in this collection.",
+          mimeType: "text/markdown"
+        }]
+      };
+    }
+  );
+  server.resource(
+    "chain-labels",
+    "productbrain://labels",
+    async (uri) => {
+      const labels = await mcpQuery("chain.listLabels");
+      if (labels.length === 0) {
+        return { contents: [{ uri: uri.href, text: "No labels in this workspace.", mimeType: "text/markdown" }] };
+      }
+      const groups = labels.filter((l) => l.isGroup);
+      const ungrouped = labels.filter((l) => !l.isGroup && !l.parentId);
+      const children = (parentId) => labels.filter((l) => l.parentId === parentId);
+      const lines = [];
+      for (const group of groups) {
+        lines.push(`## ${group.name}`);
+        for (const child of children(group._id)) {
+          lines.push(`- \`${child.slug}\` ${child.name}${child.color ? ` (${child.color})` : ""}`);
+        }
+      }
+      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" }]
+      };
+    }
+  );
+}
+
+// src/prompts/index.ts
+import { z as z10 } from "zod";
+function registerPrompts(server) {
+  server.prompt(
+    "review-against-rules",
+    "Review code or a design decision against all business rules for a given domain. Fetches the rules and asks you to do a structured compliance review.",
+    { domain: z10.string().describe("Business rule domain (e.g. 'Identity & Access', 'Governance & Decision-Making')") },
+    async ({ domain }) => {
+      const entries = await mcpQuery("chain.listEntries", { collectionSlug: "business-rules" });
+      const rules = entries.filter((e) => e.data?.domain === domain);
+      if (rules.length === 0) {
+        return {
+          messages: [
+            {
+              role: "user",
+              content: {
+                type: "text",
+                text: `No business rules found for domain "${domain}". Use the list-entries tool with collection "business-rules" to see available domains.`
+              }
+            }
+          ]
+        };
+      }
+      const rulesText = rules.map(
+        (r) => `### ${r.entryId ?? ""}: ${r.name}
+Status: ${r.status} | Severity: ${r.data?.severity ?? "unknown"}
+Description: ${r.data?.description ?? ""}
+Data Impact: ${r.data?.dataImpact ?? ""}
+Platforms: ${(r.data?.platforms ?? []).join(", ")}
+` + (r.data?.conflictWith ? `CONFLICT: ${r.data.conflictWith.rule} \u2014 ${r.data.conflictWith.nature}
+` : "")
+      ).join("\n---\n\n");
+      return {
+        messages: [
+          {
+            role: "user",
+            content: {
+              type: "text",
+              text: `Review the current code or design against the following business rules for the "${domain}" domain.
+
+For each rule, assess:
+1. Is the current implementation compliant?
+2. Are there potential violations or edge cases?
+3. What specific changes would be needed for compliance?
+
+Business Rules:
+
+${rulesText}
+
+Provide a structured review with a compliance status for each rule (COMPLIANT / AT RISK / VIOLATION / NOT APPLICABLE).`
+            }
+          }
+        ]
+      };
+    }
+  );
+  server.prompt(
+    "name-check",
+    "Check variable names, field names, or API names against the glossary for terminology alignment. Flags drift from canonical terms.",
+    { names: z10.string().describe("Comma-separated list of names to check (e.g. 'vendor_id, compliance_level, formulator_type')") },
+    async ({ names }) => {
+      const terms = await mcpQuery("chain.listEntries", { collectionSlug: "glossary" });
+      const glossaryContext = terms.map(
+        (t) => `${t.name} (${t.entryId ?? ""}) [${t.status}]: ${t.data?.canonical ?? ""}` + (t.data?.confusedWith?.length > 0 ? ` \u2014 Often confused with: ${t.data.confusedWith.join(", ")}` : "") + (t.data?.codeMapping?.length > 0 ? `
+  Code mappings: ${t.data.codeMapping.map((m) => `${m.platform}:${m.field}`).join(", ")}` : "")
+      ).join("\n");
+      return {
+        messages: [
+          {
+            role: "user",
+            content: {
+              type: "text",
+              text: `Check the following names against the glossary for terminology alignment:
+
+Names to check: ${names}
+
+Glossary (canonical terms):
+${glossaryContext}
+
+For each name:
+1. Does it match a canonical term? If so, which one?
+2. Is there terminology drift? (e.g. using "vendor" instead of "supplier", "compliance" instead of "conformance")
+3. Suggest the canonical alternative if drift is detected.
+4. Flag any names that don't have a corresponding glossary term (might need one).
+
+Format as a table: Name | Status | Canonical Form | Action Needed`
+            }
+          }
+        ]
+      };
+    }
+  );
+  server.prompt(
+    "draft-decision-record",
+    "Draft a structured decision record from a description of what was decided. Includes context from recent decisions and relevant rules.",
+    { context: z10.string().describe("Description of the decision (e.g. 'We decided to use MRSL v3.1 as the conformance baseline because...')") },
+    async ({ context }) => {
+      const recentDecisions = await mcpQuery("chain.listEntries", { collectionSlug: "decisions" });
+      const sorted = [...recentDecisions].sort((a, b) => (b.data?.date ?? "") > (a.data?.date ?? "") ? 1 : -1).slice(0, 5);
+      const recentContext = sorted.length > 0 ? sorted.map((d) => `- [${d.status}] ${d.name} (${d.data?.date ?? "no date"})`).join("\n") : "No previous decisions recorded.";
+      return {
+        messages: [
+          {
+            role: "user",
+            content: {
+              type: "text",
+              text: `Draft a structured decision record from the following context:
+
+"${context}"
+
+Recent decisions for reference:
+${recentContext}
+
+Structure the decision record with:
+1. **Title**: Concise decision statement
+2. **Decided by**: Who made or approved this decision
+3. **Date**: When it was decided
+4. **Status**: decided / proposed / revisited
+5. **Rationale**: Why this decision was made, including trade-offs considered
+6. **Alternatives considered**: What else was on the table
+7. **Related rules or tensions**: Any business rules or tensions this connects to
+
+After drafting, I can log it using the capture tool with collection "decisions".`
+            }
+          }
+        ]
+      };
+    }
+  );
+  server.prompt(
+    "draft-rule-from-context",
+    "Draft a new business rule from an observation or discovery made while coding. Fetches existing rules for the domain to ensure consistency.",
+    {
+      observation: z10.string().describe("What you observed or discovered (e.g. 'Suppliers can have multiple org types in Gateway')"),
+      domain: z10.string().describe("Which domain this rule belongs to (e.g. 'Governance & Decision-Making')")
+    },
+    async ({ observation, domain }) => {
+      const allRules = await mcpQuery("chain.listEntries", { collectionSlug: "business-rules" });
+      const existingRules = allRules.filter((r) => r.data?.domain === domain);
+      const existingContext = existingRules.length > 0 ? existingRules.map((r) => `${r.entryId ?? ""}: ${r.name} [${r.status}] \u2014 ${r.data?.description ?? ""}`).join("\n") : "No existing rules for this domain.";
+      const highestRuleNum = allRules.map((r) => parseInt((r.entryId ?? "").replace(/^[A-Z]+-/, ""), 10)).filter((n) => !isNaN(n)).sort((a, b) => b - a)[0] || 0;
+      const nextRuleId = `SOS-${String(highestRuleNum + 1).padStart(3, "0")}`;
+      return {
+        messages: [
+          {
+            role: "user",
+            content: {
+              type: "text",
+              text: `Draft a business rule based on this observation:
+
+"${observation}"
+
+Domain: ${domain}
+Suggested rule ID: ${nextRuleId}
+
+Existing rules in this domain:
+${existingContext}
+
+Draft the rule with these fields:
+1. **entryId**: ${nextRuleId}
+2. **name**: Concise rule title
+3. **data.description**: What the rule states
+4. **data.rationale**: Why this rule matters
+5. **data.dataImpact**: How this affects data models, APIs, or storage
+6. **data.severity**: high / medium / low
+7. **data.platforms**: Which platforms are affected
+8. **data.relatedRules**: Any related existing rules
+
+Make sure the rule is consistent with existing rules and doesn't contradict them. After drafting, I can create it using the capture tool with collection "business-rules".`
+            }
+          }
+        ]
+      };
+    }
+  );
+  server.prompt(
+    "run-workflow",
+    "Launch a Chainwork workflow (retro, shape, IDM) in Facilitator Mode. Returns the full workflow definition, facilitation instructions, and round structure. The agent enters Facilitator Mode and guides the participant through each round.",
+    {
+      workflow: z10.string().describe(
+        "Workflow ID to run. Available: " + listWorkflows().map((w) => `'${w.id}' (${w.name})`).join(", ")
+      ),
+      context: z10.string().optional().describe(
+        "Optional context from the participant (e.g., 'retro on last sprint', 'shape the Chainwork API bet')"
+      )
+    },
+    async ({ workflow: workflowId, context }) => {
+      const wf = getWorkflow(workflowId);
+      if (!wf) {
+        const available = listWorkflows().map((w) => `- **${w.id}**: ${w.name} \u2014 ${w.shortDescription}`).join("\n");
+        return {
+          messages: [
+            {
+              role: "user",
+              content: {
+                type: "text",
+                text: `Workflow "${workflowId}" not found.
+
+Available workflows:
+${available}
+
+Use one of these IDs to run a workflow.`
+              }
+            }
+          ]
+        };
+      }
+      let kbContext = "";
+      try {
+        const recentDecisions = await mcpQuery("chain.listEntries", {
+          collectionSlug: wf.kbOutputCollection
+        });
+        const sorted = [...recentDecisions].sort((a, b) => (b.data?.date ?? "") > (a.data?.date ?? "") ? 1 : -1).slice(0, 5);
+        if (sorted.length > 0) {
+          kbContext = `
+## Recent ${wf.kbOutputCollection} entries (for context)
+` + sorted.map((d) => `- ${d.entryId ?? ""}: ${d.name} [${d.status}]`).join("\n");
+        }
+      } catch {
+        kbContext = "\n_Could not load chain context \u2014 proceed without it._";
+      }
+      const roundsPlan = wf.rounds.map(
+        (r) => `### Round ${r.num}: ${r.label}
+**Type**: ${r.type} | **Duration**: ~${r.maxDurationHint ?? "5 min"}
+**Instruction**: ${r.instruction}
+**Facilitator guidance**: ${r.facilitatorGuidance}
+` + (r.questions ? r.questions.map(
+          (q) => `**Question**: ${q.prompt}
+` + (q.options ? q.options.map((o) => `  - ${o.id}: ${o.label}`).join("\n") : "  _(open response)_")
+        ).join("\n") : "") + `
+**Output**: Capture to \`${r.outputSchema.field}\` (${r.outputSchema.format})`
+      ).join("\n\n---\n\n");
+      const contextLine = context ? `
+The participant provided this context: "${context}"
+Use it \u2014 don't make them repeat themselves.
+` : "";
+      return {
+        messages: [
+          {
+            role: "user",
+            content: {
+              type: "text",
+              text: `# ${wf.icon} ${wf.name} Workflow \u2014 Facilitator Mode
+
+${wf.shortDescription}
+` + contextLine + `
+---
+
+## Facilitator Instructions
+
+${wf.facilitatorPreamble}
+
+---
+
+## Rounds
+
+${roundsPlan}
+
+---
+
+## Error Recovery
+
+${wf.errorRecovery}
+
+---
+
+## Chain Output
+
+When complete, use \`capture\` to create a \`${wf.kbOutputCollection}\` entry.
+Name template: ${wf.kbOutputTemplate.nameTemplate}
+Description field: ${wf.kbOutputTemplate.descriptionField}
+` + kbContext + `
+
+---
+
+**BEGIN THE WORKFLOW NOW.** Start with Round 01. Create a Plan first.`
+            }
+          }
+        ]
+      };
+    }
+  );
+}
+
+// src/server.ts
+var SERVER_VERSION = "0.0.1-beta";
+var INSTRUCTIONS = [
+  "Product Brain \u2014 the single source of truth for product knowledge.",
+  "Terminology, standards, and core data all live here \u2014 no need to check external docs.",
+  "",
+  "Workflow:",
+  "  1. Start: call `agent-start` to begin a tracked session.",
+  "  2. Orient: call `orient` to load workspace context and unlock write tools.",
+  "  3. Discover: use `search` to find entries, or `list-entries` to browse.",
+  "  4. Drill in: use `get-entry` for full details \u2014 data, labels, relations, history.",
+  "  5. Context: use `gather-context` with an entryId or a task description.",
+  "  6. Capture: use `capture` to create entries \u2014 auto-links and scores in one call.",
+  "  7. Commit: use `commit-entry` to promote drafts to SSOT \u2014 only when the user confirms.",
+  "  8. Connect: use `suggest-links` then `relate-entries` to build the graph.",
+  "  9. Close: call `agent-close` when done \u2014 records session activity.",
+  "",
+  "Write tools (capture, update-entry, relate-entries, commit-entry) require:",
+  "  - An active agent session (call agent-start)",
+  "  - Completed orientation (call orient)",
+  "  - A readwrite API key scope",
+  "",
+  "Commit-on-confirm: always capture as draft first and show the user what was captured.",
+  "Only call `commit-entry` when the user explicitly confirms (e.g. 'commit', 'looks good', 'yes').",
+  "This builds trust \u2014 the Chain (main) is SSOT; nothing goes there without user consent.",
+  "",
+  "Workspace setup: use `create-collection` and `update-collection` to shape the workspace",
+  "structure with the user. Ask what they need to track; presets are starting points, not fixed.",
+  "",
+  "Personalization: if you have context about the user from memory (prior work, recent",
+  "conversations, team context), use it to personalize recommendations. For example,",
+  "'Based on your recent pitch reviews, the gap most likely to matter is X.'",
+  "The orient/start output gives you the workspace state; your memory fills in the human context."
+].join("\n");
+function createProductBrainServer() {
+  const server = new McpServer2(
+    { name: "Product Brain", version: SERVER_VERSION },
+    { capabilities: { logging: {} }, instructions: INSTRUCTIONS }
+  );
+  const enabledModules = new Set(
+    (process.env.PB_MODULES ?? "core,gitchain,arch").split(",").map((m) => m.trim().toLowerCase())
+  );
+  registerSessionTools(server);
+  registerKnowledgeTools(server);
+  registerLabelTools(server);
+  registerHealthTools(server);
+  registerVerifyTools(server);
+  registerSmartCaptureTools(server);
+  registerWorkflowTools(server);
+  if (enabledModules.has("gitchain")) registerGitChainTools(server);
+  if (enabledModules.has("gitchain")) registerMapTools(server);
+  if (enabledModules.has("arch")) registerArchitectureTools(server);
+  registerStartTools(server);
+  registerResources(server);
+  registerPrompts(server);
+  return server;
+}
+
+export {
+  SERVER_VERSION,
+  createProductBrainServer
+};
+//# sourceMappingURL=chunk-N47IMYAQ.js.map