@productbrain/cli 0.1.0-beta.5 → 0.1.0-beta.5060

package/dist/formatters/relate.test.js

@@ -0,0 +1,81 @@
+import { describe, expect, it } from 'vitest';
+import { formatRelateReceipt, formatUnrelateReceipt } from './relate.js';
+describe('formatRelateReceipt', () => {
+    it('renders a plain receipt with no advisories', () => {
+        const out = formatRelateReceipt({ fromId: 'A', type: 'informs', toId: 'B', action: 'related' });
+        expect(out).toBe('→ A –[informs]→ B');
+    });
+    it('renders alreadyExists', () => {
+        const out = formatRelateReceipt({ fromId: 'A', type: 'informs', toId: 'B', action: 'related', alreadyExists: true });
+        expect(out).toBe('Already exists: A –[informs]→ B');
+    });
+    it('renders proposal_created', () => {
+        const out = formatRelateReceipt({ fromId: 'A', type: 'governs', toId: 'B', action: 'proposal_created' });
+        expect(out).toBe('Proposal created (requires approval): A –[governs]→ B');
+    });
+    // WP-625 (S3 of WP-618, DEC-1546, TEN-3037): the advisory must reach the terminal — this IS
+    // doneWhen 6's mechanism (a Convex log line does not satisfy it; this printer does).
+    it('appends every advisory, naming the rule, the org stage, and the rule text', () => {
+        const out = formatRelateReceipt({
+            fromId: 'STR-1', type: 'depends_on', toId: 'STR-2', action: 'related',
+            advisories: [
+                { ruleId: 'REL-LEGAL-1', ruleText: 'REL-LEGAL-1: relation type "depends_on" is not declared valid for "vision".', severity: 'advisory', stage: 'discovering' },
+            ],
+        });
+        expect(out).toContain('→ STR-1 –[depends_on]→ STR-2');
+        expect(out).toContain('⚠ REL-LEGAL-1');
+        // WP-625 review round 1: the pretty printer used to drop `stage` — discovering vs.
+        // established advisories looked identical even though the backend resolves it deliberately.
+        expect(out).toContain('org stage: discovering');
+        expect(out).toContain('not declared valid for "vision"');
+    });
+    it('WP-625 review round 1: a discovering advisory and an established advisory print differently', () => {
+        const base = { fromId: 'STR-1', type: 'depends_on', toId: 'STR-2', action: 'related' };
+        const discovering = formatRelateReceipt({ ...base, advisories: [{ ruleId: 'REL-LEGAL-1', ruleText: 'x', severity: 'advisory', stage: 'discovering' }] });
+        const established = formatRelateReceipt({ ...base, advisories: [{ ruleId: 'REL-LEGAL-1', ruleText: 'x', severity: 'advisory', stage: 'established' }] });
+        expect(discovering).not.toBe(established);
+    });
+    it('renders multiple co-occurring advisories, each on its own line', () => {
+        const out = formatRelateReceipt({
+            fromId: 'STR-1', type: 'part_of', toId: 'STR-1', action: 'related',
+            advisories: [
+                { ruleId: 'REL-LEGAL-1', ruleText: 'REL-LEGAL-1: ...', severity: 'advisory', stage: 'discovering' },
+                { ruleId: 'ALT-1', ruleText: 'ALT-1: self-nesting never in WHY/MEMORY — DEC-1546.', severity: 'advisory', stage: 'discovering' },
+            ],
+        });
+        expect(out).toContain('⚠ REL-LEGAL-1');
+        expect(out).toContain('⚠ ALT-1');
+        expect(out).toContain('DEC-1546');
+    });
+    it('adds no advisory lines when the array is empty or absent', () => {
+        const withEmpty = formatRelateReceipt({ fromId: 'A', type: 'informs', toId: 'B', action: 'related', advisories: [] });
+        const withUndefined = formatRelateReceipt({ fromId: 'A', type: 'informs', toId: 'B', action: 'related' });
+        expect(withEmpty).toBe('→ A –[informs]→ B');
+        expect(withUndefined).toBe('→ A –[informs]→ B');
+    });
+});
+describe('formatRelateReceipt — dry_run (WP-688 S2a)', () => {
+    it('renders a clean dry-run with no blocking, no advisories', () => {
+        const out = formatRelateReceipt({ fromId: 'A', type: 'informs', toId: 'B', action: 'dry_run' });
+        expect(out).toBe('[dry-run, no write] A –[informs]→ B');
+    });
+    it('renders a wouldBlock dry-run with its reason', () => {
+        const out = formatRelateReceipt({ fromId: 'A', type: 'anchored_to', toId: 'B', action: 'dry_run', wouldBlock: true, blockingReason: 'scope collapse' });
+        expect(out).toContain('[dry-run, no write] A –[anchored_to]→ B');
+        expect(out).toContain('✗ would be BLOCKED: scope collapse');
+    });
+    it('renders dry-run advisories the same way a real write would', () => {
+        const out = formatRelateReceipt({
+            fromId: 'A', type: 'conflicts_with', toId: 'B', action: 'dry_run',
+            advisories: [{ ruleId: 'REL-LEGAL-1', ruleText: 'x', severity: 'advisory', stage: 'discovering' }],
+        });
+        expect(out).toContain('[dry-run, no write] A –[conflicts_with]→ B');
+        expect(out).toContain('⚠ REL-LEGAL-1');
+    });
+});
+describe('formatUnrelateReceipt', () => {
+    it('renders the removal receipt', () => {
+        expect(formatUnrelateReceipt({ fromId: 'A', type: 'informs', toId: 'B', action: 'unrelated' })).toBe('✗ Removed A –[informs]→ B');
+    });
+});
+//# sourceMappingURL=relate.test.js.map

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

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

