@productbrain/cli 0.1.0-beta.88 → 0.1.0-beta.8802

package/dist/commands/organisationHierarchy.test.js.map

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

package/dist/commands/organisationWrite.d.ts

@@ -0,0 +1,18 @@
+type OrganisationWriteResult = {
+    outcome: 'applied';
+    [key: string]: unknown;
+} | {
+    outcome: 'refused';
+    refusal: {
+        code: string;
+        reason: string;
+        requiredAction?: string;
+    };
+};
+export declare function runOrganisationWrite<T extends OrganisationWriteResult>(call: (context: {
+    sessionId: string;
+}) => Promise<T>, formatApplied: (result: Extract<T, {
+    outcome: 'applied';
+}>) => string): Promise<void>;
+export {};
+//# sourceMappingURL=organisationWrite.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"organisationWrite.d.ts","sourceRoot":"","sources":["../../src/commands/organisationWrite.ts"],"names":[],"mappings":"AAMA,KAAK,uBAAuB,GACzB;IAAE,OAAO,EAAE,SAAS,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GAC9C;IACA,OAAO,EAAE,SAAS,CAAC;IACnB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAClE,CAAC;AAkDL,wBAAsB,oBAAoB,CAAC,CAAC,SAAS,uBAAuB,EAC3E,IAAI,EAAE,CAAC,OAAO,EAAE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,CAAC,CAAC,CAAC,EACpD,aAAa,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE;IAAE,OAAO,EAAE,SAAS,CAAA;CAAE,CAAC,KAAK,MAAM,GACnE,OAAO,CAAC,IAAI,CAAC,CAef"}

package/dist/commands/organisationWrite.js

@@ -0,0 +1,71 @@
+/** Shared session and refusal handling for organisation CLI resources. */
+import { CLIError, ErrorCode } from '../lib/errors.js';
+import { isJsonMode } from '../lib/runner.js';
+import { readSession } from '../lib/session.js';
+import { emitEffectiveTenantNotice } from '../lib/workspaceNotice.js';
+// WP-753 O5a fix round 2 (item a): CENSUS, not a generated mirror — these 13 codes span FOUR
+// separate sources, not one kernel union the generate-kernel-value-sets.mjs chassis could
+// derive a single TARGETS row from (round 1's fix for client.ts's ORGANISATIONAL_AUTHORITY_
+// REFUSAL_CODES worked because that was ONE kernel union; this set is not):
+//   - `duplicate_membership` — kernel/organisationalAuthority/managementTypes.ts's
+//     `OrganisationManagementDecision` refuse-code union (also re-exposed on
+//     `TeamHierarchyDecision` via `Exclude<OrganisationManagementDecision, ...>['code']`).
+//   - `child_team_invalid`, `parent_team_invalid`, `existing_parent_invalid`,
+//     `hierarchy_ambiguous`, `self_parent`, `hierarchy_cycle`, `hierarchy_too_deep`,
+//     `hierarchy_too_large`, `hierarchy_repair_required`, `archived_parent_authority_invalid` —
+//     kernel/organisationalAuthority/hierarchyTypes.ts's `TeamHierarchyDecision` refuse-code
+//     union (which also carries an 11th, `archived_parent_team_lead_required`, deliberately NOT
+//     in this Set — it IS an authority refusal, correctly routed below to AUTH_DENIED/'auth',
+//     not a validation gap to fix).
+//   - `last_team_lead` — NOT a kernel type at all: a Convex-adapter-only code
+//     (convex/governance/organisationResources.ts:32), so no kernel runtime const can cover it.
+//   - `role_still_held` — likewise Convex-adapter-only (convex/governance/organisationHierarchy.ts's
+//     role-move refusal, TASK-426), so no kernel runtime const can cover it either.
+// Per the coordinator's ruling: a merged generated list would be invented, not derived — this
+// stays a hand-maintained Set with its provenance named, not a TARGETS row.
+const VALIDATION_REFUSALS = new Set([
+    'duplicate_membership',
+    'last_team_lead',
+    'child_team_invalid',
+    'parent_team_invalid',
+    'existing_parent_invalid',
+    'hierarchy_ambiguous',
+    'self_parent',
+    'hierarchy_cycle',
+    'hierarchy_too_deep',
+    'hierarchy_too_large',
+    'hierarchy_repair_required',
+    'archived_parent_authority_invalid',
+    'role_still_held',
+]);
+function requireSessionId() {
+    const session = readSession();
+    if (!session) {
+        throw new CLIError('No active session.', {
+            code: ErrorCode.SESSION_REQUIRED,
+            category: 'session',
+            guidance: 'Run `pb session start` and orient to the organisation work before changing it.',
+        });
+    }
+    return session.sessionId;
+}
+export async function runOrganisationWrite(call, formatApplied) {
+    const sessionId = requireSessionId();
+    await emitEffectiveTenantNotice();
+    const result = await call({ sessionId });
+    if (result.outcome === 'refused') {
+        if (isJsonMode())
+            process.stdout.write(`${JSON.stringify(result)}\n`);
+        const validation = VALIDATION_REFUSALS.has(result.refusal.code);
+        throw new CLIError(result.refusal.reason, {
+            code: validation ? ErrorCode.VALIDATION_FAILED : ErrorCode.AUTH_DENIED,
+            category: validation ? 'validation' : 'auth',
+            guidance: result.refusal.requiredAction ?? 'Ask the relevant Team Lead to make this change.',
+        });
+    }
+    if (isJsonMode())
+        process.stdout.write(`${JSON.stringify(result)}\n`);
+    else
+        process.stdout.write(`${formatApplied(result)}\n`);
+}
+//# sourceMappingURL=organisationWrite.js.map

