@productbrain/cli 0.1.0-beta.5 → 0.1.0-beta.5060

package/dist/commands/orient.d.ts

@@ -1,43 +1,91 @@
 /**
  * pb orient — prints workspace stage and all orient sections per ARCH-25.
+ * BET-181 Slice 0: routes through runCliCommand for JSON-default output.
  */
+import { type OrientView } from '../formatters/orient.js';
+import type { OrientDirectionStrategyHighlight } from '../formatters/orientDirection.js';
 export interface OrientViewFromApi {
     stage: string;
+    /**
+     * WP-465 slice ③ (DEC-1277 §4.1): server-computed pre-build task-alignment
+     * verdict — top-level + budget-exempt on the Convex view; passed through
+     * verbatim in JSON mode and rendered by the formatter in pretty mode.
+     */
+    taskAlignment?: import('../formatters/orient.js').TaskAlignmentView;
+    /** WP-621 S1: which task preload(s), if any, degraded this run — passed through in JSON mode,
+     *  rendered as a warning line by the formatter in pretty/brief mode. */
+    degradedPreloads?: string[];
+    retrievalMiss?: import('../formatters/orient.js').RetrievalMissView;
     strategicContext: {
         vision: string | null;
         purpose: string | null;
         activeBetCount: number;
-        currentBet: string | null;
+        activeWorkPackageCount: number;
+        /** WP-436 S4: canonical field — legacy currentBet dropped. */
+        currentWorkPackage: string | null;
         activeTensionCount: number;
         productAreas: string[];
         productAreaCount: number;
     };
-    activeBets: Array<{
+    /** WP-622 (grounding S2): metadata-driven strategy/principle highlights. */
+    strategyHighlights?: OrientDirectionStrategyHighlight[];
+    /** WP-436 S4: canonical field — legacy activeBets dropped. */
+    activeWorkPackages: Array<{
         entryId: string | null;
         name: string;
         collectionSlug: string | null;
         status: string;
         preview?: string;
+        origin?: 'human' | 'agent' | 'external';
         linkedTensions?: Array<{
             entryId: string | null;
             name: string;
         }>;
+        /** WP-485 Slice 1 (R1, FEAT-1368); TEN-2746 §2c part 3 added 'stale'. See
+         *  formatters/orient.ts OrientView — this is a THIRD independent structural mirror
+         *  (raw-API-response shape, pre-normalizeView) found verifying the spec's "both
+         *  spots" claim against current code; kept in sync by hand alongside the other two. */
+        coherencyCheckStatus?: 'not_checked' | 'check_incomplete' | 'stale';
     }>;
     governance?: {
         principles: Array<{
             entryId: string | null;
             name: string;
+            collectionSlug: string | null;
+            status: string;
             preview?: string;
+            scoreFlags?: string[];
+            origin?: 'human' | 'agent' | 'external';
+            provenance?: 'authoritative' | 'provisional' | 'floor';
+            anchoredBy?: string;
+            why?: string;
+            whyQuality?: 'rationale' | 'missing' | 'restated';
         }>;
         standards: Array<{
             entryId: string | null;
             name: string;
+            collectionSlug: string | null;
+            status: string;
             preview?: string;
+            scoreFlags?: string[];
+            origin?: 'human' | 'agent' | 'external';
+            provenance?: 'authoritative' | 'provisional' | 'floor';
+            anchoredBy?: string;
+            why?: string;
+            whyQuality?: 'rationale' | 'missing' | 'restated';
         }>;
         businessRules: Array<{
             entryId: string | null;
             name: string;
+            collectionSlug: string | null;
+            status: string;
             preview?: string;
+            scoreFlags?: string[];
+            origin?: 'human' | 'agent' | 'external';
+            provenance?: 'authoritative' | 'provisional' | 'floor';
+            anchoredBy?: string;
+            why?: string;
+            whyQuality?: 'rationale' | 'missing' | 'restated';
         }>;
     };
     tensions?: Array<{
@@ -48,6 +96,10 @@ export interface OrientViewFromApi {
         entryId: string | null;
         name: string;
         preview?: string;
+        provenance?: 'authoritative' | 'provisional' | 'floor';
+        anchoredBy?: string;
+        why?: string;
+        whyQuality?: 'rationale' | 'missing' | 'restated';
     }>;
     proposals?: Array<{
         targetEntryName: string;
@@ -60,10 +112,142 @@ export interface OrientViewFromApi {
         message: string;
         suggestion?: string;
     }>;
+    startup?: {
+        groundingStatus: 'grounded' | 'partial' | 'missing';
+        confidence: string;
+        totalFound: number;
+        seeds: Array<{
+            entryId: string | null;
+            name: string;
+            collectionSlug: string | null;
+            provenance?: 'authoritative' | 'provisional' | 'floor';
+            anchoredBy?: string;
+            why?: string;
+            whyQuality?: 'rationale' | 'missing' | 'restated';
+        }>;
+        bindingGovernance: {
+            principles: Array<{
+                entryId: string | null;
+                name: string;
+                collectionSlug: string | null;
+                preview?: string;
+                provenance?: 'authoritative' | 'provisional' | 'floor';
+                anchoredBy?: string;
+                why?: string;
+                whyQuality?: 'rationale' | 'missing' | 'restated';
+            }>;
+            standards: Array<{
+                entryId: string | null;
+                name: string;
+                collectionSlug: string | null;
+                preview?: string;
+                provenance?: 'authoritative' | 'provisional' | 'floor';
+                anchoredBy?: string;
+                why?: string;
+                whyQuality?: 'rationale' | 'missing' | 'restated';
+            }>;
+            businessRules: Array<{
+                entryId: string | null;
+                name: string;
+                collectionSlug: string | null;
+                preview?: string;
+                provenance?: 'authoritative' | 'provisional' | 'floor';
+                anchoredBy?: string;
+                why?: string;
+                whyQuality?: 'rationale' | 'missing' | 'restated';
+            }>;
+            byCollection?: Array<{
+                collectionSlug: string | null;
+                collectionName: string | null;
+                canonicalKey: string | null;
+                entries: Array<{
+                    entryId: string | null;
+                    name: string;
+                    collectionSlug: string | null;
+                    preview?: string;
+                    provenance?: 'authoritative' | 'provisional' | 'floor';
+                    anchoredBy?: string;
+                    why?: string;
+                    whyQuality?: 'rationale' | 'missing' | 'restated';
+                }>;
+            }>;
+        };
+        domainRetrieval?: {
+            state: string;
+            resolvedDomainSlug?: string;
+            fallbackReason?: string;
+            fallbackAction?: string;
+            evidenceGap?: string;
+            directRatifiedCount?: number;
+            inheritedRatifiedCount?: number;
+            orgFallbackCount?: number;
+            activeSource?: string;
+            legacyUnauditedCount?: number;
+            invalidRelationCount?: number;
+            resolutionConfidence?: 'low' | 'medium' | 'high';
+            resolutionSource?: string;
+        };
+        steeringContext: Array<{
+            entryId: string | null;
+            name: string;
+            collectionSlug: string | null;
+            score: number;
+            hop: number;
+            preview?: string;
+            origin?: 'human' | 'agent' | 'external';
+        }>;
+        supportingContext: Array<{
+            entryId: string | null;
+            name: string;
+            collectionSlug: string | null;
+            score: number;
+            hop: number;
+            preview?: string;
+            origin?: 'human' | 'agent' | 'external';
+        }>;
+        taskProfile: {
+            workType: string;
+            domain: string;
+            keywords: string[];
+        };
+    };
+    taskContext?: {
+        seeds: Array<{
+            entryId: string | null;
+            name: string;
+            collectionSlug: string | null;
+            provenance?: 'authoritative' | 'provisional' | 'floor';
+            anchoredBy?: string;
+            why?: string;
+            whyQuality?: 'rationale' | 'missing' | 'restated';
+        }>;
+        context: Array<{
+            entryId: string | null;
+            name: string;
+            collectionSlug: string | null;
+            score: number;
+            hop: number;
+            origin?: 'human' | 'agent' | 'external';
+            provenance?: 'authoritative' | 'provisional' | 'floor';
+            anchoredBy?: string;
+            why?: string;
+            whyQuality?: 'rationale' | 'missing' | 'restated';
+        }>;
+        totalFound: number;
+        confidence: string;
+        /** STD-219 §4 (DEC-1147): set when taskContext is a truncation stub, not full grounding. */
+        isGroundingStub?: true;
+        groundingNote?: string;
+    };
     plannedWork?: {
         uncommittedDrafts: Array<{
             name: string;
             collection: string;
+            why?: string;
+            whyQuality?: 'rationale' | 'missing' | 'restated';
+            visibility?: string;
+            provenance?: 'authoritative' | 'provisional' | 'floor';
+            anchoredBy?: string;
         }>;
         inProgressEntries: Array<{
             name: string;
@@ -79,22 +263,70 @@ export interface OrientViewFromApi {
         sessionId: string;
         status: string;
         startedAt: number;
+        closedAt?: number;
         entriesCreated: string[];
         entriesModified: string[];
+        relationsCreated: number;
     }>;
     recoveryBlock?: {
         sessionId: string;
-        status: string;
+        status: 'timed_out' | 'completed';
         date: string;
         duration: string;
+        created: Array<{
+            entryId: string;
+            collection: string;
+            name: string;
+        }>;
+        modified: Array<{
+            entryId: string;
+            collection: string;
+            name: string;
+        }>;
         draftsNeedingAttention: Array<{
             entryId: string;
             collection: string;
             name: string;
         }>;
+        relationsCreated: number;
+        createdOverflow?: number;
+        modifiedOverflow?: number;
+        draftsOverflow?: number;
     } | null;
+    writeBackHints?: Array<{
+        collectionSlug: string;
+        hint: string;
+    }>;
+    /** WP-376 α.0: orient view sets this when any input scan hit its limit. */
+    _truncated?: boolean;
+    _budget?: {
+        bytes: number;
+        truncated: boolean;
+        truncationReasons: string[];
+        overflowed: boolean;
+    };
+    /** WP-377: schema version for orient response. */
+    _schemaVersion?: 1;
+    /** WP-480 S3 (FEAT-1360): server-resolved task-meaningfulness — optional for old deploys. */
+    taskMeaningful?: boolean;
+    /** WP-480 S3: the server's OWN tier resolution for this serve — optional for old deploys. */
+    resolvedTier?: 'summary' | 'standard' | 'full';
+    /** WP-557 occupancy: see formatters/orient.ts's OrientView — this is a THIRD independent
+     *  structural mirror (raw-API-response shape, pre-normalizeView), same class as
+     *  coherencyCheckStatus above; kept in sync by hand alongside the other two. */
+    shapeAdvisorySummary?: import('../formatters/orient.js').OrientView['shapeAdvisorySummary'];
 }
+/**
+ * Normalize the raw API view into the formatter's `OrientView` shape (optional
+ * sections become empty arrays / null, not absent). Exported so other surfaces
+ * (e.g. `pb codex-prep`) route their API view through the SAME normalizer the
+ * canonical `pb orient` path uses, instead of re-deriving fields ad hoc.
+ */
+export declare function normalizeView(raw: OrientViewFromApi): OrientView;
 export declare function runOrient(options?: {
     brief?: boolean;
+    task?: string;
+    scope?: string;
+    full?: boolean;
 }): Promise<void>;
 //# sourceMappingURL=orient.d.ts.map

package/dist/commands/orient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orient.d.ts","sourceRoot":"","sources":["../../src/commands/orient.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"orient.d.ts","sourceRoot":"","sources":["../../src/commands/orient.ts"],"names":[],"mappings":"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"}

package/dist/commands/orient.js

@@ -1,10 +1,93 @@
 /**
  * pb orient — prints workspace stage and all orient sections per ARCH-25.
+ * BET-181 Slice 0: routes through runCliCommand for JSON-default output.
  */
-import { getConfigOrGuide } from '../lib/config.js';
-import { mcpCall } from '../lib/client.js';
+import { getConfig, getConfigOrGuide } from '../lib/config.js';
+import { kernelCall } from '../lib/client.js';
+import { runCliCommand, isJsonMode } from '../lib/runner.js';
+import { stripConvexInternals } from '../lib/strip.js';
 import { formatOrient, formatOrientBrief } from '../formatters/orient.js';
-function normalizeView(raw) {
+import { getOrFetchVocabCtx } from '../lib/workspaceVocabCache.js';
+import { discardSession, readSession } from '../lib/session.js';
+import { collectCliStartupSignals } from '../lib/startup-signals.js';
+/**
+ * The orient read is useful even when its optional local session marker has gone stale on the
+ * server. Only the three lifecycle failures that prove that marker can no longer be used are
+ * recoverable here; ownership/workspace/auth failures still surface instead of being hidden.
+ */
+function isStaleSessionMarkerError(error) {
+    if (!(error instanceof Error) || error.name !== 'McpError')
+        return false;
+    const code = error.code;
+    if (code !== 'MCP_GATEWAY_CLIENT' && code !== 'SESSION_REQUIRED')
+        return false;
+    return error.message === 'Agent session not found'
+        || error.message === 'Agent session has expired (8-hour maximum exceeded)'
+        || /^Agent session is .+, not active$/.test(error.message);
+}
+/**
+ * WP-376 α.3: fire-and-forget orient byte report from the CLI surface.
+ *
+ * Inlined raw fetch (vs `kernelCall`) for three reasons:
+ *   1. No spinner — observability must not show user-visible progress
+ *      indicators after the orient render completes.
+ *   2. Truly fire-and-forget — never block returning to the shell on a
+ *      slow gateway, never propagate errors to the user.
+ *   3. Avoids the post-write session-touch heartbeat (kernelCallWithSession)
+ *      — orient byte report is itself a heartbeat-equivalent observability
+ *      write, so a follow-up agent.touchSession is redundant (parallel to
+ *      MCP's TOUCH_EXCLUDED exemption in client.ts).
+ *
+ * The gateway's `injectSessionAuth` (BR-18) resolves workspaceId / apiKeyId /
+ * clerkUserId from the bearer token, so the surface only sends payload bytes
+ * + truncation flag. Auth and identity stay server-side.
+ */
+// WP-480 S3 (FEAT-1360): the taskIsMeaningful predicate mirror is DELETED — the
+// server resolves task-meaningfulness + effective tier and serves them on the
+// orient payload (`taskMeaningful`, `resolvedTier`); this surface consumes them.
+// DEC-NEW: reports the resolved tier + task-presence alongside bytes + truncated.
+function reportOrientCliBytes(bytes, truncated, tier, taskProvided) {
+    let apiKey;
+    let siteUrl;
+    try {
+        ({ apiKey, siteUrl } = getConfig());
+    }
+    catch {
+        // No config — best-effort observability never fails the command.
+        return;
+    }
+    // Thread the active session context (Codex re-review): without it, the server's N-per-key
+    // ambiguity guard skips the rendered-byte update when a key has >1 active conversation — the whole
+    // point of this public report route is the surface-rendered metric.
+    const active = readSession();
+    void fetch(`${siteUrl}/api/aki`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${apiKey}`,
+        },
+        body: JSON.stringify({
+            fn: 'agent.reportOrientMetric',
+            args: {
+                bytes,
+                truncated,
+                tier,
+                taskProvided,
+                ...(active?.sessionId ? { sessionId: active.sessionId } : {}),
+                ...(active?.conversationId ? { conversationId: active.conversationId } : {}),
+            },
+        }),
+    }).catch(() => {
+        // Best-effort — silently swallow.
+    });
+}
+/**
+ * Normalize the raw API view into the formatter's `OrientView` shape (optional
+ * sections become empty arrays / null, not absent). Exported so other surfaces
+ * (e.g. `pb codex-prep`) route their API view through the SAME normalizer the
+ * canonical `pb orient` path uses, instead of re-deriving fields ad hoc.
+ */
+export function normalizeView(raw) {
     return {
         ...raw,
         governance: raw.governance ?? {
@@ -12,10 +95,13 @@ function normalizeView(raw) {
             standards: [],
             businessRules: [],
         },
+        strategyHighlights: raw.strategyHighlights ?? [],
         tensions: raw.tensions ?? [],
         architectureNotes: raw.architectureNotes ?? [],
         proposals: raw.proposals ?? [],
         absenceSignals: raw.absenceSignals ?? [],
+        startup: raw.startup,
+        taskContext: raw.taskContext,
         plannedWork: raw.plannedWork ?? {
             uncommittedDrafts: [],
             inProgressEntries: [],
@@ -26,16 +112,162 @@ function normalizeView(raw) {
     };
 }
 export async function runOrient(options = {}) {
+    // BET-279: --scope without --task is a silent no-op — warn the caller.
+    if (options.scope && !options.task) {
+        console.warn('Warning: --scope requires --task to filter governance. Scope was ignored.');
+    }
     const config = await getConfigOrGuide(() => runOrient(options));
     if (!config)
         return;
-    const raw = await mcpCall('chain.getOrientView', {});
-    const view = normalizeView(raw);
-    if (options.brief) {
-        console.log(formatOrientBrief(view));
-    }
-    else {
-        console.log(formatOrient(view));
+    // WP-436 S2: resolve workspace vocabulary context (Axis 2, PAT-230, DEC-1021).
+    // Uses the API key as the cache key (1:1 with workspace at CLI layer).
+    // Fail-open: if chain.getVocabulary is unreachable, resolver falls back to canonicalKey literal.
+    const vocabCtx = await getOrFetchVocabCtx(config.apiKey, async () => {
+        const vocab = await kernelCall('chain.getVocabulary', {});
+        if (vocab?.collectionLabels || vocab?.collectionDefaults) {
+            return {
+                ...(vocab.collectionLabels ? { collectionLabels: vocab.collectionLabels } : {}),
+                ...(vocab.collectionDefaults ? { collectionDefaults: vocab.collectionDefaults } : {}),
+            };
+        }
+        return null;
+    });
+    // WP-376 α.3: capture the view + raw flag from the closure so we can
+    // measure client-side rendered bytes after runCliCommand finishes.
+    let capturedView = null;
+    let capturedTruncated = false;
+    // WP-480 S3 (FEAT-1360): the served resolution (getOrientView is the payload
+    // owner) — undefined when an old deploy doesn't serve the fields yet.
+    let capturedResolvedTier;
+    let capturedTaskMeaningful;
+    await runCliCommand({
+        fn: async () => {
+            const callArgs = {};
+            if (options.task)
+                callArgs.task = options.task;
+            if (options.scope)
+                callArgs.scope = options.scope;
+            // WP-486 Slice 1 (FEAT-1371, TEN-2724): the primary orient path — this call — never sent
+            // the signals `resolveStartupDomain` already knows how to consume. `startupSignals` is
+            // sent unconditionally (harmless when no task is present — the server only threads it into
+            // domain resolution when a task is, and `context.served`'s presence telemetry benefits from
+            // an honest signal either way). `invocationPath` is NOT unconditional (PR #369 review,
+            // Codex): `kernel/telemetry/contextServed.ts`'s own `computeContextServed` comment
+            // ("Defaulting an unset invocationPath to 'manual-orient' conflated unattributed calls
+            // [base/workspace orients, bare `pb handshake`] with REAL manual `pb orient --task` rows")
+            // is an established contract this call must respect — a bare `pb orient` (no task) stays
+            // unattributed, exactly like it was before this slice. Only a task-shaped orient — the
+            // 'manual-orient' shape this constant actually names — stamps it.
+            const startupSignals = collectCliStartupSignals();
+            if (Object.keys(startupSignals).length > 0)
+                callArgs.startupSignals = startupSignals;
+            if (options.task)
+                callArgs.invocationPath = 'manual-orient';
+            // STD-219 §5 chain-versioned by DEC-NEW: surface forwards tier by key omission;
+            // kernel applies the task-conditional default via resolveEffectiveTier when tier unset.
+            if (options.full)
+                callArgs.tier = 'full';
+            // TEN-2449 + WP-479 review fix (Codex): declare the render mode EXPLICITLY as a tri-state so
+            // the server selects the rendered set once (and instruments the right coverage row). Rendering
+            // is per-invocation, which is why the caller — not a source header — is the one that can say
+            // this. The server must never INFER json from "non-brief": that mislabels this interactive
+            // pretty path as agent json traffic. Precedence: json mode (`--json` / non-TTY subprocess,
+            // where `-b --json` prints the FULL view) → 'json'; `-b` on a TTY → 'brief'; else the
+            // interactive human view → 'pretty' (deliberately uninstrumented).
+            if (isJsonMode())
+                callArgs.renderMode = 'json';
+            else if (options.brief)
+                callArgs.renderMode = 'brief';
+            else
+                callArgs.renderMode = 'pretty';
+            // WP-479 E3 stage 2 (TEN-2654): thread the EXPLICIT local session marker, when one exists,
+            // so the gateway can stamp the M1 emit rows with a real per-conversation sessionId/
+            // conversationId instead of leaving them null. `readSession()` returns null when no
+            // marker is active (no session started, or a legacy/foreign conversation) — feature-detect,
+            // never required: a bare `pb orient` with no active session still works, just unstamped.
+            const activeSession = readSession();
+            if (activeSession?.sessionId)
+                callArgs.sessionId = activeSession.sessionId;
+            if (activeSession?.conversationId)
+                callArgs.conversationId = activeSession.conversationId;
+            // WP-488 Slice 3 (FEAT-1377) — DEVIATION, documented (same root cause as
+            // packages/cli/src/commands/promote.ts's `chain.detectSemanticConflicts` call, see
+            // that comment for the full evidence): deriving this route's return type from
+            // kernel-client (`GatewayRouteReturnByName<'chain.getOrientView'>`, or a direct
+            // type-only import of `convex/agentKnowledge/orientView.ts`'s `getOrientView`) fails
+            // packages/cli's `rootDir: "src"` + `moduleResolution: "NodeNext"` — verified via the
+            // identical failure mode reproduced for the detectSemanticConflicts call. Left as the
+            // pre-existing hand-typed `OrientViewFromApi` generic; that interface is also
+            // consumed by codex-prep.ts / handshake.ts / tests, so replacing its DEFINITION with
+            // the derived type (rather than just this one call site) was independently out of
+            // scope for a "no behavior change" slice regardless of the tsconfig issue.
+            const raw = await kernelCall('chain.getOrientView', Object.keys(callArgs).length > 0 ? callArgs : {});
+            // An orient read and the session lifecycle transition are separate server operations.
+            // MCP already completes both; the CLI previously only forwarded the session id for
+            // attribution, leaving the session permanently unoriented and making every server-gated
+            // follow-up reject the normal `session start → orient → write` sequence. Complete the
+            // transition only when a local session exists; sessionless orient remains a read-only path.
+            // Codex P2 (PR #372): orientation unlocks server-gated writes, so it must only complete
+            // for a TASK-GROUNDED orient — the same hasTaskGrounding gate MCP applies
+            // (packages/mcp-server/src/tools/orient.ts: task provided AND the server returned real
+            // taskContext entries). A bare `pb orient` / `pb orient -b` stays a read.
+            const hasTaskGrounding = Boolean(options.task && (raw.taskContext?.context?.length ?? 0) > 0);
+            if (activeSession?.sessionId && hasTaskGrounding) {
+                try {
+                    await kernelCall('agent.markOriented', { sessionId: activeSession.sessionId });
+                }
+                catch (error) {
+                    if (!isStaleSessionMarkerError(error))
+                        throw error;
+                    // The read already succeeded. Remove only this conversation's unusable marker and
+                    // return the sessionless view; the next write will correctly require a fresh session.
+                    discardSession(activeSession.conversationId);
+                }
+            }
+            // Normalize before output in any mode — ensures JSON keys are stable
+            // for agent consumers (optional sections become empty arrays, not absent).
+            const view = normalizeView(raw);
+            capturedView = view;
+            // BET-β S3b parity with MCP: prefer the tier-budget signal (_budget.truncated),
+            // fall back to the legacy input-scan flag (_truncated). Summary-tier section
+            // dropping is reported via _budget.truncated only, so reading _truncated alone
+            // recorded lastOrientTruncated:false on the main path this change introduces.
+            capturedTruncated = raw._budget?.truncated ?? raw._truncated === true;
+            // WP-480 S3: capture the server's resolution off the payload.
+            capturedResolvedTier = raw.resolvedTier;
+            capturedTaskMeaningful = raw.taskMeaningful;
+            return view;
+        },
+        formatPretty: (view) => {
+            return options.brief ? formatOrientBrief(view, vocabCtx) : formatOrient(view, vocabCtx);
+        },
+    });
+    // WP-376 α.3: fire-and-forget byte report. Match what the user actually saw —
+    // JSON-stringified data for piped/JSON mode, formatted text for TTY.
+    if (capturedView != null) {
+        try {
+            let rendered;
+            if (isJsonMode()) {
+                rendered = JSON.stringify(stripConvexInternals(capturedView));
+            }
+            else {
+                rendered = options.brief ? formatOrientBrief(capturedView, vocabCtx) : formatOrient(capturedView, vocabCtx);
+            }
+            const bytes = Buffer.byteLength(rendered, 'utf8');
+            // WP-480 S3 (FEAT-1360): consume the SERVED resolution (the payload now
+            // carries `resolvedTier` + `taskMeaningful`; getOrientView is the payload
+            // owner). Old-deploy fallback, null-guarded like retrievalMiss: explicit
+            // --full is still client-known input (not a mirrored rule); else
+            // 'standard' / false — honestly degraded, never re-derived locally.
+            const resolvedTier = capturedResolvedTier ?? (options.full ? 'full' : 'standard');
+            reportOrientCliBytes(bytes, capturedTruncated, resolvedTier, capturedTaskMeaningful ?? false);
+            // Activation-telemetry context.served is no longer emitted here. It moved to the
+            // shared server-side seam (DEC-1207): the AKI gateway derives + emits it for EVERY
+            // connector that calls chain.getOrientView, so the CLI no longer carries its own copy.
+        }
+        catch {
+            // Best-effort observability — never fail the command on measurement.
+        }
     }
 }
 //# sourceMappingURL=orient.js.map

package/dist/commands/orient.js.map

@@ -1 +1 @@
-{"version":3,"file":"orient.js","sourceRoot":"","sources":["../../src/commands/orient.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AA4D1E,SAAS,aAAa,CAAC,GAAsB;IAC3C,OAAO;QACL,GAAG,GAAG;QACN,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI;YAC5B,UAAU,EAAE,EAAE;YACd,SAAS,EAAE,EAAE;YACb,aAAa,EAAE,EAAE;SAClB;QACD,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,EAAE;QAC5B,iBAAiB,EAAE,GAAG,CAAC,iBAAiB,IAAI,EAAE;QAC9C,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,EAAE;QAC9B,cAAc,EAAE,GAAG,CAAC,cAAc,IAAI,EAAE;QACxC,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI;YAC9B,iBAAiB,EAAE,EAAE;YACrB,iBAAiB,EAAE,EAAE;YACrB,YAAY,EAAE,EAAE;SACjB;QACD,aAAa,EAAE,GAAG,CAAC,aAAa,IAAI,EAAE;QACtC,aAAa,EAAE,GAAG,CAAC,aAAa,IAAI,IAAI;KACzC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,UAA+B,EAAE;IAC/D,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAChE,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,GAAG,GAAG,MAAM,OAAO,CAAoB,qBAAqB,EAAE,EAAE,CAAC,CAAC;IACxE,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IAEhC,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;IACvC,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;IAClC,CAAC;AACH,CAAC"}
+{"version":3,"file":"orient.js","sourceRoot":"","sources":["../../src/commands/orient.ts"],"names":[],"mappings":"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"}