@productbrain/cli 0.1.0-beta.55 → 0.1.0-beta.5504

package/dist/formatters/orientDirection.test.js

@@ -0,0 +1,193 @@
+import { describe, expect, it } from 'vitest';
+import { buildStrategyHighlightsLines, formatShapeAdvisorySummaryLine, capDirectionText, buildVisionPurposeLines } from './orientDirection.js';
+import { formatOrient, formatOrientBrief } from './orient.js';
+function view(overrides = {}) {
+    return {
+        stage: 'grounded',
+        strategicContext: {
+            vision: null,
+            purpose: null,
+            activeBetCount: 0, activeWorkPackageCount: 0,
+            currentWorkPackage: null,
+            activeTensionCount: 0,
+            productAreas: [],
+            productAreaCount: 0,
+        },
+        activeWorkPackages: [],
+        governance: {
+            principles: [],
+            standards: [],
+            businessRules: [],
+        },
+        tensions: [],
+        architectureNotes: [],
+        proposals: [],
+        absenceSignals: [],
+        priorSessions: [],
+        recoveryBlock: null,
+        plannedWork: { uncommittedDrafts: [], inProgressEntries: [], openTensions: [] },
+        ...overrides,
+    };
+}
+// ── buildStrategyHighlightsLines (WP-622, grounding S2) ───────────────────────
+describe('buildStrategyHighlightsLines', () => {
+    it('renders nothing for undefined or empty input — no empty section header', () => {
+        expect(buildStrategyHighlightsLines(undefined)).toEqual([]);
+        expect(buildStrategyHighlightsLines([])).toEqual([]);
+    });
+    it('renders a section header and one line per entry, id-first', () => {
+        const lines = buildStrategyHighlightsLines([
+            { entryId: 'STR-4', name: 'Strategy: agent-governed capture', preview: 'We will win by building agent-governed capture.' },
+        ]);
+        expect(lines).toContain('## Strategy highlights');
+        expect(lines.some((l) => l.includes('`STR-4`') && l.includes('Strategy: agent-governed capture') && l.includes('We will win'))).toBe(true);
+    });
+    it('renders just the name, with no backtick-id prefix and no "Name Name" duplication, when entryId is null (Copilot review, PR #601)', () => {
+        const lines = buildStrategyHighlightsLines([{ entryId: null, name: 'Untitled strategy' }]);
+        const row = lines.find((l) => l.startsWith('- '));
+        expect(row).toBe('- Untitled strategy');
+        expect(row).not.toContain('`');
+    });
+    it('truncates a long preview at 120 chars with an ellipsis', () => {
+        const longPreview = 'x'.repeat(200);
+        const lines = buildStrategyHighlightsLines([{ entryId: 'STR-1', name: 'Long', preview: longPreview }]);
+        const row = lines.find((l) => l.startsWith('- '));
+        expect(row).toBeDefined();
+        expect(row).toContain('x'.repeat(120) + '…');
+        expect(row).not.toContain('x'.repeat(121));
+    });
+    it('omits the preview suffix when absent', () => {
+        const lines = buildStrategyHighlightsLines([{ entryId: 'STR-2', name: 'No preview' }]);
+        const row = lines.find((l) => l.startsWith('- '));
+        expect(row).toBe('- `STR-2` No preview');
+    });
+    it('strips control chars from name and preview before rendering (Copilot review, PR #601 — terminal-injection guard)', () => {
+        const lines = buildStrategyHighlightsLines([
+            { entryId: 'STR-3', name: 'Evil\x1b[31mname', preview: 'Evil\x1b[31mpreview' },
+        ]);
+        const row = lines.find((l) => l.startsWith('- '));
+        expect(row).not.toContain('\x1b');
+    });
+    it('renders the provenance mark (Copilot review, PR #601 — carry authority signals through)', () => {
+        const lines = buildStrategyHighlightsLines([{ entryId: 'STR-1', name: 'Provisional strategy', provenance: 'provisional' }]);
+        const row = lines.find((l) => l.startsWith('- '));
+        expect(row).toBe('- ~ `STR-1` Provisional strategy');
+    });
+    it('renders anchoredBy, whyQuality, and possibleConflict signals', () => {
+        const lines = buildStrategyHighlightsLines([{
+                entryId: 'STR-1',
+                name: 'Anchored strategy',
+                anchoredBy: 'Product Team',
+                whyQuality: 'missing',
+                possibleConflict: { kind: 'contradiction', label: 'Conflicts with STR-2' },
+            }]);
+        const row = lines.find((l) => l.startsWith('- '));
+        expect(row).toContain('(Product Team)');
+        expect(row).toContain('no rationale captured');
+        expect(row).toContain('⚠ Conflicts with STR-2');
+    });
+});
+// ── formatShapeAdvisorySummaryLine re-export (WP-622 offsetting extraction) ───
+describe('formatShapeAdvisorySummaryLine (moved from orient.ts, WP-622)', () => {
+    it('is re-exported from orient.js unchanged', async () => {
+        const { formatShapeAdvisorySummaryLine: reExported } = await import('./orient.js');
+        expect(reExported).toBe(formatShapeAdvisorySummaryLine);
+    });
+    it('still renders the compound-zero case (non-empty candidateRateBySource bypasses the undefined guard)', () => {
+        expect(formatShapeAdvisorySummaryLine({
+            windowDays: 7,
+            compoundTotal: 0,
+            pendingCount: 0,
+            pendingRate: null,
+            precisionAgent: null,
+            precisionAgentN: 0,
+            precisionHuman: null,
+            precisionHumanN: 0,
+            precisionHumanNote: null,
+            candidateRateBySource: { agent: 0.5 },
+            scanTruncated: false,
+        })).toBe('Shape advisories (7d): 0 compound. candidateRateBySource: agent 50%.');
+    });
+});
+// ── formatOrient wiring (WP-622) ──────────────────────────────────────────────
+describe('formatOrient renders strategyHighlights', () => {
+    it('includes the section when strategyHighlights is present and non-empty', () => {
+        const output = formatOrient(view({
+            strategyHighlights: [{ entryId: 'STR-4', name: 'Strategy A', preview: 'Win by X.' }],
+        }));
+        expect(output).toContain('## Strategy highlights');
+        expect(output).toContain('STR-4');
+    });
+    it('omits the section when strategyHighlights is absent or empty', () => {
+        expect(formatOrient(view())).not.toContain('## Strategy highlights');
+        expect(formatOrient(view({ strategyHighlights: [] }))).not.toContain('## Strategy highlights');
+    });
+});
+// ── capDirectionText / buildVisionPurposeLines (WP-622 follow-up, Copilot review PR #601) ────
+describe('capDirectionText', () => {
+    it('leaves a short string untouched', () => {
+        expect(capDirectionText('short')).toBe('short');
+    });
+    it('caps a long, unmarked string at 200 chars with an ellipsis (client-side backstop — the server also bounds at every tier since S1/TEN-3058)', () => {
+        const long = 'x'.repeat(500);
+        const result = capDirectionText(long);
+        expect(result).toBe('x'.repeat(200) + '…');
+    });
+    it('does NOT double-cut a string whose length exactly matches the server-truncation signature (max real chars + 1 ellipsis char)', () => {
+        const serverTruncated = 'x'.repeat(200) + '…';
+        expect(capDirectionText(serverTruncated)).toBe(serverTruncated);
+    });
+    it('DOES cap a naturally long string that merely ends in "…" but is not the exact server-truncation length (Copilot review, PR #603)', () => {
+        const naturallyLong = 'x'.repeat(500) + '…'; // 501 chars, ends in '…', NOT max+1 (201)
+        const result = capDirectionText(naturallyLong);
+        expect(result).toBe('x'.repeat(200) + '…');
+        expect(result.length).toBe(201);
+    });
+    it('respects a custom max', () => {
+        expect(capDirectionText('x'.repeat(50), 10)).toBe('x'.repeat(10) + '…');
+    });
+});
+describe('buildVisionPurposeLines', () => {
+    it('renders nothing when both are null', () => {
+        expect(buildVisionPurposeLines({ vision: null, purpose: null })).toEqual([]);
+    });
+    it('renders Vision and Purpose lines, each capped', () => {
+        const lines = buildVisionPurposeLines({ vision: 'x'.repeat(500), purpose: 'short purpose' });
+        expect(lines[0]).toBe('Vision: ' + 'x'.repeat(200) + '…');
+        expect(lines[1]).toBe('Purpose: short purpose');
+    });
+    it('strips control chars before capping/rendering (Copilot review, PR #603 — terminal-injection guard)', () => {
+        const lines = buildVisionPurposeLines({ vision: 'Evil\x1b[31mvision', purpose: 'Evil\x1b[31mpurpose' });
+        expect(lines.join('\n')).not.toContain('\x1b');
+    });
+});
+describe('formatOrientBrief renders vision/purpose and strategyHighlights (Copilot review, PR #601 post-merge — the prescribed -b grounding surface)', () => {
+    it('renders Vision and Purpose when present', () => {
+        const output = formatOrientBrief(view({
+            strategicContext: {
+                vision: 'By 2028, founders resolve disagreements by asking the Chain.',
+                purpose: 'One trustworthy source of product truth.',
+                activeBetCount: 0, activeWorkPackageCount: 0,
+                currentWorkPackage: null,
+                activeTensionCount: 0,
+                productAreas: [],
+                productAreaCount: 0,
+            },
+        }));
+        expect(output).toContain('Vision: By 2028, founders resolve disagreements by asking the Chain.');
+        expect(output).toContain('Purpose: One trustworthy source of product truth.');
+    });
+    it('renders strategyHighlights', () => {
+        const output = formatOrientBrief(view({
+            strategyHighlights: [{ entryId: 'STR-4', name: 'Strategy A', preview: 'Win by X.' }],
+        }));
+        expect(output).toContain('## Strategy highlights');
+        expect(output).toContain('STR-4');
+    });
+    it('omits vision/purpose lines when both are null', () => {
+        const output = formatOrientBrief(view());
+        expect(output).not.toContain('Vision:');
+        expect(output).not.toContain('Purpose:');
+    });
+});
+//# 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":"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"}

