@productbrain/mcp 0.0.1-beta.958 → 0.0.1-beta.978

package/dist/{chunk-7BKN47NY.js → chunk-JJJO3SDX.js}

@@ -4263,6 +4263,25 @@ function sanitizeEntryData(data) {
   );
   return Object.keys(filtered).length > 0 ? filtered : void 0;
 }
+function renderWhyLine(e) {
+  const why = typeof e.why === "string" ? e.why : "";
+  if (e.whyQuality === "missing") {
+    return { line: `**Why:** \u2014 (no rationale captured)`, why, whySourceKey: null };
+  }
+  if (why.length > 0) {
+    const suffix = e.whyQuality === "restated" ? " (restated)" : "";
+    const d = e.data ?? {};
+    let whySourceKey = null;
+    const kf = e.whyField;
+    if ((kf === "rationale" || kf === "description") && typeof d[kf] === "string" && d[kf].trim().length > 0) {
+      whySourceKey = kf;
+    } else if (typeof d.rationale === "string" && d.rationale.trim().length > 0) {
+      whySourceKey = "rationale";
+    }
+    return { line: `**Why:** ${why}${suffix}`, why, whySourceKey };
+  }
+  return { line: null, why, whySourceKey: null };
+}
 var ENTRIES_ACTIONS = ["list", "get", "batch", "search"];
 var entriesSchema = z4.object({
   action: z4.enum(ENTRIES_ACTIONS).describe(
@@ -4291,6 +4310,9 @@ var entriesGetOutputSchema = z4.object({
   verificationStatus: z4.string().optional(),
   sourceRef: z4.string().optional(),
   sourceExcerpt: z4.string().optional(),
+  why: z4.string().optional(),
+  // TEN-2191: quality of the captured WHY — 'rationale' | 'missing' | 'restated'.
+  whyQuality: z4.enum(["rationale", "missing", "restated"]).optional(),
   data: z4.record(z4.unknown()).optional(),
   relations: z4.array(z4.object({
     entryId: z4.string().optional(),
@@ -4299,7 +4321,7 @@ var entriesGetOutputSchema = z4.object({
     direction: z4.string()
   })).optional(),
   labels: z4.array(z4.string()).optional()
-});
+}).passthrough();
 var entriesListOutputSchema = z4.object({
   entries: z4.array(z4.object({
     entryId: z4.string(),
@@ -4332,8 +4354,11 @@ var entriesBatchOutputSchema = z4.object({
     verificationStatus: z4.string().optional(),
     sourceRef: z4.string().optional(),
     sourceExcerpt: z4.string().optional(),
+    // TEN-2191: mirror entriesGetOutputSchema — batch entries now carry why/whyQuality.
+    why: z4.string().optional(),
+    whyQuality: z4.enum(["rationale", "missing", "restated"]).optional(),
     data: z4.record(z4.unknown()).optional()
-  })),
+  }).passthrough()),
   total: z4.number()
 });
 function registerEntriesTools(server) {
@@ -4419,10 +4444,13 @@ async function handleGet(entryId) {
   if (epistemic) {
     lines.push(formatEpistemicLine(epistemic));
   }
+  const { line: whyLine, why, whySourceKey } = renderWhyLine(e);
+  if (whyLine !== null) lines.push(whyLine);
   const visibleData = sanitizeEntryData(e.data);
-  if (visibleData) {
+  const filteredData = visibleData && whySourceKey ? Object.keys(visibleData).filter((k) => k !== whySourceKey).length > 0 ? Object.fromEntries(Object.entries(visibleData).filter(([k]) => k !== whySourceKey)) : void 0 : visibleData;
+  if (filteredData) {
     lines.push("");
-    for (const [key, val] of Object.entries(visibleData)) {
+    for (const [key, val] of Object.entries(filteredData)) {
       const display = typeof val === "string" ? val : JSON.stringify(val);
       lines.push(`**${key}:** ${display}`);
     }
@@ -4463,8 +4491,17 @@ async function handleGet(entryId) {
     ...e.verificationStatus ? { verificationStatus: String(e.verificationStatus) } : {},
     ...e.sourceRef ? { sourceRef: String(e.sourceRef) } : {},
     ...e.sourceExcerpt ? { sourceExcerpt: String(e.sourceExcerpt) } : {},
+    // TEN-2191: surface the WHY and its quality in the structured payload too.
+    ...why.length > 0 ? { why } : {},
+    ...e.whyQuality ? { whyQuality: String(e.whyQuality) } : {},
     entries: [{ entryId: e.entryId, name: e.name, status: e.status, ...e.workflowStatus ? { workflowStatus: e.workflowStatus } : {}, collectionName: String(e.collectionName ?? e.canonicalKey ?? "\u2014") }],
-    ...visibleData ? { data: visibleData } : {},
+    // Structured payload uses the same filteredData as the text render — the
+    // WHY-source field (rationale or description) is intentionally omitted from
+    // `data` because its full value is carried in the top-level `why` field
+    // (no information loss; `why` is the complete untruncated extractWhy result).
+    // This restores true STD-218 text/structured parity and removes the duplication
+    // that commit 8f3b1664 left in the structured payload. (Codex finding, TEN-2191.)
+    ...filteredData ? { data: filteredData } : {},
     ...Array.isArray(e.relations) && e.relations.length > 0 ? {
       relations: e.relations.map((r) => ({
         ...r.otherEntryId ? { entryId: r.otherEntryId } : {},
@@ -4521,10 +4558,13 @@ async function handleBatch(entryIds) {
     if (entry.sourceExcerpt) {
       lines.push(`**Source excerpt:** ${entry.sourceExcerpt}`);
     }
+    const { line: whyLine, whySourceKey } = renderWhyLine(entry);
+    if (whyLine !== null) lines.push(whyLine);
     const visibleData = sanitizeEntryData(entry.data);
-    if (visibleData) {
+    const filteredData = visibleData && whySourceKey ? Object.keys(visibleData).filter((k) => k !== whySourceKey).length > 0 ? Object.fromEntries(Object.entries(visibleData).filter(([k]) => k !== whySourceKey)) : void 0 : visibleData;
+    if (filteredData) {
       lines.push("");
-      for (const [key, val] of Object.entries(visibleData)) {
+      for (const [key, val] of Object.entries(filteredData)) {
         const display = typeof val === "string" ? val : JSON.stringify(val);
         lines.push(`**${key}:** ${display}`);
       }
@@ -4555,6 +4595,9 @@ async function handleBatch(entryIds) {
   }
   const structuredEntries = results.filter((r) => !r.error && r.entry).map((r) => {
     const entry = r.entry;
+    const { why: entryWhy, whySourceKey: entryWhySourceKey } = renderWhyLine(entry);
+    const entryVisibleData = sanitizeEntryData(entry.data);
+    const entryFilteredData = entryVisibleData && entryWhySourceKey ? Object.keys(entryVisibleData).filter((k) => k !== entryWhySourceKey).length > 0 ? Object.fromEntries(Object.entries(entryVisibleData).filter(([k]) => k !== entryWhySourceKey)) : void 0 : entryVisibleData;
     return {
       entryId: String(entry.entryId ?? ""),
       name: String(entry.name ?? ""),
@@ -4567,7 +4610,10 @@ async function handleBatch(entryIds) {
       ...entry.sourceRef ? { sourceRef: String(entry.sourceRef) } : {},
       ...entry.sourceExcerpt ? { sourceExcerpt: String(entry.sourceExcerpt) } : {},
       ...entry.workflowStatus ? { workflowStatus: String(entry.workflowStatus) } : {},
-      ...sanitizeEntryData(entry.data) ? { data: sanitizeEntryData(entry.data) } : {}
+      // TEN-2191: surface why/whyQuality in structured payload — mirrors handleGet.
+      ...entryWhy.length > 0 ? { why: entryWhy } : {},
+      ...entry.whyQuality ? { whyQuality: String(entry.whyQuality) } : {},
+      ...entryFilteredData ? { data: entryFilteredData } : {}
     };
   });
   const total = structuredEntries.length;
@@ -15222,4 +15268,4 @@ export {
   createProductBrainServer,
   initFeatureFlags
 };
-//# sourceMappingURL=chunk-7BKN47NY.js.map
+//# sourceMappingURL=chunk-JJJO3SDX.js.map