@productbrain/mcp 0.0.1-beta.8633 → 0.0.1-beta.8643

package/dist/{chunk-LDWP3UNV.js → chunk-LJBOAIFJ.js}

@@ -38,7 +38,7 @@ import {
   trackQualityVerdict,
   trackSessionCaptureRate,
   trackZeroCaptureAuditFired
-} from "./chunk-66OMK2AA.js";
+} from "./chunk-FZWP45AU.js";
 
 // src/server.ts
 import { McpServer as McpServer2 } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -7613,6 +7613,65 @@ function formatRuleListsLines(ruleLists) {
   if (lines.length === 0 && ruleLists.unassigned === 0 && !ruleLists.truncated) return [];
   return [...lines, ...formatRuleListTrailers(ruleLists)];
 }
+var BRIEFING_PULL_COMMANDS = {
+  cli: 'pb orient --task "<what you are doing>" \xB7 pb get <ID> \xB7 pb search <query>',
+  mcp: 'orient task="<what you are doing>" \xB7 entries action=get entryId=<ID> \xB7 entries action=search query=<query>'
+};
+var BRIEFING_ANSWER_COMMANDS = {
+  cli: 'pb question answer <ID> "<answer>"',
+  mcp: 'question action=answer entryId=<ID> text="<answer>"'
+};
+var BRIEFING_QUESTION_DETAIL_COMMANDS = {
+  cli: "pb question list",
+  mcp: "question action=list"
+};
+var BRIEFING_QUESTION_MAX_CHARS = 160;
+function briefingLine(value, max) {
+  const line = sanitizeRuleListField(value);
+  if (max === void 0 || Array.from(line).length <= max) return line;
+  const cut = Array.from(line).slice(0, max).join("");
+  return `${(cut.replace(/\s+\S*$/, "") || cut).trimEnd()}\u2026`;
+}
+function idTag(entryId) {
+  return entryId ? ` (${sanitizeRuleListField(entryId)})` : "";
+}
+function formatBriefingLines(view) {
+  const lines = [];
+  const f = view.facts ?? {};
+  if (view.workspaceName) lines.push(`Workspace: ${briefingLine(view.workspaceName)}${view.actingRole ? ` \u2014 acting as ${briefingLine(view.actingRole)}` : ""}`);
+  if (f.purpose) lines.push(`Purpose: ${briefingLine(f.purpose)}`);
+  if (f.vision) lines.push(`Vision: ${briefingLine(f.vision)}`);
+  if (f.strategy) {
+    lines.push(`Strategy${idTag(f.strategy.entryId)}: ${briefingLine(f.strategy.name)}`);
+    if (f.strategy.notDo) lines.push(`  Not doing: ${briefingLine(f.strategy.notDo)}`);
+  }
+  if (f.objective) {
+    lines.push(`Objective${idTag(f.objective.entryId)}: ${briefingLine(f.objective.name)}`);
+    for (const kr of f.objective.keyResults) {
+      const current = kr.readingUnresolved ? "unresolved (too many corrections to read)" : kr.currentValue ?? "n/a";
+      const value = `${current} / ${kr.targetValue ?? "n/a"}`;
+      lines.push(`  - ${briefingLine(kr.name)}: ${value}`);
+    }
+  }
+  if (f.currentWorkPackage) lines.push(`Current work package${idTag(f.currentWorkPackage.entryId)}: ${briefingLine(f.currentWorkPackage.name)}`);
+  if (f.briefingUnavailable) lines.push("Purpose, vision, strategy, objective and work package: unavailable \u2014 the briefing read failed; orient again to retry.");
+  if (f.spineUnavailable) lines.push("Objective: unavailable \u2014 the objectives read failed; orient again to retry.");
+  if (f.truncated) lines.push("(A bounded read hit its cap: a fact above may be missing or not the current one.)");
+  const ruleLines = formatRuleListsLines(view.ruleLists);
+  if (ruleLines.length > 0) lines.push("", "Rules:", ...ruleLines);
+  const questions = view.openQuestions ?? [];
+  if (questions.length > 0) {
+    lines.push("", `Open questions (${questions.length}) \u2014 they need you before you continue; answer with ${BRIEFING_ANSWER_COMMANDS[view.surface]}:`);
+    for (const q of questions) {
+      const age = q.ageDays !== void 0 ? ` (${q.ageDays}d)` : "";
+      lines.push(`  - ${sanitizeRuleListField(q.entryId)} \u2014 ${briefingLine(q.title, BRIEFING_QUESTION_MAX_CHARS)}${age}`);
+    }
+    if (view.openQuestionsTruncated) lines.push("  (This list may be incomplete: you may have more open questions than shown.)");
+    lines.push(`  Asker, why you, what waits on it and what you may do: ${BRIEFING_QUESTION_DETAIL_COMMANDS[view.surface]}`);
+  }
+  lines.push("", `Pull more: ${BRIEFING_PULL_COMMANDS[view.surface]}`);
+  return lines;
+}
 
 // src/tools/orient-rituals.ts
 var RULE_LISTS_EVERYONE_ONLY_LABEL = "Rules (everyone list only; run `orient mode=full` for your team and role lists):";
