@productbrain/cli 0.1.0-beta.1414 → 0.1.0-beta.14155

package/dist/formatters/orientRetrievalMiss.d.ts

@@ -0,0 +1,22 @@
+/** `buildRetrievalMissLines` — extracted out of orient.ts (STD-2/DEC-1504: that file is
+ *  grandfathered shrink-only, so WP-582 B2's growth there needs an equal-or-greater offsetting
+ *  extraction in the SAME PR). Pure, self-contained, module-private in its original home (never
+ *  exported) — used by both formatOrient and formatOrientBrief.
+ *
+ *  The param type is declared INLINE (a structural subset of `OrientView`) rather than imported
+ *  from orient.ts — importing the type back would create a two-file import cycle
+ *  (orient.ts -> orientRetrievalMiss.ts -> orient.ts), which dep-cruiser's no-circular rule flags
+ *  even for a type-only edge (CI finding, PR #532: `npm run check:boundaries`). */
+interface RetrievalMissView {
+    served: 'ok' | 'low' | 'miss';
+    kind: string | null;
+    confidence: number;
+    rubricVersion: string;
+}
+export declare function buildRetrievalMissLines(view: {
+    retrievalMiss?: RetrievalMissView;
+}, opts?: {
+    markdownHeading?: boolean;
+}): string[];
+export {};
+//# sourceMappingURL=orientRetrievalMiss.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"orientRetrievalMiss.d.ts","sourceRoot":"","sources":["../../src/formatters/orientRetrievalMiss.ts"],"names":[],"mappings":"AAAA;;;;;;;;mFAQmF;AACnF,UAAU,iBAAiB;IACzB,MAAM,EAAE,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC;IAC9B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE;IAAE,aAAa,CAAC,EAAE,iBAAiB,CAAA;CAAE,EAC3C,IAAI,GAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAA;CAA8B,GAC9D,MAAM,EAAE,CAeV"}

package/dist/formatters/orientRetrievalMiss.js

@@ -0,0 +1,17 @@
+export function buildRetrievalMissLines(view, opts = { markdownHeading: true }) {
+    const verdict = view.retrievalMiss;
+    const lines = [];
+    if (verdict && verdict.served !== 'ok') {
+        if (verdict.served === 'miss') {
+            lines.push(`${opts.markdownHeading ? '## ' : ''}⚠ RETRIEVAL MISS — ${verdict.kind ?? 'unknown'}`);
+        }
+        else {
+            lines.push(`_weak serve (provisional, ${verdict.rubricVersion}): ${verdict.kind ?? 'thin'}_`);
+        }
+    }
+    if (lines.length === 0)
+        return [];
+    lines.push('');
+    return lines;
+}
+//# sourceMappingURL=orientRetrievalMiss.js.map

package/dist/formatters/orientRetrievalMiss.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orientRetrievalMiss.js","sourceRoot":"","sources":["../../src/formatters/orientRetrievalMiss.ts"],"names":[],"mappings":"AAgBA,MAAM,UAAU,uBAAuB,CACrC,IAA2C,EAC3C,OAAsC,EAAE,eAAe,EAAE,IAAI,EAAE;IAE/D,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC;IACnC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QACvC,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,sBAAsB,OAAO,CAAC,IAAI,IAAI,SAAS,EAAE,CAAC,CAAC;QACpG,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,6BAA6B,OAAO,CAAC,aAAa,MAAM,OAAO,CAAC,IAAI,IAAI,MAAM,GAAG,CAAC,CAAC;QAChG,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/formatters/plannedWorkCounts.d.ts

@@ -0,0 +1,16 @@
+/**
+ * TEN-4562 (TEN-4550; copilot-instructions.md code rules): the kernel caps every planned-work list at 5 and says when it cut one
+ * (convex/agentKnowledge/orient.ts: draftsTruncated, openTensionsTruncated). Every CLI surface
+ * that prints planned work (pb orient full and brief, the generated context.md) renders a cut list through these two
+ * helpers, so none prints an exact-looking "5 open tension(s)".
+ */
+/** The served flags, beside the two lists on every CLI planned-work shape. */
+export interface PlannedWorkCutFlags {
+    draftsTruncated?: boolean;
+    openTensionsTruncated?: boolean;
+}
+/** "5+" when the kernel cut the list, the exact count otherwise. */
+export declare function cappedCount(count: number, truncated: boolean | undefined): string;
+/** A heading suffix for a cut list — " (5+, more than shown)" — or nothing. */
+export declare function cutNote(count: number, truncated: boolean | undefined): string;
+//# sourceMappingURL=plannedWorkCounts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plannedWorkCounts.d.ts","sourceRoot":"","sources":["../../src/formatters/plannedWorkCounts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,8EAA8E;AAC9E,MAAM,WAAW,mBAAmB;IAClC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAEjF;AAED,+EAA+E;AAC/E,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAE7E"}

package/dist/formatters/plannedWorkCounts.js

