@productbrain/mcp 0.0.1-beta.3298 → 0.0.1-beta.3314

package/dist/{chunk-WXBZFMDB.js → chunk-AWDYYGKN.js}

@@ -40,7 +40,7 @@ import {
   trackSessionCaptureRate,
   trackWriteBackHintServed,
   trackZeroCaptureAuditFired
-} from "./chunk-6XYRKXER.js";
+} from "./chunk-ZZVUTH6P.js";
 
 // src/server.ts
 import { McpServer as McpServer2 } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -14706,6 +14706,168 @@ function registerFeedbackTool(server) {
   }));
 }
 
+// src/tools/shape.ts
+import { z as z29 } from "zod/v3";
+var SHAPE_ACTIONS = ["list", "show", "agree", "dismiss"];
+var LIST_DISPOSITIONS = ["pending", "agreed", "dismissed", "expired"];
+var LIST_OUTCOMES = ["not_candidate", "atomic", "compound", "unavailable"];
+var shapeSchema = z29.object({
+  action: z29.enum(SHAPE_ACTIONS).describe(
+    "'list': list shape advisories for this workspace, latest per subject. 'show': show one shape advisory by id. 'agree': agree with a compound advisory's split verdict. 'dismiss': dismiss a compound advisory's split verdict."
+  ),
+  disposition: z29.enum(LIST_DISPOSITIONS).optional().describe(
+    "For 'list': filter by disposition. Omitting both disposition and outcome defaults to the actionable set (disposition:pending, outcome:compound)."
+  ),
+  outcome: z29.enum(LIST_OUTCOMES).optional().describe(
+    "For 'list': filter by outcome. Omitting both disposition and outcome defaults to the actionable set (disposition:pending, outcome:compound)."
+  ),
+  limit: z29.number().min(1).max(200).optional().describe("For 'list': max rows (default 50, max 200)."),
+  rowId: z29.string().max(200).optional().describe("For 'show'/'agree'/'dismiss': the advisory row id."),
+  reason: z29.string().max(1e3).optional().describe("For 'agree'/'dismiss': optional reason (capped at 1000 chars).")
+});
+var shapeListVariant = z29.object({
+  action: z29.literal("list"),
+  disposition: z29.enum(LIST_DISPOSITIONS).optional(),
+  outcome: z29.enum(LIST_OUTCOMES).optional(),
+  limit: z29.number().min(1).max(200).optional()
+});
+var shapeShowVariant = z29.object({ action: z29.literal("show"), rowId: z29.string().max(200) });
+var shapeAgreeVariant = z29.object({ action: z29.literal("agree"), rowId: z29.string().max(200), reason: z29.string().max(1e3).optional() });
+var shapeDismissVariant = z29.object({ action: z29.literal("dismiss"), rowId: z29.string().max(200), reason: z29.string().max(1e3).optional() });
+var shapeActionUnion = z29.discriminatedUnion("action", [
+  shapeListVariant,
+  shapeShowVariant,
+  shapeAgreeVariant,
+  shapeDismissVariant
+]);
+var SHAPE_ACTION_SPECS = {
+  list: { params: ["disposition", "outcome", "limit"], description: "All params optional; no filters defaults to disposition:pending + outcome:compound." },
+  show: { params: ["rowId"], description: "rowId is required." },
+  agree: { params: ["rowId", "reason"], description: "rowId is required; reason is optional." },
+  dismiss: { params: ["rowId", "reason"], description: "rowId is required; reason is optional." }
+};
+async function handleShapeList(disposition, outcome, limit) {
+  const noFiltersGiven = disposition === void 0 && outcome === void 0;
+  const effectiveDisposition = disposition ?? (noFiltersGiven ? "pending" : void 0);
+  const effectiveOutcome = outcome ?? (noFiltersGiven ? "compound" : void 0);
+  const items = await kernelQuery("chain.shapeAdvisories", {
+    ...effectiveDisposition ? { disposition: effectiveDisposition } : {},
+    ...effectiveOutcome ? { outcome: effectiveOutcome } : {},
+    ...limit ? { limit } : {}
+  });
+  if (items.length === 0) {
+    return successResult("No shape advisories match.", "No shape advisories found.", { items: [], count: 0 });
+  }
+  const lines = ["# Shape Advisories", ""];
+  for (const item of items) {
+    const verdict = item.outcome === "unavailable" && item.unavailableReason ? `unavailable(${item.unavailableReason})` : item.outcome;
+    lines.push(`- \`${item.id}\` \u2014 ${item.subjectEntryId} \xB7 ${verdict} \xB7 disposition:${item.disposition} \xB7 ${item.source}`);
+  }
+  return successResult(
+    lines.join("\n"),
+    `Found ${items.length} shape advisor${items.length === 1 ? "y" : "ies"}.`,
+    { items, count: items.length },
+    [{ tool: "shape", description: "Show one advisory in full", parameters: { action: "show", rowId: items[0].id } }]
+  );
+}
+function renderShapeAdvisoryText(item) {
+  const lines = [
+    `# ${item.id}`,
+    `- Subject: ${item.subjectEntryId} (${item.collectionSlug})`,
+    `- Outcome: ${item.outcome}`,
+    `- Disposition: ${item.disposition}`,
+    `- Source: ${item.source}`
+  ];
+  if (item.proposedAtoms?.length) {
+    lines.push("", `Proposed split (${item.proposedAtoms.length} atom(s)):`);
+    item.proposedAtoms.forEach((atom, idx) => {
+      lines.push(`  [${idx}] ${atom.title} \u2014 ${atom.concern}`);
+      lines.push(`      "${atom.bodyExcerpt}"`);
+      if (atom.suggestedCollection) lines.push(`      suggested collection: ${atom.suggestedCollection}`);
+    });
+  }
+  if (item.proposedLinks?.length) {
+    lines.push("", "Proposed links:");
+    for (const link of item.proposedLinks) {
+      const from = link.fromIdx === -1 ? "original" : `[${link.fromIdx}]`;
+      lines.push(`  ${from} --${link.relation}--> [${link.toIdx}]`);
+    }
+  }
+  if (item.dispositionReason) lines.push("", `- Disposition reason: ${item.dispositionReason}`);
+  return lines.join("\n");
+}
+async function handleShapeShow(rowId) {
+  const item = await kernelQuery("chain.showShapeAdvisory", { rowId });
+  if (!item) {
+    return failureResult(
+      `Advisory '${rowId}' not found (missing, or belongs to a different workspace).`,
+      "NOT_FOUND",
+      `Advisory '${rowId}' not found.`,
+      "Use action=list to find valid ids.",
+      [{ tool: "shape", description: "List advisories", parameters: { action: "list" } }]
+    );
+  }
+  return successResult(
+    renderShapeAdvisoryText(item),
+    `Advisory ${item.id}: ${item.outcome}, disposition:${item.disposition}.`,
+    item
+  );
+}
+async function handleShapeDisposition(disposition, rowId, reason) {
+  requireWriteAccess();
+  try {
+    const result2 = await kernelMutation("chain.dispositionShapeAdvisory", {
+      rowId,
+      disposition,
+      ...reason ? { dispositionReason: reason } : {}
+    });
+    return successResult(
+      `Advisory ${result2.rowId} dispositioned: ${result2.disposition}.`,
+      `Advisory dispositioned: ${result2.disposition}.`,
+      result2
+    );
+  } catch (err) {
+    const classified = classifyError(err);
+    const isNotFound = classified.code === "NOT_FOUND";
+    return failureResult(
+      classified.message,
+      classified.code,
+      classified.message,
+      isNotFound ? "Use action=list to find valid ids." : classified.recovery ?? "Use action=show to check the advisory's current outcome/disposition.",
+      isNotFound ? [{ tool: "shape", description: "List advisories", parameters: { action: "list" } }] : classified.availableActions ?? [{ tool: "shape", description: "Show the advisory", parameters: { action: "show", rowId } }],
+      classified.diagnostics
+    );
+  }
+}
+function registerShapeTools(server) {
+  const shapeHandlers = {
+    list: (data) => handleShapeList(data.disposition, data.outcome, data.limit),
+    show: (data) => handleShapeShow(data.rowId),
+    agree: (data) => handleShapeDisposition("agreed", data.rowId, data.reason),
+    dismiss: (data) => handleShapeDisposition("dismissed", data.rowId, data.reason)
+  };
+  server.registerTool(
+    "shape",
+    {
+      title: "Shape",
+      description: "Review and disposition shape-advisory (single-concern split) suggestions for this workspace. Four actions:\n\n- **list**: List shape advisories, latest per subject (filter by disposition/outcome).\n- **show**: Show one shape advisory in full by id.\n- **agree**: Agree with a compound advisory's split verdict.\n- **dismiss**: Dismiss a compound advisory's split verdict.",
+      inputSchema: shapeSchema,
+      // Mixed read/write noun (§3 R3, same as workspace's proposals-respond): agree/dismiss write;
+      // list/show read.
+      annotations: { readOnlyHint: false, idempotentHint: false, openWorldHint: false }
+    },
+    thinWrapper(async (args) => {
+      const parsed = parseOrFail(shapeSchema, args);
+      if (!parsed.ok) return parsed.result;
+      const { action } = parsed.data;
+      return runWithToolContext(
+        { tool: "shape", action },
+        () => dispatchDiscriminated("shape", shapeActionUnion, parsed.data, SHAPE_ACTION_SPECS, shapeHandlers)
+      );
+    })
+  );
+}
+
 // src/resources/index.ts
 import { existsSync as existsSync3 } from "fs";
 import { dirname, join, resolve as resolve4 } from "path";
