@productbrain/mcp 0.0.1-beta.6442 → 0.0.1-beta.6461

package/dist/{chunk-7TLBTMIV.js → chunk-PZDI2QMN.js}

@@ -847,6 +847,169 @@ async function resolveCollection(params) {
   return result2 ?? null;
 }
 
+// src/tools/coherency-refusal.ts
+function asDescription(value) {
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : void 0;
+}
+var GENERIC_RECOVERY_LINE = "Respond and retry: link the entry to the strategic spine, pass `coherencyAcknowledgement`, or supply a typed `steeringOverrideReason`.";
+function coherencyRefusedResult(toolName, entryId, refusal, options) {
+  const headingLevel = options?.headingLevel ?? 1;
+  const heading = "#".repeat(headingLevel);
+  const lines = [
+    `${heading} Write refused by the coherency gate`,
+    "",
+    refusal.reason ?? `The coherency gate refused this write on ${entryId}.`
+  ];
+  if (refusal.subject?.name) {
+    lines.push(`On: ${refusal.subject.name}`);
+  }
+  if (refusal.mode) {
+    lines.push("", `Mode: ${refusal.mode}`);
+  }
+  const routes = refusal.routes;
+  const routeKeys = routes ? Object.keys(routes) : [];
+  if (routeKeys.length > 0) {
+    lines.push("", `${"#".repeat(headingLevel + 1)} Recovery routes`);
+    const beforeRoutes = lines.length;
+    if (routes && typeof routes.link === "object" && routes.link !== null) {
+      const link = routes.link;
+      lines.push(`- **link:** ${asDescription(link.description) ?? "Link the entry to the strategic spine."}`);
+    }
+    if (routes && typeof routes.acknowledge === "object" && routes.acknowledge !== null) {
+      const ack = routes.acknowledge;
+      const responses = ack.responses?.join(" | ") ?? "linked | accepted-fix | diverged";
+      lines.push(
+        `- **acknowledge** (\`${ack.param ?? "coherencyAcknowledgement"}\`): ${responses}${ack.minReasonChars ? ` (\u2265${ack.minReasonChars} chars for diverged)` : ""}. ${asDescription(ack.description) ?? ""}`.trim()
+      );
+    }
+    if (routes && typeof routes.override === "object" && routes.override !== null) {
+      const ov = routes.override;
+      lines.push(
+        `- **override** (\`${ov.param ?? "steeringOverrideReason"}\`): \u2265${ov.minChars ?? 12} chars. ${asDescription(ov.description) ?? ""}`.trim()
+      );
+    }
+    if (lines.length === beforeRoutes) {
+      lines.push(GENERIC_RECOVERY_LINE);
+    }
+  } else {
+    lines.push("", GENERIC_RECOVERY_LINE);
+  }
+  return failureResult(
+    lines.join("\n"),
+    "COHERENCY_REFUSED",
+    `Coherency gate refused ${toolName} on ${entryId}.`,
+    "Use one of the refusal's routes (link / coherencyAcknowledgement / steeringOverrideReason), then retry.",
+    void 0,
+    { entryId, refusal }
+  );
+}
+
+// src/lib/collectionCache.ts
+var collectionCache = new ScopedCache(COLLECTION_CACHE_TTL_MS);
+async function getCollections() {
+  const scope = cacheScope();
+  const hit = collectionCache.get(scope);
+  if (hit) return hit.collections;
+  const result2 = await kernelQuery("chain.listCollections") ?? [];
+  const bySlug = new Map(result2.map((c) => [c.slug, c]));
+  collectionCache.set(scope, { collections: result2, bySlug });
+  return result2;
+}
+async function getCollectionBySlug(slug) {
+  await getCollections();
+  return collectionCache.get(cacheScope())?.bySlug.get(slug);
+}
+function invalidateCollectionCacheForScope() {
+  collectionCache.delete(cacheScope());
+}
+async function isGoverned(slug) {
+  const col = await getCollectionBySlug(slug);
+  return !!col?.governed;
+}
+
+// src/lib/versionWrite.ts
+function buildVersionPatch(params) {
+  const { capture, targetProseKey } = params;
+  const data = { ...capture.fields ?? {} };
+  if (capture.prose.trim()) data[targetProseKey] = capture.prose;
+  return capture.name ? { name: capture.name, data } : { data };
+}
+function readVersionWriteOutcome(result2) {
+  if (result2 && typeof result2 === "object" && result2.outcome === "refused") {
+    const rawRefusal = result2.refusal;
+    const refusal = rawRefusal && typeof rawRefusal === "object" ? rawRefusal : { reason: "The workspace refused this update." };
+    return { ok: false, refusal };
+  }
+  if (result2 && typeof result2 === "object" && typeof result2.id === "string") {
+    return { ok: true, id: result2.id };
+  }
+  return { ok: false, refusal: { reason: "The workspace refused this update." } };
+}
+
+// src/tools/captureVersion.ts
+function buildVersionPreviewResult(groundingEntry, name) {
+  return successResult(
+    `# Would save as a new version of ${groundingEntry.entryId}
+
+No DB writes \u2014 call without \`preview:true\` to version for real.`,
+    `Would save as a new version of ${groundingEntry.entryId}.`,
+    { id: groundingEntry.entryId, kind: "version", preview: true, name }
+  );
+}
+async function resolveTargetProseKey(collectionSlug) {
+  const col = await getCollectionBySlug(collectionSlug).catch(() => void 0);
+  return col?.descriptionFieldKey || "description";
+}
+async function runVersionCapture(params) {
+  const { groundingEntry, name, description, data, sourceRef, sourceExcerpt, links, groundingElapsedMs } = params;
+  const versionAgentId = getAgentSessionId();
+  const targetProseKey = await resolveTargetProseKey(groundingEntry.collectionSlug);
+  const patch = buildVersionPatch({ capture: { prose: description ?? "", fields: data ?? void 0 }, targetProseKey });
+  try {
+    const rawResult = await kernelMutation("chain.updateEntry", {
+      entryId: groundingEntry.entryId,
+      ...patch,
+      autoPublish: true,
+      changeNote: "Captured as a new version via MCP",
+      changedBy: versionAgentId ? `agent:${versionAgentId}` : "capture",
+      ...sourceRef ? { sourceRef } : {},
+      ...sourceExcerpt ? { sourceExcerpt } : {}
+    });
+    void kernelMutation("chain.recordGroundingOutcome", {
+      surface: "mcp",
+      promptShown: false,
+      highestRatio: groundingEntry.score,
+      hadGovernance: false,
+      grounding_ms: groundingElapsedMs
+    }).catch(() => void 0);
+    const outcome = readVersionWriteOutcome(rawResult);
+    if (!outcome.ok) {
+      return coherencyRefusedResult("capture", groundingEntry.entryId, outcome.refusal);
+    }
+    if (links && links.length > 0) {
+      await kernelMutation("chain.createEntryRelations", {
+        relations: links.slice(0, 25).map((l) => ({ fromEntryId: groundingEntry.entryId, toEntryId: l.to, type: l.type, proposedBy: "user" })),
+        sessionId: versionAgentId ?? void 0
+      }).catch(() => void 0);
+    }
+    return successResult(
+      `# Saved as a new version of ${groundingEntry.entryId}
+
+${name}`,
+      `Saved as a new version of ${groundingEntry.entryId}.`,
+      { id: groundingEntry.entryId, kind: "version" }
+    );
+  } catch (error) {
+    const classified = classifyError(error);
+    return failureResult(classified.message, classified.code, classified.message, classified.recovery, classified.availableActions, classified.diagnostics);
+  }
+}
+async function captureVersionOrPreview(preview, params) {
+  return preview ? buildVersionPreviewResult(params.groundingEntry, params.name) : runVersionCapture(params);
+}
+
 // src/lib/fieldTypes.ts
 var FIELD_TYPE_DEFAULTS = {
   "string": "",
@@ -909,29 +1072,6 @@ function inferSourceDate(...values) {
   return `${inferredYear}-${month}-${day}`;
 }
 
-// src/lib/collectionCache.ts
-var collectionCache = new ScopedCache(COLLECTION_CACHE_TTL_MS);
-async function getCollections() {
-  const scope = cacheScope();
-  const hit = collectionCache.get(scope);
-  if (hit) return hit.collections;
-  const result2 = await kernelQuery("chain.listCollections") ?? [];
-  const bySlug = new Map(result2.map((c) => [c.slug, c]));
-  collectionCache.set(scope, { collections: result2, bySlug });
-  return result2;
-}
-async function getCollectionBySlug(slug) {
-  await getCollections();
-  return collectionCache.get(cacheScope())?.bySlug.get(slug);
-}
-function invalidateCollectionCacheForScope() {
-  collectionCache.delete(cacheScope());
-}
-async function isGoverned(slug) {
-  const col = await getCollectionBySlug(slug);
-  return !!col?.governed;
-}
-
 // src/lib/textMatch.ts
 var STOP_WORDS = /* @__PURE__ */ new Set([
   "the",
@@ -2335,6 +2475,7 @@ ${groundingReport.duplicates.map((d) => `- **${d.entryId}** ${d.name} [${d.colle
       }
     };
   }
+  if (groundingEntry?.kind === "version") return captureVersionOrPreview(preview ?? false, { groundingEntry, name, description, data: userData, sourceRef, sourceExcerpt, links, groundingElapsedMs });
   const data = buildDataFromFields(col.fields ?? [], profile.descriptionField, description);
   for (const def of profile.defaults) {
     if (def.value !== "infer" && def.value !== "today") {
@@ -2538,7 +2679,7 @@ Use \`entries action=get\` to inspect the existing entry, or \`entries action=up
   const tAfterCreate = Date.now();
   void kernelMutation("chain.recordGroundingOutcome", {
     surface: "mcp",
-    promptShown: groundingEntry?.kind === "ask" || groundingEntry?.kind === "version",
+    promptShown: groundingEntry?.kind === "ask",
     highestRatio: Math.max(
       ...groundingReport.duplicates.map((d) => d.overlapRatio),
       ...groundingReport.related.map((r) => r.overlapRatio),
@@ -3719,65 +3860,6 @@ async function runConflictPreflight(name, description, collectionHint) {
   }
 }
 
-// src/tools/coherency-refusal.ts
-function asDescription(value) {
-  if (typeof value !== "string") return void 0;
-  const trimmed = value.trim();
-  return trimmed.length > 0 ? trimmed : void 0;
-}
-var GENERIC_RECOVERY_LINE = "Respond and retry: link the entry to the strategic spine, pass `coherencyAcknowledgement`, or supply a typed `steeringOverrideReason`.";
-function coherencyRefusedResult(toolName, entryId, refusal, options) {
-  const headingLevel = options?.headingLevel ?? 1;
-  const heading = "#".repeat(headingLevel);
-  const lines = [
-    `${heading} Write refused by the coherency gate`,
-    "",
-    refusal.reason ?? `The coherency gate refused this write on ${entryId}.`
-  ];
-  if (refusal.subject?.name) {
-    lines.push(`On: ${refusal.subject.name}`);
-  }
-  if (refusal.mode) {
-    lines.push("", `Mode: ${refusal.mode}`);
-  }
-  const routes = refusal.routes;
-  const routeKeys = routes ? Object.keys(routes) : [];
-  if (routeKeys.length > 0) {
-    lines.push("", `${"#".repeat(headingLevel + 1)} Recovery routes`);
-    const beforeRoutes = lines.length;
-    if (routes && typeof routes.link === "object" && routes.link !== null) {
-      const link = routes.link;
-      lines.push(`- **link:** ${asDescription(link.description) ?? "Link the entry to the strategic spine."}`);
-    }
-    if (routes && typeof routes.acknowledge === "object" && routes.acknowledge !== null) {
-      const ack = routes.acknowledge;
-      const responses = ack.responses?.join(" | ") ?? "linked | accepted-fix | diverged";
-      lines.push(
-        `- **acknowledge** (\`${ack.param ?? "coherencyAcknowledgement"}\`): ${responses}${ack.minReasonChars ? ` (\u2265${ack.minReasonChars} chars for diverged)` : ""}. ${asDescription(ack.description) ?? ""}`.trim()
-      );
-    }
-    if (routes && typeof routes.override === "object" && routes.override !== null) {
-      const ov = routes.override;
-      lines.push(
-        `- **override** (\`${ov.param ?? "steeringOverrideReason"}\`): \u2265${ov.minChars ?? 12} chars. ${asDescription(ov.description) ?? ""}`.trim()
-      );
-    }
-    if (lines.length === beforeRoutes) {
-      lines.push(GENERIC_RECOVERY_LINE);
-    }
-  } else {
-    lines.push("", GENERIC_RECOVERY_LINE);
-  }
-  return failureResult(
-    lines.join("\n"),
-    "COHERENCY_REFUSED",
-    `Coherency gate refused ${toolName} on ${entryId}.`,
-    "Use one of the refusal's routes (link / coherencyAcknowledgement / steeringOverrideReason), then retry.",
-    void 0,
-    { entryId, refusal }
-  );
-}
-
 // src/tools/knowledge/getHistory.ts
 import { z as z7 } from "zod/v3";
 var getHistorySchema = z7.object({
@@ -3821,7 +3903,8 @@ var updateEntrySchema = z8.object({
   data: z8.record(z8.unknown()).optional().describe("Fields to update (merged with existing data)"),
   order: z8.number().optional().describe("New sort order"),
   canonicalKey: z8.string().optional().describe("Semantic type (e.g. 'decision', 'tension'). Only changeable on draft/uncommitted entries."),
-  autoPublish: z8.boolean().optional().default(false).describe("Only true when user explicitly asks to publish. Default false = draft. Never auto-publish without user confirmation."),
+  autoPublish: z8.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
   changeNote: z8.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: z8.string().optional().describe("URI or path of the source document backing this entry. Write-once: can only be set if currently empty."),
   sourceExcerpt: z8.string().optional().describe("Verbatim excerpt from the source that backs this entry's claims. Write-once: can only be set if currently empty."),
@@ -4708,8 +4791,9 @@ var entriesSchema = z11.object({
   canonicalKey: z11.string().max(200).optional().describe(
     "For 'update': semantic type (e.g. 'decision', 'tension'); only changeable on draft/uncommitted entries. For 'move': optional atomic move+retype target. For 'preflight': optional semantic type to check requirements for."
   ),
+  // DEC-1716: draft vs. published is decided by the entry's own accepted/active status, never this flag.
   autoPublish: z11.boolean().optional().default(false).describe(
-    "For 'update': only true when the user explicitly asks to publish. Default false = draft."
+    "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."
   ),
   changeNote: z11.string().max(2e3).optional().describe(
     "For 'update': short human-readable rationale for WHY this change was made. Surfaces in activity feed."
@@ -4951,7 +5035,7 @@ function registerEntriesTools(server) {
     "entries",
     {
       title: "Entries",
-      description: 'Read and manage entries on the Chain. One tool for the entry lifecycle.\n\n- **preflight**: Inspect a type and selected context before composing. No writes, capacity reservation or authority grant.\n- **list**: Browse entries with optional filters (collection, status, tag, label). Use collections action=list first to discover slugs.\n- **get**: Fetch a single entry by ID \u2014 full record with data, labels, relations, history.\n- **batch**: Fetch multiple entries (max 20) in one call. Same shape as get per entry.\n- **search**: Full-text search across entries. Scope by collection or filter by status.\n- **update**: Change fields on an existing entry (draft by default \u2014 never autoPublish without explicit user confirmation).\n- **commit**: Accept a draft entry onto the Chain (SSOT). Runs the contradiction preflight first.\n- **history**: Audit trail for an entry.\n- **move**: Relocate an entry to a different collection; pass canonicalKey too for an atomic move+retype.\n- **verify**: Mark an entry as verified (lightweight, no codebase scan \u2014 see `quality action=verify-chain` for that).\n\nUse `entries action=get entryId="..."` to fetch one. Use `entries action=search query="..."` to discover.',
+      description: 'Read and manage entries on the Chain. One tool for the entry lifecycle.\n\n- **preflight**: Inspect a type and selected context before composing. No writes, capacity reservation or authority grant.\n- **list**: Browse entries with optional filters (collection, status, tag, label). Use collections action=list first to discover slugs.\n- **get**: Fetch a single entry by ID \u2014 full record with data, labels, relations, history.\n- **batch**: Fetch multiple entries (max 20) in one call. Same shape as get per entry.\n- **search**: Full-text search across entries. Scope by collection or filter by status.\n- **update**: Change fields on an existing entry (publishes whenever the entry is not draft \u2014 includes archived, not just accepted/active; autoPublish is accepted but ignored).\n- **commit**: Accept a draft entry onto the Chain (SSOT). Runs the contradiction preflight first.\n- **history**: Audit trail for an entry.\n- **move**: Relocate an entry to a different collection; pass canonicalKey too for an atomic move+retype.\n- **verify**: Mark an entry as verified (lightweight, no codebase scan \u2014 see `quality action=verify-chain` for that).\n\nUse `entries action=get entryId="..."` to fetch one. Use `entries action=search query="..."` to discover.',
       inputSchema: entriesSchema,
       // Mixed read/write noun (§3 R3): can't be marked read-only once update/commit/move
       // live here too — accepted for the 11-tool default (§9 R3).
@@ -16669,4 +16753,4 @@ export {
   createProductBrainServer,
   initFeatureFlags
 };
-//# sourceMappingURL=chunk-7TLBTMIV.js.map
+//# sourceMappingURL=chunk-PZDI2QMN.js.map