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

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

@@ -7675,20 +7675,6 @@ function formatBriefingLines(view) {
 
 // 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 = [""];
@@ -7703,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) {
@@ -7786,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 } : {},
@@ -7797,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.",
@@ -7832,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 }
       }
     )
   };
@@ -8131,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 = [];
@@ -8141,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) {
@@ -8179,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);
     }
@@ -8228,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);
     }
@@ -8546,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) {
@@ -8584,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) {
@@ -8672,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) {
@@ -8755,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) {
@@ -8779,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");
@@ -8977,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");
@@ -9033,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");
@@ -13851,47 +13718,16 @@ Write via \`update\`: \`draft\` | \`archived\` (\`accepted\` via \`commit\`, nev
 `;
 
 // src/resources/orientationMarkdown.ts
-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")
-    );
+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 ruleLines2 = 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.
-
-` + ruleLines2 + '\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)."
@@ -13914,13 +13750,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."
@@ -13940,8 +13771,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).`
@@ -13952,11 +13782,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",
@@ -13964,22 +13791,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 ruleLines = [];
+  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 = buildDirectionLines(orientView);
-    ruleLines = agentSessionId ? formatRuleListsLines(orientView.ruleLists) : buildEveryoneOnlyRuleListsLines(orientView.ruleLists);
+    briefingLines = buildOrientBriefingLines(orientView, { everyoneOnly: !agentSessionId });
   }
-  return buildOrientationMarkdown(collections, standards, businessRules, principles, directionLines, ruleLines);
+  return buildOrientationMarkdown(collections, briefingLines);
 }
 
 // src/resources/terminologyResource.ts
@@ -14608,4 +14430,4 @@ export {
   createProductBrainServer,
   initFeatureFlags
 };
-//# sourceMappingURL=chunk-LJBOAIFJ.js.map
+//# sourceMappingURL=chunk-YCGDWKLK.js.map