@aragon-agent/cli 0.5.11 → 0.5.12

package/CHANGELOG.md

@@ -7,6 +7,30 @@ were written.
 
 ## Unreleased
 
+### Fixed
+
+- **`/clear` now takes the todo panel with it.** Finish a plan, type `/clear`,
+  and the transcript emptied while the `7/7 done` rail stayed exactly where it
+  was — on a screen you had just asked to be cleared. It stayed until your next
+  real message, which is precisely the pause you take after clearing to decide
+  what to ask next, so essentially everyone met it.
+
+  This was deliberate once. The list is a projection of what the model believes,
+  and `/clear` wipes the transcript rather than the conversation, so the model
+  still believed in the plan and a panel contradicting the model was judged worse
+  than no panel. That reasoning holds for everything the CLI does on its own; it
+  does not hold against you typing the command. An explicit instruction was
+  always this rule's exception — `/todo clear` has used the same door from the
+  start — and `/clear` now goes through it.
+
+  The list itself is cleared, not just the pixels, so `/save`, `/todo status`,
+  `/todo continue` and auto follow-through all agree with the screen: no plan is
+  written into a saved session, nothing offers to continue one, and nothing spends
+  a follow-through on it. `/reset` is unchanged and still the only command that
+  clears the conversation. Nothing is stranded either way — the model's next
+  `todo_write` is a full replacement, so the panel comes back the moment there is
+  a plan to show.
+
 ### Added
 
 - **An update that will not start is undone automatically.** The updater shipped

package/README.md

@@ -107,7 +107,7 @@ Exit codes: `0` success · `1` agent/runtime error · `2` config/usage error ·
 | `/thinking <level>` | Set the thinking level |
 | `/max-tokens [<n>\|auto\|default]` | Output token cap; with no argument, reports the setting **and** the effective cap for the live model |
 | `/tools` | List active tools |
-| `/clear` | Clear the visible transcript |
+| `/clear` | Clear the visible transcript and the todo panel |
 | `/reset` | New conversation |
 | `/cwd [dir]` | Show / change the tool working directory |
 | `/save [file]` | Save the session to JSON |
@@ -498,9 +498,11 @@ against an empty plan is refused outright. A session that never plans has
 byte-identical layout to a build without this feature.
 
 **The list is a projection of what the model believes**, so nothing that does
-not also tell the model may change it:
+not also tell the model may change it — except you, saying so:
 
-- `/clear` wipes the transcript but not the conversation, so the plan stays.
+- `/clear` and `/todo clear` take the plan off the screen. Neither touches the
+  conversation, so the model still knows what it was doing and its next update
+  brings the panel straight back.
 - `/reset` clears the conversation, so the plan goes with it.
 - `/save` writes the list and `/resume` restores it. Resuming a session that has
   no list clears the current one, rather than leaving a plan on screen whose

package/dist/agent/controller.d.ts

