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

package/dist/formatters/qualityChecks.js

@@ -0,0 +1,97 @@
+const rate = (r) => `${r.count}/${r.of}`;
+/** The verb each mode prints as, one place for every line below (RULE-664). */
+const MODE_VERB = { hold: 'holds', suggest: 'suggests', record: 'records' };
+/** TEN-4775: the header says what the check does per kind, from the mode the door applies, never a bar it does not hold at. */
+function header(check) {
+    const of = (mode) => check.kinds.filter((k) => k.mode === mode).map((k) => k.kind).join(', ');
+    const holds = of('hold');
+    const later = ['suggest', 'record'].flatMap((mode) => (of(mode) ? [`${MODE_VERB[mode]} ${of(mode)}`] : []));
+    const parts = [holds ? `${MODE_VERB.hold} ${holds}` : `${MODE_VERB.hold} nothing`, ...later];
+    return `${check.checkKey} check (p ${check.holdAt.toFixed(2)}: ${parts.join('; ')})`;
+}
+/** TASK-747 (DEC-2117): the trip window of non-self resolutions, and the self-accepts beside it, never counted. */
+function kindLine(k) {
+    if (k.mode !== 'hold' && k.trippedAt === null)
+        return `  ${k.kind}: ${MODE_VERB[k.mode]}; never held, so no trip window`;
+    const w = k.window;
+    const mode = k.trippedAt === null ? 'holds' : `suggests, hold tripped ${new Date(k.trippedAt).toISOString().slice(0, 10)}`;
+    return `  ${k.kind}: ${mode}; trip window ${w.fill} of ${w.of} non-self resolutions: unchanged ${w.accepted_unchanged}, `
+        + `edited ${w.accepted_edited}, discarded ${w.discarded}; self-accepted unchanged ${rate(k.selfUnchanged)} self resolutions, `
+        + `unattributed ${k.unattributed} (no writer person); neither counted`;
+}
+function windowLine(label, w) {
+    const reasons = Object.entries(w.unavailableReasons).map(([why, n]) => `${why} ${n}`).join(', ');
+    // TEN-5167: only the role check looks an owner up, so only its window carries the count.
+    const ownerUnread = w.ownerUnread ? `owner lookup failed ${rate(w.ownerUnread)} of the holds and suggestions, ` : '';
+    return `  ${label}: ${w.checked} writes checked; held ${rate(w.holds)}, suggested ${rate(w.suggestions)}, recorded at the bar ${rate(w.recorded)}, `
+        + `timed out ${rate(w.timeouts)}, ${ownerUnread}unavailable ${rate(w.unavailable)}${reasons ? ` (${reasons})` : ''}; `
+        + `of the holds: handed back ${rate(w.handBacks)}, overridden ${rate(w.overrides)}`;
+}
+/** TASK-901: what became of the held entries, each result by the writer itself and by someone else. */
+function outcomesLine(label, w) {
+    const o = w.outcomes;
+    const part = (word) => `${word} ${o[word].self + o[word].other} (self ${o[word].self}, other ${o[word].other})`;
+    return `  ${label} outcomes: ${part('accepted_unchanged')}, ${part('accepted_edited')}, ${part('discarded')}`;
+}
+export function formatQualityChecks(result) {
+    const lines = [];
+    for (const check of result.checks) {
+        lines.push(header(check));
+        lines.push(...check.kinds.map(kindLine));
+        lines.push(windowLine('all time', check.allTime));
+        lines.push(outcomesLine('all time', check.allTime));
+        lines.push(windowLine('last 50 holds', check.lastHolds));
+        lines.push(outcomesLine('last 50 holds', check.lastHolds));
+        if (check.lastHoldsCutAtRows !== null)
+            lines.push(`  last 50 holds: window cut at ${check.lastHoldsCutAtRows} rows; its counts are partial.`);
+    }
+    if (result.truncated)
+        lines.push('The ledger read stopped at its cap: the all-time counts cover the newest rows only.');
+    return lines.join('\n');
+}
+/** TASK-921: the words each class prints as; the class itself comes from the kernel (roleSuggestionOutcomes.ts). */
+const CLASS_WORD = {
+    matched: 'matched', mismatched: 'mismatched', still_draft: 'still draft', discarded: 'discarded or retired', unowned: 'no owner',
+    unreadable: 'unreadable (no role kept)', gone: 'entry gone',
+};
+const TOTAL_LABEL = {
+    hold: 'holds', suggest: 'suggestions', record: 'recorded', released: 'released to the writer', placed: 'placed on its role', all: 'all',
+};
+/** `pb quality checks --role-suggestions` (TASK-921): one line per verdict, then each class over its denominator (RULE-17). */
+export function formatRoleSuggestions(result) {
+    const lines = result.rows.map((r) => {
+        const p = r.probability === null ? 'p -' : `p ${r.probability.toFixed(2)}`;
+        const named = r.suggested ? `${r.suggested.name}${r.suggested.roleId ? ` (${r.suggested.roleId})` : ''}` : 'no role kept';
+        const owner = r.finalOwner ? `${r.finalOwner.name}${r.finalOwner.roleId ? ` (${r.finalOwner.roleId})` : ''}` : 'none';
+        const resolved = r.resolution ? `, ${r.resolution}` : '';
+        return `${new Date(r.at).toISOString().slice(0, 16)}Z  ${r.subjectEntryId ?? '(no entry id)'}  ${r.action}${r.late ? ' (late)' : ''}  ${p}  `
+            + `named ${named} -> owner ${owner} [${r.entryStatus ?? 'gone'}${resolved}]: ${CLASS_WORD[r.class]}`;
+    });
+    if (lines.length === 0)
+        lines.push('No role-check suggestion or hold in the ledger read yet; pb quality checks shows how many writes the role check judged.');
+    for (const t of result.totals) {
+        const parts = result.classes.map((c) => `${CLASS_WORD[c]} ${t.byClass[c]}/${t.of}`); // the kernel's class order (ROLE_SUGGESTION_CLASSES)
+        lines.push(`${TOTAL_LABEL[t.action]}: ${t.of} rows; ${parts.join(', ')}`);
+    }
+    const lead = result.leadRoutes; // DEC-2165 kill line A (TASK-949): the route names the writer's own team, so expect 0
+    lines.push(`Team Lead routes: ${lead.of} entries Team Lead owns after a check named it; writer's team read ${lead.teamRead}/${lead.of}; owned in another team ${lead.offTeam}/${lead.teamRead}.`);
+    if (result.truncated) {
+        const from = result.readFrom === null ? 'its cap' : `${new Date(result.readFrom).toISOString().slice(0, 10)}`;
+        lines.push(`The ledger read stopped at ${from}: older verdicts are not in these rows or counts.`);
+    }
+    return lines.join('\n');
+}
+/** `pb quality checks --policy-rows` (TASK-961): one line per policy row at the bar, newest first, then how much was read (RULE-17). */
+export function formatPolicyRows(result) {
+    const lines = result.rows.map((r) => {
+        const p = r.probability === null ? 'p -' : `p ${r.probability.toFixed(2)}`;
+        return `${new Date(r.at).toISOString().slice(0, 16)}Z  ${r.subjectEntryId ?? '(no entry id)'}  ${r.ruleId ?? '(no rule id)'}  ${p}  ${r.mode ?? '(no mode)'}`;
+    });
+    if (lines.length === 0)
+        lines.push('No policy-check row at the bar in the ledger read yet; pb quality checks shows how many writes the policy check judged.');
+    lines.push(`${result.rows.length} rows at the bar, from the newest ${result.scanned} check rows read.`);
+    if (result.truncated)
+        lines.push('The ledger read stopped at its cap: older policy rows are not listed.');
+    return lines.join('\n');
+}
+//# sourceMappingURL=qualityChecks.js.map