package/dist/formatters/orientRetrievalMiss.d.ts

@@ -0,0 +1,30 @@
+/** `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;
+}
+interface RetrievalMissDomainRetrieval {
+    fallbackReason?: string;
+    fallbackAction?: string;
+    evidenceGap?: string;
+}
+export declare function buildRetrievalMissLines(view: {
+    retrievalMiss?: RetrievalMissView;
+    startup?: {
+        domainRetrieval?: RetrievalMissDomainRetrieval;
+    };
+}, 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,UAAU,4BAA4B;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE;IAAE,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAAC,OAAO,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,4BAA4B,CAAA;KAAE,CAAA;CAAE,EACzG,IAAI,GAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAA;CAA8B,GAC9D,MAAM,EAAE,CAmBV"}

package/dist/formatters/orientRetrievalMiss.js

@@ -0,0 +1,24 @@
+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'}_`);
+        }
+    }
+    const retrieval = view.startup?.domainRetrieval;
+    if (retrieval?.fallbackReason)
+        lines.push(`Reason: ${retrieval.fallbackReason}`);
+    if (retrieval?.fallbackAction)
+        lines.push(`Next action: ${retrieval.fallbackAction}`);
+    if (retrieval?.evidenceGap)
+        lines.push(`Evidence gap: ${retrieval.evidenceGap}`);
+    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":"AAsBA,MAAM,UAAU,uBAAuB,CACrC,IAAyG,EACzG,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,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC;IAChD,IAAI,SAAS,EAAE,cAAc;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,SAAS,CAAC,cAAc,EAAE,CAAC,CAAC;IACjF,IAAI,SAAS,EAAE,cAAc;QAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,SAAS,CAAC,cAAc,EAAE,CAAC,CAAC;IACtF,IAAI,SAAS,EAAE,WAAW;QAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC;IACjF,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/promote.d.ts

@@ -16,6 +16,13 @@ export type CommitEntryResult = {
     existing: boolean;
     entryId: string;
     name: string;
+} | {
+    status: 'coherency_refused';
+    entryId: string;
+    name: string;
+    refusal: {
+        reason?: string;
+    };
 } | {
     _id: string;
     entryId?: string;
@@ -25,6 +32,48 @@ export type CommitEntryResult = {
         verdict: string;
         violations?: string[];
     };
+    /**
+     * WP-465 slice ⑤ (Light-mode row-11): a non-blocking coherency advisory raised
+     * when a misaligned governance draft is accepted. Surfaced, never enforced.
+     */
+    steeringAdvisory?: string;
+    /**
+     * WP-B (attestation-model spec §4.3): the promote auto-verified this entry
+     * server-side (promote-gate context). Server-derived; the CLI renders, never
+     * re-derives (spec §5). Optional — old server omits it (spec §11 rollout rule).
+     */
+    autoVerified?: {
+        strength: string;
+        basis?: string;
+        context?: string;
+        verifiedBy?: string;
+    };
+    /**
+     * WP-485 Slice 2b (FEAT-1370): the server's single contradiction verdict, attached
+     * only when the (still ungraduated, DEC-1321) gate found blocking-confidence conflicts
+     * but let the commit through anyway (`disposition: 'advisory'`). Rendered, never
+     * re-derived — the CLI no longer runs its own blocking comparison (Slice 2a moved the
+     * decision server-side). `conflictDetails` mirrors `SemanticConflictArg` (convex/lib/
+     * conflictPolicy.ts) but the CLI treats it as a display-only shape, not a shared type.
+     */
+    contradictionAdvisory?: {
+        reason: string;
+        blockingCount: number;
+        conflictDetails: Array<{
+            chainEntryId: string;
+            chainEntryName: string;
+            type: string;
+            confidence: number;
+            explanation: string;
+        }>;
+    };
+    /**
+     * WP-582 B1 (FEAT-1403): the direction-trace promote-time advisory, via D0's
+     * publishSeam.finalizePublish accumulator. Present only for a bet/work_package promote
+     * whose trace did NOT reach a `strategy` canonicalKey (a real strategy path renders no
+     * advisory at all — the array is absent, never empty).
+     */
+    publishAdvisories?: string[];
 };
 export declare function formatPromoteReceipt(data: PromoteReceiptData): string;
 //# sourceMappingURL=promote.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"promote.d.ts","sourceRoot":"","sources":["../../src/formatters/promote.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oCAAoC;IACpC,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAED,MAAM,MAAM,iBAAiB,GACzB;IACE,MAAM,EAAE,kBAAkB,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd,GACD;IACE,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAC7D,CAAC;AAEN,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAiCrE"}