@@ -0,0 +1,15 @@
+/**
+ * TEN-4562 (TEN-4550; copilot-instructions.md code rules): the kernel caps every planned-work list at 5 and says when it cut one
+ * (convex/agentKnowledge/orient.ts: draftsTruncated, openTensionsTruncated). Every CLI surface
+ * that prints planned work (pb orient full and brief, the generated context.md) renders a cut list through these two
+ * helpers, so none prints an exact-looking "5 open tension(s)".
+ */
+/** "5+" when the kernel cut the list, the exact count otherwise. */
+export function cappedCount(count, truncated) {
+    return truncated ? `${count}+` : String(count);
+}
+/** A heading suffix for a cut list — " (5+, more than shown)" — or nothing. */
+export function cutNote(count, truncated) {
+    return truncated ? ` (${count}+, more than shown)` : '';
+}
+//# sourceMappingURL=plannedWorkCounts.js.map

package/dist/formatters/plannedWorkCounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plannedWorkCounts.js","sourceRoot":"","sources":["../../src/formatters/plannedWorkCounts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,oEAAoE;AACpE,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,SAA8B;IACvE,OAAO,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACjD,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,OAAO,CAAC,KAAa,EAAE,SAA8B;IACnE,OAAO,SAAS,CAAC,CAAC,CAAC,KAAK,KAAK,qBAAqB,CAAC,CAAC,CAAC,EAAE,CAAC;AAC1D,CAAC"}

package/dist/formatters/qualityChecks.d.ts

@@ -0,0 +1,21 @@
+/**
+ * `pb quality checks` (TASK-740, TASK-747): formats the kernel's per-check rates (quality.checks). Every rate prints as
+ * count/denominator (RULE-17); the counts and each kind's mode come from the kernel, this file only lays them out (RULE-128).
+ */
+import type { GatewayRouteReturnByName } from '@productbrain/kernel-client';
+export type QualityChecksResult = GatewayRouteReturnByName<'quality.checks'>;
+export type RoleSuggestionsResult = GatewayRouteReturnByName<'quality.roleSuggestions'>;
+export type CheckRowsResult = GatewayRouteReturnByName<'quality.checkRows'>;
+export declare function formatQualityChecks(result: QualityChecksResult): string;
+/** `pb quality checks --role-suggestions` (TASK-921): one line per verdict, then each class over its denominator (RULE-17). */
+export declare function formatRoleSuggestions(result: RoleSuggestionsResult): string;
+/** The table's text cut, so a row stays one line; --json carries the whole text. */
+export declare const CHECK_ROW_TEXT_CUT = 200;
+/**
+ * `pb quality checks --rows` (TASK-1328): the window first, by outcome over the writes checked (one door row a write; a late answer and an
+ * override are further rows beside them, RULE-17), the rows left out by why, how many rows the filters match, then one line per row
+ * ending in where its entry stands today (later: overridden, handed back, still draft, discarded, accepted or gone).
+ * Every outcome word and its order come from the kernel (RULE-664).
+ */
+export declare function formatCheckRows(result: CheckRowsResult): string;
+//# sourceMappingURL=qualityChecks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"qualityChecks.d.ts","sourceRoot":"","sources":["../../src/formatters/qualityChecks.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAE5E,MAAM,MAAM,mBAAmB,GAAG,wBAAwB,CAAC,gBAAgB,CAAC,CAAC;AAC7E,MAAM,MAAM,qBAAqB,GAAG,wBAAwB,CAAC,yBAAyB,CAAC,CAAC;AACxF,MAAM,MAAM,eAAe,GAAG,wBAAwB,CAAC,mBAAmB,CAAC,CAAC;AA6C5E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAevE;AAWD,+HAA+H;AAC/H,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAqB3E;AAGD,oFAAoF;AACpF,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAMtC;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CA6B/D"}

package/dist/formatters/qualityChecks.js