package/dist/formatters/qualityChecks.js.map

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

package/dist/formatters/questions.d.ts

@@ -0,0 +1,76 @@
+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 ("no math here"). 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';
+    replaced?: true;
+    answeredLine?: string;
+}
+/**
+ * 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;
+    /** TASK-957 (RULE-664): the kernel's judge sentence for the row, printed as sent. */
+    judgeSentence?: 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,CAAC;IAAC,QAAQ,CAAC,EAAE,IAAI,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE;AAElR;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAgBtG;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;IACjB,qFAAqF;IACrF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;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,CAmCpF"}

package/dist/formatters/questions.js

@@ -0,0 +1,122 @@
+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 — 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 ("no math here"). 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.`;
+        }
+        // TASK-978 (TEN-5317): the same answer again; the kernel's line names who answered and when.
+        return `${singleLine(entryId)} already has this answer — no change. ${singleLine(result.answeredLine)}`.trim();
+    }
+    const name = singleLine(askerName) || 'The asker';
+    // TASK-978 (DEC-2181): a re-answer through the answer door replaced the answer; the history keeps the old one.
+    if (result.replaced)
+        return `${singleLine(entryId)} is answered again; the previous answer stays in its history. ${name} will see the new answer at their next session.`;
+    // §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`, or TO DECIDE (the kernel's judge sentence, TASK-957) on the obligation view. 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 | TO DECIDE';
+    // 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));
+        else
+            cols.push(singleLine(r.judgeSentence));
+        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,156 @@
+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('the same answer again: names the entry and the kernel line naming who answered and when (TEN-5317)', () => {
+        const answeredLine = 'This question was answered by Robin at 2026-10-17 14:20 UTC.';
+        const message = formatQuestionAnswer('TEN-100', { entryId: 'TEN-100', status: 'processed', idempotent: true, processedVia: 'answered', answeredLine });
+        expect(message).toBe(`TEN-100 already has this answer — no change. ${answeredLine}`);
+    });
+    it('a re-answer says the answer was replaced and the previous one stays in history (DEC-2181)', () => {
+        const message = formatQuestionAnswer('TEN-100', { entryId: 'TEN-100', status: 'processed', answer: 'Monday', replaced: true }, 'Robin');
+        expect(message).toBe('TEN-100 is answered again; the previous answer stays in its history. Robin will see the new answer at their next session.');
+    });
+    // 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('the same answer again from an older server with no answeredLine still reads plainly', () => {
+        const message = formatQuestionAnswer('TEN-100', { entryId: 'TEN-100', status: 'processed', idempotent: true, processedVia: 'answered' });
+        expect(message).toBe('TEN-100 already has this answer — 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/);
+    });
+    // TASK-957 (RULE-664): the kernel's judge sentence is the last column of the obligation view, printed as sent.
+    it('prints the kernel judge sentence unchanged under TO DECIDE', () => {
+        const out = formatQuestionList({ questions: [row({ judgeSentence: 'What is your answer, as Team Lead?' })], viewerPersonId: 'p1' }, false);
+        const [header, dataLine] = out.split('\n');
+        expect(header.endsWith('| TO DECIDE')).toBe(true);
+        expect(dataLine.endsWith(' | What is your answer, as Team Lead?')).toBe(true);
+    });
+    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":""}