@productbrain/cli 0.1.0-beta.99 → 0.1.0-beta.9904

package/dist/formatters/questions.d.ts

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

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

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

package/dist/formatters/questions.js

@@ -0,0 +1,116 @@
+import { stripControlChars } from '../lib/strip.js';
+/**
+ * Human-formatted rendering for `pb question <verb>` (WP-638 S3, §7.7 of the routed-questions
+ * design spec: docs/superpowers/specs/2026-08-10-routed-questions-design.md). One entry point
+ * per verb, mirrors formatters/shape.ts's shape — every field rendered as the deployed
+ * mutation actually returned it, no math here.
+ */
+function singleLine(value) {
+    return value ? stripControlChars(value).replace(/\s+/g, ' ').trim() : '';
+}
+/** TEN-3332 rider (WP-707 S1): the list column's QUESTION truncation used to be a hard
+ *  character-count slice with no word-boundary awareness and no ellipsis marker — a truncated
+ *  row was visually indistinguishable from a short question that just happened to fit. Trims
+ *  back to the last whitespace inside the limit and appends `…` only when the text actually
+ *  needed cutting.
+ *  WP-707 S1 round 2 (DEC-1622, ruling #10): `limit` is the CLI's column width, so the
+ *  returned string (including the appended `…`) must never exceed it — slicing to `limit`
+ *  before appending a 1-char ellipsis produced a `limit + 1`-char cell, one column over.
+ *  Reserve that 1 char up front instead. */
+function truncateWithEllipsis(value, limit) {
+    if (value.length <= limit)
+        return value;
+    const hardCap = value.slice(0, limit - 1);
+    const lastSpace = hardCap.lastIndexOf(' ');
+    const trimmed = lastSpace > 0 ? hardCap.slice(0, lastSpace) : hardCap;
+    return `${trimmed}…`;
+}
+/** `roleOrLeadName` is resolved by the caller (one `chain.getEntry` lookup) — this formatter
+ *  never resolves ids itself, matching formatters/shape.ts's "no math here" rule. The name is
+ *  workspace-controlled entry data (a role name), never sanitized upstream — every
+ *  interpolation here goes through singleLine() first (BET-269 C3: terminal escaping) so a name
+ *  containing control/ANSI sequences can't inject extra terminal output when this pretty-mode
+ *  confirmation prints (round 2 review, PRRT_kwDORS4ils6YnqK-). */
+export function formatQuestionCreate(result, roleOrLeadName) {
+    const name = singleLine(roleOrLeadName);
+    const base = `Asked as ${singleLine(result.questionId ?? result.entryId)}. It is with ${name}.`;
+    const blocksHint = ' If something is blocked on this, add --blocks <entry-id>.';
+    const nudge = result.nudge ? ` ${result.nudge}` : '';
+    return `${base}${blocksHint}${nudge}`;
+}
+export function formatQuestionAssignReassign(entryId, targetName) {
+    return `${singleLine(entryId)} reassigned to ${singleLine(targetName)}. They'll see it at their next session.`;
+}
+/**
+ * PRRT_kwDORS4ils6YnqK0 (round 2): does NOT mention `pb question list --mine` — S3 shipped no
+ * `list` subcommand at the time (createQuestionCommand() exposed only its write verbs; `list`
+ * was S4's own vertical, §4.1's slice-boundary fix). Pointing users at an unshipped command
+ * would have been a broken-command dead end; S4 restored the full §7.7 wording once `list`
+ * landed (D1c+D2a+D2b, WP-781: the surviving write verbs are now create/assign/answer/
+ * force-close — adopt/snooze/decline are deleted).
+ *
+ * Late #633 finding (PRRT_kwDORS4ils6YozQN): a question closed by decline/forceClose reaches
+ * the SAME idempotent branch as a genuine re-answer — say "already answered" only when it
+ * actually was (or when an older server response omits `processedVia` — treated as answered,
+ * the pre-fix behavior, so a caller that has not yet threaded the new field never regresses).
+ */
+export function formatQuestionAnswer(entryId, result, askerName) {
+    if (result.idempotent) {
+        if (result.processedVia === 'declined' || result.processedVia === 'force_closed') {
+            const via = result.processedVia === 'declined' ? 'declined' : 'force-closed';
+            return `${singleLine(entryId)} is already processed (${via}) — no change.`;
+        }
+        return `${singleLine(entryId)} is already answered — no change.`;
+    }
+    const name = singleLine(askerName) || 'The asker';
+    // §7.7's documented string (design spec line 1413) points at the persistent history surface
+    // this slice introduces — restored now that `pb question list --mine` actually exists (review
+    // finding: S3's temporary wording never got the S4 pointer added).
+    return `${singleLine(entryId)} is answered. ${name} will see the answer at their next session (and in pb question list --mine).`;
+}
+export function formatQuestionForceClose(entryId, result) {
+    return result.idempotent ? `${singleLine(entryId)} is already closed — no change.` : 'Force-closed. Reason recorded.';
+}
+/**
+ * §7.7's `pb question list` columns, in order: ID · QUESTION · STATE · WHY · DOMAIN · WITH ·
+ * AGE — plus OUTCOME on `--mine`. Empty: `No open questions.` / `--mine`:
+ * `You haven't asked any questions yet.` — never a bare empty table.
+ */
+const QUESTION_LIST_TRUNCATE = 60;
+export function formatQuestionList(result, mine) {
+    const rows = result.questions;
+    if (rows.length === 0) {
+        return mine ? "You haven't asked any questions yet." : 'No open questions.';
+    }
+    const header = mine
+        ? 'ID | QUESTION | STATE | WHY | DOMAIN | WITH | AGE | OUTCOME'
+        : 'ID | QUESTION | STATE | WHY | DOMAIN | WITH | AGE';
+    // Pipe-delimited, not fixed-width — STATE/WHY/DOMAIN/WITH are already short, controlled
+    // server-side strings (never truncated, so a display string is never cut mid-word); only
+    // QUESTION (genuine user free text) is bounded.
+    const lines = rows.map((r) => {
+        const cols = [
+            singleLine(r.entryId),
+            truncateWithEllipsis(singleLine(r.question), QUESTION_LIST_TRUNCATE),
+            singleLine(r.stateLabel),
+            singleLine(r.why),
+            singleLine(r.domain),
+            singleLine(r.withLabel),
+            `${r.ageDays}d`,
+        ];
+        if (mine)
+            cols.push(singleLine(r.outcome));
+        return cols.join(' | ');
+    });
+    // Review finding: the scan is honestly capped (ACK_GATE_ASKER_SCAN_CAP for --mine,
+    // ACK_GATE_ROLE_SCAN_CAP/ACK_GATE_OWNER_SCAN_CAP for the obligation view) — a caller who has
+    // asked/owed more than that must be TOLD the list isn't exhaustive, not left assuming an older
+    // row silently doesn't exist.
+    const truncationNote = result.truncated
+        ? [mine
+                ? 'Showing your most recent questions only — older ones exist but are not shown.'
+                : 'This list may be incomplete — some obligations may not be shown.']
+        : [];
+    return [header, ...lines, ...truncationNote].join('\n');
+}
+//# sourceMappingURL=questions.js.map

