@productbrain/cli 0.1.0-beta.49 → 0.1.0-beta.4902

package/dist/formatters/questions.js

@@ -0,0 +1,146 @@
+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() : '';
+}
+function domainListSuffix(domainSlugs) {
+    if (!domainSlugs)
+        return '';
+    return domainSlugs.length > 0 ? ` Domains in this workspace: ${domainSlugs.join(', ')}.` : ' No domains exist in this workspace yet.';
+}
+/** `roleName`/`leadName` are resolved by the caller (one `chain.getEntry` lookup) — this
+ *  formatter never resolves ids itself, matching formatters/shape.ts's "no math here" rule.
+ *  The name is workspace-controlled entry/person data (a role name, a person's displayName),
+ *  never sanitized upstream — every interpolation here goes through singleLine() first
+ *  (BET-269 C3: terminal escaping) so a name containing control/ANSI sequences can't inject
+ *  extra terminal output when this pretty-mode confirmation prints (round 2 review,
+ *  PRRT_kwDORS4ils6YnqK-). */
+export function formatQuestionCreate(result, roleOrLeadName) {
+    const name = singleLine(roleOrLeadName);
+    const base = result.status === 'unrouted'
+        ? `Question created and suggested to ${name}. Confirm with: pb question assign ${result.entryId}`
+        : `Question created. Nothing here says who owns it, so it has gone to ${name}.`;
+    const blocksHint = ' If something is blocked on this, add --blocks <entry-id>.';
+    const nudge = result.nudge ? ` ${result.nudge}` : '';
+    return `${base}${domainListSuffix(result.domainSlugs)}${blocksHint}${nudge}`;
+}
+export function formatQuestionAdopt(result, roleOrLeadName) {
+    const name = singleLine(roleOrLeadName);
+    const base = result.status === 'unrouted'
+        ? `${result.entryId} is now a routed question, suggested to ${name}.`
+        : `${result.entryId} is now a routed question. Nothing here says who owns it, so it has gone to ${name}.`;
+    const nudge = result.nudge ? ` ${result.nudge}` : '';
+    return `${base}${domainListSuffix(result.domainSlugs)}${nudge}`;
+}
+export function formatQuestionAssignConfirm(entryId) {
+    return `${singleLine(entryId)} is yours now.`;
+}
+export function formatQuestionAssignReassign(entryId, targetName) {
+    return `${singleLine(entryId)} reassigned to ${singleLine(targetName)}. They'll see it at their next session.`;
+}
+export function formatQuestionSnooze(result, leadName) {
+    if (result.snoozeUntil) {
+        return `Snoozed until ${new Date(result.snoozeUntil).toISOString().slice(0, 10)}. ${result.snoozeCount ?? '?'} of 2 snoozes used.`;
+    }
+    if (result.status === 'escalated') {
+        return `You have used both snoozes on this question — it has been escalated to ${singleLine(leadName) || 'the team lead'}.`;
+    }
+    return 'No snoozes left — answer it or force-close it.';
+}
+/**
+ * `isRoot` disambiguates two branches that otherwise share the identical
+ * `{status:'escalated', ownerRoleId}` shape: a suggestee's PASS (§3.7a, never sets `isRoot` —
+ * it is never the owner/lead) vs an owner/lead's decline (§3.7b, always sets `isRoot`
+ * explicitly — `true` at the root, `false` below it). Checking `isRoot !== undefined` is what
+ * tells the two apart; `ownerRoleId` alone cannot.
+ */
+export function formatQuestionDecline(entryId, result, roleOrLeadName) {
+    const name = singleLine(roleOrLeadName) || undefined;
+    if (result.status === 'processed')
+        return 'Declined and closed.';
+    if (result.isRoot === true)
+        return `Declined — but ${result.dependentsCount ?? 0} item(s) still depend on it, so it stays with you. Answer it or force-close it.`;
+    if (result.isRoot === false)
+        return `Declined and escalated to ${name ?? 'the team lead'}.`;
+    // isRoot is undefined here — a suggestee's pass (§3.7a), never a terminal decline.
+    if (result.suggestedRoleId)
+        return `Passed. ${singleLine(entryId)} is now suggested to ${name ?? 'another role'}.`;
+    return `Passed. Nobody else here owns this, so it has gone to ${name ?? 'the team lead'}.`;
+}
+/**
+ * PRRT_kwDORS4ils6YnqK0 (round 2): does NOT mention `pb question list --mine` — S3 ships no
+ * `list` subcommand (createQuestionCommand() exposes only the seven write verbs; `list` is
+ * S4's own vertical, §4.1's slice-boundary fix). Pointing users at an unshipped command here
+ * would be a broken-command dead end; S4 restores the full §7.7 wording when `list` lands.
+ *
+ * Late #633 finding (PRRT_kwDORS4ils6YozQN): a question closed by decline/forceClose reaches
+ * the SAME idempotent branch as a genuine re-answer — say "already answered" only when it
+ * actually was (or when an older server response omits `processedVia` — treated as answered,
+ * the pre-fix behavior, so a caller that has not yet threaded the new field never regresses).
+ */
+export 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 pendingNote = result.answerPending ? ' The answer is a draft awaiting accept.' : '';
+    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 `Answered. ${name} will see the outcome at their next session (and in pb question list --mine).${pendingNote}`;
+}
+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),
+            singleLine(r.question).slice(0, 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":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD;;;;;GAKG;AAEH,SAAS,UAAU,CAAC,KAAyB;IAC3C,OAAO,KAAK,CAAC,CAAC,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC3E,CAAC;AAED,SAAS,gBAAgB,CAAC,WAAsB;IAC9C,IAAI,CAAC,WAAW;QAAE,OAAO,EAAE,CAAC;IAC5B,OAAO,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,+BAA+B,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,0CAA0C,CAAC;AACxI,CAAC;AAaD;;;;;;8BAM8B;AAC9B,MAAM,UAAU,oBAAoB,CAAC,MAAyB,EAAE,cAAsB;IACpF,MAAM,IAAI,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,KAAK,UAAU;QACvC,CAAC,CAAC,qCAAqC,IAAI,sCAAsC,MAAM,CAAC,OAAO,EAAE;QACjG,CAAC,CAAC,sEAAsE,IAAI,GAAG,CAAC;IAClF,MAAM,UAAU,GAAG,4DAA4D,CAAC;IAChF,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACrD,OAAO,GAAG,IAAI,GAAG,gBAAgB,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,UAAU,GAAG,KAAK,EAAE,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAyB,EAAE,cAAsB;IACnF,MAAM,IAAI,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,KAAK,UAAU;QACvC,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,2CAA2C,IAAI,GAAG;QACrE,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,+EAA+E,IAAI,GAAG,CAAC;IAC5G,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACrD,OAAO,GAAG,IAAI,GAAG,gBAAgB,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,KAAK,EAAE,CAAC;AAClE,CAAC;AAID,MAAM,UAAU,2BAA2B,CAAC,OAAe;IACzD,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,gBAAgB,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,OAAe,EAAE,UAAkB;IAC9E,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,kBAAkB,UAAU,CAAC,UAAU,CAAC,yCAAyC,CAAC;AACjH,CAAC;AAID,MAAM,UAAU,oBAAoB,CAAC,MAAoB,EAAE,QAAiB;IAC1E,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACvB,OAAO,iBAAiB,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,MAAM,CAAC,WAAW,IAAI,GAAG,qBAAqB,CAAC;IACrI,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,OAAO,0EAA0E,UAAU,CAAC,QAAQ,CAAC,IAAI,eAAe,GAAG,CAAC;IAC9H,CAAC;IACD,OAAO,gDAAgD,CAAC;AAC1D,CAAC;AAID;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAe,EAAE,MAAqB,EAAE,cAAuB;IACnG,MAAM,IAAI,GAAG,UAAU,CAAC,cAAc,CAAC,IAAI,SAAS,CAAC;IACrD,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW;QAAE,OAAO,sBAAsB,CAAC;IACjE,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI;QAAE,OAAO,kBAAkB,MAAM,CAAC,eAAe,IAAI,CAAC,iFAAiF,CAAC;IAClK,IAAI,MAAM,CAAC,MAAM,KAAK,KAAK;QAAE,OAAO,6BAA6B,IAAI,IAAI,eAAe,GAAG,CAAC;IAC5F,mFAAmF;IACnF,IAAI,MAAM,CAAC,eAAe;QAAE,OAAO,WAAW,UAAU,CAAC,OAAO,CAAC,wBAAwB,IAAI,IAAI,cAAc,GAAG,CAAC;IACnH,OAAO,yDAAyD,IAAI,IAAI,eAAe,GAAG,CAAC;AAC7F,CAAC;AAID;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAe,EAAE,MAAoB,EAAE,SAAkB;IAC5F,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,IAAI,MAAM,CAAC,YAAY,KAAK,UAAU,IAAI,MAAM,CAAC,YAAY,KAAK,cAAc,EAAE,CAAC;YACjF,MAAM,GAAG,GAAG,MAAM,CAAC,YAAY,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC;YAC7E,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,0BAA0B,GAAG,gBAAgB,CAAC;QAC7E,CAAC;QACD,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,mCAAmC,CAAC;IACnE,CAAC;IACD,MAAM,WAAW,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,yCAAyC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1F,MAAM,IAAI,GAAG,UAAU,CAAC,SAAS,CAAC,IAAI,WAAW,CAAC;IAClD,4FAA4F;IAC5F,8FAA8F;IAC9F,mEAAmE;IACnE,OAAO,aAAa,IAAI,gFAAgF,WAAW,EAAE,CAAC;AACxH,CAAC;AAID,MAAM,UAAU,wBAAwB,CAAC,OAAe,EAAE,MAAwB;IAChF,OAAO,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,iCAAiC,CAAC,CAAC,CAAC,gCAAgC,CAAC;AACxH,CAAC;AAoBD;;;;GAIG;AACH,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAElC,MAAM,UAAU,kBAAkB,CAAC,MAA0B,EAAE,IAAa;IAC1E,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC;IAC9B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC,CAAC,CAAC,sCAAsC,CAAC,CAAC,CAAC,oBAAoB,CAAC;IAC9E,CAAC;IACD,MAAM,MAAM,GAAG,IAAI;QACjB,CAAC,CAAC,6DAA6D;QAC/D,CAAC,CAAC,mDAAmD,CAAC;IACxD,wFAAwF;IACxF,yFAAyF;IACzF,gDAAgD;IAChD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC3B,MAAM,IAAI,GAAG;YACX,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC;YACrB,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,sBAAsB,CAAC;YACvD,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;YACxB,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC;YACjB,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC;YACpB,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;YACvB,GAAG,CAAC,CAAC,OAAO,GAAG;SAChB,CAAC;QACF,IAAI,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IACH,mFAAmF;IACnF,6FAA6F;IAC7F,+FAA+F;IAC/F,8BAA8B;IAC9B,MAAM,cAAc,GAAG,MAAM,CAAC,SAAS;QACrC,CAAC,CAAC,CAAC,IAAI;gBACL,CAAC,CAAC,+EAA+E;gBACjF,CAAC,CAAC,kEAAkE,CAAC;QACvE,CAAC,CAAC,EAAE,CAAC;IACP,OAAO,CAAC,MAAM,EAAE,GAAG,KAAK,EAAE,GAAG,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1D,CAAC"}

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,184 @@
+import { describe, expect, it } from 'vitest';
+import { formatQuestionCreate, formatQuestionAdopt, formatQuestionAssignConfirm, formatQuestionAssignReassign, formatQuestionSnooze, formatQuestionDecline, 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).
+ */
+function createAdoptResult(overrides = {}) {
+    return {
+        entryId: 'TEN-100',
+        facetId: 'facet-1',
+        status: 'unrouted',
+        routingReason: 'single_domain_owner',
+        domainSlugs: ['delivery', 'strategy'],
+        ...overrides,
+    };
+}
+describe('formatQuestionCreate', () => {
+    it('suggests a role and includes the confirm command + live domain list + blocks hint', () => {
+        const message = formatQuestionCreate(createAdoptResult(), 'Delivery Lead');
+        expect(message).toContain('Question created and suggested to Delivery Lead.');
+        expect(message).toContain('Confirm with: pb question assign TEN-100');
+        expect(message).toContain('Domains in this workspace: delivery, strategy.');
+        expect(message).toContain('If something is blocked on this, add --blocks <entry-id>.');
+    });
+    it('born-escalated (no suggestion derivable) names the team lead, never "suggested"', () => {
+        const message = formatQuestionCreate(createAdoptResult({ status: 'escalated', suggestedRoleId: undefined, ownerRoleId: 'role-lead' }), 'Ralph');
+        expect(message).toBe('Question created. Nothing here says who owns it, so it has gone to Ralph. Domains in this workspace: delivery, strategy. If something is blocked on this, add --blocks <entry-id>.');
+    });
+    it('appends the sub-80-char nudge verbatim when present', () => {
+        const message = formatQuestionCreate(createAdoptResult({ nudge: 'Tip: add a sentence on why it matters — the person who picks this up sees only what you wrote.' }), 'Delivery Lead');
+        expect(message).toContain('Tip: add a sentence on why it matters');
+    });
+    it('renders "no domains yet" when the workspace has none', () => {
+        const message = formatQuestionCreate(createAdoptResult({ domainSlugs: [] }), 'Delivery Lead');
+        expect(message).toContain('No domains exist in this workspace yet.');
+    });
+    // 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 role name before interpolating it', () => {
+        const message = formatQuestionCreate(createAdoptResult(), 'Delivery Lead\x1b[31m\x07');
+        expect(message).toContain('Question created and suggested to Delivery Lead.');
+    });
+});
+describe('formatQuestionAdopt', () => {
+    it('names the entry id and the suggested role', () => {
+        const message = formatQuestionAdopt(createAdoptResult(), 'Delivery Lead');
+        expect(message).toBe('TEN-100 is now a routed question, suggested to Delivery Lead. Domains in this workspace: delivery, strategy.');
+    });
+    it('born-escalated form names the entry id and the team lead', () => {
+        const message = formatQuestionAdopt(createAdoptResult({ status: 'escalated', suggestedRoleId: undefined, ownerRoleId: 'role-lead' }), 'Ralph');
+        expect(message).toBe('TEN-100 is now a routed question. Nothing here says who owns it, so it has gone to Ralph. Domains in this workspace: delivery, strategy.');
+    });
+});
+describe('assign confirmation strings', () => {
+    it('bare confirm: "<ID> is yours now."', () => {
+        expect(formatQuestionAssignConfirm('TEN-100')).toBe('TEN-100 is yours now.');
+    });
+    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('formatQuestionSnooze', () => {
+    it('within budget: "Snoozed until <date>. <n> of 2 snoozes used."', () => {
+        const message = formatQuestionSnooze({ entryId: 'TEN-100', status: 'routed', snoozeCount: 1, snoozeUntil: Date.UTC(2026, 7, 14) });
+        expect(message).toBe('Snoozed until 2026-08-14. 1 of 2 snoozes used.');
+    });
+    it('at budget from routed (escalates): names the team lead, never "escalated to nobody"', () => {
+        const message = formatQuestionSnooze({ entryId: 'TEN-100', status: 'escalated', ownerRoleId: 'role-lead' }, 'Ralph');
+        expect(message).toBe('You have used both snoozes on this question — it has been escalated to Ralph.');
+    });
+    // At budget from an already-'escalated' row (R32/OR-21), the verb THROWS a plain refusal
+    // ("No snoozes left — answer it or force-close it.") rather than returning a result — there
+    // is no successful SnoozeResult shape for this case, so the CLI/MCP surfaces the thrown
+    // message verbatim through the ordinary error path, never through this formatter.
+    it('sanitizes a control-character-laden lead name before interpolating it (PRRT_kwDORS4ils6YnqK-)', () => {
+        const message = formatQuestionSnooze({ entryId: 'TEN-100', status: 'escalated', ownerRoleId: 'role-lead' }, 'Ralph\x1b[31m\x07');
+        expect(message).toBe('You have used both snoozes on this question — it has been escalated to Ralph.');
+    });
+});
+describe('formatQuestionDecline', () => {
+    it('suggestee pass, re-suggested: "Passed. <ID> is now suggested to <role>."', () => {
+        const message = formatQuestionDecline('TEN-100', { entryId: 'TEN-100', status: 'unrouted', suggestedRoleId: 'role-2' }, 'Backend Lead');
+        expect(message).toBe('Passed. TEN-100 is now suggested to Backend Lead.');
+    });
+    it('suggestee pass, nothing left: "Passed. Nobody else here owns this, so it has gone to <lead>." — isRoot is UNDEFINED (never set by a pass, §3.7a)', () => {
+        const message = formatQuestionDecline('TEN-100', { entryId: 'TEN-100', status: 'escalated', ownerRoleId: 'role-lead' }, 'Ralph');
+        expect(message).toBe('Passed. Nobody else here owns this, so it has gone to Ralph.');
+    });
+    it('owner/lead decline, zero dependents: "Declined and closed."', () => {
+        const message = formatQuestionDecline('TEN-100', { entryId: 'TEN-100', status: 'processed' });
+        expect(message).toBe('Declined and closed.');
+    });
+    it('owner/lead decline, below root with dependents: "Declined and escalated to <lead>."', () => {
+        const message = formatQuestionDecline('TEN-100', { entryId: 'TEN-100', status: 'escalated', ownerRoleId: 'role-lead', isRoot: false }, 'Ralph');
+        expect(message).toBe('Declined and escalated to Ralph.');
+    });
+    it('owner/lead decline AT ROOT with dependents (OR-17): stays with the decliner, never a hand-off', () => {
+        const message = formatQuestionDecline('TEN-100', { entryId: 'TEN-100', status: 'escalated', isRoot: true, dependentsCount: 3 });
+        expect(message).toBe('Declined — but 3 item(s) still depend on it, so it stays with you. Answer it or force-close it.');
+    });
+    it('sanitizes a control-character-laden role/lead name before interpolating it (PRRT_kwDORS4ils6YnqK-)', () => {
+        const message = formatQuestionDecline('TEN-100', { entryId: 'TEN-100', status: 'unrouted', suggestedRoleId: 'role-2' }, 'Backend Lead\x1b[31m\x07');
+        expect(message).toBe('Passed. TEN-100 is now suggested to Backend Lead.');
+    });
+});
+describe('formatQuestionAnswer', () => {
+    it('names the asker and never says "notified" (OR-18/R33)', () => {
+        const message = formatQuestionAnswer('TEN-100', { entryId: 'TEN-100', status: 'processed', answerEntryId: 'DEC-5', answerPending: false }, 'Mathijs');
+        expect(message).toBe('Answered. Mathijs will see the outcome 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('Answered. Mathijs will see the outcome at their next session (and in pb question list --mine).');
+    });
+    it('appends the draft-awaiting-accept note when the answer entry landed as a draft', () => {
+        const message = formatQuestionAnswer('TEN-100', { entryId: 'TEN-100', status: 'processed', answerPending: true }, 'Mathijs');
+        expect(message).toContain('The answer is a draft awaiting accept.');
+    });
+    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.');
+    });
+});
+//# 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,26 @@
 /**
  * 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';
+    action: 'related' | 'unrelated' | 'proposal_created' | 'dry_run';
     proposalId?: string;
+    advisories?: RelateAdvisory[];
+    wouldBlock?: boolean;
+    blockingReason?: string;
+    chainDebtPrevented?: boolean;
+    wouldRequireProposal?: 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,kBAAkB,GAAG,SAAS,CAAC;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;IAE9B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IAGxB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAG7B,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAiBnE;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAErE"}

package/dist/formatters/relate.js

@@ -2,13 +2,22 @@
  * Relate / unrelate receipt formatters — terminal output for pb relate / pb unrelate.
  */
 export function formatRelateReceipt(data) {
+    const advisoryLines = (data.advisories ?? []).map((a) => `  ⚠ ${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 divert into a sign-off proposal instead of writing this relation` : '';
+        const proposalLine = data.wouldRequireProposal ? `\n  ⚠ would divert into an async-consent proposal instead of writing this relation` : '';
+        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}${proposalLine}${blockLine}${suffix}`;
+    }
     if (data.alreadyExists) {
-        return `Already exists: ${data.fromId} –[${data.type}]→ ${data.toId}`;
+        return `Already exists: ${data.fromId} –[${data.type}]→ ${data.toId}${suffix}`;
     }
     if (data.action === 'proposal_created') {
-        return `Proposal created (requires approval): ${data.fromId} –[${data.type}]→ ${data.toId}`;
+        return `Proposal created (requires approval): ${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;AA8BH,MAAM,UAAU,mBAAmB,CAAC,IAAuB;IACzD,MAAM,aAAa,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,MAAM,gBAAgB,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;IACnH,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,8EAA8E,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/H,MAAM,YAAY,GAAG,IAAI,CAAC,oBAAoB,CAAC,CAAC,CAAC,oFAAoF,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3I,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,YAAY,GAAG,SAAS,GAAG,MAAM,EAAE,CAAC;IACzI,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,IAAI,IAAI,CAAC,MAAM,KAAK,kBAAkB,EAAE,CAAC;QACvC,OAAO,yCAAyC,IAAI,CAAC,MAAM,MAAM,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,GAAG,MAAM,EAAE,CAAC;IACvG,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,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"}