@productbrain/cli 0.1.0-beta.1131 → 0.1.0-beta.11313

package/dist/formatters/conflicts.js

@@ -0,0 +1,105 @@
+import { stripControlChars } from '../lib/strip.js';
+function singleLine(value) {
+    return stripControlChars(value).replace(/\s+/g, ' ').trim();
+}
+/** Age is derived at render time from the existing createdAt field — never a stored field. */
+export function formatConflictAge(createdAt, now = Date.now()) {
+    const deltaMs = Math.max(0, now - createdAt);
+    const deltaSec = Math.floor(deltaMs / 1000);
+    if (deltaSec < 60)
+        return `${deltaSec}s ago`;
+    const deltaMin = Math.floor(deltaSec / 60);
+    if (deltaMin < 60)
+        return `${deltaMin}m ago`;
+    const deltaHour = Math.floor(deltaMin / 60);
+    if (deltaHour < 24)
+        return `${deltaHour}h ago`;
+    const deltaDay = Math.floor(deltaHour / 24);
+    return `${deltaDay}d ago`;
+}
+/** Longest detector reason a row prints before it is cut with an ellipsis (TASK-917). */
+export const CONFLICT_REASON_MAX_CHARS = 200;
+/** Name first, id in brackets (RULE-662, DEC-232); a deleted side has no id to print. */
+function entryLabel(name, entryId) {
+    const label = singleLine(name);
+    return entryId ? `${label} [${singleLine(entryId)}]` : label;
+}
+function boundedReason(explanation) {
+    const reason = singleLine(explanation);
+    if (reason.length === 0)
+        return '(no reason recorded)';
+    if (reason.length <= CONFLICT_REASON_MAX_CHARS)
+        return reason;
+    return `${reason.slice(0, CONFLICT_REASON_MAX_CHARS - 1).trimEnd()}…`;
+}
+export function formatConflictItem(item, now) {
+    const dangle = item.dangling ? ' [dangling]' : '';
+    const base = `[${item.confidence.toFixed(2)}] ${singleLine(item.id)} · ${entryLabel(item.entryAName, item.entryAId)} ↔ ${entryLabel(item.entryBName, item.entryBId)} · ${singleLine(item.conflictType)} · ${formatConflictAge(item.createdAt, now)}${dangle}`;
+    // TASK-917 (TEN-4850): the detector's reason rides on every row, so a pair is judged from
+    // the list without a second read of both entries.
+    const lines = [base, `      Reason: ${boundedReason(item.explanation)}`];
+    // Review fix (PR #528 P2): the API has returned guidance/humanVerdict/snoozedUntil since C2
+    // shipped — render them so a verdicted-real or snoozed debt row reads as debt, not as a
+    // plain unreviewed advisory (the `--all` guidance text was computed server-side and dropped).
+    if (item.guidance)
+        lines.push(`      ↳ ${singleLine(item.guidance)}`);
+    return lines.join('\n');
+}
+export function formatConflictsList(items, options = {}) {
+    const { mode = 'actionable', now } = options;
+    if (items.length === 0) {
+        // Review fix (PR #528 P2): an empty ACTIONABLE result must never claim "no open conflicts"
+        // when snoozed/verdicted debt rows still exist — only the 'all' read means the workspace is
+        // genuinely clean of every open row.
+        return mode === 'all'
+            ? 'No open conflicts.'
+            : 'No actionable conflicts (open, unverdicted, unsnoozed). Run `pb conflicts list --all` to see verdicted/snoozed debt.';
+    }
+    // Review fix (PR #528 round 2, P2): every row carries the SAME listTruncated stamp (checking
+    // [0] is sufficient, never re-derived per-row). D1 residue fix (named item a): actionable
+    // mode's own scan can ALSO stop before exhausting the cohort (crowded out by enough
+    // snoozed/verdicted rows) — disclosed the same way 'all' mode already discloses its cap. Known
+    // residual gap (declared, not silently dropped): a scan that finds ZERO actionable rows AND
+    // was truncated has no row left to carry the stamp — the wire shape (a bare array) has no slot
+    // for that edge case; closing it needs a response-shape change, out of this fix's scope.
+    const truncated = items[0]?.listTruncated === true;
+    const header = mode === 'all'
+        ? `Open conflicts (${items.length}${truncated ? '+' : ''})`
+        : `Actionable conflicts (${items.length}${truncated ? '+' : ''})`;
+    return [header, '', ...items.map((item) => formatConflictItem(item, now))].join('\n');
+}
+export function formatConflictResolve(value, verdict) {
+    if (value && typeof value === 'object' && 'ok' in value && value.ok === true) {
+        return verdict === 'real'
+            ? 'Verdict recorded: real — the row stays open (visible until the content changes).'
+            : 'Verdict recorded: noise — the row is resolved.';
+    }
+    return JSON.stringify(value, null, 2);
+}
+/** `pb conflicts snooze` render — bounded, logged debt (Q6: never phrased as a dismissal). */
+export function formatConflictSnooze(value) {
+    if (value && typeof value === 'object' && 'snoozedUntil' in value) {
+        const v = value;
+        return `Snoozed until ${new Date(v.snoozedUntil).toISOString()} (snooze #${v.snoozeCount}) — this is logged debt, not a verdict.`;
+    }
+    return JSON.stringify(value, null, 2);
+}
+/** `pb conflicts reverdict` render — a logged amendment, names the prior value (point 3). */
+export function formatConflictReverdict(value, verdict) {
+    if (value && typeof value === 'object' && 'priorVerdict' in value) {
+        const v = value;
+        return `Reverdicted: ${v.priorVerdict} → ${verdict} (logged amendment).`;
+    }
+    return JSON.stringify(value, null, 2);
+}
+export function formatConflictsSummary(value) {
+    const lowerBoundText = value.humanBar.lowerBound === null
+        ? 'null (no reviewed rows yet)'
+        : value.humanBar.lowerBound.toFixed(3);
+    const sampledSuffix = value.truncated ? ' (sampled — scan cap reached)' : '';
+    return [
+        `Verdict summary: reviewed ${value.reviewed}, real ${value.real}, falseAlarm ${value.falseAlarm}${sampledSuffix}`,
+        `Wilson bar (human cohort): lowerBound ${lowerBoundText}, meets ${value.humanBar.meets}${sampledSuffix}`,
+    ].join('\n');
+}
+//# sourceMappingURL=conflicts.js.map