@@ -339,7 +339,11 @@ export declare class AgentController {
     subscribeTodos(listener: TodoEventListener): () => void;
     /** `/resume`. An absent or empty list CLEARS — see `TodoStore.restore` (P0-2). */
     restoreTodos(items: unknown): void;
-    /** `/todo clear`. A user override of a projection; refused mid-run by `/todo`. */
+    /**
+     * `/todo clear` and `/clear`. A user override of a projection (I-2's standing
+     * exception). `/todo` refuses mid-run before it gets here; `/clear` does not,
+     * on purpose — refusing there would leave it unable to clear the transcript.
+     */
     clearTodos(): void;
     getRetryConfig(): RetryConfig;
     /**

package/dist/agent/controller.js

@@ -916,7 +916,11 @@ export class AgentController {
     restoreTodos(items) {
         this.todos?.restore(items);
     }
-    /** `/todo clear`. A user override of a projection; refused mid-run by `/todo`. */
+    /**
+     * `/todo clear` and `/clear`. A user override of a projection (I-2's standing
+     * exception). `/todo` refuses mid-run before it gets here; `/clear` does not,
+     * on purpose — refusing there would leave it unable to clear the transcript.
+     */
     clearTodos() {
         this.todos?.clear('user');
     }
@@ -1057,9 +1061,10 @@ export class AgentController {
         // in this conversation" hint would otherwise start lying (P2-9).
         this.skills.getRegistry().clearActive();
         // `/reset` clears `messages`, so the belief that justifies the panel is gone
-        // with them and the list must go too (I-2). `/clear` reaches the transcript
-        // and NOT this method, which is the whole distinction: it tells the model
-        // nothing, so it may not change the list.
+        // with them and the list must go too (I-2). `/clear` also drops the list, but
+        // through `clearTodos()` and reason `'user'`, which is the distinction that
+        // remains: this path is a belief that no longer exists, that one is a user
+        // overriding a projection of a belief the model still holds.
         this.todos?.clear('reset');
     }
     /** Read-only view of the live system prompt (regression tests, /debug). */

package/dist/agent/reducer.js

@@ -692,10 +692,20 @@ export function viewReducer(state, action) {
                 streamingId: undefined,
                 expandedToolIds: {},
                 teamEntryId: undefined,
-                // The entry it pointed at is gone, so the id goes with it. `todos` is
-                // DELIBERATELY UNTOUCHED (I-2): `/clear` wipes the transcript and not
-                // the conversation, so the model still believes in the plan, and a panel
-                // that disagrees with the model is worse than no panel.
+                // The list goes with the screen it was on. `/clear` is an explicit user
+                // instruction, which is I-2's standing exception (`TodoClearReason`
+                // `'user'`, the same door `/todo clear` uses) — so the command clears the
+                // STORE via `controller.clearTodos()` and this clears the MIRROR, exactly
+                // the pairing `resetConversation` below has always had.
+                //
+                // The mirror write is same-valued with the store's own `todoCleared`
+                // dispatch rather than redundant with it: it is what makes this action
+                // stand on its own. `builtins.ts` is the only dispatcher of it TODAY, and
+                // a second one — a real clear-screen key, a session-restore path — would
+                // otherwise bring the bug back in identical form and in silence.
+                //
+                // The entry id is dropped because the entry it pointed at is gone.
+                todos: null,
                 todoEntryId: undefined,
                 // Same reasoning for the retry card: the entry is gone, so the id must go
                 // with it or `retryScheduled` would `mapEntry` an id that no longer

package/dist/commands/builtins.js

@@ -831,8 +831,27 @@ const COMMANDS = [
     },
     {
         name: 'clear',
-        description: 'Clear the visible transcript',
-        run: (ctx) => ctx.dispatch({ type: 'clearTranscript' }),
+        description: 'Clear the visible transcript and the todo panel',
+        run: (ctx) => {
+            // A USER OVERRIDE OF A PROJECTION, the same class as `/todo clear`, so it
+            // reuses reason `'user'`; I-2 and its standing exception are stated on
+            // `TodoStore`. Clearing the STORE and not merely the view mirror is what
+            // keeps `/save`, `/todo status|continue` and follow-through agreeing with
+            // the screen — they read the store directly. `messages` is untouched:
+            // clearing the conversation is still `/reset` alone.
+            //
+            // DELIBERATELY WITHOUT `/todo clear`'s two guards: an `isRunning()` refusal
+            // would leave `/clear` unable to clear even the transcript mid-run, and an
+            // early return on an empty list would skip the dispatch below entirely.
+            // Clearing an empty store is already silent — it emits into a reducer
+            // branch that writes two fields that are both already at their defaults.
+            //
+            // Bounded side effect: the emptied store re-arms `todo_write`'s "a fresh
+            // plan has at least two items" gate, so a model that shrinks a plan to one
+            // item right after a mid-run `/clear` gets the refusal text and retries.
+            ctx.controller.clearTodos();
+            ctx.dispatch({ type: 'clearTranscript' });
+        },
     },
     {
         name: 'reset',

package/dist/todo/store.d.ts

@@ -10,12 +10,18 @@
  * `TeamRuntime`.
  *
  * INVARIANT I-2 — the list is a PROJECTION OF WHAT THE MODEL BELIEVES, and
- * nothing that does not tell the model may change it. `/clear` wipes the
- * transcript but not the conversation, so it must NOT reach this class;
- * `/reset` clears `messages`, so it must. Every write is a FULL REPLACEMENT and
- * every clear is a FULL REMOVAL - there is no partial update anywhere, which is
- * what makes I-9 ("the panel is never a contradiction of the model") provable
- * rather than argued.
+ * nothing that does not tell the model may change it — EXCEPT AN EXPLICIT USER
+ * INSTRUCTION, which is the rule's standing exception and is marked
+ * `TodoClearReason = 'user'`. Two commands come through that door: `/todo clear`
+ * and `/clear`. Neither tells the model anything, and that is fine, because what
+ * they leave behind is "panel absent, model still remembers" - the direction I-9
+ * below calls safe, and one the model's next full-replacement write heals on its
+ * own. `/reset` (reason `'reset'`) remains the only clear caused by the belief
+ * itself being destroyed, because it clears `messages`.
+ *
+ * Every write is a FULL REPLACEMENT and every clear is a FULL REMOVAL - there is
+ * no partial update anywhere, which is what makes I-9 ("the panel is never a
+ * contradiction of the model") provable rather than argued.
  */
 import { type NormalizeResult } from './normalize.js';
 import type { TodoClearReason, TodoEventListener, TodoSnapshot } from './types.js';

package/dist/todo/store.js

@@ -10,12 +10,18 @@
  * `TeamRuntime`.
  *
  * INVARIANT I-2 — the list is a PROJECTION OF WHAT THE MODEL BELIEVES, and
- * nothing that does not tell the model may change it. `/clear` wipes the
- * transcript but not the conversation, so it must NOT reach this class;
- * `/reset` clears `messages`, so it must. Every write is a FULL REPLACEMENT and
- * every clear is a FULL REMOVAL - there is no partial update anywhere, which is
- * what makes I-9 ("the panel is never a contradiction of the model") provable
- * rather than argued.
+ * nothing that does not tell the model may change it — EXCEPT AN EXPLICIT USER
+ * INSTRUCTION, which is the rule's standing exception and is marked
+ * `TodoClearReason = 'user'`. Two commands come through that door: `/todo clear`
+ * and `/clear`. Neither tells the model anything, and that is fine, because what
+ * they leave behind is "panel absent, model still remembers" - the direction I-9
+ * below calls safe, and one the model's next full-replacement write heals on its
+ * own. `/reset` (reason `'reset'`) remains the only clear caused by the belief
+ * itself being destroyed, because it clears `messages`.
+ *
+ * Every write is a FULL REPLACEMENT and every clear is a FULL REMOVAL - there is
+ * no partial update anywhere, which is what makes I-9 ("the panel is never a
+ * contradiction of the model") provable rather than argued.
  */
 import { getLogger } from '../logging/logger.js';
 import { TODO_LIMITS } from './limits.js';

package/dist/todo/types.d.ts

@@ -42,7 +42,8 @@ export interface TodoSnapshot {
 /**
  * Why a list went away.
  *
- *   `user`  - `/todo clear`.
+ *   `user`  - `/todo clear`, or `/clear`. Both are an explicit user instruction,
+ *             which is I-2's standing exception; neither touches `messages`.
  *   `reset` - `/reset`, or a `/resume` whose file carried no list (§3.13).
  *   `turn`  - every item was completed when the next user turn started.
  *   `stale` - unfinished, and unwritten for more than `TODO_LIMITS.staleTurns`

package/dist/ui/ActivityLine.d.ts

@@ -21,6 +21,22 @@
  *
  * What is left is the one thing the status bar cannot say: THAT THE SILENCE IS
  * WORK. The bar shows state; this row shows life.
+ *
+ * THIS ROW OWNS THE ONLY ANIMATED SPINNER WHILE IT IS MOUNTED
+ * (single-spinner-while-running D-1). Seven other sites can animate — the
+ * streaming assistant marker, the tool badge, the team/fast/retry cards, and the
+ * two panels' rows — and each was independently right to. Emergently they put up
+ * to five braille animations on adjacent rows, each on its own 80 ms timer: one
+ * piece of information rendered five times and out of phase, which is the same
+ * duplication the paragraph above legislates against for text. So `App` widens
+ * the `reducedMotion` it hands those seven to `cfg.reducedMotion || (running &&
+ * !overlay)`, and they all fall back to the static glyphs they already had.
+ *
+ * THIS COMPONENT KEEPS THE RAW CONFIG FLAG, and that asymmetry is deliberate
+ * (D-5). It reads the flag TWICE: once for the spinner below, and once for
+ * `pickActivityPhrase`'s rotation. Handing it the widened value would freeze the
+ * phrase at the first word of every run — a second, unrelated regression, and
+ * one nobody would connect to a change about icons.
  */
 import React from 'react';
 import type { Theme } from './theme.js';

package/dist/ui/App.js

@@ -1422,6 +1422,30 @@ export function App({ controller, version, mode, initialOverlay, initialPrompt,
     const opener = empty ? (_jsx(SessionOpener, { variant: fullscreen ? pickOpenerVariant(viewportBudget, contentCols, caps) : 'none', version: version, cwd: controller.getCwd(), hasKey: hasKey, viewportRows: fullscreen ? viewportBudget : Number.POSITIVE_INFINITY, theme: theme, caps: caps })) : null;
     const density = cfg.density;
     const transcriptWindow = cfg.transcriptWindow ?? DEFAULT_TRANSCRIPT_WINDOW;
+    // --- One spinner per run (single-spinner-while-running D-1 .. D-5). ------
+    //
+    // THE MOUNT CONDITION, NAMED ONCE AND USED TWICE (D-4). This const both gates
+    // the `<ActivityLine>` element below and feeds the derivation on the next
+    // line, so "the line is up" and "every other site is still" can never
+    // disagree. Two copies of the same boolean expression is exactly how that
+    // invariant becomes false in six months, silently and in only one branch.
+    //
+    // NOT `running` ALONE (D-3). While an overlay owns the screen the activity row
+    // is suppressed, so keying suppression off `running` would leave the frame
+    // with ZERO life signals: the bar shows state, this row shows life. Never
+    // trade one duplicate for one absence.
+    const activityVisible = running && !overlayNode;
+    // The FOUR VIEW CONSUMERS (transcript x 2, team panel, todo panel) take this;
+    // the activity line keeps the raw config flag (D-5), because it reads that
+    // flag a second time to gate phrase rotation and the widened value would
+    // freeze the phrase at the first word of every run.
+    //
+    // So below `App` the prop now means "this frame does not animate here" rather
+    // than "the user asked for reduced motion". `cfg.reducedMotion` (`:279`) stays
+    // the sole config source, and `spinner-census.test.ts` pins this wiring —
+    // threading the raw flag into a fifth consumer is the one silent way back to
+    // two spinners (R-2).
+    const viewReducedMotion = reducedMotion || activityVisible;
     // Assigned during render so `/perf` reads the CURRENT frame (see `perfRef`).
     // `mountedEntries` is the same number `render-budget.test.tsx` asserts (AC-9).
     perfRef.current = {
@@ -1440,20 +1464,25 @@ export function App({ controller, version, mode, initialOverlay, initialPrompt,
         viewportRows: fullscreen ? viewportBudget : rows,
         offset: scrolledLines,
     };
-    const viewport = fullscreen ? (overlayNode ? (_jsx(Box, { flexDirection: "column", flexGrow: 1, overflow: "hidden", children: overlayNode })) : (_jsxs(ScrollViewport, { intent: scrollIntent, pinToBottomNonce: pinToBottomNonce, onScrolledLinesChange: setScrolledLines, showScrollIndicator: true, cols: contentCols, theme: theme, caps: caps, children: [opener, _jsx(TranscriptList, { entries: state.entries, expandedToolIds: state.expandedToolIds, thinkingVisible: state.thinkingVisible, reducedMotion: reducedMotion, density: density, mode: mode, nowSec: nowSec, theme: theme, caps: caps, windowSize: transcriptWindow, cols: contentCols, heights: heights, mountedSink: mountedCount })] }))) : (_jsxs(_Fragment, { children: [opener, _jsx(Transcript, { entries: state.entries, expandedToolIds: state.expandedToolIds, thinkingVisible: state.thinkingVisible, reducedMotion: reducedMotion, density: density, mode: mode, nowSec: nowSec, theme: theme, caps: caps }), overlayNode] }));
+    const viewport = fullscreen ? (overlayNode ? (_jsx(Box, { flexDirection: "column", flexGrow: 1, overflow: "hidden", children: overlayNode })) : (_jsxs(ScrollViewport, { intent: scrollIntent, pinToBottomNonce: pinToBottomNonce, onScrolledLinesChange: setScrolledLines, showScrollIndicator: true, cols: contentCols, theme: theme, caps: caps, children: [opener, _jsx(TranscriptList, { entries: state.entries, expandedToolIds: state.expandedToolIds, thinkingVisible: state.thinkingVisible, reducedMotion: viewReducedMotion, density: density, mode: mode, nowSec: nowSec, theme: theme, caps: caps, windowSize: transcriptWindow, cols: contentCols, heights: heights, mountedSink: mountedCount })] }))) : (_jsxs(_Fragment, { children: [opener, _jsx(Transcript, { entries: state.entries, expandedToolIds: state.expandedToolIds, thinkingVisible: state.thinkingVisible, reducedMotion: viewReducedMotion, density: density, mode: mode, nowSec: nowSec, theme: theme, caps: caps }), overlayNode] }));
     // The completion popup lives inside the bottom chrome and can add up to 9
     // rows; unbounded, it pushes the status bar past the frame height where
     // `overflow: hidden` clips it away (R-14 / M-14). Cap it against the viewport.
     const popupMaxRows = fullscreen ? Math.max(1, viewportBudget - 4) : undefined;
     const composer = fullscreen ? (_jsx(Composer, { isActive: overlay === null, running: state.status === 'running', history: promptHistory, commands: commandOptions, cwd: controller.getCwd(), showHint: rows >= HINT_MIN_ROWS, submitCount: cfg.submitCount, hintsEnabled: cfg.hints, agentMode: state.agentMode, popupMaxRows: popupMaxRows, theme: theme, caps: caps, onSubmit: (text) => void handleSubmit(text), onHelp: () => dispatch({ type: 'setOverlay', overlay: 'help' }) })) : (_jsx(Box, { marginTop: 1, children: _jsx(PromptInput, { isActive: overlay === null, running: state.status === 'running', history: promptHistory, commands: commandOptions, cwd: controller.getCwd(), agentMode: state.agentMode, theme: theme, caps: caps, onSubmit: (text) => void handleSubmit(text), onHelp: () => dispatch({ type: 'setOverlay', overlay: 'help' }) }) }));
-    return (_jsx(AppShell, { mode: mode, rows: rows, cols: cols, header: header, viewport: viewport, team: state.team ? (_jsx(TeamPanel, { snapshot: state.team, rows: rows, cols: cols, reducedMotion: reducedMotion, theme: theme, caps: caps })) : null, rail: showRail && state.todos ? (_jsx(TodoPanel, { snapshot: state.todos, width: railWidth, rows: railRows, running: state.status === 'running', reducedMotion: reducedMotion, theme: theme, caps: caps })) : null, strip: showStrip && state.todos ? (_jsx(TodoStrip, { snapshot: state.todos, cols: cols, theme: theme, caps: caps })) : null, toast: _jsx(BottomStatusRow, { mode: mode, toasts: state.toasts, 
+    return (_jsx(AppShell, { mode: mode, rows: rows, cols: cols, header: header, viewport: viewport, team: state.team ? (_jsx(TeamPanel, { snapshot: state.team, rows: rows, cols: cols, reducedMotion: viewReducedMotion, theme: theme, caps: caps })) : null, rail: showRail && state.todos ? (_jsx(TodoPanel, { snapshot: state.todos, width: railWidth, rows: railRows, running: running, reducedMotion: viewReducedMotion, theme: theme, caps: caps })) : null, strip: showStrip && state.todos ? (_jsx(TodoStrip, { snapshot: state.todos, cols: cols, theme: theme, caps: caps })) : null, toast: _jsx(BottomStatusRow, { mode: mode, toasts: state.toasts, 
             // `!overlayNode` suppresses the line while an overlay owns the screen:
             // the full-screen branch replaces the whole viewport with the overlay,
             // and a working line under a settings screen is noise attached to a
             // surface the run is not visible on. (Inline overlays are part of the
             // document flow, so there the suppression is conservative rather than
             // necessary — P2-5.)
-            activity: running && !overlayNode ? (_jsx(ActivityLine, { startedAt: runStartedAt.current, elapsedMs: elapsedMs, reducedMotion: reducedMotion, runningTool: runningTool, theme: theme, caps: caps })) : null, 
+            //
+            // THE CONDITION IS `activityVisible`, THE SAME CONST THE SUPPRESSION
+            // SIGNAL IS DERIVED FROM (D-4): inlining it here again is how the two
+            // drift apart, and the drift is silent in whichever branch is not
+            // edited.
+            activity: activityVisible ? (_jsx(ActivityLine, { startedAt: runStartedAt.current, elapsedMs: elapsedMs, reducedMotion: reducedMotion, runningTool: runningTool, theme: theme, caps: caps })) : null, 
             // PRESENCE IS DECIDED HERE, NOT BY `UpdateLine` RETURNING `null`
             // (C-15 / cli-auto-update P0-1 / D-19). `BottomStatusRow` tests this
             // prop for truthiness, and a React element is truthy however it

package/dist/ui/Transcript.js

@@ -138,6 +138,21 @@ function EntryViewImpl({ entry, prev, expanded, thinkingVisible, reducedMotion,
             // While text streams, the spinner IS the role marker. Braille dots are
             // both an animation and a Unicode-only glyph, so reduced motion and an
             // ASCII terminal fall back to the same static marker (P2-11 / A-10).
+            //
+            // `reducedMotion` ARRIVES PRE-WIDENED FROM `App`: it is now
+            // `cfg.reducedMotion || activityVisible`, so this marker is static for the
+            // whole of every run and the activity row above the composer carries the
+            // one animation (single-spinner-while-running D-2). Nothing here changes —
+            // the expression already meant "do not animate here".
+            //
+            // THAT IS SAFE FOR `<Static>` BY CONSTRUCTION, not by luck: a settled
+            // prefix is printed once and can never be re-printed, so a boolean that
+            // changed how an already-printed entry renders would tear the history.
+            // `computeSettledCount` below breaks on EVERY condition that makes an
+            // entry animate (`:84` streaming, `:85` running tool, `:91` active team,
+            // `:104` retry, `:109` live fast), so every animating entry is in the live
+            // region and every entry in `<Static>` already has `animate === false` on
+            // both sides of the flip. Weakening a break clause breaks that proof.
             const animate = entry.streaming && !reducedMotion && caps.unicode;
             return frame(animate ? _jsx(Spinner, { type: "dots" }) : glyphs.assistant, theme.primary, _jsx(AssistantEntry, { text: entry.text, thinking: entry.thinking, thinkingOpen: entry.thinkingOpen, thinkingVisible: thinkingVisible, streaming: entry.streaming, aborted: entry.aborted, 
                 // `EntryViewImpl` hands each renderer EXPLICIT SCALAR PROPS, so

package/dist/ui/entries/FastCard.js

@@ -1,4 +1,4 @@
-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";
 /**
  * FastCard — one fast-model review in the transcript (fast-model-tier §6).
  *
@@ -76,7 +76,25 @@ function FastCardImpl(props) {
     const duration = durationMs === undefined ? '' : `  ${glyphs.midDot}  ${formatDuration(durationMs)}`;
     const head = `fast review #${reviewIndex}  ${glyphs.midDot}  ${model}  ${glyphs.midDot}  turn ${turn}${duration}`;
     const showBody = status === 'advice' && text !== undefined && text.trim().length > 0;
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { flexDirection: "row", children: [_jsx(Text, { color: theme.accent, bold: true, children: "fast" }), live && !reducedMotion && caps.unicode ? (_jsxs(Text, { color: color, children: ['  ', _jsx(Spinner, { type: "dots" }), " ", head] })) : (_jsxs(Text, { color: theme.muted, wrap: "truncate", children: ['  ', live ? `${glyphs.spinnerStill} ` : '', head] }))] }), showBody ? (_jsx(Box, { flexDirection: "column", flexShrink: 0, paddingLeft: 1, ...railBorderProps(glyphs.railVertical, theme.border), children: textRows(text).map((line, index) => (_jsx(Text, { color: theme.primary, children: line }, index))) })) : (_jsx(Box, { flexDirection: "column", flexShrink: 0, paddingLeft: 1, children: _jsx(Text, { color: color, wrap: "truncate", children: statusLine(props) }) }))] }));
+    // COLOUR TRACKS `live`, MOTION TRACKS `animate` — one headline, two separate
+    // decisions (single-spinner-while-running C-1 / D-7).
+    //
+    // These used to be two whole `<Text>` elements, so the still branch also
+    // demoted the head to `theme.muted`. That was harmless while stillness meant
+    // "the user set reducedMotion", but `App` now widens the prop to "this frame
+    // does not animate here" for the whole of every run — and under the old shape
+    // that would have greyed out every live fast review for the whole run, losing
+    // the status colour along with the motion.
+    //
+    // Three things are load-bearing and all three are silent if dropped: the
+    // leading two-space gutter that separates the head from the bold `fast` label,
+    // the single space after the marker (the still form bakes it into its template
+    // string), and `head` itself. `wrap="truncate"` now applies to the animated
+    // path too, which it did not before: it is what the still branch always did,
+    // it is the behaviour this card has in every state that is now common, and an
+    // unbounded wrap inside a one-row headline is the worse failure.
+    const animate = live && !reducedMotion && caps.unicode;
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { flexDirection: "row", children: [_jsx(Text, { color: theme.accent, bold: true, children: "fast" }), _jsxs(Text, { color: live ? color : theme.muted, wrap: "truncate", children: ['  ', animate ? (_jsxs(_Fragment, { children: [_jsx(Spinner, { type: "dots" }), ' '] })) : live ? (`${glyphs.spinnerStill} `) : (''), head] })] }), showBody ? (_jsx(Box, { flexDirection: "column", flexShrink: 0, paddingLeft: 1, ...railBorderProps(glyphs.railVertical, theme.border), children: textRows(text).map((line, index) => (_jsx(Text, { color: theme.primary, children: line }, index))) })) : (_jsx(Box, { flexDirection: "column", flexShrink: 0, paddingLeft: 1, children: _jsx(Text, { color: color, wrap: "truncate", children: statusLine(props) }) }))] }));
 }
 /**
  * `React.memo` with the DEFAULT comparator (tui-render-performance L2 / R3).

package/dist/ui/overlays/HelpOverlay.js

@@ -33,7 +33,7 @@ const COMMANDS = [
         'Todo planning: status, switches, the rail, follow-through',
     ],
     ['/tools', 'List active tools'],
-    ['/clear', 'Clear the visible transcript'],
+    ['/clear', 'Clear the visible transcript and the todo panel'],
     ['/reset', 'New conversation'],
     ['/cwd [dir]', 'Show or change the tool working directory'],
     ['/save [file]', 'Save the session to JSON'],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aragon-agent/cli",
-  "version": "0.5.11",
+  "version": "0.5.12",
   "description": "AragonAgent CLI — a Claude-Code / Codex-style interactive terminal UI (TUI) on top of the @aragon-agent/core engine. Installable and runnable via npm / npx.",
   "license": "MIT",
   "author": "AragonAgent contributors",
@@ -52,7 +52,7 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@aragon-agent/core": "^0.2.11",
+    "@aragon-agent/core": "^0.2.12",
     "chalk": "^5.6.2",
     "cli-highlight": "^2.0.0",
     "commander": "^12.1.0",