@@ -0,0 +1,132 @@
+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; a frozen trip prints the kernel's words in its place. */
+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)}`;
+    const window = k.frozen
+        ?? `${w.fill} of ${w.of} non-self resolutions: unchanged ${w.accepted_unchanged}, edited ${w.accepted_edited}, discarded ${w.discarded}`;
+    return `  ${k.kind}: ${mode}; trip window ${window}; 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.');
+    // The contradiction ranker's harvest counter: the kernel writes the words, this file only prints them.
+    if (result.contradictionRanker)
+        lines.push(result.contradictionRanker.line);
+    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');
+}
+/** The table's text cut, so a row stays one line; --json carries the whole text. */
+export const CHECK_ROW_TEXT_CUT = 200;
+const day = (at) => new Date(at).toISOString().slice(0, 10);
+/** A count with its noun, singular for one: every count line below says it through this (RULE-705). */
+const count = (n, one, many = `${one}s`) => `${n} ${n === 1 ? one : many}`;
+const roleRef = (r, none) => (r ? `${r.name}${r.roleId ? ` (${r.roleId})` : ''}` : none);
+/**
+ * `pb quality checks --rows` (TASK-1328): the window first, by outcome over the writes checked (one door row a write; a late answer and an
+ * override are further rows beside them, RULE-17), the rows left out by why, how many rows the filters match, then one line per row
+ * ending in where its entry stands today (later: overridden, handed back, still draft, discarded, accepted or gone).
+ * Every outcome word and its order come from the kernel (RULE-664).
+ */
+export function formatCheckRows(result) {
+    const m = result.matching, w = result.window;
+    const outcomes = result.outcomes.map((o) => `${o} ${w.byOutcome[o]}`).join(', ');
+    const kinds = result.kinds.map((k) => `${k} ${w.byKind[k] ?? 0}`).join(', ');
+    const filters = [...(result.kind ? [`--kind ${result.kind}`] : []), ...(result.outcome ? [`--outcome ${result.outcome}`] : [])];
+    const until = new Date(result.until).toISOString();
+    const lines = [
+        `${result.checkKey} check, ${day(result.since)} to ${until}, ${result.kind ? `${result.kind} only` : 'every kind'}`,
+        `${count(w.writes, 'write')} checked in the window; rows by outcome: ${outcomes}; rows by kind: ${kinds}`,
+        `Beside the writes: ${count(w.late, 'late answer')} and ${count(w.overrides, 'override')}, each a second row for its write.`,
+        `Left out of the ${count(w.total, 'row')}: ${result.leftOutReasons.map((r) => `${r} ${w.leftOut[r]}`).join(', ')}`,
+    ];
+    if (filters.length)
+        lines.push(`${count(m.total, 'row matches', 'rows match')} ${filters.join(' ')}`);
+    if (result.readFrom !== null) {
+        const from = new Date(result.readFrom).toISOString();
+        lines.push(`The read stopped at its cap, so the window starts at ${from}. For the earlier rows, run again with --until ${from}.`);
+    }
+    lines.push(result.sample
+        ? `Sample: ${result.rows.length} of the ${m.total}, seed ${result.sample.seed}; the same draw again: --until ${until} --seed ${result.sample.seed}`
+        : `Newest ${result.rows.length} of the ${m.total}:`);
+    for (const r of result.rows) {
+        const p = r.probability === null ? 'p -' : `p ${r.probability.toFixed(2)}`;
+        const text = r.entry ? r.entry.text.replace(/\s+/g, ' ').trim() : '';
+        const cut = text.length > CHECK_ROW_TEXT_CUT ? `${text.slice(0, CHECK_ROW_TEXT_CUT)}...` : text;
+        lines.push(`${r.entryId ?? '(no entry id)'}  ${r.kind}  ${roleRef(r.actingRole, 'no acting role')}  named ${roleRef(r.namedRole, '-')}  ${p}  `
+            + `${r.outcome}${r.late ? ' (late)' : ''}  later ${r.later}${r.entry ? `  ${r.entry.name}: ${cut}` : ''}`);
+    }
+    if (result.rows.length === 0)
+        lines.push('No row matches. Widen the window with an earlier --since, or drop --kind or --outcome.');
+    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,90 @@
+export interface CreateResult {
+    entryId: string;
+    questionId?: string;
+    facetId: string;
+    status: 'escalated' | 'routed';
+    ownerRoleId: string;
+    ownerTeamId?: string;
+    ownerIsTeamLead?: boolean;
+    routingReason: string;
+    nudge?: string;
+}
+/** `roleOrLeadName` is the seat's name, resolved by the caller (`chain.getEntry` lookups; "Team Lead of <team>" for Team Lead) — 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;
+    ownerTeamId?: string;
+    ownerIsTeamLead?: boolean;
+}
+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' | '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 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;
+    /** The role the question is with (ROL-n), null while none owns it (DEC-2507: on every row of every list view). */
+    ownerRoleId?: string | null;
+    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;
+}
+/** `role` and `note` ride only the role view (`list --role`, TASK-1416): the note is the server's one sentence for a role read that is
+ *  not live, empty or cut, printed as sent (RULE-664). */
+export interface QuestionListResult {
+    questions: QuestionListRow[];
+    viewerPersonId: string;
+    truncated?: boolean;
+    role?: {
+        entryId?: string;
+        name: string;
+        live: boolean;
+    };
+    note?: string;
+}
+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":"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"}

package/dist/formatters/questions.js

@@ -0,0 +1,126 @@
+import { stripControlChars } from '../lib/strip.js';
+/**
+ * Human-formatted rendering for `pb question <verb>` (WP-638 S3, §7.7 of the routed-questions
+ * design spec). 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 the seat's name, resolved by the caller (`chain.getEntry` lookups; "Team Lead of <team>" for Team Lead) — 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 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 === 'force_closed') {
+            return `${singleLine(entryId)} is already processed (force-closed) — 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) {
+        // A role read says which role, in the server's words: "No open questions." would read as about the caller.
+        if (result.role)
+            return singleLine(result.note);
+        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 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.role
+        ? (result.note ? [singleLine(result.note)] : [])
+        : 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":""}