@productbrain/cli 0.1.0-beta.45 → 0.1.0-beta.4505

package/dist/formatters/session.d.ts

@@ -1,11 +1,123 @@
 /**
  * Session formatters — terminal output for session start / close.
+ *
+ * TEN-2370: session close must reflect the *server's* post-promote truth, not the
+ * local capture-time snapshot. `formatSessionClose` takes a `SessionCloseWrapup`
+ * (committed vs still-draft, from `agent.getSessionWrapup`) and renders the real
+ * loop status. `formatLoopUnfinished` renders the enforcement nudge when drafts
+ * remain (ASM-40) — the session is intentionally left open so the agent can
+ * promote and re-close.
  */
 import type { SessionState } from '../lib/session.js';
-export declare function formatSessionStart(session: SessionState, superseded?: {
-    previousSessionId: string;
-    startedAt: string;
-    initiatedBy: string;
+import { type SessionNotice } from '../lib/sessionNotices.js';
+import { type OrientView } from './orient.js';
+/** WP-582 B2 round 1 (Codex P2 review, PR #532, T10): the same three-line rituals surface orient
+ *  renders, reused verbatim (`buildRitualsSurfaceLines`) so close never invents its own copy. */
+export type SessionCloseRituals = Pick<OrientView, 'directionLine' | 'verdictAskLine' | 'spineLine'>;
+/** One entry as the server reports it in the wrapup (committed or draft). */
+export interface WrapupEntryRef {
+    entryId: string;
+    name: string;
+}
+/**
+ * Server-truth view of the session at close time. `null` when the wrapup read
+ * failed — callers fall back to the legacy local-snapshot rendering so an infra
+ * blip never blocks a close.
+ */
+export interface SessionCloseWrapup {
+    committed: WrapupEntryRef[];
+    drafts: WrapupEntryRef[];
+    /** Best-effort: count of pending domain-tag proposals (admin-gated; omitted when unavailable). */
+    pendingDomainProposals?: number;
+    /**
+     * Entries past OVERFLOW_SCAN_CAP the server did not enumerate (TEN-2370). A nonzero
+     * value means the draft set could not be fully read, so the gate fails CLOSED.
+     */
+    overflowUnscanned?: number;
+}
+/** The exact, copy-pasteable batch accept command for a set of draft IDs. WP-640 S4
+ *  (DEC-1578): `pb promote` retired — this is now `pb entry accept`, same server route. */
+export declare function buildPromoteCommand(entryIds: string[]): string;
+/**
+ * The session-start invite to send feedback. Agents pipe stdout, so they never see the pretty
+ * block this line lives in — every session-start JSON payload carries it as `feedbackHint` too.
+ * One constant, because a hint that reaches only TTY users reaches ~1% of this CLI's callers.
+ */
+export declare const FEEDBACK_SUBMIT_HINT = "Friction or ideas? `pb feedback submit -c <bug|friction|idea|praise|other> \"<message>\"` \u2014 describe how pb behaved, not your workspace content. Once screening completes, it enters the builders' triage queue.";
+/**
+ * WP-584 S4 (FEAT-1412 / TEN-2971): the legacy plain-text "Feedback queue: N new..." line lived
+ * here — an agent skimming stdout read right past it (dogfood 2026-08-02: the agent never told
+ * the user). It is now the `feedback-queue` spine notice (until-resolved, standing state
+ * — see convex/lib/notices/feedbackQueueProducer.ts), rendered structurally through the SAME
+ * `notices` block below every other spine notice already uses. The raw `feedbackQueueNew` /
+ * `feedbackOldestNewAt` fields stay on the wire response (S1 contract item 7, published
+ * clients) — this formatter just no longer RENDERS a bespoke line from them.
+ */
+export declare function formatSessionStart(session: SessionState, activeProfile?: string | null, feedback?: {
+    notices?: SessionNotice[];
+    adoptDiscoveryHint?: string;
 }): string;
-export declare function formatSessionClose(session: SessionState): string;
+/**
+ * The already-active status report — `pb session start` when this conversation's local marker is
+ * still live. The branch is deliberately kernel-call-free (offline-safe; see commands/session.ts),
+ * so no spine notice (including the feedback-queue standing notice) can ride it — those
+ * need server data every other start path gets from `agent.startSession`/`agent.resumeSession`.
+ * The invite is a static constant and rides every session start, this one included (its JSON
+ * twin carries the same string as `feedbackHint`).
+ */
+export declare function formatSessionAlreadyActive(session: SessionState): string;
+export declare function formatSessionClose(session: SessionState, wrapup: SessionCloseWrapup | null, workspaceSlug?: string | null, appUrl?: string | null, rituals?: SessionCloseRituals | null): string;
+/**
+ * The enforcement nudge (ASM-40 / TEN-2370): drafts remain and the operator did
+ * not pass --force. The session is left OPEN — this output tells them how to
+ * finish the loop (promote) and how to escape (--force). It must never imply the
+ * session was closed.
+ */
+export declare function formatLoopUnfinished(wrapup: SessionCloseWrapup): string;
+/** One session row as returned by `agent.listSessions` / carried in `agent.showConversation`. */
+export interface SessionListRow {
+    sessionId: string;
+    conversationId: string | null;
+    label: string | null;
+    clientKind: string | null;
+    initiatedBy: string;
+    status: string;
+    startedAt: number;
+    lastToolCallAt: number;
+    entriesCreatedCount: number;
+    entriesModifiedCount: number;
+    purpose: string | null;
+}
+export interface SessionListData {
+    active: SessionListRow[];
+    recent: SessionListRow[];
+    quota: {
+        activeCount: number;
+        cap: number;
+    };
+}
+/** A lineage row as returned by `agent.showConversation` — SessionListRow plus per-session activity detail. */
+export interface ShowLineageRow extends SessionListRow {
+    entriesCreated: string[];
+    entriesModified: string[];
+    relationsCreated: number;
+    gateFailures: number;
+    contradictionWarnings: number;
+}
+/** One governanceServedLog row surfaced by `agent.showConversation`. */
+export interface ShowServeRow {
+    servedAt: number;
+    entryId: string;
+    surface: string;
+    renderMode: string | null;
+    task: string | null;
+    sessionId: string | null;
+}
+export interface ShowConversationData {
+    conversationId: string | null;
+    sessions: ShowLineageRow[];
+    serves: ShowServeRow[];
+}
+export declare function formatSessionList(data: SessionListData): string;
+export declare function formatSessionShow(data: ShowConversationData): string;
 //# sourceMappingURL=session.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/formatters/session.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,YAAY,EACrB,UAAU,CAAC,EAAE;IAAE,iBAAiB,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACjF,MAAM,CAmBR;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAqBhE"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/formatters/session.ts"],"names":[],"mappings":"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"}

package/dist/formatters/session.js

@@ -1,40 +1,219 @@
 /**
  * Session formatters — terminal output for session start / close.
+ *
+ * TEN-2370: session close must reflect the *server's* post-promote truth, not the
+ * local capture-time snapshot. `formatSessionClose` takes a `SessionCloseWrapup`
+ * (committed vs still-draft, from `agent.getSessionWrapup`) and renders the real
+ * loop status. `formatLoopUnfinished` renders the enforcement nudge when drafts
+ * remain (ASM-40) — the session is intentionally left open so the agent can
+ * promote and re-close.
  */
-export function formatSessionStart(session, superseded) {
+import { stripControlChars } from '../lib/strip.js';
+import { formatSessionNoticeLines, formatAdoptDiscoveryLine } from '../lib/sessionNotices.js';
+import { buildRitualsSurfaceLines } from './orient.js';
+/** Shared: append the truncation notice when the server could not enumerate every entry. */
+function pushOverflowUnscannedNotice(lines, unscanned) {
+    if (unscanned && unscanned > 0) {
+        lines.push('');
+        lines.push(`Plus ${unscanned} more entr${unscanned === 1 ? 'y' : 'ies'} this session that couldn't be enumerated — ` +
+            `promote/commit them in Cortex, or re-run with --force to close anyway.`);
+    }
+}
+/** The exact, copy-pasteable batch accept command for a set of draft IDs. WP-640 S4
+ *  (DEC-1578): `pb promote` retired — this is now `pb entry accept`, same server route. */
+export function buildPromoteCommand(entryIds) {
+    return `pb entry accept ${entryIds.join(' ')}`;
+}
+/**
+ * The session-start invite to send feedback. Agents pipe stdout, so they never see the pretty
+ * block this line lives in — every session-start JSON payload carries it as `feedbackHint` too.
+ * One constant, because a hint that reaches only TTY users reaches ~1% of this CLI's callers.
+ */
+export const FEEDBACK_SUBMIT_HINT = 'Friction or ideas? `pb feedback submit -c <bug|friction|idea|praise|other> "<message>"` — describe how pb behaved, not your workspace content. Once screening completes, it enters the builders\' triage queue.';
+/**
+ * WP-584 S4 (FEAT-1412 / TEN-2971): the legacy plain-text "Feedback queue: N new..." line lived
+ * here — an agent skimming stdout read right past it (dogfood 2026-08-02: the agent never told
+ * the user). It is now the `feedback-queue` spine notice (until-resolved, standing state
+ * — see convex/lib/notices/feedbackQueueProducer.ts), rendered structurally through the SAME
+ * `notices` block below every other spine notice already uses. The raw `feedbackQueueNew` /
+ * `feedbackOldestNewAt` fields stay on the wire response (S1 contract item 7, published
+ * clients) — this formatter just no longer RENDERS a bespoke line from them.
+ */
+export function formatSessionStart(session, activeProfile, feedback) {
     const lines = [];
     lines.push('');
     lines.push(`Session started: ${session.sessionId}`);
     lines.push(`Workspace: ${session.workspaceName}`);
+    if (activeProfile)
+        lines.push(`Profile: ${activeProfile}`);
     lines.push(`Time: ${session.startedAt}`);
-    if (superseded) {
+    // FEAT-1409 spine core: low-severity notices never take the headline (HARD CONSTRAINT 14) —
+    // rendered as plain lines below the session banner, never a top-of-output interrupt.
+    const noticeLines = formatSessionNoticeLines(feedback?.notices);
+    if (noticeLines.length > 0) {
+        lines.push('');
+        lines.push('Notices:');
+        lines.push(...noticeLines);
+    }
+    // WP-638 S4 (§10.3) — the bounded adopt-discovery advisory: silent at zero (the server omits
+    // the field entirely rather than sending a "0" line).
+    const adoptLines = formatAdoptDiscoveryLine(feedback?.adoptDiscoveryHint);
+    if (adoptLines.length > 0) {
         lines.push('');
-        lines.push(`Note: superseded previous session ${superseded.previousSessionId}`);
-        lines.push(`  Started: ${superseded.startedAt} by ${superseded.initiatedBy}`);
+        lines.push(...adoptLines);
     }
     lines.push('');
     lines.push('You now have write access. Use `pb capture "<text>"` to capture knowledge.');
+    lines.push(FEEDBACK_SUBMIT_HINT);
     lines.push('Run `pb session close` when done.');
     return lines.join('\n');
 }
-export function formatSessionClose(session) {
+/**
+ * The already-active status report — `pb session start` when this conversation's local marker is
+ * still live. The branch is deliberately kernel-call-free (offline-safe; see commands/session.ts),
+ * so no spine notice (including the feedback-queue standing notice) can ride it — those
+ * need server data every other start path gets from `agent.startSession`/`agent.resumeSession`.
+ * The invite is a static constant and rides every session start, this one included (its JSON
+ * twin carries the same string as `feedbackHint`).
+ */
+export function formatSessionAlreadyActive(session) {
+    const lines = [];
+    lines.push(`Session already active: ${session.sessionId}`);
+    lines.push(`Started: ${session.startedAt}`);
+    lines.push(`Entries captured: ${session.entriesCaptured.length}`);
+    lines.push('');
+    lines.push(FEEDBACK_SUBMIT_HINT);
+    lines.push('Run `pb session close` to end it, or `pb session close --force` to force-close.');
+    return lines.join('\n');
+}
+/** Shared: append the pending domain-tag proposal advisory + review hint when present. */
+function pushDomainProposalHint(lines, pending) {
+    if (pending && pending > 0) {
+        lines.push('');
+        lines.push(`${pending} pending domain-tag proposal${pending === 1 ? '' : 's'} awaiting review — run \`pb authority-domains review\`.`);
+    }
+}
+/** Shared: append the exact-session ratify deep link (or generic fallback) when entries exist. */
+function pushRatifyHandoff(lines, session, workspaceSlug, appUrl) {
+    lines.push('');
+    if (workspaceSlug && appUrl) {
+        // WP-455 E4: hand off to the exact-session ratify page while context is fresh.
+        // The ?sessionId pins this session so the page never relies on its fallback. The
+        // caller resolves `appUrl` so it always matches the bound deployment — suppressed
+        // (null) when preview-bound without an explicit host, so we never print a prod link
+        // pointing at a preview session (Codex P2, PR #151).
+        lines.push('Ratify these captures while fresh:');
+        lines.push(`  ${appUrl}/w/${workspaceSlug}/bridge/session-close?sessionId=${session.sessionId}`);
+    }
+    else {
+        lines.push('Review and commit drafts in Cortex, or via MCP.');
+    }
+}
+export function formatSessionClose(session, wrapup, workspaceSlug, appUrl, rituals) {
     const lines = [];
-    const count = session.entriesCaptured.length;
     lines.push('');
     lines.push('Session closed.');
     lines.push(`Duration: ${formatDuration(session.startedAt)}`);
-    if (count > 0) {
+    // WP-582 B2 round 1 (Codex P2 review, PR #532, T10): the governing B2 spec names "orient +
+    // session close" — render the same compact direction/verdict-ask/spine lines here so closing
+    // a session surfaces the same state-of-the-world nudge orient does. `rituals` is optional
+    // (read is best-effort, non-critical — see commands/session.ts) so a fetch failure never
+    // blocks or corrupts the close output; when absent, this block is silently skipped rather
+    // than rendering the no-row fallback text (that fallback belongs to a genuine no-row arm,
+    // not a close-time read we chose not to attempt).
+    if (rituals) {
+        lines.push(...buildRitualsSurfaceLines(rituals));
+    }
+    // Legacy path: server wrapup unavailable — render from the local capture snapshot.
+    if (!wrapup) {
+        const count = session.entriesCaptured.length;
+        if (count > 0) {
+            lines.push('');
+            lines.push(`Entries captured: ${count} (all as drafts)`);
+            for (const id of session.entriesCaptured) {
+                lines.push(`  • ${id}`);
+            }
+            pushRatifyHandoff(lines, session, workspaceSlug, appUrl);
+        }
+        else {
+            lines.push('No entries captured this session.');
+        }
+        return lines.join('\n');
+    }
+    // Server-truth path (TEN-2370).
+    const { committed, drafts } = wrapup;
+    const unscanned = wrapup.overflowUnscanned ?? 0;
+    if (committed.length === 0 && drafts.length === 0 && unscanned === 0) {
+        lines.push('No entries captured this session.');
+        return lines.join('\n');
+    }
+    // Committed list renders BEFORE the status line so a committed entry never
+    // appears after the word "draft" — it is, definitively, no longer a draft.
+    if (committed.length > 0) {
         lines.push('');
-        lines.push(`Entries captured: ${count} (all as drafts)`);
-        for (const id of session.entriesCaptured) {
-            lines.push(`  • ${id}`);
+        lines.push('Committed to the Chain this session:');
+        for (const e of committed) {
+            lines.push(`  ✓ ${e.entryId} — ${e.name}`);
         }
+    }
+    lines.push('');
+    lines.push(`Loop status: ${committed.length} committed, ${drafts.length} still draft.`);
+    if (drafts.length > 0) {
         lines.push('');
-        lines.push('Review and commit drafts in Product Brain Studio, or via MCP.');
+        lines.push('Still draft — not in SSOT:');
+        for (const e of drafts) {
+            lines.push(`  • ${e.entryId} — ${e.name}`);
+        }
+        lines.push('');
+        lines.push('Closed with uncommitted drafts. Promote them later with:');
+        lines.push(`  ${buildPromoteCommand(drafts.map((d) => d.entryId))}`);
+    }
+    pushOverflowUnscannedNotice(lines, wrapup.overflowUnscanned);
+    pushDomainProposalHint(lines, wrapup.pendingDomainProposals);
+    pushRatifyHandoff(lines, session, workspaceSlug, appUrl);
+    return lines.join('\n');
+}
+/**
+ * The enforcement nudge (ASM-40 / TEN-2370): drafts remain and the operator did
+ * not pass --force. The session is left OPEN — this output tells them how to
+ * finish the loop (promote) and how to escape (--force). It must never imply the
+ * session was closed.
+ */
+export function formatLoopUnfinished(wrapup) {
+    const lines = [];
+    const { committed, drafts } = wrapup;
+    lines.push('');
+    if (drafts.length > 0) {
+        lines.push(`Session NOT closed — ${drafts.length} draft${drafts.length === 1 ? '' : 's'} still uncommitted to the Chain.`);
     }
     else {
-        lines.push('No entries captured this session.');
+        // Gate fired on unread overflow alone — the draft set couldn't be fully enumerated.
+        lines.push('Session NOT closed — the full draft set could not be read (too many entries this session).');
+    }
+    if (committed.length > 0) {
+        lines.push(`(${committed.length} already committed this session.)`);
+    }
+    if (drafts.length > 0) {
+        lines.push('');
+        lines.push('Still draft — not in SSOT:');
+        for (const e of drafts) {
+            lines.push(`  • ${e.entryId} — ${e.name}`);
+        }
+        lines.push('');
+        lines.push('Finish the loop — promote these drafts:');
+        lines.push(`  ${buildPromoteCommand(drafts.map((d) => d.entryId))}`);
+        lines.push('Then re-run `pb session close`. To close anyway: `pb session close --force`.');
+        // In governance/consensus workspaces a promote opens a proposal instead of committing,
+        // so the draft stays draft until the proposal is approved — re-running promote alone
+        // would just re-open the gate. Point those operators at approval / --force so the nudge
+        // is honest there too, not only in direct-commit workspaces (Codex P2, PR #196).
+        lines.push('(Governance workspaces: a promote opens a proposal — approve it in Cortex, or use --force to close now.)');
     }
+    else {
+        lines.push('Promote/commit them in Cortex, or re-run `pb session close --force` to close anyway.');
+    }
+    pushOverflowUnscannedNotice(lines, wrapup.overflowUnscanned);
+    pushDomainProposalHint(lines, wrapup.pendingDomainProposals);
     return lines.join('\n');
 }
 function formatDuration(startedAt) {
@@ -48,4 +227,114 @@ function formatDuration(startedAt) {
     const rem = mins % 60;
     return rem > 0 ? `${hrs}h ${rem}m` : `${hrs}h`;
 }
+/** Relative "Nm/h/d ago" — mirrors formatters/brief.ts + formatters/changes.ts (no shared util exists for this). */
+function formatTimeAgo(ts) {
+    const diff = Date.now() - ts;
+    if (diff < 60_000)
+        return 'just now';
+    if (diff < 3_600_000)
+        return `${Math.floor(diff / 60_000)}m ago`;
+    if (diff < 86_400_000)
+        return `${Math.floor(diff / 3_600_000)}h ago`;
+    return `${Math.floor(diff / 86_400_000)}d ago`;
+}
+/** Truncate a (possibly long, e.g. sha256) conversationId for the human table — full value always ships in --json. */
+function truncateConversationId(id, max = 12) {
+    if (!id)
+        return '—';
+    const safe = stripControlChars(id);
+    return safe.length > max ? `${safe.slice(0, max)}…` : safe;
+}
+/**
+ * Label-collision cue (design spec Pass 3): when ≥2 ACTIVE rows share a label, the founder can no
+ * longer tell them apart by label alone — append a disambiguating ordinal, oldest-first, so the
+ * cue is stable across repeated `list` calls (a newly-started sibling never renumbers an existing
+ * one). Only active rows participate — a closed/orphaned row from a past resume window sharing a
+ * worktree name with a live one isn't a real ambiguity for the founder right now.
+ */
+function labelCollisionCues(activeRows) {
+    const bySessionId = new Map();
+    const groups = new Map();
+    for (const r of activeRows) {
+        if (!r.label)
+            continue;
+        const g = groups.get(r.label) ?? [];
+        g.push(r);
+        groups.set(r.label, g);
+    }
+    for (const [label, group] of groups) {
+        if (group.length < 2)
+            continue;
+        const sorted = [...group].sort((a, b) => a.startedAt - b.startedAt);
+        sorted.forEach((r, i) => {
+            bySessionId.set(r.sessionId, `${label} (${i + 1})`);
+        });
+    }
+    return bySessionId;
+}
+function renderSessionRow(r, displayLabel) {
+    const conv = truncateConversationId(r.conversationId);
+    const activity = `${r.entriesCreatedCount}c/${r.entriesModifiedCount}m`;
+    return (`  ${r.sessionId}  ${conv.padEnd(13)} ${displayLabel.padEnd(24)} ${r.status.padEnd(9)} ` +
+        `${formatTimeAgo(r.startedAt).padEnd(10)} ${activity}`);
+}
+export function formatSessionList(data) {
+    const lines = [];
+    lines.push(`Quota: ${data.quota.activeCount} of ${data.quota.cap} active`);
+    lines.push('');
+    if (data.active.length === 0) {
+        lines.push('No active sessions.');
+    }
+    else {
+        lines.push(`Active (${data.active.length}):`);
+        lines.push(`  ${'SESSION ID'.padEnd(24)}${'CONV ID'.padEnd(14)}${'LABEL'.padEnd(25)}${'STATUS'.padEnd(10)}${'STARTED'.padEnd(11)}ENTRIES`);
+        const cues = labelCollisionCues(data.active);
+        for (const r of data.active) {
+            const displayLabel = cues.get(r.sessionId) ?? (r.label ? stripControlChars(r.label) : '—');
+            lines.push(renderSessionRow(r, displayLabel));
+        }
+    }
+    if (data.recent.length > 0) {
+        lines.push('');
+        lines.push(`Recent (${data.recent.length}):`);
+        for (const r of data.recent) {
+            const displayLabel = r.label ? stripControlChars(r.label) : '—';
+            lines.push(renderSessionRow(r, displayLabel));
+        }
+    }
+    lines.push('');
+    lines.push('Show a conversation\'s full lineage: pb session show <session-id-or-conversation-id>');
+    return lines.join('\n');
+}
+const SHOW_SERVES_DISPLAY_LIMIT = 10;
+export function formatSessionShow(data) {
+    const lines = [];
+    const first = data.sessions[0];
+    const label = first?.label ? stripControlChars(first.label) : null;
+    lines.push(`Conversation: ${data.conversationId ?? '(legacy — no conversationId)'}`);
+    if (label)
+        lines.push(`Label: ${label}`);
+    lines.push(`${data.sessions.length} session(s) in lineage`);
+    lines.push('');
+    for (const s of data.sessions) {
+        lines.push(`  ${s.sessionId}  [${s.status}]  started ${formatTimeAgo(s.startedAt)}`);
+        lines.push(`    Created: ${s.entriesCreated.length ? s.entriesCreated.join(', ') : '—'}`);
+        lines.push(`    Modified: ${s.entriesModified.length ? s.entriesModified.join(', ') : '—'}`);
+        lines.push(`    Relations: ${s.relationsCreated}  Gate failures: ${s.gateFailures}  Contradictions: ${s.contradictionWarnings}`);
+    }
+    lines.push('');
+    const shown = data.serves.slice(0, SHOW_SERVES_DISPLAY_LIMIT);
+    lines.push(`Serves (${shown.length} of ${data.serves.length} shown, most recent first):`);
+    if (shown.length === 0) {
+        lines.push('  No governance serves recorded for this conversation.');
+    }
+    else {
+        for (const serve of shown) {
+            const task = serve.task ? ` task="${stripControlChars(serve.task)}"` : '';
+            const sessionRef = serve.sessionId ? ` session=${serve.sessionId}` : '';
+            lines.push(`  ${formatTimeAgo(serve.servedAt).padEnd(10)} ${serve.entryId.padEnd(10)} ${(serve.renderMode ?? '—').padEnd(8)}${task}${sessionRef}`);
+        }
+    }
+    return lines.join('\n');
+}
 //# sourceMappingURL=session.js.map

package/dist/formatters/session.js.map

@@ -1 +1 @@
-{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/formatters/session.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,UAAU,kBAAkB,CAChC,OAAqB,EACrB,UAAkF;IAElF,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,oBAAoB,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACpD,KAAK,CAAC,IAAI,CAAC,cAAc,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAClD,KAAK,CAAC,IAAI,CAAC,SAAS,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAEzC,IAAI,UAAU,EAAE,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,qCAAqC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;QAChF,KAAK,CAAC,IAAI,CAAC,cAAc,UAAU,CAAC,SAAS,OAAO,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;IAChF,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,4EAA4E,CAAC,CAAC;IACzF,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;IAEhD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAqB;IACtD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC;IAE7C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC9B,KAAK,CAAC,IAAI,CAAC,aAAa,cAAc,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAE7D,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,qBAAqB,KAAK,kBAAkB,CAAC,CAAC;QACzD,KAAK,MAAM,EAAE,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;YACzC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC1B,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;IAC9E,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,cAAc,CAAC,SAAiB;IACvC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;IACtD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC;IACpC,IAAI,IAAI,GAAG,CAAC;QAAE,OAAO,oBAAoB,CAAC;IAC1C,IAAI,IAAI,GAAG,EAAE;QAAE,OAAO,GAAG,IAAI,GAAG,CAAC;IACjC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;IAClC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;IACtB,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC;AACjD,CAAC"}
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/formatters/session.ts"],"names":[],"mappings":"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"}

package/dist/formatters/shape.d.ts

@@ -0,0 +1,54 @@
+export interface ShapeAdvisoryItem {
+    /** Non-underscore twin of the row's `_id` (TEN-340) — the field `pb shape show`/`agree`/
+     *  `dismiss` target. */
+    id: string;
+    outcome: 'not_candidate' | 'atomic' | 'compound' | 'unavailable' | 'reserved';
+    disposition: 'pending' | 'agreed' | 'dismissed' | 'expired';
+    subjectEntryId: string;
+    collectionSlug: string;
+    source: string;
+    confidence?: number;
+    reason?: string;
+    gateDisposition?: string;
+    unavailableReason?: string;
+    at: number;
+    dispositionAt?: number;
+    dispositionBy?: {
+        kind: 'human' | 'agent' | 'system';
+        personId?: string;
+        agentId?: string;
+    };
+    dispositionReason?: string;
+    proposedAtoms?: Array<{
+        title: string;
+        concern: string;
+        bodyExcerpt: string;
+        suggestedCollection?: string;
+    }>;
+    proposedLinks?: Array<{
+        fromIdx: number;
+        toIdx: number;
+        relation: string;
+    }>;
+    [key: string]: unknown;
+}
+export declare function formatShapeAdvisoryItem(item: ShapeAdvisoryItem, now?: number): string;
+/**
+ * WP-571 sweep fix (review finding on PR #513/#517): `truncated` surfaces the backend's
+ * LIST_SCAN_CAP safety-bound signal (`convex/shape/listAdvisories.ts`) — without it, a short
+ * or empty list was indistinguishable from "no more advisories exist" vs. "the scan gave up
+ * at the cap before finding enough." Optional + defaulted false so every pre-existing call
+ * site (and both formatter tests) keeps working unchanged.
+ */
+export declare function formatShapeAdvisoriesList(items: ShapeAdvisoryItem[], now?: number, truncated?: boolean): string;
+export declare function formatShapeAdvisoryShow(item: ShapeAdvisoryItem | null): string;
+export interface ShapeDispositionReceipt {
+    rowId: string;
+    disposition: 'agreed' | 'dismissed';
+    dispositionBy: {
+        kind: 'human' | 'agent';
+        personId?: string;
+    };
+}
+export declare function formatShapeDispositionReceipt(value: ShapeDispositionReceipt): string;
+//# sourceMappingURL=shape.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shape.d.ts","sourceRoot":"","sources":["../../src/formatters/shape.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,iBAAiB;IAChC;4BACwB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,eAAe,GAAG,QAAQ,GAAG,UAAU,GAAG,aAAa,GAAG,UAAU,CAAC;IAC9E,WAAW,EAAE,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAC;IAC5D,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE;QAAE,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5F,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7G,aAAa,CAAC,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5E,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAeD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,iBAAiB,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAKrF;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,iBAAiB,EAAE,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,SAAS,UAAQ,GAAG,MAAM,CAO7G;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI,GAAG,MAAM,CAqC9E;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,QAAQ,GAAG,WAAW,CAAC;IACpC,aAAa,EAAE;QAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/D;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,uBAAuB,GAAG,MAAM,CAKpF"}