package/dist/formatters/conflicts.js.map

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

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

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

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

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

package/dist/formatters/conflicts.test.js

@@ -0,0 +1,166 @@
+import { describe, expect, it } from 'vitest';
+import { formatConflictAge, formatConflictsList, formatConflictResolve, formatConflictsSummary, CONFLICT_REASON_MAX_CHARS, } from './conflicts.js';
+const NOW = 1_800_000_000_000;
+function item(overrides = {}) {
+    return {
+        id: 'issue-1',
+        entryAId: 'DEC-1',
+        entryAName: 'Ship weekly',
+        entryBId: 'DEC-2',
+        entryBName: 'Ship monthly',
+        conflictType: 'contradiction',
+        confidence: 0.85,
+        explanation: 'Test conflict',
+        createdAt: NOW - 3 * 24 * 60 * 60 * 1000,
+        dangling: false,
+        ...overrides,
+    };
+}
+describe('conflicts formatters', () => {
+    // Review fix (PR #528 P2): the empty-state message is now MODE-AWARE — an empty ACTIONABLE
+    // result must never claim "no open conflicts" when verdicted/snoozed debt rows still exist.
+    it('renders an honest empty state for the actionable (default) mode — never "no open conflicts" when debt may still exist', () => {
+        expect(formatConflictsList([], { now: NOW })).toContain('No actionable conflicts');
+        expect(formatConflictsList([], { now: NOW })).not.toBe('No open conflicts.');
+    });
+    it('renders "No open conflicts." only for the all-mode empty state (the workspace is genuinely clean)', () => {
+        expect(formatConflictsList([], { mode: 'all', now: NOW })).toBe('No open conflicts.');
+    });
+    it('renders workspace rows with entry names, confidence, and relative age', () => {
+        const output = formatConflictsList([item()], { now: NOW });
+        expect(output).toContain('Actionable conflicts (1)');
+        expect(output).toContain('Ship weekly');
+        expect(output).toContain('Ship monthly');
+        expect(output).toContain('0.85');
+        expect(output).toContain('3d ago');
+    });
+    // TASK-917 (TEN-4850): a row is judged from the list alone: issue id, both names with
+    // their ids in brackets (RULE-662, DEC-232), type, age, and the detector reason below.
+    it('prints the issue id, both entry ids beside their names and the detector reason on every row', () => {
+        const output = formatConflictsList([item(), item({ id: 'issue-2', entryAId: 'RULE-9', entryAName: 'One owner', entryBId: 'TEN-4', entryBName: 'Two owners', explanation: 'Both claim the same seat.' })], { now: NOW });
+        expect(output.split('\n')).toEqual([
+            'Actionable conflicts (2)',
+            '',
+            '[0.85] issue-1 · Ship weekly [DEC-1] ↔ Ship monthly [DEC-2] · contradiction · 3d ago',
+            '      Reason: Test conflict',
+            '[0.85] issue-2 · One owner [RULE-9] ↔ Two owners [TEN-4] · contradiction · 3d ago',
+            '      Reason: Both claim the same seat.',
+        ]);
+    });
+    it('cuts a long reason at the bound with an ellipsis and flattens line breaks', () => {
+        const long = `${'word '.repeat(80)}\nsecond line`;
+        const reasonLine = formatConflictsList([item({ explanation: long })], { now: NOW }).split('\n')[3];
+        const reason = reasonLine.replace('      Reason: ', '');
+        expect(reason.length).toBeLessThanOrEqual(CONFLICT_REASON_MAX_CHARS);
+        expect(reason.endsWith('…')).toBe(true);
+        expect(reasonLine).not.toContain('second line');
+    });
+    it('says no reason was recorded instead of printing an empty reason', () => {
+        const output = formatConflictsList([item({ explanation: '  ' })], { now: NOW });
+        expect(output).toContain('Reason: (no reason recorded)');
+    });
+    it('prints a deleted side by its placeholder name with no empty brackets', () => {
+        const output = formatConflictsList([item({ entryBId: null, entryBName: '(deleted entry)', dangling: true })], { now: NOW });
+        expect(output).toContain('Ship weekly [DEC-1] ↔ (deleted entry) · ');
+        expect(output).not.toContain('[]');
+    });
+    it('marks dangling rows (a partner entry was deleted)', () => {
+        const output = formatConflictsList([item({ dangling: true })], { now: NOW });
+        expect(output).toContain('[dangling]');
+    });
+    it('renders the non-underscore id — the field that survives the CLI JSON envelope\'s stripConvexInternals (TEN-340)', () => {
+        const output = formatConflictsList([item({ id: 'issue-target-1' })], { now: NOW });
+        expect(output).toContain('issue-target-1');
+    });
+    // C2 (WP-468) review fix (PR #528 P2): the server-computed per-row guidance for a
+    // verdicted/snoozed debt row must actually render in the `--all` pretty output.
+    it('renders per-row guidance text for a verdicted/snoozed debt row in --all mode', () => {
+        const output = formatConflictsList([item({ humanVerdict: 'real', guidance: 'confirmed contradiction (real) — supersede or archive one side' })], { mode: 'all', now: NOW });
+        expect(output).toContain('Open conflicts (1)');
+        expect(output).toContain('confirmed contradiction (real)');
+    });
+    it('renders a plain row (no guidance line) for an actionable row with no guidance field', () => {
+        const output = formatConflictsList([item()], { now: NOW });
+        expect(output).not.toContain('↳');
+    });
+    it('derives age purely from createdAt at render time — sub-minute, sub-hour, sub-day tiers', () => {
+        expect(formatConflictAge(NOW - 30_000, NOW)).toBe('30s ago');
+        expect(formatConflictAge(NOW - 5 * 60_000, NOW)).toBe('5m ago');
+        expect(formatConflictAge(NOW - 2 * 60 * 60_000, NOW)).toBe('2h ago');
+        expect(formatConflictAge(NOW - 4 * 24 * 60 * 60_000, NOW)).toBe('4d ago');
+    });
+    it('renders a resolve receipt naming the recorded CLI-vocabulary verdict — real stays open, noise resolves (C2)', () => {
+        expect(formatConflictResolve({ ok: true }, 'real')).toContain('real');
+        expect(formatConflictResolve({ ok: true }, 'real')).toContain('stays open');
+        expect(formatConflictResolve({ ok: true }, 'false_alarm')).toContain('noise');
+        expect(formatConflictResolve({ ok: true }, 'false_alarm')).toContain('resolved');
+    });
+    it('renders the summary with raw counts and the humanBar Wilson-bound fields exactly as returned', () => {
+        const output = formatConflictsSummary({
+            reviewed: 2,
+            real: 1,
+            falseAlarm: 1,
+            open: 0,
+            resolvedWithoutVerdict: 0,
+            precision: 0.5,
+            truncated: false,
+            humanBar: { meets: false, lowerBound: 0.05, reviewed: 2 },
+            escalatedCohort: { byModel: {}, crossTab: [] },
+        });
+        expect(output).toContain('reviewed 2');
+        expect(output).toContain('real 1');
+        expect(output).toContain('falseAlarm 1');
+        expect(output).toContain('meets false');
+        expect(output).toContain('0.05'.slice(0, 4));
+    });
+    it('renders humanBar.lowerBound === null as an explicit, honest empty state — never a blank or "0"', () => {
+        const output = formatConflictsSummary({
+            reviewed: 0,
+            real: 0,
+            falseAlarm: 0,
+            open: 0,
+            resolvedWithoutVerdict: 0,
+            precision: 0,
+            truncated: false,
+            humanBar: { meets: false, lowerBound: null, reviewed: 0 },
+            escalatedCohort: { byModel: {}, crossTab: [] },
+        });
+        expect(output).toContain('null');
+        expect(output).not.toContain('lowerBound 0,');
+    });
+    // Review fix (PR #528 round 3, P2): when the verdict scan truncated, reviewed/real/falseAlarm
+    // and the Wilson bar describe only the SAMPLED cohort — must render a qualifier, matching the
+    // scoreboard panel's existing verdictsSuffix pattern.
+    it('renders a truncation qualifier on both lines when the verdict scan truncated', () => {
+        const output = formatConflictsSummary({
+            reviewed: 1300,
+            real: 1200,
+            falseAlarm: 100,
+            open: 0,
+            resolvedWithoutVerdict: 0,
+            precision: 0.92,
+            truncated: true,
+            humanBar: { meets: true, lowerBound: 0.9, reviewed: 1300 },
+            escalatedCohort: { byModel: {}, crossTab: [] },
+        });
+        expect(output).toContain('sampled — scan cap reached');
+        const lines = output.split('\n');
+        expect(lines[0]).toContain('sampled — scan cap reached');
+        expect(lines[1]).toContain('sampled — scan cap reached');
+    });
+    it('renders NO truncation qualifier when the verdict scan did not truncate', () => {
+        const output = formatConflictsSummary({
+            reviewed: 2,
+            real: 1,
+            falseAlarm: 1,
+            open: 0,
+            resolvedWithoutVerdict: 0,
+            precision: 0.5,
+            truncated: false,
+            humanBar: { meets: false, lowerBound: 0.05, reviewed: 2 },
+            escalatedCohort: { byModel: {}, crossTab: [] },
+        });
+        expect(output).not.toContain('sampled');
+    });
+});
+//# sourceMappingURL=conflicts.test.js.map

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

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