package/dist/formatters/questions.js.map

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

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

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

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

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

package/dist/formatters/questions.test.js

@@ -0,0 +1,144 @@
+import { describe, expect, it } from 'vitest';
+import { formatQuestionCreate, formatQuestionAssignReassign, formatQuestionAnswer, formatQuestionForceClose, formatQuestionList, } from './questions.js';
+/**
+ * Formatter tests for `pb question` (WP-638 S3, §7.7 of the routed-questions design spec).
+ * Every case is re-derived from §7.7's per-verb confirmation/refusal table — the same
+ * "derived from the matrix, not written beside it" discipline the spec itself demands (§3.9).
+ *
+ * D1c+D2a+D2b (TASK-413/414/416, WP-781): `adopt`/`snooze`/`decline` are deleted, and `assign`
+ * is reassign-to-a-role only (DEC-1707/§10: no domain lookup anywhere; only assign/answer/
+ * forceClose remain). Every question is now born `'escalated'` straight to the Team Lead.
+ */
+function createResult(overrides = {}) {
+    return {
+        entryId: 'TEN-100',
+        questionId: 'QUE-7',
+        facetId: 'facet-1',
+        status: 'escalated',
+        ownerRoleId: 'role-lead',
+        routingReason: 'no_domain',
+        ...overrides,
+    };
+}
+describe('formatQuestionCreate', () => {
+    it('names who it has gone to, plus the blocks hint', () => {
+        const message = formatQuestionCreate(createResult(), 'Ralph');
+        expect(message).toBe('Asked as QUE-7. It is with Ralph. If something is blocked on this, add --blocks <entry-id>.');
+    });
+    it('appends the sub-80-char nudge verbatim when present', () => {
+        const message = formatQuestionCreate(createResult({ nudge: 'Tip: add a sentence on why it matters — the person who picks this up sees only what you wrote.' }), 'Ralph');
+        expect(message).toContain('Tip: add a sentence on why it matters');
+    });
+    // PRRT_kwDORS4ils6YnqK- (round 2 review): resolved role/team-lead names are
+    // workspace-controlled entry names — sanitize before interpolating into terminal output.
+    it('sanitizes a control-character-laden lead name before interpolating it', () => {
+        const message = formatQuestionCreate(createResult(), 'Ralph\x1b[31m\x07');
+        expect(message).toContain('Asked as QUE-7. It is with Ralph.');
+    });
+});
+describe('assign confirmation strings', () => {
+    it('reassign: names the target and says they will see it at their next session', () => {
+        const message = formatQuestionAssignReassign('TEN-100', 'Sylvie');
+        expect(message).toBe("TEN-100 reassigned to Sylvie. They'll see it at their next session.");
+    });
+});
+describe('formatQuestionAnswer', () => {
+    it('names the asker and never says "notified" (OR-18/R33)', () => {
+        const message = formatQuestionAnswer('TEN-100', { entryId: 'TEN-100', status: 'processed', answer: 'Yes.' }, 'Mathijs');
+        expect(message).toBe('TEN-100 is answered. Mathijs will see the answer at their next session (and in pb question list --mine).');
+        expect(message).not.toContain('notified');
+    });
+    // Review finding (post-S4 landing): now that `pb question list --mine` is a real, shipped
+    // command in this same PR, §7.7's documented string (design spec line 1413) restores the
+    // pointer S3's temporary wording had to omit.
+    it('mentions the now-shipped pb question list --mine command (§7.7)', () => {
+        const message = formatQuestionAnswer('TEN-100', { entryId: 'TEN-100', status: 'processed' }, 'Mathijs');
+        expect(message).toContain('pb question list --mine');
+    });
+    it('sanitizes a control-character-laden asker name before interpolating it (PRRT_kwDORS4ils6YnqK-)', () => {
+        const message = formatQuestionAnswer('TEN-100', { entryId: 'TEN-100', status: 'processed' }, 'Mathijs\x1b[31m\x07');
+        expect(message).toBe('TEN-100 is answered. Mathijs will see the answer at their next session (and in pb question list --mine).');
+    });
+    it('idempotent re-answer: names the entry, no re-answered wording', () => {
+        const message = formatQuestionAnswer('TEN-100', { entryId: 'TEN-100', status: 'processed', idempotent: true });
+        expect(message).toBe('TEN-100 is already answered — no change.');
+    });
+    // Late #633 finding (PRRT_kwDORS4ils6YozQN): a question closed by decline/forceClose reaches
+    // the SAME idempotent branch as a genuine re-answer.
+    it('idempotent re-answer on a DECLINED question says "processed (declined)", never "already answered"', () => {
+        const message = formatQuestionAnswer('TEN-100', { entryId: 'TEN-100', status: 'processed', idempotent: true, processedVia: 'declined' });
+        expect(message).toBe('TEN-100 is already processed (declined) — no change.');
+    });
+    it('idempotent re-answer on a FORCE-CLOSED question says "processed (force-closed)", never "already answered"', () => {
+        const message = formatQuestionAnswer('TEN-100', { entryId: 'TEN-100', status: 'processed', idempotent: true, processedVia: 'force_closed' });
+        expect(message).toBe('TEN-100 is already processed (force-closed) — no change.');
+    });
+    it('idempotent re-answer with an explicit processedVia:"answered" still says "already answered"', () => {
+        const message = formatQuestionAnswer('TEN-100', { entryId: 'TEN-100', status: 'processed', idempotent: true, processedVia: 'answered' });
+        expect(message).toBe('TEN-100 is already answered — no change.');
+    });
+});
+describe('formatQuestionForceClose', () => {
+    it('"Force-closed. Reason recorded."', () => {
+        expect(formatQuestionForceClose('TEN-100', { entryId: 'TEN-100', status: 'processed' })).toBe('Force-closed. Reason recorded.');
+    });
+    it('idempotent re-close: names the entry, no second "recorded"', () => {
+        expect(formatQuestionForceClose('TEN-100', { entryId: 'TEN-100', status: 'processed', idempotent: true })).toBe('TEN-100 is already closed — no change.');
+    });
+});
+// WP-638 S4 (§4.1's slice-boundary fix) — `pb question list`.
+describe('formatQuestionList', () => {
+    function row(overrides = {}) {
+        return {
+            entryId: 'TEN-1', question: 'Do we ship Dutch?', status: 'unrouted',
+            stateLabel: 'Suggested to you — take it or pass', why: 'Delivery Lead owns the Delivery domain',
+            domain: 'Delivery', withLabel: 'suggested: Delivery Lead', ageDays: 2,
+            legalVerbs: ['answer', 'take it', 'pass', 'reassign'],
+            ...overrides,
+        };
+    }
+    it('empty (non-mine): "No open questions." — never a bare empty table', () => {
+        expect(formatQuestionList({ questions: [], viewerPersonId: 'p1' }, false)).toBe('No open questions.');
+    });
+    it('empty (--mine): "You haven\'t asked any questions yet."', () => {
+        expect(formatQuestionList({ questions: [], viewerPersonId: 'p1' }, true)).toBe("You haven't asked any questions yet.");
+    });
+    it('renders the stateLabel and why, never the raw status enum', () => {
+        const out = formatQuestionList({ questions: [row()], viewerPersonId: 'p1' }, false);
+        expect(out).toContain('TEN-1');
+        expect(out).toContain('Suggested to you — take it or pass');
+        expect(out).not.toMatch(/\bunrouted\b/);
+    });
+    it('--mine appends the OUTCOME column', () => {
+        const out = formatQuestionList({ questions: [row({ status: 'processed', stateLabel: 'Closed', outcome: 'DEC-9 — Ship it.' })], viewerPersonId: 'p1' }, true);
+        expect(out).toContain('DEC-9 — Ship it.');
+    });
+    // TEN-3332 rider (WP-707 S1): the QUESTION column used to hard-slice at 60 chars with no
+    // word-boundary awareness and no ellipsis marker.
+    it('a QUESTION over the 60-char limit is trimmed at the last word boundary and marked with an ellipsis', () => {
+        const longQuestion = 'A first outside team runs its real work on Product Brain without us in the room';
+        expect(longQuestion.length).toBeGreaterThan(60);
+        const out = formatQuestionList({ questions: [row({ question: longQuestion })], viewerPersonId: 'p1' }, false);
+        const dataLine = out.split('\n')[1];
+        const questionCell = dataLine.split(' | ')[1];
+        expect(questionCell.endsWith('…')).toBe(true);
+        // WP-707 S1 round 2 (ruling #10): the ellipsis is INSIDE the 60-char column width, not
+        // appended past it — the cell (including `…`) must never exceed the limit.
+        expect(questionCell.length).toBeLessThanOrEqual(60);
+        const withoutEllipsis = questionCell.slice(0, -1);
+        expect(longQuestion.startsWith(withoutEllipsis)).toBe(true);
+        // The cut must land on a real word boundary — never mid-word.
+        const nextChar = longQuestion[withoutEllipsis.length];
+        expect(nextChar === ' ' || nextChar === undefined).toBe(true);
+    });
+    it('a QUESTION at or under the 60-char limit is rendered verbatim, with no ellipsis', () => {
+        const shortQuestion = 'Do we ship Dutch localization this quarter or next one';
+        expect(shortQuestion.length).toBeLessThanOrEqual(60);
+        const out = formatQuestionList({ questions: [row({ question: shortQuestion })], viewerPersonId: 'p1' }, false);
+        const dataLine = out.split('\n')[1];
+        const questionCell = dataLine.split(' | ')[1];
+        expect(questionCell).toBe(shortQuestion);
+        expect(questionCell.endsWith('…')).toBe(false);
+    });
+});
+//# sourceMappingURL=questions.test.js.map

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

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

