@productbrain/mcp 0.0.1-beta.11701 → 0.0.1-beta.11709

package/dist/{chunk-CMRO7CUV.js → chunk-VW2VE3H6.js}

@@ -36,7 +36,7 @@ import {
   runWithToolContext,
   setSessionOriented,
   startAgentSession
-} from "./chunk-SFMHXRAR.js";
+} from "./chunk-H2SLL2NX.js";
 
 // src/server.ts
 import { McpServer as McpServer2 } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -2430,7 +2430,7 @@ var PRODUCT_NAME = "Product Brain";
 var PLATFORM_TERM_LABEL = "Platform";
 var PLATFORM_GLOSSARY_TERMS = [
   { name: "Team", definition: "A group of people and agents working toward one purpose; its roles own its decisions, rules and work." },
-  { name: "Team Lead", definition: "The role accountable for a team's purpose; it decides anything that belongs to a role nobody holds." },
+  { name: "Team Lead", definition: "The role accountable for a team's purpose; it holds every role in its team with no one seated, covering it." },
   { name: "Role", definition: "A named set of responsibilities a person holds; whoever sits in it decides and accepts the entries it owns." },
   { name: "Tension", definition: "A gap someone notices between how things are and how they should be; linking one to an entry is how you say you disagree with it." }
 ];
