@pugi/cli 0.1.0-beta.9 → 0.1.0-beta.90

package/dist/tui/repl.js

@@ -1,12 +1,12 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 /**
- * REPL root component - Sprint α5.7 (ADR-0056 PR-PUGI-CLI-REPL-DEFAULT).
+ * REPL root component - Sprint .
  *
  * Three-zone layout:
  *
- *   header   - `Pugi.io · workspace: <name> · v<X> on watch`
- *   main     - conversation pane (top half) + agent tree (bottom half)
- *   footer   - input box + status bar + key hints
+ *  header  - `Pugi.io · workspace: <name> · v<X> on watch`
+ *  main    - conversation pane (top half) + agent tree (bottom half)
+ *  footer  - input box + status bar + key hints
  *
  * The component subscribes to a ReplSession instance for state. It does
  * NOT own the SSE client or the transport - the session module does.
@@ -26,14 +26,17 @@ import { ConversationPane } from './conversation-pane.js';
 import { InputBox } from './input-box.js';
 import { ReplSplash } from './repl-splash.js';
 import { StatusBar } from './status-bar.js';
+import { ThinkingSpinner } from './thinking-spinner.js';
 import { ToolStreamPane } from './tool-stream-pane.js';
 import { UpdateBanner } from './update-banner.js';
+import { WelcomeBanner } from './welcome-banner.js';
 import { collectWorkspaceContext } from './workspace-context.js';
+import { useTheme } from '../core/theme/context.js';
 import { slugForCwd } from '../core/repl/history.js';
 import { SLASH_COMMAND_HELP, SLASH_COMMAND_GROUPS } from '../core/repl/slash-commands.js';
 const TICK_INTERVAL_MS = 200;
 const PULSE_INTERVAL_MS = 700;
-// α6.12: maximum transcript rows the conversation pane renders at once.
+// : maximum transcript rows the conversation pane renders at once.
 // Older rows scroll off the top; full history stays in session state.
 const CONVERSATION_WINDOW = 12;
 export function Repl(props) {
@@ -41,22 +44,28 @@ export function Repl(props) {
     const [overlay, setOverlay] = useState('none');
     const [pulsePhase, setPulsePhase] = useState(0);
     const [tickNow, setTickNow] = useState((props.now ?? Date.now)());
-    // α6.12: operator-driven collapse for the tool stream pane. The CLI
+    // : operator-driven collapse for the tool stream pane. The CLI
     // host can hide the pane entirely via `--no-tool-stream`; this state
     // is the runtime toggle (Ctrl+T) for operators who want the pane on
     // screen but folded to a single row while they read a long reply.
     const [toolStreamCollapsed, setToolStreamCollapsed] = useState(false);
-    // α6.14 wave 3: boot splash visible until first input, first
+    // wave 3: boot splash visible until first input, first
     // `agent.spawned` event, or 10s idle. The host gates the initial
     // visibility on `--no-splash` / PUGI_SKIP_SPLASH via `skipSplash`.
-    // α6.14.6 CEO dogfood 2026-05-25: default splash to HIDDEN at boot
-    // (parity with Claude Code's minimal one-line banner). Operator can
+    // CEO dogfood: default splash to HIDDEN at boot
+    // (parity with the upstream tool's minimal one-line banner). Operator can
     // opt back in via `/splash` slash. The chafa pug pre-print + header
     // line already give the brand cue without the multi-row Plan/Model/
     // Tenant block crowding the top.
     const [splashVisible, setSplashVisible] = useState(false);
     const dismissSplash = useCallback(() => setSplashVisible(false), []);
-    // α6.14 wave 3: workspace context snapshot for the status bar. We
+    // CEO P0 #2 : welcome banner. Visible from boot
+    // until the operator submits the first brief OR the session emits
+    // its first agent event. The host owns dismissal lifecycle (kept
+    // symmetric with the splash) so the welcome card never lingers
+    // behind а live transcript.
+    const [welcomeVisible, setWelcomeVisible] = useState(Boolean(props.welcomeData));
+    // wave 3: workspace context snapshot for the status bar. We
     // read once at mount and freeze; a brand-new PUGI.md or skill is
     // surfaced on the next REPL boot rather than via a watcher.
     const workspaceContext = useMemo(() => props.workspaceContext ?? collectWorkspaceContext(process.cwd()), [props.workspaceContext]);
@@ -88,9 +97,9 @@ export function Repl(props) {
     useEffect(() => {
         props.onOverlayChange?.(overlay);
     }, [overlay, props]);
-    // α6.14 wave 3: dismiss the boot splash once the first agent spawns
+    // wave 3: dismiss the boot splash once the first agent spawns
     // (the operator has clearly engaged the system) or the transcript
-    // gains a row. Mirrors the natural attention shift Claude Code /
+    // gains a row. Mirrors the natural attention shift the upstream tool /
     // Codex / Gemini CLI all do on their boot screens.
     useEffect(() => {
         if (!splashVisible)
@@ -99,6 +108,20 @@ export function Repl(props) {
             setSplashVisible(false);
         }
     }, [splashVisible, state.agents.length, state.transcript.length]);
+    // CEO P0 #2 v2: welcome banner stays until the operator
+    // actively engages the loop — first agent spawn. Boot-time auto-init
+    // emits system rows into `state.transcript` (skip-trust hints, dirty
+    // tree warnings) which used к dismiss the banner within ~2s, hiding
+    // the brand mascot before the operator could read it. Drop the
+    // `transcript.length` trigger; agent spawn (= real dispatch) remains
+    // the sole signal that the operator stopped reading the banner.
+    useEffect(() => {
+        if (!welcomeVisible)
+            return;
+        if (state.agents.length > 0) {
+            setWelcomeVisible(false);
+        }
+    }, [welcomeVisible, state.agents.length]);
     const personaNames = useMemo(() => buildPersonaNameMap(), []);
     const { exit } = useApp();
     const handleSubmit = useCallback((line) => {
@@ -106,6 +129,10 @@ export function Repl(props) {
         // `setSplashVisible(false)` is a no-op once the state already
         // settled to false (timer fired or `agent.spawned` arrived).
         setSplashVisible(false);
+        // CEO P0 #2 : same dismissal for the welcome banner
+        // — the operator engaging the input box is the cleanest signal
+        // they have finished reading the boot card.
+        setWelcomeVisible(false);
         // Run async without awaiting - the session module owns the
         // network call, errors land in the transcript automatically.
         void props.session.handleInput(line).then((verdict) => {
@@ -137,7 +164,7 @@ export function Repl(props) {
             setOverlay('none');
         }
     }, { isActive: overlay === 'help' || overlay === 'roster' });
-    // α6.12: Ctrl+T toggles the tool stream pane between expanded and
+    // : Ctrl+T toggles the tool stream pane between expanded and
     // collapsed states. Active only while no overlay is open, so the
     // toggle never fights the help/roster dismiss handler. The input box
     // owns its own raw-input mode, so this listener only fires on the
@@ -147,7 +174,7 @@ export function Repl(props) {
             setToolStreamCollapsed((prev) => !prev);
         }
     }, { isActive: overlay === 'none' && props.hideToolStream !== true });
-    // α6.3 office-hours: a pending ask or plan-review modal pauses input
+    // office-hours: a pending ask or plan-review modal pauses input
     // until the operator resolves it. The modal owns its own useInput
     // hook, so the InputBox unmounts while a modal is open to avoid two
     // raw-input listeners competing for the same keystroke. Resolution
@@ -161,29 +188,69 @@ export function Repl(props) {
     const handlePlanReviewResolve = useCallback((result) => {
         void props.session.resolvePlanReview(result);
     }, [props.session]);
-    // α6.9: Ctrl+C abort handler. Forwards to ReplSession.cancel() which
+    // : Ctrl+C abort handler. Forwards to ReplSession.cancel() which
     // aborts the in-flight dispatch, closes the SSE stream, and surfaces
     // "Aborted." in the transcript.
     //
     // Return contract (consumed by InputBox):
-    //   - true        - dispatch was cancelled (keep the buffer + DO arm
-    //                   the press-again-to-exit timer; second Ctrl+C in
-    //                   the window exits).
-    //   - false       - idle / nothing to cancel (legacy: clear buffer +
-    //                   arm the exit timer so the operator sees the hint
-    //                   and can confirm exit on the next press).
-    //   - undefined   - bypassed entirely (e.g. a modal owns the input).
-    //                   InputBox MUST NOT arm the exit timer and MUST
-    //                   NOT clear the buffer. P2 fix: previously this
-    //                   returned `false` and the buffer-clear path wiped
-    //                   the operator's mid-typed modal text on the first
-    //                   Ctrl+C, costing a press of work.
+    //  - true       - dispatch was cancelled (keep the buffer + DO arm
+    //                  the press-again-to-exit timer; second Ctrl+C in
+    //                  the window exits).
+    //  - false      - idle / nothing to cancel (legacy: clear buffer +
+    //                  arm the exit timer so the operator sees the hint
+    //                  and can confirm exit on the next press).
+    //  - undefined  - bypassed entirely (e.g. a modal owns the input).
+    //                  InputBox MUST NOT arm the exit timer and MUST
+    //                  NOT clear the buffer. P2 fix: previously this
+    //                  returned `false` and the buffer-clear path wiped
+    //                  the operator's mid-typed modal text on the first
+    //                  Ctrl+C, costing a press of work.
     const handleCancel = useCallback(() => {
         if (modalActive)
             return undefined;
         return props.session.cancel();
     }, [props.session, modalActive]);
-    // α6.14.5 CEO dogfood 2026-05-25 (parity with Claude Code): input
+    // BT 8 (the upstream tool parity): Esc-Esc walkback. Forwards to
+    // ReplSession.walkbackLastTurn which trims the trailing operator
+    // turn + its persona response from the in-memory transcript. Returns
+    // `'walked-back'` so the input box knows the host did the work;
+    // `'nothing'` covers both the empty-transcript and dispatch-in-flight
+    // refusals (the session module owns the refusal copy in both cases).
+    const handleWalkback = useCallback(() => {
+        if (modalActive)
+            return 'nothing';
+        const verdict = props.session.walkbackLastTurn();
+        return verdict === 'walked-back' ? 'walked-back' : 'nothing';
+    }, [props.session, modalActive]);
+    // — Shift+Tab cycles the 6 canonical permission modes (CC
+    // parity). Refuses while a modal is active so the operator does not
+    // accidentally flip mode mid-prompt; otherwise resolves the current
+    // mode through the workspace > global > default merge, advances via
+    // `nextPermissionMode`, и persists к .pugi/session.json. Returns the
+    // new mode string so the InputBox can flash a one-line toast.
+    const handleCyclePermissionMode = useCallback(() => {
+        if (modalActive)
+            return null;
+        try {
+            // Lazy-require так this code path doesn't drag the permissions
+            // module into the splash + boot stages where it isn't needed.
+            // The require is sync but the inner work is pure JSON IO.
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const perm = require('../core/permissions/index.js');
+            const workspaceRoot = process.cwd();
+            const current = perm.resolveMode({ workspaceRoot });
+            const next = perm.nextPermissionMode(current);
+            perm.setCurrentMode(workspaceRoot, next);
+            return next;
+        }
+        catch {
+            // Persistence is best-effort — if .pugi/session.json is read-only
+            // или ENOENT-on-parent the toast is suppressed so we don't lie
+            // about the flip к the operator.
+            return null;
+        }
+    }, [modalActive]);
+    // CEO dogfood (parity with the upstream tool): input
     // box pinned to alt-screen BOTTOM, conversation grows above it.
     // Beta.3's height={rows} fix broke keystroke focus - raw echo at
     // viewport bottom. The right pattern is minHeight on the root +
@@ -191,37 +258,48 @@ export function Repl(props) {
     // input, and the input stays the sole focusable surface adjacent
     // to the cursor row, so all keystrokes route through it.
     const altScreenRows = process.stdout.rows ?? 24;
-    return (_jsxs(Box, { flexDirection: "column", paddingX: 1, minHeight: altScreenRows, children: [props.updateBanner ? _jsx(UpdateBanner, { result: props.updateBanner }) : null, splashVisible ? (_jsx(ReplSplash, { cliVersion: state.cliVersion, workspaceLabel: state.workspaceLabel, plan: props.splashPlan, model: props.splashModel, tenant: props.splashTenant, onDismiss: dismissSplash, mascotPrePrinted: props.mascotPrePrinted === true })) : null, _jsx(Header, { state: state }), _jsx(Box, { flexDirection: "column", marginTop: 1, flexGrow: 1, justifyContent: "flex-end", children: overlay === 'help' ? (_jsx(HelpOverlay, {})) : overlay === 'roster' ? (_jsx(RosterOverlay, {})) : overlay === 'farewell' ? (_jsx(FarewellOverlay, {})) : (_jsx(MainArea, { state: state, personaNames: personaNames, nowEpochMs: tickNow, hideToolStream: props.hideToolStream === true, toolStreamCollapsed: toolStreamCollapsed })) }), state.pendingAsk ? (_jsx(Box, { marginTop: 1, children: _jsx(AskModal, { tag: state.pendingAsk, onResolve: handleAskResolve }) })) : null, state.pendingPlanReview ? (_jsx(Box, { marginTop: 1, children: _jsx(PlanReviewModal, { tag: state.pendingPlanReview, onResolve: handlePlanReviewResolve }) })) : null, _jsxs(Box, { flexDirection: "column", marginTop: 1, children: [overlay === 'farewell' || modalActive ? null : (_jsx(InputBox, { onSubmit: handleSubmit, onExit: handleExit, onCancel: handleCancel, now: props.now, 
+    return (_jsxs(Box, { flexDirection: "column", paddingX: 1, minHeight: altScreenRows, children: [welcomeVisible && props.welcomeData ? (_jsx(WelcomeBanner, { data: props.welcomeData, mascotPrePrinted: props.mascotPrePrinted === true, autoInitStatus: props.autoInitStatus ?? null })) : null, splashVisible ? (_jsx(ReplSplash, { cliVersion: state.cliVersion, workspaceLabel: state.workspaceLabel, plan: props.splashPlan, model: props.splashModel, tenant: props.splashTenant, onDismiss: dismissSplash, mascotPrePrinted: props.mascotPrePrinted === true })) : null, _jsx(Header, { state: state }), _jsx(Box, { flexDirection: "column", marginTop: 1, flexGrow: 1, justifyContent: "flex-end", children: overlay === 'help' ? (_jsx(HelpOverlay, {})) : overlay === 'roster' ? (_jsx(RosterOverlay, {})) : overlay === 'farewell' ? (_jsx(FarewellOverlay, {})) : (_jsx(MainArea, { state: state, personaNames: personaNames, nowEpochMs: tickNow, hideToolStream: props.hideToolStream === true, toolStreamCollapsed: toolStreamCollapsed })) }), state.pendingAsk ? (_jsx(Box, { marginTop: 1, children: _jsx(AskModal, { tag: state.pendingAsk, onResolve: handleAskResolve }) })) : null, state.pendingPlanReview ? (_jsx(Box, { marginTop: 1, children: _jsx(PlanReviewModal, { tag: state.pendingPlanReview, onResolve: handlePlanReviewResolve }) })) : null, _jsxs(Box, { flexDirection: "column", marginTop: 1, children: [overlay === 'farewell' || modalActive ? null : (_jsx(InputBox, { onSubmit: handleSubmit, onExit: handleExit, onCancel: handleCancel, onWalkback: handleWalkback, onCyclePermissionMode: handleCyclePermissionMode, now: props.now, 
                         // Slug from process.cwd() (full path) so two workspaces with
                         // the same basename do not share history. state.workspaceLabel
                         // is the basename only. Codex review P2.
-                        workspaceSlug: slugForCwd(process.cwd()) })), _jsx(StatusBar, { connection: state.connection, activeAgentCount: countActive(state), tokensDownstreamTotal: state.tokensDownstreamTotal, briefStartedAtEpochMs: state.briefStartedAtEpochMs, nowEpochMs: tickNow, pulsePhase: pulsePhase, pugiMdCount: workspaceContext.pugiMdCount, mcpServerCount: workspaceContext.mcpServerCount, skillCount: workspaceContext.skillCount, quotaPct: props.quotaPct, dispatchState: state.dispatchState, dispatchToolLabel: state.dispatchToolLabel })] })] }));
+                        workspaceSlug: slugForCwd(process.cwd()) })), _jsx(ThinkingSpinner, { dispatchState: state.dispatchState, dispatchToolLabel: state.dispatchToolLabel }), _jsx(StatusBar, { connection: state.connection, activeAgentCount: countActive(state), tokensDownstreamTotal: state.tokensDownstreamTotal, briefStartedAtEpochMs: state.briefStartedAtEpochMs, nowEpochMs: tickNow, pulsePhase: pulsePhase, pugiMdCount: workspaceContext.pugiMdCount, mcpServerCount: workspaceContext.mcpServerCount, skillCount: workspaceContext.skillCount, quotaPct: props.quotaPct, dispatchState: state.dispatchState, dispatchToolLabel: state.dispatchToolLabel, lastCompletedOutcome: state.lastCompletedOutcome, 
+                        // cost-meter sprint — surface accumulated session totals
+                        // + per-turn delta flash on the status bar's top row. The
+                        // session module owns accumulation; the bar is a pure render.
+                        sessionTokensIn: state.sessionTokensIn, sessionTokensOut: state.sessionTokensOut, sessionCostUsd: state.sessionCostUsd, sessionStartedAtEpochMs: state.sessionStartedAtEpochMs, lastTurnDelta: state.lastTurnDelta }), props.updateBanner ? _jsx(UpdateBanner, { result: props.updateBanner }) : null] })] }));
 }
 function Header({ state }) {
-    return (_jsxs(Box, { children: [_jsx(Text, { bold: true, children: "Pugi" }), _jsx(Text, { bold: true, color: "cyan", children: ".io" }), _jsx(Text, { dimColor: true, children: `  ·  workspace: ${state.workspaceLabel}  ·  v${state.cliVersion}  ·  ` }), _jsx(Text, { color: "cyan", children: state.connection === 'on_watch' ? 'on watch' : state.connection.replace('_', ' ') })] }));
+    // the header `.io` brand accent + connection
+    // pill route through `useTheme()` so the operator's `/theme` flip
+    // (default / dark / light / colorblind) re-tints the chrome on
+    // re-mount. The `useTheme` hook returns the `default` preset's
+    // colors when no provider is mounted, preserving the previous
+    // `#3da9fc` constants for tests that import `<Repl />` standalone.
+    const theme = useTheme();
+    return (_jsxs(Box, { children: [_jsx(Text, { bold: true, children: "Pugi" }), _jsx(Text, { bold: true, color: theme.accent, children: ".io" }), _jsx(Text, { dimColor: true, children: ` · workspace: ${state.workspaceLabel} · v${state.cliVersion} · ` }), _jsx(Text, { color: theme.accent, children: state.connection === 'on_watch' ? 'on watch' : state.connection.replace('_', ' ') })] }));
 }
 function MainArea({ state, personaNames, nowEpochMs, hideToolStream, toolStreamCollapsed, }) {
-    // α6.12: three vertical panes stacked above the input box.
+    // : three vertical panes stacked above the input box.
     //
-    //   1. Conversation pane (top)  - transcript with Markdown render.
-    //   2. Tool stream pane (mid)   - live Read/Edit/Bash/Grep lines.
-    //                                  Hidden when `--no-tool-stream` is
-    //                                  set; collapsed via Ctrl+T while
-    //                                  the pane is visible.
-    //   3. Agent tree pane (bottom) - Cyber-Zoo roster with persona /
-    //                                  status / duration / token counts.
+    //  1. Conversation pane (top) - transcript with Markdown render.
+    //  2. Tool stream pane (mid)  - live Read/Edit/Bash/Grep lines.
+    //                                 Hidden when `--no-tool-stream` is
+    //                                 set; collapsed via Ctrl+T while
+    //                                 the pane is visible.
+    //  3. Agent tree pane (bottom) - Cyber-Zoo roster with persona /
+    //                                 status / duration / token counts.
     //
     // The window over the transcript is small (last 12 rows) so the
     // bottom of the frame stays anchored to the input box. New agents
-    // push the operator line up the screen, mirroring Claude Code /
-    // Codex CLI / Gemini CLI rendering.
+    // push the operator line up the screen, mirroring the upstream tool /
+    // peer CLI / Gemini CLI rendering.
     const conversationSlice = state.transcript.slice(-CONVERSATION_WINDOW);
     return (_jsxs(Box, { flexDirection: "column", children: [_jsx(ConversationPane, { rows: conversationSlice, personaNames: personaNames }), hideToolStream ? null : (_jsx(Box, { marginTop: 1, children: _jsx(ToolStreamPane, { calls: state.toolCalls, collapsed: toolStreamCollapsed }) })), _jsx(Box, { marginTop: 1, children: _jsx(AgentTreePane, { agents: state.agents, nowEpochMs: nowEpochMs }) })] }));
 }
 function HelpOverlay() {
     // Group commands by their `group` field so the operator scans the
     // palette by intent (dispatch → session → tools → settings → meta).
-    // The α6.14 wave-2 expansion grew the surface from 6 to 20 commands;
+    // The wave-2 expansion grew the surface from 6 to 20 commands;
     // a flat list would force the operator to read 20 rows top-to-bottom
     // every time. Grouping cuts perceived complexity dramatically.
     const grouped = new Map();
@@ -238,14 +316,14 @@ function HelpOverlay() {
                 const rows = grouped.get(group);
                 if (!rows || rows.length === 0)
                     return null;
-                return (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { dimColor: true, children: `  -- ${group} --` }), rows.map((row) => (_jsxs(Box, { children: [_jsx(Text, { bold: true, color: "cyan", children: `  /${row.name} ${row.args}`.padEnd(22, ' ') }), _jsx(Text, { dimColor: true, children: row.gloss })] }, row.name)))] }, group));
+                return (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { dimColor: true, children: ` -- ${group} --` }), rows.map((row) => (_jsxs(Box, { children: [_jsx(Text, { bold: true, color: "#3da9fc", children: ` /${row.name} ${row.args}`.padEnd(22, ' ') }), _jsx(Text, { dimColor: true, children: row.gloss })] }, row.name)))] }, group));
             }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: `${PUGI_TAGLINE}` }) }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: 'Press any key to dismiss.' }) })] }));
 }
 function RosterOverlay() {
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { bold: true, children: "On-watch roster" }), _jsx(Box, { marginTop: 1, flexDirection: "column", children: THE_TEN.map((persona) => (_jsxs(Box, { children: [_jsx(Text, { bold: true, children: `  ${persona.name.padEnd(10, ' ')}` }), _jsx(Text, { dimColor: true, children: `${persona.role.padEnd(20, ' ')}` }), _jsx(Text, { children: persona.oneLiner })] }, persona.slug))) }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: 'Press any key to dismiss.' }) })] }));
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { bold: true, children: "On-watch roster" }), _jsx(Box, { marginTop: 1, flexDirection: "column", children: THE_TEN.map((persona) => (_jsxs(Box, { children: [_jsx(Text, { bold: true, children: ` ${persona.name.padEnd(10, ' ')}` }), _jsx(Text, { dimColor: true, children: `${persona.role.padEnd(20, ' ')}` }), _jsx(Text, { children: persona.oneLiner })] }, persona.slug))) }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: 'Press any key to dismiss.' }) })] }));
 }
 function FarewellOverlay() {
-    return (_jsx(Box, { flexDirection: "column", alignItems: "center", paddingY: 2, children: _jsx(Text, { bold: true, color: "cyan", children: PUGI_TAGLINE }) }));
+    return (_jsx(Box, { flexDirection: "column", alignItems: "center", paddingY: 2, children: _jsx(Text, { bold: true, color: "#3da9fc", children: PUGI_TAGLINE }) }));
 }
 function applyVerdictSideEffects(verdict, handlers) {
     switch (verdict.kind) {
@@ -270,8 +348,10 @@ function applyVerdictSideEffects(verdict, handlers) {
         case 'consensus':
         case 'diff':
         case 'cost':
+        case 'quota':
         case 'status':
         case 'resume':
+        case 'mcp':
         case 'stub':
             // All non-overlay verdicts: the session module already appended
             // any operator-visible system lines (and, for `ask`, set

package/dist/tui/slash-palette.js

@@ -7,7 +7,7 @@ export const PALETTE_ROW_LIMIT = 8;
  * Centralises the "starts-with-slash → filter SLASH_COMMAND_HELP"
  * logic so the input box and the unit test agree on the shape.
  *
- * Wave 4 fix 2026-05-25: returns the FULL filtered set, not just the
+ * fix: returns the FULL filtered set, not just the
  * first PALETTE_ROW_LIMIT rows. The palette renderer now windows the
  * visible slice internally based on `focusedIndex`, so the operator
  * can scroll past row 7 via ↑/↓ on a long list (e.g. 20 commands when
@@ -15,9 +15,9 @@ export const PALETTE_ROW_LIMIT = 8;
  * shape for backward compatibility but always equals `rows.length`.
  *
  * Behaviour:
- *   - Empty / non-slash buffer → empty result; palette stays hidden.
- *   - `/` alone → all registry rows (the operator wants to browse).
- *   - `/he` → rows whose name starts with `he` (case-insensitive).
+ *  - Empty / non-slash buffer → empty result; palette stays hidden.
+ *  - `/` alone → all registry rows (the operator wants to browse).
+ *  - `/he` → rows whose name starts with `he` (case-insensitive).
  */
 export function filterPalette(buffer) {
     if (!buffer.startsWith('/')) {
@@ -86,7 +86,7 @@ export function completePalette(buffer, rows, focusedIndex) {
 export function SlashPalette(props) {
     if (props.rows.length === 0)
         return null;
-    // Wave 4 fix 2026-05-25: compute the visible window so the operator
+    // fix: compute the visible window so the operator
     // can scroll past row 7 on long lists. Focus indexes the full rows
     // array; the window slides to keep the focused row visible.
     const window = computePaletteWindow(props.rows, props.focusedIndex);
@@ -101,6 +101,6 @@ export function SlashPalette(props) {
                 const glyph = focused ? '▸' : '·';
                 const cmd = `/${row.name}${row.args ? ` ${row.args}` : ''}`.padEnd(22, ' ');
                 return (_jsxs(Box, { children: [_jsx(Text, { color: focused ? 'cyan' : 'gray', children: `${glyph} ` }), _jsx(Text, { bold: focused, color: focused ? 'cyan' : undefined, dimColor: !focused, children: cmd }), _jsx(Text, { dimColor: true, children: row.gloss })] }, row.name));
-            }), overflow ? (_jsx(Box, { children: _jsx(Text, { dimColor: true, children: `  → ${focusedDisplayIndex}/${window.total}` }) })) : null, _jsx(Box, { children: _jsx(Text, { dimColor: true, children: '  ↑/↓ select  ·  Tab complete  ·  Enter run  ·  Esc close' }) })] }));
+            }), overflow ? (_jsx(Box, { children: _jsx(Text, { dimColor: true, children: ` → ${focusedDisplayIndex}/${window.total}` }) })) : null, _jsx(Box, { children: _jsx(Text, { dimColor: true, children: ' ↑/↓ select · Tab complete · Enter run · Esc close' }) })] }));
 }
 //# sourceMappingURL=slash-palette.js.map

