@productbrain/mcp 0.0.1-beta.7503 → 0.0.1-beta.7510

package/dist/{chunk-NHVFNXUV.js → chunk-57YGCYCX.js}

@@ -1498,6 +1498,7 @@ var captureSchema = z4.object({
   entryId: entryIdSchema,
   canonicalKey: z4.string().optional().describe("Semantic type (e.g. 'decision', 'tension', 'vision'). Auto-assigned from collection if omitted."),
   data: z4.record(z4.unknown()).optional().describe("Explicit field values when you know the schema (e.g. canonical_key, cardinality_rule, required_fields). Merged with inferred values; user-provided wins."),
+  why: z4.string().optional().describe("Reasoning behind this entry \u2014 hard-required for decision/rule/strategy/purpose/vision/objective."),
   links: z4.array(z4.object({
     to: z4.string().describe("Target entry ID (e.g. '<PREFIX>-<n>')"),
     type: z4.string().describe("Relation type (e.g. 'governs', 'related_to', 'informs')")
@@ -1814,6 +1815,7 @@ var captureCompoundSchema = z4.object({
   entryId: entryIdSchema,
   canonicalKey: z4.string().max(200).optional().describe("Semantic type (e.g. 'decision', 'tension', 'vision'). Auto-assigned from collection if omitted."),
   data: z4.record(z4.unknown()).optional().describe("Explicit field values. Merged with inferred values; user-provided wins."),
+  why: z4.string().max(2e4).optional().describe("Why this entry exists."),
   links: z4.array(z4.object({
     to: z4.string().max(200).describe("Target entry ID (e.g. '<PREFIX>-<n>')"),
     type: z4.string().max(200).describe("Relation type (e.g. 'governs', 'related_to', 'informs')")
@@ -1833,7 +1835,7 @@ var captureActionUnion = z4.discriminatedUnion("action", [
 ]);
 var CAPTURE_ACTION_SPECS = {
   capture: {
-    params: ["collection", "name", "description", "context", "entryId", "canonicalKey", "data", "links", "sourceRef", "sourceExcerpt", "preview", "suggestOnly", "format"],
+    params: ["collection", "name", "description", "context", "entryId", "canonicalKey", "data", "why", "links", "sourceRef", "sourceExcerpt", "preview", "suggestOnly", "format"],
     description: "name and description are required."
   }
 };
@@ -1850,7 +1852,7 @@ function registerSmartCaptureTools(server) {
 Supported collections with smart profiles: ${SMART_PROFILE_COLLECTIONS.join(", ")}.
 All other collections get an ENT-{random} ID and sensible defaults.
 
-**Explicit data:** When you know the schema, pass \`data: { field: value }\` to set fields directly. Top-level \`name\` and \`description\` always win for those fields. \`data\` wins over inference for all other fields.
+**Explicit data:** When you know the schema, pass \`data: { field: value }\` to set fields directly. Top-level \`name\`/\`description\` win for those fields; \`data\` wins over inference for the rest. Governance entries also require a top-level \`why\`.
 
 **Compound capture:** Pass \`links\` to create relations in the same call (skips auto-link discovery). Entries are always created as \`draft\` \u2014 use \`entries action=commit\` to promote when ready.`,
       inputSchema: captureCompoundSchema,
@@ -1867,8 +1869,9 @@ All other collections get an ENT-{random} ID and sensible defaults.
     })
   );
 }
-async function handleCapture(server, { collection, name, description, context, entryId, canonicalKey, data: userData, links, sourceRef, sourceExcerpt, preview, suggestOnly, format, ownerRoleEntryId }) {
+async function handleCapture(server, { collection, name, description, context, entryId, canonicalKey, data: userData, why, links, sourceRef, sourceExcerpt, preview, suggestOnly, format, ownerRoleEntryId }) {
   requireWriteAccess();
+  if (typeof why === "string" && why.trim().length > 0) userData = { ...userData && typeof userData === "object" ? userData : {}, why };
   const timingStart = Date.now();
   const wsCtx = await getWorkspaceContext();
   const explicitCollectionProvided = typeof collection === "string" && collection.trim().length > 0;
@@ -2987,7 +2990,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?.canonical ?? entry.data?.rationale ?? "";
+  const descField = entry.data?.description ?? entry.data?.canonical ?? entry.data?.rationale ?? entry.data?.why ?? "";
   const preflight = await runConflictPreflight(
     entry.name,
     descField,
@@ -14867,4 +14870,4 @@ export {
   createProductBrainServer,
   initFeatureFlags
 };
-//# sourceMappingURL=chunk-NHVFNXUV.js.map
+//# sourceMappingURL=chunk-57YGCYCX.js.map