@productbrain/mcp 0.0.1-beta.8647 → 0.0.1-beta.8658

package/dist/{chunk-JSKIMDXR.js → chunk-WKSQMKMW.js}

@@ -7658,7 +7658,10 @@ function formatBriefingLines(view) {
   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 rl = view.ruleLists;
+  const ruleRows = rl ? rl.everyone.rows.length + (rl.team?.rows.length ?? 0) + rl.role.rows.length : 0;
+  if (ruleRows === 0 && view.rulesEmptyLine) lines.push("", view.rulesEmptyLine, ...ruleLines);
+  else 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]}:`);
@@ -13718,42 +13721,16 @@ Write via \`update\`: \`draft\` | \`archived\` (\`accepted\` via \`commit\`, nev
 `;
 
 // src/resources/orientationMarkdown.ts
-function buildOrientationMarkdown(collections, standards, businessRules, principles, directionLines) {
-  const sections = ["# Product Brain \u2014 Orientation"];
-  if (directionLines && directionLines.length > 0) {
-    sections.push(directionLines.join("\n"));
+function buildOrientationMarkdown(collections, briefingLines) {
+  if (briefingLines.length === 0) {
+    throw new Error("buildOrientationMarkdown: briefingLines is empty \u2014 pass the rendered briefing or the read-failed marker line");
   }
+  const sections = ["# Product Brain \u2014 Orientation", briefingLines.join("\n")];
   sections.push(
     "## About Product Brain (PB)\nPB is a knowledge management system used by many product teams. This section describes how PB works \u2014 not your product.\n\n### How PB Organizes Its Tools\n- **Tools** = actions with side-effects or dynamic computation (capture, accept, search).\n- **Resources** = stable, read-only data (orientation, terminology, collection schemas).\n- **Prompts** = multi-step choreography (workflows, guided capture, deep dives).\n- Every tool, resource, and prompt works for ANY workspace \u2014 no bespoke logic.\n- Resource templates (URI params) serve workspace-specific data through generic patterns.\n- Compound tools with `action` enums keep the tool count minimal.\n\n" + DATA_HANDLING_SECTION
   );
-  const wsRules = [];
-  for (const p of principles ?? []) {
-    wsRules.push({ id: p.entryId ?? "", name: p.name, severity: p.data?.severity ?? void 0, source: "principles" });
-  }
-  for (const s of standards ?? []) {
-    wsRules.push({ id: s.entryId ?? "", name: s.name, severity: s.data?.severity ?? void 0, source: "standards" });
-  }
-  for (const r of businessRules ?? []) {
-    wsRules.push({ id: r.entryId ?? "", name: r.name, severity: r.data?.severity ?? void 0, source: "rules" });
-  }
-  if (wsRules.length > 0) {
-    const ruleLines = wsRules.map((r) => {
-      const sev = r.severity ? ` [${r.severity}]` : "";
-      return `- **${r.id}**: ${r.name}${sev}`;
-    }).join("\n");
-    sections.push(
-      `## Your Workspace Principles & Rules (${wsRules.length} active)
-These are principles, standards, and rules your team has accepted onto the Chain. Respect them during implementation.
-
-` + ruleLines + '\n\nUse `entries action=get entryId="<ID>"` to drill into any rule before making changes in that area.'
-    );
-  } else {
-    sections.push(
-      "## Your Workspace Principles & Rules\nNo active principles, standards, or rules on the Chain yet.\nUse `capture` with collection `principles`, `standards`, or `rules` to add your team's guardrails.\nOnce accepted, they appear here at orient time \u2014 so every agent session starts with your rules visible."
-    );
-  }
   sections.push(
-    "## Core Product Architecture\nThe Chain is a versioned, connected, compounding knowledge base \u2014 the SSOT for a product team.\nEverything on the Chain is one of **two primitives**:\n\n- **Entry** (atom) \u2014 a discrete knowledge unit: target audience, business rule, glossary term, metric, tension. Lives in a collection.\n- **Process** (authored) \u2014 a narrative chain with named links (Strategy Coherence, IDM Proposal). Content is inline text. Collection: `chains`.\n\nEntries are atoms. Processes author narrative from atoms.\nBoth share the same versioning, branching, gating, and relation system.\n\nThe Chain compounds: each new relation makes entries discoverable from more starting points \u2192 context gathering returns richer results \u2192 AI processes have more context \u2192 quality scores improve \u2192 next accept is smarter than the last."
+    "## Core Product Architecture\nThe Chain is a versioned, connected, compounding knowledge base \u2014 the SSOT for a product team.\nEverything on the Chain is one of **two primitives**:\n\n- **Entry** (atom) \u2014 a discrete knowledge unit: target audience, rule, glossary term, metric, tension. Lives in a collection.\n- **Process** (authored) \u2014 a narrative chain with named links (Strategy Coherence, IDM Proposal). Content is inline text. Collection: `chains`.\n\nEntries are atoms. Processes author narrative from atoms.\nBoth share the same versioning, branching, gating, and relation system.\n\nThe Chain compounds: each new relation makes entries discoverable from more starting points \u2192 context gathering returns richer results \u2192 AI processes have more context \u2192 quality scores improve \u2192 next accept is smarter than the last."
   );
   sections.push(
     "## Architecture\n```\nCursor (stdio) \u2192 MCP Server (mcp-server/src/index.ts)\n  \u2192 POST /api/aki with Bearer token\n  \u2192 Convex HTTP Action (convex/http.ts)\n  \u2192 internalQuery / internalMutation (convex/agentKnowledge/*)\n  \u2192 Convex DB (workspace-scoped)\n```\nSecurity: API key auth on every request, workspace-scoped data, internal functions blocked from external clients.\nKey files: `packages/mcp-server/src/client.ts` (HTTP client + audit), `convex/schema.ts` (schema)."
@@ -13776,13 +13753,8 @@ Tags for filtering (e.g. \`severity:high\`), relations via \`entryRelations\`, v
       "## Data Model\nCould not load collections \u2014 use `collections action=list` to browse manually."
     );
   }
-  const rulesCount = businessRules ? `${businessRules.length} entries` : "not loaded \u2014 collection may not exist yet";
   sections.push(
-    `## Rules
-Collection: \`rules\` (${rulesCount}).
-Find rules: \`entries action=search\` for text search, \`entries action=list collection=rules\` to browse.
-Check compliance: use the \`review-against-rules\` prompt (pass a domain).
-Draft a new rule: use the \`draft-rule-from-context\` prompt.`
+    '## Rules\nThe rules that bind you are in the briefing above, each with its why. A rule on no list binds nobody.\nOpen one: `entries action=get entryId="<ID>"`. Find one: `entries action=search query="<noun>"`.\nDraft a new rule: use the `draft-rule-from-context` prompt.'
   );
   sections.push(
     "## Knowledge Graph\nEntries are connected via typed relations (`entryRelations` table). Relations are bidirectional and collection-agnostic \u2014 any entry can link to any other entry.\n\n**Recommended relation types** (extensible \u2014 any string accepted):\n- `governs` \u2014 a rule constrains behavior of a feature\n- `defines_term_for` \u2014 a glossary term is canonical vocabulary for a feature/area\n- `belongs_to` \u2014 a feature belongs to a product area or parent concept (typed successor: `anchored_to`)\n- `informs` \u2014 a decision or insight informs a feature\n- `surfaces_tension_in` \u2014 a tension exists within a feature area\n- `related_to`, `depends_on`, `replaces`, `conflicts_with`, `references`, `confused_with`\n\nEach relation type is defined as a glossary entry (prefix `GT-REL-*`) to prevent terminology drift.\n\n**Tools:**\n- `context action=gather` \u2014 get the full context around any entry (multi-hop graph traversal)\n- `relations action=suggest` \u2014 discover potential connections for an entry\n- `relations action=create` \u2014 create a typed link between two entries\n- `relations action=find` \u2014 list direct relations for an entry\n\n**Convention:** When creating or updating entries in governed collections, always use `relations action=suggest` to discover and create relevant relations."
@@ -13802,8 +13774,7 @@ All other collections use the \`ENT-{random}\` fallback profile.
 **Prompts** (invoke via MCP prompt protocol):
 - \`name-check\` \u2014 verify a name against glossary conventions
 - \`draft-decision-record\` \u2014 scaffold a decision entry
-- \`review-against-rules\` \u2014 check work against business rules for a domain
-- \`draft-rule-from-context\` \u2014 create a new business rule from context
+- \`draft-rule-from-context\` \u2014 create a new rule from context
 
 Use \`quality action=check\` to score existing entries retroactively.
 Use \`entries action=update\` for post-creation adjustments (status changes, field updates, deprecation).`
@@ -13814,11 +13785,8 @@ Use \`entries action=update\` for post-creation adjustments (status changes, fie
   return sections.join("\n\n---\n\n");
 }
 async function buildOrientationResourceText(kernelQuery2, agentSessionId) {
-  const [collectionsResult, standardsResult, rulesResult, principlesResult, orientViewResult] = await Promise.allSettled([
+  const [collectionsResult, orientViewResult] = await Promise.allSettled([
     kernelQuery2("chain.listCollections"),
-    kernelQuery2("chain.listEntries", { collectionSlug: "standards" }),
-    kernelQuery2("chain.listEntries", { collectionSlug: "rules" }),
-    kernelQuery2("chain.listEntries", { collectionSlug: "principles" }),
     kernelQuery2("chain.getOrientView", {
       tier: "summary",
       invocationPath: "unknown",
@@ -13826,20 +13794,17 @@ async function buildOrientationResourceText(kernelQuery2, agentSessionId) {
     })
   ]);
   const collections = collectionsResult.status === "fulfilled" ? collectionsResult.value : null;
-  const standards = standardsResult.status === "fulfilled" ? standardsResult.value : null;
-  const businessRules = rulesResult.status === "fulfilled" ? rulesResult.value : null;
-  const principles = principlesResult.status === "fulfilled" ? principlesResult.value : null;
-  let directionLines;
+  let briefingLines;
   if (orientViewResult.status === "rejected") {
     const reason = orientViewResult.reason instanceof Error ? orientViewResult.reason.message : String(orientViewResult.reason);
     const normalized = sanitizeSingleLineField(reason);
     const truncated = normalized.length > 120 ? `${normalized.slice(0, 120)}\u2026` : normalized;
-    directionLines = [`_Strategic context unavailable: the spine read failed (${truncated})_`];
+    briefingLines = [`_Briefing unavailable: the orient read failed (${truncated}); purpose, objective and the rules that bind you are not shown. Read this resource again or run orient to retry._`];
   } else {
     const orientView = orientViewResult.value;
-    directionLines = buildOrientBriefingLines(orientView, { everyoneOnly: !agentSessionId });
+    briefingLines = buildOrientBriefingLines(orientView, { everyoneOnly: !agentSessionId });
   }
-  return buildOrientationMarkdown(collections, standards, businessRules, principles, directionLines);
+  return buildOrientationMarkdown(collections, briefingLines);
 }
 
 // src/resources/terminologyResource.ts
@@ -14468,4 +14433,4 @@ export {
   createProductBrainServer,
   initFeatureFlags
 };
-//# sourceMappingURL=chunk-JSKIMDXR.js.map
+//# sourceMappingURL=chunk-WKSQMKMW.js.map