package/dist/commands/organisationWrite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"organisationWrite.js","sourceRoot":"","sources":["../../src/commands/organisationWrite.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAStE,6FAA6F;AAC7F,0FAA0F;AAC1F,4FAA4F;AAC5F,4EAA4E;AAC5E,mFAAmF;AACnF,6EAA6E;AAC7E,2FAA2F;AAC3F,8EAA8E;AAC9E,qFAAqF;AACrF,gGAAgG;AAChG,6FAA6F;AAC7F,gGAAgG;AAChG,8FAA8F;AAC9F,oCAAoC;AACpC,8EAA8E;AAC9E,gGAAgG;AAChG,qGAAqG;AACrG,oFAAoF;AACpF,8FAA8F;AAC9F,4EAA4E;AAC5E,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC;IACnC,sBAAsB;IACtB,gBAAgB;IAChB,oBAAoB;IACpB,qBAAqB;IACrB,yBAAyB;IACzB,qBAAqB;IACrB,aAAa;IACb,iBAAiB;IACjB,oBAAoB;IACpB,qBAAqB;IACrB,2BAA2B;IAC3B,mCAAmC;IACnC,iBAAiB;CACjB,CAAC,CAAC;AAEH,SAAS,gBAAgB;IACxB,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC;IAC9B,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,MAAM,IAAI,QAAQ,CAAC,oBAAoB,EAAE;YACxC,IAAI,EAAE,SAAS,CAAC,gBAAgB;YAChC,QAAQ,EAAE,SAAS;YACnB,QAAQ,EAAE,gFAAgF;SAC1F,CAAC,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC,SAAS,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACzC,IAAoD,EACpD,aAAqE;IAErE,MAAM,SAAS,GAAG,gBAAgB,EAAE,CAAC;IACrC,MAAM,yBAAyB,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;IACzC,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAClC,IAAI,UAAU,EAAE;YAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACtE,MAAM,UAAU,GAAG,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAChE,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE;YACzC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW;YACtE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM;YAC5C,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,cAAc,IAAI,iDAAiD;SAC5F,CAAC,CAAC;IACJ,CAAC;IACD,IAAI,UAAU,EAAE;QAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;;QACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,aAAa,CAAC,MAA4C,CAAC,IAAI,CAAC,CAAC;AAC/F,CAAC"}

package/dist/commands/orient.d.ts

@@ -1,19 +1,39 @@
 /**
- * pb orient — prints workspace stage and all orient sections per ARCH-25.
+ * pb orient — prints all orient sections per ARCH-25.
  * BET-181 Slice 0: routes through runCliCommand for JSON-default output.
  */