package/dist/tui/splash.js

@@ -21,11 +21,11 @@ export function Splash({ data }) {
             cmd: 'pugi login',
             gloss: 'Connect this terminal to your Pugi account',
         };
-    return (_jsxs(Box, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [_jsx(Box, { children: _jsx(Text, { bold: true, color: "cyan", children: "pugi.io" }) }), _jsx(Box, { children: _jsx(Text, { dimColor: true, children: `v${data.cliVersion}  ·  ${data.apiUrl}` }) }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "Account: " }), _jsx(Text, { children: accountLine })] }), data.isAuthenticated && data.plan ? (_jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "Plan: " }), _jsx(Text, { children: data.plan })] })) : null] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { dimColor: true, children: "Quick start:" }), _jsx(HintRow, { command: primaryHint.cmd, gloss: primaryHint.gloss }), data.isAuthenticated ? (_jsx(HintRow, { command: 'pugi login', gloss: 'Re-authenticate or switch accounts' })) : (_jsx(HintRow, { command: 'pugi code "fix the bug"', gloss: 'Run a one-shot coding task' })), _jsx(HintRow, { command: 'pugi review --triple', gloss: 'Run the Anvil triple-review gate' }), _jsx(HintRow, { command: 'pugi help', gloss: 'Full command reference' })] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: "Docs: https://pugi.dev   \u00B7   Status: https://pugi.io/status" }) })] }));
+    return (_jsxs(Box, { flexDirection: "column", paddingX: 2, paddingY: 1, children: [_jsx(Box, { children: _jsx(Text, { bold: true, color: "#3da9fc", children: "pugi.io" }) }), _jsx(Box, { children: _jsx(Text, { dimColor: true, children: `v${data.cliVersion} · ${data.apiUrl}` }) }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "Account: " }), _jsx(Text, { children: accountLine })] }), data.isAuthenticated && data.plan ? (_jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "Plan: " }), _jsx(Text, { children: data.plan })] })) : null] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { dimColor: true, children: "Quick start:" }), _jsx(HintRow, { command: primaryHint.cmd, gloss: primaryHint.gloss }), data.isAuthenticated ? (_jsx(HintRow, { command: 'pugi login', gloss: 'Re-authenticate or switch accounts' })) : (_jsx(HintRow, { command: 'pugi code "fix the bug"', gloss: 'Run a one-shot coding task' })), _jsx(HintRow, { command: 'pugi review --triple', gloss: 'Run the Anvil triple-review gate' }), _jsx(HintRow, { command: 'pugi help', gloss: 'Full command reference' })] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: "Docs: https://pugi.dev  \u00B7  Status: https://pugi.io/status" }) })] }));
 }
 function HintRow({ command, gloss }) {
     // Pad command names so the gloss column lines up across rows.
     const padded = command.padEnd(28, ' ');
-    return (_jsxs(Text, { children: [_jsx(Text, { children: `  ${padded}` }), _jsx(Text, { dimColor: true, children: gloss })] }));
+    return (_jsxs(Text, { children: [_jsx(Text, { children: ` ${padded}` }), _jsx(Text, { dimColor: true, children: gloss })] }));
 }
 //# sourceMappingURL=splash.js.map