package/dist/formatters/context.d.ts

@@ -7,7 +7,7 @@ export interface ContextRelatedEntry {
     _id?: string;
     entryId: string | null;
     name: string;
-    canonicalKey?: string;
+    canonicalKey: string | null;
     collectionSlug?: string;
     collectionName?: string;
     relationType?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/formatters/context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,mBAAmB;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE;QACJ,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE;IAAE,GAAG,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAKtF"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/formatters/context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,mBAAmB;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IAGb,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE;QACJ,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE;IAAE,GAAG,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAKtF"}

package/dist/formatters/context.js.map

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

package/dist/formatters/direction.d.ts

@@ -0,0 +1,48 @@
+/**
+ * `pb direction` — human-formatted rendering for the upward direction trace (WP-582 B1,
+ * FEAT-1403). Mirrors formatters/conflicts.ts's shape: kernel purity, no state-machine logic
+ * here — every field is rendered exactly as the stored directionTraceSnapshots row carries it.
+ */
+export type DirectionTraceChallengedState = 'reachedVisionOnly' | 'noPath' | 'truncated';
+export interface DirectionTraceSampleRow {
+    entryId: string;
+    name: string;
+    state: DirectionTraceChallengedState;
+    updatedAt: number;
+    candidateStrategyNames: string[];
+    deferred?: {
+        reason: string;
+        deferredAt: number;
+    };
+}
+export interface DirectionTraceCounts {
+    reached: number;
+    reachedVisionOnly: number;
+    reachedUnclassified: number;
+    noPath: number;
+    truncated: number;
+    total: number;
+}
+export interface DirectionTraceSnapshot {
+    computedAt: number;
+    counts: DirectionTraceCounts;
+    sample: DirectionTraceSampleRow[];
+    sampleTruncated?: boolean;
+    sampleTotalChallenged?: number;
+    originsTruncated?: boolean;
+    baselineAt: number;
+    baselineCounts: DirectionTraceCounts;
+}
+export declare const DIRECTION_LIST_DEFAULT_LIMIT = 5;
+export declare function formatDirectionList(snapshot: DirectionTraceSnapshot | null, options?: {
+    all?: boolean;
+}): string;
+export declare function formatDirectionRefresh(result: {
+    counts: DirectionTraceCounts;
+}): string;
+export declare function formatDirectionDefer(result: {
+    entryId: string;
+    reason: string;
+    count?: number;
+}): string;
+//# sourceMappingURL=direction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"direction.d.ts","sourceRoot":"","sources":["../../src/formatters/direction.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAIH,MAAM,MAAM,6BAA6B,GAAG,mBAAmB,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEzF,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,6BAA6B,CAAC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB,EAAE,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CACnD;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,MAAM,EAAE,uBAAuB,EAAE,CAAC;IAIlC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAI/B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,oBAAoB,CAAC;CACtC;AAoBD,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAE9C,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI,EAAE,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,MAAM,CAgDpH;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,oBAAoB,CAAA;CAAE,GAAG,MAAM,CAIvF;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAGxG"}

