@productbrain/mcp 0.0.1-beta.7984 → 0.0.1-beta.7996

package/dist/{chunk-3NICJHNZ.js → chunk-3VQ5VSBH.js}

@@ -39,7 +39,7 @@ import {
   trackQualityVerdict,
   trackSessionCaptureRate,
   trackZeroCaptureAuditFired
-} from "./chunk-SLQ5XKT5.js";
+} from "./chunk-N6HO6ETW.js";
 
 // src/server.ts
 import { McpServer as McpServer2 } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -1024,19 +1024,11 @@ async function captureVersionOrPreview(preview, params) {
   return preview ? buildVersionPreviewResult(params.groundingEntry, params.name) : runVersionCapture(params);
 }
 
-// src/lib/formatFieldGuidance.ts
-function formatFieldGuidance(fields) {
-  const guidedFields = fields.filter((f) => f.writingGuidance);
-  if (guidedFields.length === 0) return "";
-  const lines = ["## Writing Guidance"];
-  for (const field of guidedFields) {
-    const displayName2 = field.label || field.key;
-    lines.push(`- ${displayName2}: ${field.writingGuidance}`);
-    if (field.writingExamples && field.writingExamples.length > 0) {
-      lines.push(`  Examples: ${field.writingExamples.join(" | ")}`);
-    }
-  }
-  return lines.join("\n");
+// src/lib/bodyTemplate.ts
+function readBodyTemplateGuidance(bodyTemplate) {
+  if (!bodyTemplate || bodyTemplate.length === 0) return void 0;
+  return bodyTemplate.map((entry) => `## ${entry.heading}
+${entry.guidance}`).join("\n\n");
 }
 
 // src/lib/inferSourceDate.ts
@@ -2535,14 +2527,13 @@ Use \`entries action=get\` to inspect the existing entry, or \`entries action=up
       lines.push(`_Grounding: ${parts.join(", ")}. Review and link if relevant._`);
     }
   }
-  const fieldGuidanceSection = formatFieldGuidance(col.fields ?? []);
-  if (fieldGuidanceSection) {
+  const bodyGuidance = readBodyTemplateGuidance(col.bodyTemplate);
+  if (bodyGuidance) {
     lines.push("");
-    lines.push(fieldGuidanceSection);
-    const guidedFieldCount = (col.fields ?? []).filter((f) => f.writingGuidance).length;
+    lines.push(bodyGuidance);
     trackFieldGuidanceApplied(wsCtx.workspaceId, {
       collection: resolvedCollection,
-      guided_field_count: guidedFieldCount
+      guided_heading_count: col.bodyTemplate?.length ?? 0
     });
   }
   if (formativeHints.length > 0) {
@@ -2665,10 +2656,9 @@ Use \`entries action=get\` to inspect the existing entry, or \`entries action=up
     allFields: (col.fields ?? []).map((f) => ({
       key: f.key,
       required: f.required === true,
-      type: f.type,
-      ...f.helpText ? { helpText: f.helpText } : {}
+      type: f.type
     })),
-    ...col.captureExpectation ? { captureExpectation: col.captureExpectation } : {}
+    ...bodyGuidance ? { guidance: bodyGuidance } : {}
   };
   const totalMs = Date.now() - timingStart;
   const timing = {
@@ -6360,7 +6350,7 @@ var fieldSchema = z17.object({
   colorMap: z17.record(z17.string().max(50)).optional().describe("V2 value-to-semantic-color mapping, e.g. { critical: 'danger', low: 'success' }"),
   accentSource: z17.boolean().optional().describe("When true, this field's colorMap value drives the card-level accent styling"),
   iconMap: z17.record(z17.string(), z17.string().max(50)).optional().describe("Maps field values to icons (emoji/symbol), prepended to badge text"),
-  helpText: z17.string().max(2e3).optional().describe("Help text shown in editors and describe output"),
+  helpText: z17.string().max(2e3).optional().describe("Help text shown in admin field editors"),
   optionDescriptions: z17.record(z17.string().max(500)).optional().describe("Per-option guidance for select fields"),
   semanticRole: z17.enum(["problem", "appetite", "elements", "architecture", "done_when", "risks", "exclusions"]).optional().describe("Semantic role for schema-driven consumers \u2014 enables field-key-independent validation and rendering"),
   maxLength: z17.number().optional().describe("Maximum character length for field values. Three-tier resolution: explicit > displayHint > type fallback."),
@@ -6537,17 +6527,14 @@ async function handleDescribe(slug) {
     col.stratum ? `**Stratum:** ${col.stratum}` : null
   ].filter(Boolean).join(" \xB7 ");
   if (meta) sections.push(meta);
-  if (col.usageGuidance) {
-    sections.push(`
+  if (col.usageGuidance) sections.push(`
 ## When to Use
 
 ${col.usageGuidance}`);
-  } else if (col.purpose) {
-    sections.push(`
+  else if (col.purpose) sections.push(`
 ## Purpose
 
 ${col.purpose}`);
-  }
   if (col.validWorkflowStatuses && col.validWorkflowStatuses.length > 0) {
     sections.push(
       `
@@ -6563,12 +6550,14 @@ ${col.validWorkflowStatuses.map((s) => `- ${s}`).join("\n")}`
 
 ${col.statusList.map((s) => `- \`${s.label}\` \u2192 ${s.category}${s.archiveDefault ? " (archiveDefault)" : ""}`).join("\n")}`);
   }
+  const bodyGuidance = readBodyTemplateGuidance(col.bodyTemplate);
+  if (bodyGuidance) sections.push(`
+${bodyGuidance}`);
   if (col.fields.length > 0) {
     const fieldDocs = col.fields.map((f) => {
       const parts = [];
       const typeInfo = `${f.type}${f.required ? ", required" : ""}`;
       parts.push(`### \`${f.key}\` \u2014 ${f.label ?? f.key} (${typeInfo})`);