package/dist/formatters/scoreboard.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Scoreboard formatter — compact human-readable board for `pb scoreboard` (pretty mode).
+ *
+ * The JSON mode (the agent-primary surface) emits the full structured ScoreboardCliView; this is
+ * the human glance: one line per metric with a status glyph, the raw reading, and (when not ok)
+ * the next action. The standing coaching/moat `unmeasured` line always prints — honesty over
+ * flattery (four green tiles ≠ a healthy moat).
+ */
+import type { ScoreboardCliView } from '../commands/scoreboard.js';
+export declare function formatScoreboard(view: ScoreboardCliView): string;
+//# sourceMappingURL=scoreboard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scoreboard.d.ts","sourceRoot":"","sources":["../../src/formatters/scoreboard.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AA0InE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAuBhE"}

package/dist/formatters/scoreboard.js

@@ -0,0 +1,164 @@
+/**
+ * Scoreboard formatter — compact human-readable board for `pb scoreboard` (pretty mode).
+ *
+ * The JSON mode (the agent-primary surface) emits the full structured ScoreboardCliView; this is
+ * the human glance: one line per metric with a status glyph, the raw reading, and (when not ok)
+ * the next action. The standing coaching/moat `unmeasured` line always prints — honesty over
+ * flattery (four green tiles ≠ a healthy moat).
+ */
+import { green, red, yellow, dim, bold, cyan } from '../lib/style.js';
+function statusGlyph(status) {
+    switch (status) {
+        case 'ok':
+            return green('OK ');
+        case 'degraded':
+            return red('DEGRADED');
+        case 'awaiting':
+            return yellow('AWAITING');
+        case 'unmeasured':
+            return dim('UNMEASURED');
+    }
+}
+function formatLine(d) {
+    const head = `${statusGlyph(d.status).padEnd(10)} ${bold(d.metric)} ${d.label}`;
+    const reading = `    ${dim('reading:')} ${d.reading}`;
+    const lines = [head, reading];
+    if (d.status !== 'ok') {
+        lines.push(`    ${dim('cause:')}   ${d.cause}`);
+        if (d.nextAction)
+            lines.push(`    ${cyan('→')} ${d.nextAction}`);
+    }
+    return lines.join('\n');
+}
+/** A parenthetical qualifier for a value sampled from a scan-capped read — never silently
+ *  presented as complete (PR #422 review: the label-honesty failure this run exists to prevent). */
+function truncatedQualifier(truncated) {
+    return truncated ? ' (sampled — scan cap reached)' : '';
+}
+/**
+ * WP-499 Slice B (TEN-2743, §2.5): the coherence panel renders RAW values, never a diagnosis
+ * tile — DEC-1282, no thresholds baked in. `humanBar.meets`/`lowerBound` is the one legitimate
+ * bar-comparison output (from readVerdictSummary); this section never computes a second one.
+ */
+function formatCoherence(c) {
+    const lowerBoundText = c.humanBar.lowerBound === null ? 'null' : c.humanBar.lowerBound.toFixed(3);
+    // PR #422 review (Codex): reviewed/real/falseAlarm/humanBar.meets are a SAMPLE, not a
+    // complete count, whenever readVerdictSummary's scan was capped — a misleading `meets` is
+    // exactly what a reader must never see rendered as if it were the full picture.
+    const verdictsSuffix = truncatedQualifier(c.reviewedTruncated);
+    // PR #422 review round 2 (Codex): overrides/heldBlocks come from two INDEPENDENTLY capped
+    // partitions — the server returns rate:null whenever truncated is true (dividing them would
+    // bias the ratio, e.g. 5,000 real overrides capped to 500 alongside 500 real held-blocks
+    // would read 50% instead of the true ~91%). So truncated+null is a DISTINCT, self-explaining
+    // state from "no data yet" (denominator===0, truncated:false) — never conflate the two
+    // messages, and never suffix a generic qualifier onto either.
+    const overrideRateText = c.contradictionOverrideRate.rate !== null
+        ? `${(c.contradictionOverrideRate.rate * 100).toFixed(0)}%`
+        : c.contradictionOverrideRate.truncated
+            ? 'rate unavailable — too many events to sample reliably (scan cap reached)'
+            : 'no enforcement events yet';
+    const openConflictsSuffix = c.openConflictsTruncated ? '+' : '';
+    // Review fix (PR #528 P1): this is the OBSERVED precision (real/reviewed), a DIFFERENT
+    // number from humanBar.lowerBound (the Wilson confidence bound on the same ratio) — a
+    // 1-real/0-falseAlarm cohort reads precision 1.000 while lowerBound sits well below 1.
+    // `c.precision` is itself optional (an older deployment's payload predates the field).
+    // Review fix (PR #528 round 2, P2): when the verdict-cohort scan truncated, `precision` is
+    // only the ratio within the SAMPLED rows, not the full population — the same honesty rule
+    // already applied to the counts/humanBar lines above (verdictsSuffix) must also cover this.
+    const precisionText = c.precision === undefined
+        ? 'n/a (older deployment)'
+        : c.precision === null
+            ? 'n/a (N=0)'
+            : `${c.precision.toFixed(3)}${verdictsSuffix}`;
+    // PR #422 review (Codex): detectionCoverage was assembled server-side specifically for this
+    // panel but never rendered — an operator running the default pretty `pb scoreboard` never saw
+    // it at all.
+    const surfaces = Object.keys(c.detectionCoverage.bySurface);
+    const detectionLines = surfaces.length === 0
+        ? [`    ${dim('detection coverage:')} no detection events yet`]
+        : [
+            `    ${dim('detection coverage:')} scanned ${c.detectionCoverage.scanned}${truncatedQualifier(c.detectionCoverage.truncated)}`,
+            ...surfaces.map((surface) => {
+                const counts = c.detectionCoverage.bySurface[surface];
+                return `      ${surface}: checked_clear=${counts.checked_clear} checked_conflicts=${counts.checked_conflicts} partial=${counts.partial} unavailable=${counts.unavailable}`;
+            }),
+        ];
+    // Review fix (PR #528 P1): every C2 field on CoherencePayload is OPTIONAL — an older
+    // deployment's `coherence` object can be present (passing the `if (payload.coherence)`
+    // guard in formatScoreboard below) while lacking every field C2 added. Missing-field →
+    // undefined → wrong-branch is a documented trap in this repo; render "n/a", never
+    // dereference `c.dial.coherencyMode` unguarded (the exact crash the finding named).
+    const hasQueueFields = c.openUnverdicted !== undefined && c.verdictedOpenCount !== undefined && c.snoozedCount !== undefined;
+    // Adversarial done-audit fix (set-algebra advertising): snoozedUnverdicted publishes the third
+    // partition (open + unverdicted + currently snoozed) — see coherenceDial.ts's identity note.
+    // Optional/predates-this-fix, same convention as every other C2 queue field. Review fix (PR
+    // #539, Codex P2, "qualify truncated snoozed-unverdicted counts"): derived from the SAME
+    // sample as openUnverdicted (healSweepRuns.ts's computeVerdictSummary — one fetch, two
+    // filters), so it shares openUnverdicted's OWN truncation flag, never rendered as exact
+    // when the sample itself was capped.
+    const snoozedUnverdictedSuffix = c.snoozedUnverdicted !== undefined
+        ? `, snoozed-unverdicted ${c.snoozedUnverdicted}${truncatedQualifier(!!c.openUnverdictedTruncated)}`
+        : '';
+    const queueLine = hasQueueFields
+        ? `    ${dim('queue:')} actionable ${c.openUnverdicted}${truncatedQualifier(!!c.openUnverdictedTruncated)}, `
+            + `verdicted-open ${c.verdictedOpenCount}${truncatedQualifier(!!c.verdictedOpenTruncated)}, `
+            + `snoozed ${c.snoozedCount}${truncatedQualifier(!!c.snoozedCountTruncated)}${snoozedUnverdictedSuffix}`
+        : `    ${dim('queue:')} n/a (older deployment)`;
+    // Review fix (PR #528 round 2, P2): totalOpen is countOpenConflictIssues' own 200-row-capped
+    // count — the adjacent legacy `open conflicts:` line above already qualifies with `+` via
+    // openConflictsSuffix; this line rendered an exact-looking number with no such signal.
+    const totalOpenLine = c.totalOpen === undefined
+        ? `    ${dim('total open:')} n/a (older deployment)`
+        : `    ${dim('total open:')} ${c.totalOpen}${truncatedQualifier(!!c.totalOpenTruncated)}${c.totalOpenAlarm ? ' ⚠ ALARM — 150+ open rows' : ''}`;
+    const dialLine = c.dial === undefined
+        ? `    ${dim('dial:')} n/a (older deployment)`
+        : `    ${dim('dial:')} mode=${c.dial.coherencyMode} br170Graduated=${c.dial.br170Graduated} br170GraduatedPinned=${c.dial.br170GraduatedPinned}`;
+    // C1 (WP-468/FEAT-1408): at-cap disclosure for publish-origin rows (10-row cap) — never
+    // telemetry-only (spec requirement). Missing field → older deployment, same n/a convention.
+    const publishOriginLine = c.publishOriginOpen === undefined
+        ? `    ${dim('publish-origin:')} n/a (older deployment)`
+        : `    ${dim('publish-origin:')} ${c.publishOriginOpen}/10${truncatedQualifier(!!c.publishOriginTruncated)}${c.publishOriginAtCap ? ' ⚠ AT CAP' : ''}`;
+    return [
+        `${bold('COHERENCE')} Contradiction advisories & verdicts`,
+        `    ${dim('open conflicts:')} ${c.openConflictCount}${openConflictsSuffix}`,
+        `    ${dim('verdicts:')} reviewed ${c.reviewed}, real ${c.real}, falseAlarm ${c.falseAlarm}${verdictsSuffix}`,
+        `    ${dim('humanBar:')} lowerBound ${lowerBoundText}, meets ${c.humanBar.meets}${verdictsSuffix}`,
+        `    ${dim('precision:')} ${precisionText}`,
+        // point 8: the actionable/verdicted-open/snoozed set. Adversarial done-audit fix
+        // (set-algebra advertising): the true identity is totalOpen = actionable +
+        // snoozed-unverdicted + verdicted-open — an unverdicted row IS moved out of "actionable"
+        // by snoozing (isActionableConflictIssue excludes it); snoozed-unverdicted is that bucket.
+        queueLine,
+        totalOpenLine,
+        // point 8, scope-doc F10: the dial state — previously unreadable from any scoreboard surface.
+        dialLine,
+        publishOriginLine,
+        ...detectionLines,
+        `    ${dim('contradiction override rate:')} ${overrideRateText}`,
+    ];
+}
+export function formatScoreboard(view) {
+    const { diagnosis, payload } = view;
+    const when = new Date(payload.generatedAt).toISOString();
+    const out = [];
+    out.push(bold('Flywheel scoreboard') + dim(`  (workspace ${payload.workspaceId} · ${when})`));
+    out.push('');
+    out.push(formatLine(diagnosis.m1));
+    out.push(formatLine(diagnosis.m2));
+    out.push(formatLine(diagnosis.m3));
+    out.push(formatLine(diagnosis.m4));
+    out.push(formatLine(diagnosis.m5));
+    out.push('');
+    out.push(formatLine(diagnosis.moat));
+    // coherence-run-sweep fix (PR #422 post-merge thread, Codex P2, "Handle scoreboards
+    // from older deployments"): `payload.coherence`'s type is compile-time only —
+    // `kernelCall`'s generic doesn't verify the RUNTIME shape a deployment predating this
+    // field actually returns. Rendering unconditionally threw for the default pretty path
+    // (only `--json` avoided it); skip the panel instead of crashing `pb scoreboard`.
+    if (payload.coherence) {
+        out.push('');
+        out.push(...formatCoherence(payload.coherence));
+    }
+    return out.join('\n');
+}
+//# sourceMappingURL=scoreboard.js.map