package/dist/formatters/direction.js

@@ -0,0 +1,75 @@
+import { stripControlChars } from '../lib/strip.js';
+function singleLine(value) {
+    return stripControlChars(value).replace(/\s+/g, ' ').trim();
+}
+const STATE_LABEL = {
+    reachedVisionOnly: 'vision-only',
+    noPath: 'no path',
+    truncated: 'truncated (inconclusive)',
+};
+function formatSampleRow(row) {
+    const deferredNote = row.deferred ? ` [deferred: ${singleLine(row.deferred.reason)}]` : '';
+    const candidatesNote = row.candidateStrategyNames.length > 0
+        ? ` · candidates: ${row.candidateStrategyNames.map(singleLine).join(', ')}`
+        : '';
+    return `${singleLine(row.entryId)} · ${singleLine(row.name)} · ${STATE_LABEL[row.state]}${candidatesNote}${deferredNote}`;
+}
+export const DIRECTION_LIST_DEFAULT_LIMIT = 5;
+export function formatDirectionList(snapshot, options = {}) {
+    if (!snapshot) {
+        return 'Direction trace: not computed yet · `pb direction refresh`';
+    }
+    const { counts, sample } = snapshot;
+    const computedAtIso = new Date(snapshot.computedAt).toISOString();
+    const baselineIso = new Date(snapshot.baselineAt).toISOString();
+    const lines = [
+        `Direction trace (computed ${computedAtIso}) — baseline accepted ${baselineIso}:`,
+        `  reached ${counts.reached} · vision-only ${counts.reachedVisionOnly} · unclassified ${counts.reachedUnclassified} · ` +
+            `no-path ${counts.noPath} · truncated ${counts.truncated} · total ${counts.total}`,
+        `  (baseline: reached ${snapshot.baselineCounts.reached} of ${snapshot.baselineCounts.total} — a newly-honest signal, not an improvement)`,
+    ];
+    if (sample.length === 0) {
+        // Codex P2 review (PR #529): an empty sample is honestly "every bet reaches a strategy" ONLY
+        // when reached === total. `reachedUnclassified` is deliberately excluded from the sample (the
+        // shape's own contract) but is NOT `reached` — a workspace where every non-reached bet landed
+        // on an unclassified strategy-collection terminal would previously render the same falsely
+        // reassuring "every bet reaches a strategy" line despite `counts.reachedUnclassified > 0`.
+        if (counts.reached === counts.total) {
+            lines.push('', 'No challenged work packages — every active work package reaches a strategy.');
+        }
+        else {
+            lines.push('', `No challenged work packages in the sample, but ${counts.reachedUnclassified} work package${counts.reachedUnclassified === 1 ? '' : 's'} ` +
+                'reached an unclassified strategy-collection terminal (excluded from "challenged" by design — see `counts` above).');
+        }
+        if (snapshot.originsTruncated) {
+            lines.push('', '⚠ Origin enumeration capped at 1000 active work packages — `counts.total` may under-count the true denominator.');
+        }
+        return lines.join('\n');
+    }
+    const shown = options.all ? sample : sample.slice(0, DIRECTION_LIST_DEFAULT_LIMIT);
+    lines.push('', `Challenged work packages${options.all ? '' : ` (top ${shown.length} of ${sample.length}, most-recently-updated first — \`--all\` for the rest)`}:`);
+    for (const row of shown)
+        lines.push(`  ${formatSampleRow(row)}`);
+    if (snapshot.sampleTruncated) {
+        // Codex P2 review (PR #529): the prior text claimed "recompute narrows this only by deferring
+        // or resolving some" — false. Deferring a bet logs bounded debt on the ENTRY but never removes
+        // it from the challenged set (readBetDeferFlags still surfaces it, `deferred` just annotates
+        // the row), and "resolving" means linking a real strategy via `pb relate` (out of this
+        // command's control entirely) — recompute alone never narrows a truncated sample.
+        lines.push('', `⚠ Snapshot capped: showing ${sample.length} of ${snapshot.sampleTotalChallenged ?? '?'} total challenged work packages — link real strategies (\`pb relate\`) to the shown work packages to narrow this; deferring only logs debt, it does not remove a work package from the challenged set.`);
+    }
+    if (snapshot.originsTruncated) {
+        lines.push('', '⚠ Origin enumeration capped at 1000 active work packages — `counts.total` may under-count the true denominator.');
+    }
+    return lines.join('\n');
+}
+export function formatDirectionRefresh(result) {
+    const { counts } = result;
+    return `Direction trace refreshed — reached ${counts.reached} · vision-only ${counts.reachedVisionOnly} · ` +
+        `unclassified ${counts.reachedUnclassified} · no-path ${counts.noPath} · truncated ${counts.truncated} · total ${counts.total}`;
+}
+export function formatDirectionDefer(result) {
+    const countNote = typeof result.count === 'number' ? ` (deferred ${result.count} time${result.count === 1 ? '' : 's'} — bounded debt` : ' (bounded debt';
+    return `Deferred ${singleLine(result.entryId)}: ${singleLine(result.reason)}${countNote}, never an ack, never auto-related)`;
+}
+//# sourceMappingURL=direction.js.map