-      if (f.helpText) parts.push(f.helpText);
       if (f.options && f.options.length > 0) {
         const optLines = f.options.map((opt) => {
           const desc = f.optionDescriptions?.[opt];
@@ -6619,10 +6608,11 @@ ${refList}`);
           key: f.key,
           type: f.type,
           required: f.required,
-          helpText: f.helpText ?? null,
           options: f.options ?? null,
           optionDescriptions: f.optionDescriptions ?? null
         })),
+        bodyTemplate: col.bodyTemplate ?? null,
+        // TASK-375: replaces the deleted per-field helpText above
         examples: col.examples ?? [],
         crossReferences: col.crossReferences ?? []
       }
@@ -13871,8 +13861,9 @@ function formatOutcomeShow(result2) {
   const o = result2.outcome;
   const unit = o.unit ? ` ${sanitizeSingleLineField(o.unit)}` : "";
   const lines = [
+    // N2 (TASK-367): the metric line is retired — the entry's own name (above) already states
+    // what is measured — mirrors packages/cli/src/commands/outcome.ts text-for-text.
     `${sanitizeSingleLineField(result2.entryId)} \u2014 ${sanitizeSingleLineField(result2.name)}`,
-    `  metric      ${o.metric ? sanitizeSingleLineField(o.metric) : "not set"}`,
     `  current     ${o.current ? `${o.current.value}${unit}` : "no readings yet"}   (${o.readingCount} reading(s))`,
     `  progress    ${pct(o.progressPct)}   direction ${o.direction}`,
     `  pace        ${pct(o.pacePct)}   ${o.pacePct === void 0 ? "(no cycle end set)" : o.pacePct >= 0 ? "(ahead of pace)" : "(behind pace)"}`,
@@ -14528,7 +14519,7 @@ ${entry.labels.map((l) => `- ${l.name ?? l.slug}`).join("\n")}`);
         collectionSlug,
         requiredFields: contract.requiredFields,
         allFields: contract.allFields,
-        captureExpectation: contract.captureExpectation
+        guidance: contract.guidance
       };
       return {
         contents: [{
@@ -14868,4 +14859,4 @@ export {
   createProductBrainServer,
   initFeatureFlags
 };
-//# sourceMappingURL=chunk-3NICJHNZ.js.map
+//# sourceMappingURL=chunk-3VQ5VSBH.js.map