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

package/dist/{chunk-OZXZLLHS.js → chunk-JSKIMDXR.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,23 +7613,68 @@ 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):";
-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,
-    ...ruleLists.namesTruncated ? { namesTruncated: true } : {}
-  };
-  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 = [""];
@@ -7644,81 +7689,15 @@ function buildRitualsSurfaceLines(view, opts) {
   if (view?.atCapLine) lines.push(view.atCapLine);
   return lines;
 }
-var DEFAULT_SPINE_ORDER = ["purpose", "vision", "strategy", "product", "objectives", "keyResults"];
-var TRUNCATION_MESSAGES = {
-  objectives_capped: "(more objectives exist than shown)",
-  key_results_capped: "(more key results exist than shown)",
-  reading_unresolved: "(some key results have an unresolved reading)"
-};
-function krValue(v) {
-  return v === null ? "n/a" : String(v);
-}
-function buildKeyResultLine(kr, objName) {
-  const idPart = kr.entryId ? `${toSafeCodeSpan(sanitizeSingleLineField(kr.entryId))} ` : "";
-  const unresolvedTag = kr.readingUnresolved ? " [reading unresolved]" : "";
-  const values = `${krValue(kr.currentValue)} / ${krValue(kr.targetValue)} [${kr.staleness}]${unresolvedTag}`;
-  const suffix = objName ? ` (${sanitizeSingleLineField(objName)})` : "";
-  return `**Key result:** ${idPart}${sanitizeSingleLineField(kr.name)}${suffix}: ${values}`;
-}
-function toSafeCodeSpan(text) {
-  const longestBacktickRun = (text.match(/`+/g) ?? []).reduce((max, run) => Math.max(max, run.length), 0);
-  const fence = "`".repeat(longestBacktickRun + 1);
-  const pad = text.startsWith("`") || text.endsWith("`") ? " " : "";
-  return `${fence}${pad}${text}${pad}${fence}`;
-}
-function buildDirectionLines(view) {
-  const purpose = view?.strategicContext?.purpose;
-  const vision = view?.strategicContext?.vision;
-  const productAreas = view?.strategicContext?.productAreas ?? [];
-  const spine = view?.strategicSpine;
-  const objectives = spine?.objectives ?? [];
-  const orphanKeyResults = spine?.orphanKeyResults ?? [];
-  const truncationReasons = spine?.truncationReasons ?? [];
-  const fetchFailed = spine?.fetchFailed ?? false;
-  const krRows = objectives.flatMap((o) => o.keyResults.map((kr) => ({ o, kr })));
-  const strategy = (view?.strategyHighlights ?? []).filter(
-    (e) => typeof e === "object" && e != null && typeof e.name === "string" && e.name.length > 0
-  );
-  const hasSomething = purpose || vision || strategy.length > 0 || productAreas.length > 0 || objectives.length > 0 || orphanKeyResults.length > 0 || truncationReasons.length > 0 || fetchFailed;
-  if (!hasSomething) return [];
-  const lines = ["## Strategic Context"];
-  for (const section of spine?.order ?? DEFAULT_SPINE_ORDER) {
-    if (section === "purpose") {
-      if (purpose) lines.push(`**Purpose:** ${stripControlChars(purpose)}`);
-    } else if (section === "vision") {
-      if (vision) lines.push(`**Vision:** ${stripControlChars(vision)}`);
-    } else if (section === "strategy") lines.push(...buildStrategyRowLines(strategy));
-    else if (section === "product") {
-      if (productAreas.length > 0) lines.push(`**Product areas:** ${productAreas.join(", ")}`);
-    } else if (section === "objectives") {
-      if (fetchFailed) lines.push("**Strategic spine:** unavailable \u2014 orient fetch failed, retry `orient`.");
-      else if (objectives.length > 0) {
-        for (const obj of objectives) {
-          const idPart = obj.entryId ? `${toSafeCodeSpan(sanitizeSingleLineField(obj.entryId))} ` : "";
-          lines.push(`**Objective:** ${idPart}${sanitizeSingleLineField(obj.name)}`);
-        }
-      }
-    } else if (section === "keyResults" && !fetchFailed && (krRows.length > 0 || orphanKeyResults.length > 0 || truncationReasons.length > 0)) {
-      for (const { o, kr } of krRows) lines.push(buildKeyResultLine(kr, o.name));
-      if (orphanKeyResults.length > 0) {
-        lines.push("**Key results without an objective:**");
-        for (const kr of orphanKeyResults) lines.push(buildKeyResultLine(kr, null));
-      }
-      for (const reason of truncationReasons) lines.push(TRUNCATION_MESSAGES[reason]);
-    }
-  }
-  return lines;
-}
-function buildStrategyRowLines(strategy) {
-  const lines = [];
-  for (const row of strategy) {
-    const mark = provenanceMark(row.provenance);
-    const rawId = row.entryId ?? row._id;
-    const idPart = typeof rawId === "string" && rawId ? `${toSafeCodeSpan(sanitizeSingleLineField(rawId))} ` : "";
-    const anchorSuffix = row.anchoredBy ? ` (${sanitizeSingleLineField(row.anchoredBy)})` : "";
-    const preview = typeof row.preview === "string" && row.preview ? ` \u2014 ${stripControlChars(row.preview)}` : "";
-    lines.push(`**Strategy:** ${mark}${idPart}${sanitizeSingleLineField(row.name)}${anchorSuffix}${preview}`);
-  }
+function buildOrientBriefingLines(view, opts) {
+  if (!view) return [];
+  const rl = view.ruleLists ?? void 0;
+  const ruleLists = rl && opts?.everyoneOnly ? { everyone: rl.everyone, team: null, role: { rows: [], overCap: 0 }, unassigned: rl.unassigned, truncated: rl.truncated, ...rl.namesTruncated ? { namesTruncated: true } : {} } : rl;
+  const lines = formatBriefingLines({ facts: view.briefing ?? void 0, ruleLists, surface: "mcp" });
+  if (!opts?.everyoneOnly || !rl) return lines;
+  if (lines.includes("Rules:")) return lines.map((l) => l === "Rules:" ? RULE_LISTS_EVERYONE_ONLY_LABEL : l);
+  const pull = lines.findIndex((l) => l.startsWith("Pull more:"));
+  lines.splice(pull < 0 ? lines.length : pull, 0, RULE_LISTS_EVERYONE_ONLY_LABEL, "(none currently served)", "");
   return lines;
 }
 async function fetchAndRenderOpenerDirection(kernelQuery2, errors, session) {
@@ -7727,7 +7706,7 @@ async function fetchAndRenderOpenerDirection(kernelQuery2, errors, session) {
   try {
     view = await kernelQuery2("chain.getOrientView", {
       tier: "standard",
-      invocationPath: "session-start",
+      invocationPath: session?.invocationPath ?? "session-start",
       // Stamps this call onto the current session/conversation/task (same as every other
       // chain.getOrientView caller) so recordOrientMetric's orientCallCount/billing rollup sees it.
       ...session?.agentSessionId ? { sessionId: session.agentSessionId } : {},
@@ -7738,32 +7717,15 @@ async function fetchAndRenderOpenerDirection(kernelQuery2, errors, session) {
     fetchFailed = true;
     errors.push(`Direction unavailable: ${e instanceof Error ? e.message : String(e)}`);
   }
-  return [...buildDirectionLines(view), ...buildRitualsSurfaceLines(view, { fetchFailed: fetchFailed || view?.fetchFailed === true })];
+  return { lines: [...buildOrientBriefingLines(view), ...buildRitualsSurfaceLines(view, { fetchFailed: fetchFailed || view?.fetchFailed === true })], view };
 }
 async function buildAlreadyOrientedResult(kernelQuery2, agentSessionId, taskGroundingWarningLines2) {
-  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
-    }),
-    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")}
-
-` : "";
+  const errors = [];
+  const { lines, view } = await fetchAndRenderOpenerDirection(kernelQuery2, errors, { agentSessionId, invocationPath: "manual-orient" });
   return {
     content: [{
       type: "text",
-      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."
+      text: "Already oriented. Session active, writes unlocked.\n" + [...errors, ...lines].join("\n") + "\n\n" + taskGroundingWarningLines2.join("\n") + "Use `orient mode='full'` for workspace context or `orient task='...'` before substantive work."
     }],
     structuredContent: success(
       "Already oriented. Session active, writes unlocked.",
@@ -7773,35 +7735,15 @@ async function buildAlreadyOrientedResult(kernelQuery2, agentSessionId, taskGrou
         taskGroundingStatus: "workspace_only",
         taskGroundingRequired: true,
         nextStep: 'Run `orient task="describe the work"` before substantive work.',
-        // T1's undefined-vs-null distinction: omit the key on a fetch failure, keep an explicit
-        // null for a genuine no-row arm.
-        ...rituals?.directionLine !== void 0 ? { directionLine: rituals.directionLine } : {},
-        ...rituals?.verdictAskLine !== void 0 ? { verdictAskLine: rituals.verdictAskLine } : {},
-        ...rituals?.spineLine !== void 0 ? { spineLine: rituals.spineLine } : {},
-        // PR #538 late review fix (P2, "include at-cap disclosure in structured orient output"):
-        // 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 } : {},
-        // 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,
-            ...ruleLists.namesTruncated ? { namesTruncated: true } : {}
-          },
-          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 } : {}
+        // T1's undefined-vs-null distinction: omit the key on a fetch failure, keep an explicit null for a genuine no-row arm.
+        ...view?.directionLine !== void 0 ? { directionLine: view.directionLine } : {},
+        ...view?.verdictAskLine !== void 0 ? { verdictAskLine: view.verdictAskLine } : {},
+        ...view?.spineLine !== void 0 ? { spineLine: view.spineLine } : {},
+        ...view?.atCapLine !== void 0 ? { atCapLine: view.atCapLine } : {},
+        // PR #538: text and structure carry the same at-cap disclosure
+        ...view?.briefing ? { briefing: view.briefing } : {},
+        ...view?.ruleLists ? { ruleLists: view.ruleLists } : {},
+        ...view ? {} : { fetchFailed: true }
       }
     )
   };
@@ -8072,7 +8014,8 @@ async function buildOrientResponse(wsCtx, agentSessionId, errors, task) {
   lines.push("");
   const startShapeLine = formatShapeAdvisorySummaryLine(shapeAdvisorySummary);
   if (startShapeLine) lines.push(startShapeLine, "");
-  lines.push(...await fetchAndRenderOpenerDirection(kernelQuery, errors, { agentSessionId, conversationId: getConversationId(), task }));
+  const opener = await fetchAndRenderOpenerDirection(kernelQuery, errors, { agentSessionId, conversationId: getConversationId(), task });
+  lines.push(...opener.lines);
   lines.push("_Need a collection that doesn't exist yet? Creating one is not available through this tool. Ask a platform admin to provision it, or enable the module ontology pack that owns it._");
   lines.push("");
   let activeBets = [];
@@ -8082,11 +8025,10 @@ async function buildOrientResponse(wsCtx, agentSessionId, errors, task) {
   } catch {
   }
   let governanceEntries = { principles: [], standards: [], businessRules: [] };
-  let ruleListsView;
+  const ruleListsView = opener.view?.ruleLists ?? void 0;
   let bindingGovernanceView;
   try {
     bindingGovernanceView = await kernelQuery("chain.getBindingGovernanceView", { task });
-    ruleListsView = bindingGovernanceView?.ruleLists;
   } catch {
   }
   if (task) {
@@ -8120,8 +8062,6 @@ async function buildOrientResponse(wsCtx, agentSessionId, errors, task) {
       lines.push("");
     }
     lines.push(...buildOperatingProtocol(governanceEntries, task));
-    const ruleLines = formatRuleListsLines(ruleListsView);
-    if (ruleLines.length > 0) lines.push("", "Rules:", ...ruleLines);
     if (coherence) {
       lines.push(...coherence.lines);
     }
@@ -8169,8 +8109,6 @@ async function buildOrientResponse(wsCtx, agentSessionId, errors, task) {
     lines.push(
       ...buildOperatingProtocol({ truncated: bindingGovernanceView?._budget?.truncated === true })
     );
-    const noTaskRuleLines = formatRuleListsLines(ruleListsView);
-    if (noTaskRuleLines.length > 0) lines.push("", "Rules:", ...noTaskRuleLines);
     if (coherence) {
       lines.push(...coherence.lines);
     }
@@ -8487,8 +8425,7 @@ 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);
+    scanLines.push("", ...buildOrientBriefingLines(orientView));
     let oriented = false;
     let orientationStatus2 = "no_session";
     if (agentSessionId && taskAsked) {
@@ -8525,7 +8462,7 @@ async function _handleOrient({ mode = "full", tier, task, startupSignals, invoca
     lines.push("");
   }
   if (mode === "brief") {
-    lines.push(...buildDirectionLines(orientView));
+    lines.push(...buildOrientBriefingLines(orientView));
     if (orientView?.strategicContext) {
       const sc = orientView.strategicContext;
       if (sc.playingFieldCount != null && sc.playingFieldCount > 0) {
@@ -8613,8 +8550,6 @@ async function _handleOrient({ mode = "full", tier, task, startupSignals, invoca
       } else {
         lines.push(...buildOperatingProtocol());
       }
-      const ruleLines = formatRuleListsLines(orientView.ruleLists);
-      if (ruleLines.length > 0) lines.push("", "Rules:", ...ruleLines);
     }
     let orientationStatus2 = "no_session";
     if (agentSessionId && taskAsked) {
@@ -8696,6 +8631,7 @@ async function _handleOrient({ mode = "full", tier, task, startupSignals, invoca
   }
   lines.push("_Need a collection that doesn't exist yet? Creating one is not available through this tool. Ask a platform admin to provision it, or enable the module ontology pack that owns it._");
   lines.push("");
+  lines.push(...buildOrientBriefingLines(orientView), "");
   let fullCoherenceSnapshot;
   if (readiness) {
     if (!sampleTruncated && readiness.gaps.length > 0) {
@@ -8720,16 +8656,10 @@ async function _handleOrient({ mode = "full", tier, task, startupSignals, invoca
     if (task) {
       lines.push(`Working on: **${task}**`);
       lines.push("");
-      lines.push(...buildDirectionLines(orientView));
       if (orientView?.strategicContext) {
         const sc = orientView.strategicContext;
         if (sc.playingFieldCount != null && sc.playingFieldCount > 0) lines.push(`**Playing field (${sc.playingFieldCount}):** ${(sc.playingField ?? []).join(", ")}`);
-        const currentWP = sc.currentWorkPackage;
-        const wpSingularFull = getCollectionLabel("work_package", "singular", vocabCtx);
-        const wpPluralFull = getCollectionLabel("work_package", "plural", vocabCtx);
-        const betLine = currentWP ? `**Current ${wpSingularFull}:** ${currentWP}. ${sc.activeWorkPackageCount} active ${wpPluralFull}.` : `No active ${wpPluralFull}.`;
-        lines.push(`${betLine} ${sc.activeTensionCount} open tension(s).`);
-        lines.push("");
+        lines.push(`${sc.activeWorkPackageCount} active ${getCollectionLabel("work_package", "plural", vocabCtx)}, ${sc.activeTensionCount} open tension(s).`, "");
       }
       if (orientView?.continuingFrom && orientView.continuingFrom.length > 0) {
         lines.push("## Continuing from");
@@ -8918,8 +8848,6 @@ async function _handleOrient({ mode = "full", tier, task, startupSignals, invoca
         lines.push(...formatRecoveryBlock(recoveryBlock));
       }
     } else {
-      const scNoTaskLines = buildDirectionLines(orientView);
-      if (scNoTaskLines.length > 0) lines.push(...scNoTaskLines, "");
       lines.push(...buildRitualsSurfaceLines(orientView, { fetchFailed: orientFetchFailed || orientView?.fetchFailed === true }));
       if (orientView?.activeWorkPackages?.length) {
         lines.push("## Active work packages \u2014 current scope");
@@ -8974,8 +8902,6 @@ 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");
@@ -12040,12 +11966,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 +11992,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
@@ -13783,16 +13718,11 @@ Write via \`update\`: \`draft\` | \`archived\` (\`accepted\` via \`commit\`, nev
 `;
 
 // src/resources/orientationMarkdown.ts
-function buildOrientationMarkdown(collections, standards, businessRules, principles, directionLines, ruleLines) {
+function buildOrientationMarkdown(collections, standards, businessRules, principles, directionLines) {
   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
   );
@@ -13807,7 +13737,7 @@ function buildOrientationMarkdown(collections, standards, businessRules, princip
     wsRules.push({ id: r.entryId ?? "", name: r.name, severity: r.data?.severity ?? void 0, source: "rules" });
   }
   if (wsRules.length > 0) {
-    const ruleLines2 = wsRules.map((r) => {
+    const ruleLines = wsRules.map((r) => {
       const sev = r.severity ? ` [${r.severity}]` : "";
       return `- **${r.id}**: ${r.name}${sev}`;
     }).join("\n");
@@ -13815,7 +13745,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.
 
-` + ruleLines2 + '\n\nUse `entries action=get entryId="<ID>"` to drill into any rule before making changes in that area.'
+` + ruleLines + '\n\nUse `entries action=get entryId="<ID>"` to drill into any rule before making changes in that area.'
     );
   } else {
     sections.push(
@@ -13900,7 +13830,6 @@ async function buildOrientationResourceText(kernelQuery2, agentSessionId) {
   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);
@@ -13908,10 +13837,9 @@ async function buildOrientationResourceText(kernelQuery2, agentSessionId) {
     directionLines = [`_Strategic context unavailable: the spine read failed (${truncated})_`];
   } else {
     const orientView = orientViewResult.value;
-    directionLines = buildDirectionLines(orientView);
-    ruleLines = agentSessionId ? formatRuleListsLines(orientView.ruleLists) : buildEveryoneOnlyRuleListsLines(orientView.ruleLists);
+    directionLines = buildOrientBriefingLines(orientView, { everyoneOnly: !agentSessionId });
   }
-  return buildOrientationMarkdown(collections, standards, businessRules, principles, directionLines, ruleLines);
+  return buildOrientationMarkdown(collections, standards, businessRules, principles, directionLines);
 }
 
 // src/resources/terminologyResource.ts
@@ -14540,4 +14468,4 @@ export {
   createProductBrainServer,
   initFeatureFlags
 };
-//# sourceMappingURL=chunk-OZXZLLHS.js.map
+//# sourceMappingURL=chunk-JSKIMDXR.js.map