@@ -14715,7 +14877,7 @@ import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
 // src/resources/agentCheatsheet.ts
 var AGENT_CHEATSHEET = `# Product Brain \u2014 Agent Cheatsheet
 
-## Core Tools (Serves 11 default compound tools; 3 more (chain, chain-review, map) behind PB_MODULES=gitchain)
+## Core Tools (Serves 12 default compound tools; 3 more (chain, chain-review, map) behind PB_MODULES=gitchain)
 | Tool | Purpose | Key params |
 |---|---|---|
 | \`orient\` | Workspace context, governance, active bets, session start | \`action\`: start, task, record-activation |
@@ -14729,6 +14891,7 @@ var AGENT_CHEATSHEET = `# Product Brain \u2014 Agent Cheatsheet
 | \`workflows\` | Run workflows, checkpoint, load a skill | \`action\`: list, start, checkpoint, get-run, load-skill |
 | \`workspace\` | Check / whoami / status / self-test, usage, governance proposals | \`action\`: check, whoami, status, audit, self-test, usage, proposals-* |
 | \`feedback\` | Submit product feedback (any key, no session required); \`list\` reads back your own workspace's feedback (no gate); vendor triage: queue / note / group / status | \`action\`: submit, list, queue, note, group, status |
+| \`shape\` | Review / disposition write-shape (single-concern split) advisories | \`action\`: list, show, agree, dismiss |
 
 ## Collection Prefixes
 GLO (glossary), BR (business-rules), PRI (principles), STD (standards),
@@ -15226,12 +15389,12 @@ ${entry.labels.map((l) => `- ${l.name ?? l.slug}`).join("\n")}`);
 }
 
 // src/prompts/index.ts