+import type { WhyQuality } from "@productbrain/kernel-client";
+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-771 S4 (TASK-295): ordered spine sections + objectives/KRs — absent on a legacy server
+     *  payload predating this field (round 1 review, Codex finding 1). */
+    strategicSpine?: import('../formatters/orientDirection.js').OrientStrategicSpineView;
+    /** 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;
@@ -24,36 +44,17 @@ export interface OrientViewFromApi {
             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';
-        }>;
-        standards: Array<{
-            entryId: string | null;
-            name: string;
-            collectionSlug: string | null;
-            status: string;
-            preview?: string;
-            scoreFlags?: string[];
-            origin?: 'human' | 'agent' | 'external';
-        }>;
-        businessRules: Array<{
-            entryId: string | null;
-            name: string;
-            collectionSlug: string | null;
-            status: string;
-            preview?: string;
-            scoreFlags?: string[];
-            origin?: 'human' | 'agent' | 'external';
-        }>;
-    };
+    /** TASK-436: matches formatters/orient.ts's `OrientView['ruleLists']` — see that type's own doc. */
+    ruleLists?: import('../formatters/orient.js').OrientView['ruleLists'];
+    /** TASK-552b: the briefing's facts. getOrientView always serves them (its route type says optional);
+     *  TASK-554's handshake throws on a view without them rather than write a spineless briefing. */
+    briefing?: import('../lib/ruleListRender.js').BriefingFactsView;
     tensions?: Array<{
         entryId: string | null;
         name: string;
@@ -62,11 +63,10 @@ export interface OrientViewFromApi {
         entryId: string | null;
         name: string;
         preview?: string;
-    }>;
-    proposals?: Array<{
-        targetEntryName: string;
-        proposedOperation: string;
-        hoursRemaining: number;
+        provenance?: 'authoritative' | 'provisional' | 'floor';
+        anchoredBy?: string;
+        why?: string;
+        whyQuality?: WhyQuality;
     }>;
     absenceSignals?: Array<{
         type: string;
@@ -82,27 +82,11 @@ export interface OrientViewFromApi {
             entryId: string | null;
             name: string;
             collectionSlug: string | null;
+            provenance?: 'authoritative' | 'provisional' | 'floor';
+            anchoredBy?: string;
+            why?: string;
+            whyQuality?: WhyQuality;
         }>;
-        bindingGovernance: {
-            principles: Array<{
-                entryId: string | null;
-                name: string;
-                collectionSlug: string | null;
-                preview?: string;
-            }>;
-            standards: Array<{
-                entryId: string | null;
-                name: string;
-                collectionSlug: string | null;
-                preview?: string;
-            }>;
-            businessRules: Array<{
-                entryId: string | null;
-                name: string;
-                collectionSlug: string | null;
-                preview?: string;
-            }>;
-        };
         steeringContext: Array<{
             entryId: string | null;
             name: string;
@@ -123,7 +107,6 @@ export interface OrientViewFromApi {
         }>;
         taskProfile: {
             workType: string;
-            domain: string;
             keywords: string[];
         };
     };
@@ -132,6 +115,10 @@ export interface OrientViewFromApi {
             entryId: string | null;
             name: string;
             collectionSlug: string | null;
+            provenance?: 'authoritative' | 'provisional' | 'floor';
+            anchoredBy?: string;
+            why?: string;
+            whyQuality?: WhyQuality;
         }>;
         context: Array<{
             entryId: string | null;
@@ -140,14 +127,26 @@ export interface OrientViewFromApi {
             score: number;
             hop: number;
             origin?: 'human' | 'agent' | 'external';
+            provenance?: 'authoritative' | 'provisional' | 'floor';
+            anchoredBy?: string;
+            why?: string;
+            whyQuality?: WhyQuality;
         }>;
         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?: WhyQuality;
+            visibility?: string;
+            provenance?: 'authoritative' | 'provisional' | 'floor';
+            anchoredBy?: string;
         }>;
         inProgressEntries: Array<{
             name: string;
@@ -193,14 +192,33 @@ export interface OrientViewFromApi {
         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-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,22 +1,98 @@
 /**
- * pb orient — prints workspace stage and all orient sections per ARCH-25.
+ * pb orient — prints all orient sections per ARCH-25.
  * BET-181 Slice 0: routes through runCliCommand for JSON-default output.
  */
-import { getConfigOrGuide } from '../lib/config.js';
+import { getConfig, getConfigOrGuide } from '../lib/config.js';
 import { kernelCall } from '../lib/client.js';
-import { runCliCommand } from '../lib/runner.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 ?? {
-            principles: [],
-            standards: [],
-            businessRules: [],
-        },
+        strategyHighlights: raw.strategyHighlights ?? [],
         tensions: raw.tensions ?? [],
         architectureNotes: raw.architectureNotes ?? [],
-        proposals: raw.proposals ?? [],
         absenceSignals: raw.absenceSignals ?? [],
         startup: raw.startup,
         taskContext: raw.taskContext,
@@ -30,28 +106,160 @@ 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;
+    // 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): `startupSignals` is sent unconditionally.
+            // D1d (WP-754/TASK-204): domain resolution is deleted server-side — `startupSignals` no
+            // longer feeds it. It still feeds `context.served`'s presence telemetry
+            // (`convex/lib/contextServedInput.ts`'s `changedPaths`/`branchNamePresent`/
+            // `worktreeNamePresent`), which benefits from an honest signal whether or not a task is
+            // present — that is the sole surviving reason this stays unconditional.
+            // `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` / `PB_JSON=1` — piping
+            // alone does NOT switch modes, WP-744 / 1e-B — 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/entryAccept.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.
+            // A session is oriented when the agent asked a task-shaped question, whether or not the Chain
+            // had anything to say (TASK-534, WP-791, TEN-4261; DEC-1147). A bare `pb orient` / `pb orient -b`
+            // stays a read; thin grounding is still disclosed by the formatter's grounding-status lines.
+            const taskAsked = raw.taskMeaningful === true && !raw.degradedPreloads?.some((d) => d === 'gather' || d === 'governanceLoadRejected');
+            let sessionOriented = false;
+            if (activeSession?.sessionId && taskAsked) {
+                try {
+                    await kernelCall('agent.markOriented', { sessionId: activeSession.sessionId });
+                    sessionOriented = true;
+                }
+                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).
-            return normalizeView(raw);
+            const view = { ...normalizeView(raw), sessionOriented };
+            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) : formatOrient(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