@productbrain/mcp 0.0.1-beta.5543 → 0.0.1-beta.5561

package/dist/{chunk-P4YFJRPQ.js → chunk-Y2JXPTBG.js}

@@ -802,7 +802,8 @@ var FIELD_TYPE_DEFAULTS = {
   "array": [],
   "json": null,
   "date": null,
-  "person": null
+  "person": null,
+  "role": null
 };
 
 // src/lib/formatFieldGuidance.ts
@@ -15334,6 +15335,9 @@ function stripControlChars(str) {
   if (!str) return str;
   return str.replace(ANSI_AND_CONTROL_RE2, "");
 }
+function sanitizeSingleLineField(str) {
+  return stripControlChars(str).replace(/\s+/g, " ").trim();
+}
 
 // src/tools/question.ts
 var QUESTION_ACTIONS = ["create", "adopt", "assign", "snooze", "decline", "answer", "force-close", "list"];
@@ -15598,6 +15602,93 @@ function registerQuestionTools(server) {
   );
 }
 
+// src/tools/role.ts
+import { z as z34 } from "zod/v3";
+var ROLE_ACTIONS = ["accountable"];
+var roleSchema = z34.object({
+  action: z34.enum(ROLE_ACTIONS).describe("'accountable': what this role owns (explicit), reports on (reporting), and \u2014 not yet computed \u2014 inherits via Team-Lead vacancy coverage."),
+  roleId: z34.string().max(200).optional().describe("The role, by the human chain id `chain.getEntry` or `pb get` would print for it, or a raw entry id. Required for 'accountable'."),
+  canonicalKey: z34.string().max(200).optional().describe("'accountable': narrow to one kind (e.g. objective, key_result, tension)."),
+  limit: z34.number().int().positive().max(200).optional().describe("'accountable': max explicit-list rows per page (default and maximum 200)."),
+  cursor: z34.number().optional().describe("'accountable': continue the explicit list from an earlier truncated page's nextCursor.")
+});
+var accountableVariant = z34.object({
+  action: z34.literal("accountable"),
+  roleId: z34.string().max(200),
+  canonicalKey: z34.string().max(200).optional(),
+  limit: z34.number().int().positive().max(200).optional(),
+  cursor: z34.number().optional()
+});
+var roleActionUnion = z34.discriminatedUnion("action", [accountableVariant]);
+var ROLE_ACTION_SPECS = {
+  accountable: { params: ["roleId", "canonicalKey", "limit", "cursor"], description: "roleId is required; canonicalKey/limit/cursor are optional." }
+};
+function formatRow(row) {
+  const id = row.entryId ?? row.id;
+  return `    ${id}  ${sanitizeSingleLineField(row.name)}  [${row.canonicalKey ?? "?"}/${row.status}]`;
+}
+function formatSection(label, rows, truncated, cursorHint) {
+  if (rows.length === 0) return [`  ${label}: not recorded yet`];
+  const lines = [`  ${label}:`, ...rows.map(formatRow)];
+  if (truncated) lines.push(`    (more exist \u2014 ${cursorHint ?? "raise limit (capped at 200, no cursor for this list)"})`);
+  return lines;
+}
+function formatRoleAccountable(result2) {
+  const roleLabel = `${sanitizeSingleLineField(result2.role.name)} (${result2.role.entryId ?? result2.role.id})`;
+  const explicitCursorHint = result2.nextCursor !== null ? `raise limit or continue with cursor ${result2.nextCursor}` : "raise limit";
+  return [
+    `${roleLabel} \u2014 accountability:`,
+    ...formatSection("explicit (owns)", result2.explicit, result2.explicitTruncated, explicitCursorHint),
+    ...formatSection("reporting (reports on)", result2.reporting, result2.reportingTruncated),
+    `  inherited: not-computed \u2014 ${result2.inheritedNotComputedReason}`
+  ].join("\n");
+}
+async function handleRoleAccountable(roleId, canonicalKey, limit, cursor) {
+  try {
+    const raw = await kernelQuery("chain.listByRole", { roleId, canonicalKey, limit, cursor });
+    const result2 = raw;
+    const message = formatRoleAccountable(result2);
+    return successResult(message, message, result2);
+  } catch (err) {
+    return roleErrorResult(err, "accountable", { roleId, canonicalKey, limit, cursor });
+  }
+}
+function roleErrorResult(err, action, params = {}) {
+  const classified = classifyError(err);
+  const definedParams = Object.fromEntries(Object.entries(params).filter(([, v]) => v !== void 0));
+  return failureResult(
+    classified.message,
+    classified.code,
+    classified.message,
+    classified.recovery ?? "Use action='accountable' with roleId set to a real role's chain id or entry id.",
+    classified.availableActions ?? [{ tool: "role", description: `Retry ${action}`, parameters: { action, ...definedParams } }],
+    classified.diagnostics
+  );
+}
+function registerRoleTools(server) {
+  const roleHandlers = {
+    accountable: (data) => handleRoleAccountable(data.roleId, data.canonicalKey, data.limit, data.cursor)
+  };
+  server.registerTool(
+    "role",
+    {
+      title: "Role",
+      description: "Workspace roles \u2014 who is accountable for what. One action:\n\n- **accountable**: what this role owns (`explicit`, data.ownerRoleId), reports on (`reporting`, data.reporterRoleId \u2014 key results and tensions only, a separate fact from ownership), and \u2014 always `not-computed` today, never faked as empty \u2014 inherits via Team-Lead vacancy coverage.",
+      inputSchema: roleSchema,
+      annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false }
+    },
+    thinWrapper(async (args) => {
+      const parsed = parseOrFail(roleSchema, args);
+      if (!parsed.ok) return parsed.result;
+      const { action } = parsed.data;
+      return runWithToolContext(
+        { tool: "role", action },
+        () => dispatchDiscriminated("role", roleActionUnion, parsed.data, ROLE_ACTION_SPECS, roleHandlers)
+      );
+    })
+  );
+}
+
 // src/resources/index.ts
 import { existsSync as existsSync3 } from "fs";
 import { dirname, join, resolve as resolve4 } from "path";
