@productbrain/mcp 0.0.1-beta.7807 → 0.0.1-beta.7814

package/dist/{chunk-NOEYON3B.js → chunk-5HVA3T22.js}

@@ -400,6 +400,15 @@ function formatOwnerLine(owner, options = {}) {
   }
 }
 
+// src/lib/proseBody.ts
+function readEntryBody(data, proseKey) {
+  const body = data?.body;
+  if (typeof body === "string" && body.trim().length > 0) return body;
+  if (!data || !proseKey) return void 0;
+  const legacy = data[proseKey];
+  return typeof legacy === "string" ? legacy : void 0;
+}
+
 // src/tools/knowledge-helpers.ts
 var EPISTEMIC_COLLECTIONS = /* @__PURE__ */ new Set(["insights", "assumptions"]);
 function deriveEpistemicStatus(entry) {
@@ -481,8 +490,8 @@ function formatOwnerLine2(owner) {
 function extractPreview(data, maxLen) {
   if (!data || typeof data !== "object") return "";
   const d = data;
-  const raw = d.description ?? d.canonical ?? d.detail ?? d.rule ?? "";
-  if (typeof raw !== "string" || !raw) return "";
+  const raw = readEntryBody(d, "description") ?? readEntryBody(d, "canonical") ?? readEntryBody(d, "detail") ?? readEntryBody(d, "rule") ?? "";
+  if (!raw) return "";
   return raw.length > maxLen ? raw.substring(0, maxLen) + "..." : raw;
 }
 var TOOL_NAME_MIGRATIONS = /* @__PURE__ */ new Map([
@@ -2731,7 +2740,7 @@ async function runContradictionCheck(name, description, excludeEntryId, excludeD
       return true;
     }).slice(0, 5);
     for (const entry of allGov) {
-      const entryTokens = new Set(tokenizeText(`${entry.name} ${entry.data?.description ?? ""}`));
+      const entryTokens = new Set(tokenizeText(`${entry.name} ${readEntryBody(entry.data, "description") ?? ""}`));
       const matched = keyTerms.filter((t) => entryTokens.has(t));
       if (matched.length < 3) continue;
       let governsCount = 0;
@@ -2994,7 +3003,7 @@ async function handleCommitEntry({ entryId, preview, steeringOverrideReason, coh
   if (!entry) {
     return notFoundResult(entryId, `Entry '${entryId}' not found. Try search to find the right ID.`);
   }
-  const descField = entry.data?.description ?? entry.data?.why ?? entry.data?.rationale ?? entry.data?.canonical ?? "";
+  const descField = readEntryBody(entry.data, "description") ?? readEntryBody(entry.data, "why") ?? readEntryBody(entry.data, "rationale") ?? readEntryBody(entry.data, "canonical") ?? "";
   const preflight = await runConflictPreflight(
     entry.name,
     descField,
@@ -14251,6 +14260,42 @@ async function buildOrientationResourceText(kernelQuery2, agentSessionId) {
   return buildOrientationMarkdown(collections, standards, businessRules, principles, directionLines, ruleLines);
 }
 
+// src/resources/terminologyResource.ts
+async function buildTerminologyResourceText() {
+  const [glossaryResult, standardsResult] = await Promise.allSettled([
+    kernelQuery("chain.listEntries", { collectionSlug: "glossary" }),
+    kernelQuery("chain.listEntries", { collectionSlug: "standards" })
+  ]);
+  const lines = ["# Product Brain \u2014 Terminology"];
+  if (glossaryResult.status === "fulfilled") {
+    const glossary = glossaryResult.value ?? [];
+    if (glossary.length > 0) {
+      const terms = glossary.map((t) => `- **${t.name}** (${t.entryId ?? "\u2014"}) [${t.status}]: ${readEntryBody(t.data, "canonical") ?? readEntryBody(t.data, "description") ?? ""}`).join("\n");
+      lines.push(`## Glossary (${glossary.length} terms)
+
+${terms}`);
+    } else {
+      lines.push("## Glossary\n\nNo glossary terms yet. Use `capture` with collection `glossary` to add terms.");
+    }
+  } else {
+    lines.push("## Glossary\n\nCould not load glossary \u2014 use `entries action=list collection=glossary` to browse manually.");
+  }
+  if (standardsResult.status === "fulfilled") {
+    const standards = standardsResult.value ?? [];
+    if (standards.length > 0) {
+      const stds = standards.map((s) => `- **${s.name}** (${s.entryId ?? "\u2014"}) [${s.status}]: ${readEntryBody(s.data, "description") ?? ""}`).join("\n");
+      lines.push(`## Standards (${standards.length} entries)
+
+${stds}`);
+    } else {
+      lines.push("## Standards\n\nNo standards yet. Use `capture` with collection `standards` to add standards.");
+    }
+  } else {
+    lines.push("## Standards\n\nCould not load standards \u2014 use `entries action=list collection=standards` to browse manually.");
+  }
+  return lines.join("\n\n---\n\n");
+}
+
 // src/resources/index.ts
 var MODULE_DIR = dirname(fileURLToPath(import.meta.url));
 var UI_VIEW_BASE_CANDIDATES = [
@@ -14294,42 +14339,9 @@ function registerResources(server) {
   server.resource(
     "chain-terminology",
     "productbrain://terminology",
-    async (uri) => {
-      const [glossaryResult, standardsResult] = await Promise.allSettled([
-        kernelQuery("chain.listEntries", { collectionSlug: "glossary" }),
-        kernelQuery("chain.listEntries", { collectionSlug: "standards" })
-      ]);
-      const lines = ["# Product Brain \u2014 Terminology"];
-      if (glossaryResult.status === "fulfilled") {
-        const glossary = glossaryResult.value ?? [];
-        if (glossary.length > 0) {
-          const terms = glossary.map((t) => `- **${t.name}** (${t.entryId ?? "\u2014"}) [${t.status}]: ${t.data?.canonical ?? t.data?.description ?? ""}`).join("\n");
-          lines.push(`## Glossary (${glossary.length} terms)
-
-${terms}`);
-        } else {
-          lines.push("## Glossary\n\nNo glossary terms yet. Use `capture` with collection `glossary` to add terms.");
-        }
-      } else {
-        lines.push("## Glossary\n\nCould not load glossary \u2014 use `entries action=list collection=glossary` to browse manually.");
-      }
-      if (standardsResult.status === "fulfilled") {
-        const standards = standardsResult.value ?? [];
-        if (standards.length > 0) {
-          const stds = standards.map((s) => `- **${s.name}** (${s.entryId ?? "\u2014"}) [${s.status}]: ${s.data?.description ?? ""}`).join("\n");
-          lines.push(`## Standards (${standards.length} entries)
-
-${stds}`);
-        } else {
-          lines.push("## Standards\n\nNo standards yet. Use `capture` with collection `standards` to add standards.");
-        }
-      } else {
-        lines.push("## Standards\n\nCould not load standards \u2014 use `entries action=list collection=standards` to browse manually.");
-      }
-      return {
-        contents: [{ uri: uri.href, text: lines.join("\n\n---\n\n"), mimeType: "text/markdown" }]
-      };
-    }
+    async (uri) => ({
+      contents: [{ uri: uri.href, text: await buildTerminologyResourceText(), mimeType: "text/markdown" }]
+    })
   );
   server.resource(
     "chain-collections",
@@ -14610,43 +14622,38 @@ ${entry.labels.map((l) => `- ${l.name ?? l.slug}`).join("\n")}`);
 
 // src/prompts/index.ts
 import { z as z34 } from "zod/v3";
-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: z34.string().describe("Business rule domain (e.g. 'Identity & Access', 'Governance & Decision-Making')") },
-    async ({ domain }) => {
-      const entries = await kernelQuery("chain.listEntries", { collectionSlug: "business-rules" });
-      const rules = entries.filter((e) => e.data?.domain === domain);
-      if (rules.length === 0) {
-        return {
-          messages: [
-            {
-              role: "user",
-              content: {
-                type: "text",
-                text: `No business rules found for domain "${domain}". Use \`entries action=list collection=business-rules\` to see available domains.`
-              }
-            }
-          ]
-        };
-      }
-      const rulesText = rules.map(
-        (r) => `### ${r.entryId ?? ""}: ${r.name}
+async function buildReviewAgainstRulesPrompt(domain) {
+  const entries = await kernelQuery("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 \`entries action=list 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 ?? ""}
+Description: ${readEntryBody(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.
+  ).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?
@@ -14658,29 +14665,24 @@ 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: z34.string().describe("Comma-separated list of names to check (e.g. 'vendor_id, compliance_level, formulator_type')") },
-    async ({ names }) => {
-      const terms = await kernelQuery("chain.listEntries", { collectionSlug: "glossary" });
-      const glossaryContext = terms.map(
-        (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 ? `
+        }
+      }
+    ]
+  };
+}
+async function buildNameCheckPrompt(names) {
+  const terms = await kernelQuery("chain.listEntries", { collectionSlug: "glossary" });
+  const glossaryContext = terms.map(
+    (t) => `${t.name} (${t.entryId ?? ""}) [${t.status}]: ${readEntryBody(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:
+  ).join("\n");
+  return {
+    messages: [
+      {
+        role: "user",
+        content: {
+          type: "text",
+          text: `Check the following names against the glossary for terminology alignment:
 
 Names to check: ${names}
 
@@ -14694,11 +14696,23 @@ For each name:
 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`
-            }
-          }
-        ]
-      };
-    }
+        }
+      }
+    ]
+  };
+}
+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: z34.string().describe("Business rule domain (e.g. 'Identity & Access', 'Governance & Decision-Making')") },
+    async ({ domain }) => buildReviewAgainstRulesPrompt(domain)
+  );
+  server.prompt(
+    "name-check",
+    "Check variable names, field names, or API names against the glossary for terminology alignment. Flags drift from canonical terms.",
+    { names: z34.string().describe("Comma-separated list of names to check (e.g. 'vendor_id, compliance_level, formulator_type')") },
+    async ({ names }) => buildNameCheckPrompt(names)
   );
   server.prompt(
     "draft-decision-record",
@@ -14744,17 +14758,20 @@ After drafting, I can log it using the capture tool with collection "decisions".
       observation: z34.string().describe("What you observed or discovered (e.g. 'Suppliers can have multiple org types in Gateway')"),
       domain: z34.string().describe("Which domain this rule belongs to (e.g. 'Governance & Decision-Making')")
     },
-    async ({ observation, domain }) => {
-      const allRules = await kernelQuery("chain.listEntries", { collectionSlug: "business-rules" });
-      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.";
-      return {
-        messages: [
-          {
-            role: "user",
-            content: {
-              type: "text",
-              text: `Draft a business rule based on this observation:
+    async ({ observation, domain }) => buildDraftRuleFromContextPrompt(observation, domain)
+  );
+}
+async function buildDraftRuleFromContextPrompt(observation, domain) {
+  const allRules = await kernelQuery("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 ${readEntryBody(r.data, "description") ?? ""}`).join("\n") : "No existing rules for this domain.";
+  return {
+    messages: [
+      {
+        role: "user",
+        content: {
+          type: "text",
+          text: `Draft a business rule based on this observation:
 
 "${observation}"
 
@@ -14773,12 +14790,10 @@ Draft the rule with these fields (do not specify entryId \u2014 Convex assigns s
 7. **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".`
-            }
-          }
-        ]
-      };
-    }
-  );
+        }
+      }
+    ]
+  };
 }
 
 // src/server.ts
@@ -14901,4 +14916,4 @@ export {
   createProductBrainServer,
   initFeatureFlags
 };
-//# sourceMappingURL=chunk-NOEYON3B.js.map
+//# sourceMappingURL=chunk-5HVA3T22.js.map