@productbrain/mcp 0.0.1-beta.37 → 0.0.1-beta.39

package/dist/{chunk-7CD66MUS.js → chunk-XCKGFYDP.js}

@@ -25,7 +25,7 @@ import {
   startAgentSession,
   trackWriteTool,
   translateStaleToolNames
-} from "./chunk-Z2FGGJHI.js";
+} from "./chunk-7VJP2IMS.js";
 import {
   trackQualityCheck,
   trackQualityVerdict
@@ -36,10 +36,32 @@ import { McpServer as McpServer2 } from "@modelcontextprotocol/sdk/server/mcp.js
 
 // src/tools/knowledge.ts
 import { z } from "zod";
+var LEGACY_WORKFLOW_STATUSES = /* @__PURE__ */ new Set([
+  "open",
+  "pending",
+  "decided",
+  "proposed",
+  "accepted",
+  "needs-amendment",
+  "withdrawn",
+  "review",
+  "in-progress",
+  "conflict",
+  "processing",
+  "closed",
+  "shaped",
+  "bet",
+  "building",
+  "shipped"
+]);
 var updateEntrySchema = z.object({
   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"),
+  status: z.union([
+    z.enum(["draft", "active", "deprecated", "archived"]),
+    z.enum(["open", "pending", "decided", "proposed", "accepted", "needs-amendment", "withdrawn", "review", "in-progress", "conflict", "processing", "closed", "shaped", "bet", "building", "shipped"])
+  ]).optional().describe("Lifecycle status: draft | active | deprecated | archived. **Workflow values (open, pending, decided\u2026) are deprecated here \u2014 use `workflowStatus` instead. Passing a workflow value as `status` will be auto-routed with a warning until 2026-09-03, then hard-errored.**"),
+  workflowStatus: z.enum(["open", "pending", "proposed", "accepted", "needs-amendment", "withdrawn", "review", "in-progress", "decided", "conflict", "processing", "closed"]).optional().describe("Collection workflow state (e.g. 'open', 'pending', 'decided', 'conflict'). Validated against collection's allowed values."),
   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."),
@@ -61,12 +83,23 @@ function registerKnowledgeTools(server) {
       inputSchema: updateEntrySchema,
       annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false }
     },
-    async ({ entryId, name, status, data, order, canonicalKey, autoPublish, changeNote }) => {
+    async ({ entryId, name, status: rawStatus, workflowStatus: rawWorkflowStatus, data, order, canonicalKey, autoPublish, changeNote }) => {
       requireWriteAccess();
+      let status = rawStatus;
+      let workflowStatus = rawWorkflowStatus;
+      let deprecationWarning;
+      if (rawStatus && LEGACY_WORKFLOW_STATUSES.has(rawStatus)) {
+        if (!workflowStatus) {
+          workflowStatus = rawStatus;
+        }
+        status = void 0;
+        deprecationWarning = `\u26A0\uFE0F Deprecation: \`status: '${rawStatus}'\` \u2014 use \`workflowStatus: '${rawStatus}'\` instead. Support ends ~2026-09-03.`;
+      }
       const id = await mcpMutation("chain.updateEntry", {
         entryId,
         name,
         status,
+        workflowStatus,
         data,
         order,
         canonicalKey,
@@ -79,13 +112,21 @@ function registerKnowledgeTools(server) {
       const updated = await mcpQuery("chain.getEntry", { entryId });
       const entryStatus = updated?.status ?? "draft";
       const versionMode = entryStatus === "active" ? "published" : `saved as ${entryStatus}`;
+      const responseLines = [
+        `# Entry Updated`,
+        ``,
+        `**${entryId}** \u2014 ${versionMode}.`,
+        ``,
+        `Internal ID: ${id}`,
+        `**Workspace:** ${wsCtx.workspaceSlug} (${wsCtx.workspaceId})`
+      ];
+      if (deprecationWarning) {
+        responseLines.push("");
+        responseLines.push(deprecationWarning);
+      }
       return {
-        content: [{ type: "text", text: `# Entry Updated
-
-**${entryId}** \u2014 ${versionMode}.
-
-Internal ID: ${id}
-**Workspace:** ${wsCtx.workspaceSlug} (${wsCtx.workspaceId})` }]
+        content: [{ type: "text", text: responseLines.join("\n") }],
+        structuredContent: { entryId: id, versionMode }
       };
     }
   );
@@ -125,7 +166,7 @@ ${formatted}` }]
     },
     async ({ entryId }) => {
       requireWriteAccess();
-      const { runContradictionCheck } = await import("./smart-capture-BIKEZC6P.js");
+      const { runContradictionCheck } = await import("./smart-capture-E53YEHHO.js");
       const entry = await mcpQuery("chain.getEntry", { entryId });
       if (!entry) {
         return {
@@ -225,7 +266,7 @@ var entriesSchema = z2.object({
   entryId: z2.string().optional().describe("Entry ID for get action, e.g. 'T-SUPPLIER', 'BR-001'"),
   entryIds: z2.array(z2.string()).min(1).max(20).optional().describe("Entry IDs for batch action, e.g. ['TYPE-strategy', 'STR-jljeg7']"),
   collection: z2.string().optional().describe("Collection slug for list/search, e.g. 'glossary', 'tracking-events', 'business-rules'"),
-  status: z2.string().optional().describe("Filter: draft | active | verified | deprecated"),
+  status: z2.string().optional().describe("Filter: draft | active | deprecated | archived"),
   tag: z2.string().optional().describe("Filter by internal tag for list"),
   label: z2.string().optional().describe("Filter by label slug for list \u2014 matches entries across all collections"),
   query: z2.string().optional().describe("Search text for search action (min 2 characters)")
@@ -334,7 +375,7 @@ async function handleGet(entryId) {
     "",
     `# ${e.entryId ? `${e.entryId}: ` : ""}${e.name}`,
     "",
-    `**Status:** ${e.status}`,
+    `**Status:** ${e.status}${e.workflowStatus ? ` / ${e.workflowStatus}` : ""}`,
     `**Type:** ${e.canonicalKey ?? "untyped"}`
   ];
   if (e.data && typeof e.data === "object") {
@@ -371,7 +412,8 @@ async function handleGet(entryId) {
     name: String(e.name ?? ""),
     collection: String(e.canonicalKey ?? ""),
     status: String(e.status ?? ""),
-    entries: [{ entryId: e.entryId, name: e.name, status: e.status, collectionName: String(e.collectionName ?? e.canonicalKey ?? "\u2014") }],
+    ...e.workflowStatus ? { workflowStatus: String(e.workflowStatus) } : {},
+    entries: [{ entryId: e.entryId, name: e.name, status: e.status, ...e.workflowStatus ? { workflowStatus: e.workflowStatus } : {}, collectionName: String(e.collectionName ?? e.canonicalKey ?? "\u2014") }],
     ...e.data && typeof e.data === "object" ? { data: e.data } : {},
     ...Array.isArray(e.relations) && e.relations.length > 0 ? {
       relations: e.relations.map((r) => ({
@@ -404,7 +446,7 @@ async function handleBatch(entryIds) {
     const entry = r.entry;
     lines.push(`## ${entry.entryId ? `${entry.entryId}: ` : ""}${entry.name}`);
     lines.push("");
-    lines.push(`**Status:** ${entry.status}`);
+    lines.push(`**Status:** ${entry.status}${entry.workflowStatus ? ` / ${entry.workflowStatus}` : ""}`);
     lines.push(`**Type:** ${entry.canonicalKey ?? "untyped"}`);
     if (entry.data && typeof entry.data === "object") {
       lines.push("");
@@ -444,6 +486,7 @@ async function handleBatch(entryIds) {
       name: String(entry.name ?? ""),
       collection: String(entry.canonicalKey ?? ""),
       status: String(entry.status ?? ""),
+      ...entry.workflowStatus ? { workflowStatus: String(entry.workflowStatus) } : {},
       ...entry.data && typeof entry.data === "object" ? { data: entry.data } : {}
     };
   });
@@ -471,8 +514,9 @@ async function handleList(collection, status, tag, label) {
   }
   const formatted = entries.map((e) => {
     const id = e.entryId ? `**${e.entryId}:** ` : "";
+    const statusDisplay = e.workflowStatus ? `${e.status} / ${e.workflowStatus}` : e.status;
     const dataPreview = e.data ? Object.entries(e.data).slice(0, 4).map(([k, v]) => `  ${k}: ${typeof v === "string" ? v.substring(0, 120) : JSON.stringify(v)}`).join("\n") : "";
-    return `- ${id}${e.name} \`${e.status}\`${dataPreview ? `
+    return `- ${id}${e.name} \`${statusDisplay}\`${dataPreview ? `
 ${dataPreview}` : ""}`;
   }).join("\n\n");
   const scope = collection ? ` in \`${collection}\`` : "";
@@ -480,7 +524,8 @@ ${dataPreview}` : ""}`;
     entryId: String(e.entryId ?? ""),
     name: String(e.name ?? ""),
     collection: String(e.canonicalKey ?? collection ?? ""),
-    status: String(e.status ?? "")
+    status: String(e.status ?? ""),
+    ...e.workflowStatus ? { workflowStatus: e.workflowStatus } : {}
   }));
   return {
     content: [{ type: "text", text: `## List Result
@@ -523,13 +568,14 @@ async function handleSearch(server, query, collection, status) {
   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 statusDisplay = e.workflowStatus ? `${e.status} / ${e.workflowStatus}` : e.status;
     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}`;
+    return `- ${id}${e.name} \`${statusDisplay}\`${colTag}${typeTag}${preview}`;
   }).join("\n");
   const header = `## Search Result
 
@@ -542,6 +588,7 @@ async function handleSearch(server, query, collection, status) {
     name: String(e.name ?? ""),
     collection: collMap.get(e.collectionId ?? "")?.slug ?? "unknown",
     status: String(e.status ?? ""),
+    ...e.workflowStatus ? { workflowStatus: e.workflowStatus } : {},
     ...e.score != null ? { score: e.score } : {}
   }));
   const entriesForView = structuredResults.map((e) => ({
@@ -991,11 +1038,14 @@ function annotateStaleNames(text) {
 var CONTEXT_ACTIONS = ["gather", "build"];
 var contextSchema = z5.object({
   action: z5.enum(CONTEXT_ACTIONS).describe(
-    "'gather': assemble knowledge context (entry graph, task auto-load, or graph mode). 'build': structured build spec for an entry."
+    "'gather': assemble knowledge context (entry graph, task auto-load, journey mode, or graph mode). 'build': structured build spec for an entry."
   ),
   entryId: z5.string().optional().describe("Entry ID for graph traversal or build, e.g. 'FEAT-001', 'GT-019'"),
+  mapEntryId: z5.string().optional().describe(
+    "Journey map entry ID for journey-aware context (gather only). Returns context organised by journey stage. Takes precedence over entryId when both are supplied. Example: 'MAP-1'."
+  ),
   task: z5.string().optional().describe("Natural-language task description for auto-loading relevant context (gather only)"),
-  mode: z5.enum(["search", "graph"]).default("search").optional().describe("For gather: 'search' (default) or 'graph' (enhanced with provenance paths)"),
+  mode: z5.enum(["search", "graph"]).default("search").optional().describe("For gather: 'search' (default) or 'graph' (enhanced with provenance paths). Ignored when mapEntryId is provided."),
   maxHops: z5.number().min(1).max(3).default(2).describe("Relation traversal depth (1=direct only, 2=default, 3=wide net)"),
   maxResults: z5.number().min(1).max(25).default(10).optional().describe("Max entries to return in gather task mode (default 10)")
 });
@@ -1015,9 +1065,12 @@ function registerContextTools(server) {
         const issues = parsed.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ");
         return { content: [{ type: "text", text: `Invalid arguments: ${issues}` }] };
       }
-      const { action, entryId, task, mode, maxHops, maxResults } = parsed.data;
+      const { action, entryId, mapEntryId, task, mode, maxHops, maxResults } = parsed.data;
       return runWithToolContext({ tool: "context", action }, async () => {
         if (action === "gather") {
+          if (mapEntryId) {
+            return handleJourneyGather(server, mapEntryId, maxHops ?? 2, maxResults ?? 20);
+          }
           return handleGather(server, entryId, task, mode ?? "search", maxHops ?? 2, maxResults ?? 10);
         }
         if (action === "build") {
@@ -1233,6 +1286,80 @@ Use \`graph action=suggest\` to discover potential connections, or \`relations a
     structuredContent: { nodes, edges }
   };
 }
+async function handleJourneyGather(server, mapEntryId, maxHops, maxResults) {
+  await server.sendLoggingMessage({
+    level: "info",
+    data: `Loading journey context for map ${mapEntryId}...`,
+    logger: "product-brain"
+  });
+  const result = await mcpQuery("chain.journeyAwareGatherContext", {
+    mapEntryId,
+    maxHops,
+    maxResults
+  });
+  if (!result) {
+    return { content: [{ type: "text", text: `Journey map \`${mapEntryId}\` not found or has no slot data. Verify the map entry ID.` }] };
+  }
+  if (result.stages.length === 0 || result.seedCount === 0) {
+    return {
+      content: [{
+        type: "text",
+        text: `# Journey Context: ${result.map.name}
+
+_No ingredients found in this journey map._
+
+Add journey steps via MCP: \`map-slot action=add mapEntryId="${mapEntryId}" slotId="..." ingredientEntryId="..."\``
+      }]
+    };
+  }
+  const lines = [
+    `# Journey Context: ${result.map.name}`,
+    `**Template:** ${result.map.templateName}  |  **Map ID:** ${result.map.entryId}`,
+    `**Steps scanned:** ${result.seedCount}${result.truncated ? ` (capped at 10 \u2014 ${result.stages.flatMap((s) => s.ingredients).length} total ingredients)` : ""}`,
+    `**Related knowledge:** ${result.totalFound} entries`,
+    "",
+    "## Journey Stages"
+  ];
+  for (const stage of result.stages) {
+    const ingredientList = stage.ingredients.length === 0 ? "_empty_" : stage.ingredients.map((i) => `${i.entryId}: ${i.name}`).join(", ");
+    lines.push(`- **${stage.label}**: ${ingredientList}`);
+  }
+  if (result.context.length > 0) {
+    lines.push("");
+    lines.push("## Governance & Intelligence");
+    lines.push(`_Entries from the knowledge graph connected to journey steps:_`);
+    lines.push("");
+    const byCollection = /* @__PURE__ */ new Map();
+    for (const entry of result.context) {
+      const key = entry.collectionName;
+      if (!byCollection.has(key)) byCollection.set(key, []);
+      byCollection.get(key).push(entry);
+    }
+    for (const [collName, entries] of byCollection) {
+      lines.push(`### ${collName} (${entries.length})`);
+      for (const e of entries) {
+        const arrow = e.relationDirection === "outgoing" ? "\u2192" : "\u2190";
+        const id = e.entryId ? `**${e.entryId}:** ` : "";
+        const scoreLabel = typeof e.score === "number" ? `  ${e.score}` : "";
+        lines.push(`- ${arrow} ${id}${e.name}${scoreLabel}`);
+      }
+      lines.push("");
+    }
+  }
+  lines.push(`_Use \`entries action=get\` for full details. Link governance to steps: \`relations action=create\`._`);
+  return {
+    content: [{ type: "text", text: lines.join("\n") }],
+    structuredContent: {
+      map: result.map,
+      stages: result.stages,
+      context: result.context.map((e) => ({
+        entryId: e.entryId ?? "",
+        name: e.name,
+        collectionName: e.collectionName
+      }))
+    }
+  };
+}
 async function handleBuild(server, entryId, maxHops) {
   requireActiveSession();
   await server.sendLoggingMessage({
@@ -1569,7 +1696,7 @@ function registerLabelTools(server) {
 }
 
 // src/tools/health.ts
-import { z as z19 } from "zod";
+import { z as z20 } from "zod";
 
 // src/tools/session.ts
 import { z as z9 } from "zod";
@@ -2991,17 +3118,11 @@ function scoreElements(ctx) {
   } else {
     missing.push("Identify solution elements \u2014 breadboard-level pieces, each independently describable.");
   }
-  if (text.length > 20) {
-    const hasNoImpl = !/\b(implement|code|function|class|import|export|module)\b/i.test(text) || /breadboard|concept|capability|value/i.test(text);
-    if (hasNoImpl) {
-      satisfied.push("Abstraction level appropriate");
-      score += 2;
-    } else {
-      missing.push("Elements should be at breadboard level \u2014 capabilities, not implementation details.");
-    }
-  }
   const totalElements = Math.max(ctx.elementCount, textDescribed);
-  if (totalElements >= 2) {
+  if (totalElements >= 3) {
+    satisfied.push("Multiple independently describable pieces");
+    score += 3;
+  } else if (totalElements >= 2) {
     satisfied.push("Multiple independently describable pieces");
     score += 2;
   }
@@ -3099,9 +3220,8 @@ function scoreBoundaries(ctx) {
   const missing = [];
   const satisfied = [];
   let score = 0;
-  const noGoSignals = countMatches(text, NOGO_SIGNALS);
-  const wontStatements = (text.match(/\bwon'?t\b|\bwill not\b/gi) ?? []).length;
-  const totalNoGos = Math.max(ctx.noGoCount, noGoSignals, wontStatements);
+  const textNoGos = Math.max(countMatches(text, NOGO_SIGNALS), (text.match(/\bwon'?t\b|\bwill not\b/gi) ?? []).length);
+  const totalNoGos = Math.min(ctx.noGoCount + textNoGos, 10);
   if (totalNoGos >= 3) {
     satisfied.push(`${totalNoGos} explicit no-gos declared`);
     score += 5;
@@ -3181,8 +3301,8 @@ function suggestCaptures(ctx, activeDimension) {
   if (text.length < 30) return suggestions;
   if (activeDimension === "problem_clarity" || activeDimension === "appetite") {
     if (countMatches(text, WORKAROUND_SIGNALS) > 0 && ctx.riskCount === 0) {
-      const match = text.match(/(?:workaround|currently|today|right now)[^.]*\./i);
-      if (match) {
+      const match = text.match(/(?:workaround|currently|today|right now)[^.]{0,120}\./i);
+      if (match && isBalanced(match[0])) {
         suggestions.push({
           type: "tension",
           name: extractPhrase(match[0], 60),
@@ -3195,7 +3315,7 @@ function suggestCaptures(ctx, activeDimension) {
   if (activeDimension === "elements") {
     if (ctx.elementCount === 0 && /(?:service|component|module|layer|store|engine|kernel)/i.test(text)) {
       const match = text.match(/(?:a |the )?(\w[\w\s]{2,30}(?:service|component|module|layer|store|engine|kernel))/i);
-      if (match) {
+      if (match && isBalanced(match[1])) {
         suggestions.push({
           type: "element",
           name: capitalize(match[1].trim()),
@@ -3207,8 +3327,8 @@ function suggestCaptures(ctx, activeDimension) {
   }
   if (activeDimension === "risks") {
     if (ctx.riskCount === 0 && countMatches(text, RISK_SIGNALS) >= 2) {
-      const match = text.match(/(?:risk|rabbit hole|unknown|might|could fail)[^.]*\./i);
-      if (match) {
+      const match = text.match(/(?:risk|rabbit hole|unknown|might|could fail)[^.]{0,120}\./i);
+      if (match && isBalanced(match[0])) {
         suggestions.push({
           type: "risk",
           name: extractPhrase(match[0], 60),
@@ -3219,8 +3339,8 @@ function suggestCaptures(ctx, activeDimension) {
     }
   }
   if (/(?:we(?:'ll| will) (?:use|go with|pick|choose)|decided to|decision:|instead of)/i.test(text)) {
-    const match = text.match(/(?:we(?:'ll| will) (?:use|go with|pick|choose)|decided to|decision:)[^.]*\./i);
-    if (match) {
+    const match = text.match(/(?:we(?:'ll| will) (?:use|go with|pick|choose)|decided to|decision:)[^.]{0,120}\./i);
+    if (match && isBalanced(match[0])) {
       suggestions.push({
         type: "decision",
         name: extractPhrase(match[0], 60),
@@ -3414,7 +3534,8 @@ function registerFacilitateTools(server) {
   );
 }
 function buildStudioUrl(workspaceSlug, entryId) {
-  return `https://productbrain.app/${workspaceSlug}/studio/entries/${entryId}`;
+  const appUrl = process.env.PRODUCTBRAIN_APP_URL ?? "https://productbrain.io";
+  return `${appUrl}/${workspaceSlug}/studio/entries/${entryId}`;
 }
 function buildDirective(scorecard, phase, betEntryId, captureReady, activeDimension, nextDimension) {
   const b = betEntryId;
@@ -4538,7 +4659,7 @@ function registerVerifyTools(server) {
 }
 
 // src/tools/start.ts
-import { z as z14 } from "zod";
+import { z as z15 } from "zod";
 
 // src/presets/collections.ts
 var GOVERNANCE_CORE = [
@@ -4675,13 +4796,12 @@ async function queryPlannedWork() {
       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 });
-        }
+        result.uncommittedDrafts.push({ name: entry.name, collection });
       }
-      if (entry.status === "in-progress" || entry.status === "in_progress") {
+      if (collection === "tensions" && entry.workflowStatus === "open") {
+        result.openTensions.push({ name: entry.name, entryId: entry.entryId ?? entry._id });
+      }
+      if (entry.workflowStatus === "in-progress") {
         result.inProgressEntries.push({
           name: entry.name,
           collection,
@@ -4878,9 +4998,120 @@ function buildOperatingProtocol(governanceOrStandards, task) {
   return lines;
 }
 
+// src/tools/start-interview.ts
+import { z as z14 } from "zod";
+var interviewExtractionSchema = z14.object({
+  vision: z14.string().min(10).describe("What they're building \u2014 concise product purpose statement"),
+  audience: z14.string().optional().describe("Who it's for \u2014 primary user or customer segment"),
+  techStack: z14.array(z14.string()).optional().describe("Key technologies, frameworks, or platforms (e.g. ['SvelteKit', 'Convex', 'PostgreSQL'])"),
+  keyTerms: z14.array(z14.string()).optional().describe("Domain-specific terms that belong in the glossary"),
+  keyDecisions: z14.array(z14.string()).optional().describe("Recent significant decisions made (each as a concise statement)"),
+  tensions: z14.array(z14.string()).optional().describe("Pain points or friction the product is solving")
+});
+function extractionToBatchEntries(extracted) {
+  const entries = [];
+  if (extracted.vision) {
+    entries.push({
+      collection: "strategy",
+      name: "Product Vision",
+      description: extracted.vision
+    });
+  }
+  if (extracted.audience) {
+    const audienceName = extracted.audience.split(/\s+/).slice(0, 6).join(" ");
+    entries.push({
+      collection: "audiences",
+      name: audienceName,
+      description: extracted.audience
+    });
+  }
+  if (extracted.techStack?.length) {
+    entries.push({
+      collection: "architecture",
+      name: "Tech Stack",
+      description: `Technology choices: ${extracted.techStack.join(", ")}`
+    });
+    for (const tech of extracted.techStack.slice(0, 3)) {
+      entries.push({ collection: "glossary", name: tech, description: `${tech} \u2014 part of the tech stack` });
+    }
+  }
+  if (extracted.keyTerms?.length) {
+    for (const term of extracted.keyTerms) {
+      const alreadyAdded = entries.some(
+        (e) => e.collection === "glossary" && e.name.toLowerCase() === term.toLowerCase()
+      );
+      if (!alreadyAdded) {
+        entries.push({ collection: "glossary", name: term, description: `Core domain term: ${term}` });
+      }
+    }
+  }
+  if (extracted.keyDecisions?.length) {
+    for (const decision of extracted.keyDecisions) {
+      entries.push({
+        collection: "decisions",
+        name: decision.slice(0, 80),
+        description: decision
+      });
+    }
+  }
+  if (extracted.tensions?.length) {
+    for (const tension of extracted.tensions) {
+      entries.push({
+        collection: "tensions",
+        name: tension.slice(0, 80),
+        description: tension
+      });
+    }
+  }
+  return entries;
+}
+function getInterviewInstructions(workspaceName) {
+  return {
+    systemPrompt: `You are activating the **${workspaceName}** Product Brain. Ask 1\u20132 focused questions, then extract structured knowledge and feed it to batch-capture. Everything lands as a draft \u2014 the user confirms before anything is committed.`,
+    question1: `**Q1 \u2014 What are you building and for whom?** Describe your product in 1\u20132 sentences and who it's for. (This becomes your Product Vision and primary Audience.)`,
+    question2: `**Q2 (optional) \u2014 What's your tech stack or key domain terms?** Name a few core technologies or terms your team uses. (These become Architecture + Glossary entries.)`,
+    extractionGuidance: `After the user answers, extract:
+- vision: the core product purpose (required)
+- audience: who it's for (optional)
+- techStack: technologies mentioned (optional, array)
+- keyTerms: domain terms (optional, array)
+- keyDecisions: any decisions stated (optional, array)
+- tensions: any pain points stated (optional, array)
+
+Map to batch-capture entries:
+- vision \u2192 strategy ("Product Vision")
+- audience \u2192 audiences (1 entry)
+- techStack \u2192 architecture ("Tech Stack") + top 3 terms \u2192 glossary
+- keyTerms \u2192 glossary (1 per term)
+- keyDecisions \u2192 decisions (1 per decision)
+- tensions \u2192 tensions (1 per tension)`,
+    captureInstructions: `Call batch-capture with the extracted entries. Keep descriptions concise (1\u20132 sentences each). Prefer 8 good entries over 15 mediocre ones \u2014 quality over volume. If batch-capture returns failedEntries, tell the user and retry those individually.`,
+    qualityNote: `After capturing, call graph action=suggest on 2\u20133 key entries to build the graph. Present the drafts grouped by collection. Ask: "Commit all, or review first?" Only call commit-entry when the user confirms.`,
+    scanOffer: `After the interview capture, offer the Project Scan: "I can also scan your project files (README.md, package.json, .cursorrules) to extract more knowledge automatically. Want me to? It takes about 2 minutes and stays as drafts."`
+  };
+}
+function buildInterviewResponse(workspaceName) {
+  const instructions = getInterviewInstructions(workspaceName);
+  return [
+    "## Let's activate your workspace",
+    "",
+    instructions.systemPrompt,
+    "",
+    "I'll ask you 1\u20132 questions. Your answers become the first entries in your knowledge graph \u2014 all as drafts until you confirm.",
+    "",
+    `**${instructions.question1}**`,
+    "",
+    "_Take your time \u2014 a sentence or two is enough. I'll extract the structure from your answer._",
+    "",
+    `> ${instructions.scanOffer}`,
+    "",
+    '_Everything stays as a draft until you say "commit" or "looks good"._'
+  ].join("\n");
+}
+
 // src/tools/start.ts
-var startSchema = z14.object({
-  preset: z14.string().optional().describe(
+var startSchema = z15.object({
+  preset: z15.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."
   )
 });
@@ -5002,15 +5233,9 @@ Available presets: ${listPresets().map((p) => `\`${p.id}\``).join(", ")}`;
   }
   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.",
+    buildInterviewResponse(wsCtx.workspaceName),
     "",
-    `_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: `collections action=create`, `collections action=update`, or `collections action=list`.",
+    "_You can also customize your structure anytime: `collections action=create`, `collections action=update`, or `collections action=list`._",
     "",
     "---",
     "Orientation complete. Write tools are available."
@@ -5026,14 +5251,7 @@ 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.`;
+    const cta = gap.capabilityGuidance ?? gap.guidance ?? `Tell me about your ${gap.label.toLowerCase()} and I'll capture it.`;
     return { action: gap.label, cta };
   }
   if (openTensions.length > 0) {
@@ -5059,7 +5277,7 @@ async function buildOrientResponse(wsCtx, agentSessionId, errors) {
   let openTensions = [];
   try {
     const tensions = await mcpQuery("chain.listEntries", { collectionSlug: "tensions" });
-    openTensions = (tensions ?? []).filter((e) => e.status === "draft");
+    openTensions = (tensions ?? []).filter((e) => e.workflowStatus === "open");
   } catch {
   }
   let readiness = null;
@@ -5069,17 +5287,19 @@ async function buildOrientResponse(wsCtx, agentSessionId, errors) {
     errors.push(`Readiness: ${e.message}`);
   }
   const lines = [];
-  const isLowReadiness = readiness && readiness.score < 50;
-  const isHighReadiness = readiness && readiness.score >= 50;
+  const isLowReadiness = readiness !== null && readiness.score < 50;
+  const isHighReadiness = readiness !== null && readiness.score >= 50;
+  const stage = readiness?.stage ?? null;
   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.`);
+    const stageNote = stage ? ` and is still at the **${stage}** stage` : "";
+    lines.push(`Your workspace has been around for ${ageDays} days${stageNote}.`);
     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.`);
+    if (stage) lines.push(`**Brain stage: ${stage}.** Let's get your workspace active.`);
     lines.push("");
   }
   if (isLowReadiness) {
@@ -5103,7 +5323,7 @@ async function buildOrientResponse(wsCtx, agentSessionId, errors) {
     lines.push("");
   } else if (isHighReadiness) {
     if (readiness) {
-      lines.push(`Readiness: ${readiness.score}% (${readiness.passedChecks}/${readiness.totalChecks}).`);
+      lines.push(`**Brain stage: ${stage}.**`);
     }
     let wsPrinciples = [];
     let wsStandards = [];
@@ -5118,7 +5338,7 @@ async function buildOrientResponse(wsCtx, agentSessionId, errors) {
       const govEntries = [];
       for (const slug of govSlugs) {
         const entries = await mcpQuery("chain.listEntries", { collectionSlug: slug });
-        const active = (entries ?? []).filter((e) => e.status === "active" || e.status === "verified");
+        const active = (entries ?? []).filter((e) => e.status === "active");
         if (active.length > 0) {
           govEntries.push({ slug, entries: active });
           if (slug === "principles") wsPrinciples = active;
@@ -5196,6 +5416,34 @@ async function buildOrientResponse(wsCtx, agentSessionId, errors) {
         lines.push(...formatRecoveryBlock(recoveryBlock));
       }
     }
+    try {
+      const allEntries = await mcpQuery("chain.listEntries", {});
+      const committed = (allEntries ?? []).filter(
+        (e) => e.status === "active"
+      );
+      const committedCollections = new Set(committed.map((e) => e.collectionId ?? e.collection));
+      if (committed.length >= 10 && committedCollections.size >= 3) {
+        lines.push("");
+        lines.push("## Your workspace is activated");
+        lines.push(
+          `**${committed.length} committed entries** across **${committedCollections.size} collections** \u2014 your knowledge graph is alive.`
+        );
+        lines.push("");
+        lines.push(
+          `**Try it:** Ask me anything about your product \u2014 architecture, decisions, tensions \u2014 and I'll pull context from the graph.`
+        );
+        lines.push("");
+        if (wsCtx.workspaceSlug) {
+          lines.push(`**View in Studio:** \`/w/${wsCtx.workspaceSlug}/studio\``);
+          lines.push("");
+        }
+        if (committed.length >= 10 && committedCollections.size >= 3) {
+          lines.push(`_Tip: Connect entries with \`graph action=suggest\` to unlock deeper context._`);
+          lines.push("");
+        }
+      }
+    } catch {
+    }
     lines.push("What would you like to work on?");
     lines.push("");
   }
@@ -5224,9 +5472,9 @@ async function buildOrientResponse(wsCtx, agentSessionId, errors) {
 }
 
 // src/tools/usage.ts
-import { z as z15 } from "zod";
-var usageSummarySchema = z15.object({
-  periodDays: z15.number().min(1).max(90).optional().describe("Number of days to look back (default 30, max 90)")
+import { z as z16 } from "zod";
+var usageSummarySchema = z16.object({
+  periodDays: z16.number().min(1).max(90).optional().describe("Number of days to look back (default 30, max 90)")
 });
 function registerUsageTools(server) {
   server.registerTool(
@@ -5289,43 +5537,43 @@ function registerUsageTools(server) {
 }
 
 // src/tools/gitchain.ts
-import { z as z16 } from "zod";
-var chainSchema = z16.object({
-  action: z16.enum(["create", "get", "list", "edit"]).describe("Action: create a process, get process details, list all processes, or edit a process link"),
-  chainEntryId: z16.string().optional().describe("Chain entry ID (required for get/edit)"),
-  title: z16.string().optional().describe("Process title (required for create)"),
-  chainTypeId: z16.string().optional().default("strategy-coherence").describe("Process template slug for create: 'strategy-coherence', 'idm-proposal', or any custom template slug"),
-  description: z16.string().optional().describe("Description (for create)"),
-  linkId: z16.string().optional().describe("Link to edit (for edit action): problem, insight, choice, action, outcome"),
-  content: z16.string().optional().describe("New content for the link (for edit action)"),
-  status: z16.string().optional().describe("Filter by status for list: 'draft' or 'active'"),
-  author: z16.string().optional().describe("Who is performing the action. Defaults to 'mcp'.")
+import { z as z17 } from "zod";
+var chainSchema = z17.object({
+  action: z17.enum(["create", "get", "list", "edit"]).describe("Action: create a process, get process details, list all processes, or edit a process link"),
+  chainEntryId: z17.string().optional().describe("Chain entry ID (required for get/edit)"),
+  title: z17.string().optional().describe("Process title (required for create)"),
+  chainTypeId: z17.string().optional().default("strategy-coherence").describe("Process template slug for create: 'strategy-coherence', 'idm-proposal', or any custom template slug"),
+  description: z17.string().optional().describe("Description (for create)"),
+  linkId: z17.string().optional().describe("Link to edit (for edit action): problem, insight, choice, action, outcome"),
+  content: z17.string().optional().describe("New content for the link (for edit action)"),
+  status: z17.string().optional().describe("Filter by status for list: 'draft' or 'active'"),
+  author: z17.string().optional().describe("Who is performing the action. Defaults to 'mcp'.")
 });
-var chainVersionSchema = z16.object({
-  action: z16.enum(["commit", "list", "diff", "revert", "history"]).describe("Action: commit a snapshot, list commits, diff two versions, revert to a version, or view history"),
-  chainEntryId: z16.string().describe("The chain's entry ID"),
-  commitMessage: z16.string().optional().describe("Commit message (required for commit). Convention: type(link): description"),
-  versionA: z16.number().optional().describe("Earlier version for diff"),
-  versionB: z16.number().optional().describe("Later version for diff"),
-  toVersion: z16.number().optional().describe("Version number to revert to"),
-  author: z16.string().optional().describe("Who is performing the action. Defaults to 'mcp'.")
+var chainVersionSchema = z17.object({
+  action: z17.enum(["commit", "list", "diff", "revert", "history"]).describe("Action: commit a snapshot, list commits, diff two versions, revert to a version, or view history"),
+  chainEntryId: z17.string().describe("The chain's entry ID"),
+  commitMessage: z17.string().optional().describe("Commit message (required for commit). Convention: type(link): description"),
+  versionA: z17.number().optional().describe("Earlier version for diff"),
+  versionB: z17.number().optional().describe("Later version for diff"),
+  toVersion: z17.number().optional().describe("Version number to revert to"),
+  author: z17.string().optional().describe("Who is performing the action. Defaults to 'mcp'.")
 });
-var chainBranchSchema = z16.object({
-  action: z16.enum(["create", "list", "merge", "conflicts"]).describe("Action: create a branch, list branches, merge a branch, or check for conflicts"),
-  chainEntryId: z16.string().describe("The chain's entry ID"),
-  branchName: z16.string().optional().describe("Branch name (required for merge/conflicts, optional for create)"),
-  strategy: z16.enum(["merge_commit", "squash"]).optional().describe("Merge strategy: 'merge_commit' (default) or 'squash'"),
-  author: z16.string().optional().describe("Who is performing the action. Defaults to 'mcp'.")
+var chainBranchSchema = z17.object({
+  action: z17.enum(["create", "list", "merge", "conflicts"]).describe("Action: create a branch, list branches, merge a branch, or check for conflicts"),
+  chainEntryId: z17.string().describe("The chain's entry ID"),
+  branchName: z17.string().optional().describe("Branch name (required for merge/conflicts, optional for create)"),
+  strategy: z17.enum(["merge_commit", "squash"]).optional().describe("Merge strategy: 'merge_commit' (default) or 'squash'"),
+  author: z17.string().optional().describe("Who is performing the action. Defaults to 'mcp'.")
 });
-var chainReviewSchema = z16.object({
-  action: z16.enum(["gate", "comment", "resolve-comment", "list-comments"]).describe("Action: run coherence gate, add a comment, resolve a comment, or list comments"),
-  chainEntryId: z16.string().describe("The chain's entry ID"),
-  commitMessage: z16.string().optional().describe("Commit message to lint (for gate action)"),
-  versionNumber: z16.number().optional().describe("Version to comment on or list comments for"),
-  linkId: z16.string().optional().describe("Link this comment targets (optional for comment)"),
-  body: z16.string().optional().describe("Comment text (required for comment action)"),
-  commentId: z16.string().optional().describe("Comment ID (required for resolve-comment)"),
-  author: z16.string().optional().describe("Who is performing the action. Defaults to 'mcp'.")
+var chainReviewSchema = z17.object({
+  action: z17.enum(["gate", "comment", "resolve-comment", "list-comments"]).describe("Action: run coherence gate, add a comment, resolve a comment, or list comments"),
+  chainEntryId: z17.string().describe("The chain's entry ID"),
+  commitMessage: z17.string().optional().describe("Commit message to lint (for gate action)"),
+  versionNumber: z17.number().optional().describe("Version to comment on or list comments for"),
+  linkId: z17.string().optional().describe("Link this comment targets (optional for comment)"),
+  body: z17.string().optional().describe("Comment text (required for comment action)"),
+  commentId: z17.string().optional().describe("Comment ID (required for resolve-comment)"),
+  author: z17.string().optional().describe("Who is performing the action. Defaults to 'mcp'.")
 });
 function linkSummary(links) {
   return Object.entries(links).map(([id, content]) => {
@@ -5708,38 +5956,38 @@ ${formatted}`
 }
 
 // src/tools/maps.ts
-import { z as z17 } from "zod";
-var createAudienceMapSetSchema = z17.object({
-  audienceEntryId: z17.string().describe("Entry ID of the audience (e.g. STR-fb7hje)")
+import { z as z18 } from "zod";
+var createAudienceMapSetSchema = z18.object({
+  audienceEntryId: z18.string().describe("Entry ID of the audience (e.g. STR-fb7hje)")
 });
-var mapSchema = z17.object({
-  action: z17.enum(["create", "get", "list"]).describe("Action: create a map, get map details, or list all maps"),
-  mapEntryId: z17.string().optional().describe("Map entry ID (for get)"),
-  title: z17.string().optional().describe("Map title (for create)"),
-  templateId: z17.string().optional().default("lean-canvas").describe("Template slug for create: 'lean-canvas' or any composed template"),
-  description: z17.string().optional().describe("Description (for create)"),
-  slotIds: z17.array(z17.string()).optional().describe("Slot IDs to initialize (for create; auto-populated from template if omitted)"),
-  status: z17.string().optional().describe("Filter by status for list")
+var mapSchema = z18.object({
+  action: z18.enum(["create", "get", "list"]).describe("Action: create a map, get map details, or list all maps"),
+  mapEntryId: z18.string().optional().describe("Map entry ID (for get)"),
+  title: z18.string().optional().describe("Map title (for create)"),
+  templateId: z18.string().optional().default("lean-canvas").describe("Template slug for create: 'lean-canvas' or any composed template"),
+  description: z18.string().optional().describe("Description (for create)"),
+  slotIds: z18.array(z18.string()).optional().describe("Slot IDs to initialize (for create; auto-populated from template if omitted)"),
+  status: z18.string().optional().describe("Filter by status for list")
 });
-var mapSlotSchema = z17.object({
-  action: z17.enum(["add", "remove", "replace", "list"]).describe("Action: add/remove/replace an ingredient in a slot, or list slot contents"),
-  mapEntryId: z17.string().describe("Map entry ID"),
-  slotId: z17.string().optional().describe("Slot ID (e.g. 'problem', 'customer-segments')"),
-  ingredientEntryId: z17.string().optional().describe("Ingredient entry ID to add/remove"),
-  newIngredientEntryId: z17.string().optional().describe("New ingredient entry ID (for replace)"),
-  label: z17.string().optional().describe("Display label override"),
-  author: z17.string().optional().describe("Who is performing the action")
+var mapSlotSchema = z18.object({
+  action: z18.enum(["add", "remove", "replace", "list"]).describe("Action: add/remove/replace an ingredient in a slot, or list slot contents"),
+  mapEntryId: z18.string().describe("Map entry ID"),
+  slotId: z18.string().optional().describe("Slot ID (e.g. 'problem', 'customer-segments')"),
+  ingredientEntryId: z18.string().optional().describe("Ingredient entry ID to add/remove"),
+  newIngredientEntryId: z18.string().optional().describe("New ingredient entry ID (for replace)"),
+  label: z18.string().optional().describe("Display label override"),
+  author: z18.string().optional().describe("Who is performing the action")
 });
-var mapVersionSchema = z17.object({
-  action: z17.enum(["commit", "list", "history"]).describe("Action: commit the map, list commits, or view commit history"),
-  mapEntryId: z17.string().describe("Map entry ID"),
-  commitMessage: z17.string().optional().describe("Commit message (for commit action)"),
-  author: z17.string().optional().describe("Who is committing")
+var mapVersionSchema = z18.object({
+  action: z18.enum(["commit", "list", "history"]).describe("Action: commit the map, list commits, or view commit history"),
+  mapEntryId: z18.string().describe("Map entry ID"),
+  commitMessage: z18.string().optional().describe("Commit message (for commit action)"),
+  author: z18.string().optional().describe("Who is committing")
 });
-var mapSuggestSchema = z17.object({
-  mapEntryId: z17.string().describe("Map entry ID to suggest ingredients for"),
-  slotId: z17.string().optional().describe("Specific slot to find ingredients for (or all empty slots)"),
-  query: z17.string().optional().describe("Optional search query to narrow ingredient suggestions")
+var mapSuggestSchema = z18.object({
+  mapEntryId: z18.string().describe("Map entry ID to suggest ingredients for"),
+  slotId: z18.string().optional().describe("Specific slot to find ingredients for (or all empty slots)"),
+  query: z18.string().optional().describe("Optional search query to narrow ingredient suggestions")
 });
 function slotSummary(slots) {
   return Object.entries(slots).map(([id, refs]) => {
@@ -6165,7 +6413,7 @@ Use \`map-slot action=add mapEntryId="${mapEntryId}" slotId="..." ingredientEntr
 // src/tools/architecture.ts
 import { existsSync as existsSync2, readFileSync as readFileSync2, readdirSync, statSync } from "fs";
 import { resolve as resolve2, relative, dirname, normalize } from "path";
-import { z as z18 } from "zod";
+import { z as z19 } from "zod";
 var COLLECTION_SLUG = "architecture";
 var COLLECTION_FIELDS = [
   { key: "archType", label: "Architecture Type", type: "select", required: true, options: ["template", "layer", "node", "flow"], searchable: true },
@@ -6322,14 +6570,14 @@ var SEED_FLOWS = [
   { entryId: "ARCH-flow-knowledge-trust", name: "Knowledge Trust Flow", order: 3, data: { archType: "flow", sourceNode: "ARCH-node-mcp", targetNode: "ARCH-node-glossary", description: "MCP verify tool checks entries against codebase \u2192 file existence, schema references validated \u2192 trust scores updated", color: "#22c55e" } },
   { entryId: "ARCH-flow-analytics", name: "Analytics Flow", order: 4, data: { archType: "flow", sourceNode: "ARCH-node-command-center", targetNode: "ARCH-node-posthog", description: "Feature views and actions tracked \u2192 workspace-scoped events \u2192 PostHog group analytics \u2192 Command Center metrics", color: "#ec4899" } }
 ];
-var architectureSchema = z18.object({
-  action: z18.enum(["show", "explore", "flow"]).describe("Action: show full map, explore a layer, or visualize a flow"),
-  template: z18.string().optional().describe("Template entry ID to filter by (for show)"),
-  layer: z18.string().optional().describe("Layer name or entry ID (for explore), e.g. 'Core' or 'ARCH-layer-core'"),
-  flow: z18.string().optional().describe("Flow name or entry ID (for flow), e.g. 'Smart Capture Flow'")
+var architectureSchema = z19.object({
+  action: z19.enum(["show", "explore", "flow"]).describe("Action: show full map, explore a layer, or visualize a flow"),
+  template: z19.string().optional().describe("Template entry ID to filter by (for show)"),
+  layer: z19.string().optional().describe("Layer name or entry ID (for explore), e.g. 'Core' or 'ARCH-layer-core'"),
+  flow: z19.string().optional().describe("Flow name or entry ID (for flow), e.g. 'Smart Capture Flow'")
 });
-var architectureAdminSchema = z18.object({
-  action: z18.enum(["seed", "check"]).describe("Action: seed default architecture data, or check dependency health")
+var architectureAdminSchema = z19.object({
+  action: z19.enum(["seed", "check"]).describe("Action: seed default architecture data, or check dependency health")
 });
 function registerArchitectureTools(server) {
   server.registerTool(
@@ -6925,15 +7173,32 @@ async function handleWhoami() {
     }
   };
 }
+var STAGE_LABELS = {
+  blank: "Blank",
+  seeded: "Seeded",
+  grounded: "Grounded",
+  connected: "Connected"
+};
+var STAGE_DESCRIPTIONS = {
+  blank: "No knowledge captured yet.",
+  seeded: "Early knowledge is in place \u2014 keep building.",
+  grounded: "Solid foundations \u2014 a few gaps remain.",
+  connected: "Well-connected knowledge graph \u2014 your Brain is useful."
+};
 async function handleWorkspaceStatus() {
   const result = await mcpQuery("chain.workspaceReadiness");
   const { score, totalChecks, passedChecks, checks, gaps, stats, governanceMode } = result;
+  const scoringVersion = result.scoringVersion ?? "v1";
+  const stage = result.stage ?? "seeded";
+  const stageLabel = STAGE_LABELS[stage] ?? stage;
+  const stageDescription = STAGE_DESCRIPTIONS[stage] ?? "";
   const scoreBar = "\u2588".repeat(Math.round(score / 10)) + "\u2591".repeat(10 - Math.round(score / 10));
   const lines = [
-    `# Workspace Readiness: ${score}%`,
-    `${scoreBar} ${passedChecks}/${totalChecks} requirements met`,
-    `
-**Governance:** ${governanceMode ?? "open"}${(governanceMode ?? "open") !== "open" ? " (commits require proposal)" : ""}`,
+    `# Brain Status: ${stageLabel}`,
+    `_${stageDescription}_`,
+    "",
+    `${scoreBar} ${stageLabel} \xB7 ${score}%`,
+    `**Governance:** ${governanceMode ?? "open"}${(governanceMode ?? "open") !== "open" ? " (commits require proposal)" : ""}`,
     "",
     "## Stats",
     `- **Entries:** ${stats.totalEntries} (${stats.activeCount} active, ${stats.draftCount} draft)`,
@@ -6943,28 +7208,35 @@ async function handleWorkspaceStatus() {
     ""
   ];
   if (gaps.length > 0) {
-    lines.push("## Gaps (action required)");
+    lines.push("## Gaps");
     for (const gap of gaps) {
-      lines.push(`- [ ] **${gap.label}** \u2014 ${gap.description}`);
-      lines.push(`  ${gap.current}/${gap.required} | _${gap.guidance}_`);
+      const action = gap.capabilityGuidance ?? gap.guidance;
+      lines.push(`- [ ] **${gap.label}**`);
+      lines.push(`  _${action}_`);
     }
     lines.push("");
   }
   const passed = checks.filter((c) => c.passed);
   if (passed.length > 0) {
-    lines.push("## Passed");
+    lines.push("## Passing checks");
     for (const check of passed) {
-      lines.push(`- [x] **${check.label}** (${check.current}/${check.required})`);
+      lines.push(`- [x] ${check.label} (${check.current}/${check.required})`);
     }
   }
   return {
     content: [{ type: "text", text: lines.join("\n") }],
     structuredContent: {
+      stage,
+      scoringVersion,
       readinessScore: score,
       activeEntries: stats.activeCount,
       totalRelations: stats.totalRelations,
       orphanedEntries: stats.orphanedCount,
-      gaps: gaps.map((g) => ({ label: g.label, guidance: g.guidance }))
+      gaps: gaps.map((g) => ({
+        id: g.id,
+        label: g.label,
+        guidance: g.capabilityGuidance ?? g.guidance
+      }))
     }
   };
 }
@@ -7004,45 +7276,48 @@ ${logLines.join("\n")}` }],
   };
 }
 var HEALTH_ACTIONS = ["check", "whoami", "status", "audit", "self-test"];
-var healthSchema = z19.object({
-  action: z19.enum(HEALTH_ACTIONS).describe(
+var healthSchema = z20.object({
+  action: z20.enum(HEALTH_ACTIONS).describe(
     "'check': connectivity and workspace stats. 'whoami': session identity. 'status': workspace readiness. 'audit': session audit log. 'self-test': validate all tool schemas."
   ),
-  limit: z19.number().min(1).max(50).default(20).optional().describe("For audit: how many recent calls to show (max 50)")
+  limit: z20.number().min(1).max(50).default(20).optional().describe("For audit: how many recent calls to show (max 50)")
 });
-var orientSchema = z19.object({
-  mode: z19.enum(["full", "brief"]).optional().default("full").describe("full = full context (default). brief = compact summary for mid-session re-orientation."),
-  task: z19.string().optional().describe("Natural-language task description for task-scoped context. When provided, orient returns scored, relevant entries for the task.")
+var orientSchema = z20.object({
+  mode: z20.enum(["full", "brief"]).optional().default("full").describe("full = full context (default). brief = compact summary for mid-session re-orientation."),
+  task: z20.string().optional().describe("Natural-language task description for task-scoped context. When provided, orient returns scored, relevant entries for the task.")
 });
-var healthCheckOutputSchema = z19.object({
-  healthy: z19.boolean(),
-  collections: z19.number(),
-  entries: z19.number(),
-  latencyMs: z19.number(),
-  workspace: z19.string()
+var healthCheckOutputSchema = z20.object({
+  healthy: z20.boolean(),
+  collections: z20.number(),
+  entries: z20.number(),
+  latencyMs: z20.number(),
+  workspace: z20.string()
 });
-var healthStatusOutputSchema = z19.object({
-  readinessScore: z19.number(),
-  activeEntries: z19.number(),
-  totalRelations: z19.number(),
-  orphanedEntries: z19.number(),
-  gaps: z19.array(z19.object({ label: z19.string(), guidance: z19.string() }))
+var healthStatusOutputSchema = z20.object({
+  // Optional with defaults — older backends that don't return these fields won't fail.
+  stage: z20.enum(["blank", "seeded", "grounded", "connected"]).optional().default("seeded"),
+  scoringVersion: z20.enum(["v1", "v2"]).optional().default("v1"),
+  readinessScore: z20.number(),
+  activeEntries: z20.number(),
+  totalRelations: z20.number(),
+  orphanedEntries: z20.number(),
+  gaps: z20.array(z20.object({ id: z20.string(), label: z20.string(), guidance: z20.string() }))
 });
-var healthAuditOutputSchema = z19.object({
-  totalCalls: z19.number(),
-  calls: z19.array(z19.object({
-    tool: z19.string(),
-    action: z19.string().optional(),
-    timestamp: z19.string(),
-    durationMs: z19.number().optional()
+var healthAuditOutputSchema = z20.object({
+  totalCalls: z20.number(),
+  calls: z20.array(z20.object({
+    tool: z20.string(),
+    action: z20.string().optional(),
+    timestamp: z20.string(),
+    durationMs: z20.number().optional()
   }))
 });
-var healthWhoamiOutputSchema = z19.object({
-  workspaceId: z19.string(),
-  workspaceName: z19.string(),
-  scope: z19.string(),
-  sessionId: z19.union([z19.string(), z19.null()]),
-  oriented: z19.boolean()
+var healthWhoamiOutputSchema = z20.object({
+  workspaceId: z20.string(),
+  workspaceName: z20.string(),
+  scope: z20.string(),
+  sessionId: z20.union([z20.string(), z20.null()]),
+  oriented: z20.boolean()
 });
 var ALL_TOOL_SCHEMAS = [
   { name: "entries", schema: entriesSchema },
@@ -7078,14 +7353,14 @@ var ALL_TOOL_SCHEMAS = [
   { name: "architecture-admin", schema: architectureAdminSchema },
   { name: "facilitate", schema: facilitateSchema }
 ];
-var selfTestOutputSchema = z19.object({
-  passed: z19.number(),
-  failed: z19.number(),
-  total: z19.number(),
-  results: z19.array(z19.object({
-    tool: z19.string(),
-    valid: z19.boolean(),
-    error: z19.string().optional()
+var selfTestOutputSchema = z20.object({
+  passed: z20.number(),
+  failed: z20.number(),
+  total: z20.number(),
+  results: z20.array(z20.object({
+    tool: z20.string(),
+    valid: z20.boolean(),
+    error: z20.string().optional()
   }))
 });
 function handleSelfTest() {
@@ -7203,7 +7478,7 @@ function registerHealthTools(server) {
       let openTensions = [];
       try {
         const tensions = await mcpQuery("chain.listEntries", { collectionSlug: "tensions" });
-        openTensions = (tensions ?? []).filter((e) => e.status === "draft");
+        openTensions = (tensions ?? []).filter((e) => e.workflowStatus === "open");
       } catch {
       }
       let readiness = null;
@@ -7223,7 +7498,8 @@ function registerHealthTools(server) {
       }
       lines.push("");
       if (mode === "brief") {
-        lines.push(`Readiness: ${readiness?.score ?? "?"}%`);
+        const briefStage = readiness?.stage ?? (readiness?.score != null ? readiness.score < 50 ? "seeded" : "grounded" : "unknown");
+        lines.push(`Brain stage: ${briefStage}`);
         if (orientEntries?.strategicContext) {
           const sc = orientEntries.strategicContext;
           if (sc.vision) lines.push(`Vision: ${sc.vision}`);
@@ -7283,30 +7559,24 @@ function registerHealthTools(server) {
         }
         return { content: [{ type: "text", text: lines.join("\n") }] };
       }
+      const orientStage = readiness?.stage ?? "seeded";
       if (isLowReadiness && wsCtx?.createdAt) {
         const ageDays = Math.floor((Date.now() - wsCtx.createdAt) / (1e3 * 60 * 60 * 24));
         if (ageDays >= 30) {
-          lines.push(`Your workspace has been around for ${ageDays} days but is only ${readiness.score}% ready.`);
+          lines.push(`Your workspace has been around for ${ageDays} days and is still at the **${orientStage}** stage.`);
           lines.push("Let's close the gaps \u2014 or if the current structure doesn't fit, we can reshape it.");
           lines.push("");
         }
       }
       if (isLowReadiness) {
-        lines.push(`Readiness: ${readiness.score}% (${readiness.passedChecks}/${readiness.totalChecks}).`);
+        lines.push(`**Brain stage: ${orientStage}.**`);
         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.`;
+          const cta = gap.capabilityGuidance ?? gap.guidance ?? `Tell me about your ${gap.label.toLowerCase()} and I'll capture it.`;
           lines.push("## Recommended next step");
-          lines.push(`**${gap.label}** (${gap.current}/${gap.required})`);
+          lines.push(`**${gap.label}**`);
           lines.push("");
           lines.push(cta);
           lines.push("");
@@ -7322,7 +7592,7 @@ function registerHealthTools(server) {
         lines.push("_Use `collections action=create` to add it, or ask me to propose collections for your domain._");
         lines.push("");
       } else if (readiness) {
-        lines.push(`Readiness: ${readiness.score}% (${readiness.passedChecks}/${readiness.totalChecks}).`);
+        lines.push(`**Brain stage: ${orientStage}.**`);
         lines.push("");
         if (orientEntries?.strategicContext) {
           const sc = orientEntries.strategicContext;
@@ -7929,12 +8199,12 @@ ${entry.labels.map((l) => `- ${l.name ?? l.slug}`).join("\n")}`);
 }
 
 // src/prompts/index.ts
-import { z as z20 } from "zod";
+import { z as z21 } 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: z20.string().describe("Business rule domain (e.g. 'Identity & Access', 'Governance & Decision-Making')") },
+    { domain: z21.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);
@@ -7987,7 +8257,7 @@ Provide a structured review with a compliance status for each rule (COMPLIANT /
   server.prompt(
     "name-check",
     "Check variable names, field names, or API names against the glossary for terminology alignment. Flags drift from canonical terms.",
-    { names: z20.string().describe("Comma-separated list of names to check (e.g. 'vendor_id, compliance_level, formulator_type')") },
+    { names: z21.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(
@@ -8023,7 +8293,7 @@ Format as a table: Name | Status | Canonical Form | Action Needed`
   server.prompt(
     "draft-decision-record",
     "Draft a structured decision record from a description of what was decided. Includes context from recent decisions and relevant rules.",
-    { context: z20.string().describe("Description of the decision (e.g. 'We decided to use MRSL v3.1 as the conformance baseline because...')") },
+    { context: z21.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);
@@ -8061,8 +8331,8 @@ After drafting, I can log it using the capture tool with collection "decisions".
     "draft-rule-from-context",
     "Draft a new business rule from an observation or discovery made while coding. Fetches existing rules for the domain to ensure consistency.",
     {
-      observation: z20.string().describe("What you observed or discovered (e.g. 'Suppliers can have multiple org types in Gateway')"),
-      domain: z20.string().describe("Which domain this rule belongs to (e.g. 'Governance & Decision-Making')")
+      observation: z21.string().describe("What you observed or discovered (e.g. 'Suppliers can have multiple org types in Gateway')"),
+      domain: z21.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" });
@@ -8103,10 +8373,10 @@ Make sure the rule is consistent with existing rules and doesn't contradict them
     "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: z20.string().describe(
+      workflow: z21.string().describe(
         "Workflow ID to run. Available: " + listWorkflows().map((w) => `'${w.id}' (${w.name})`).join(", ")
       ),
-      context: z20.string().optional().describe(
+      context: z21.string().optional().describe(
         "Optional context from the participant (e.g., 'retro on last sprint', 'shape the Chainwork API bet')"
       )
     },
@@ -8210,7 +8480,7 @@ Description field: ${wf.kbOutputTemplate.descriptionField}
     "shape-a-bet",
     "Launch a coached shaping session powered by the facilitate tool. Dynamically loads workspace context, governance constraints, and coaching rubrics. Use when the user wants to shape a bet, define a pitch, or scope work.",
     {
-      idea: z20.string().describe("Brief description of the idea or feature to shape (e.g. 'Improve the glossary editing flow')")
+      idea: z21.string().describe("Brief description of the idea or feature to shape (e.g. 'Improve the glossary editing flow')")
     },
     async ({ idea }) => {
       let strategicContext = "";
@@ -8248,7 +8518,7 @@ Description field: ${wf.kbOutputTemplate.descriptionField}
           "chain.listEntries",
           { collectionSlug: "tensions" }
         );
-        const open = (tensions ?? []).filter((t) => t.status === "draft" || t.status === "active");
+        const open = (tensions ?? []).filter((t) => t.workflowStatus === "open");
         if (open.length > 0) {
           tensionsContext = open.slice(0, 10).map((t) => `- \`${t.entryId ?? "?"}\` ${t.name}`).join("\n");
         }
@@ -8362,9 +8632,9 @@ Walk away mid-session and everything captured so far exists as drafts. \`facilit
     "capture-and-connect",
     "Guided workflow: capture a knowledge entry, discover graph connections, create relations, and prepare for commit. Encodes the capture \u2192 suggest \u2192 batch-create \u2192 commit choreography as a step-by-step guide.",
     {
-      collection: z20.string().describe("Collection slug (e.g. 'glossary', 'business-rules', 'decisions', 'tensions')"),
-      name: z20.string().describe("Entry name"),
-      description: z20.string().describe("Entry description")
+      collection: z21.string().describe("Collection slug (e.g. 'glossary', 'business-rules', 'decisions', 'tensions')"),
+      name: z21.string().describe("Entry name"),
+      description: z21.string().describe("Entry description")
     },
     async ({ collection, name, description }) => {
       const collections = await mcpQuery("chain.listCollections");
@@ -8418,7 +8688,7 @@ Only call \`commit-entry\` when the user explicitly confirms.
     "deep-dive",
     "Explore everything the Chain knows about a topic or entry. Assembles entry details, graph context, related business rules, and glossary terms into a comprehensive briefing.",
     {
-      topic: z20.string().describe("Entry ID (e.g. 'BR-001') or topic to explore (e.g. 'authentication')")
+      topic: z21.string().describe("Entry ID (e.g. 'BR-001') or topic to explore (e.g. 'authentication')")
     },
     async ({ topic }) => {
       const isEntryId = /^[A-Z]+-\d+$/i.test(topic) || /^[A-Z]+-[a-z0-9]+$/i.test(topic);
@@ -8501,7 +8771,7 @@ ${contextInstructions}`
     "pre-commit-check",
     "Run a readiness check before committing an entry to the Chain. Validates quality score, required relations, and business rule compliance.",
     {
-      entryId: z20.string().describe("Entry ID to check (e.g. 'GT-019', 'DEC-005')")
+      entryId: z21.string().describe("Entry ID to check (e.g. 'GT-019', 'DEC-005')")
     },
     async ({ entryId }) => {
       return {
@@ -8555,6 +8825,123 @@ If ready, ask the user to confirm. If not, suggest specific improvements.
       };
     }
   );
+  server.prompt(
+    "project-scan",
+    "Scan local project files to extract structured knowledge for Product Brain. The IDE agent reads README.md, package.json, .cursorrules, folder structure, and recent git history, then extracts vision, tech stack, key terms, and decisions into batch-capture entries. All entries land as drafts \u2014 the user reviews and commits.",
+    {
+      workspaceContext: z21.string().optional().describe("Optional context about the workspace preset and existing collections (paste from start/orient output)")
+    },
+    async ({ workspaceContext }) => {
+      let collectionsContext = "";
+      try {
+        const cols = await mcpQuery("chain.listCollections");
+        if (cols?.length) {
+          const colList = cols.map((c) => `- \`${c.slug}\`: ${c.name}`).join("\n");
+          collectionsContext = `
+## Available Collections
+${colList}
+`;
+        }
+      } catch {
+      }
+      const schemaFields = Object.entries(interviewExtractionSchema.shape).map(([key, field]) => `- \`${key}\`: ${field.description ?? ""}`).join("\n");
+      const exampleExtraction = {
+        vision: "A task management app for solo developers who work with AI coding assistants",
+        audience: "Solo developers using Cursor, Claude Code, or similar AI IDEs",
+        techStack: ["SvelteKit", "Convex", "TypeScript"],
+        keyTerms: ["Chain", "Capture", "Orientation"],
+        keyDecisions: ["Use Convex for real-time backend to avoid managing infrastructure"],
+        tensions: ["Activation requires skill \u2014 users need to know what to capture"]
+      };
+      const exampleEntries = extractionToBatchEntries(exampleExtraction);
+      const exampleOutput = JSON.stringify({ entries: exampleEntries.slice(0, 4) }, null, 2);
+      return {
+        messages: [{
+          role: "user",
+          content: {
+            type: "text",
+            text: `# Project Scan \u2014 Agent-Side Knowledge Extraction
+
+You are scanning the user's local project to extract structured knowledge for Product Brain.
+PB runs remotely \u2014 you do the file reading and extraction, then call \`batch-capture\`.
+
+` + (workspaceContext ? `## Workspace Context
+${workspaceContext}
+
+` : "") + collectionsContext + `## Step 1: Read Project Files
+
+Read these files in this order (skip gracefully if not present):
+1. \`README.md\` or \`readme.md\` \u2014 product description, purpose, setup
+2. \`package.json\` \u2014 name, description, dependencies (framework, database, auth)
+3. \`tsconfig.json\` or \`tsconfig.app.json\` \u2014 compilation target, paths
+4. Top-level folder structure (list directories only, max 2 levels deep)
+5. \`.cursorrules\` or \`CLAUDE.md\` or \`AGENTS.md\` \u2014 project conventions, constraints
+6. \`git log --oneline -20\` \u2014 recent commit messages for decisions/tensions
+
+**ICP stack only (V1):** README, package.json, tsconfig, folder structure, .cursorrules/CLAUDE.md, git log.
+Do not attempt to read Python, Rust, Go, or mobile-specific files in this pass.
+
+## Step 2: Extract Structured Data
+
+After reading, extract the following schema:
+
+\`\`\`
+${schemaFields}
+\`\`\`
+
+**Quality rules (RH2 mitigation):**
+- Prefer 8 good entries over 20 mediocre ones
+- Only include terms you have direct evidence for from the files
+- Skip fields you cannot confidently fill \u2014 empty arrays > hallucinated data
+- Keep descriptions concise: 1\u20132 sentences max
+
+## Step 3: Validate Before Capture
+
+Before calling batch-capture, check your extraction:
+- vision is present and at least 10 characters
+- each entry has a non-empty name and description
+- no duplicate names within the same collection
+- if techStack is present, at least one glossary entry per technology
+
+If validation fails for any entry, drop it rather than sending malformed data.
+
+## Step 4: Map to batch-capture
+
+Map your extracted data to entries using these rules:
+- \`vision\` \u2192 strategy collection, name: "Product Vision"
+- \`audience\` \u2192 audiences collection
+- \`techStack\` \u2192 architecture collection ("Tech Stack") + top 3 items \u2192 glossary
+- \`keyTerms\` \u2192 glossary collection (1 entry per term)
+- \`keyDecisions\` \u2192 decisions collection (1 entry per decision)
+- \`tensions\` \u2192 tensions collection (1 entry per tension)
+
+**Example output:**
+\`\`\`json
+${exampleOutput}
+\`\`\`
+
+## Step 5: Call batch-capture
+
+\`\`\`
+batch-capture entries=[...your mapped entries...]
+\`\`\`
+
+If \`failed > 0\` in the response, inspect \`failedEntries\` and retry those individually.
+
+## Step 6: Connect + Review
+
+After capture:
+1. Call \`graph action=suggest\` on 2\u20133 key entries (vision, architecture, a decision)
+2. Present entries grouped by collection
+3. Ask: "Commit all, or would you like to review first?"
+4. Only call \`commit-entry\` when the user confirms
+
+**Begin with Step 1 now.** Read the files, then report what you found before extracting.`
+          }
+        }]
+      };
+    }
+  );
 }
 
 // src/server.ts
@@ -8669,4 +9056,4 @@ export {
   SERVER_VERSION,
   createProductBrainServer
 };
-//# sourceMappingURL=chunk-7CD66MUS.js.map
+//# sourceMappingURL=chunk-XCKGFYDP.js.map