@@ -15607,7 +15698,7 @@ import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
 // src/resources/agentCheatsheet.ts
 var AGENT_CHEATSHEET = `# Product Brain \u2014 Agent Cheatsheet
 
-## Core Tools (Serves 13 default compound tools; 2 more (chain, chain-review) behind PB_MODULES=gitchain \u2014 map retired, L29)
+## Core Tools (Serves 14 default compound tools; 2 more (chain, chain-review) behind PB_MODULES=gitchain \u2014 map retired, L29)
 | Tool | Purpose | Key params |
 |---|---|---|
 | \`orient\` | Workspace context, governance, active work packages, session start | \`action\`: start, task, record-activation |
@@ -15623,6 +15714,7 @@ var AGENT_CHEATSHEET = `# Product Brain \u2014 Agent Cheatsheet
 | \`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 |
 | \`question\` | Routed questions \u2014 create/adopt, own, snooze, decline, answer, force-close | \`action\`: create, adopt, assign, snooze, decline, answer, force-close |
+| \`role\` | What a role is accountable for \u2014 owns, reports on, and (not yet computed) inherits via Team-Lead vacancy coverage | \`action\`: accountable |
 
 ## Collection Prefixes
 GLO (glossary), BR (business-rules), PRI (principles), STD (standards),
@@ -16109,12 +16201,12 @@ ${entry.labels.map((l) => `- ${l.name ?? l.slug}`).join("\n")}`);
 }
 
 // src/prompts/index.ts
-import { z as z34 } from "zod/v3";
+import { z as z35 } 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: z34.string().describe("Business rule domain (e.g. 'Identity & Access', 'Governance & Decision-Making')") },
+    { domain: z35.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);
@@ -16167,7 +16259,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: z34.string().describe("Comma-separated list of names to check (e.g. 'vendor_id, compliance_level, formulator_type')") },
+    { names: z35.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(
@@ -16203,7 +16295,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: z34.string().describe("Description of the decision (e.g. 'We decided to use MRSL v3.1 as the conformance baseline because...')") },
+    { context: z35.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);
@@ -16241,8 +16333,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: z34.string().describe("What you observed or discovered (e.g. 'Suppliers can have multiple org types in Gateway')"),
-      domain: z34.string().describe("Which domain this rule belongs to (e.g. 'Governance & Decision-Making')")
+      observation: z35.string().describe("What you observed or discovered (e.g. 'Suppliers can have multiple org types in Gateway')"),
+      domain: z35.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" });
@@ -16308,7 +16400,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 13 default compound tools (WP-559 adds `shape` \u2014 review/disposition for write-shape advisories; WP-638 S3 adds `question` \u2014 routed-question routing/ownership/lifecycle); 2 more (chain, chain-review) behind PB_MODULES=gitchain.",
+  "Serves 14 default compound tools (WP-559 adds `shape` \u2014 review/disposition for write-shape advisories; WP-638 S3 adds `question` \u2014 routed-question routing/ownership/lifecycle; WP-730 S2 adds `role` \u2014 role accountability); 2 more (chain, chain-review) 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.*`.",
   "",
   "## Your Workspace Principles",
@@ -16380,6 +16472,7 @@ function createProductBrainServer() {
   registerFeedbackTool(server);
   registerShapeTools(server);
   registerQuestionTools(server);
+  registerRoleTools(server);
   if (enabledModules.has("gitchain")) registerGitChainTools(server);
   registerResources(server);
   registerPrompts(server);
@@ -16519,4 +16612,4 @@ export {
   createProductBrainServer,
   initFeatureFlags
 };
-//# sourceMappingURL=chunk-P4YFJRPQ.js.map
+//# sourceMappingURL=chunk-Y2JXPTBG.js.map