@productbrain/cli 0.1.0-beta.997 → 0.1.0-beta.9989

package/dist/formatters/orient.rcrtMiss.test.js

@@ -0,0 +1,77 @@
+import { describe, expect, it } from 'vitest';
+import { formatOrient, formatOrientBrief } from './orient.js';
+function view(overrides = {}) {
+    return {
+        strategicContext: {
+            vision: null,
+            purpose: null,
+            activeBetCount: 0, activeWorkPackageCount: 0,
+            currentWorkPackage: null,
+            activeTensionCount: 0,
+        },
+        activeWorkPackages: [],
+        tensions: [],
+        architectureNotes: [],
+        absenceSignals: [],
+        plannedWork: {
+            uncommittedDrafts: [],
+            inProgressEntries: [],
+            openTensions: [],
+        },
+        priorSessions: [],
+        recoveryBlock: null,
+        ...overrides,
+    };
+}
+describe('formatOrient renders retrievalMiss', () => {
+    it('miss renders prominently with kind', () => {
+        const out = formatOrient(view({
+            retrievalMiss: { served: 'miss', kind: 'domain-unresolved', confidence: 1, rubricVersion: 'rcrt-miss/v1@live-dirty' },
+            startup: {
+                groundingStatus: 'missing',
+                confidence: 'low',
+                totalFound: 0,
+                seeds: [],
+                steeringContext: [],
+                supportingContext: [],
+                taskProfile: { workType: 'review', keywords: [] },
+            },
+        }));
+        expect(out).toMatch(/RETRIEVAL MISS|DOMAIN/);
+        // TASK-534: a task that matched nothing is not told to orient again.
+        expect(out).toContain('## Task grounding missing');
+        expect(out).not.toContain('Task grounding required');
+        // Sessionless orient cannot capture: point at `pb session start`, not at capture.
+        expect(out).toContain('pb session start');
+        expect(out).not.toContain('proceed and capture');
+    });
+    it('low renders quieter and provisional', () => {
+        const out = formatOrient(view({
+            retrievalMiss: { served: 'low', kind: 'thin-serve', confidence: 0.5, rubricVersion: 'rcrt-miss/v1@live-dirty' },
+        }));
+        expect(out.toLowerCase()).toContain('provisional');
+    });
+    it('ok adds no miss banner', () => {
+        const out = formatOrient(view({
+            retrievalMiss: { served: 'ok', kind: null, confidence: 1, rubricVersion: 'x' },
+        }));
+        expect(out).not.toMatch(/RETRIEVAL MISS/);
+    });
+    it('brief miss render avoids markdown headings', () => {
+        const out = formatOrientBrief(view({
+            retrievalMiss: { served: 'miss', kind: 'domain-unresolved', confidence: 1, rubricVersion: 'rcrt-miss/v1@live-dirty' },
+            startup: {
+                groundingStatus: 'missing',
+                confidence: 'low',
+                totalFound: 0,
+                seeds: [],
+                steeringContext: [],
+                supportingContext: [],
+                taskProfile: { workType: 'review', keywords: [] },
+            },
+        }));
+        expect(out).toContain('RETRIEVAL MISS');
+        expect(out).not.toMatch(/^## /m);
+    });
+});
+//# sourceMappingURL=orient.rcrtMiss.test.js.map

package/dist/formatters/orient.rcrtMiss.test.js.map

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

package/dist/formatters/orient.rituals.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=orient.rituals.test.d.ts.map

package/dist/formatters/orient.rituals.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orient.rituals.test.d.ts","sourceRoot":"","sources":["../../src/formatters/orient.rituals.test.ts"],"names":[],"mappings":""}

package/dist/formatters/orient.rituals.test.js

@@ -0,0 +1,73 @@
+/** WP-582 B2 (FEAT-1404) — the rituals surface (direction/verdict-ask/spine one-liners) renders
+ *  identically on formatOrient (full) and formatOrientBrief. Pre-rendered server strings — the CLI
+ *  only prints them, with an explicit no-row fallback when the server field is absent/null. */
+import { describe, expect, it } from 'vitest';
+import { formatOrient, formatOrientBrief } from './orient.js';
+// TASK-435 (C4c): the readiness stage label is deleted from served text — the "Stage: X
+// (provisional: ...)" qualifier used to carry this disclosure. `READINESS_PROVISIONAL_LINE`
+// survives, decoupled from the deleted stage word.
+it.each([formatOrient, formatOrientBrief])('discloses a truncated readiness sample without ever naming a stage', (format) => {
+    const out = format(view({ sampleTruncated: true }));
+    expect(out).toContain('Readiness is provisional');
+    expect(out).not.toContain('Stage:');
+});
+function view(overrides = {}) {
+    return {
+        strategicContext: {
+            vision: null,
+            purpose: null,
+            activeBetCount: 0, activeWorkPackageCount: 0,
+            currentWorkPackage: null,
+            activeTensionCount: 0,
+        },
+        activeWorkPackages: [],
+        tensions: [],
+        architectureNotes: [],
+        absenceSignals: [],
+        plannedWork: {
+            uncommittedDrafts: [],
+            inProgressEntries: [],
+            openTensions: [],
+        },
+        priorSessions: [],
+        recoveryBlock: null,
+        ...overrides,
+    };
+}
+const DIRECTION_LINE = '8 of 10 active work packages have no path to a strategy — baseline 5 of 6 accepted 2026-07-01; new since: 3 · `pb direction list`';
+const VERDICT_ASK_LINE = '2 contradictions awaiting your verdict — `pb conflicts list` / `pb conflicts resolve <id> --verdict real|noise`';
+const SPINE_LINE = 'Spine check: structural PASS, story PASS [unvalidated] — `pb quality spine-check`';
+for (const [label, formatFn] of [['formatOrient (full)', formatOrient], ['formatOrientBrief', formatOrientBrief]]) {
+    describe(`rituals surface — ${label}`, () => {
+        it('renders all three populated lines verbatim', () => {
+            const out = formatFn(view({
+                directionLine: DIRECTION_LINE,
+                verdictAskLine: VERDICT_ASK_LINE,
+                spineLine: SPINE_LINE,
+            }));
+            expect(out).toContain(DIRECTION_LINE);
+            expect(out).toContain(VERDICT_ASK_LINE);
+            expect(out).toContain(SPINE_LINE);
+        });
+        // TEN-3547 (WP-744/TASK-156): the server's `buildSpineLine` now names every arm itself and
+        // never serves `null` in practice — a CLI-invented "not computed yet" fallback for spine would
+        // only ever guess wrong about which arm applies, so it is deleted. Direction keeps its
+        // fallback (out of scope for this slice — run-sweep).
+        it('renders the zero-count verdict-ask line and the direction no-row fallback; emits NO spine line when the server sent null', () => {
+            const out = formatFn(view({
+                directionLine: null,
+                verdictAskLine: 'No contradictions awaiting your verdict.',
+                spineLine: null,
+            }));
+            expect(out).toContain('Direction: not computed yet — `pb direction refresh`');
+            expect(out).toContain('No contradictions awaiting your verdict.');
+            expect(out).not.toContain('Spine check:');
+        });
+        it('renders the direction no-row fallback, and no spine line, when the fields are entirely absent (older/undecorated view)', () => {
+            const out = formatFn(view({}));
+            expect(out).toContain('Direction: not computed yet — `pb direction refresh`');
+            expect(out).not.toContain('Spine check:');
+        });
+    });
+}
+//# sourceMappingURL=orient.rituals.test.js.map

package/dist/formatters/orient.rituals.test.js.map

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

package/dist/formatters/orientDegradation.d.ts

@@ -0,0 +1,38 @@
+/** Small orient-view status-tag/notice builders — offset extraction out of formatters/orient.ts
+ *  (STD-2/DEC-1504: that file is grandfathered over the 500-LOC budget and shrink-only, so new
+ *  rendering logic belongs in its own module). `formatters/orient.ts` keeps a one-line re-export
+ *  of `coherencyCheckTag` so its own two call sites and the existing
+ *  `orient.coherencyCheckTag.test.ts` (which imports from `./orient.js`) both keep working
+ *  unchanged. */
+/** WP-485 Slice 1 (R1, FEAT-1368): render tag for a bet whose latest contradiction-detection
+ *  status is partial/unavailable (WP-A §7); silent for checked_clear/conflicts/never-checked.
+ *  TEN-2746 §2c: 'stale' — clear/conflicts-found but changed since (re-run vs retry a failed one). */
+export declare function coherencyCheckTag(status: 'not_checked' | 'check_incomplete' | 'stale' | undefined): string;
+/**
+ * WP-621 (grounding S1, Copilot review PR #599): the server's `degradedPreloads` marker
+ * (orientPreloadFallbacks.ts) named which task preload(s) fell back to a typed-empty default
+ * this run — but it was served only on the raw Convex view, never rendered by either connector,
+ * so a degraded run silently looked like a normal thinner result on the primary surfaces
+ * (undermining "serve less, LABELLED"). Renders a single visible warning line naming exactly
+ * which preload(s) degraded. Returns `[]` (nothing to render) when absent/empty — never a
+ * false-positive warning on a healthy run.
+ *
+ * TASK-167 (1c-late): since TASK-157's bounded governance read, a binding scan that HITS its
+ * bound returns a CAPPED (truncated) result, never the full set (`startupResolver.ts`'s
+ * `GOVERNANCE_ENTRIES_SCAN_LIMIT`; `bindingScanTruncated: true` when a 32-entry binding
+ * collection yields only its first 20, `startupResolver.test.ts` dW1) — and TASK-157 marks
+ * `governanceLoad` degraded for that capped-but-successful load, the same as a genuine preload
+ * rejection. A capped load and a genuine fallback are indistinguishable to the connector; only
+ * the server (orientPreloadFallbacks.ts) knows which members are in the list. So the line states
+ * only what membership means — the named preload(s) are incomplete this run — never asserting a
+ * cause (a fetch failure vs. a deliberate cap) the connector cannot know.
+ *
+ * PR #920 review (Codex P2): `DegradedPreload` is `'gather' | 'governanceLoad' | 'domain'`
+ * (orientPreloadFallbacks.ts) — a gather- or domain-only degradation is task-context/domain
+ * resolution, not governance, so an earlier draft's "Governance for this run is incomplete"
+ * wording was itself a false, member-specific claim on those two members. The wording below is
+ * member-agnostic on purpose: it must read true for every current AND future `DegradedPreload`
+ * value without special-casing which one(s) fired.
+ */
+export declare function buildDegradedPreloadsLines(degraded?: readonly string[] | null): string[];
+//# sourceMappingURL=orientDegradation.d.ts.map

package/dist/formatters/orientDegradation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orientDegradation.d.ts","sourceRoot":"","sources":["../../src/formatters/orientDegradation.ts"],"names":[],"mappings":"AAAA;;;;;iBAKiB;AAEjB;;sGAEsG;AACtG,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,kBAAkB,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAK1G;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,GAAG,MAAM,EAAE,CAGxF"}

package/dist/formatters/orientDegradation.js

@@ -0,0 +1,50 @@
+/** Small orient-view status-tag/notice builders — offset extraction out of formatters/orient.ts
+ *  (STD-2/DEC-1504: that file is grandfathered over the 500-LOC budget and shrink-only, so new
+ *  rendering logic belongs in its own module). `formatters/orient.ts` keeps a one-line re-export
+ *  of `coherencyCheckTag` so its own two call sites and the existing
+ *  `orient.coherencyCheckTag.test.ts` (which imports from `./orient.js`) both keep working
+ *  unchanged. */
+/** WP-485 Slice 1 (R1, FEAT-1368): render tag for a bet whose latest contradiction-detection
+ *  status is partial/unavailable (WP-A §7); silent for checked_clear/conflicts/never-checked.
+ *  TEN-2746 §2c: 'stale' — clear/conflicts-found but changed since (re-run vs retry a failed one). */
+export function coherencyCheckTag(status) {
+    if (status === 'not_checked')
+        return ' [not checked]';
+    if (status === 'check_incomplete')
+        return ' [check incomplete]';
+    if (status === 'stale')
+        return ' [stale — entry changed since last check]';
+    return '';
+}
+/**
+ * WP-621 (grounding S1, Copilot review PR #599): the server's `degradedPreloads` marker
+ * (orientPreloadFallbacks.ts) named which task preload(s) fell back to a typed-empty default
+ * this run — but it was served only on the raw Convex view, never rendered by either connector,
+ * so a degraded run silently looked like a normal thinner result on the primary surfaces
+ * (undermining "serve less, LABELLED"). Renders a single visible warning line naming exactly
+ * which preload(s) degraded. Returns `[]` (nothing to render) when absent/empty — never a
+ * false-positive warning on a healthy run.
+ *
+ * TASK-167 (1c-late): since TASK-157's bounded governance read, a binding scan that HITS its
+ * bound returns a CAPPED (truncated) result, never the full set (`startupResolver.ts`'s
+ * `GOVERNANCE_ENTRIES_SCAN_LIMIT`; `bindingScanTruncated: true` when a 32-entry binding
+ * collection yields only its first 20, `startupResolver.test.ts` dW1) — and TASK-157 marks
+ * `governanceLoad` degraded for that capped-but-successful load, the same as a genuine preload
+ * rejection. A capped load and a genuine fallback are indistinguishable to the connector; only
+ * the server (orientPreloadFallbacks.ts) knows which members are in the list. So the line states
+ * only what membership means — the named preload(s) are incomplete this run — never asserting a
+ * cause (a fetch failure vs. a deliberate cap) the connector cannot know.
+ *
+ * PR #920 review (Codex P2): `DegradedPreload` is `'gather' | 'governanceLoad' | 'domain'`
+ * (orientPreloadFallbacks.ts) — a gather- or domain-only degradation is task-context/domain
+ * resolution, not governance, so an earlier draft's "Governance for this run is incomplete"
+ * wording was itself a false, member-specific claim on those two members. The wording below is
+ * member-agnostic on purpose: it must read true for every current AND future `DegradedPreload`
+ * value without special-casing which one(s) fired.
+ */
+export function buildDegradedPreloadsLines(degraded) {
+    if (!degraded || degraded.length === 0)
+        return [];
+    return [`⚠ ${degraded.join(', ')} incomplete this run. Results may be thinner than usual.`];
+}
+//# sourceMappingURL=orientDegradation.js.map

package/dist/formatters/orientDegradation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orientDegradation.js","sourceRoot":"","sources":["../../src/formatters/orientDegradation.ts"],"names":[],"mappings":"AAAA;;;;;iBAKiB;AAEjB;;sGAEsG;AACtG,MAAM,UAAU,iBAAiB,CAAC,MAAgE;IAChG,IAAI,MAAM,KAAK,aAAa;QAAE,OAAO,gBAAgB,CAAC;IACtD,IAAI,MAAM,KAAK,kBAAkB;QAAE,OAAO,qBAAqB,CAAC;IAChE,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,2CAA2C,CAAC;IAC3E,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,0BAA0B,CAAC,QAAmC;IAC5E,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAClD,OAAO,CAAC,KAAK,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC;AAC9F,CAAC"}

package/dist/formatters/orientDegradation.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=orientDegradation.test.d.ts.map

package/dist/formatters/orientDegradation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orientDegradation.test.d.ts","sourceRoot":"","sources":["../../src/formatters/orientDegradation.test.ts"],"names":[],"mappings":""}

package/dist/formatters/orientDegradation.test.js

@@ -0,0 +1,28 @@
+/**
+ * TASK-167 (1c-late, WP-744): buildDegradedPreloadsLines states only what a `degradedPreloads`
+ * member MEANS — the named preload(s) are incomplete this run — never a cause the connector
+ * cannot know. `gather` and `domain` are task-context/domain-resolution members, not governance;
+ * a `governanceLoad` member itself can mean either a genuine preload rejection OR a capped
+ * (truncated, never "full") binding-governance scan that hit its bound (TASK-157) — both are
+ * indistinguishable here, so the wording stays member-agnostic (PR #920 review).
+ */
+import { describe, expect, it } from 'vitest';
+import { buildDegradedPreloadsLines } from './orientDegradation.js';
+describe('buildDegradedPreloadsLines', () => {
+    it('renders one line naming every degraded member, with no asserted cause', () => {
+        // Real DegradedPreload members (orientPreloadFallbacks.ts): 'gather' | 'governanceLoad' |
+        // 'domain'. A gather/domain member is task-context/domain resolution, not governance — the
+        // wording must stay member-agnostic (PR #920 review).
+        expect(buildDegradedPreloadsLines(['governanceLoad', 'gather'])).toEqual([
+            '⚠ governanceLoad, gather incomplete this run. Results may be thinner than usual.',
+        ]);
+    });
+    it('renders nothing for an empty list', () => {
+        expect(buildDegradedPreloadsLines([])).toEqual([]);
+    });
+    it('renders nothing when absent (undefined/null)', () => {
+        expect(buildDegradedPreloadsLines(undefined)).toEqual([]);
+        expect(buildDegradedPreloadsLines(null)).toEqual([]);
+    });
+});
+//# sourceMappingURL=orientDegradation.test.js.map

package/dist/formatters/orientDegradation.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orientDegradation.test.js","sourceRoot":"","sources":["../../src/formatters/orientDegradation.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAEpE,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IAC1C,EAAE,CAAC,uEAAuE,EAAE,GAAG,EAAE;QAC/E,0FAA0F;QAC1F,2FAA2F;QAC3F,sDAAsD;QACtD,MAAM,CAAC,0BAA0B,CAAC,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YACvE,kFAAkF;SACnF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,0BAA0B,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,CAAC,0BAA0B,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC1D,MAAM,CAAC,0BAA0B,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/formatters/orientDirection.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Orient direction types (WP-622; the shape-advisory summary line left with the shape judge, TASK-737). TASK-552b (DEC-1888): the
+ * spine renders (purpose, vision, strategy, objectives, key results) moved to the one briefing
+ * builder, `formatBriefingLines` (lib/ruleListRender.ts); only the served shapes stay named here.
+ */
+import type { WhyQuality } from '@productbrain/kernel-client';
+/** WP-622 (grounding S2): its own view-type widening for a strategy-highlight row — a deliberate
+ *  subset of the served row (TEN-2278: CLI can't import convex/, so it never gets the full row
+ *  shape for free). Copilot review (PR #601): the server annotates strategyHighlights with the
+ *  SAME authority-provenance + possible-conflict fields governance rows get (orient.ts's
+ *  annotateEntry pass) — dropping them here would let a provisional/floor/contested strategy
+ *  render as ordinary, unmarked direction. */
+export interface OrientDirectionStrategyHighlight {
+    entryId: string | null;
+    name: string;
+    preview?: string;
+    provenance?: 'authoritative' | 'provisional' | 'floor';
+    anchoredBy?: string;
+    whyQuality?: WhyQuality;
+    possibleConflict?: {
+        kind: string;
+        label: string;
+    };
+}
+//# sourceMappingURL=orientDirection.d.ts.map

package/dist/formatters/orientDirection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orientDirection.d.ts","sourceRoot":"","sources":["../../src/formatters/orientDirection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D;;;;;8CAK8C;AAC9C,MAAM,WAAW,gCAAgC;IAC/C,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,eAAe,GAAG,aAAa,GAAG,OAAO,CAAC;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,gBAAgB,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CACpD"}

package/dist/formatters/orientDirection.js

@@ -0,0 +1,7 @@
+/**
+ * Orient direction types (WP-622; the shape-advisory summary line left with the shape judge, TASK-737). TASK-552b (DEC-1888): the
+ * spine renders (purpose, vision, strategy, objectives, key results) moved to the one briefing
+ * builder, `formatBriefingLines` (lib/ruleListRender.ts); only the served shapes stay named here.
+ */
+export {};
+//# sourceMappingURL=orientDirection.js.map

package/dist/formatters/orientDirection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orientDirection.js","sourceRoot":"","sources":["../../src/formatters/orientDirection.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/formatters/orientDirection.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=orientDirection.test.d.ts.map

package/dist/formatters/orientDirection.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orientDirection.test.d.ts","sourceRoot":"","sources":["../../src/formatters/orientDirection.test.ts"],"names":[],"mappings":""}

package/dist/formatters/orientDirection.test.js

@@ -0,0 +1,48 @@
+import { describe, expect, it } from 'vitest';
+import { formatOrient, formatOrientBrief } from './orient.js';
+function view(overrides = {}) {
+    return {
+        strategicContext: {
+            vision: null,
+            purpose: null,
+            activeBetCount: 0, activeWorkPackageCount: 0,
+            currentWorkPackage: null,
+            activeTensionCount: 0,
+        },
+        activeWorkPackages: [],
+        tensions: [],
+        architectureNotes: [],
+        absenceSignals: [],
+        priorSessions: [],
+        recoveryBlock: null,
+        plannedWork: { uncommittedDrafts: [], inProgressEntries: [], openTensions: [] },
+        ...overrides,
+    };
+}
+// ── TASK-552b (DEC-1888): orient renders the one briefing ───────────────────────
+const facts = {
+    purpose: 'One trustworthy source of product truth.',
+    vision: 'By 2028, founders resolve disagreements by asking the Chain.',
+    strategy: { entryId: 'STR-8', name: 'Roles own every outcome', notDo: 'no doc editor; no chat' },
+    objective: { entryId: 'OBJ-1', name: 'A first outside team', keyResults: [{ name: 'Teams self-start', currentValue: 2, targetValue: 5 }] },
+    currentWorkPackage: { entryId: 'WP-777', name: 'Rules handed to agents' },
+};
+describe('formatOrient and formatOrientBrief render the briefing (TASK-552b)', () => {
+    for (const [label, format] of [['full', formatOrient], ['brief', formatOrientBrief]]) {
+        it(`${label}: prints the spine through the builder, with the CLI pull commands`, () => {
+            const output = format(view({ briefing: facts }));
+            expect(output).toContain('Purpose: One trustworthy source of product truth.');
+            expect(output).toContain('Vision: By 2028, founders resolve disagreements by asking the Chain.');
+            expect(output).toContain('Strategy (STR-8): Roles own every outcome\n  Not doing: no doc editor; no chat');
+            expect(output).toContain('Objective (OBJ-1): A first outside team\n  - Teams self-start: 2 / 5');
+            expect(output).toContain('Current work package (WP-777): Rules handed to agents');
+            expect(output).toContain('Pull more: pb orient --task');
+        });
+        it(`${label}: prints no spine lines of its own when the payload has no briefing`, () => {
+            const output = format(view({ strategyHighlights: [{ entryId: 'STR-4', name: 'Strategy A', preview: 'Win by X.' }] }));
+            expect(output).not.toContain('Purpose:');
+            expect(output).not.toContain('## Strategy highlights');
+        });
+    }
+});
+//# sourceMappingURL=orientDirection.test.js.map

package/dist/formatters/orientDirection.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orientDirection.test.js","sourceRoot":"","sources":["../../src/formatters/orientDirection.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAmB,MAAM,aAAa,CAAC;AAE/E,SAAS,IAAI,CAAC,YAAiC,EAAE;IAC/C,OAAO;QACL,gBAAgB,EAAE;YAChB,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE,IAAI;YACb,cAAc,EAAE,CAAC,EAAE,sBAAsB,EAAE,CAAC;YAC5C,kBAAkB,EAAE,IAAI;YACxB,kBAAkB,EAAE,CAAC;SACtB;QACD,kBAAkB,EAAE,EAAE;QACtB,QAAQ,EAAE,EAAE;QACZ,iBAAiB,EAAE,EAAE;QACrB,cAAc,EAAE,EAAE;QAClB,aAAa,EAAE,EAAE;QACjB,aAAa,EAAE,IAAI;QACnB,WAAW,EAAE,EAAE,iBAAiB,EAAE,EAAE,EAAE,iBAAiB,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE;QAC/E,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAGD,mFAAmF;AAEnF,MAAM,KAAK,GAAG;IACZ,OAAO,EAAE,0CAA0C;IACnD,MAAM,EAAE,8DAA8D;IACtE,QAAQ,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,yBAAyB,EAAE,KAAK,EAAE,wBAAwB,EAAE;IAChG,SAAS,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,sBAAsB,EAAE,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,YAAY,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC,EAAE;IAC1I,kBAAkB,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,wBAAwB,EAAE;CAC1E,CAAC;AAEF,QAAQ,CAAC,oEAAoE,EAAE,GAAG,EAAE;IAClF,KAAK,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAU,EAAE,CAAC;QAC9F,EAAE,CAAC,GAAG,KAAK,oEAAoE,EAAE,GAAG,EAAE;YACpF,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;YACjD,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,mDAAmD,CAAC,CAAC;YAC9E,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,sEAAsE,CAAC,CAAC;YACjG,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,gFAAgF,CAAC,CAAC;YAC3G,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,sEAAsE,CAAC,CAAC;YACjG,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,uDAAuD,CAAC,CAAC;YAClF,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,6BAA6B,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,GAAG,KAAK,qEAAqE,EAAE,GAAG,EAAE;YACrF,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,kBAAkB,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YACtH,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;YACzC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAAC;QACzD,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/formatters/orientRetrievalMiss.d.ts

@@ -0,0 +1,22 @@
+/** `buildRetrievalMissLines` — extracted out of orient.ts (STD-2/DEC-1504: that file is
+ *  grandfathered shrink-only, so WP-582 B2's growth there needs an equal-or-greater offsetting
+ *  extraction in the SAME PR). Pure, self-contained, module-private in its original home (never
+ *  exported) — used by both formatOrient and formatOrientBrief.
+ *
+ *  The param type is declared INLINE (a structural subset of `OrientView`) rather than imported
+ *  from orient.ts — importing the type back would create a two-file import cycle
+ *  (orient.ts -> orientRetrievalMiss.ts -> orient.ts), which dep-cruiser's no-circular rule flags
+ *  even for a type-only edge (CI finding, PR #532: `npm run check:boundaries`). */
+interface RetrievalMissView {
+    served: 'ok' | 'low' | 'miss';
+    kind: string | null;
+    confidence: number;
+    rubricVersion: string;
+}
+export declare function buildRetrievalMissLines(view: {
+    retrievalMiss?: RetrievalMissView;
+}, opts?: {
+    markdownHeading?: boolean;
+}): string[];
+export {};
+//# sourceMappingURL=orientRetrievalMiss.d.ts.map

package/dist/formatters/orientRetrievalMiss.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orientRetrievalMiss.d.ts","sourceRoot":"","sources":["../../src/formatters/orientRetrievalMiss.ts"],"names":[],"mappings":"AAAA;;;;;;;;mFAQmF;AACnF,UAAU,iBAAiB;IACzB,MAAM,EAAE,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC;IAC9B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE;IAAE,aAAa,CAAC,EAAE,iBAAiB,CAAA;CAAE,EAC3C,IAAI,GAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAA;CAA8B,GAC9D,MAAM,EAAE,CAeV"}

package/dist/formatters/orientRetrievalMiss.js

@@ -0,0 +1,17 @@
+export function buildRetrievalMissLines(view, opts = { markdownHeading: true }) {
+    const verdict = view.retrievalMiss;
+    const lines = [];
+    if (verdict && verdict.served !== 'ok') {
+        if (verdict.served === 'miss') {
+            lines.push(`${opts.markdownHeading ? '## ' : ''}⚠ RETRIEVAL MISS — ${verdict.kind ?? 'unknown'}`);
+        }
+        else {
+            lines.push(`_weak serve (provisional, ${verdict.rubricVersion}): ${verdict.kind ?? 'thin'}_`);
+        }
+    }
+    if (lines.length === 0)
+        return [];
+    lines.push('');
+    return lines;
+}
+//# sourceMappingURL=orientRetrievalMiss.js.map

package/dist/formatters/orientRetrievalMiss.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orientRetrievalMiss.js","sourceRoot":"","sources":["../../src/formatters/orientRetrievalMiss.ts"],"names":[],"mappings":"AAgBA,MAAM,UAAU,uBAAuB,CACrC,IAA2C,EAC3C,OAAsC,EAAE,eAAe,EAAE,IAAI,EAAE;IAE/D,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC;IACnC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QACvC,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,sBAAsB,OAAO,CAAC,IAAI,IAAI,SAAS,EAAE,CAAC,CAAC;QACpG,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,6BAA6B,OAAO,CAAC,aAAa,MAAM,OAAO,CAAC,IAAI,IAAI,MAAM,GAAG,CAAC,CAAC;QAChG,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/formatters/plannedWorkCounts.d.ts

@@ -0,0 +1,19 @@
+/**
+ * TEN-4562 (TEN-4550; CLAUDE.md §13): the kernel caps every planned-work list at 5 and says when it cut one
+ * (convex/agentKnowledge/orient.ts: draftsTruncated, inProgressTruncated, openTensionsTruncated). Every CLI surface
+ * that prints planned work (pb orient full and brief, the generated context.md) renders a cut list through these two
+ * helpers, so none prints an exact-looking "5 in progress". The kernel's draftScanCapped is deliberately not read: it
+ * is a scan fact (the draft walk stopped at its page cap with rows possibly unread), so alone it neither proves nor
+ * rules out an omitted visible draft, and rendering it would reveal a hidden-only backlog.
+ */
+/** The served flags, beside the three lists on every CLI planned-work shape. */
+export interface PlannedWorkCutFlags {
+    draftsTruncated?: boolean;
+    inProgressTruncated?: boolean;
+    openTensionsTruncated?: boolean;
+}
+/** "5+" when the kernel cut the list, the exact count otherwise. */
+export declare function cappedCount(count: number, truncated: boolean | undefined): string;
+/** A heading suffix for a cut list — " (5+, more than shown)" — or nothing. */
+export declare function cutNote(count: number, truncated: boolean | undefined): string;
+//# sourceMappingURL=plannedWorkCounts.d.ts.map

package/dist/formatters/plannedWorkCounts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plannedWorkCounts.d.ts","sourceRoot":"","sources":["../../src/formatters/plannedWorkCounts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,gFAAgF;AAChF,MAAM,WAAW,mBAAmB;IAClC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAEjF;AAED,+EAA+E;AAC/E,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAE7E"}

package/dist/formatters/plannedWorkCounts.js

@@ -0,0 +1,17 @@
+/**
+ * TEN-4562 (TEN-4550; CLAUDE.md §13): the kernel caps every planned-work list at 5 and says when it cut one
+ * (convex/agentKnowledge/orient.ts: draftsTruncated, inProgressTruncated, openTensionsTruncated). Every CLI surface
+ * that prints planned work (pb orient full and brief, the generated context.md) renders a cut list through these two
+ * helpers, so none prints an exact-looking "5 in progress". The kernel's draftScanCapped is deliberately not read: it
+ * is a scan fact (the draft walk stopped at its page cap with rows possibly unread), so alone it neither proves nor
+ * rules out an omitted visible draft, and rendering it would reveal a hidden-only backlog.
+ */
+/** "5+" when the kernel cut the list, the exact count otherwise. */
+export function cappedCount(count, truncated) {
+    return truncated ? `${count}+` : String(count);
+}
+/** A heading suffix for a cut list — " (5+, more than shown)" — or nothing. */
+export function cutNote(count, truncated) {
+    return truncated ? ` (${count}+, more than shown)` : '';
+}
+//# sourceMappingURL=plannedWorkCounts.js.map

package/dist/formatters/plannedWorkCounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plannedWorkCounts.js","sourceRoot":"","sources":["../../src/formatters/plannedWorkCounts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,oEAAoE;AACpE,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,SAA8B;IACvE,OAAO,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACjD,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,OAAO,CAAC,KAAa,EAAE,SAA8B;IACnE,OAAO,SAAS,CAAC,CAAC,CAAC,KAAK,KAAK,qBAAqB,CAAC,CAAC,CAAC,EAAE,CAAC;AAC1D,CAAC"}

package/dist/formatters/questions.d.ts

@@ -0,0 +1,72 @@
+export interface CreateResult {
+    entryId: string;
+    questionId?: string;
+    facetId: string;
+    status: 'escalated';
+    ownerRoleId: string;
+    routingReason: string;
+    nudge?: string;
+}
+/** `roleOrLeadName` is resolved by the caller (one `chain.getEntry` lookup) — this formatter
+ *  never resolves ids itself ("no math here"). The name is
+ *  workspace-controlled entry data (a role name), never sanitized upstream — every
+ *  interpolation here goes through singleLine() first (BET-269 C3: terminal escaping) so a name
+ *  containing control/ANSI sequences can't inject extra terminal output when this pretty-mode
+ *  confirmation prints (round 2 review, PRRT_kwDORS4ils6YnqK-). */
+export declare function formatQuestionCreate(result: CreateResult, roleOrLeadName: string): string;
+export interface AssignResult {
+    entryId: string;
+    status: 'routed' | 'escalated';
+    ownerRoleId: string;
+}
+export declare function formatQuestionAssignReassign(entryId: string, targetName: string): string;
+export interface AnswerResult {
+    entryId: string;
+    status: 'processed';
+    answer?: string;
+    answerEntryId?: string;
+    askerPersonId?: string;
+    askerName?: string;
+    idempotent?: boolean;
+    processedVia?: 'answered' | 'declined' | 'force_closed';
+}
+/**
+ * PRRT_kwDORS4ils6YnqK0 (round 2): does NOT mention `pb question list --mine` — S3 shipped no
+ * `list` subcommand at the time (createQuestionCommand() exposed only its write verbs; `list`
+ * was S4's own vertical, §4.1's slice-boundary fix). Pointing users at an unshipped command
+ * would have been a broken-command dead end; S4 restored the full §7.7 wording once `list`
+ * landed (D1c+D2a+D2b, WP-781: the surviving write verbs are now create/assign/answer/
+ * force-close — adopt/snooze/decline are deleted).
+ *
+ * Late #633 finding (PRRT_kwDORS4ils6YozQN): a question closed by decline/forceClose reaches
+ * the SAME idempotent branch as a genuine re-answer — say "already answered" only when it
+ * actually was (or when an older server response omits `processedVia` — treated as answered,
+ * the pre-fix behavior, so a caller that has not yet threaded the new field never regresses).
+ */
+export declare function formatQuestionAnswer(entryId: string, result: AnswerResult, askerName?: string): string;
+export interface ForceCloseResult {
+    entryId: string;
+    status: 'processed';
+    idempotent?: boolean;
+}
+export declare function formatQuestionForceClose(entryId: string, result: ForceCloseResult): string;
+export interface QuestionListRow {
+    entryId: string;
+    question: string;
+    status: string;
+    stateLabel: string;
+    routingReason?: string;
+    why: string;
+    domain: string;
+    withLabel: string;
+    ageDays: number;
+    legalVerbs: string[];
+    outcome?: string;
+}
+export interface QuestionListResult {
+    questions: QuestionListRow[];
+    viewerPersonId: string;
+    truncated?: boolean;
+}
+export declare function formatQuestionList(result: QuestionListResult, mine: boolean): string;
+//# sourceMappingURL=questions.d.ts.map

package/dist/formatters/questions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"questions.d.ts","sourceRoot":"","sources":["../../src/formatters/questions.ts"],"names":[],"mappings":"AAmCA,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,WAAW,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;mEAKmE;AACnE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAMzF;AAED,MAAM,WAAW,YAAY;IAAG,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,QAAQ,GAAG,WAAW,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE;AAEtG,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAExF;AAED,MAAM,WAAW,YAAY;IAAG,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,cAAc,CAAA;CAAE;AAE1O;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAatG;AAED,MAAM,WAAW,gBAAgB;IAAG,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE;AAEhG,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAE1F;AAID,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IAAG,SAAS,EAAE,eAAe,EAAE,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE;AASjH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAkCpF"}