-import { z as z29 } from "zod/v3";
+import { z as z30 } from "zod/v3";
 function registerPrompts(server) {
   server.prompt(
     "review-against-rules",
     "Review code or a design decision against all business rules for a given domain. Fetches the rules and asks you to do a structured compliance review.",
-    { domain: z29.string().describe("Business rule domain (e.g. 'Identity & Access', 'Governance & Decision-Making')") },
+    { domain: z30.string().describe("Business rule domain (e.g. 'Identity & Access', 'Governance & Decision-Making')") },
     async ({ domain }) => {
       const entries = await kernelQuery("chain.listEntries", { collectionSlug: "business-rules" });
       const rules = entries.filter((e) => e.data?.domain === domain);
@@ -15284,7 +15447,7 @@ Provide a structured review with a compliance status for each rule (COMPLIANT /
   server.prompt(
     "name-check",
     "Check variable names, field names, or API names against the glossary for terminology alignment. Flags drift from canonical terms.",
-    { names: z29.string().describe("Comma-separated list of names to check (e.g. 'vendor_id, compliance_level, formulator_type')") },
+    { names: z30.string().describe("Comma-separated list of names to check (e.g. 'vendor_id, compliance_level, formulator_type')") },
     async ({ names }) => {
       const terms = await kernelQuery("chain.listEntries", { collectionSlug: "glossary" });
       const glossaryContext = terms.map(
@@ -15320,7 +15483,7 @@ Format as a table: Name | Status | Canonical Form | Action Needed`
   server.prompt(
     "draft-decision-record",
     "Draft a structured decision record from a description of what was decided. Includes context from recent decisions and relevant rules.",
-    { context: z29.string().describe("Description of the decision (e.g. 'We decided to use MRSL v3.1 as the conformance baseline because...')") },
+    { context: z30.string().describe("Description of the decision (e.g. 'We decided to use MRSL v3.1 as the conformance baseline because...')") },
     async ({ context }) => {
       const recentDecisions = await kernelQuery("chain.listEntries", { collectionSlug: "decisions" });
       const sorted = [...recentDecisions].sort((a, b) => (b.data?.date ?? "") > (a.data?.date ?? "") ? 1 : -1).slice(0, 5);
@@ -15358,8 +15521,8 @@ After drafting, I can log it using the capture tool with collection "decisions".
     "draft-rule-from-context",
     "Draft a new business rule from an observation or discovery made while coding. Fetches existing rules for the domain to ensure consistency.",
     {
-      observation: z29.string().describe("What you observed or discovered (e.g. 'Suppliers can have multiple org types in Gateway')"),
-      domain: z29.string().describe("Which domain this rule belongs to (e.g. 'Governance & Decision-Making')")
+      observation: z30.string().describe("What you observed or discovered (e.g. 'Suppliers can have multiple org types in Gateway')"),
+      domain: z30.string().describe("Which domain this rule belongs to (e.g. 'Governance & Decision-Making')")
     },
     async ({ observation, domain }) => {
       const allRules = await kernelQuery("chain.listEntries", { collectionSlug: "business-rules" });
@@ -15425,7 +15588,7 @@ var INSTRUCTIONS = [
   "- **Self-documenting**: orient and server instructions teach agents how PB works. Cursor rules supplement but don't replace.",
   "",
   "### Tool Rename Notice (WP-484 S3, one release)",
-  "Serves 11 default compound tools; 3 more (chain, chain-review, map) behind PB_MODULES=gitchain.",
+  "Serves 12 default compound tools (WP-559 adds `shape` \u2014 review/disposition for write-shape advisories); 3 more (chain, chain-review, map) behind PB_MODULES=gitchain.",
   "Old standalone names are gone \u2014 no alias window (ASM-43: zero external consumers). Map: `start_pb`\u2192`orient action=start`, `record_activation`\u2192`orient action=record-activation`, `session-wrapup`\u2192`session action=wrapup-review|wrapup-commit`, `facilitate`\u2192`session action=resume|commit-constellation`, `update-entry`\u2192`entries action=update`, `commit-entry`\u2192`entries action=commit`, `get-history`\u2192`entries action=history`, `move-entry`\u2192`entries action=move`, `verify-entry`\u2192`entries action=verify`, `graph`\u2192`relations action=find|suggest`, `documents`\u2192`context action=last-verified-brief`, `labels`\u2192`collections action=label-*`, `verify`\u2192`quality action=verify-chain`, `audit`\u2192`quality action=audit`, `health`\u2192`workspace action=check|whoami|status|self-test`, `get-usage-summary`\u2192`workspace action=usage`, `governance-proposals`\u2192`workspace action=proposals-*`, `skills`\u2192`workflows action=load-skill`, `chain-version`\u2192`chain action=version.*`, `chain-branch`\u2192`chain-review action=branch.*`, `create-audience-map-set`/`map-slot`/`map-version`/`map-suggest`\u2192`map action=create-audience-set|slot.*|version.*|suggest`.",
   "",
   "## Your Workspace Principles",
@@ -15494,6 +15657,7 @@ function createProductBrainServer() {
   registerWorkflowTools(server);
   registerWorkspaceTools(server);
   registerFeedbackTool(server);
+  registerShapeTools(server);
   if (enabledModules.has("gitchain")) registerGitChainTools(server);
   if (enabledModules.has("gitchain")) registerMapTools(server);
   registerResources(server);
@@ -15634,4 +15798,4 @@ export {
   createProductBrainServer,
   initFeatureFlags
 };
-//# sourceMappingURL=chunk-WXBZFMDB.js.map
+//# sourceMappingURL=chunk-AWDYYGKN.js.map