@productbrain/cli 0.1.0-beta.973 → 0.1.0-beta.9756

package/dist/formatters/digest.test.js

@@ -0,0 +1,166 @@
+/**
+ * TASK-130 (WP-702) — `pb digest` formatter tests. PR #1122 round 1 review (P1): every
+ * model-derived field must be sanitized before pretty-render, and the empty-cohort message
+ * must not claim "no pending drafts" when the scan was capped before it could know that.
+ */
+import { describe, expect, it } from 'vitest';
+import { formatDigest } from './digest.js';
+function makeResult(overrides = {}) {
+    return {
+        themes: [],
+        totalPending: 0,
+        composedEntryCount: 0,
+        themeCount: 0,
+        scanCapped: false,
+        composeCapped: false,
+        droppedInventedIds: 0,
+        missingIds: 0,
+        duplicateIds: 0,
+        truncatedBodies: 0,
+        foreignCollectionRows: 0,
+        model: 'anthropic/claude-sonnet-5',
+        llmOutcome: 'live',
+        tokensUsed: 0,
+        costCredits: 0,
+        ...overrides,
+    };
+}
+describe('formatDigest', () => {
+    it('sanitizes an ANSI escape sequence out of a theme title before rendering', () => {
+        const result = makeResult({
+            composedEntryCount: 1,
+            themeCount: 1,
+            themes: [
+                {
+                    title: '\x1b[31mRed alert\x1b[0m',
+                    narrative: 'Still true.',
+                    founderDecisions: [],
+                    agentFixes: [{ entryId: 'TEN-1', note: 'Fine.' }],
+                },
+            ],
+        });
+        const out = formatDigest(result, '7d');
+        expect(out).not.toContain('\x1b[31m');
+        expect(out).toContain('Red alert');
+    });
+    it('collapses an embedded newline in a narrative/note so it cannot forge an extra terminal line', () => {
+        const result = makeResult({
+            composedEntryCount: 1,
+            themeCount: 1,
+            themes: [
+                {
+                    title: 'Theme A',
+                    narrative: 'Line one\nFAKE: this looks like a new digest section',
+                    founderDecisions: [{ entryId: 'TEN-1', note: 'A note\nwith an embedded newline.' }],
+                    agentFixes: [],
+                },
+            ],
+        });
+        const out = formatDigest(result, '7d');
+        const lines = out.split('\n');
+        // The narrative and the note must each render as exactly ONE line — the embedded \n was
+        // collapsed to a space, not rendered as a real newline the terminal would treat as a new
+        // line (which could otherwise forge a fake extra section).
+        expect(lines.some((l) => l.includes('Line one FAKE: this looks like a new digest section'))).toBe(true);
+        expect(lines.some((l) => l.includes('A note with an embedded newline.'))).toBe(true);
+        expect(out).not.toContain('Line one\nFAKE');
+    });
+    it('sanitizes entryId too, defensively', () => {
+        const result = makeResult({
+            composedEntryCount: 1,
+            themeCount: 1,
+            themes: [
+                {
+                    title: 'Theme A',
+                    narrative: 'Still true.',
+                    founderDecisions: [],
+                    agentFixes: [{ entryId: 'TEN-1\x1b[31m', note: 'Fine.' }],
+                },
+            ],
+        });
+        const out = formatDigest(result, '7d');
+        expect(out).not.toContain('\x1b[31m');
+    });
+    it('reports the honest "no pending drafts" line when the scan was NOT capped', () => {
+        const out = formatDigest(makeResult({ scanCapped: false }), '7d');
+        expect(out).toContain('No pending drafts found since 7d.');
+    });
+    it('prints a scan-cap warning instead of the definitive "no pending drafts" line when composedEntryCount is 0 but scanCapped is true', () => {
+        const out = formatDigest(makeResult({ scanCapped: true }), '7d');
+        expect(out).not.toContain('No pending drafts found');
+        expect(out).toContain('scan CAPPED');
+    });
+    it('prints a truncated-bodies warning line when truncatedBodies > 0', () => {
+        const result = makeResult({
+            composedEntryCount: 1,
+            themeCount: 1,
+            truncatedBodies: 2,
+            themes: [{ title: 'Theme A', narrative: 'Still true.', founderDecisions: [], agentFixes: [{ entryId: 'TEN-1', note: 'Fine.' }] }],
+        });
+        const out = formatDigest(result, '7d');
+        expect(out).toContain('2 capture(s) had truncated body text');
+    });
+    it('omits the truncated-bodies line when truncatedBodies is 0', () => {
+        const result = makeResult({
+            composedEntryCount: 1,
+            themeCount: 1,
+            themes: [{ title: 'Theme A', narrative: 'Still true.', founderDecisions: [], agentFixes: [{ entryId: 'TEN-1', note: 'Fine.' }] }],
+        });
+        const out = formatDigest(result, '7d');
+        expect(out).not.toContain('truncated body text');
+    });
+    it('still renders themes for a live-incomplete-coverage outcome, with the coverage-gap lines', () => {
+        const result = makeResult({
+            composedEntryCount: 2,
+            themeCount: 1,
+            llmOutcome: 'live-incomplete-coverage',
+            missingIds: 1,
+            duplicateIds: 1,
+            themes: [{ title: 'Theme A', narrative: 'Still true.', founderDecisions: [], agentFixes: [{ entryId: 'TEN-1', note: 'Fine.' }] }],
+        });
+        const out = formatDigest(result, '7d');
+        expect(out).toContain('Theme A');
+        expect(out).toContain('never cited by the model');
+        expect(out).toContain('Dropped 1 duplicate citation');
+    });
+    it('stops before rendering themes for a non-live outcome', () => {
+        const result = makeResult({ composedEntryCount: 1, llmOutcome: 'failed-timeout' });
+        const out = formatDigest(result, '7d');
+        expect(out).toContain('Composer did not produce a live brief');
+    });
+    it('prints a foreignCollectionRows warning line when it is > 0 (TASK-131, WP-702)', () => {
+        const result = makeResult({
+            composedEntryCount: 1,
+            themeCount: 1,
+            foreignCollectionRows: 2,
+            themes: [{ title: 'Theme A', narrative: 'Still true.', founderDecisions: [], agentFixes: [{ entryId: 'TEN-1', note: 'Fine.' }] }],
+        });
+        const out = formatDigest(result, '7d');
+        expect(out).toContain('2 pending draft(s) were dropped from this digest');
+    });
+    it('omits the foreignCollectionRows line when it is 0', () => {
+        const result = makeResult({
+            composedEntryCount: 1,
+            themeCount: 1,
+            themes: [{ title: 'Theme A', narrative: 'Still true.', founderDecisions: [], agentFixes: [{ entryId: 'TEN-1', note: 'Fine.' }] }],
+        });
+        const out = formatDigest(result, '7d');
+        expect(out).not.toContain('dropped from this digest');
+    });
+    it('prints the foreignCollectionRows warning even in the empty-cohort branch — "no pending drafts" is never the whole story when rows were dropped (TASK-131, WP-702)', () => {
+        const out = formatDigest(makeResult({ scanCapped: false, foreignCollectionRows: 1 }), '7d');
+        expect(out).toContain('1 pending draft(s) were dropped from this digest');
+        expect(out).toContain('Nothing else was found in this window (since 7d).');
+    });
+    it('never says "No pending drafts found" when foreignCollectionRows > 0 and the cohort is otherwise empty (Codex round 1, PRRT_kwDORS4ils6l1rMW)', () => {
+        const out = formatDigest(makeResult({ scanCapped: false, foreignCollectionRows: 3 }), '7d');
+        expect(out).not.toContain('No pending drafts found');
+    });
+    it('still prefers the scan-capped line over the foreignCollectionRows "nothing else" line when both are true', () => {
+        const out = formatDigest(makeResult({ scanCapped: true, foreignCollectionRows: 1 }), '7d');
+        expect(out).toContain('scan CAPPED');
+        expect(out).not.toContain('Nothing else was found');
+        expect(out).not.toContain('No pending drafts found');
+    });
+});
+//# sourceMappingURL=digest.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"digest.test.js","sourceRoot":"","sources":["../../src/formatters/digest.test.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":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAA+B,MAAM,gBAAgB,CAAC;AAElF,MAAM,GAAG,GAAG,iBAAiB,CAAC;AAE9B,SAAS,UAAU,CAAC,YAAuD,EAAE;IAC3E,OAAO;QACL,OAAO,EAAE,EAAE,EAAE,iBAAiB,EAAE,CAAC,EAAE,mBAAmB,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE;QAC7F,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,YAA6C,EAAE;IAC/D,OAAO;QACL,UAAU,EAAE,GAAG;QACf,MAAM,EAAE,UAAU,EAAE;QACpB,MAAM,EAAE,EAAE;QACV,UAAU,EAAE,GAAG,GAAG,IAAI;QACtB,cAAc,EAAE,UAAU,EAAE;QAC5B,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,oFAAoF,EAAE,GAAG,EAAE;QAC5F,MAAM,MAAM,GAAG,mBAAmB,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACjG,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,6EAA6E,CAAC,CAAC;IAC1G,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4HAA4H,EAAE,GAAG,EAAE;QACpI,mFAAmF;QACnF,0FAA0F;QAC1F,sEAAsE;QACtE,MAAM,MAAM,GAAG,mBAAmB,CAAC,QAAQ,CAAC;YAC1C,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,mBAAmB,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;SACtE,CAAC,CAAC,CAAC;QACJ,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,8CAA8C,CAAC,CAAC;QAC7E,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,sEAAsE,CAAC,CAAC;IACnG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0EAA0E,EAAE,GAAG,EAAE;QAClF,MAAM,MAAM,GAAG,mBAAmB,CAAC,QAAQ,CAAC;YAC1C,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,mBAAmB,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;SACtE,CAAC,CAAC,CAAC;QACJ,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,qEAAqE,CAAC,CAAC;IAClG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4EAA4E,EAAE,GAAG,EAAE;QACpF,MAAM,MAAM,GAAG,mBAAmB,CAAC,QAAQ,CAAC;YAC1C,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;YAC3D,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC7C,OAAO,EAAE,MAAM,CAAC,EAAE;gBAClB,IAAI,EAAE,OAAO,CAAC,EAAE;gBAChB,KAAK,EAAE,QAAiB;gBACxB,SAAS,EAAE,GAAG,GAAG,CAAC;gBAClB,sBAAsB,EAAE,EAAE;aAC3B,CAAC,CAAC;YACH,eAAe,EAAE,IAAI;YACrB,qBAAqB,EAAE,GAAG;SAC3B,CAAC,CAAC,CAAC;QACJ,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;QAC9C,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,4DAA4D,CAAC,CAAC;QAC3F,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,qFAAqF,CAAC,CAAC;IAClH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0FAA0F,EAAE,GAAG,EAAE;QAClG,MAAM,MAAM,GAAG,mBAAmB,CAAC,QAAQ,CAAC;YAC1C,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;YAClD,gBAAgB,EAAE,IAAI;SACvB,CAAC,CAAC,CAAC;QACJ,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,0DAA0D,CAAC,CAAC;IACvF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;QAC7E,MAAM,MAAM,GAAG,mBAAmB,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACjG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,2BAA2B,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/formatters/entry.d.ts