package/dist/formatters/direction.js.map

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

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

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

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

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

package/dist/formatters/direction.test.js

@@ -0,0 +1,70 @@
+import { describe, expect, it } from 'vitest';
+import { formatDirectionList } from './direction.js';
+const NOW = 1_800_000_000_000;
+function baseCounts(overrides = {}) {
+    return {
+        reached: 10, reachedVisionOnly: 0, reachedUnclassified: 0, noPath: 0, truncated: 0, total: 10,
+        ...overrides,
+    };
+}
+function snapshot(overrides = {}) {
+    return {
+        computedAt: NOW,
+        counts: baseCounts(),
+        sample: [],
+        baselineAt: NOW - 1000,
+        baselineCounts: baseCounts(),
+        ...overrides,
+    };
+}
+describe('direction formatters', () => {
+    it('renders the honest "every bet reaches a strategy" line only when reached === total', () => {
+        const output = formatDirectionList(snapshot({ counts: baseCounts({ reached: 10, total: 10 }) }));
+        expect(output).toContain('No challenged work packages — every active work package reaches a strategy.');
+    });
+    it('does NOT claim "every bet reaches a strategy" when the empty sample hides unclassified terminals (Codex P1/P2, PR #529 T8)', () => {
+        // reachedUnclassified is excluded from the sample by design, but a bet reaching an
+        // unclassified terminal has NOT reached a strategy — the old unconditional "sample.length
+        // === 0" branch rendered the same falsely reassuring line regardless.
+        const output = formatDirectionList(snapshot({
+            counts: baseCounts({ reached: 4, reachedUnclassified: 6, total: 10 }),
+        }));
+        expect(output).not.toContain('every active work package reaches a strategy');
+        expect(output).toContain('6 work packages reached an unclassified strategy-collection terminal');
+    });
+    it('singularizes the unclassified-terminal count message for exactly one bet', () => {
+        const output = formatDirectionList(snapshot({
+            counts: baseCounts({ reached: 9, reachedUnclassified: 1, total: 10 }),
+        }));
+        expect(output).toContain('1 work package reached an unclassified strategy-collection terminal');
+    });
+    it('does not claim deferring narrows a truncated sample (Codex P2, PR #529 T9)', () => {
+        const output = formatDirectionList(snapshot({
+            counts: baseCounts({ reached: 0, noPath: 300, total: 300 }),
+            sample: Array.from({ length: 200 }, (_, i) => ({
+                entryId: `WP-${i}`,
+                name: `Bet ${i}`,
+                state: 'noPath',
+                updatedAt: NOW - i,
+                candidateStrategyNames: [],
+            })),
+            sampleTruncated: true,
+            sampleTotalChallenged: 300,
+        }));
+        expect(output).toContain('⚠ Snapshot capped');
+        expect(output).not.toContain('recompute narrows this only by deferring or resolving some');
+        expect(output).toContain('deferring only logs debt, it does not remove a work package from the challenged set');
+    });
+    it('renders an originsTruncated warning distinct from sampleTruncated (Codex P2, PR #529 T2)', () => {
+        const output = formatDirectionList(snapshot({
+            counts: baseCounts({ reached: 1000, total: 1000 }),
+            originsTruncated: true,
+        }));
+        expect(output).toContain('⚠ Origin enumeration capped at 1000 active work packages');
+    });
+    it('omits the originsTruncated warning when the flag is absent or false', () => {
+        const output = formatDirectionList(snapshot({ counts: baseCounts({ reached: 10, total: 10 }) }));
+        expect(output).not.toContain('Origin enumeration capped');
+    });
+});
+//# sourceMappingURL=direction.test.js.map

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

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