@productbrain/mcp 0.0.1-beta.7530 → 0.0.1-beta.7547

package/dist/{chunk-57YGCYCX.js → chunk-LKAOXJNJ.js}

@@ -3624,13 +3624,11 @@ async function handleVerifyChain(server, { collection, mode }) {
   };
 }
 async function handleVerifyEntry({ entryId }) {
+  requireWriteAccess();
   const agentSessionId = getAgentSessionId();
   const result2 = await kernelMutation(
     "chain.verifyEntry",
-    {
-      entryId,
-      ...agentSessionId ? { sessionId: agentSessionId } : {}
-    }
+    { entryId, ...agentSessionId ? { sessionId: agentSessionId } : {} }
   );
   const basis = result2.attestation?.basis;
   const strength = result2.attestation?.strength;
@@ -7631,7 +7629,51 @@ function formatShapeAdvisorySummaryLine(sas) {
   return `Shape advisories (${sas.windowDays}d): ${sas.pendingCount} pending / ${sas.compoundTotal} compound${pendingRatePart} \u2014 precisionAgent ${agentPart}, precisionHuman ${humanPart}.${truncatedNote}${candidatePart}`;
 }
 
+// src/lib/ruleListRender.ts
+var RULE_LIST_CONTROL_CHARS_RE = /[\x00-\x08\x0b-\x1f\x7f]/g;
+function sanitizeRuleListField(value) {
+  return value.replace(RULE_LIST_CONTROL_CHARS_RE, "").replace(/\s+/g, " ").trim();
+}
+function formatRuleListRow(row) {
+  const entryId = sanitizeRuleListField(row.entryId);
+  const owner = row.ownerRoleId ? sanitizeRuleListField(row.ownerRoleId) : "\u2014";
+  const team = row.teamId ? ` (team ${sanitizeRuleListField(row.teamId)})` : "";
+  const servedAt = row.servedAt ? ` \u2014 served ${new Date(row.servedAt).toISOString()}` : "";
+  return `${entryId} \u2014 owner ${owner}${team}${servedAt}`;
+}
+function formatRuleListBucketLines(label, bucket, truncated) {
+  if (!bucket || bucket.rows.length === 0) return [];
+  const lines = [`${label}:`, ...bucket.rows.map((r) => `  - ${formatRuleListRow(r)}`)];
+  if (bucket.overCap > 0) lines.push(`  (${truncated ? "at least " : ""}+${bucket.overCap} more, capped)`);
+  return lines;
+}
+function formatRuleListsLines(ruleLists) {
+  if (!ruleLists) return [];
+  const lines = [
+    ...formatRuleListBucketLines("Everyone", ruleLists.everyone, ruleLists.truncated),
+    ...formatRuleListBucketLines("Team", ruleLists.team, ruleLists.truncated),
+    ...formatRuleListBucketLines("Role", ruleLists.role, ruleLists.truncated)
+  ];
+  if (lines.length === 0 && ruleLists.unassigned === 0 && !ruleLists.truncated) return [];
+  if (ruleLists.truncated) {
+    lines.push("(Some Current rules may be missing from these lists \u2014 the underlying read was truncated.)");
+  }
+  if (ruleLists.unassigned > 0) {
+    const atLeast = ruleLists.truncated ? "at least " : "";
+    lines.push(`(${atLeast}${ruleLists.unassigned} rule(s) opted into a list but could not be resolved \u2014 excluded, not silently dropped.)`);
+  }
+  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):";
+var RULE_LISTS_UNAVAILABLE_LINE = "Rules: unavailable \u2014 rule list fetch failed, retry `orient mode=full`";
+function buildEveryoneOnlyRuleListsLines(ruleLists) {
+  if (!ruleLists) return [];
+  const everyoneOnly = { everyone: ruleLists.everyone, team: null, role: { rows: [], overCap: 0 }, unassigned: ruleLists.unassigned, truncated: ruleLists.truncated };
+  const bucketLines = formatRuleListsLines(everyoneOnly);
+  return [RULE_LISTS_EVERYONE_ONLY_LABEL, bucketLines.length > 0 ? bucketLines.join("\n") : "(none currently served)"];
+}
 var SPINE_UNAVAILABLE_LINE = "Spine check: unavailable \u2014 orient fetch failed, retry `orient`";
 function buildRitualsSurfaceLines(view, opts) {
   const lines = [""];
@@ -7743,20 +7785,29 @@ async function fetchAndRenderOpenerDirection(kernelQuery2, errors, session) {
   return [...buildDirectionLines(view), ...buildRitualsSurfaceLines(view, { fetchFailed: fetchFailed || view?.fetchFailed === true })];
 }
 async function buildAlreadyOrientedResult(kernelQuery2, agentSessionId, taskGroundingWarningLines2) {
-  let ritualsFetchFailed = false;
-  let rituals = null;
-  try {
-    rituals = await kernelQuery2("chain.getRitualsSurface", {
+  const [ritualsSettled, bindingGovernanceSettled] = await Promise.allSettled([
+    // PR #532 late review fix (P2, "add a time bucket to the direct rituals query"): matches
+    // conflictQueue.ts's minute-bucket convention — forces a fresh reactive result once a snooze
+    // expires on wall-clock time alone, with no corresponding DB write to bust the cache.
+    kernelQuery2("chain.getRitualsSurface", {
       now: Math.floor(Date.now() / 6e4) * 6e4
-    });
-  } catch {
-    ritualsFetchFailed = true;
-  }
+    }),
+    kernelQuery2("chain.getBindingGovernanceView", {})
+  ]);
+  const ritualsFetchFailed = ritualsSettled.status === "rejected";
+  const rituals = ritualsSettled.status === "fulfilled" ? ritualsSettled.value : null;
+  const ruleListsFetchFailed = bindingGovernanceSettled.status === "rejected";
+  const ruleLists = bindingGovernanceSettled.status === "fulfilled" ? bindingGovernanceSettled.value?.ruleLists : void 0;
   const ritualsLines = buildRitualsSurfaceLines(rituals, { fetchFailed: ritualsFetchFailed });
+  const ruleListsBlock = ruleListsFetchFailed ? `${RULE_LISTS_UNAVAILABLE_LINE}
+
+` : ruleLists !== void 0 ? `${buildEveryoneOnlyRuleListsLines(ruleLists).join("\n")}
+
+` : "";
   return {
     content: [{
       type: "text",
-      text: "Already oriented. Session active, writes unlocked.\n" + ritualsLines.join("\n") + "\n\n" + taskGroundingWarningLines2.join("\n") + "Use `orient mode='full'` for workspace context or `orient task='...'` before substantive work."
+      text: "Already oriented. Session active, writes unlocked.\n" + ritualsLines.join("\n") + "\n\n" + ruleListsBlock + taskGroundingWarningLines2.join("\n") + "Use `orient mode='full'` for workspace context or `orient task='...'` before substantive work."
     }],
     structuredContent: success(
       "Already oriented. Session active, writes unlocked.",
@@ -7775,7 +7826,21 @@ async function buildAlreadyOrientedResult(kernelQuery2, agentSessionId, taskGrou
         // atCapLine renders in TEXT (buildRitualsSurfaceLines) but was never mirrored into
         // structuredContent — a structured-content consumer silently missed the dropped-at-cap
         // warning even when the same response's text carried it.
-        ...rituals?.atCapLine !== void 0 ? { atCapLine: rituals.atCapLine } : {}
+        ...rituals?.atCapLine !== void 0 ? { atCapLine: rituals.atCapLine } : {},
+        // Pre-review fix 1 (TEN-3912): team/role dropped from THIS path's payload — they are
+        // always trivial here (see the doc comment above), never this session's real rules —
+        // and `ruleListsScope` says explicitly why, rather than shipping a shape a consumer could
+        // misread as "this session has no team/role rules".
+        ...ruleLists ? {
+          ruleLists: { everyone: ruleLists.everyone, unassigned: ruleLists.unassigned, truncated: ruleLists.truncated },
+          ruleListsScope: "everyone-only"
+        } : {},
+        // Round 1 review (PRRT_kwDORS4ils6mOeU8, TEN-3912): explicit `true` only on the rejection
+        // above, mirroring the existing `fetchFailed`/`groundingStub`-style boolean flags on this
+        // same payload (present-and-true means "this happened", omitted means "it didn't") — never
+        // a bare `false`, never inferred from `ruleLists` being absent (a genuine no-row read also
+        // leaves it undefined).
+        ...ruleListsFetchFailed ? { ruleListsFetchFailed: true } : {}
       }
     )
   };
@@ -7849,42 +7914,6 @@ function replaceVocabTokens(body, workspaceCtx, collectionCtxMap) {
   });
 }
 
-// src/lib/ruleListRender.ts
-var RULE_LIST_CONTROL_CHARS_RE = /[\x00-\x08\x0b-\x1f\x7f]/g;
-function sanitizeRuleListField(value) {
-  return value.replace(RULE_LIST_CONTROL_CHARS_RE, "").replace(/\s+/g, " ").trim();
-}
-function formatRuleListRow(row) {
-  const entryId = sanitizeRuleListField(row.entryId);
-  const owner = row.ownerRoleId ? sanitizeRuleListField(row.ownerRoleId) : "\u2014";
-  const team = row.teamId ? ` (team ${sanitizeRuleListField(row.teamId)})` : "";
-  const servedAt = row.servedAt ? ` \u2014 served ${new Date(row.servedAt).toISOString()}` : "";
-  return `${entryId} \u2014 owner ${owner}${team}${servedAt}`;
-}
-function formatRuleListBucketLines(label, bucket, truncated) {
-  if (!bucket || bucket.rows.length === 0) return [];
-  const lines = [`${label}:`, ...bucket.rows.map((r) => `  - ${formatRuleListRow(r)}`)];
-  if (bucket.overCap > 0) lines.push(`  (${truncated ? "at least " : ""}+${bucket.overCap} more, capped)`);
-  return lines;
-}
-function formatRuleListsLines(ruleLists) {
-  if (!ruleLists) return [];
-  const lines = [
-    ...formatRuleListBucketLines("Everyone", ruleLists.everyone, ruleLists.truncated),
-    ...formatRuleListBucketLines("Team", ruleLists.team, ruleLists.truncated),
-    ...formatRuleListBucketLines("Role", ruleLists.role, ruleLists.truncated)
-  ];
-  if (lines.length === 0 && ruleLists.unassigned === 0 && !ruleLists.truncated) return [];
-  if (ruleLists.truncated) {
-    lines.push("(Some Current rules may be missing from these lists \u2014 the underlying read was truncated.)");
-  }
-  if (ruleLists.unassigned > 0) {
-    const atLeast = ruleLists.truncated ? "at least " : "";
-    lines.push(`(${atLeast}${ruleLists.unassigned} rule(s) opted into a list but could not be resolved \u2014 excluded, not silently dropped.)`);
-  }
-  return lines;
-}
-
 // src/tools/start_pb.ts
 import { z as z18 } from "zod/v3";
 
@@ -8512,6 +8541,8 @@ async function _handleOrient({ mode = "full", tier, task, startupSignals, invoca
       "Full onboarding is optional: call `orient action=start` if you want guided workspace setup. If you already ran setup, continue your task without restarting it."
     ];
     scanLines.push(...buildRitualsSurfaceLines(orientView, { fetchFailed: orientFetchFailed || orientView?.fetchFailed === true }));
+    const blankRuleLines = formatRuleListsLines(orientView?.ruleLists);
+    if (blankRuleLines.length > 0) scanLines.push("", "Rules:", ...blankRuleLines);
     let oriented = false;
     let orientationStatus2 = "no_session";
     if (agentSessionId) {
@@ -8524,11 +8555,12 @@ async function _handleOrient({ mode = "full", tier, task, startupSignals, invoca
         orientationStatus2 = "failed";
       }
     }
+    const blankRuleListsExtra = orientView?.ruleLists ? { ruleLists: orientView.ruleLists } : {};
     const blankResult = {
       content: [{ type: "text", text: scanLines.join("\n") }],
       structuredContent: success(
         "No accepted user-authored entries found. Follow the spine guidance for your task; full onboarding is optional.",
-        { oriented, orientationStatus: orientationStatus2, redirectHint: "Optional full onboarding: `orient action=start`. Continue an existing task using the spine guidance." },
+        { oriented, orientationStatus: orientationStatus2, redirectHint: "Optional full onboarding: `orient action=start`. Continue an existing task using the spine guidance.", ...blankRuleListsExtra },
         task ? [] : [{ tool: "orient", description: "Optional full workspace onboarding", parameters: { action: "start" } }]
       )
     };
@@ -8968,8 +9000,6 @@ async function _handleOrient({ mode = "full", tier, task, startupSignals, invoca
           businessRules: (gov.businessRules ?? []).map(mapGovernanceEntry)
         }, task));
       }
-      const ruleLines2 = formatRuleListsLines(orientView?.ruleLists);
-      if (ruleLines2.length > 0) lines.push("", "Rules:", ...ruleLines2);
       let allEntries = [];
       try {
         allEntries = await kernelQuery("chain.listEntries", {
@@ -9040,6 +9070,8 @@ async function _handleOrient({ mode = "full", tier, task, startupSignals, invoca
       lines.push("");
     }
   }
+  const ruleLinesFull = formatRuleListsLines(orientView?.ruleLists);
+  if (ruleLinesFull.length > 0) lines.push("", "Rules:", ...ruleLinesFull);
   const classificationGaps = readiness?.gaps?.filter((g) => g.id?.startsWith?.(PURPOSE_GAP_PREFIX)) ?? [];
   if (classificationGaps.length > 0) {
     lines.push("## Classification gaps");
@@ -14098,11 +14130,16 @@ All entries: \`draft\` | \`active\` | \`deprecated\` | \`archived\`
 `;
 
 // src/resources/orientationMarkdown.ts
-function buildOrientationMarkdown(collections, standards, businessRules, principles, directionLines) {
+function buildOrientationMarkdown(collections, standards, businessRules, principles, directionLines, ruleLines) {
   const sections = ["# Product Brain \u2014 Orientation"];
   if (directionLines && directionLines.length > 0) {
     sections.push(directionLines.join("\n"));
   }
+  if (ruleLines && ruleLines.length > 0) {
+    sections.push(
+      "## Rules (delivered lists)\nEveryone/team/role rules currently served to this workspace and role (DEC-1774) \u2014 distinct from the collection-listing section below.\n\n" + ruleLines.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
   );
@@ -14117,7 +14154,7 @@ function buildOrientationMarkdown(collections, standards, businessRules, princip
     wsRules.push({ id: r.entryId ?? "", name: r.name, severity: r.data?.severity ?? void 0, source: "business-rules" });
   }
   if (wsRules.length > 0) {
-    const ruleLines = wsRules.map((r) => {
+    const ruleLines2 = wsRules.map((r) => {
       const sev = r.severity ? ` [${r.severity}]` : "";
       return `- **${r.id}**: ${r.name}${sev}`;
     }).join("\n");
@@ -14125,7 +14162,7 @@ function buildOrientationMarkdown(collections, standards, businessRules, princip
       `## 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.'
+` + ruleLines2 + '\n\nUse `entries action=get entryId="<ID>"` to drill into any rule before making changes in that area.'
     );
   } else {
     sections.push(
@@ -14193,7 +14230,7 @@ Use \`entries action=update\` for post-creation adjustments (status changes, fie
   );
   return sections.join("\n\n---\n\n");
 }
-async function buildOrientationResourceText(kernelQuery2) {
+async function buildOrientationResourceText(kernelQuery2, agentSessionId) {
   const [collectionsResult, standardsResult, rulesResult, principlesResult, orientViewResult] = await Promise.allSettled([
     kernelQuery2("chain.listCollections"),
     kernelQuery2("chain.listEntries", { collectionSlug: "standards" }),
@@ -14201,7 +14238,8 @@ async function buildOrientationResourceText(kernelQuery2) {
     kernelQuery2("chain.listEntries", { collectionSlug: "principles" }),
     kernelQuery2("chain.getOrientView", {
       tier: "summary",
-      invocationPath: "unknown"
+      invocationPath: "unknown",
+      ...agentSessionId ? { sessionId: agentSessionId } : {}
     })
   ]);
   const collections = collectionsResult.status === "fulfilled" ? collectionsResult.value : null;
@@ -14209,6 +14247,7 @@ async function buildOrientationResourceText(kernelQuery2) {
   const businessRules = rulesResult.status === "fulfilled" ? rulesResult.value : null;
   const principles = principlesResult.status === "fulfilled" ? principlesResult.value : null;
   let directionLines;
+  let ruleLines = [];
   if (orientViewResult.status === "rejected") {
     const reason = orientViewResult.reason instanceof Error ? orientViewResult.reason.message : String(orientViewResult.reason);
     const normalized = sanitizeSingleLineField(reason);
@@ -14217,8 +14256,9 @@ async function buildOrientationResourceText(kernelQuery2) {
   } else {
     const orientView = orientViewResult.value;
     directionLines = buildDirectionLines(orientView);
+    ruleLines = agentSessionId ? formatRuleListsLines(orientView.ruleLists) : buildEveryoneOnlyRuleListsLines(orientView.ruleLists);
   }
-  return buildOrientationMarkdown(collections, standards, businessRules, principles, directionLines);
+  return buildOrientationMarkdown(collections, standards, businessRules, principles, directionLines, ruleLines);
 }
 
 // src/resources/index.ts
@@ -14257,7 +14297,8 @@ function registerResources(server) {
     "chain-orientation",
     "productbrain://orientation",
     async (uri) => ({
-      contents: [{ uri: uri.href, text: await buildOrientationResourceText(kernelQuery), mimeType: "text/markdown" }]
+      contents: [{ uri: uri.href, text: await buildOrientationResourceText(kernelQuery, getAgentSessionId()), mimeType: "text/markdown" }]
+      // TEN-3912 fix 2
     })
   );
   server.resource(
@@ -14870,4 +14911,4 @@ export {
   createProductBrainServer,
   initFeatureFlags
 };
-//# sourceMappingURL=chunk-57YGCYCX.js.map
+//# sourceMappingURL=chunk-LKAOXJNJ.js.map