@@ -1,19 +1,33 @@
+import type { WhyQuality } from '@productbrain/kernel-client';
+import { type OwnerLine } from '../lib/ownerLine.js';
 export interface EntryRelation {
     direction: string;
     type: string;
     otherEntryId?: string | null;
     otherName?: string | null;
+    otherStatus?: string | null;
 }
 export interface EntryHistoryEvent {
     timestamp: number;
     event: string;
     changedBy?: string;
     note?: string;
+    /**
+     * WP-D (attestation spec §7.2): server-derived honest qualifier on legacy 'verified'
+     * rows. The ledger note may carry a false attribution — this renders beside it.
+     * Optional — old server omits it (spec §11 rollout rule). Shipped rendered; the
+     * published CLI never re-derives (spec §5).
+     */
+    legacyQualifier?: string;
 }
 export interface EntryFromApi {
     entryId?: string | null;
     name: string;
     canonicalKey?: string | null;
+    /** WP-771 S1b: the real collection slug — what `[...]` in `pb get`'s first line shows.
+     *  `canonicalKey` is the semantic type, not the collection; `pb search`'s formatter
+     *  (formatters/search.ts) got this right from the start, this formatter didn't. */
+    collectionSlug?: string | null;
     status: string;
     workflowStatus?: string;
     /** BET-240 S0: Entry provenance — human, agent, or external. */
@@ -22,6 +36,13 @@ export interface EntryFromApi {
     originDetail?: string;
     /** BET-240 E1: Trust signal — 'unverified' or 'verified'. */
     verificationStatus?: 'unverified' | 'verified';
+    /** WP-A T7/T8: server-shipped honest label. Optional — old server omits it (spec §11). */
+    verifiedBy?: string;
+    /** WP-A T7/T8: server-shipped attestation strength/basis. Optional — old server omits it (spec §11). */
+    attestation?: {
+        strength: string;
+        basis?: string;
+    };
     /** BET-240 E2: URI or path of the source document. */
     sourceRef?: string;
     /** BET-240 E2: Verbatim excerpt from the source. */
@@ -45,7 +66,7 @@ export interface EntryFromApi {
      * 'rationale' = a real rationale; 'restated' = rationale merely echoes the name;
      * 'missing' = no rationale captured. Drives a self-announcing Why line.
      */
-    whyQuality?: 'rationale' | 'missing' | 'restated';
+    whyQuality?: WhyQuality;
     /**
      * Kernel-resolved WHY-source field for this entry's collection (Codex finding,
      * TEN-2191). 'rationale' for standard governance collections; 'description' for
@@ -54,7 +75,26 @@ export interface EntryFromApi {
      * twice alongside the Why line. When absent (older kernels), falls back to
      * rationale-detection based on entry.why / data.rationale equality.
      */
-    whyField?: 'rationale' | 'description';
+    whyField?: 'why' | 'rationale' | 'description';
+    /**
+     * FEAT-1334 / DEC-1296 / DEC-1297: read-time "possible conflict" advisory marker. Present when
+     * the heal sweep has an OPEN conflictIssues row touching this entry. Advisory only — never a gate
+     * on the entry. Rendered as a prominent line so TTY readers (`pb get`) see it, not just `--json`.
+     */
+    possibleConflict?: {
+        kind: string;
+        label: string;
+    };
+    /**
+     * WP-745 slice 3 PR A: who owns this record, from `entryAuthorityOwnerships` —
+     * absent for a question and a domain. A role or a team reads `placed`:
+     * where it lives, `Home: <team>` (DEC-1944), or nothing for the root team. TEN-3909: objective | key_result | tension used to be absent here too, but
+     * WP-753 O3 moved their real ownership onto this same row (DEC-1719) — they show through it
+     * like any other working record now. `OwnerLine` (WP-753 O5b fix round 1, item 2) is kernel's
+     * ONE structural type for this, shared by MCP and the browser Rail — no local copy of the
+     * discriminated union here anymore.
+     */
+    owner?: OwnerLine;
 }
 /** Format full entry for terminal output — data fields, relations (with type labels), last 10 history events. */
 export declare function formatEntry(entry: EntryFromApi): string;

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

@@ -1 +1 @@
-{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../../src/formatters/entry.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;IACxC,kFAAkF;IAClF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,kBAAkB,CAAC,EAAE,YAAY,GAAG,UAAU,CAAC;IAC/C,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC;IAC5B,OAAO,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC9B,8EAA8E;IAC9E,UAAU,CAAC,EAAE,eAAe,GAAG,aAAa,GAAG,OAAO,CAAC;IACvD,sFAAsF;IACtF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wGAAwG;IACxG,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,UAAU,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,UAAU,CAAC;IAClD;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,WAAW,GAAG,aAAa,CAAC;CACxC;AAUD,iHAAiH;AACjH,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAwGvD"}
+{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../../src/formatters/entry.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAA4C,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAE/F,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B;;uFAEmF;IACnF,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;IACxC,kFAAkF;IAClF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,kBAAkB,CAAC,EAAE,YAAY,GAAG,UAAU,CAAC;IAC/C,0FAA0F;IAC1F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wGAAwG;IACxG,WAAW,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC;IAC5B,OAAO,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC9B,8EAA8E;IAC9E,UAAU,CAAC,EAAE,eAAe,GAAG,aAAa,GAAG,OAAO,CAAC;IACvD,sFAAsF;IACtF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wGAAwG;IACxG,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,KAAK,GAAG,WAAW,GAAG,aAAa,CAAC;IAC/C;;;;OAIG;IACH,gBAAgB,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AA6BD,iHAAiH;AACjH,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAoIvD"}

package/dist/formatters/entry.js

@@ -2,8 +2,27 @@
  * Entry formatter — full entry display with data, relations, and history.
  * Chain: DEC-186 (CLI uses Convex view model with CLI-native formatting).
  */
-import { stripControlChars } from '../lib/strip.js';
+import { stripControlChars, sanitizeSingleLineField } from '../lib/strip.js';
 import { provenanceMark } from './orient.js';
+import { formatOwnerLine as kernelFormatOwnerLine } from '../lib/ownerLine.js'; // WP-753 O5b fix round 2 (item 1): GENERATED copy of kernel/organisationalAuthority/ownerLine.ts — a runtime `kernel/...` import is forbidden for this connector (packages/mcp-server/tsconfig.json:14-22)
+// Review round 2: a team/role name is user-editable, so an embedded newline must never inject
+// an extra, unprefixed terminal line (spoofing e.g. a second "Status:" line) — the OUTER
+// stripControlChars call on the composed line preserves newlines by design (legitimate for
+// multiline text elsewhere), so each name is sanitized to one line here, BEFORE handing the
+// owner to kernel's formatOwnerLine (WP-753 O5b fix round 1, item 2) — kernel is pure and does
+// no surface-specific sanitization; CLI/MCP keep ids (ids: true, the default) for repair commands.
+function formatOwnerLine(owner) {
+    const sanitized = owner.kind === 'one'
+        ? { ...owner, team: { name: sanitizeSingleLineField(owner.team.name) }, role: { name: sanitizeSingleLineField(owner.role.name) } }
+        : owner.kind === 'dangling'
+            // WP-753 O5b fix round 3 (item 6): team/role nested to match the `one` kind.
+            ? { ...owner, ...(owner.team ? { team: { name: sanitizeSingleLineField(owner.team.name) } } : {}), ...(owner.role ? { role: { name: sanitizeSingleLineField(owner.role.name) } } : {}) }
+            // DEC-1944 (TASK-614; WP-783): a role or a team names where it lives.
+            : owner.kind === 'placed'
+                ? { ...owner, team: { name: sanitizeSingleLineField(owner.team.name) } }
+                : owner;
+    return kernelFormatOwnerLine(sanitized);
+}
 function sanitizeData(data) {
     if (!data || typeof data !== 'object')
         return undefined;
@@ -16,16 +35,39 @@ export function formatEntry(entry) {
     const s = stripControlChars;
     const lines = [];
     const id = entry.entryId ?? '—';
-    const coll = entry.canonicalKey ?? '—';
-    lines.push(`${s(id)}  [${s(coll)}]  ${s(entry.name)}`);
+    // WP-771 S1b round 2 (Codex P2, PRRT_kwDORS4ils6lGWJs): this header renders as ONE terminal
+    // line, but stripControlChars deliberately keeps \x0a (strip.ts:41) — a collection slug with
+    // an embedded newline could still forge an extra line here. sanitizeSingleLineField (not `s`)
+    // for this field only, same treatment role.ts's collectionSlug fix used this round.
+    const coll = entry.collectionSlug ? sanitizeSingleLineField(entry.collectionSlug) : '—';
+    lines.push(`${s(id)}  [${coll}]  ${s(entry.name)}`);
     lines.push('');
     lines.push(`Status: ${s(entry.status)}${entry.workflowStatus ? ` / ${s(entry.workflowStatus)}` : ''}`);
+    // FEAT-1334 / DEC-1297: surface the advisory conflict marker prominently (honest "under review"
+    // wording — never asserts the entry is wrong).
+    if (entry.possibleConflict) {
+        lines.push(`⚠ ${s(entry.possibleConflict.label)}`);
+    }
     if (entry.origin) {
         const detail = entry.originDetail ? ` (${s(entry.originDetail)})` : '';
         lines.push(`Origin: ${s(entry.origin)}${detail}`);
     }
     if (entry.verificationStatus) {
-        lines.push(`Verification: ${s(entry.verificationStatus)}`);
+        // WP-A T8: honest qualifier when the server ships verifiedBy — connectors never re-derive
+        // (spec §5). Keep today's bare form when absent (old server, spec §11 rollout rule).
+        // Final-review Fix 1: a non-'attested' basis (the pre-branch legacy corpus, spec §7.1)
+        // must render the honest legacy qualifier instead of "— by X (strength)" — the shipped
+        // verifiedBy is already the resolved legacy string ("legacy — unclassified").
+        let who;
+        if (entry.attestation?.basis && entry.attestation.basis !== 'attested') {
+            who = entry.verifiedBy ? ` (${s(entry.verifiedBy)})` : '';
+        }
+        else {
+            who = entry.verifiedBy
+                ? ` — by ${s(entry.verifiedBy)}${entry.attestation ? ` (${s(entry.attestation.strength)})` : ''}`
+                : '';
+        }
+        lines.push(`Verification: ${s(entry.verificationStatus)}${who}`);
     }
     if (entry.sourceRef) {
         lines.push(`Source ref: ${s(entry.sourceRef)}`);
@@ -39,6 +81,9 @@ export function formatEntry(entry) {
         const anchorPart = entry.anchoredBy ? ` — anchoredBy ${s(entry.anchoredBy)}` : '';
         lines.push(`Authority: ${mark} ${s(entry.provenance)}${anchorPart}`);
     }
+    if (entry.owner) {
+        lines.push(s(formatOwnerLine(entry.owner)));
+    }
     // Phase 4 (BET-238 E5): surface rationale first-class when present and not already
     // surfaced via entry.data.rationale in the Data block below.
     // TEN-2191 (honesty patch): WHY is rationale-only and whyQuality announces its
@@ -63,7 +108,7 @@ export function formatEntry(entry) {
     let whySourceKey = null;
     if (entry.why) {
         const kf = entry.whyField;
-        if ((kf === 'rationale' || kf === 'description') && typeof d[kf] === 'string' && d[kf].trim().length > 0) {
+        if ((kf === 'why' || kf === 'rationale' || kf === 'description') && typeof d[kf] === 'string' && d[kf].trim().length > 0) {
             whySourceKey = kf;
         }
         else if (typeof d.rationale === 'string' && d.rationale.trim().length > 0) {
@@ -96,7 +141,7 @@ export function formatEntry(entry) {
         lines.push('Relations:');
         for (const r of entry.relations) {
             const arrow = r.direction === 'outgoing' ? '→' : '←';
-            const other = r.otherEntryId ? `${s(r.otherEntryId)}: ${s(r.otherName ?? '')}` : s(r.otherName ?? '—');
+            const other = (r.otherEntryId ? `${s(r.otherEntryId)}: ${s(r.otherName ?? '')}` : s(r.otherName ?? '—')) + ` [${s(r.otherStatus ?? 'status unknown')}]`;
             lines.push(`  ${arrow} ${s(r.type)} ${other}`);
         }
         lines.push('');
@@ -106,7 +151,10 @@ export function formatEntry(entry) {
         lines.push('History (last 10):');
         for (const h of last10) {
             const date = new Date(h.timestamp).toISOString().split('T')[0];
-            lines.push(`  ${date}: ${s(h.event)}${h.changedBy ? ` (${s(h.changedBy)})` : ''}${h.note ? ` — ${s(h.note)}` : ''}`);
+            // WP-D (spec §7.2): the qualifier renders beside a legacy verify event — the ledger
+            // sentence stays as written (append-only), the display stops lying.
+            const qualifier = h.legacyQualifier ? ` [${s(h.legacyQualifier)}]` : '';
+            lines.push(`  ${date}: ${s(h.event)}${h.changedBy ? ` (${s(h.changedBy)})` : ''}${h.note ? ` — ${s(h.note)}` : ''}${qualifier}`);
         }
     }
     return lines.join('\n');