package/dist/formatters/scoreboard.js.map

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

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

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

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

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

package/dist/formatters/scoreboard.test.js

@@ -0,0 +1,303 @@
+/**
+ * WP-499 Slice B (TEN-2743, §2.5) — formatScoreboard's new coherence section.
+ * DEC-1282: no thresholds baked in — the coherence panel renders raw values, never a second
+ * diagnosis tile (diagnose() never touches payload.coherence — confirmed by not passing through it).
+ */
+import { describe, expect, it } from 'vitest';
+import { formatScoreboard } from './scoreboard.js';
+import { diagnose } from '../scoreboard/diagnose.js';
+function basePayload(coherence) {
+    return {
+        workspaceId: 'ws-1',
+        generatedAt: 1_800_000_000_000,
+        m1: { mix: { audited: 0, draft: 0, noDomain: 0, total: 0 }, noDomainShare: null, auditedShare: null, draftShare: null, windowMs: 1, servedRowCount: 0 },
+        m2: { divergentBuckets: 0, fullParity: true, task: null },
+        m3: { capturedCount: 0, everRatifiedCount: 0, inSessionRatifiedCount: 0, everRatifiedRate: null, inSessionRatifiedRate: null, sessionWindow: 20, sessionsConsidered: 0 },
+        m4: {
+            reworkJoinWindowMs: 1, lookbackWindowMs: 1, now: 1, servedCount: 0, unattributableServedCount: 0,
+            pendingObservationCount: 0, decidedCount: 0, firstTimeGoodCount: 0, reworkedCount: 0, firstTimeGoodShare: null,
+            signalCount: 0, joinedSignalCount: 0, unjoinedSignalCount: 0, falseAttributionRate: null,
+            byClassification: { revision: 0, ci_review_correction: 0, user_override: 0 },
+            ciReviewCorrectionAttribution: { attributable: 0, notAttributable: 0, unspecified: 0 },
+            cohort: { workspaceId: 'ws-1', taskProvidedCount: 0, taskAbsentCount: 0 },
+        },
+        materialization: { latestMaterializedAt: null, materializationAgeMs: null, now: 1 },
+        coherence,
+    };
+}
+const localDrift = { localProjectionMtime: null, serverMaterializedAt: null, localLagMs: null, localAgeMs: null };
+/** Default coherence fixture — override only the fields a test cares about. */
+function coherence(overrides = {}) {
+    return {
+        openConflictCount: 0,
+        openConflictsTruncated: false,
+        reviewed: 0,
+        real: 0,
+        falseAlarm: 0,
+        reviewedTruncated: false,
+        humanBar: { meets: false, lowerBound: null, reviewed: 0 },
+        precision: null,
+        openUnverdicted: 0,
+        verdictedOpenCount: 0,
+        snoozedCount: 0,
+        totalOpen: 0,
+        totalOpenAlarm: false,
+        dial: { br170Graduated: false, br170GraduatedPinned: false, coherencyMode: 'light' },
+        detectionCoverage: { bySurface: {}, scanned: 0, truncated: false },
+        contradictionOverrideRate: { overrides: 0, heldBlocks: 0, rate: null, truncated: false },
+        ...overrides,
+    };
+}
+function view(c) {
+    const payload = basePayload(c);
+    return { payload, localDrift, diagnosis: diagnose(payload, localDrift) };
+}
+describe('formatScoreboard coherence section (TEN-2743, §2.5)', () => {
+    it('renders openConflictCount, reviewed/real/falseAlarm, and humanBar exactly as the payload carries them — no recomputed Wilson math', () => {
+        const output = formatScoreboard(view(coherence({
+            openConflictCount: 3,
+            reviewed: 2,
+            real: 1,
+            falseAlarm: 1,
+            humanBar: { meets: false, lowerBound: 0.05, reviewed: 2 },
+        })));
+        // PR #422 review (Copilot): assert the specific line, not a bare digit substring — the
+        // ISO timestamp header and other metric readings can also contain "3".
+        expect(output).toContain('open conflicts: 3');
+        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');
+    });
+    it('renders "no enforcement events yet" when contradictionOverrideRate.rate is null — never "0%", never blank', () => {
+        const output = formatScoreboard(view(coherence()));
+        expect(output).toContain('no enforcement events yet');
+        expect(output).not.toContain('0%');
+    });
+    it('renders a percentage when contradictionOverrideRate.rate is non-null', () => {
+        const output = formatScoreboard(view(coherence({
+            contradictionOverrideRate: { overrides: 3, heldBlocks: 1, rate: 0.75, truncated: false },
+        })));
+        expect(output).toContain('75%');
+        expect(output).not.toContain('no enforcement events yet');
+    });
+    it('renders an honest "rate unavailable" message — never a percentage — when the scan was capped (PR #422 review round 2, Codex: independently-capped partitions bias a naive ratio, so the server now returns rate:null whenever truncated is true)', () => {
+        const output = formatScoreboard(view(coherence({
+            contradictionOverrideRate: { overrides: 500, heldBlocks: 0, rate: null, truncated: true },
+        })));
+        const overrideLine = output.split('\n').find((l) => l.includes('contradiction override rate'));
+        expect(overrideLine).not.toMatch(/\d+%/);
+        expect(overrideLine).not.toContain('no enforcement events yet');
+        expect(overrideLine).toMatch(/scan cap|too many events|unavailable/i);
+    });
+    it('renders the detectionCoverage panel — bySurface breakdown and scanned count (PR #422 review, Codex — was assembled but never rendered)', () => {
+        const output = formatScoreboard(view(coherence({
+            detectionCoverage: {
+                bySurface: { publish: { checked_clear: 2, checked_conflicts: 1, partial: 0, unavailable: 0 } },
+                scanned: 3,
+                truncated: false,
+            },
+        })));
+        expect(output).toContain('detection coverage');
+        expect(output).toContain('publish');
+        expect(output).toContain('checked_clear=2');
+        expect(output).toContain('checked_conflicts=1');
+    });
+    it('renders an honest empty state when detectionCoverage has no surfaces yet', () => {
+        const output = formatScoreboard(view(coherence()));
+        expect(output).toContain('detection coverage');
+        expect(output).toMatch(/no detection events yet/i);
+    });
+    it('renders a truncation qualifier on the detection coverage line when the scan was capped', () => {
+        const output = formatScoreboard(view(coherence({
+            detectionCoverage: { bySurface: { publish: { checked_clear: 1, checked_conflicts: 0, partial: 0, unavailable: 0 } }, scanned: 5000, truncated: true },
+        })));
+        const coverageLine = output.split('\n').find((l) => l.includes('detection coverage'));
+        expect(coverageLine).toMatch(/sampled|truncat/i);
+    });
+    it('renders a truncation qualifier on verdicts AND humanBar when reviewedTruncated is true — a misleading meets must never render unqualified (PR #422 review, Codex)', () => {
+        const output = formatScoreboard(view(coherence({
+            reviewed: 1000, real: 950, falseAlarm: 50, reviewedTruncated: true,
+            humanBar: { meets: true, lowerBound: 0.94, reviewed: 1000 },
+        })));
+        const verdictsLine = output.split('\n').find((l) => l.includes('verdicts:'));
+        const humanBarLine = output.split('\n').find((l) => l.includes('humanBar:'));
+        expect(verdictsLine).toMatch(/sampled|truncat/i);
+        expect(humanBarLine).toMatch(/sampled|truncat/i);
+    });
+    it('renders no truncation qualifiers when every underlying scan was complete', () => {
+        const output = formatScoreboard(view(coherence({ reviewed: 2, real: 1, falseAlarm: 1 })));
+        const verdictsLine = output.split('\n').find((l) => l.includes('verdicts:'));
+        const humanBarLine = output.split('\n').find((l) => l.includes('humanBar:'));
+        expect(verdictsLine).not.toMatch(/sampled|truncat/i);
+        expect(humanBarLine).not.toMatch(/sampled|truncat/i);
+    });
+    // coherence-run-sweep fix (PR #422 post-merge thread, Codex P2, "Handle scoreboards from
+    // older deployments"): `payload.coherence`'s type is compile-time only — a deployment
+    // predating this field returns a payload that genuinely lacks it at runtime (kernelCall's
+    // generic never verifies the wire shape). The pretty path must degrade, not throw.
+    it('does not throw when payload.coherence is absent (older deployment) and simply omits the panel', () => {
+        const payload = basePayload(coherence());
+        delete payload.coherence;
+        const v = { payload, localDrift, diagnosis: diagnose(payload, localDrift) };
+        let output = '';
+        expect(() => {
+            output = formatScoreboard(v);
+        }).not.toThrow();
+        expect(output).not.toContain('COHERENCE');
+    });
+    // C2 (WP-468/FEAT-1407, point 8) — the new queue/precision/dial fields.
+    it('renders precision as an explicit "n/a (N=0)" when nothing has been verdicted, never a blank/misleading number', () => {
+        const output = formatScoreboard(view(coherence({ reviewed: 0, precision: null })));
+        const precisionLine = output.split('\n').find((l) => l.includes('precision:'));
+        expect(precisionLine).toContain('n/a (N=0)');
+    });
+    // Review fix (PR #528 P1): precision is the OBSERVED ratio (real/reviewed) — a DIFFERENT
+    // number from humanBar.lowerBound (the Wilson confidence bound on that same ratio). A
+    // 1-real/0-falseAlarm cohort must read precision 1.000 even though its lowerBound is well
+    // below 1 — conflating the two mislabels the statistic on every non-empty cohort.
+    it('renders the OBSERVED precision, distinct from the Wilson lowerBound, for a small all-real cohort', () => {
+        const output = formatScoreboard(view(coherence({
+            reviewed: 1, real: 1, falseAlarm: 0, precision: 1,
+            humanBar: { meets: false, lowerBound: 0.206, reviewed: 1 },
+        })));
+        const precisionLine = output.split('\n').find((l) => l.includes('precision:'));
+        const humanBarLine = output.split('\n').find((l) => l.includes('humanBar:'));
+        expect(precisionLine).toContain('1.000');
+        expect(humanBarLine).toContain('0.206');
+        expect(precisionLine).not.toContain('0.206');
+    });
+    // Review fix (PR #528 round 2, P2): when the verdict-cohort scan truncated, precision is
+    // only the ratio within the SAMPLED rows, not the full population — the same honesty rule
+    // already applied to the counts/humanBar lines (verdictsSuffix) must also cover this line.
+    it('renders precision with a truncation qualifier when reviewedTruncated is true', () => {
+        const output = formatScoreboard(view(coherence({
+            reviewed: 1300, real: 1300, falseAlarm: 0, precision: 1, reviewedTruncated: true,
+            humanBar: { meets: true, lowerBound: 0.99, reviewed: 1300 },
+        })));
+        const precisionLine = output.split('\n').find((l) => l.includes('precision:'));
+        expect(precisionLine).toContain('1.000');
+        expect(precisionLine).toContain('sampled — scan cap reached');
+    });
+    // Review fix (PR #528 P7 / older-deployment defaults): `payload.coherence` can be PRESENT
+    // (passing the outer `if (payload.coherence)` guard) while predating every C2 field —
+    // `c.dial.coherencyMode` must never throw unguarded.
+    it('renders "n/a (older deployment)" for precision/queue/total-open/dial when those C2 fields are entirely absent, never throws', () => {
+        const olderDeploymentCoherence = coherence();
+        delete olderDeploymentCoherence.precision;
+        delete olderDeploymentCoherence.openUnverdicted;
+        delete olderDeploymentCoherence.verdictedOpenCount;
+        delete olderDeploymentCoherence.snoozedCount;
+        delete olderDeploymentCoherence.totalOpen;
+        delete olderDeploymentCoherence.totalOpenAlarm;
+        delete olderDeploymentCoherence.dial;
+        let output = '';
+        expect(() => {
+            output = formatScoreboard(view(olderDeploymentCoherence));
+        }).not.toThrow();
+        expect(output.split('\n').find((l) => l.includes('precision:'))).toContain('n/a (older deployment)');
+        expect(output.split('\n').find((l) => l.includes('queue:'))).toContain('n/a (older deployment)');
+        expect(output.split('\n').find((l) => l.includes('total open:'))).toContain('n/a (older deployment)');
+        expect(output.split('\n').find((l) => l.includes('dial:'))).toContain('n/a (older deployment)');
+    });
+    it('renders the actionable/verdicted-open/snoozed queue counts', () => {
+        const output = formatScoreboard(view(coherence({
+            openUnverdicted: 3, verdictedOpenCount: 2, snoozedCount: 1,
+        })));
+        const queueLine = output.split('\n').find((l) => l.includes('queue:'));
+        expect(queueLine).toContain('actionable 3');
+        expect(queueLine).toContain('verdicted-open 2');
+        expect(queueLine).toContain('snoozed 1');
+    });
+    // Review fix (PR #528 P1): every one of these queue sub-counts is itself a capped-sample
+    // count — a truncation flag must render a qualifier, never present as an exact number.
+    it('renders a truncation qualifier on each queue sub-count independently', () => {
+        const output = formatScoreboard(view(coherence({
+            openUnverdicted: 200, openUnverdictedTruncated: true,
+            verdictedOpenCount: 5000, verdictedOpenTruncated: true,
+            snoozedCount: 200, snoozedCountTruncated: true,
+        })));
+        const queueLine = output.split('\n').find((l) => l.includes('queue:'));
+        expect(queueLine).toMatch(/actionable 200.*sampled/);
+        expect(queueLine).toMatch(/verdicted-open 5000.*sampled/);
+        expect(queueLine).toMatch(/snoozed 200.*sampled/);
+    });
+    // Review fix (PR #539, Codex P2, "qualify truncated snoozed-unverdicted counts"):
+    // snoozedUnverdicted is derived from the SAME sample as openUnverdicted (one fetch, two
+    // filters, healSweepRuns.ts) — it must inherit openUnverdicted's OWN truncation qualifier,
+    // never render as an exact number when that shared sample was capped.
+    it('qualifies snoozed-unverdicted as sampled when the shared openUnverdicted sample was truncated', () => {
+        const output = formatScoreboard(view(coherence({
+            openUnverdicted: 200, openUnverdictedTruncated: true, snoozedUnverdicted: 15,
+        })));
+        const queueLine = output.split('\n').find((l) => l.includes('queue:'));
+        expect(queueLine).toMatch(/snoozed-unverdicted 15.*sampled/);
+    });
+    it('renders snoozed-unverdicted as an exact number when the sample was NOT truncated', () => {
+        const output = formatScoreboard(view(coherence({
+            openUnverdicted: 3, openUnverdictedTruncated: false, snoozedUnverdicted: 1,
+        })));
+        const queueLine = output.split('\n').find((l) => l.includes('queue:'));
+        expect(queueLine).toContain('snoozed-unverdicted 1');
+        expect(queueLine).not.toMatch(/snoozed-unverdicted 1.*sampled/);
+    });
+    it('renders totalOpen with a loud alarm suffix once totalOpenAlarm is true', () => {
+        // Note: /alarm/i alone would false-match the pre-existing "falseAlarm" verdict-count field
+        // name — assert on the specific "total open" LINE, not the whole payload.
+        const quiet = formatScoreboard(view(coherence({ totalOpen: 12, totalOpenAlarm: false })));
+        const quietLine = quiet.split('\n').find((l) => l.includes('total open:'));
+        expect(quietLine).toContain('total open: 12');
+        expect(quietLine).not.toMatch(/ALARM/);
+        const loud = formatScoreboard(view(coherence({ totalOpen: 151, totalOpenAlarm: true })));
+        const loudLine = loud.split('\n').find((l) => l.includes('total open:'));
+        expect(loudLine).toContain('total open: 151');
+        expect(loudLine).toMatch(/ALARM/);
+    });
+    // Review fix (PR #528 round 2, P2): totalOpen previously rendered an exact-looking number
+    // with no truncation signal, even though it is countOpenConflictIssues' own 200-row-capped
+    // count — the SAME honesty rule already applied to every other capped count in this panel.
+    it('renders totalOpen with a truncation qualifier when totalOpenTruncated is true', () => {
+        const output = formatScoreboard(view(coherence({ totalOpen: 200, totalOpenTruncated: true })));
+        const totalOpenLine = output.split('\n').find((l) => l.includes('total open:'));
+        expect(totalOpenLine).toContain('total open: 200');
+        expect(totalOpenLine).toContain('sampled — scan cap reached');
+    });
+    it('renders totalOpen with NO truncation qualifier when totalOpenTruncated is false', () => {
+        const output = formatScoreboard(view(coherence({ totalOpen: 12, totalOpenTruncated: false })));
+        const totalOpenLine = output.split('\n').find((l) => l.includes('total open:'));
+        expect(totalOpenLine).not.toContain('sampled');
+    });
+    it('renders the dial state — mode, br170Graduated, br170GraduatedPinned (scope-doc F10)', () => {
+        const output = formatScoreboard(view(coherence({
+            dial: { br170Graduated: true, br170GraduatedPinned: true, coherencyMode: 'strict' },
+        })));
+        const dialLine = output.split('\n').find((l) => l.includes('dial:'));
+        expect(dialLine).toContain('mode=strict');
+        expect(dialLine).toContain('br170Graduated=true');
+        expect(dialLine).toContain('br170GraduatedPinned=true');
+    });
+    // C1 (WP-468/FEAT-1408): the at-cap disclosure — never telemetry-only.
+    it('renders the publish-origin count and cap disclosure', () => {
+        const output = formatScoreboard(view(coherence({
+            publishOriginOpen: 3, publishOriginAtCap: false, publishOriginTruncated: false,
+        })));
+        const line = output.split('\n').find((l) => l.includes('publish-origin:'));
+        expect(line).toContain('publish-origin: 3/10');
+        expect(line).not.toMatch(/AT CAP/);
+    });
+    it('renders an AT CAP warning when publishOriginAtCap is true', () => {
+        const output = formatScoreboard(view(coherence({
+            publishOriginOpen: 10, publishOriginAtCap: true, publishOriginTruncated: false,
+        })));
+        const line = output.split('\n').find((l) => l.includes('publish-origin:'));
+        expect(line).toContain('publish-origin: 10/10');
+        expect(line).toMatch(/AT CAP/);
+    });
+    it('renders "n/a (older deployment)" for publish-origin when the field is absent', () => {
+        const output = formatScoreboard(view(coherence()));
+        const line = output.split('\n').find((l) => l.includes('publish-origin:'));
+        expect(line).toContain('n/a (older deployment)');
+    });
+});
+//# sourceMappingURL=scoreboard.test.js.map