+{"version":3,"file":"promote.d.ts","sourceRoot":"","sources":["../../src/formatters/promote.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oCAAoC;IACpC,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAED,MAAM,MAAM,iBAAiB,GACzB;IACE,MAAM,EAAE,kBAAkB,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd,GAMD;IACE,MAAM,EAAE,mBAAmB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9B,GACD;IACE,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC5D;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,YAAY,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3F;;;;;;;OAOG;IACH,qBAAqB,CAAC,EAAE;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,EAAE,MAAM,CAAC;QACtB,eAAe,EAAE,KAAK,CAAC;YACrB,YAAY,EAAE,MAAM,CAAC;YACrB,cAAc,EAAE,MAAM,CAAC;YACvB,IAAI,EAAE,MAAM,CAAC;YACb,UAAU,EAAE,MAAM,CAAC;YACnB,WAAW,EAAE,MAAM,CAAC;SACrB,CAAC,CAAC;KACJ,CAAC;IACF;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B,CAAC;AAEN,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAwErE"}

package/dist/formatters/promote.js

@@ -16,6 +16,13 @@ export function formatPromoteReceipt(data) {
         lines.push('  The entry will be committed once the proposal is approved.');
         lines.push(`  View: pb get ${data.entryId}`);
     }
+    else if ('status' in result && result.status === 'coherency_refused') {
+        lines.push(`Promote refused by the coherency gate for ${data.entryId}`);
+        lines.push(`  Entry: ${result.name}`);
+        lines.push(`  Reason: ${result.refusal.reason ?? 'refused by the coherency gate'}`);
+        lines.push('');
+        lines.push('  The entry was NOT committed — it remains a draft.');
+    }
     else {
         const r = result;
         const displayId = r.entryId ?? data.entryId;
@@ -24,6 +31,12 @@ export function formatPromoteReceipt(data) {
         if (data.commitMessage) {
             lines.push(`  Message: ${data.commitMessage}`);
         }
+        // WP-B (spec §4.3): THE RECEIPT SAYS SO — the server attested this entry as part
+        // of the promote; silence here would hide an attribution write from the operator.
+        if (r.autoVerified) {
+            const who = r.autoVerified.verifiedBy ? ` (${r.autoVerified.verifiedBy})` : '';
+            lines.push(`  Auto-verified as part of promote — ${r.autoVerified.strength}${who}`);
+        }
         if (r.qualityVerdict?.verdict === 'warn' && r.qualityVerdict.violations && r.qualityVerdict.violations.length > 0) {
             lines.push('');
             lines.push('  Quality warnings (entry committed but consider fixing):');
@@ -31,6 +44,33 @@ export function formatPromoteReceipt(data) {
                 lines.push(`    - ${v}`);
             }
         }
+        // WP-465 slice ⑤: Light-mode coherency advisory — committed, but the misalignment
+        // is surfaced to the operator alongside other warnings.
+        if (typeof r.steeringAdvisory === 'string' && r.steeringAdvisory.trim()) {
+            lines.push('');
+            lines.push('  ⚠ Coherency advisory (entry committed):');
+            lines.push(`    ${r.steeringAdvisory}`);
+        }
+        // WP-485 Slice 2b (R3, FEAT-1370): one enforcement policy — advisory only while
+        // DEC-1321 keeps `graduated: false`. The commit succeeded; this just surfaces what
+        // the server's contradiction gate found.
+        if (r.contradictionAdvisory) {
+            lines.push('');
+            lines.push('  ⚠ Contradiction advisory (entry committed):');
+            lines.push(`    ${r.contradictionAdvisory.reason}`);
+            for (const c of r.contradictionAdvisory.conflictDetails) {
+                lines.push(`    - ${c.chainEntryId} (${c.chainEntryName}): ${c.explanation}`);
+            }
+        }
+        // WP-582 B1 (FEAT-1403): direction-trace advisory — never a paste-ready `pb relate`, only
+        // the question + candidate strategy names (TEN-2906).
+        if (r.publishAdvisories && r.publishAdvisories.length > 0) {
+            lines.push('');
+            lines.push('  ⚠ Direction advisory (entry committed):');
+            for (const advisory of r.publishAdvisories) {
+                lines.push(`    ${advisory}`);
+            }
+        }
         lines.push('');
         lines.push(`  View: pb get ${displayId}`);
     }

package/dist/formatters/promote.js.map

@@ -1 +1 @@
-{"version":3,"file":"promote.js","sourceRoot":"","sources":["../../src/formatters/promote.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA0BH,MAAM,UAAU,oBAAoB,CAAC,IAAwB;IAC3D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAE3B,IAAI,QAAQ,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,kBAAkB,EAAE,CAAC;QAC/D,6DAA6D;QAC7D,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC,CAAC,kBAAkB,CAAC;QAClF,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,QAAQ,IAAI,CAAC,OAAO,oBAAoB,CAAC,CAAC;QAC9D,KAAK,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QAC/C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAC;QAC3E,KAAK,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/C,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,GAAG,MAA4I,CAAC;QACvJ,MAAM,SAAS,GAAG,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC;QAC5C,KAAK,CAAC,IAAI,CAAC,YAAY,SAAS,sBAAsB,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC;QACpE,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACnC,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;QACjD,CAAC;QACD,IAAI,CAAC,CAAC,cAAc,EAAE,OAAO,KAAK,MAAM,IAAI,CAAC,CAAC,cAAc,CAAC,UAAU,IAAI,CAAC,CAAC,cAAc,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClH,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;YACxE,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,cAAc,CAAC,UAAU,EAAE,CAAC;gBAC5C,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,kBAAkB,SAAS,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"promote.js","sourceRoot":"","sources":["../../src/formatters/promote.ts"],"names":[],"mappings":"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"}

package/dist/formatters/proposals.js

@@ -26,7 +26,7 @@ export function formatProposalsList(data) {
         }
         lines.push('');
     }
-    lines.push('Actions: pb accept <id> | pb reject <id> --reason "..."');
+    lines.push('Actions: pb proposal accept <id> | pb proposal reject <id> --reason "..."');
     return lines.join('\n');
 }
 export function formatAcceptReceipt(data) {
@@ -52,7 +52,7 @@ export function formatAutoAcceptReport(data) {
             lines.push(`    Reason: ${s.reason}`);
         }
         lines.push('');
-        lines.push('Review skipped proposals: pb proposals');
+        lines.push('Review skipped proposals: pb proposal list');
     }
     if (data.approved.length === 0 && data.skipped.length === 0) {
         return 'No open proposals to process.';

package/dist/formatters/proposals.js.map

@@ -1 +1 @@
-{"version":3,"file":"proposals.js","sourceRoot":"","sources":["../../src/formatters/proposals.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAwBH,MAAM,UAAU,mBAAmB,CAAC,IAAuB;IACzD,IAAI,IAAI,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,4BAA4B,CAAC;IACtC,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,4BAA4B,CAAC,CAAC;IACtD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,CAAC,CAAC,SAAS;YACzB,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,CAAC,CAAC,cAAc,GAAG,CAAC;gBACpB,CAAC,CAAC,gBAAgB;gBAClB,CAAC,CAAC,GAAG,CAAC,CAAC,cAAc,aAAa,CAAC;QAEvC,MAAM,SAAS,GAAG,CAAC,CAAC,kBAAkB,IAAI,CAAC,CAAC,eAAe,CAAC;QAC5D,MAAM,OAAO,GAAG,CAAC,CAAC,cAAc,IAAI,CAAC,CAAC,WAAW,IAAI,SAAS,CAAC;QAE/D,KAAK,CAAC,IAAI,CAAC,KAAK,SAAS,YAAY,OAAO,MAAM,OAAO,GAAG,CAAC,CAAC;QAC9D,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;QACzC,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,CAAC,eAAe,EAAE,CAAC;YACtB,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;QACpD,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;IACtE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAQD,MAAM,UAAU,mBAAmB,CAAC,IAAuB;IACzD,OAAO,aAAa,IAAI,CAAC,OAAO,EAAE,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAuB;IACzD,OAAO,aAAa,IAAI,CAAC,OAAO,EAAE,CAAC;AACrC,CAAC;AAOD,MAAM,UAAU,sBAAsB,CAAC,IAAsB;IAC3D,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,QAAQ,CAAC,MAAM,eAAe,CAAC,CAAC;QACjE,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,OAAO,CAAC,MAAM,wCAAwC,CAAC,CAAC;QACnF,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YACvC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QACxC,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5D,OAAO,+BAA+B,CAAC;IACzC,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}
+{"version":3,"file":"proposals.js","sourceRoot":"","sources":["../../src/formatters/proposals.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAwBH,MAAM,UAAU,mBAAmB,CAAC,IAAuB;IACzD,IAAI,IAAI,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,4BAA4B,CAAC;IACtC,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,4BAA4B,CAAC,CAAC;IACtD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,CAAC,CAAC,SAAS;YACzB,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,CAAC,CAAC,cAAc,GAAG,CAAC;gBACpB,CAAC,CAAC,gBAAgB;gBAClB,CAAC,CAAC,GAAG,CAAC,CAAC,cAAc,aAAa,CAAC;QAEvC,MAAM,SAAS,GAAG,CAAC,CAAC,kBAAkB,IAAI,CAAC,CAAC,eAAe,CAAC;QAC5D,MAAM,OAAO,GAAG,CAAC,CAAC,cAAc,IAAI,CAAC,CAAC,WAAW,IAAI,SAAS,CAAC;QAE/D,KAAK,CAAC,IAAI,CAAC,KAAK,SAAS,YAAY,OAAO,MAAM,OAAO,GAAG,CAAC,CAAC;QAC9D,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;QACzC,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,CAAC,eAAe,EAAE,CAAC;YACtB,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;QACpD,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,2EAA2E,CAAC,CAAC;IACxF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAQD,MAAM,UAAU,mBAAmB,CAAC,IAAuB;IACzD,OAAO,aAAa,IAAI,CAAC,OAAO,EAAE,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAuB;IACzD,OAAO,aAAa,IAAI,CAAC,OAAO,EAAE,CAAC;AACrC,CAAC;AAOD,MAAM,UAAU,sBAAsB,CAAC,IAAsB;IAC3D,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,QAAQ,CAAC,MAAM,eAAe,CAAC,CAAC;QACjE,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,OAAO,CAAC,MAAM,wCAAwC,CAAC,CAAC;QACnF,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YACvC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QACxC,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5D,OAAO,+BAA+B,CAAC;IACzC,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/formatters/questions.d.ts

@@ -0,0 +1,100 @@
+export interface CreateAdoptResult {
+    entryId: string;
+    facetId: string;
+    status: 'unrouted' | 'escalated';
+    suggestedRoleId?: string;
+    ownerRoleId?: string;
+    routingReason: string;
+    domainSlugs: string[];
+    nudge?: string;
+}
+/** `roleName`/`leadName` are resolved by the caller (one `chain.getEntry` lookup) — this
+ *  formatter never resolves ids itself, matching formatters/shape.ts's "no math here" rule.
+ *  The name is workspace-controlled entry/person data (a role name, a person's displayName),
+ *  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: CreateAdoptResult, roleOrLeadName: string): string;
+export declare function formatQuestionAdopt(result: CreateAdoptResult, roleOrLeadName: string): string;
+export interface AssignResult {
+    entryId: string;
+    status: 'routed' | 'unrouted' | 'escalated' | 'processed';
+    ownerRoleId?: string;
+    ownerPersonId?: string;
+    ownerPersonName?: string;
+}
+export declare function formatQuestionAssignConfirm(entryId: string): string;
+export declare function formatQuestionAssignReassign(entryId: string, targetName: string): string;
+export interface SnoozeResult {
+    entryId: string;
+    status: 'routed' | 'escalated';
+    snoozeCount?: number;
+    snoozeUntil?: number;
+    ownerRoleId?: string;
+}
+export declare function formatQuestionSnooze(result: SnoozeResult, leadName?: string): string;
+export interface DeclineResult {
+    entryId: string;
+    status: 'unrouted' | 'escalated' | 'processed';
+    suggestedRoleId?: string;
+    ownerRoleId?: string;
+    dependentsCount?: number;
+    isRoot?: boolean;
+}
+/**
+ * `isRoot` disambiguates two branches that otherwise share the identical
+ * `{status:'escalated', ownerRoleId}` shape: a suggestee's PASS (§3.7a, never sets `isRoot` —
+ * it is never the owner/lead) vs an owner/lead's decline (§3.7b, always sets `isRoot`
+ * explicitly — `true` at the root, `false` below it). Checking `isRoot !== undefined` is what
+ * tells the two apart; `ownerRoleId` alone cannot.
+ */
+export declare function formatQuestionDecline(entryId: string, result: DeclineResult, roleOrLeadName?: string): string;
+export interface AnswerResult {
+    entryId: string;
+    status: 'processed';
+    answerEntryId?: string;
+    answerPending?: boolean;
+    askerPersonId?: string;
+    askerName?: string;
+    idempotent?: boolean;
+    processedVia?: 'answered' | 'declined' | 'force_closed';
+}
+/**
+ * PRRT_kwDORS4ils6YnqK0 (round 2): does NOT mention `pb question list --mine` — S3 ships no
+ * `list` subcommand (createQuestionCommand() exposes only the seven write verbs; `list` is
+ * S4's own vertical, §4.1's slice-boundary fix). Pointing users at an unshipped command here
+ * would be a broken-command dead end; S4 restores the full §7.7 wording when `list` lands.
+ *
+ * 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":"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"}