@@ -2744,7 +2744,7 @@ async function handleGet(entryId) {
   if (e.sourceExcerpt) lines.push(`**Source excerpt:** ${e.sourceExcerpt}`);
   const parsedOwner = parseOwnerOutput(e.owner);
   if (parsedOwner) lines.push(formatOwnerLine2(parsedOwner));
-  for (const line of [e.pendingMove, e.qualityOverride, e.spineLine]) if (typeof line === "string") lines.push(sanitizeSingleLineField(line));
+  for (const line of [e.heldLine, e.pendingMove, e.qualityOverride, e.spineLine]) if (typeof line === "string") lines.push(sanitizeSingleLineField(line));
   const restsOnChanged = Array.isArray(e.restsOnChanged) ? e.restsOnChanged : [];
   for (const item of restsOnChanged) lines.push(sanitizeSingleLineField(restsOnLine(item)));
   if (epistemic) lines.push(formatEpistemicLine(epistemic));
@@ -2793,7 +2793,9 @@ async function handleGet(entryId) {
     ...e.sourceExcerpt ? { sourceExcerpt: String(e.sourceExcerpt) } : {},
     ...parsedOwner ? { owner: parsedOwner } : {},
     // TASK-954, TASK-1027: the kernel's lines as served
-    ...Object.fromEntries(["pendingMove", "qualityOverride", "spineLine"].filter((k) => typeof e[k] === "string").map((k) => [k, e[k]])),
+    ...Object.fromEntries(["heldLine", "pendingMove", "qualityOverride", "spineLine"].filter((k) => typeof e[k] === "string").map((k) => [k, e[k]])),
+    ...e.coveredBy !== void 0 ? { coveredBy: e.coveredBy } : {},
+    // DEC-2257: the Team Lead holding a role with no one seated
     ...restsOnChanged.length > 0 ? { restsOnChanged } : {},
     // TEN-2191: surface the WHY and its quality in the structured payload too.
     ...why.length > 0 ? { why } : {},
@@ -3644,7 +3646,8 @@ var ORGANISATION_VALIDATION_REFUSALS = /* @__PURE__ */ new Set([
   "move_not_needed",
   "no_pending_move",
   "why_required",
-  "role_unplaced"
+  "role_unplaced",
+  "role_work_target_invalid"
 ]);
 
 // src/tools/people.ts
@@ -4037,13 +4040,13 @@ function registerOutcomeTools(server) {
 
 // src/tools/role.ts
 import { z as z18 } from "zod/v3";
-var ROLE_ACTIONS = ["seat", "unseat", "release_move", "accept_move", "refuse_move"];
+var ROLE_ACTIONS = ["seat", "unseat", "release_move", "accept_move", "refuse_move", "move_work"];
 var ROLE_READS_MOVED = {
   accountable: "role only writes. Read what a role owns and who holds it with the read-only context tool: context action=accountable roleId=..."
 };
 var roleSchema = z18.object({
   action: actionEnum(ROLE_ACTIONS, ROLE_READS_MOVED).describe(
-    "'seat': put a person in this role. 'unseat': take this role from a person. 'release_move' / 'accept_move' / 'refuse_move': move a role or team to a team with another Team Lead."
+    "'seat': put a person in this role. 'unseat': take this role from a person. 'release_move' / 'accept_move' / 'refuse_move': move a role or team to a team with another Team Lead. 'move_work': move every open item a role owns to another role."
   ),
   roleId: z18.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."),
   person: z18.string().max(200).optional().describe(
@@ -4059,7 +4062,10 @@ var roleSchema = z18.object({
     "'seat', Team Lead only: as the team's Team Lead, seat a second Team Lead who holds the seat on your authority until you unseat them."
   ),
   childId: z18.string().max(200).optional().describe("'release_move' / 'accept_move' / 'refuse_move': the role or team that moves, by chain id or entry id."),
-  why: z18.string().max(1e3).optional().describe("'refuse_move': why the move is refused; it becomes a tension for the old team's Team Lead.")
+  why: z18.string().max(1e3).optional().describe("'refuse_move': why the move is refused; it becomes a tension for the old team's Team Lead."),
+  fromRoleId: z18.string().max(200).optional().describe("'move_work': the role whose open work moves, by chain id or entry id."),
+  toRoleId: z18.string().max(200).optional().describe("'move_work': the receiving role; without it, the nearest Team Lead of the old role's home team."),
+  dryRun: z18.boolean().optional().describe("'move_work': return the receipt and change nothing.")
 });
 var seatVariant = z18.object({
   action: z18.literal("seat"),
@@ -4078,12 +4084,14 @@ var unseatVariant = z18.object({
 var releaseMoveVariant = z18.object({ action: z18.literal("release_move"), childId: z18.string().max(200), teamId: z18.string().max(200) });
 var acceptMoveVariant = z18.object({ action: z18.literal("accept_move"), childId: z18.string().max(200) });
 var refuseMoveVariant = z18.object({ action: z18.literal("refuse_move"), childId: z18.string().max(200), why: z18.string().max(1e3) });
+var moveWorkVariant = z18.object({ action: z18.literal("move_work"), fromRoleId: z18.string().max(200), toRoleId: z18.string().max(200).optional(), dryRun: z18.boolean().optional() });
 var roleActionUnion = z18.discriminatedUnion("action", [
   seatVariant,
   unseatVariant,
   releaseMoveVariant,
   acceptMoveVariant,
-  refuseMoveVariant
+  refuseMoveVariant,
+  moveWorkVariant
 ]);
 var ROLE_ACTION_SPECS = {
   seat: {
@@ -4093,18 +4101,12 @@ var ROLE_ACTION_SPECS = {
   unseat: { params: ["roleId", "person", "teamId"], description: "roleId and person are required; teamId only for Team Lead." },
   release_move: { params: ["childId", "teamId"], description: "childId and teamId (the team it moves to) are required." },
   accept_move: { params: ["childId"], description: "childId is required." },
-  refuse_move: { params: ["childId", "why"], description: "childId and why are required." }
+  refuse_move: { params: ["childId", "why"], description: "childId and why are required." },
+  move_work: { params: ["fromRoleId", "toRoleId", "dryRun"], description: "fromRoleId is required; toRoleId and dryRun are optional." }
 };
-function formatHolders(result2) {
-  if (result2.holders.length === 0) return [`  holders: none${result2.holdersTruncated ? " found, but the membership scan is incomplete" : ""}`];
+function formatHeld(result2) {
   return [
-    "  holders:",
-    ...result2.holders.map((h) => {
-      const word = personStatusTag(h.status);
-      const tag = word ? ` (${word})` : "";
-      const team = h.teamName ? `  in ${sanitizeSingleLineField(h.teamName)}` : "";
-      return `    ${sanitizeSingleLineField(h.displayName)}${tag}${team}`;
-    }),
+    ...result2.heldLine ? [`  ${sanitizeSingleLineField(result2.heldLine)}`] : [],
     ...result2.holdersTruncated ? ["    (membership scan cut at 500 rows, more holders may exist)"] : []
   ];
 }
@@ -4125,10 +4127,9 @@ function formatRoleAccountable(result2) {
   const explicitCursorHint = result2.nextCursor !== null ? `raise limit or continue with cursor ${result2.nextCursor}` : "raise limit";
   return [
     `${roleLabel2} \u2014 accountability:`,
-    ...formatHolders(result2),
+    ...formatHeld(result2),
     ...formatSection("explicit (owns)", result2.explicit, result2.explicitTruncated, explicitCursorHint),
-    ...formatSection("reporting (reports on)", result2.reporting, result2.reportingTruncated),
-    `  inherited: not-computed \u2014 ${result2.inheritedNotComputedReason}`
+    ...formatSection("reporting (reports on)", result2.reporting, result2.reportingTruncated)
   ].join("\n");
 }
 async function handleRoleAccountable(roleId, canonicalKey, limit, cursor) {
@@ -4199,6 +4200,27 @@ async function handleMove(action, params) {
     return roleErrorResult(err, action, params);
   }
 }
+async function handleMoveWork(params) {
+  try {
+    requireWriteAccess();
+    const raw = await kernelMutation("organisation.setOwnership", {
+      fromRoleRef: params.fromRoleId,
+      roleRef: params.toRoleId,
+      ...params.dryRun ? { dryRun: true } : {},
+      sessionId: getAgentSessionId()
+    });
+    if (raw.outcome === "refused") {
+      const recovery = authorityRecovery(raw.refusal) ?? raw.refusal.requiredAction ?? "Ask the Team Lead the refusal names.";
+      const message2 = `Refused: ${sanitizeSingleLineField(raw.refusal.reason)} ${recovery}`;
+      const code = ORGANISATION_VALIDATION_REFUSALS.has(raw.refusal.code) ? "VALIDATION_ERROR" : "PERMISSION_DENIED";
+      return failureResult(message2, code, message2, recovery, void 0, raw);
+    }
+    const message = raw.text;
+    return successResult(message, message, raw);
+  } catch (err) {
+    return roleErrorResult(err, "move_work", params);
+  }
+}
 function roleErrorResult(err, action, params = {}) {
   const classified = classifyError(err);
   const definedParams = Object.fromEntries(Object.entries(params).filter(([, v]) => v !== void 0));
@@ -4218,13 +4240,14 @@ function registerRoleTools(server) {
     unseat: (data) => handleRoleUnseat(data.roleId, data.person, data.teamId),
     release_move: (data) => handleMove("release_move", data),
     accept_move: (data) => handleMove("accept_move", data),
-    refuse_move: (data) => handleMove("refuse_move", data)
+    refuse_move: (data) => handleMove("refuse_move", data),
+    move_work: (data) => handleMoveWork(data)
   };
   server.registerTool(
     "role",
     {
       title: "Role",
-      description: "Workspace roles \u2014 who holds a role and where it sits. Five actions:\n\n- **seat**: put a person in this role, by person id or email, or by `newPersonName` for someone with no login yet (a placeholder person, created once per exact name). The role's home team is used; name `teamId` only for Team Lead. A held role refuses a second holder and names the holder; the person keeps their other roles in the team. Needs the team's Team Lead. With `onMyAuthority`, the team's Team Lead seats a second Team Lead on their own authority; unseating them revokes it.\n- **unseat**: take this role from a person; their other roles in the team stay. The last active Team Lead of a team is refused. Invite a person, or take them out of a team, with the `people` tool.\n- **release_move** / **accept_move** / **refuse_move**: move a role or team (`childId`) to a team whose Team Lead is another seat. Acting as Team Lead of its current team, release it toward `teamId`; acting as Team Lead of that team, accept it, or refuse it with `why` (it stays, and a tension goes to its current team's Team Lead).\n\nRead what a role owns with `context action=accountable`.",
+      description: "Workspace roles \u2014 who holds a role, where it sits and what it owns. Six actions:\n\n- **seat**: put a person in this role, by person id or email, or by `newPersonName` for someone with no login yet (a placeholder person, created once per exact name). The role's home team is used; name `teamId` only for Team Lead. A held role refuses a second holder and names the holder; the person keeps their other roles in the team. Needs the team's Team Lead. With `onMyAuthority`, the team's Team Lead seats a second Team Lead on their own authority; unseating them revokes it.\n- **unseat**: take this role from a person; their other roles in the team stay. The last active Team Lead of a team is refused. Invite a person, or take them out of a team, with the `people` tool.\n- **release_move** / **accept_move** / **refuse_move**: move a role or team (`childId`) to a team whose Team Lead is another seat. Acting as Team Lead of its current team, release it toward `teamId`; acting as Team Lead of that team, accept it, or refuse it with `why` (it stays, and a tension goes to its current team's Team Lead).\n- **move_work**: move every open item `fromRoleId` owns (drafts, current entries, open questions) to `toRoleId`, each checked as a one-entry ownership change; an item the receiver may not own goes to the nearest Team Lead of the old role's home team, and past items stay as history. Each call moves a capped number and says how many remain; call again to finish. `dryRun` returns the receipt and changes nothing.\n\nRead what a role owns with `context action=accountable`.",
       inputSchema: roleSchema,
       // The hints describe the whole tool, so they say the most it can do: unseat removes a role and can
       // delete a membership row (destructive), and a repeated seat still writes history and audit rows
@@ -11848,4 +11871,4 @@ export {
   SERVER_VERSION,
   createProductBrainServer
 };
-//# sourceMappingURL=chunk-CMRO7CUV.js.map
+//# sourceMappingURL=chunk-VW2VE3H6.js.map