@productbrain/cli 0.1.0-beta.98 → 0.1.0-beta.9817

package/dist/commands/orient.d.ts

@@ -1,19 +1,35 @@
 /**
- * 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';
+import type { PlannedWorkCutFlags } from '../formatters/plannedWorkCounts.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;
@@ -24,36 +40,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 +59,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 +78,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 +103,6 @@ export interface OrientViewFromApi {
         }>;
         taskProfile: {
             workType: string;
-            domain: string;
             keywords: string[];
         };
     };
@@ -132,6 +111,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 +123,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?: {
+    plannedWork?: PlannedWorkCutFlags & {
         uncommittedDrafts: Array<{
             name: string;
             collection: string;
+            why?: string;
+            whyQuality?: WhyQuality;
+            visibility?: string;
+            provenance?: 'authoritative' | 'provisional' | 'floor';
+            anchoredBy?: string;
         }>;
         inProgressEntries: Array<{
             name: string;
@@ -193,14 +188,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":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAA4B,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAKxF,OAAO,EAAmC,KAAK,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC3F,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,kCAAkC,CAAC;AAAC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAoBxK,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,yBAAyB,EAAE,iBAAiB,CAAC;IACpE;4EACwE;IACxE,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,aAAa,CAAC,EAAE,OAAO,yBAAyB,EAAE,iBAAiB,CAAC;IACpE,gBAAgB,EAAE;QAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,cAAc,EAAE,MAAM,CAAC;QACvB,sBAAsB,EAAE,MAAM,CAAC;QAC/B,8DAA8D;QAC9D,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;QAClC,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC;IACF,4EAA4E;IAC5E,kBAAkB,CAAC,EAAE,gCAAgC,EAAE,CAAC;IACxD,8DAA8D;IAC9D,kBAAkB,EAAE,KAAK,CAAC;QACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;QACxC,cAAc,CAAC,EAAE,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACjE;;;+FAGuF;QACvF,oBAAoB,CAAC,EAAE,aAAa,GAAG,kBAAkB,GAAG,OAAO,CAAC;KACrE,CAAC,CAAC;IACH,oGAAoG;IACpG,SAAS,CAAC,EAAE,OAAO,yBAAyB,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;IACtE;qGACiG;IACjG,QAAQ,CAAC,EAAE,OAAO,0BAA0B,EAAE,iBAAiB,CAAC;IAChE,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3D,iBAAiB,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,eAAe,GAAG,aAAa,GAAG,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,UAAU,CAAA;KAAE,CAAC,CAAC;IAC1M,cAAc,CAAC,EAAE,KAAK,CAAC;QACrB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IACH,OAAO,CAAC,EAAE;QACR,eAAe,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;QACpD,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;YAAC,UAAU,CAAC,EAAE,eAAe,GAAG,aAAa,GAAG,OAAO,CAAC;YAAC,UAAU,CAAC,EAAE,MAAM,CAAC;YAAC,GAAG,CAAC,EAAE,MAAM,CAAC;YAAC,UAAU,CAAC,EAAE,UAAU,CAAA;SAAE,CAAC,CAAC;QAE1M,eAAe,EAAE,KAAK,CAAC;YACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;YACvB,IAAI,EAAE,MAAM,CAAC;YACb,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;YAC9B,KAAK,EAAE,MAAM,CAAC;YACd,GAAG,EAAE,MAAM,CAAC;YACZ,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;SACzC,CAAC,CAAC;QACH,iBAAiB,EAAE,KAAK,CAAC;YACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;YACvB,IAAI,EAAE,MAAM,CAAC;YACb,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;YAC9B,KAAK,EAAE,MAAM,CAAC;YACd,GAAG,EAAE,MAAM,CAAC;YACZ,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;SACzC,CAAC,CAAC;QACH,WAAW,EAAE;YACX,QAAQ,EAAE,MAAM,CAAC;YACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;SACpB,CAAC;KACH,CAAC;IACF,WAAW,CAAC,EAAE;QACZ,KAAK,EAAE,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;YAAC,UAAU,CAAC,EAAE,eAAe,GAAG,aAAa,GAAG,OAAO,CAAC;YAAC,UAAU,CAAC,EAAE,MAAM,CAAC;YAAC,GAAG,CAAC,EAAE,MAAM,CAAC;YAAC,UAAU,CAAC,EAAE,UAAU,CAAA;SAAE,CAAC,CAAC;QAC1M,OAAO,EAAE,KAAK,CAAC;YACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;YACvB,IAAI,EAAE,MAAM,CAAC;YACb,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;YAC9B,KAAK,EAAE,MAAM,CAAC;YACd,GAAG,EAAE,MAAM,CAAC;YACZ,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;YACxC,UAAU,CAAC,EAAE,eAAe,GAAG,aAAa,GAAG,OAAO,CAAC;YACvD,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,GAAG,CAAC,EAAE,MAAM,CAAC;YACb,UAAU,CAAC,EAAE,UAAU,CAAC;SACzB,CAAC,CAAC;QACH,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,4FAA4F;QAC5F,eAAe,CAAC,EAAE,IAAI,CAAC;QACvB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,WAAW,CAAC,EAAE,mBAAmB,GAAG;QAClC,iBAAiB,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAC;YAAC,GAAG,CAAC,EAAE,MAAM,CAAC;YAAC,UAAU,CAAC,EAAE,UAAU,CAAC;YAAC,UAAU,CAAC,EAAE,MAAM,CAAC;YAAC,UAAU,CAAC,EAAE,eAAe,GAAG,aAAa,GAAG,OAAO,CAAC;YAAC,UAAU,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACxM,iBAAiB,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAChF,YAAY,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACxD,CAAC;IACF,aAAa,CAAC,EAAE,KAAK,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,eAAe,EAAE,MAAM,EAAE,CAAC;QAC1B,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC,CAAC;IACH,aAAa,CAAC,EAAE;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,WAAW,GAAG,WAAW,CAAC;QAClC,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACtE,QAAQ,EAAE,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACvE,sBAAsB,EAAE,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACrF,gBAAgB,EAAE,MAAM,CAAC;QACzB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,GAAG,IAAI,CAAC;IACT,2EAA2E;IAC3E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,iBAAiB,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE,CAAC;IAClG,6FAA6F;IAC7F,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,6FAA6F;IAC7F,YAAY,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;IAC/C;;oFAEgF;IAChF,oBAAoB,CAAC,EAAE,OAAO,yBAAyB,EAAE,UAAU,CAAC,sBAAsB,CAAC,CAAC;CAC7F;AAgED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,iBAAiB,GAAG,UAAU,CAiBhE;AAED,wBAAsB,SAAS,CAAC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAuJ/G"}

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

package/dist/commands/orient.js.map

@@ -1 +1 @@
-{"version":3,"file":"orient.js","sourceRoot":"","sources":["../../src/commands/orient.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAmB,MAAM,yBAAyB,CAAC;AAqH3F,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,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,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,UAA8D,EAAE;IAC9F,uEAAuE;IACvE,IAAI,OAAO,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACnC,OAAO,CAAC,IAAI,CAAC,2EAA2E,CAAC,CAAC;IAC5F,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAChE,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,MAAM,aAAa,CAAa;QAC9B,EAAE,EAAE,KAAK,IAAI,EAAE;YACb,MAAM,QAAQ,GAA2B,EAAE,CAAC;YAC5C,IAAI,OAAO,CAAC,IAAI;gBAAE,QAAQ,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;YAC/C,IAAI,OAAO,CAAC,KAAK;gBAAE,QAAQ,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;YAClD,MAAM,GAAG,GAAG,MAAM,UAAU,CAC1B,qBAAqB,EACrB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CACjD,CAAC;YACF,qEAAqE;YACrE,2EAA2E;YAC3E,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;QACD,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE;YACrB,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACtE,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"orient.js","sourceRoot":"","sources":["../../src/commands/orient.ts"],"names":[],"mappings":"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"}

package/dist/commands/outcome.d.ts

@@ -0,0 +1,91 @@
+/** Mirrors the door's own `kind` union (`convex/outcomes/readings.ts`). Kept as a literal list so
+ *  a bad value is refused HERE, naming the legal set, rather than as an opaque validator error. */
+declare const READING_KINDS: readonly ["measurement", "estimate", "correction"];
+type ReadingKind = (typeof READING_KINDS)[number];
+export interface OutcomeRecordOptions {
+    asOf?: string;
+    kind?: string;
+    corrects?: string;
+    byRole?: string;
+    note?: string;
+    source?: string;
+    valueText?: string;
+    json?: boolean;
+}
+export interface OutcomeListOptions {
+    limit?: string;
+    json?: boolean;
+}
+export interface ReadingRow {
+    /** Non-underscore twin of the row's `_id` (TEN-340: the CLI's JSON envelope unconditionally
+     *  strips any `_id`-keyed field via `stripConvexInternals`) — this is the field
+     *  `pb outcome record --corrects <READING-ID>` targets. Same twin `pb conflicts` (`id`) and
+     *  `pb shape` (`rowId`) already carry, for the same reason. */
+    readingId: string;
+    value: number;
+    valueText?: string;
+    asOf: number;
+    recordedAt: number;
+    kind: ReadingKind;
+    independenceTier: string;
+    actorKind: string;
+    note?: string;
+    source?: string;
+    supersededByReadingId?: string;
+}
+interface ListReadingsResult {
+    entryDocId: string;
+    pageExhausted: boolean;
+    readings: ReadingRow[];
+}
+export declare function runOutcomeRecord(entryId: string, value: string, options: OutcomeRecordOptions): Promise<void>;
+export declare function formatReadingsList(entryId: string, result: ListReadingsResult | null): string;
+export declare function runOutcomeList(entryId: string, options: OutcomeListOptions): Promise<void>;
+interface OutcomeShowResult {
+    entryId: string;
+    name: string;
+    readyToCloseInstruction: string | null;
+    outcome: {
+        current?: {
+            value: number;
+            asOf: number;
+        };
+        currentResolution: string;
+        hasNoReadings: boolean;
+        direction: string;
+        progressPct?: number;
+        pacePct?: number;
+        nextDueAt?: number;
+        state: string;
+        overdueByMs?: number;
+        completion: string;
+        completionProvenance: string;
+        readyToClose: 'achieved' | 'missed' | null;
+        weakestTierInCycle: string | null;
+        ownerRole: {
+            id: string;
+            name: string | null;
+        } | null;
+        reporterRole: {
+            id: string;
+            name: string | null;
+        } | null;
+        readingCount: number;
+        unit: string | null;
+    };
+}
+/**
+ * Pretty rendering for `pb outcome show`. Exported for the same reason `formatReadingsList` is:
+ * the honesty rules here are assertable claims, not styling.
+ *
+ * Two of them are load-bearing. **A blank is never printed as a zero** — `progressPct` is
+ * `undefined` for a never-measured key result and `—` says that, where `0%` would read as a
+ * measurement. And **the recorded completion is never called "confirmed" or "verified"** — it
+ * reports what was recorded and where that came from, because nothing in this run verifies a
+ * close, and a surface that implies otherwise is the failure the whole provenance field exists to
+ * prevent.
+ */
+export declare function formatOutcomeShow(result: OutcomeShowResult | null): string;
+export declare function runOutcomeShow(entryId: string): Promise<void>;
+export {};
+//# sourceMappingURL=outcome.d.ts.map