@productbrain/mcp 0.0.1-beta.5946 → 0.0.1-beta.5955

package/dist/{chunk-7T4HSTNG.js → chunk-W3MF7EC3.js}

@@ -1072,7 +1072,8 @@ var batchCaptureRealOutputSchema = z3.object({
     // stays a draft) — the same path that now also emits coherencyRefusal. The strict schema must
     // accept it or a refused response fails to validate on `status` (codex review, completing the
     // coherencyRefusal contract fix).
-    status: z3.enum(["draft", "committed", "proposed", "draft_on_failure"]),
+    status: z3.enum(["draft", "committed", "proposed", "draft_on_failure", "draft_spine_floor"]),
+    spineFloor: z3.object({ relationType: z3.string(), parentKind: z3.string(), exempt: z3.boolean() }).optional(),
     classifiedBy: z3.enum(["llm", "heuristic", "explicit"]).optional(),
     confidence: z3.number().optional(),
     confidenceTier: z3.enum(["high", "medium", "low"]).optional(),
@@ -1096,6 +1097,7 @@ var batchCaptureRealOutputSchema = z3.object({
   committed: z3.number(),
   proposed: z3.number(),
   drafts: z3.number(),
+  spineFloored: z3.number().optional(),
   classified: z3.number().optional(),
   autoCommitApplied: z3.boolean(),
   skippedLowConfidence: z3.array(z3.object({
@@ -1764,6 +1766,8 @@ function inferRelationType(_sourceCollection, _targetCollection, profile) {
 var AUTO_LINK_CONFIDENCE_THRESHOLD = 35;
 var MAX_AUTO_LINKS = 5;
 var MAX_SUGGESTIONS = 5;
+var SPINE_FLOOR_SENTENCE = "kept as a draft; it can be accepted once its spine above is accepted \u2014 the promote door checks the whole spine and names the first missing rung.";
+var SPINE_FLOOR_EXEMPT_SENTENCE = "kept as a draft, though this workspace is not yet enforcing the spine above it \u2014 it can be accepted as-is.";
 var BR_STD_ENTRY_ID_REGEX = /^(BR|STD)-\d+$/;
 var entryIdSchema = z5.string().regex(BR_STD_ENTRY_ID_REGEX).optional().describe("Only for business-rules and standards. Must match BR-NNN or STD-NNN. Omit for all other collections \u2014 IDs are auto-generated.");
 var captureSchema = z5.object({
@@ -2071,12 +2075,14 @@ var captureSuccessOutputSchema = z5.object({
   entryId: z5.string(),
   collection: z5.string(),
   name: z5.string(),
-  // "draft_on_failure" is emitted when an auto-commit is REFUSED/failed (stays a draft) — the
-  // same path that also emits coherencyRefusal; the strict schema must accept it or fail.
-  status: z5.enum(["draft", "committed", "proposed", "draft_on_failure"]),
+  // Single captures report the persisted draft; batch captures distinguish the draft reason.
+  status: z5.enum(["draft", "committed", "proposed", "draft_on_failure", "draft_spine_floor"]),
   // WP-480 S1: `qualityScore` (required, client N/10) deleted — a named, accepted
   // breaking output-contract change. The server verdict stays as `qualityVerdict`.
   qualityVerdict: z5.record(z5.unknown()).optional(),
+  qualityHints: z5.array(z5.record(z5.unknown())).optional(),
+  relationSuggestions: z5.array(z5.record(z5.unknown())).optional(),
+  groundingReport: captureSinglePreviewOutputSchema.shape.groundingReport.optional(),
   classifier: captureClassifierSchema.optional(),
   studioUrl: z5.string().optional(),
   warnings: z5.array(z5.string()).optional(),
@@ -2094,6 +2100,8 @@ var captureSuccessOutputSchema = z5.object({
     slug: z5.string(),
     status: z5.literal("proposal-pending")
   }).optional(),
+  // TASK-160: the server's birth-floor verdict must survive the strict output contract.
+  spineFloor: z5.object({ relationType: z5.string(), parentKind: z5.string(), exempt: z5.boolean() }).optional(),
   // WP-465 surface parity: structured coherency refusal when an auto-commit is gate-refused.
   // Loose record — the CoherencyRefusal contract is authored in
   // convex/lib/gates/coherencyControls.ts; re-declaring it here would be a second SSOT.
@@ -2183,7 +2191,7 @@ function registerSmartCaptureTools(server) {
     "capture",
     {
       title: "Capture",
-      description: "The tool for creating knowledge entries \u2014 single or batch. Two actions:\n\n- **capture**: Create a single entry. Creates an entry, auto-links related entries, and returns a quality scorecard \u2014 all in one call. Provide a name and description; `collection` is optional \u2014 the classifier auto-routes when omitted.\n- **batch**: Create multiple entries in one call via `items[]` (absorbs batch-capture). Each item may carry inline `relations` created right after that entry is captured.\n\n**action=capture details:**\nSupported collections with smart profiles: tensions, business-rules, glossary, decisions, features, audiences, strategy, standards, chains, insights, principles.\nAll other collections get an ENT-{random} ID and sensible defaults.\n\n**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.\n\n**Compound capture:** Pass `links` to create relations in the same call (skips auto-link discovery). In Open mode, entries commit by default when `autoCommit` is omitted. Pass `autoCommit: true` to promote the entry from draft to SSOT immediately after linking when you want to be explicit. Governed collections (glossary, business-rules, principles, standards, strategy, features, architecture) will warn but still commit \u2014 use only when you're certain.\n\nEntries are created as `draft` first, then may publish immediately depending on governance and `autoCommit`. Use `entries action=update` for post-creation adjustments.",
+      description: "The tool for creating knowledge entries \u2014 single or batch. Two actions:\n\n- **capture**: Create a single entry. Creates an entry, auto-links related entries, and returns a quality scorecard \u2014 all in one call. Provide a name and description; `collection` is optional \u2014 the classifier auto-routes when omitted.\n- **batch**: Create multiple entries in one call via `items[]` (absorbs batch-capture). Each item may carry inline `relations` created right after that entry is captured.\n\n**action=capture details:**\nSupported collections with smart profiles: tensions, business-rules, glossary, decisions, features, audiences, strategy, standards, chains, insights, principles.\nAll other collections get an ENT-{random} ID and sensible defaults.\n\n**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.\n\n**Compound capture:** Pass `links` to create relations in the same call (skips auto-link discovery). In Open mode, entries commit by default when `autoCommit` is omitted. Pass `autoCommit: true` to promote the entry from draft to SSOT immediately after linking when you want to be explicit. Governed collections (glossary, business-rules, principles, standards, strategy, features, architecture) will warn but still commit \u2014 use only when you're certain. An objective, key result or work package is always born draft first \u2014 `autoCommit: true` has no effect on that first birth even with a complete spine; commit it explicitly afterward.\n\nEntries are created as `draft` first, then may publish immediately depending on governance and `autoCommit`. Use `entries action=update` for post-creation adjustments.",
       inputSchema: captureCompoundSchema,
       annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
     },
@@ -2429,6 +2437,7 @@ ${groundingReport.governance.map((g) => `- **${g.entryId}** ${g.name} [${g.colle
   let authorityDomainFromCreate;
   let coachingFromCreate;
   let wasAutoCommittedServerSide = false;
+  let spineFloor;
   try {
     const result2 = await kernelMutation("chain.createEntry", {
       collectionSlug: resolvedCollection,
@@ -2536,6 +2545,7 @@ No DB writes \u2014 call without \`preview:true\` to capture for real.${result2.
     if (created.status === "active") {
       wasAutoCommittedServerSide = true;
     }
+    spineFloor = created.spineFloor;
   } catch (error) {
     const msg = error instanceof Error ? error.message : String(error);
     if (isGatewayTimeout(error)) return buildCaptureOutcomeUnknownResult(error, name, msg);
@@ -2776,7 +2786,7 @@ Use \`entries action=get\` to inspect the existing entry, or \`entries action=up
     }
   }
   const freshGovernanceMode = await refreshWorkspaceGovernanceMode();
-  const shouldAutoCommit = shouldAutoCommitCapture(autoCommit, freshGovernanceMode);
+  const shouldAutoCommit = !spineFloor && shouldAutoCommitCapture(autoCommit, freshGovernanceMode);
   let finalStatus = "draft";
   let commitError = null;
   let commitRefusal = null;
@@ -2907,6 +2917,11 @@ Use \`entries action=get\` to inspect the existing entry, or \`entries action=up
     } else {
       lines.push(`Error: ${commitError}. Entry saved as draft \u2014 use \`entries action=commit entryId="${finalEntryId}"\` to promote when ready.`);
     }
+  } else if (spineFloor) {
+    lines.push("");
+    lines.push("## Saved as draft");
+    lines.push(`**${name}** ${spineFloor.exempt ? SPINE_FLOOR_EXEMPT_SENTENCE : SPINE_FLOOR_SENTENCE}`);
+    lines.push(`Next: \`entries action=commit entryId="${finalEntryId}"\`.`);
   }
   if (shouldAutoCommit && conflictCandidates.length > 0) {
     lines.push("");
@@ -3130,6 +3145,8 @@ Use \`entries action=get\` to inspect the existing entry, or \`entries action=up
           relationSuggestions: relationSuggestionsFromCreate,
           // TEN-2365: capture-time authority-domain proposal (PENDING ratification), when filed.
           ...authorityDomainFromCreate && { authorityDomain: authorityDomainFromCreate },
+          // WP-745 TASK-160 (PR #901 review): the machine-readable projection — was reaching the human text only.
+          ...spineFloor && { spineFloor },
           // WP-318 S2: Pre-write grounding report — always included (empty arrays when no suggestions)
           groundingReport
         },
@@ -3149,7 +3166,8 @@ async function handleBatchCapture(server, { entries, autoCommit, preview }) {
   const createdBy = agentId ? `agent:${agentId}` : "capture";
   const wsCtx = await getWorkspaceContext();
   const freshGovernanceModeForBatch = await refreshWorkspaceGovernanceMode();
-  const autoCommitApplied = shouldAutoCommitCapture(autoCommit, freshGovernanceModeForBatch);
+  const shouldAutoCommitBatch = shouldAutoCommitCapture(autoCommit, freshGovernanceModeForBatch);
+  let autoCommitApplied = false;
   const needsClassification = entries.map((e, i) => ({ ...e, index: i })).filter((e) => !e.collection);
   let classificationMap = /* @__PURE__ */ new Map();
   if (needsClassification.length > 0) {
@@ -3403,11 +3421,13 @@ async function handleBatchCapture(server, { entries, autoCommit, preview }) {
       ];
       if (!preview) resolveGapsForEntry(entry.name, result2.entryId);
       const batchWasAutoCommittedServerSide = result2.status === "active";
-      let finalStatus = batchWasAutoCommittedServerSide ? "committed" : "draft";
+      const batchSpineFloor = result2.spineFloor;
+      let finalStatus = batchWasAutoCommittedServerSide ? "committed" : batchSpineFloor ? "draft_spine_floor" : "draft";
       let commitError;
       let commitRefusal;
       let contradictionAdvisory;
       if (batchWasAutoCommittedServerSide) {
+        if (!preview) autoCommitApplied = true;
         await recordSessionActivity({ entryModified: internalId });
         trackChainEntryCommitted(wsCtx.workspaceId, {
           entry_id: finalEntryId,
@@ -3502,9 +3522,10 @@ async function handleBatchCapture(server, { entries, autoCommit, preview }) {
           if (relationsProposedCount > 0) {
             batchEntryWarnings.push(`${relationsProposedCount} inline relation(s) converted to an agent proposal (misuse pattern) \u2014 review in Cortex UI.`);
           }
-          if (!preview && autoCommitApplied && !batchWasAutoCommittedServerSide) {
+          if (!preview && shouldAutoCommitBatch && !batchWasAutoCommittedServerSide && !batchSpineFloor) {
             try {
               const semanticConflicts = await discoverSemanticConflicts(entry.name, entry.description, resolvedSlug);
+              autoCommitApplied = true;
               const commitResult = await kernelMutation("chain.commitEntry", {
                 entryId: finalEntryId,
                 author: agentId ? `agent:${agentId}` : void 0,
@@ -3559,6 +3580,8 @@ async function handleBatchCapture(server, { entries, autoCommit, preview }) {
             ...commitError ? { commitError } : {},
             // WP-465 surface parity: thread full refusal payload for coherency-refused batch entries.
             ...commitRefusal ? { commitRefusal } : {},
+            ...batchSpineFloor ? { spineFloor: batchSpineFloor } : {},
+            // WP-745 TASK-160: read by the render below.
             // WP-485 Slice 2b (R2, FEAT-1370): the server's contradiction advisory (DEC-1321 —
             // advisory only, never blocking) — visible, never a silent success.
             ...contradictionAdvisory ? { contradictionAdvisory } : {},
@@ -3598,6 +3621,7 @@ async function handleBatchCapture(server, { entries, autoCommit, preview }) {
   const proposed = created.filter((r) => r.status === "proposed");
   const drafts = created.filter((r) => r.status === "draft");
   const commitFailed = created.filter((r) => r.status === "draft_on_failure");
+  const spineFloored = created.filter((r) => r.status === "draft_spine_floor");
   const classifiedCount = created.filter((r) => r.classifiedBy && r.classifiedBy !== "explicit").length;
   await server.sendLoggingMessage({
     level: "info",
@@ -3625,8 +3649,9 @@ async function handleBatchCapture(server, { entries, autoCommit, preview }) {
   }
   if (created.length > 0) {
     const commitFailedSegment = commitFailed.length > 0 ? `, ${commitFailed.length} commit-failed` : "";
+    const spineFloorSegment = spineFloored.length > 0 ? `, ${spineFloored.length} spine-floored` : "";
     lines.push(
-      `**Statuses:** ${committed.length} committed, ${proposed.length} proposed, ${drafts.length} draft${commitFailedSegment}.`
+      `**Statuses:** ${committed.length} committed, ${proposed.length} proposed, ${drafts.length} draft${spineFloorSegment}${commitFailedSegment}.`
     );
     lines.push("");
   }
@@ -3670,11 +3695,13 @@ _Use \`entries action=move\` to correct any misclassified entries._`);
     lines.push("");
     lines.push("_Re-capture these with an explicit `collection` or use the suggested collection._");
   }
-  if (commitFailed.length > 0) {
+  if (commitFailed.length > 0 || spineFloored.length > 0) {
     lines.push("");
     lines.push("## Saved as draft");
-    for (const r of commitFailed) {
-      if (r.commitRefusal) {
+    for (const r of [...spineFloored, ...commitFailed]) {
+      if (r.spineFloor) {
+        lines.push(`- **${r.entryId}**: ${r.name} [${r.collection}] \u2014 ${r.spineFloor.exempt ? SPINE_FLOOR_EXEMPT_SENTENCE : SPINE_FLOOR_SENTENCE} Next: \`entries action=commit entryId="${r.entryId}"\`.`);
+      } else if (r.commitRefusal) {
         lines.push(`- **${r.entryId}**: ${r.name} [${r.collection}]`);
         const refusalText = coherencyRefusedResult("batch-capture", r.entryId ?? "", r.commitRefusal, { headingLevel: 3 }).content[0].text;
         lines.push(...refusalText.split("\n"));
@@ -3743,8 +3770,9 @@ _Use \`entries action=move\` to correct any misclassified entries._`);
   const skippedNote = skippedLowConfidence.length > 0 ? `, ${skippedLowConfidence.length} skipped (low confidence)` : "";
   const classifiedNote = classifiedCount > 0 ? `, ${classifiedCount} auto-classified` : "";
   const commitFailedNote = commitFailed.length > 0 ? `, ${commitFailed.length} commit-failed` : "";
-  const summary = failed.length > 0 || unknownOutcomeEntries.length > 0 || skippedLowConfidence.length > 0 || commitFailed.length > 0 ? `Batch captured ${created.length}/${entries.length} entries (${failed.length} failed${unknownOutcomeSummaryNote(unknownOutcomeEntries)}${skippedNote}, ${committed.length} committed, ${proposed.length} proposed, ${drafts.length} draft${commitFailedNote}${classifiedNote}).` : `Batch captured ${created.length} entries successfully (${committed.length} committed, ${proposed.length} proposed, ${drafts.length} draft${classifiedNote}).`;
-  const firstDraft = drafts[0];
+  const spineFloorNote = spineFloored.length > 0 ? `, ${spineFloored.length} spine-floored` : "";
+  const summary = failed.length > 0 || unknownOutcomeEntries.length > 0 || skippedLowConfidence.length > 0 || commitFailed.length > 0 || spineFloored.length > 0 ? `Batch captured ${created.length}/${entries.length} entries (${failed.length} failed${unknownOutcomeSummaryNote(unknownOutcomeEntries)}${skippedNote}, ${committed.length} committed, ${proposed.length} proposed, ${drafts.length} draft${spineFloorNote}${commitFailedNote}${classifiedNote}).` : `Batch captured ${created.length} entries successfully (${committed.length} committed, ${proposed.length} proposed, ${drafts.length} draft${classifiedNote}).`;
+  const firstDraft = drafts[0] ?? spineFloored[0] ?? commitFailed[0];
   const next = [];
   if (created.length > 0) {
     next.push({ tool: "relations", description: "Discover connections", parameters: { action: "suggest", entryId: created[0].entryId } });
@@ -3780,6 +3808,8 @@ _Use \`entries action=move\` to correct any misclassified entries._`);
             ...r.commitError ? { commitError: r.commitError } : {},
             // WP-465 surface parity: thread full refusal payload into batch structured output.
             ...r.commitRefusal ? { coherencyRefusal: r.commitRefusal } : {},
+            ...r.spineFloor ? { spineFloor: r.spineFloor } : {},
+            // WP-745 TASK-160: the projection a machine consumer receives; was human-render only (Copilot review, PR #901).
             ...r.authorityDomain ? { domain: r.authorityDomain.slug } : {},
             // TEN-957 (WP-484 S2): inline relations created for this entry.
             ...r.relationsCreated ? { relationsCreated: r.relationsCreated } : {},
@@ -3796,6 +3826,7 @@ _Use \`entries action=move\` to correct any misclassified entries._`);
           proposed: proposed.length,
           drafts: drafts.length,
           ...commitFailed.length > 0 ? { commitFailed: commitFailed.length } : {},
+          ...spineFloored.length > 0 ? { spineFloored: spineFloored.length } : {},
           ...classifiedCount > 0 ? { classified: classifiedCount } : {},
           autoCommitApplied,
           ...skippedLowConfidence.length > 0 && {
@@ -17062,4 +17093,4 @@ export {
   createProductBrainServer,
   initFeatureFlags
 };
-//# sourceMappingURL=chunk-7T4HSTNG.js.map
+//# sourceMappingURL=chunk-W3MF7EC3.js.map