package/dist/tui/status-bar.js

@@ -1,5 +1,12 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 import { Box, Text } from 'ink';
+import { formatCostUsd, formatTokens } from '../core/repl/model-pricing.js';
+/**
+ * Window during which the per-turn delta flash stays visible on the
+ * cost-meter row. CEO spec: ~2 seconds after completion. Past that, the
+ * flash dimms out and the row shows session totals only.
+ */
+const TURN_DELTA_FLASH_MS = 2_000;
 /**
  * Cyan dot glyphs across the pulse cycle. Three steps keep the motion
  * subtle - a true gradient would force an Ink rerender on every
@@ -12,13 +19,78 @@ export function StatusBar(props) {
     const tokenLabel = formatTokens(props.tokensDownstreamTotal);
     const phase = clampPhase(props.pulsePhase);
     const glyph = PULSE_DOTS[Math.min(phase, PULSE_DOTS.length - 1)] ?? PULSE_DOTS[0];
-    // α6.9: composite status label — connection problems trump dispatch
+    // : composite status label — connection problems trump dispatch
     // state because the operator needs to know about a dropped admin-api
     // first. When the connection is healthy (`on_watch` / `connecting`),
     // the FSM dispatch state takes over to show the dispatch lifecycle
     // (`dispatching` / `tool: read` / `aborting` / etc.).
-    const status = composeStatusLabel(props.connection, props.dispatchState, props.dispatchToolLabel);
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Text, { color: status.color, children: `${glyph ?? '●'} ${status.label}` }), _jsx(Text, { dimColor: true, children: `  ·  ${props.activeAgentCount} agents  ·  ` }), _jsx(Text, { children: `↓ ${tokenLabel} tokens` }), _jsx(Text, { dimColor: true, children: `  ·  ${elapsedLabel}` })] }), _jsx(Box, { children: _jsx(Text, { dimColor: true, children: `${formatCount(props.pugiMdCount)} PUGI.md  ·  ${formatCount(props.mcpServerCount)} MCP  ·  ${formatCount(props.skillCount)} skills  ·  ${formatQuota(props.quotaPct)} quota` }) })] }));
+    const status = composeStatusLabel(props.connection, props.dispatchState, props.dispatchToolLabel, props.lastCompletedOutcome);
+    // cost-meter sprint — the cost row anchors above the legacy
+    // dispatch-state line so the operator's eye lands on the meter first
+    // (matches the upstream tool TUI footer rhythm). The session-elapsed slot
+    // uses sessionStartedAtEpochMs (REPL boot), distinct from the
+    // per-brief `elapsedLabel` on the row below.
+    const costRow = renderCostMeterRow(props.sessionTokensIn ?? 0, props.sessionTokensOut ?? 0, props.sessionCostUsd ?? 0, props.sessionStartedAtEpochMs, now);
+    const deltaFlash = renderTurnDeltaFlash(props.lastTurnDelta, now);
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: `↑ ${costRow.tokensInLabel}` }), _jsx(Text, { dimColor: true, children: ' ' }), _jsx(Text, { color: "cyan", children: `↓ ${costRow.tokensOutLabel}` }), _jsx(Text, { dimColor: true, children: ` · ` }), _jsx(Text, { bold: true, children: costRow.costLabel }), _jsx(Text, { dimColor: true, children: ` · ${costRow.elapsedLabel}` }), deltaFlash ? (_jsxs(_Fragment, { children: [_jsx(Text, { dimColor: true, children: ' ' }), _jsx(Text, { color: "green", children: deltaFlash })] })) : null] }), _jsxs(Box, { children: [_jsx(Text, { color: status.color, children: `${glyph ?? '●'} ${status.label}` }), _jsx(Text, { dimColor: true, children: ` · ${props.activeAgentCount} agents · ` }), _jsx(Text, { children: `↓ ${tokenLabel} tokens` }), _jsx(Text, { dimColor: true, children: ` · ${elapsedLabel}` }), typeof props.externalDispatchCount === 'number' && props.externalDispatchCount > 0 ? (_jsx(Text, { color: "yellow", children: ` · ${props.externalDispatchCount} dispatch${props.externalDispatchCount === 1 ? '' : 'es'} active. /cancel к manage.` })) : null] }), _jsx(Box, { children: _jsx(Text, { dimColor: true, children: `${formatCount(props.pugiMdCount)} PUGI.md · ${formatCount(props.mcpServerCount)} MCP · ${formatCount(props.skillCount)} skills · ${formatQuota(props.quotaPct)} quota` }) })] }));
+}
+/**
+ * cost-meter sprint — assemble the cost-meter row labels. Pure helper
+ * so the snapshot tests assert the formatted shape without standing up
+ * an Ink renderer.
+ */
+export function renderCostMeterRow(tokensIn, tokensOut, costUsd, sessionStartedAtEpochMs, nowEpochMs) {
+    const elapsedMs = typeof sessionStartedAtEpochMs === 'number'
+        ? Math.max(0, nowEpochMs - sessionStartedAtEpochMs)
+        : 0;
+    return {
+        tokensInLabel: formatTokens(tokensIn),
+        tokensOutLabel: formatTokens(tokensOut),
+        costLabel: formatCostUsd(costUsd),
+        elapsedLabel: formatElapsedShort(elapsedMs),
+    };
+}
+/**
+ * cost-meter sprint — render the per-turn delta flash when the most
+ * recent turn completed within the flash window. Returns null when no
+ * turn has completed yet OR the flash has expired (the elapsed slot
+ * gets the slot back). The flash format mirrors the spec:
+ *
+ *    `+200/+1.1k +$0.01`
+ *
+ * Exported for snapshot tests.
+ */
+export function renderTurnDeltaFlash(delta, nowEpochMs) {
+    if (!delta)
+        return null;
+    const elapsedSinceMs = nowEpochMs - delta.completedAtEpochMs;
+    if (elapsedSinceMs < 0 || elapsedSinceMs > TURN_DELTA_FLASH_MS)
+        return null;
+    const inLabel = formatTokens(delta.tokensIn);
+    const outLabel = formatTokens(delta.tokensOut);
+    const costLabel = delta.costUsd > 0 ? ` +${formatCostUsd(delta.costUsd)}` : '';
+    return `+${inLabel}/+${outLabel}${costLabel}`;
+}
+/**
+ * cost-meter sprint — local copy of the session elapsed formatter.
+ * Mirrors the helper in `core/repl/session.ts` so the status bar stays
+ * a pure leaf component without a circular import on session.ts (the
+ * model-pricing module's `formatDuration` is similar but ships an
+ * `XhYm` ceiling that does not match the CEO spec's `2m44s` shape).
+ */
+function formatElapsedShort(elapsedMs) {
+    if (!Number.isFinite(elapsedMs) || elapsedMs <= 0)
+        return '0s';
+    const totalSec = Math.floor(elapsedMs / 1000);
+    if (totalSec < 60)
+        return `${totalSec}s`;
+    const min = Math.floor(totalSec / 60);
+    const sec = totalSec % 60;
+    if (min < 60)
+        return `${min}m${sec.toString().padStart(2, '0')}s`;
+    const hr = Math.floor(min / 60);
+    const restMin = min % 60;
+    return `${hr}h${restMin.toString().padStart(2, '0')}m`;
 }
 /**
  * Render a count badge — number if defined, `—` placeholder otherwise.
@@ -53,29 +125,29 @@ export function connectionLabel(connection) {
     }
 }
 /**
- * α6.9: compose the visible status label from connection + FSM state.
+ * : compose the visible status label from connection + FSM state.
  *
  * Priority order:
  *
- *   1. `offline` / `reconnecting` — transport health wins; the
- *      operator needs to know about a dropped stream before anything
- *      about the dispatch.
- *   2. `aborting` / `aborted` / `failed` — operator-visible terminal
- *      states the FSM reached; the colour shifts to amber/red so the
- *      anomaly stands out vs the calm cyan baseline.
- *   3. `tool_running` — surfaces the tool label when available
- *      (`tool: read`), falls back to `tool` when not.
- *   4. `awaiting_response` — `dispatching` (matches Codex CLI's verb
- *      for the same state).
- *   5. `completed` — `shipped` (matches the agent tree status glyph
- *      so the operator's eye links the two surfaces).
- *   6. `idle` / unknown — connection label (`on watch` / `connecting`).
+ *  1. `offline` / `reconnecting` — transport health wins; the
+ *     operator needs to know about a dropped stream before anything
+ *     about the dispatch.
+ *  2. `aborting` / `aborted` / `failed` — operator-visible terminal
+ *     states the FSM reached; the colour shifts to amber/red so the
+ *     anomaly stands out vs the calm cyan baseline.
+ *  3. `tool_running` — surfaces the tool label when available
+ *     (`tool: read`), falls back to `tool` when not.
+ *  4. `awaiting_response` — `dispatching` (matches peer CLI's verb
+ *     for the same state).
+ *  5. `completed` — `shipped` (matches the agent tree status glyph
+ *     so the operator's eye links the two surfaces).
+ *  6. `idle` / unknown — connection label (`on watch` / `connecting`).
  *
  * The dispatch label `dispatchToolLabel` is already shaped as
  * `tool: <kind>` upstream so we just concatenate; null falls through
  * to the bare `tool` placeholder.
  */
