@productbrain/mcp 0.0.1-beta.951 → 0.0.1-beta.958

package/dist/{chunk-ZPK5CSCQ.js → chunk-7BKN47NY.js}

@@ -12527,11 +12527,16 @@ function replaceVocabTokens(body, workspaceCtx, collectionCtxMap) {
 
 // src/tools/orient.ts
 var PURPOSE_GAP_PREFIX = "purpose-gap-";
-function reportOrientWrapperBytes(toolResult, truncated) {
+var NON_MEANINGFUL_TASK_RE = /^[\s​‌‍⁠]*$/u;
+function taskIsMeaningful(task) {
+  if (typeof task !== "string") return false;
+  return !NON_MEANINGFUL_TASK_RE.test(task);
+}
+function reportOrientWrapperBytes(toolResult, truncated, tier, taskProvided) {
   try {
     const fullToolOutput = JSON.stringify({ content: toolResult.content ?? [] });
     const bytes = Buffer.byteLength(fullToolOutput, "utf8");
-    void kernelMutation("agent.reportOrientMetric", { bytes, truncated }).catch(() => {
+    void kernelMutation("agent.reportOrientMetric", { bytes, truncated, tier, taskProvided }).catch(() => {
     });
   } catch {
   }
@@ -12584,7 +12589,7 @@ var VALID_TASK_DOMAINS = [
 var orientSchema = z21.object({
   mode: z21.enum(["full", "brief"]).optional().default("full").describe("full = full context (default). brief = compact summary for mid-session re-orientation. Prefer using the `tier` param for depth control."),
   tier: z21.enum(["summary", "standard", "full"]).optional().describe(
-    "Payload depth. summary = ~10 KB compact. standard = ~256 KB default. full = complete payload (large). Defaults to standard."
+    "Payload depth. Defaults to summary (~10 KB) when task is provided; standard (~256 KB) when task is absent. Pass summary, standard, or full to override."
   ),
   task: z21.string().optional().describe("Natural-language task description for task-scoped context. When provided, orient returns scored, relevant entries for the task."),
   scope: z21.enum(VALID_TASK_DOMAINS).optional().describe(`Optional domain scope to filter governance to entries relevant for this domain. Valid values: ${VALID_TASK_DOMAINS.join(", ")}.`)
@@ -12613,712 +12618,725 @@ function registerOrientTool(server) {
     "orient",
     {
       title: "Orient \u2014 Task Grounding",
-      description: "Task-grounded context loader. Use AFTER `start_pb` (the canonical session opener) to load governance and context for a specific task. Returns workspace context with a single recommended next action for low-readiness workspaces, or a standup-style briefing for established workspaces.\n\n**Not the session opener.** For 'how do I begin a session' or 'Start PB', call `start_pb` instead. `orient` is for refreshing or scoping context once a session is already underway.\n\nCompleting orientation unlocks write tools for the active session.\n\n**tier:** Controls payload depth. `standard` (default, ~256 KB) is the recommended default. `summary` (~10 KB) for quick mid-session re-orientation. `full` for complete payload when deep context is needed.\n\n**mode:** `full` (default) returns full context. `brief` returns compact summary \u2014 mapped to tier=summary internally. Prefer `tier` for explicit depth control.\n\n**task:** Optional natural-language task description. When provided, returns task-scoped context (scored, relevant entries) in addition to standard orient sections.\n\n**scope:** Optional domain scope. Filters governance entries to those relevant for the specified domain. Authority roots include strategy, product, product-design, engineering, architecture, data, governance, and go-to-market. Child scopes such as product-design/ux, engineering/frontend, data/analytics, and governance/principles are accepted. Legacy internal scopes remain accepted.",
+      description: "Task-grounded context loader. Use AFTER `start_pb` (the canonical session opener) to load governance and context for a specific task. Returns workspace context with a single recommended next action for low-readiness workspaces, or a standup-style briefing for established workspaces.\n\n**Not the session opener.** For 'how do I begin a session' or 'Start PB', call `start_pb` instead. `orient` is for refreshing or scoping context once a session is already underway.\n\nCompleting orientation unlocks write tools for the active session.\n\n**tier:** Controls payload depth.\n- `summary` (~10 KB) \u2014 compact, calibrated for task-scoped retrieval.\n- `standard` (~256 KB) \u2014 rich, suited to workspace standups.\n- `full` \u2014 complete payload, no cap (use with deliberation).\n\nDefaults: `summary` when `task` is provided; `standard` when `task` is absent. Explicit `tier` always wins. Pair with `mode='brief'` for compact formatting (orthogonal to depth).\n\n**mode:** `full` (default) returns full context. `brief` returns compact summary \u2014 mapped to tier=summary internally. Prefer `tier` for explicit depth control.\n\n**task:** Optional natural-language task description. When provided, returns task-scoped context (scored, relevant entries) in addition to standard orient sections.\n\n**scope:** Optional domain scope. Filters governance entries to those relevant for the specified domain. Authority roots include strategy, product, product-design, engineering, architecture, data, governance, and go-to-market. Child scopes such as product-design/ux, engineering/frontend, data/analytics, and governance/principles are accepted. Legacy internal scopes remain accepted.",
       inputSchema: orientSchema,
       annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false }
     },
-    thinWrapper(async ({ mode = "full", tier, task, scope }) => {
-      const errors = [];
-      const effectiveTier = tier ?? (mode === "brief" ? "summary" : "standard");
-      if (scope && !task) {
-        errors.push("--scope requires --task to filter governance. Scope was ignored.");
-      }
-      const agentSessionId = getAgentSessionId();
-      if (isSessionOriented() && mode === "brief" && !task) {
-        return {
-          content: [{
-            type: "text",
-            text: "Already oriented. Session active, writes unlocked.\n\n" + taskGroundingWarningLines().join("\n") + "Use `orient mode='full'` for workspace context or `orient task='...'` before substantive work."
-          }],
-          structuredContent: success(
-            "Already oriented. Session active, writes unlocked.",
-            {
-              alreadyOriented: true,
-              sessionId: agentSessionId,
-              taskGroundingStatus: "workspace_only",
-              taskGroundingRequired: true,
-              nextStep: 'Run `orient task="describe the work"` before substantive work.'
-            }
-          )
-        };
-      }
-      let wsCtx = null;
-      try {
-        wsCtx = await getWorkspaceContext();
-      } catch (e) {
-        errors.push(`Workspace: ${e instanceof Error ? e.message : String(e)}`);
-      }
-      let priorSessions = [];
-      let recoveryBlock = null;
-      let orientView = null;
+    thinWrapper(_handleOrient)
+  );
+}
+async function _handleOrient({ mode = "full", tier, task, scope }) {
+  const errors = [];
+  const callTier = tier ?? (mode === "brief" ? "summary" : void 0);
+  const resolvedTier = callTier ?? (taskIsMeaningful(task) ? "summary" : "standard");
+  if (scope && !task) {
+    errors.push("--scope requires --task to filter governance. Scope was ignored.");
+  }
+  const agentSessionId = getAgentSessionId();
+  if (isSessionOriented() && mode === "brief" && !task) {
+    return {
+      content: [{
+        type: "text",
+        text: "Already oriented. Session active, writes unlocked.\n\n" + taskGroundingWarningLines().join("\n") + "Use `orient mode='full'` for workspace context or `orient task='...'` before substantive work."
+      }],
+      structuredContent: success(
+        "Already oriented. Session active, writes unlocked.",
+        {
+          alreadyOriented: true,
+          sessionId: agentSessionId,
+          taskGroundingStatus: "workspace_only",
+          taskGroundingRequired: true,
+          nextStep: 'Run `orient task="describe the work"` before substantive work.'
+        }
+      )
+    };
+  }
+  let wsCtx = null;
+  try {
+    wsCtx = await getWorkspaceContext();
+  } catch (e) {
+    errors.push(`Workspace: ${e instanceof Error ? e.message : String(e)}`);
+  }
+  let priorSessions = [];
+  let recoveryBlock = null;
+  let orientView = null;
+  try {
+    const orientArgs = {};
+    if (task) orientArgs.task = task;
+    if (scope) orientArgs.scope = scope;
+    if (callTier) orientArgs.tier = callTier;
+    orientView = await kernelQuery("chain.getOrientView", orientArgs);
+  } catch {
+  }
+  let vocabCtx;
+  try {
+    const vocab = await kernelQuery("chain.getVocabulary", {});
+    if (vocab?.collectionLabels || vocab?.collectionDefaults) {
+      vocabCtx = {
+        ...vocab.collectionLabels ? { collectionLabels: vocab.collectionLabels } : {},
+        ...vocab.collectionDefaults ? { collectionDefaults: vocab.collectionDefaults } : {}
+      };
+    }
+  } catch {
+  }
+  if (orientView) {
+    priorSessions = orientView.priorSessions ?? [];
+    recoveryBlock = orientView.recoveryBlock ?? null;
+  }
+  const hasTaskGrounding = Boolean(task && orientView?.taskContext?.context?.length > 0);
+  if (wsCtx && hasTaskGrounding && orientView?.writeBackHints) {
+    const hints = Array.isArray(orientView.writeBackHints) ? orientView.writeBackHints : [];
+    if (hints.length > 0) {
+      trackWriteBackHintServed(wsCtx.workspaceId, {
+        hint_count: hints.length,
+        has_task: !!task
+      });
+    }
+  }
+  let openTensions = [];
+  try {
+    const tensions = await kernelQuery("chain.listEntries", { collectionSlug: "tensions" });
+    openTensions = (tensions ?? []).filter((e) => e.workflowStatus === "open");
+  } catch {
+  }
+  let allCollections = [];
+  try {
+    allCollections = await kernelQuery("chain.listCollections") ?? [];
+  } catch {
+  }
+  let readiness = null;
+  try {
+    readiness = await kernelQuery("chain.workspaceReadiness");
+  } catch (e) {
+    errors.push(`Readiness: ${e instanceof Error ? e.message : String(e)}`);
+  }
+  if (readiness?.stage === "blank") {
+    const scanLines = [
+      `# Welcome to ${wsCtx?.workspaceName ?? "your workspace"}`,
+      "",
+      "Your workspace is fresh \u2014 let's set it up.",
+      "",
+      "**Recommended:** call the `start` tool instead of `orient` for the best first-run experience.",
+      "It will guide you through setting up your workspace \u2014 you can tell me about your product, scan your codebase, or use a preset.",
+      "",
+      "Or tell me about your product and I'll start capturing knowledge directly."
+    ];
+    let oriented = false;
+    let orientationStatus2 = "no_session";
+    if (agentSessionId) {
       try {
-        const orientArgs = {};
-        if (task) orientArgs.task = task;
-        if (scope) orientArgs.scope = scope;
-        orientArgs.tier = effectiveTier;
-        orientView = await kernelQuery("chain.getOrientView", orientArgs);
+        await kernelCall("agent.markOriented", { sessionId: agentSessionId });
+        setSessionOriented(true);
+        oriented = true;
+        orientationStatus2 = "complete";
       } catch {
+        orientationStatus2 = "failed";
       }
-      let vocabCtx;
-      try {
-        const vocab = await kernelQuery("chain.getVocabulary", {});
-        if (vocab?.collectionLabels || vocab?.collectionDefaults) {
-          vocabCtx = {
-            ...vocab.collectionLabels ? { collectionLabels: vocab.collectionLabels } : {},
-            ...vocab.collectionDefaults ? { collectionDefaults: vocab.collectionDefaults } : {}
-          };
-        }
-      } catch {
+    }
+    const blankResult = {
+      content: [{ type: "text", text: scanLines.join("\n") }],
+      structuredContent: success(
+        "Workspace is blank. Use the start_pb tool for guided setup.",
+        { stage: "blank", readinessScore: readiness?.score ?? 0, oriented, orientationStatus: orientationStatus2, redirectHint: "Use the `start_pb` tool for the full guided setup experience." },
+        [{ tool: "start_pb", description: "Guided workspace setup", parameters: {} }]
+      )
+    };
+    reportOrientWrapperBytes(blankResult, false, resolvedTier, taskIsMeaningful(task));
+    return blankResult;
+  }
+  const lines = [];
+  const isLowReadiness = readiness && readiness.score < 50;
+  if (wsCtx) {
+    lines.push(`# ${wsCtx.workspaceName}`);
+    lines.push(`_Workspace \`${wsCtx.workspaceSlug}\` \u2014 Product Brain is healthy._`);
+  } else {
+    lines.push("# Workspace");
+    lines.push("_Could not resolve workspace._");
+  }
+  lines.push("");
+  lines.push(...taskGroundingWarningLines(task, hasTaskGrounding));
+  if (mode === "brief") {
+    const briefStage = readiness?.stage ?? (readiness?.score != null ? readiness.score < 50 ? "seeded" : "grounded" : "unknown");
+    lines.push(`Brain stage: ${briefStage}`);
+    if (orientView?.strategicContext) {
+      const sc = orientView.strategicContext;
+      if (sc.vision) lines.push(`Vision: ${sc.vision}`);
+      if (sc.purpose) lines.push(`Purpose: ${sc.purpose}`);
+      if (sc.productAreaCount != null && sc.productAreaCount > 0) {
+        lines.push(`Product areas (${sc.productAreaCount}): ${(sc.productAreas ?? []).join(", ")}`);
+      }
+      if (sc.playingFieldCount != null && sc.playingFieldCount > 0) {
+        lines.push(`Playing field (${sc.playingFieldCount}): ${(sc.playingField ?? []).join(", ")}`);
+      }
+      const wpPlural = getCollectionLabel("work_package", "plural", vocabCtx);
+      lines.push(`${sc.activeBetCount} active ${wpPlural}, ${sc.activeTensionCount} tension(s).`);
+    }
+    if (orientView?.taskContext && orientView.taskContext.context.length > 0) {
+      lines.push(`Task context: ${orientView.taskContext.totalFound} relevant entries (${orientView.taskContext.confidence} confidence).`);
+      if (orientView.taskContext.isGroundingStub && orientView.taskContext.groundingNote) {
+        lines.push(`\u26A0\uFE0F ${orientView.taskContext.groundingNote}`);
+      }
+    }
+    if (orientView?.startup?.domainRetrieval) {
+      const retrieval = orientView.startup.domainRetrieval;
+      const scopedTo = retrieval.resolvedDomainSlug ? ` (${retrieval.resolvedDomainSlug})` : "";
+      lines.push(`Domain retrieval: ${retrieval.state}${scopedTo}`);
+      if (retrieval.activeSource) lines.push(`Active source: ${retrieval.activeSource}`);
+      if (retrieval.fallbackReason) lines.push(`Fallback: ${retrieval.fallbackReason}`);
+      if (retrieval.fallbackAction) lines.push(`Action: ${retrieval.fallbackAction}`);
+      if (retrieval.evidenceGap) lines.push(`Evidence gap: ${retrieval.evidenceGap}`);
+      if (retrieval.directRatifiedCount != null || retrieval.inheritedRatifiedCount != null || retrieval.orgFallbackCount != null) {
+        lines.push(`Domain relation evidence: ${retrieval.directRatifiedCount ?? 0} direct, ${retrieval.inheritedRatifiedCount ?? 0} inherited, ${retrieval.orgFallbackCount ?? 0} org fallback`);
+      }
+    }
+    if (orientView?.writeBackHints && orientView.writeBackHints.length > 0) {
+      lines.push("");
+      lines.push("Write-back hints (what to capture this session):");
+      for (const h of orientView.writeBackHints) {
+        lines.push(`  ${h.collectionSlug}: ${h.hint}`);
       }
-      if (orientView) {
-        priorSessions = orientView.priorSessions ?? [];
-        recoveryBlock = orientView.recoveryBlock ?? null;
-      }
-      const hasTaskGrounding = Boolean(task && orientView?.taskContext?.context?.length > 0);
-      if (wsCtx && hasTaskGrounding && orientView?.writeBackHints) {
-        const hints = Array.isArray(orientView.writeBackHints) ? orientView.writeBackHints : [];
-        if (hints.length > 0) {
-          trackWriteBackHintServed(wsCtx.workspaceId, {
-            hint_count: hints.length,
-            has_task: !!task
-          });
-        }
+    }
+    if (orientView?.activeWorkPackages?.length > 0) {
+      for (const e of orientView.activeWorkPackages) {
+        const tensions = e.linkedTensions;
+        const tensionPart = tensions?.length ? ` \u2014 ${tensions.map((t) => `${t.entryId ?? t.name} (${t.severity ?? "\u2014"})`).join(", ")}` : "";
+        const originPart = e.origin ? ` (origin: ${e.origin})` : "";
+        lines.push(`- \`${e.entryId ?? e._id}\` ${e.name}${originPart}${tensionPart}`);
       }
-      let openTensions = [];
-      try {
-        const tensions = await kernelQuery("chain.listEntries", { collectionSlug: "tensions" });
-        openTensions = (tensions ?? []).filter((e) => e.workflowStatus === "open");
-      } catch {
+    }
+    if (orientView?.trustMetrics) {
+      const tm = orientView.trustMetrics;
+      if (tm.unverified > 0 || tm.verified > 0) {
+        const capNote = tm.scannedCap ? "+" : "";
+        lines.push(`Trust: ${tm.verified} verified, ${tm.unverified} unverified, ${tm.noStatus} no-status (${tm.total}${capNote} scanned).`);
       }
-      let allCollections = [];
-      try {
-        allCollections = await kernelQuery("chain.listCollections") ?? [];
-      } catch {
+    }
+    const briefWna = formatWhatNeedsAttentionBrief(orientView?.whatNeedsAttention);
+    if (briefWna.length > 0) {
+      lines.push("");
+      lines.push(...briefWna);
+    }
+    const briefGaps = readiness?.gaps ?? [];
+    if (briefGaps.length > 0) {
+      const oneLiner = formatGapOneLiner(briefGaps[0]);
+      if (oneLiner) lines.push(oneLiner);
+    }
+    const briefClassificationGaps = briefGaps.filter((g) => g.id?.startsWith?.(PURPOSE_GAP_PREFIX));
+    if (briefClassificationGaps.length > 0) {
+      lines.push(`${briefClassificationGaps.length} collection(s) with weak purpose \u2014 classification may be inaccurate.`);
+    }
+    if (recoveryBlock) {
+      lines.push("");
+      lines.push(...formatRecoveryBlock(recoveryBlock));
+    } else if (priorSessions.length > 0) {
+      const last = priorSessions[0];
+      const date = last.startedAt ? new Date(last.startedAt).toISOString().split("T")[0] : "unknown";
+      const created = Array.isArray(last.entriesCreated) ? last.entriesCreated.length : last.entriesCreated ?? 0;
+      const modified = Array.isArray(last.entriesModified) ? last.entriesModified.length : last.entriesModified ?? 0;
+      lines.push(`Last session (${date}): ${created} created, ${modified} modified`);
+    }
+    let coherenceSnapshot;
+    const coherence = buildCoherenceSection();
+    if (coherence) {
+      lines.push("");
+      lines.push(...coherence.lines);
+      coherenceSnapshot = coherence.snapshot;
+    }
+    if (allCollections.length > 0) {
+      const docCompleteness = buildDocCompletenessSection(allCollections);
+      if (docCompleteness.errorCount > 0 || docCompleteness.warningCount > 0) {
+        lines.push(...docCompleteness.lines);
       }
-      let readiness = null;
-      try {
-        readiness = await kernelQuery("chain.workspaceReadiness");
-      } catch (e) {
-        errors.push(`Readiness: ${e instanceof Error ? e.message : String(e)}`);
+    }
+    if (orientView) {
+      lines.push("");
+      if (task) {
+        const mapGovernanceEntry = (e) => ({
+          entryId: e.entryId,
+          name: e.name,
+          description: typeof e.preview === "string" ? e.preview : void 0,
+          tier: typeof e.tier === "number" ? e.tier : void 0,
+          // Phase 4 (DEC-1141): thread provenance fields to buildOperatingProtocol.
+          provenance: e.provenance,
+          anchoredBy: typeof e.anchoredBy === "string" ? e.anchoredBy : void 0
+        });
+        const gov = orientView.governance ?? { principles: [], standards: [], businessRules: [] };
+        lines.push(...buildOperatingProtocol({
+          principles: (gov.principles ?? []).map(mapGovernanceEntry),
+          standards: (gov.standards ?? []).map(mapGovernanceEntry),
+          businessRules: (gov.businessRules ?? []).map(mapGovernanceEntry)
+        }, task));
+      } else {
+        lines.push(...buildOperatingProtocol());
       }
-      if (readiness?.stage === "blank") {
-        const scanLines = [
-          `# Welcome to ${wsCtx?.workspaceName ?? "your workspace"}`,
-          "",
-          "Your workspace is fresh \u2014 let's set it up.",
-          "",
-          "**Recommended:** call the `start` tool instead of `orient` for the best first-run experience.",
-          "It will guide you through setting up your workspace \u2014 you can tell me about your product, scan your codebase, or use a preset.",
-          "",
-          "Or tell me about your product and I'll start capturing knowledge directly."
-        ];
-        let oriented = false;
-        let orientationStatus2 = "no_session";
-        if (agentSessionId) {
-          try {
-            await kernelCall("agent.markOriented", { sessionId: agentSessionId });
-            setSessionOriented(true);
-            oriented = true;
-            orientationStatus2 = "complete";
-          } catch {
-            orientationStatus2 = "failed";
-          }
-        }
-        const blankResult = {
-          content: [{ type: "text", text: scanLines.join("\n") }],
-          structuredContent: success(
-            "Workspace is blank. Use the start_pb tool for guided setup.",
-            { stage: "blank", readinessScore: readiness?.score ?? 0, oriented, orientationStatus: orientationStatus2, redirectHint: "Use the `start_pb` tool for the full guided setup experience." },
-            [{ tool: "start_pb", description: "Guided workspace setup", parameters: {} }]
-          )
-        };
-        reportOrientWrapperBytes(blankResult, false);
-        return blankResult;
+    }
+    let orientationStatus2 = "no_session";
+    if (agentSessionId && hasTaskGrounding) {
+      const orientedOk = await markOrientedWithSnapshotFallback(agentSessionId, coherenceSnapshot);
+      if (orientedOk) {
+        orientationStatus2 = "complete";
+        lines.push("---");
+        lines.push(`Orientation complete. Session ${agentSessionId}. Write tools available.`);
+      } else {
+        orientationStatus2 = "failed";
+        lines.push("---");
+        lines.push("_Warning: Could not mark session as oriented. Write tools may be restricted._");
       }
-      const lines = [];
-      const isLowReadiness = readiness && readiness.score < 50;
-      if (wsCtx) {
-        lines.push(`# ${wsCtx.workspaceName}`);
-        lines.push(`_Workspace \`${wsCtx.workspaceSlug}\` \u2014 Product Brain is healthy._`);
+    } else if (agentSessionId) {
+      orientationStatus2 = "task_required";
+      lines.push("---");
+      lines.push('Workspace orientation loaded. Write tools stay locked until you run `orient task="describe the work"`.');
+    } else {
+      lines.push("---");
+      lines.push("_No active agent session. Call `session action=start` to begin._");
+    }
+    const briefTruncated = orientView?._budget?.truncated ?? orientView?._truncated ?? false;
+    if (briefTruncated) {
+      const reasons = orientView?._budget?.truncationReasons;
+      lines.push("");
+      if (reasons && reasons.length > 0) {
+        lines.push(`_Context truncated to fit tier budget: ${reasons.join(", ")}. Use tier=full for complete payload._`);
       } else {
-        lines.push("# Workspace");
-        lines.push("_Could not resolve workspace._");
+        lines.push("_Context truncated to fit tier budget. Use tier=full for complete payload._");
+      }
+    }
+    if (errors.length > 0) {
+      lines.push("");
+      for (const err of errors) lines.push(`- ${err}`);
+    }
+    const briefResult = {
+      content: [{ type: "text", text: lines.join("\n") }],
+      structuredContent: success(
+        `Oriented (brief). Stage: ${readiness?.stage ?? "unknown"}.`,
+        {
+          mode: "brief",
+          stage: readiness?.stage ?? "unknown",
+          oriented: hasTaskGrounding ? isSessionOriented() : false,
+          sessionId: agentSessionId,
+          taskGroundingStatus: hasTaskGrounding ? "task_scoped" : task ? "missing_task_context" : "workspace_only",
+          taskGroundingRequired: !hasTaskGrounding,
+          // STD-219 §4 (DEC-1147): machine-readable stub flag for agent consumers.
+          ...orientView?.taskContext?.isGroundingStub ? { groundingStub: true } : {},
+          orientationStatus: orientationStatus2,
+          nextStep: hasTaskGrounding ? void 0 : 'Run `orient task="describe the work"` before substantive work.',
+          ...orientView?._budget ? { _budget: orientView._budget } : {}
+        }
+      )
+    };
+    reportOrientWrapperBytes(briefResult, briefTruncated, resolvedTier, taskIsMeaningful(task));
+    return briefResult;
+  }
+  const orientStage = readiness?.stage ?? "seeded";
+  if (isLowReadiness && wsCtx?.createdAt) {
+    const ageDays = Math.floor((Date.now() - wsCtx.createdAt) / (1e3 * 60 * 60 * 24));
+    if (ageDays >= 30) {
+      lines.push(`Your workspace has been around for ${ageDays} days and is still at the **${orientStage}** stage.`);
+      lines.push("Let's close the gaps \u2014 or if the current structure doesn't fit, we can reshape it.");
+      lines.push("");
+    }
+  }
+  let fullCoherenceSnapshot;
+  if (isLowReadiness) {
+    const captureBehaviorNote = (readiness?.governanceMode ?? wsCtx?.governanceMode ?? "open") === "open" ? "_In Open mode, captures commit automatically unless you ask me to keep them as drafts._" : "_Everything stays as a draft until you confirm._";
+    const gaps = readiness.gaps ?? [];
+    if (gaps.length > 0) {
+      const gapCtx = {
+        stage: orientStage,
+        passedChecks: readiness.passedChecks ?? 0,
+        totalChecks: readiness.totalChecks ?? 0,
+        score: readiness.score ?? 0
+      };
+      lines.push(formatTopGapPrompt(gaps[0], gaps.length - 1, gapCtx));
+      lines.push("");
+      lines.push(captureBehaviorNote);
+      lines.push("");
+      const remainingGaps = gaps.length - 1;
+      if (remainingGaps > 0 || openTensions.length > 0) {
+        const parts = [];
+        if (remainingGaps > 0) parts.push(`${remainingGaps} more area${remainingGaps === 1 ? "" : "s"} to cover`);
+        if (openTensions.length > 0) parts.push(`${openTensions.length} open tension${openTensions.length === 1 ? "" : "s"}`);
+        lines.push(`_${parts.join(" and ")} \u2014 ask for full status to see everything._`);
+        lines.push("");
       }
+    }
+    lines.push("_Need a collection that doesn't exist yet? Just ask \u2014 I'll set it up._");
+    lines.push("");
+  } else if (readiness) {
+    const fmt = (e) => {
+      const type = e.canonicalKey ?? "generic";
+      const stratum = e.stratum ?? "?";
+      const confidencePart = e.confidence ? ` [confidence: ${e.confidence}]` : "";
+      const reviewOverdue = e.reviewAt && new Date(e.reviewAt).getTime() < Date.now();
+      const overduePart = reviewOverdue ? " [review overdue]" : "";
+      const originPart = e.origin ? ` (origin: ${e.origin})` : "";
+      const mark = provenanceMark(e.provenance);
+      const anchorSuffix = e.anchoredBy ? ` (${e.anchoredBy})` : "";
+      return `- ${mark}\`${e.entryId ?? e._id}\` [${type} \xB7 ${stratum}] ${e.name}${anchorSuffix}${originPart}${confidencePart}${overduePart}`;
+    };
+    const fullCoherence = buildCoherenceSection();
+    if (fullCoherence) {
+      fullCoherenceSnapshot = fullCoherence.snapshot;
+    }
+    if (task) {
+      lines.push(`**Brain stage: ${orientStage}.** Working on: **${task}**`);
       lines.push("");
-      lines.push(...taskGroundingWarningLines(task, hasTaskGrounding));
-      if (mode === "brief") {
-        const briefStage = readiness?.stage ?? (readiness?.score != null ? readiness.score < 50 ? "seeded" : "grounded" : "unknown");
-        lines.push(`Brain stage: ${briefStage}`);
-        if (orientView?.strategicContext) {
-          const sc = orientView.strategicContext;
-          if (sc.vision) lines.push(`Vision: ${sc.vision}`);
-          if (sc.purpose) lines.push(`Purpose: ${sc.purpose}`);
-          if (sc.productAreaCount != null && sc.productAreaCount > 0) {
-            lines.push(`Product areas (${sc.productAreaCount}): ${(sc.productAreas ?? []).join(", ")}`);
+      if (orientView?.strategicContext) {
+        const sc = orientView.strategicContext;
+        lines.push("## Strategic Context");
+        if (sc.vision) lines.push(`**Vision:** ${sc.vision}`);
+        if (sc.purpose) lines.push(`**Purpose:** ${sc.purpose}`);
+        if (sc.productAreaCount != null && sc.productAreaCount > 0) {
+          lines.push(`**Product areas (${sc.productAreaCount}):** ${(sc.productAreas ?? []).join(", ")}`);
+        }
+        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.activeBetCount} active ${wpPluralFull}.` : `No active ${wpPluralFull}.`;
+        lines.push(`${betLine} ${sc.activeTensionCount} open tension(s).`);
+        lines.push("");
+      }
+      if (orientView?.continuingFrom && orientView.continuingFrom.length > 0) {
+        lines.push("## Continuing from");
+        lines.push("_Prior-session entries most relevant to your task._");
+        lines.push("");
+        for (const e of orientView.continuingFrom) {
+          const id = e.entryId ?? e.name;
+          const type = e.canonicalKey ?? "generic";
+          const coll = e.collectionSlug ? ` [${e.collectionSlug}]` : "";
+          lines.push(`- \`${id}\` (score ${e.score}) [${type}]${coll} \u2014 ${e.name}`);
+          if (e.reasoning) lines.push(`  _${e.reasoning}_`);
+          if ("primer" in e && typeof e.primer === "string" && e.primer.length > 0) {
+            const PRIMER_MAX = 1200;
+            const primerText = e.primer.length > PRIMER_MAX ? e.primer.slice(0, PRIMER_MAX) + "\n\u2026 (truncated \u2014 use entries action=get for full primer)" : e.primer;
+            lines.push("");
+            lines.push("  **Primer (paste when starting implementation):**");
+            lines.push("  ```");
+            for (const line of primerText.split("\n")) lines.push("  " + line);
+            lines.push("  ```");
+            lines.push("");
           }
-          if (sc.playingFieldCount != null && sc.playingFieldCount > 0) {
-            lines.push(`Playing field (${sc.playingFieldCount}): ${(sc.playingField ?? []).join(", ")}`);
+        }
+        lines.push("");
+      }
+      if (orientView?.lastSessionTouched && orientView.lastSessionTouched.length > 0) {
+        lines.push("## Last session touched");
+        lines.push("_Entries created or modified in your most recent session._");
+        lines.push("");
+        for (const e of orientView.lastSessionTouched) {
+          const id = e.entryId ?? e.name;
+          const type = e.canonicalKey ?? "generic";
+          const coll = e.collectionSlug ? ` [${e.collectionSlug}]` : "";
+          lines.push(`- \`${id}\` [${type}]${coll} \u2014 ${e.name}`);
+          if ("primer" in e && typeof e.primer === "string" && e.primer.length > 0) {
+            const PRIMER_MAX = 1200;
+            const primerText = e.primer.length > PRIMER_MAX ? e.primer.slice(0, PRIMER_MAX) + "\n\u2026 (truncated \u2014 use entries action=get for full primer)" : e.primer;
+            lines.push("");
+            lines.push("  **Primer:**");
+            lines.push("  ```");
+            for (const line of primerText.split("\n")) lines.push("  " + line);
+            lines.push("  ```");
+            lines.push("");
           }
-          const wpPlural = getCollectionLabel("work_package", "plural", vocabCtx);
-          lines.push(`${sc.activeBetCount} active ${wpPlural}, ${sc.activeTensionCount} tension(s).`);
         }
-        if (orientView?.taskContext && orientView.taskContext.context.length > 0) {
-          lines.push(`Task context: ${orientView.taskContext.totalFound} relevant entries (${orientView.taskContext.confidence} confidence).`);
+        lines.push("");
+      }
+      if (orientView?.taskContext && orientView.taskContext.context.length > 0) {
+        const tc = orientView.taskContext;
+        lines.push("## Task Context");
+        if (tc.isGroundingStub && tc.groundingNote) {
+          lines.push(`> \u26A0\uFE0F ${tc.groundingNote}`);
+          lines.push("");
         }
-        if (orientView?.startup?.domainRetrieval) {
+        if (orientView.startup?.domainRetrieval) {
           const retrieval = orientView.startup.domainRetrieval;
           const scopedTo = retrieval.resolvedDomainSlug ? ` (${retrieval.resolvedDomainSlug})` : "";
-          lines.push(`Domain retrieval: ${retrieval.state}${scopedTo}`);
-          if (retrieval.activeSource) lines.push(`Active source: ${retrieval.activeSource}`);
-          if (retrieval.fallbackReason) lines.push(`Fallback: ${retrieval.fallbackReason}`);
-          if (retrieval.fallbackAction) lines.push(`Action: ${retrieval.fallbackAction}`);
-          if (retrieval.evidenceGap) lines.push(`Evidence gap: ${retrieval.evidenceGap}`);
-          if (retrieval.directRatifiedCount != null || retrieval.inheritedRatifiedCount != null || retrieval.orgFallbackCount != null) {
-            lines.push(`Domain relation evidence: ${retrieval.directRatifiedCount ?? 0} direct, ${retrieval.inheritedRatifiedCount ?? 0} inherited, ${retrieval.orgFallbackCount ?? 0} org fallback`);
-          }
-        }
-        if (orientView?.writeBackHints && orientView.writeBackHints.length > 0) {
+          lines.push(`_Domain retrieval: ${retrieval.state}${scopedTo}_`);
+          if (retrieval.activeSource) lines.push(`_Active source: ${retrieval.activeSource}_`);
+          if (retrieval.fallbackReason) lines.push(`_${retrieval.fallbackReason}_`);
+          if (retrieval.fallbackAction) lines.push(`_${retrieval.fallbackAction}_`);
+          if (retrieval.evidenceGap) lines.push(`_Evidence gap: ${retrieval.evidenceGap}_`);
           lines.push("");
-          lines.push("Write-back hints (what to capture this session):");
-          for (const h of orientView.writeBackHints) {
-            lines.push(`  ${h.collectionSlug}: ${h.hint}`);
-          }
         }
-        if (orientView?.activeWorkPackages?.length > 0) {
-          for (const e of orientView.activeWorkPackages) {
-            const tensions = e.linkedTensions;
-            const tensionPart = tensions?.length ? ` \u2014 ${tensions.map((t) => `${t.entryId ?? t.name} (${t.severity ?? "\u2014"})`).join(", ")}` : "";
-            const originPart = e.origin ? ` (origin: ${e.origin})` : "";
-            lines.push(`- \`${e.entryId ?? e._id}\` ${e.name}${originPart}${tensionPart}`);
-          }
+        lines.push(`_Task-scoped entries (${tc.confidence} confidence, ${tc.totalFound} relevant)`);
+        lines.push("");
+        for (const e of tc.context) {
+          const id = e.entryId ?? e.name;
+          const coll = e.collectionSlug ? ` [${e.collectionSlug}]` : "";
+          const originTag = e.origin ? ` (origin: ${e.origin})` : "";
+          lines.push(`- \`${id}\` (score ${e.score})${coll}${originTag}${e.name !== id ? ` \u2014 ${e.name}` : ""}`);
+          if (e.preview) lines.push(`  _${e.preview}_`);
+        }
+        lines.push("");
+      }
+      if (orientView?.taskContext?.constellationEntries && orientView.taskContext.constellationEntries.length > 0) {
+        lines.push(...formatBetConstellationLines(
+          orientView.taskContext.constellationEntries,
+          orientView.taskContext.constellationBetName
+        ));
+      }
+      if (orientView?.writeBackHints && orientView.writeBackHints.length > 0) {
+        lines.push("");
+        lines.push("## Write-Back Hints");
+        lines.push("_What to capture this session (derived from task context):_");
+        lines.push("");
+        for (const h of orientView.writeBackHints) {
+          lines.push(`- **${h.collectionSlug}**: ${h.hint}`);
         }
-        if (orientView?.trustMetrics) {
+        lines.push("");
+      }
+      if (orientView) {
+        const result = await runAlignmentCheck(
+          task,
+          orientView.activeWorkPackages ?? [],
+          orientView.taskContext?.context
+        );
+        lines.push(...buildAlignmentCheckLines(result));
+        lines.push(...formatInitiativeStatusLines(orientView.initiativeStatus));
+        lines.push(...formatWorkstreamHealthLines(orientView.workstreamHealth));
+        lines.push(...formatWhatNeedsAttentionLines(orientView.whatNeedsAttention));
+        if (orientView.trustMetrics) {
           const tm = orientView.trustMetrics;
-          if (tm.unverified > 0 || tm.verified > 0) {
-            const capNote = tm.scannedCap ? "+" : "";
-            lines.push(`Trust: ${tm.verified} verified, ${tm.unverified} unverified, ${tm.noStatus} no-status (${tm.total}${capNote} scanned).`);
+          if (tm.verified > 0 || tm.unverified > 0) {
+            const capNote = tm.scannedCap ? " (capped at 500)" : "";
+            lines.push("## Trust metrics");
+            lines.push(`_Entry verification status across workspace${capNote}._`);
+            lines.push("");
+            lines.push(`- **Verified:** ${tm.verified}`);
+            lines.push(`- **Unverified:** ${tm.unverified}`);
+            lines.push(`- **No status (pre-BET-240):** ${tm.noStatus}`);
+            lines.push(`- **Total scanned:** ${tm.total}`);
+            lines.push("");
           }
         }
-        const briefWna = formatWhatNeedsAttentionBrief(orientView?.whatNeedsAttention);
-        if (briefWna.length > 0) {
-          lines.push("");
-          lines.push(...briefWna);
-        }
-        const briefGaps = readiness?.gaps ?? [];
-        if (briefGaps.length > 0) {
-          const oneLiner = formatGapOneLiner(briefGaps[0]);
-          if (oneLiner) lines.push(oneLiner);
-        }
-        const briefClassificationGaps = briefGaps.filter((g) => g.id?.startsWith?.(PURPOSE_GAP_PREFIX));
-        if (briefClassificationGaps.length > 0) {
-          lines.push(`${briefClassificationGaps.length} collection(s) with weak purpose \u2014 classification may be inaccurate.`);
+      }
+      if (fullCoherence) {
+        lines.push(...fullCoherence.lines);
+      }
+      if (allCollections.length > 0) {
+        const docCompleteness = buildDocCompletenessSection(allCollections);
+        if (docCompleteness.errorCount > 0 || docCompleteness.warningCount > 0) {
+          lines.push(...docCompleteness.lines);
         }
-        if (recoveryBlock) {
-          lines.push("");
-          lines.push(...formatRecoveryBlock(recoveryBlock));
-        } else if (priorSessions.length > 0) {
-          const last = priorSessions[0];
-          const date = last.startedAt ? new Date(last.startedAt).toISOString().split("T")[0] : "unknown";
-          const created = Array.isArray(last.entriesCreated) ? last.entriesCreated.length : last.entriesCreated ?? 0;
-          const modified = Array.isArray(last.entriesModified) ? last.entriesModified.length : last.entriesModified ?? 0;
-          lines.push(`Last session (${date}): ${created} created, ${modified} modified`);
-        }
-        let coherenceSnapshot;
-        const coherence = buildCoherenceSection();
-        if (coherence) {
+      }
+      if (orientView) {
+        if (orientView.activeWorkPackages?.length > 0) {
+          lines.push("## Active work packages \u2014 current scope");
+          lines.push("_Work outside these work packages requires explicit user confirmation._");
           lines.push("");
-          lines.push(...coherence.lines);
-          coherenceSnapshot = coherence.snapshot;
-        }
-        if (allCollections.length > 0) {
-          const docCompleteness = buildDocCompletenessSection(allCollections);
-          if (docCompleteness.errorCount > 0 || docCompleteness.warningCount > 0) {
-            lines.push(...docCompleteness.lines);
+          for (const e of orientView.activeWorkPackages) {
+            lines.push(fmt(e));
+            const tensions = e.linkedTensions;
+            if (tensions?.length) {
+              const tensionLines = tensions.map((t) => {
+                const meta = [t.severity, t.priority].filter(Boolean).join(", ");
+                return `\`${t.entryId ?? t.name}\` (${t.name}${meta ? `, ${meta}` : ""})`;
+              });
+              lines.push(`  Tensions: ${tensionLines.join("; ")}`);
+            }
           }
-        }
-        if (orientView) {
           lines.push("");
-          if (task) {
-            const mapGovernanceEntry = (e) => ({
-              entryId: e.entryId,
-              name: e.name,
-              description: typeof e.preview === "string" ? e.preview : void 0,
-              tier: typeof e.tier === "number" ? e.tier : void 0,
-              // Phase 4 (DEC-1141): thread provenance fields to buildOperatingProtocol.
-              provenance: e.provenance,
-              anchoredBy: typeof e.anchoredBy === "string" ? e.anchoredBy : void 0
-            });
-            const gov = orientView.governance ?? { principles: [], standards: [], businessRules: [] };
-            lines.push(...buildOperatingProtocol({
-              principles: (gov.principles ?? []).map(mapGovernanceEntry),
-              standards: (gov.standards ?? []).map(mapGovernanceEntry),
-              businessRules: (gov.businessRules ?? []).map(mapGovernanceEntry)
-            }, task));
-          } else {
-            lines.push(...buildOperatingProtocol());
-          }
-        }
-        let orientationStatus2 = "no_session";
-        if (agentSessionId && hasTaskGrounding) {
-          const orientedOk = await markOrientedWithSnapshotFallback(agentSessionId, coherenceSnapshot);
-          if (orientedOk) {
-            orientationStatus2 = "complete";
-            lines.push("---");
-            lines.push(`Orientation complete. Session ${agentSessionId}. Write tools available.`);
-          } else {
-            orientationStatus2 = "failed";
-            lines.push("---");
-            lines.push("_Warning: Could not mark session as oriented. Write tools may be restricted._");
-          }
-        } else if (agentSessionId) {
-          orientationStatus2 = "task_required";
-          lines.push("---");
-          lines.push('Workspace orientation loaded. Write tools stay locked until you run `orient task="describe the work"`.');
-        } else {
-          lines.push("---");
-          lines.push("_No active agent session. Call `session action=start` to begin._");
         }
-        const briefTruncated = orientView?._budget?.truncated ?? orientView?._truncated ?? false;
-        if (briefTruncated) {
-          const reasons = orientView?._budget?.truncationReasons;
+        if (orientView.activeGoals?.length > 0) {
+          lines.push("## Active goals");
+          orientView.activeGoals.forEach((e) => lines.push(fmt(e)));
           lines.push("");
-          if (reasons && reasons.length > 0) {
-            lines.push(`_Context truncated to fit tier budget: ${reasons.join(", ")}. Use tier=full for complete payload._`);
-          } else {
-            lines.push("_Context truncated to fit tier budget. Use tier=full for complete payload._");
-          }
         }
-        if (errors.length > 0) {
+        if (orientView.strategyHighlights?.length > 0) {
+          lines.push("## Strategy highlights");
+          lines.push("_One-sentence strategy, positioning, moat, business model, GTM \u2014 high-level strategic context._");
           lines.push("");
-          for (const err of errors) lines.push(`- ${err}`);
-        }
-        const briefResult = {
-          content: [{ type: "text", text: lines.join("\n") }],
-          structuredContent: success(
-            `Oriented (brief). Stage: ${readiness?.stage ?? "unknown"}.`,
-            {
-              mode: "brief",
-              stage: readiness?.stage ?? "unknown",
-              oriented: hasTaskGrounding ? isSessionOriented() : false,
-              sessionId: agentSessionId,
-              taskGroundingStatus: hasTaskGrounding ? "task_scoped" : task ? "missing_task_context" : "workspace_only",
-              taskGroundingRequired: !hasTaskGrounding,
-              orientationStatus: orientationStatus2,
-              nextStep: hasTaskGrounding ? void 0 : 'Run `orient task="describe the work"` before substantive work.',
-              ...orientView?._budget ? { _budget: orientView._budget } : {}
-            }
-          )
-        };
-        reportOrientWrapperBytes(briefResult, briefTruncated);
-        return briefResult;
-      }
-      const orientStage = readiness?.stage ?? "seeded";
-      if (isLowReadiness && wsCtx?.createdAt) {
-        const ageDays = Math.floor((Date.now() - wsCtx.createdAt) / (1e3 * 60 * 60 * 24));
-        if (ageDays >= 30) {
-          lines.push(`Your workspace has been around for ${ageDays} days and is still at the **${orientStage}** stage.`);
-          lines.push("Let's close the gaps \u2014 or if the current structure doesn't fit, we can reshape it.");
+          orientView.strategyHighlights.forEach((e) => lines.push(fmt(e)));
           lines.push("");
         }
-      }
-      let fullCoherenceSnapshot;
-      if (isLowReadiness) {
-        const captureBehaviorNote = (readiness?.governanceMode ?? wsCtx?.governanceMode ?? "open") === "open" ? "_In Open mode, captures commit automatically unless you ask me to keep them as drafts._" : "_Everything stays as a draft until you confirm._";
-        const gaps = readiness.gaps ?? [];
-        if (gaps.length > 0) {
-          const gapCtx = {
-            stage: orientStage,
-            passedChecks: readiness.passedChecks ?? 0,
-            totalChecks: readiness.totalChecks ?? 0,
-            score: readiness.score ?? 0
-          };
-          lines.push(formatTopGapPrompt(gaps[0], gaps.length - 1, gapCtx));
+        if (orientView.playingField?.length > 0) {
+          lines.push("## Playing field");
+          lines.push("_Products and opportunities in the strategic landscape._");
           lines.push("");
-          lines.push(captureBehaviorNote);
+          orientView.playingField.forEach((e) => lines.push(fmt(e)));
           lines.push("");
-          const remainingGaps = gaps.length - 1;
-          if (remainingGaps > 0 || openTensions.length > 0) {
-            const parts = [];
-            if (remainingGaps > 0) parts.push(`${remainingGaps} more area${remainingGaps === 1 ? "" : "s"} to cover`);
-            if (openTensions.length > 0) parts.push(`${openTensions.length} open tension${openTensions.length === 1 ? "" : "s"}`);
-            lines.push(`_${parts.join(" and ")} \u2014 ask for full status to see everything._`);
-            lines.push("");
-          }
         }
-        lines.push("_Need a collection that doesn't exist yet? Just ask \u2014 I'll set it up._");
-        lines.push("");
-      } else if (readiness) {
-        const fmt = (e) => {
-          const type = e.canonicalKey ?? "generic";
-          const stratum = e.stratum ?? "?";
-          const confidencePart = e.confidence ? ` [confidence: ${e.confidence}]` : "";
-          const reviewOverdue = e.reviewAt && new Date(e.reviewAt).getTime() < Date.now();
-          const overduePart = reviewOverdue ? " [review overdue]" : "";
-          const originPart = e.origin ? ` (origin: ${e.origin})` : "";
-          const mark = provenanceMark(e.provenance);
-          const anchorSuffix = e.anchoredBy ? ` (${e.anchoredBy})` : "";
-          return `- ${mark}\`${e.entryId ?? e._id}\` [${type} \xB7 ${stratum}] ${e.name}${anchorSuffix}${originPart}${confidencePart}${overduePart}`;
-        };
-        const fullCoherence = buildCoherenceSection();
-        if (fullCoherence) {
-          fullCoherenceSnapshot = fullCoherence.snapshot;
+        if (orientView.recentDecisions?.length > 0) {
+          lines.push("## Recent decisions");
+          orientView.recentDecisions.forEach((e) => lines.push(fmt(e)));
+          lines.push("");
         }
-        if (task) {
-          lines.push(`**Brain stage: ${orientStage}.** Working on: **${task}**`);
+        if (orientView.recentlySuperseded?.length > 0) {
+          lines.push("## Recently superseded");
+          orientView.recentlySuperseded.forEach((e) => lines.push(fmt(e)));
           lines.push("");
-          if (orientView?.strategicContext) {
-            const sc = orientView.strategicContext;
-            lines.push("## Strategic Context");
-            if (sc.vision) lines.push(`**Vision:** ${sc.vision}`);
-            if (sc.purpose) lines.push(`**Purpose:** ${sc.purpose}`);
-            if (sc.productAreaCount != null && sc.productAreaCount > 0) {
-              lines.push(`**Product areas (${sc.productAreaCount}):** ${(sc.productAreas ?? []).join(", ")}`);
-            }
-            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.activeBetCount} active ${wpPluralFull}.` : `No active ${wpPluralFull}.`;
-            lines.push(`${betLine} ${sc.activeTensionCount} open tension(s).`);
-            lines.push("");
-          }
-          if (orientView?.continuingFrom && orientView.continuingFrom.length > 0) {
-            lines.push("## Continuing from");
-            lines.push("_Prior-session entries most relevant to your task._");
-            lines.push("");
-            for (const e of orientView.continuingFrom) {
-              const id = e.entryId ?? e.name;
-              const type = e.canonicalKey ?? "generic";
-              const coll = e.collectionSlug ? ` [${e.collectionSlug}]` : "";
-              lines.push(`- \`${id}\` (score ${e.score}) [${type}]${coll} \u2014 ${e.name}`);
-              if (e.reasoning) lines.push(`  _${e.reasoning}_`);
-              if ("primer" in e && typeof e.primer === "string" && e.primer.length > 0) {
-                const PRIMER_MAX = 1200;
-                const primerText = e.primer.length > PRIMER_MAX ? e.primer.slice(0, PRIMER_MAX) + "\n\u2026 (truncated \u2014 use entries action=get for full primer)" : e.primer;
-                lines.push("");
-                lines.push("  **Primer (paste when starting implementation):**");
-                lines.push("  ```");
-                for (const line of primerText.split("\n")) lines.push("  " + line);
-                lines.push("  ```");
-                lines.push("");
-              }
-            }
-            lines.push("");
-          }
-          if (orientView?.lastSessionTouched && orientView.lastSessionTouched.length > 0) {
-            lines.push("## Last session touched");
-            lines.push("_Entries created or modified in your most recent session._");
-            lines.push("");
-            for (const e of orientView.lastSessionTouched) {
-              const id = e.entryId ?? e.name;
-              const type = e.canonicalKey ?? "generic";
-              const coll = e.collectionSlug ? ` [${e.collectionSlug}]` : "";
-              lines.push(`- \`${id}\` [${type}]${coll} \u2014 ${e.name}`);
-              if ("primer" in e && typeof e.primer === "string" && e.primer.length > 0) {
-                const PRIMER_MAX = 1200;
-                const primerText = e.primer.length > PRIMER_MAX ? e.primer.slice(0, PRIMER_MAX) + "\n\u2026 (truncated \u2014 use entries action=get for full primer)" : e.primer;
-                lines.push("");
-                lines.push("  **Primer:**");
-                lines.push("  ```");
-                for (const line of primerText.split("\n")) lines.push("  " + line);
-                lines.push("  ```");
-                lines.push("");
-              }
-            }
-            lines.push("");
-          }
-          if (orientView?.taskContext && orientView.taskContext.context.length > 0) {
-            const tc = orientView.taskContext;
-            lines.push("## Task Context");
-            if (orientView.startup?.domainRetrieval) {
-              const retrieval = orientView.startup.domainRetrieval;
-              const scopedTo = retrieval.resolvedDomainSlug ? ` (${retrieval.resolvedDomainSlug})` : "";
-              lines.push(`_Domain retrieval: ${retrieval.state}${scopedTo}_`);
-              if (retrieval.activeSource) lines.push(`_Active source: ${retrieval.activeSource}_`);
-              if (retrieval.fallbackReason) lines.push(`_${retrieval.fallbackReason}_`);
-              if (retrieval.fallbackAction) lines.push(`_${retrieval.fallbackAction}_`);
-              if (retrieval.evidenceGap) lines.push(`_Evidence gap: ${retrieval.evidenceGap}_`);
-              lines.push("");
-            }
-            lines.push(`_Task-scoped entries (${tc.confidence} confidence, ${tc.totalFound} relevant)`);
-            lines.push("");
-            for (const e of tc.context) {
-              const id = e.entryId ?? e.name;
-              const coll = e.collectionSlug ? ` [${e.collectionSlug}]` : "";
-              const originTag = e.origin ? ` (origin: ${e.origin})` : "";
-              lines.push(`- \`${id}\` (score ${e.score})${coll}${originTag}${e.name !== id ? ` \u2014 ${e.name}` : ""}`);
-              if (e.preview) lines.push(`  _${e.preview}_`);
-            }
-            lines.push("");
-          }
-          if (orientView?.taskContext?.constellationEntries && orientView.taskContext.constellationEntries.length > 0) {
-            lines.push(...formatBetConstellationLines(
-              orientView.taskContext.constellationEntries,
-              orientView.taskContext.constellationBetName
-            ));
-          }
-          if (orientView?.writeBackHints && orientView.writeBackHints.length > 0) {
-            lines.push("");
-            lines.push("## Write-Back Hints");
-            lines.push("_What to capture this session (derived from task context):_");
-            lines.push("");
-            for (const h of orientView.writeBackHints) {
-              lines.push(`- **${h.collectionSlug}**: ${h.hint}`);
-            }
-            lines.push("");
-          }
-          if (orientView) {
-            const result = await runAlignmentCheck(
-              task,
-              orientView.activeWorkPackages ?? [],
-              orientView.taskContext?.context
-            );
-            lines.push(...buildAlignmentCheckLines(result));
-            lines.push(...formatInitiativeStatusLines(orientView.initiativeStatus));
-            lines.push(...formatWorkstreamHealthLines(orientView.workstreamHealth));
-            lines.push(...formatWhatNeedsAttentionLines(orientView.whatNeedsAttention));
-            if (orientView.trustMetrics) {
-              const tm = orientView.trustMetrics;
-              if (tm.verified > 0 || tm.unverified > 0) {
-                const capNote = tm.scannedCap ? " (capped at 500)" : "";
-                lines.push("## Trust metrics");
-                lines.push(`_Entry verification status across workspace${capNote}._`);
-                lines.push("");
-                lines.push(`- **Verified:** ${tm.verified}`);
-                lines.push(`- **Unverified:** ${tm.unverified}`);
-                lines.push(`- **No status (pre-BET-240):** ${tm.noStatus}`);
-                lines.push(`- **Total scanned:** ${tm.total}`);
-                lines.push("");
-              }
-            }
-          }
-          if (fullCoherence) {
-            lines.push(...fullCoherence.lines);
-          }
-          if (allCollections.length > 0) {
-            const docCompleteness = buildDocCompletenessSection(allCollections);
-            if (docCompleteness.errorCount > 0 || docCompleteness.warningCount > 0) {
-              lines.push(...docCompleteness.lines);
-            }
-          }
-          if (orientView) {
-            if (orientView.activeWorkPackages?.length > 0) {
-              lines.push("## Active work packages \u2014 current scope");
-              lines.push("_Work outside these work packages requires explicit user confirmation._");
-              lines.push("");
-              for (const e of orientView.activeWorkPackages) {
-                lines.push(fmt(e));
-                const tensions = e.linkedTensions;
-                if (tensions?.length) {
-                  const tensionLines = tensions.map((t) => {
-                    const meta = [t.severity, t.priority].filter(Boolean).join(", ");
-                    return `\`${t.entryId ?? t.name}\` (${t.name}${meta ? `, ${meta}` : ""})`;
-                  });
-                  lines.push(`  Tensions: ${tensionLines.join("; ")}`);
-                }
-              }
-              lines.push("");
-            }
-            if (orientView.activeGoals?.length > 0) {
-              lines.push("## Active goals");
-              orientView.activeGoals.forEach((e) => lines.push(fmt(e)));
-              lines.push("");
-            }
-            if (orientView.strategyHighlights?.length > 0) {
-              lines.push("## Strategy highlights");
-              lines.push("_One-sentence strategy, positioning, moat, business model, GTM \u2014 high-level strategic context._");
-              lines.push("");
-              orientView.strategyHighlights.forEach((e) => lines.push(fmt(e)));
-              lines.push("");
-            }
-            if (orientView.playingField?.length > 0) {
-              lines.push("## Playing field");
-              lines.push("_Products and opportunities in the strategic landscape._");
-              lines.push("");
-              orientView.playingField.forEach((e) => lines.push(fmt(e)));
-              lines.push("");
-            }
-            if (orientView.recentDecisions?.length > 0) {
-              lines.push("## Recent decisions");
-              orientView.recentDecisions.forEach((e) => lines.push(fmt(e)));
-              lines.push("");
-            }
-            if (orientView.recentlySuperseded?.length > 0) {
-              lines.push("## Recently superseded");
-              orientView.recentlySuperseded.forEach((e) => lines.push(fmt(e)));
-              lines.push("");
-            }
-            if (orientView.staleEntries?.length > 0) {
-              lines.push("## Needs confirmation");
-              lines.push(`_Domain stratum entries not confirmed in ${orientView.stalenessThresholdDays} days._`);
-              orientView.staleEntries.forEach((e) => lines.push(fmt(e)));
-              lines.push("");
-            }
-            if (orientView.architectureNotes?.length > 0) {
-              lines.push("## Architecture notes");
-              orientView.architectureNotes.forEach((e) => lines.push(fmt(e)));
-              lines.push("");
-            }
-            const mapGovernanceEntry = (e) => ({
-              entryId: e.entryId,
-              name: e.name,
-              description: typeof e.preview === "string" ? e.preview : void 0,
-              tier: typeof e.tier === "number" ? e.tier : void 0,
-              // Phase 4 (DEC-1141): thread provenance fields to buildOperatingProtocol.
-              provenance: e.provenance,
-              anchoredBy: typeof e.anchoredBy === "string" ? e.anchoredBy : void 0
-            });
-            const gov = orientView.governance ?? { principles: [], standards: [], businessRules: [] };
-            lines.push(...buildOperatingProtocol({
-              principles: (gov.principles ?? []).map(mapGovernanceEntry),
-              standards: (gov.standards ?? []).map(mapGovernanceEntry),
-              businessRules: (gov.businessRules ?? []).map(mapGovernanceEntry)
-            }, task));
-          }
-          let allEntries = [];
-          try {
-            allEntries = await kernelQuery("chain.listEntries", {}) ?? [];
-          } catch {
-          }
-          const plannedWork = buildPlannedWork(allEntries);
-          if (hasPlannedWork(plannedWork)) {
-            lines.push(...buildPlannedWorkSection(plannedWork, priorSessions, recoveryBlock));
-          } else if (recoveryBlock) {
-            lines.push(...formatRecoveryBlock(recoveryBlock));
-          }
-        } else {
-          lines.push(`**Brain stage: ${orientStage}.**`);
+        }
+        if (orientView.staleEntries?.length > 0) {
+          lines.push("## Needs confirmation");
+          lines.push(`_Domain stratum entries not confirmed in ${orientView.stalenessThresholdDays} days._`);
+          orientView.staleEntries.forEach((e) => lines.push(fmt(e)));
           lines.push("");
-          if (orientView?.activeWorkPackages?.length) {
-            lines.push("## Active work packages \u2014 current scope");
-            lines.push("_Work outside these work packages requires explicit user confirmation._");
-            lines.push("");
-            for (const e of orientView.activeWorkPackages) {
-              lines.push(fmt(e));
-            }
-            lines.push("");
-          }
-          lines.push(...formatInitiativeStatusLines(orientView?.initiativeStatus));
-          lines.push(...formatWorkstreamHealthLines(orientView?.workstreamHealth));
-          lines.push(...formatWhatNeedsAttentionLines(orientView?.whatNeedsAttention));
-          if (orientView?.trustMetrics) {
-            const tm = orientView.trustMetrics;
-            if (tm.verified > 0 || tm.unverified > 0) {
-              const capNote = tm.scannedCap ? " (capped at 500)" : "";
-              lines.push("## Trust metrics");
-              lines.push(`_Entry verification status across workspace${capNote}._`);
-              lines.push("");
-              lines.push(`- **Verified:** ${tm.verified}`);
-              lines.push(`- **Unverified:** ${tm.unverified}`);
-              lines.push(`- **No status (pre-BET-240):** ${tm.noStatus}`);
-              lines.push(`- **Total scanned:** ${tm.total}`);
-              lines.push("");
-            }
-          }
-          lines.push(...buildOperatingProtocol());
-          if (fullCoherence) {
-            lines.push(...fullCoherence.lines);
-          }
-          if (allCollections.length > 0) {
-            const docCompleteness = buildDocCompletenessSection(allCollections);
-            if (docCompleteness.errorCount > 0 || docCompleteness.warningCount > 0) {
-              lines.push(...docCompleteness.lines);
-            }
-          }
-          if (priorSessions.length > 0 && !recoveryBlock) {
-            const last = priorSessions[0];
-            const date = last.startedAt ? new Date(last.startedAt).toISOString().split("T")[0] : "unknown";
-            const created = Array.isArray(last.entriesCreated) ? last.entriesCreated.length : last.entriesCreated ?? 0;
-            const modified = Array.isArray(last.entriesModified) ? last.entriesModified.length : last.entriesModified ?? 0;
-            lines.push(`_Last session (${date}): ${created} created, ${modified} modified._`);
-            lines.push("");
-          }
-          if (recoveryBlock) {
-            lines.push(...formatRecoveryBlock(recoveryBlock));
-          }
-          lines.push("**What are you working on?** Tell me and I'll load relevant governance and context.");
+        }
+        if (orientView.architectureNotes?.length > 0) {
+          lines.push("## Architecture notes");
+          orientView.architectureNotes.forEach((e) => lines.push(fmt(e)));
           lines.push("");
         }
+        const mapGovernanceEntry = (e) => ({
+          entryId: e.entryId,
+          name: e.name,
+          description: typeof e.preview === "string" ? e.preview : void 0,
+          tier: typeof e.tier === "number" ? e.tier : void 0,
+          // Phase 4 (DEC-1141): thread provenance fields to buildOperatingProtocol.
+          provenance: e.provenance,
+          anchoredBy: typeof e.anchoredBy === "string" ? e.anchoredBy : void 0
+        });
+        const gov = orientView.governance ?? { principles: [], standards: [], businessRules: [] };
+        lines.push(...buildOperatingProtocol({
+          principles: (gov.principles ?? []).map(mapGovernanceEntry),
+          standards: (gov.standards ?? []).map(mapGovernanceEntry),
+          businessRules: (gov.businessRules ?? []).map(mapGovernanceEntry)
+        }, task));
+      }
+      let allEntries = [];
+      try {
+        allEntries = await kernelQuery("chain.listEntries", {}) ?? [];
+      } catch {
       }
-      const classificationGaps = readiness?.gaps?.filter((g) => g.id?.startsWith?.(PURPOSE_GAP_PREFIX)) ?? [];
-      if (classificationGaps.length > 0) {
-        lines.push("## Classification gaps");
-        lines.push("_Collections with weak purpose \u2014 entry classification may be inaccurate._");
+      const plannedWork = buildPlannedWork(allEntries);
+      if (hasPlannedWork(plannedWork)) {
+        lines.push(...buildPlannedWorkSection(plannedWork, priorSessions, recoveryBlock));
+      } else if (recoveryBlock) {
+        lines.push(...formatRecoveryBlock(recoveryBlock));
+      }
+    } else {
+      lines.push(`**Brain stage: ${orientStage}.**`);
+      lines.push("");
+      if (orientView?.activeWorkPackages?.length) {
+        lines.push("## Active work packages \u2014 current scope");
+        lines.push("_Work outside these work packages requires explicit user confirmation._");
         lines.push("");
-        for (const g of classificationGaps) {
-          lines.push(`- ${g.label ?? g.id?.replace?.("purpose-gap-", "") ?? "unknown"}`);
+        for (const e of orientView.activeWorkPackages) {
+          lines.push(fmt(e));
         }
         lines.push("");
       }
-      if (errors.length > 0) {
-        lines.push("## Errors");
-        for (const err of errors) lines.push(`- ${err}`);
-        lines.push("");
-      }
-      let orientationStatus = "no_session";
-      if (agentSessionId && hasTaskGrounding) {
-        const orientedOk = await markOrientedWithSnapshotFallback(agentSessionId, fullCoherenceSnapshot);
-        if (orientedOk) {
-          orientationStatus = "complete";
-          lines.push("---");
-          lines.push(`Orientation complete. Session ${agentSessionId}. Write tools available.`);
-        } else {
-          orientationStatus = "failed";
-          lines.push("---");
-          lines.push("_Warning: Could not mark session as oriented. Write tools may be restricted._");
+      lines.push(...formatInitiativeStatusLines(orientView?.initiativeStatus));
+      lines.push(...formatWorkstreamHealthLines(orientView?.workstreamHealth));
+      lines.push(...formatWhatNeedsAttentionLines(orientView?.whatNeedsAttention));
+      if (orientView?.trustMetrics) {
+        const tm = orientView.trustMetrics;
+        if (tm.verified > 0 || tm.unverified > 0) {
+          const capNote = tm.scannedCap ? " (capped at 500)" : "";
+          lines.push("## Trust metrics");
+          lines.push(`_Entry verification status across workspace${capNote}._`);
+          lines.push("");
+          lines.push(`- **Verified:** ${tm.verified}`);
+          lines.push(`- **Unverified:** ${tm.unverified}`);
+          lines.push(`- **No status (pre-BET-240):** ${tm.noStatus}`);
+          lines.push(`- **Total scanned:** ${tm.total}`);
+          lines.push("");
         }
-        try {
-          await kernelMutation("chain.recordSessionSignal", {
-            sessionId: agentSessionId,
-            signalType: "immediate_context_load",
-            metadata: { source: "orient" }
-          });
-        } catch (err) {
-          process.stderr.write(`[MCP] recordSessionSignal failed: ${err.message}
-`);
+      }
+      lines.push(...buildOperatingProtocol());
+      if (fullCoherence) {
+        lines.push(...fullCoherence.lines);
+      }
+      if (allCollections.length > 0) {
+        const docCompleteness = buildDocCompletenessSection(allCollections);
+        if (docCompleteness.errorCount > 0 || docCompleteness.warningCount > 0) {
+          lines.push(...docCompleteness.lines);
         }
-      } else if (agentSessionId) {
-        orientationStatus = "task_required";
-        lines.push("---");
-        lines.push('Workspace orientation loaded. Write tools stay locked until you run `orient task="describe the work"`.');
-      } else {
-        lines.push("---");
-        lines.push("_No active agent session. Call `session action=start` to begin a tracked session._");
       }
-      const fullTruncated = orientView?._budget?.truncated ?? orientView?._truncated ?? false;
-      if (fullTruncated) {
-        const reasons = orientView?._budget?.truncationReasons;
+      if (priorSessions.length > 0 && !recoveryBlock) {
+        const last = priorSessions[0];
+        const date = last.startedAt ? new Date(last.startedAt).toISOString().split("T")[0] : "unknown";
+        const created = Array.isArray(last.entriesCreated) ? last.entriesCreated.length : last.entriesCreated ?? 0;
+        const modified = Array.isArray(last.entriesModified) ? last.entriesModified.length : last.entriesModified ?? 0;
+        lines.push(`_Last session (${date}): ${created} created, ${modified} modified._`);
         lines.push("");
-        if (reasons && reasons.length > 0) {
-          lines.push(`_Context truncated to fit tier budget: ${reasons.join(", ")}. Use tier=full for complete payload._`);
-        } else {
-          lines.push("_Context truncated to fit tier budget. Use tier=full for complete payload._");
-        }
       }
-      const fullResult = {
-        content: [{ type: "text", text: lines.join("\n") }],
-        structuredContent: success(
-          `Oriented (full). Stage: ${orientStage}. ${isLowReadiness ? "Low readiness \u2014 gaps remain." : "Ready."}`,
-          {
-            mode: "full",
-            stage: orientStage,
-            oriented: hasTaskGrounding ? isSessionOriented() : false,
-            sessionId: agentSessionId,
-            taskGroundingStatus: hasTaskGrounding ? "task_scoped" : task ? "missing_task_context" : "workspace_only",
-            taskGroundingRequired: !hasTaskGrounding,
-            domainRetrieval: orientView?.startup?.domainRetrieval,
-            orientationStatus,
-            nextStep: hasTaskGrounding ? void 0 : 'Run `orient task="describe the work"` before substantive work.',
-            ...orientView?._budget ? { _budget: orientView._budget } : {}
-          }
-        )
-      };
-      reportOrientWrapperBytes(fullResult, fullTruncated);
-      return fullResult;
-    })
-  );
+      if (recoveryBlock) {
+        lines.push(...formatRecoveryBlock(recoveryBlock));
+      }
+      lines.push("**What are you working on?** Tell me and I'll load relevant governance and context.");
+      lines.push("");
+    }
+  }
+  const classificationGaps = readiness?.gaps?.filter((g) => g.id?.startsWith?.(PURPOSE_GAP_PREFIX)) ?? [];
+  if (classificationGaps.length > 0) {
+    lines.push("## Classification gaps");
+    lines.push("_Collections with weak purpose \u2014 entry classification may be inaccurate._");
+    lines.push("");
+    for (const g of classificationGaps) {
+      lines.push(`- ${g.label ?? g.id?.replace?.("purpose-gap-", "") ?? "unknown"}`);
+    }
+    lines.push("");
+  }
+  if (errors.length > 0) {
+    lines.push("## Errors");
+    for (const err of errors) lines.push(`- ${err}`);
+    lines.push("");
+  }
+  let orientationStatus = "no_session";
+  if (agentSessionId && hasTaskGrounding) {
+    const orientedOk = await markOrientedWithSnapshotFallback(agentSessionId, fullCoherenceSnapshot);
+    if (orientedOk) {
+      orientationStatus = "complete";
+      lines.push("---");
+      lines.push(`Orientation complete. Session ${agentSessionId}. Write tools available.`);
+    } else {
+      orientationStatus = "failed";
+      lines.push("---");
+      lines.push("_Warning: Could not mark session as oriented. Write tools may be restricted._");
+    }
+    try {
+      await kernelMutation("chain.recordSessionSignal", {
+        sessionId: agentSessionId,
+        signalType: "immediate_context_load",
+        metadata: { source: "orient" }
+      });
+    } catch (err) {
+      process.stderr.write(`[MCP] recordSessionSignal failed: ${err.message}
+`);
+    }
+  } else if (agentSessionId) {
+    orientationStatus = "task_required";
+    lines.push("---");
+    lines.push('Workspace orientation loaded. Write tools stay locked until you run `orient task="describe the work"`.');
+  } else {
+    lines.push("---");
+    lines.push("_No active agent session. Call `session action=start` to begin a tracked session._");
+  }
+  const fullTruncated = orientView?._budget?.truncated ?? orientView?._truncated ?? false;
+  if (fullTruncated) {
+    const reasons = orientView?._budget?.truncationReasons;
+    lines.push("");
+    if (reasons && reasons.length > 0) {
+      lines.push(`_Context truncated to fit tier budget: ${reasons.join(", ")}. Use tier=full for complete payload._`);
+    } else {
+      lines.push("_Context truncated to fit tier budget. Use tier=full for complete payload._");
+    }
+  }
+  const fullResult = {
+    content: [{ type: "text", text: lines.join("\n") }],
+    structuredContent: success(
+      `Oriented (full). Stage: ${orientStage}. ${isLowReadiness ? "Low readiness \u2014 gaps remain." : "Ready."}`,
+      {
+        mode: "full",
+        stage: orientStage,
+        oriented: hasTaskGrounding ? isSessionOriented() : false,
+        sessionId: agentSessionId,
+        taskGroundingStatus: hasTaskGrounding ? "task_scoped" : task ? "missing_task_context" : "workspace_only",
+        taskGroundingRequired: !hasTaskGrounding,
+        // STD-219 §4 (DEC-1147): machine-readable stub flag for agent consumers.
+        ...orientView?.taskContext?.isGroundingStub ? { groundingStub: true } : {},
+        domainRetrieval: orientView?.startup?.domainRetrieval,
+        orientationStatus,
+        nextStep: hasTaskGrounding ? void 0 : 'Run `orient task="describe the work"` before substantive work.',
+        ...orientView?._budget ? { _budget: orientView._budget } : {}
+      }
+    )
+  };
+  reportOrientWrapperBytes(fullResult, fullTruncated, resolvedTier, taskIsMeaningful(task));
+  return fullResult;
 }
 
 // src/tools/health.ts
@@ -15204,4 +15222,4 @@ export {
   createProductBrainServer,
   initFeatureFlags
 };
-//# sourceMappingURL=chunk-ZPK5CSCQ.js.map
+//# sourceMappingURL=chunk-7BKN47NY.js.map