package/dist/formatters/relate.d.ts

@@ -1,13 +1,24 @@
 /**
  * Relate / unrelate receipt formatters — terminal output for pb relate / pb unrelate.
  */
+/** WP-625 (S3 of WP-618, DEC-1546, TEN-3037): advisory-only relation-legality + altitude
+ *  violations the relate door found — never blocks the write, always names the rule. */
+export interface RelateAdvisory {
+    ruleId: string;
+    ruleText: string;
+    severity: string;
+    stage: string;
+}
 export interface RelateReceiptData {
     fromId: string;
     type: string;
     toId: string;
     alreadyExists?: boolean;
-    action: 'related' | 'unrelated' | 'proposal_created';
-    proposalId?: string;
+    action: 'related' | 'unrelated' | 'dry_run';
+    advisories?: RelateAdvisory[];
+    wouldBlock?: boolean;
+    blockingReason?: string;
+    chainDebtPrevented?: boolean;
 }
 export declare function formatRelateReceipt(data: RelateReceiptData): string;
 export declare function formatUnrelateReceipt(data: RelateReceiptData): string;

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

@@ -1 +1 @@
-{"version":3,"file":"relate.d.ts","sourceRoot":"","sources":["../../src/formatters/relate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,kBAAkB,CAAC;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAQnE;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAErE"}
+{"version":3,"file":"relate.d.ts","sourceRoot":"","sources":["../../src/formatters/relate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;wFACwF;AACxF,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;IAC5C,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;IAE9B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IAGxB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAmBnE;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAErE"}

package/dist/formatters/relate.js

@@ -2,13 +2,23 @@
  * Relate / unrelate receipt formatters — terminal output for pb relate / pb unrelate.
  */
 export function formatRelateReceipt(data) {
-    if (data.alreadyExists) {
-        return `Already exists: ${data.fromId} –[${data.type}]→ ${data.toId}`;
+    // TASK-585 (WP-802, TEN-4311): an advisory never blocks the write, so on a real write the line
+    // says the row WAS written; the kernel's ruleText names the undeclared verb and the declared ones.
+    const wrote = data.action === 'related' && !data.alreadyExists;
+    const advisoryLines = (data.advisories ?? []).map((a) => wrote
+        ? `  ⚠ Written anyway (org stage: ${a.stage}): ${a.ruleText}`
+        : `  ⚠ ${a.ruleId} (org stage: ${a.stage}): ${a.ruleText}`);
+    const suffix = advisoryLines.length > 0 ? `\n${advisoryLines.join('\n')}` : '';
+    if (data.action === 'dry_run') {
+        const alreadyLine = data.alreadyExists ? `\n  (already exists — a real --if-missing call would be a no-op)` : '';
+        const debtLine = data.chainDebtPrevented ? `\n  ⚠ would be refused outright (common misuse for this entry pair)` : '';
+        const blockLine = data.wouldBlock ? `\n  ✗ would be BLOCKED: ${data.blockingReason ?? 'unknown reason'}` : '';
+        return `[dry-run, no write] ${data.fromId} –[${data.type}]→ ${data.toId}${alreadyLine}${debtLine}${blockLine}${suffix}`;
     }
-    if (data.action === 'proposal_created') {
-        return `Proposal created (requires approval): ${data.fromId} –[${data.type}]→ ${data.toId}`;
+    if (data.alreadyExists) {
+        return `Already exists: ${data.fromId} –[${data.type}]→ ${data.toId}${suffix}`;
     }
-    return `→ ${data.fromId} –[${data.type}]→ ${data.toId}`;
+    return `→ ${data.fromId} –[${data.type}]→ ${data.toId}${suffix}`;
 }
 export function formatUnrelateReceipt(data) {
     return `✗ Removed ${data.fromId} –[${data.type}]→ ${data.toId}`;

package/dist/formatters/relate.js.map

@@ -1 +1 @@
-{"version":3,"file":"relate.js","sourceRoot":"","sources":["../../src/formatters/relate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH,MAAM,UAAU,mBAAmB,CAAC,IAAuB;IACzD,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QACvB,OAAO,mBAAmB,IAAI,CAAC,MAAM,MAAM,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;IACxE,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,kBAAkB,EAAE,CAAC;QACvC,OAAO,yCAAyC,IAAI,CAAC,MAAM,MAAM,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;IAC9F,CAAC;IACD,OAAO,KAAK,IAAI,CAAC,MAAM,MAAM,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAuB;IAC3D,OAAO,aAAa,IAAI,CAAC,MAAM,MAAM,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;AAClE,CAAC"}
+{"version":3,"file":"relate.js","sourceRoot":"","sources":["../../src/formatters/relate.ts"],"names":[],"mappings":"AAAA;;GAEG;AA0BH,MAAM,UAAU,mBAAmB,CAAC,IAAuB;IACzD,+FAA+F;IAC/F,mGAAmG;IACnG,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC;IAC/D,MAAM,aAAa,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACtD,KAAK;QACH,CAAC,CAAC,kCAAkC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,QAAQ,EAAE;QAC7D,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,gBAAgB,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;IAChE,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/E,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,WAAW,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,kEAAkE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjH,MAAM,QAAQ,GAAG,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,qEAAqE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtH,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,2BAA2B,IAAI,CAAC,cAAc,IAAI,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9G,OAAO,uBAAuB,IAAI,CAAC,MAAM,MAAM,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,EAAE,CAAC;IAC1H,CAAC;IACD,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QACvB,OAAO,mBAAmB,IAAI,CAAC,MAAM,MAAM,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,GAAG,MAAM,EAAE,CAAC;IACjF,CAAC;IACD,OAAO,KAAK,IAAI,CAAC,MAAM,MAAM,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,GAAG,MAAM,EAAE,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAuB;IAC3D,OAAO,aAAa,IAAI,CAAC,MAAM,MAAM,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;AAClE,CAAC"}

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

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

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

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

package/dist/formatters/relate.test.js

@@ -0,0 +1,91 @@
+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');
+    });
+    // 'renders proposal_created' deleted (WP-776 S2a, DEC-1771): 'action' no longer has a
+    // 'proposal_created' member — the relation-consent proposal system it rendered is gone.
+    // 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('⚠ Written anyway (org stage: discovering): 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('⚠ Written anyway (org stage: discovering): REL-LEGAL-1: ...');
+        expect(out).toContain('⚠ Written anyway (org stage: discovering): ALT-1:');
+        expect(out).toContain('DEC-1546');
+    });
+    // TASK-585 (WP-802, TEN-4311): one line says the row was written, the verb is undeclared for
+    // the source type, and which verbs are declared — only on a real write.
+    it('a real write with REL-LEGAL-1 says in one line that the row was written and names the declared verbs', () => {
+        const ruleText = 'REL-LEGAL-1: relation type "resolves" is not declared valid for "insight" (declared: informs, validates, related_to).';
+        const advisories = [{ ruleId: 'REL-LEGAL-1', ruleText, severity: 'advisory', stage: 'discovering' }];
+        const written = formatRelateReceipt({ fromId: 'INS-1', type: 'resolves', toId: 'TEN-1', action: 'related', advisories });
+        expect(written.split('\n')[1]).toBe(`  ⚠ Written anyway (org stage: discovering): ${ruleText}`);
+        const existing = formatRelateReceipt({ fromId: 'INS-1', type: 'resolves', toId: 'TEN-1', action: 'related', alreadyExists: true, advisories });
+        expect(existing).not.toContain('Written anyway');
+        const dryRun = formatRelateReceipt({ fromId: 'INS-1', type: 'resolves', toId: 'TEN-1', action: 'dry_run', advisories });
+        expect(dryRun).not.toContain('Written anyway');
+    });
+    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,CAqBhE"}