-function composeStatusLabel(connection, dispatchState, toolLabel) {
+function composeStatusLabel(connection, dispatchState, toolLabel, lastCompletedOutcome) {
     // Transport health wins.
     if (connection === 'offline' || connection === 'reconnecting') {
         return connectionLabel(connection);
@@ -93,6 +165,16 @@ function composeStatusLabel(connection, dispatchState, toolLabel) {
         case 'awaiting_response':
             return { label: 'dispatching', color: 'cyan' };
         case 'completed':
+            // Branch on the work-done outcome so the bottom-bar tells the
+            // same truth as the agent-tree (2026-05-26 — memory
+            // feedback_no_fake_dispatch_promises). `'replied'` = text-only
+            // turn, render with the same neutral gray + arrow used in the
+            // agent-tree. `'shipped'` = real side-effect (or older server
+            // that omits the outcome field). Defaults to `'shipped'` so
+            // older callers without the prop wired stay back-compat.
+            if (lastCompletedOutcome === 'replied') {
+                return { label: 'replied', color: 'gray' };
+            }
             return { label: 'shipped', color: 'green' };
         case 'idle':
         case undefined:
@@ -111,18 +193,14 @@ function formatElapsed(startedAt, now) {
     const seconds = Math.floor((ms % 60_000) / 1000);
     return `${minutes}m ${seconds.toString().padStart(2, '0')}s`;
 }
-/**
- * Format the downstream token counter as 1.2k / 12.4k / 1.0m. Anvil
- * F1 emits totals in the tens-of-thousands range during a single
- * brief, so anything more than three significant figures is noise.
- */
-function formatTokens(total) {
-    if (total < 1_000)
-        return total.toString();
-    if (total < 1_000_000)
-        return `${(total / 1_000).toFixed(1)}k`;
-    return `${(total / 1_000_000).toFixed(1)}m`;
-}
+// `formatTokens` for the downstream-throughput slot is imported from
+// `core/repl/model-pricing.ts` — single source of truth for token
+// formatting across the cost-meter row, `/cost` slash, and the legacy
+// downstream-tokens slot. The shape is identical to the prior local
+// helper (`<1000` raw, `<1m` one-decimal k, `≥1m` one-decimal m); the
+// only semantic difference is non-finite / negative inputs render as
+// `0` instead of throwing, matching the cost-meter row's defensive
+// posture.
 function clampPhase(phase) {
     if (typeof phase !== 'number' || Number.isNaN(phase))
         return 0;

package/dist/tui/status-table.js

@@ -0,0 +1,7 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from 'ink';
+export function StatusTable({ snapshot }) {
+    const labelWidth = Math.max('Label'.length, ...snapshot.fields.map((f) => f.label.length));
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, children: "Pugi status" }) }), snapshot.fields.map((field) => (_jsxs(Box, { children: [_jsxs(Text, { children: [field.label.padEnd(labelWidth, ' '), " "] }), field.available ? (_jsx(Text, { children: field.value })) : (_jsx(Text, { dimColor: true, children: field.value }))] }, field.key))), _jsx(Box, { marginTop: 1, children: _jsxs(Text, { dimColor: true, children: ["CLI ", snapshot.meta.cliVersion, " Node ", snapshot.meta.nodeVersion, " cwd ", snapshot.meta.cwd] }) })] }));
+}
+//# sourceMappingURL=status-table.js.map