@productbrain/mcp 0.0.1-beta.8248 → 0.0.1-beta.8252

package/dist/{chunk-J5R4OAP5.js → chunk-LV23VXXV.js}

@@ -988,6 +988,10 @@ async function resolveTargetProseKey(collectionSlug) {
   const col = await getCollectionBySlug(collectionSlug).catch(() => void 0);
   return col?.descriptionFieldKey || "description";
 }
+function captureChangeReason(description, data) {
+  const text = description.trim() || Object.keys(data ?? {}).map((k) => `${k} set`).join(", ");
+  return text ? { changeReason: `Captured: ${text.slice(0, 300)}` } : {};
+}
 async function runVersionCapture(params) {
   const { groundingEntry, name, description, data, sourceRef, sourceExcerpt, links, groundingElapsedMs } = params;
   const versionAgentId = getAgentSessionId();
@@ -999,6 +1003,7 @@ async function runVersionCapture(params) {
       ...patch,
       autoPublish: true,
       changeNote: "Captured as a new version via MCP",
+      ...captureChangeReason(description ?? "", data ?? void 0),
       changedBy: versionAgentId ? `agent:${versionAgentId}` : "capture",
       ...sourceRef ? { sourceRef } : {},
       ...sourceExcerpt ? { sourceExcerpt } : {}
@@ -2881,6 +2886,7 @@ var updateEntrySchema = z6.object({
   canonicalKey: z6.string().optional().describe("Semantic type (e.g. 'decision', 'tension'). Only changeable on draft/uncommitted entries."),
   autoPublish: z6.boolean().optional().default(false).describe("Accepted for backward compatibility but IGNORED \u2014 draft vs. published is decided by the entry's own accepted/active status, never by this flag. Removal tracked as a follow-up."),
   // DEC-1716
+  changeReason: z6.string().optional().describe("Change reason: required when this update changes a promise field (or the name of a collection that declares one) of an accepted entry \u2014 why what the entry promises is changing. Recorded on the history event and the version. Not the same as changeNote."),
   changeNote: z6.string().optional().describe("Strongly recommended: short human-readable rationale for WHY this change was made (e.g. 'Aligned description with F1-themed copy'). Surfaces in activity feed and pb get. If omitted, falls back to session purpose or auto-generated field summary."),
   sourceRef: z6.string().optional().describe("URI or path of the source document backing this entry. Write-once: can only be set if currently empty."),
   sourceExcerpt: z6.string().optional().describe("Verbatim excerpt from the source that backs this entry's claims. Write-once: can only be set if currently empty."),
@@ -2904,7 +2910,7 @@ var commitEntrySchema = z6.object({
     reason: z6.string().optional().describe("Divergence rationale (required for 'diverged', \u226512 chars).")
   }).optional().describe("Explicit response to a coherency challenge (standard/strict workspace modes).")
 });
-async function handleUpdateEntry({ entryId, name, status: rawStatus, workflowStatus: rawWorkflowStatus, data, order, canonicalKey, autoPublish, changeNote, sourceRef, sourceExcerpt, steeringOverrideReason, coherencyAcknowledgement }, toolName = "entries") {
+async function handleUpdateEntry({ entryId, name, status: rawStatus, workflowStatus: rawWorkflowStatus, data, order, canonicalKey, autoPublish, changeNote, changeReason, sourceRef, sourceExcerpt, steeringOverrideReason, coherencyAcknowledgement }, toolName = "entries") {
   requireWriteAccess();
   const fieldsProvided = [];
   if (name !== void 0) fieldsProvided.push("name");
@@ -2925,6 +2931,7 @@ async function handleUpdateEntry({ entryId, name, status: rawStatus, workflowSta
     canonicalKey,
     autoPublish,
     changeNote,
+    ...changeReason ? { changeReason } : {},
     changedBy: getAgentSessionId() ? `agent:${getAgentSessionId()}` : void 0,
     ...sourceRef !== void 0 ? { sourceRef } : {},
     ...sourceExcerpt !== void 0 ? { sourceExcerpt } : {},
@@ -3758,6 +3765,9 @@ var entriesSchema = z10.object({
   autoPublish: z10.boolean().optional().default(false).describe(
     "For 'update': accepted for backward compatibility but IGNORED \u2014 draft vs. published is decided by the entry's own accepted/active status, never by this flag."
   ),
+  changeReason: z10.string().max(2e3).optional().describe(
+    "For 'update': Change reason \u2014 required when the update changes a promise field of an accepted entry. Recorded on the history event and the version."
+  ),
   changeNote: z10.string().max(2e3).optional().describe(
     "For 'update': short human-readable rationale for WHY this change was made. Surfaces in activity feed."
   ),
@@ -3831,7 +3841,7 @@ var ENTRIES_ACTION_SPECS = {
   get: { params: ["entryId"], description: "Fetch one entry by ID." },
   batch: { params: ["entryIds"], description: "Fetch up to 20 entries by ID." },
   search: { params: ["query", "collection", "status"], description: "Full-text search; query is required (min 2 chars)." },
-  update: { params: ["entryId", "name", "status", "workflowStatus", "data", "order", "canonicalKey", "autoPublish", "changeNote", "sourceRef", "sourceExcerpt", "steeringOverrideReason", "coherencyAcknowledgement"], description: "entryId is required; every other field is optional." },
+  update: { params: ["entryId", "name", "status", "workflowStatus", "data", "order", "canonicalKey", "autoPublish", "changeNote", "changeReason", "sourceRef", "sourceExcerpt", "steeringOverrideReason", "coherencyAcknowledgement"], description: "entryId is required; every other field is optional." },
   commit: { params: ["entryId", "preview", "steeringOverrideReason", "coherencyAcknowledgement"], description: "entryId is required." },
   history: { params: ["entryId"], description: "entryId is required." },
   move: { params: ["entryId", "toCollection", "canonicalKey"], description: "entryId and toCollection are required; canonicalKey is optional (atomic move+retype)." },
@@ -14616,4 +14626,4 @@ export {
   createProductBrainServer,
   initFeatureFlags
 };
-//# sourceMappingURL=chunk-J5R4OAP5.js.map
+//# sourceMappingURL=chunk-LV23VXXV.js.map