@@ -12040,12 +12099,19 @@ async function handleStart2(data) {
     lines.push(`Acting as role: ${result2.roleName ?? result2.roleEntryId}.`);
   }
   lines.push(FEEDBACK_SUBMIT_HINT);
-  const noticeLines = formatNoticeLines(result2.notices);
-  if (noticeLines.length > 0) {
-    lines.push("", "Notices:", ...noticeLines);
-  }
-  const ruleLines = formatRuleListsLines(result2.ruleLists);
-  if (ruleLines.length > 0) lines.push("", "Rules:", ...ruleLines);
+  const questionNotice = result2.notices?.find((n) => n.source === QUESTION_ACK_GATE_SOURCE_ID);
+  const noticeLines = formatNoticeLines(result2.notices?.filter((n) => n !== questionNotice));
+  if (noticeLines.length > 0) lines.push("", "Notices:", ...noticeLines);
+  const openQuestions = (questionNotice?.payload?.questions ?? []).map((q) => ({ entryId: q.sourcePointer, title: q.name, ageDays: q.ageDays }));
+  lines.push("", ...formatBriefingLines({
+    workspaceName: result2.workspaceName,
+    actingRole: result2.roleName,
+    facts: result2.briefing,
+    ruleLists: result2.ruleLists,
+    openQuestions,
+    openQuestionsTruncated: questionNotice?.payload?.truncated === true,
+    surface: "mcp"
+  }));
   const summary = `Session ${result2.sessionId} active. Workspace ${result2.workspaceName}. Orient with a task first; workflow checkpoints and organisation-structure writes still require it.`;
   return {
     content: [{ type: "text", text: lines.join("\n") }],
@@ -12059,8 +12125,10 @@ async function handleStart2(data) {
       feedbackQueueNew: result2.feedbackQueueNew,
       feedbackOldestNewAt: result2.feedbackOldestNewAt,
       notices: result2.notices ?? [],
-      ruleLists: result2.ruleLists
+      ruleLists: result2.ruleLists,
       // TASK-436
+      briefing: result2.briefing
+      // TASK-552
       // Finding #16: bare `parameters: {}` lets orient's schema default kick in
       // (action defaults to "task", which requires a `task` string) — the suggested
       // next-action call failed validation instead of running. `action: "start"` is
@@ -13731,7 +13799,7 @@ var ALLOWED_RELATION_TYPES_LIST = [
 var ALLOWED_RELATION_TYPES = new Set(ALLOWED_RELATION_TYPES_LIST);
 
 // src/resources/agentCheatsheet.ts
-var DATA_HANDLING_SECTION = "### How PB Handles Your Data\n- **The reply is the source of truth**: every reply carries `ok`; on failure it carries `code` and guidance. Read the reply, never an expectation.\n- **Empty-workspace safe**: the orientation resource and this cheatsheet render on a workspace with no entries and no collections.\n- **Workspace-agnostic**: PB is one product used by many teams. Nothing in these instructions is specific to your workspace; your own principles, standards and rules arrive through `productbrain://orientation`.\n- **Served, not installed**: these instructions, `productbrain://orientation` and `productbrain://agent-cheatsheet` are served over MCP.";
+var DATA_HANDLING_SECTION = "### How PB Handles Your Data\n- **The reply is the source of truth**: every reply carries `ok`; on failure it carries `code` and guidance. Read the reply, never an expectation.\n- **Empty-workspace safe**: the orientation resource and this cheatsheet render on a workspace with no entries and no collections.\n- **Workspace-agnostic**: PB is one product used by many teams. Nothing in these instructions is specific to your workspace; your own rules arrive as the rule lists that session start and orient serve you.\n- **Served, not installed**: these instructions, `productbrain://orientation` and `productbrain://agent-cheatsheet` are served over MCP.";
 var AGENT_CHEATSHEET = `# Product Brain \u2014 Agent Cheatsheet
 
 ## Core Tools (Serves 15 compound tools, always)
@@ -13756,8 +13824,7 @@ var AGENT_CHEATSHEET = `# Product Brain \u2014 Agent Cheatsheet
 This table lists actions only. See \`tools/list\` for each tool's input schema; a missing or invalid parameter is named in the call's own reply.
 
 ## Collection Prefixes
-GLO (glossary), BR (business-rules), PRI (principles), STD (standards),
-DEC (decisions), STR (strategy), TEN (tensions), FEAT (features),
+GLO (glossary), RULE (rules), DEC (decisions), STR (strategy), TEN (tensions), FEAT (features),
 BET (bets), INS (insights), ARCH (architecture), TEAM (teams),
 ROL (roles), MTRC (tracking-events), ST (semantic-types)
 
@@ -13771,7 +13838,11 @@ Write via \`update\`: \`draft\` | \`archived\` (\`accepted\` via \`commit\`, nev
 - **tensions:** open \u2192 processing \u2192 decided \u2192 closed
 - **decisions:** pending \u2192 decided
 - **bets:** shaped \u2192 bet \u2192 building \u2192 shipped
-- **business-rules:** active | conflict | review
+
+## Rule Lists
+- Session start and \`orient action=task\` serve the rules that bind you, each as one sentence with its why.
+- A rule's \`applies\` and its one owner role place it on one list: everyone (cap 15), team (cap 5 per team) or role (cap 5 per role).
+- A rule on no list binds nobody; a full list refuses a new rule until one retires, and a list over its cap is served whole.
 
 ## Key Patterns
 - **Capture flow:** \`capture\` \u2192 \`relations action=suggest\` \u2192 \`relations action=batch-create\` \u2192 \`entries action=commit\`
@@ -14444,67 +14515,43 @@ Make sure the rule is consistent with existing rules and doesn't contradict them
 // src/server.ts
 var SERVER_VERSION = "0.7.2";
 var INSTRUCTIONS = [
-  "Product Brain \u2014 the single source of truth for product knowledge.",
-  "Terminology, standards, and core data all live here \u2014 no need to check external docs.",
-  "",
-  "## About Product Brain (PB)",
+  "Product Brain (PB) is the single source of truth for your team's product knowledge: decisions, tensions, rules, work and the links between them.",
   "",
-  "PB is a knowledge management system used by many product teams.",
-  "These describe how PB works \u2014 not your product.",
+  "## What session start hands you",
   "",
-  "### How PB Organizes Its Tools",
-  "- **Tools** are for actions with side-effects or dynamic computation (capture, accept, search).",
-  "- **Resources** are for stable, read-only data (orientation, terminology, collection schemas).",
-  "- **Prompts** are for multi-step choreography (workflows, guided capture, deep dives).",
-  "- Every tool, resource, and prompt works for ANY workspace \u2014 no bespoke logic.",
-  "- Resource templates (URI params) provide workspace-specific data through generic patterns.",
-  "- Tool count stays minimal: compound tools with `action` enums over many single-purpose tools.",
+  "Call `session action=start` first. The reply names:",
+  "- the workspace and the role you act as;",
+  "- notices, including open questions routed to you;",
+  "- the rule lists that bind you, each rule as one sentence with its why, its owner role and, when it has one, its date.",
   "",
-  DATA_HANDLING_SECTION,
+  "Read those rules before you propose or build. If the work conflicts with one, stop, name the rule and ask the user before going on. Never design around a rule.",
   "",
-  "## Your Workspace Principles",
+  "## What applies means",
   "",
-  "When you orient or start, PB surfaces active entries from your `principles`, `standards`,",
-  "and `business-rules` collections. These are YOUR team's guardrails \u2014 respect them during implementation.",
-  "If no principles exist yet, PB will tell you and suggest how to add them.",
+  "Every rule (collection `rules`) declares whom it applies to, and its one owner role places it:",
+  "- **everyone**: the whole workspace, owned by the root team's lead; capped at 15 rules;",
+  "- **team**: its owner role's team; capped at 5 per team;",
+  "- **role**: its owner role; capped at 5 per role.",
   "",
-  "The three governance collections:",
-  "- **Principles** (`principles`) \u2014 beliefs that guide decisions. 'We believe X.' You reason from a principle.",
-  "- **Standards** (`standards`) \u2014 conventions about how work is done. 'We do X this way.' You lint for a standard.",
-  "- **Business Rules** (`business-rules`) \u2014 system constraints. 'The system must do X.' You test for a rule.",
+  "A rule on no list binds nobody. A full list refuses a new rule until one retires; a list already over its cap is served whole.",
   "",
-  "## Workflow",
+  "## Pull the rest",
   "",
-  "  1. Start: call `session action=start` to open a tracked write session, then `orient action=start` \u2014 it returns a standup briefing for every workspace state, fresh or active. (`orient` orients the session; only `session action=start` creates one.)",
-  "  2. Re-orient: call `orient action=task` mid-session for task-scoped context or a compact status refresh.",
-  "  3. Discover: use `entries action=search` to find entries, or `entries action=list` to browse.",
-  '  4. Drill in: use `entries action=get entryId="..."` for full details \u2014 data, labels, relations, history.',
-  "  5. Context: use `context action=gather` with an entryId or a task description.",
-  "  6. Capture: use `capture` to create entries \u2014 auto-links and scores in one call.",
-  "  7. Accept: use `entries action=commit` to send a draft for acceptance \u2014 read the reply's outcome/status field for what happened; read the capture reply first, since an entry that came back accepted needs no commit.",
-  "  8. Connect: use `relations action=suggest` then `relations action=create` to build the graph.",
-  "  9. Wrapup: call `session action=wrapup-review` before closing \u2014 reviews drafts, coaches quality, suggests links.",
-  "  10. Close: call `session action=close` when done \u2014 records session activity. Auto-nudges if wrapup was skipped.",
+  '- `orient action=task task="<what you are doing>"`: context shaped to the task, with the rules for your team and role.',
+  '- `entries action=get entryId="<ID>"`: one entry in full, with data, relations and history.',
+  '- `entries action=search query="<noun>"`: find entries by what they are about.',
   "",
-  "Write tools (capture, entries action=update, relations, entries action=commit) require:",
-  "  - An active agent session \u2014 call `session action=start` first, then `orient action=start` for context. Call `orient action=task` mid-session for a refresh.",
-  "  - A readwrite API key scope",
+  "## Writing",
   "",
-  "Alignment-first: before proposing or building anything, check orient's Workspace Governance",
-  "and Active work packages sections. These are constraints, not reference material.",
-  "If the proposal conflicts with a principle, standard, or business rule \u2014 stop, flag the conflict,",
-  "and get explicit user confirmation before proceeding. Do not design around governance.",
-  "If the work is outside the scope of active work packages \u2014 stop, name the gap, and ask the user",
-  "to confirm before designing. Do not propose implementation for out-of-scope work without a go-ahead.",
+  "Write actions (capture, entries update and commit, relations create, batch-create, dismiss and delete) need an active session and a readwrite key.",
+  "Use `capture` to create an entry and read its reply: an entry that came back accepted needs no `entries action=commit`.",
+  "Link with `relations action=suggest`, then `relations action=create`.",
+  "Finish with `session action=wrapup-review`, then `session action=close`.",
+  "If the work falls outside the active work packages, name the gap and ask the user before designing it.",
   "",
-  "Workspace setup: use `collections action=update` to shape existing collections with the user.",
-  "Creating a brand-new collection is not self-serve \u2014 ask a platform admin to provision it, or",
-  "enable the module ontology pack that owns the drawer.",
+  DATA_HANDLING_SECTION,
   "",
-  "Personalization: if you have context about the user from memory (prior work, recent",
-  "conversations, team context), use it to personalize recommendations. For example,",
-  "'Based on your recent pitch reviews, the gap most likely to matter is X.'",
-  "The orient/start output gives you the workspace state; your memory fills in the human context."
+  "Every tool and action: `productbrain://agent-cheatsheet`."
 ].join("\n");
 function createProductBrainServer() {
   const server = new McpServer2(
@@ -14561,4 +14608,4 @@ export {
   createProductBrainServer,
   initFeatureFlags
 };
-//# sourceMappingURL=chunk-LDWP3UNV.js.map
+//# sourceMappingURL=chunk-LJBOAIFJ.js.map