aiden-runtime 4.7.0 → 4.8.1

package/README.md

@@ -242,7 +242,18 @@ Remove-Item -Recurse -Force $env:LOCALAPPDATA\aiden
 
 <br>
 
-<img width="938" height="1049" alt="preview (3)" src="https://github.com/user-attachments/assets/93af497d-0fe3-4e2b-aa73-7739682c18b1" />
+<img width="938" height="1049" alt="preview (3)" src="https://github.com/user-attachments/assets/4e32ae38-74ad-433d-b986-0a15bc2dffec" />
+
+
+## Recommended terminal setup
+
+For best visual rendering, Aiden looks crispest with:
+
+- **Font:** Cascadia Code, JetBrains Mono, or Fira Code at 13–14pt
+- **Terminal:** Windows Terminal, iTerm2, or a modern emulator with truecolor support
+- **Color depth:** truecolor (24-bit) — most modern terminals support this
+
+Aiden works on any terminal but glyphs and color depth may degrade gracefully on older / minimal setups.
 
 
 ## Setup wizard

package/dist/cli/v4/aidenCLI.js

@@ -1089,12 +1089,30 @@ async function buildAgentRuntime(cliOpts, opts) {
     catch {
         // Missing or unreadable file is fine — no permanent allowlist yet.
     }
-    // Auxiliary client (compression / risk-assessment cheap LLM). Default to
-    // the same provider/model as the main loop — the resolver hands the
-    // auxiliary client a separately-configured cheap model later (v4.1).
+    // Auxiliary client (compression / risk-assessment / session-summary
+    // / skill-describe). v4.8.0 Slice 11 — route through Groq's cheap
+    // 8B model as the default, with the parent provider/model as the
+    // fallback when Groq isn't configured. Fixes the ChatGPT Plus +
+    // gpt-5 routing bug: pre-Slice-11 auxiliary inherited the parent
+    // (codex backend, accepts only `gpt-5-codex`/`gpt-4.1-mini`/etc.)
+    // and every aux call returned a 400 model-not-supported. Groq is
+    // cheap, fast, and reliable for the cheap classify/summarise jobs
+    // auxiliary is designed for. If the user has no GROQ_API_KEY, the
+    // resolver throws and we fall through to the parent — no regression
+    // for non-codex users.
+    //
+    // Skip the parent fallback when the parent IS already the Groq cheap
+    // model — same identity attempt twice is just noise in the verbose
+    // log. (Resolver dedup; the auxiliary client itself doesn't filter.)
+    const AUX_DEFAULT_PROVIDER = 'groq';
+    const AUX_DEFAULT_MODEL = 'llama-3.1-8b-instant';
+    const parentSameAsDefault = providerId === AUX_DEFAULT_PROVIDER && modelId === AUX_DEFAULT_MODEL;
     const auxiliaryClient = new auxiliaryClient_1.AuxiliaryClient({
-        defaultProvider: providerId,
-        defaultModel: modelId,
+        defaultProvider: AUX_DEFAULT_PROVIDER,
+        defaultModel: AUX_DEFAULT_MODEL,
+        fallbacks: parentSameAsDefault
+            ? []
+            : [{ providerId, modelId }],
         // Phase 21 #5: ensure the auxiliary path also honors entry.oauth →
         // tokenStore. If a user runs the auxiliary cheap LLM through an
         // OAuth-only provider, omitting `paths` would skip the fast-path
@@ -1113,6 +1131,9 @@ async function buildAgentRuntime(cliOpts, opts) {
     approvalEngine['callbacks'] = {
         promptUser: callbacks.promptApproval,
         riskAssess: callbacks.riskAssess,
+        // v4.8.0 Phase 2.5 — paint the structured approval row before the
+        // existing y/n prompt runs. Additive; promptApproval flow unchanged.
+        onUiEvent: (name, args) => display.renderUiEvent(name, args),
         // Phase 16f: append-on-disk for "Allow always" choices. Single-process
         // REPL — atomic write via tmp-then-rename.
         persistAllow: (tool, signature) => {
@@ -1237,6 +1258,12 @@ async function buildAgentRuntime(cliOpts, opts) {
     // tools return undefined → agent treats them as non-mutating (no
     // checkpoint flag); plugin authors must declare `mutates` honestly.
     const resolveMutates = (name) => toolRegistry.get(name)?.mutates;
+    // v4.8.0 Phase 2.1 — resolver for the uiOnly flag. The dispatch
+    // loop branches on `=== true` so any non-true value (undefined for
+    // unknown tools, false for explicit executables) keeps the normal
+    // executable path. Closure-captures the live registry, same as
+    // resolveMutates / resolveToolset.
+    const resolveUiOnly = (name) => toolRegistry.get(name)?.uiOnly;
     // ── Phase 16b.4: assemble system-prompt context ─────────────────────
     // PromptBuilder needs SOUL.md (read at build time from `paths.soulMd`),
     // a frozen MemorySnapshot (loaded once at boot — same lifecycle as
@@ -1379,6 +1406,7 @@ async function buildAgentRuntime(cliOpts, opts) {
         resolveVerifiedFlag,
         resolveToolset,
         resolveMutates,
+        resolveUiOnly,
         providerId,
         modelId,
         // Phase 16b.4: wire PromptBuilder so SOUL.md actually reaches the LLM.
@@ -1470,6 +1498,7 @@ async function buildAgentRuntime(cliOpts, opts) {
         resolveVerifiedFlag,
         resolveToolset,
         resolveMutates,
+        resolveUiOnly,
         // v4.7.0 Phase 2.4 — share the REPL's config-resolved honesty mode
         // with daemon-built agents so autonomous turns honour the same
         // setting interactive turns do.
@@ -1576,6 +1605,7 @@ async function buildAgentRuntime(cliOpts, opts) {
             resolveVerifiedFlag,
             resolveToolset,
             resolveMutates,
+            resolveUiOnly,
             runStore: replRunStore,
             instanceId: replInstanceId,
             logger: bootLogger.child('subagent'),
@@ -1650,6 +1680,11 @@ async function buildAgentRuntime(cliOpts, opts) {
         resolveVerifiedFlag,
         resolveToolset,
         resolveMutates,
+        resolveUiOnly,
+        // v4.8.0 Phase 2.5 — emit ui_task_update/ui_task_done events so
+        // subagent activity surfaces as gutter-indented trail rows in the
+        // parent's chat surface alongside its own tool trail.
+        onUiEvent: (name, args) => display.renderUiEvent(name, args),
         runStore: replRunStore,
         instanceId: replInstanceId,
         // v4.6 Phase 2Q-B — REPL parent-run wiring. Reads the same

package/dist/cli/v4/callbacks.js

@@ -21,7 +21,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CliCallbacks = void 0;
 exports.mapBlockerToCard = mapBlockerToCard;
 exports.renderApprovalBox = renderApprovalBox;
-const box_1 = require("./box");
+// v4.8.0 Slice 5 — verbose-mode gate for internal-telemetry dim lines.
+const tokens_1 = require("./design/tokens");
 async function defaultPrompts() {
     // eslint-disable-next-line @typescript-eslint/no-var-requires
     const inq = require('@inquirer/prompts');
@@ -379,11 +380,12 @@ Reply with ONE word: safe, caution, or dangerous.`;
          * own SKILL.md (best-effort parse; falls back to id slice).
          */
         this.onSkillCandidate = (candidate) => {
+            // v4.8.0 Slice 5 — internal-telemetry cue; user already discovers
+            // candidates via /skills review. Surface only in verbose mode.
+            if (!(0, tokens_1.isVerbose)())
+                return;
             let name = candidate.id.slice(0, 8);
             try {
-                // Tier-3.1c sweep: do not import here — chatSession's display
-                // wraps strings, and the SKILL.md frontmatter is plain enough
-                // that a quick regex is fine for the cue line.
                 const m = /\bname\s*:\s*([^\n]+)/.exec(candidate.skillContent);
                 if (m)
                     name = m[1].trim();
@@ -402,6 +404,11 @@ Reply with ONE word: safe, caution, or dangerous.`;
                 this.display.warn('[compress] auxiliary call failed; history unchanged');
                 return;
             }
+            // v4.8.0 Slice 5 — successful auto-compress is technical telemetry
+            // (refused / failed variants stay visible since they explain action
+            // outcomes; success is just bookkeeping).
+            if (!(0, tokens_1.isVerbose)())
+                return;
             this.display.dim(`[compress] removed ${result.removedMessageCount} msgs, kept ${result.preservedRecentCount} recent (~${result.summaryTokens} tok)`);
         };
         /** Budget warning sink. Caution = dim line, warning = visible warn. */
@@ -410,7 +417,9 @@ Reply with ONE word: safe, caution, or dangerous.`;
             if (level === 'warning') {
                 this.display.warn(`Budget: ${msg} — approaching the cap.`);
             }
-            else {
+            else if ((0, tokens_1.isVerbose)()) {
+                // v4.8.0 Slice 5 — caution-level per-turn dim line is verbose-only;
+                // the actionable 'warning' tier above continues to fire unchanged.
                 this.display.dim(`[budget] ${msg}`);
             }
         };
@@ -424,6 +433,10 @@ Reply with ONE word: safe, caution, or dangerous.`;
         this.onMemoryRefresh = (files) => {
             // Phase v4.1.2: argument switched from single-string-or-'both' to
             // the full sorted set of dirty files (SOUL.md joined the rotation).
+            // v4.8.0 Slice 5 — internal cache refresh; the user's "✓ Saved"
+            // confirmation lands separately when memory_add returns verified=true.
+            if (!(0, tokens_1.isVerbose)())
+                return;
             const label = files.length > 0 ? files.join(', ') : 'none';
             this.display.dim(`[memory] refreshed system prompt (${label})`);
         };
@@ -616,23 +629,29 @@ const APPROVAL_BOX_WIDTH = 64;
 // and the user wouldn't see they were viewing a partial value.
 const APPROVAL_ARGS_LIMIT = 50;
 /**
- * Render an approval request as a yellow-bordered rounded box. Pure —
- * returns the multi-line string; caller writes it. Args are truncated
- * to APPROVAL_ARGS_LIMIT chars for display only; the full args stay
- * with the tool call.
+ * Render an approval request with the Aiden-native framed-panel chrome
+ * (Slice 6) — orange left bar, no closing corners, footer hint always
+ * present. Token-sourced from cli/v4/design/tokens.ts. Returns the
+ * multi-line string; caller writes it. Args are truncated to
+ * APPROVAL_ARGS_LIMIT chars for display only; the full args stay with
+ * the tool call. Colour discipline: brand (bar + title + key glyphs),
+ * tier-semantic (badge), muted (everything else) — ≤3 distinct colours.
  */
 function renderApprovalBox(req, display) {
-    const W = APPROVAL_BOX_WIDTH;
-    const top = display.paint((0, box_1.boxTopTitled)('Approval required', W), 'warn');
-    const bot = display.paint((0, box_1.boxBottom)(W), 'warn');
-    const side = (content) => {
-        const raw = (0, box_1.boxLine)(content, W);
-        const left = raw.slice(0, 1);
-        const inner = raw.slice(1, raw.length - 1);
-        const right = raw.slice(raw.length - 1);
-        return `${display.paint(left, 'warn')}${inner}${display.paint(right, 'warn')}`;
-    };
-    const tierBadge = badgeForTier(req.riskTier);
+    // v4.8.0 Slice 6 hotfix:
+    //   - Drop panel title + tier badge (Phase 2.5 ui_approval_request event
+    //     row above already announces the headline + tier-by-colour).
+    //   - Lead with structured key/value rows; unify inner-padding so keys
+    //     and dividers share the same left edge.
+    //   - Footer hint matches the actual inquirer select() mechanic
+    //     (arrow-key navigation), not fictional y/a/n keystrokes.
+    //   - Leading + trailing blank lines for vertical breathing room
+    //     between the event row above and the inquirer picker below.
+    const indent = '  ';
+    const innerW = APPROVAL_BOX_WIDTH;
+    const bar = display.applyColors(tokens_1.glyphs.panel.bar, 'brand');
+    const line = (content) => `${indent}${bar}  ${content}`;
+    const divider = display.muted(tokens_1.glyphs.chrome.hLine.repeat(innerW - 2));
     let argsPreview = '';
     try {
         argsPreview = JSON.stringify(req.args);
@@ -643,17 +662,19 @@ function renderApprovalBox(req, display) {
     if (argsPreview.length > APPROVAL_ARGS_LIMIT) {
         argsPreview = argsPreview.slice(0, APPROVAL_ARGS_LIMIT - 1) + '…';
     }
+    // Key-value rows. Key column padded to 12 cells for vertical alignment.
+    const KEY_W = 12;
+    const kv = (k, v) => `${display.muted(k.padEnd(KEY_W))}${v}`;
     const lines = [
-        top,
-        side(''),
-        side(` ${display.muted('Tool:')} ${req.toolName}${tierBadge ? '  ' + tierBadge : ''}`),
+        line(kv('tool', req.toolName)),
     ];
-    if (req.reason) {
-        lines.push(side(` ${display.muted('Reason:')} ${req.reason}`));
-    }
-    lines.push(side(` ${display.muted('Args:')} ${argsPreview}`));
-    lines.push(side(''));
-    lines.push(side(` ${display.brand('[y]')} allow once  ${display.brand('[a]')} allow always  ${display.brand('[n]')} deny`));
-    lines.push(bot);
-    return lines.join('\n');
+    if (req.reason)
+        lines.push(line(kv('reason', req.reason)));
+    lines.push(line(kv('args', argsPreview)));
+    lines.push(line(divider));
+    lines.push(line(display.muted('↑↓ navigate · enter select · esc cancel')));
+    // Leading + trailing blank lines: caller already adds one trailing
+    // newline, so producing '\n<panel>\n' yields one blank above + one
+    // blank below once the caller's own '\n' lands.
+    return '\n' + lines.join('\n') + '\n';
 }

package/dist/cli/v4/chatSession.js

@@ -234,6 +234,11 @@ class ChatSession {
         // turn's elapsed ms (rendered in the trailing footer) and the
         // provider used last turn (so a switch surfaces as `groq ──→ together`).
         this.lastTurnElapsedMs = 0;
+        // v4.8.0 Slice 7 — status-footer telemetry. turnCount increments on
+        // every completed turn (success OR failure paths); lastTurnOutcome
+        // maps result.finishReason to a colour-kind hint for the state dot.
+        this.turnCount = 0;
+        this.lastTurnOutcome = 'ok';
         this.lastFooterProvider = null;
         /**
          * Phase v4.1.2-memory-AB:
@@ -902,13 +907,15 @@ class ChatSession {
         // Phase 22 Task 4: status bar reflects the live phase. Set on
         // entry, cleared in both success and error paths below.
         this.setStatusState({ kind: 'generating', sinceMs: Date.now() });
-        // Tier-3.1a: dim full-width rule between the user input echo and
-        // the agent reply for clean visual rhythm.
-        this.opts.display.write(`  ${this.opts.display.rule()}\n`);
-        // Phase 26.2.3 — blank line between the user-input echo and the
-        // spinner / response so the eye sees user → agent as separate
-        // beats instead of butting together.
-        this.opts.display.write('\n');
+        // v4.8.1 Slice 2 hotfix #3 — removed the prior Tier-3.1a dim
+        // rule between the user input echo and the agent reply. The dim
+        // colour read as a near-blank row in live smoke, and stacked
+        // with the indicator's erase-blank residue produced two visible
+        // separator rows above `▎ Aiden`. With the rule gone, the layout
+        // is:
+        //   user input → [indicator paints, erases — 1 blank row] → ▎ Aiden
+        // = exactly one blank row between user input and Aiden header,
+        // matching the rhythm Shiva flagged in smoke.
         const turnStartedAt = Date.now();
         const userMsg = { role: 'user', content: userInput };
         // Apply any queued system prompts (from skill slash commands) by
@@ -991,6 +998,11 @@ class ChatSession {
         const indicator = this.opts.display.activityIndicator('thinking');
         let indicatorStopped = false;
         let streamingActive = false;
+        // v4.8.0 Phase 2.3 fix-2 — clear the ui-event flag at turn-start.
+        // The existing reset sites in Display (streamPartial first-delta +
+        // streamComplete) only fire on text-streaming turns; tool-only
+        // turns leave the flag sticky. This is the authoritative reset.
+        this.opts.display.resetUiTurnState();
         // v4.1.5 Issue O — track whether this turn had any tool calls so
         // we can emit a single muted rule between the tool trail and the
         // reply header. Set true when the first tool's `before` phase
@@ -1187,6 +1199,19 @@ class ChatSession {
                         this.opts.display.streamToolIndicator(call.name);
                     }
                     : undefined,
+                // v4.8.0 Phase 2.3 fix-2 — uiOnly events route to the display
+                // layer. The Phase 2.1 dispatch branch in aidenAgent.ts skips
+                // onToolCall('before'), which is what normally fires
+                // beforeFirstToolHook → stopIndicatorOnce. Without this stop
+                // call, the 250ms indicator tick walks up 2 lines and erases
+                // our paint within a quarter-second. Stop the indicator here,
+                // mirroring how a first regular tool call stops it. Phase 2.3
+                // handles ui_task_update + ui_task_done; the other 5 event
+                // names land in Phase 2.4 (renderer silent-ignores them).
+                onUiEvent: (name, args) => {
+                    stopIndicatorOnce();
+                    this.opts.display.renderUiEvent(name, args);
+                },
                 onProgress: streamingEnabled
                     ? (outputTokens, maxTokens) => {
                         if (indicatorStopped === false)
@@ -1316,6 +1341,12 @@ class ChatSession {
             }
             this.setStatusState({ kind: 'ready' });
             this.lastTurnElapsedMs = Date.now() - turnStartedAt;
+            // v4.8.0 Slice 7 — record per-turn outcome for the status dot.
+            this.turnCount += 1;
+            this.lastTurnOutcome =
+                result.finishReason === 'stop' ? 'ok' :
+                    result.finishReason === 'budget_exhausted' ? 'warn' :
+                        result.finishReason === 'interrupted' ? 'muted' : 'error';
             // v4.5 Phase 8b — surface a deferred daemon-scheduling tip
             // queued at turn start. Renders AFTER the agent's response per
             // Q-P8b-3(b) — the user reads the answer first, then sees the
@@ -1414,6 +1445,10 @@ class ChatSession {
             }
             this.setStatusState({ kind: 'ready' });
             this.lastTurnElapsedMs = Date.now() - turnStartedAt;
+            // v4.8.0 Slice 7 — error path also bumps the turn counter and
+            // records a red state-dot outcome for the next footer render.
+            this.turnCount += 1;
+            this.lastTurnOutcome = 'error';
             // v4.1.5+ Path A — finalize the loop trace on the error path
             // too. Loop patterns that ended in an error are exactly the
             // ones most worth capturing for diagnosis.
@@ -1614,6 +1649,12 @@ class ChatSession {
         }
         catch { /* never let a missing marker crash boot */ }
         // Bottom prompt hint — final line of the boot card.
+        // v4.8.0 Slice 10d — full-width muted `─` divider between the
+        // boot card (parchment / capability card / two-column block) and
+        // the input hint prevents the boot chrome from merging visually
+        // with the active prompt. Pattern: blank · rule · blank · hint.
+        display.write('\n');
+        display.write(`  ${display.rule()}\n`);
         display.write('\n');
         display.write(display.bottomPromptHint() + '\n');
     }
@@ -1694,12 +1735,18 @@ class ChatSession {
         }
         const usedTokens = this.modelMetadata.estimateMessageTokens(this.history);
         const maxTokens = limits.contextLength;
-        display.write(display.statusFooter({
+        // v4.8.0 Slice 7 hotfix — predictable 1-blank-line rhythm: one
+        // blank above the footer (visual breath after the reply), one
+        // blank below (before the next prompt).
+        display.write('\n' + display.statusFooter({
             provider,
             model,
             ctxUsed: usedTokens,
             ctxMax: maxTokens,
             elapsedMs: this.lastTurnElapsedMs,
+            turnCount: this.turnCount,
+            sessionMs: Date.now() - this.startedAt,
+            state: this.lastTurnOutcome,
         }) + '\n\n');
     }
     // ── Input ──────────────────────────────────────────────────────────

package/dist/cli/v4/commands/help.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.help = exports.SUBSECTION_MAP = exports.SUBSECTION_ORDER = void 0;
 exports.subsectionFor = subsectionFor;
+const framedPanel_1 = require("../display/framedPanel");
 /**
  * Order matters: sections render in this order. Commands within a
  * section render in registration (alphabetical via registry.list)
@@ -98,25 +99,35 @@ exports.help = {
         for (const c of system) {
             buckets.get(subsectionFor(c.name)).push(c);
         }
-        // Tier-3.1: gate icon column on AIDEN_UI_ICONS=1 (default OFF).
+        // v4.8.0 Slice 4 — every section renders as an Aiden-native framed
+        // panel: left orange accent bar, title + count subtitle, command
+        // rows, footer hint always present. AIDEN_UI_ICONS still respected
+        // for the inline glyph column. Sections stack vertically; one
+        // blank line between them comes from the panel's trailing newline.
         const showIcons = process.env.AIDEN_UI_ICONS === '1';
+        const toRows = (cmds) => cmds.map((c) => ({
+            command: `${showIcons ? `${c.icon ?? ' '} ` : ''}/${c.name}`,
+            description: c.description,
+        }));
         for (const sec of exports.SUBSECTION_ORDER) {
             const cmds = buckets.get(sec);
             if (cmds.length === 0)
                 continue;
-            ctx.display.dim(`── ${sec} ──`);
-            for (const c of cmds) {
-                const prefix = showIcons ? `${c.icon ?? ' '} ` : '';
-                ctx.display.write(`  ${prefix}/${c.name.padEnd(14)} ${c.description}\n`);
-            }
+            ctx.display.write((0, framedPanel_1.renderFramedPanel)({
+                title: sec,
+                subtitle: `${cmds.length} ${cmds.length === 1 ? 'command' : 'commands'}`,
+                rows: toRows(cmds),
+                footer: 'type /<name> to run · /help for this list',
+            }));
             ctx.display.write('\n');
         }
         if (skill.length > 0) {
-            ctx.display.dim('── Skills ──');
-            for (const c of skill) {
-                const prefix = showIcons ? '⚡ ' : '';
-                ctx.display.write(`  ${prefix}/${c.name.padEnd(14)} ${c.description}\n`);
-            }
+            ctx.display.write((0, framedPanel_1.renderFramedPanel)({
+                title: 'Skills',
+                subtitle: `${skill.length} ${skill.length === 1 ? 'command' : 'commands'}`,
+                rows: toRows(skill),
+                footer: 'type /<name> to run · /skills list to browse installed skills',
+            }));
         }
         return {};
     },

package/dist/cli/v4/commands/runs.js

@@ -35,6 +35,7 @@ const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const daemon_1 = require("../../../core/v4/daemon");
 const paths_1 = require("../../../core/v4/paths");
+const table_1 = require("../table");
 const noopOut = (s) => { process.stdout.write(s); };
 const noopErr = (s) => { process.stderr.write(s); };
 async function runRunsSubcommand(action, args, argv, opts = {}) {
@@ -74,18 +75,12 @@ function cmdList(runStore, argv, out) {
         sessionIdPrefix: argv.trigger,
         topLevelOnly: !includeChildren,
     });
-    if (rows.length === 0) {
-        out('No runs match the filter.\n');
-        return 0;
-    }
-    out(`${'runId'.padEnd(6)}  ${'status'.padEnd(11)}  ${'finish'.padEnd(11)}  ${'started'.padEnd(20)}  sessionId\n`);
-    for (const r of rows) {
-        const started = new Date(r.startedAt).toISOString().slice(0, 19) + 'Z';
-        const finish = r.finishReason ?? '-';
-        // v4.6 Phase 2Q-B — child-count badge. Only relevant for the
-        // top-level view (when --include-children is OFF). Skipped on
-        // the flat view to avoid double-counting visual weight: in flat
-        // mode the children are already on screen as their own rows.
+    // v4.8.0 Slice 3 — migrate from padEnd string concatenation to the
+    // framed table primitive. Title + count in the top border; empty
+    // state paints a framed message so layout weight matches populated
+    // runs. The trigger-badge (child-count summary) becomes part of the
+    // sessionId cell's `format` so column widths still auto-fit.
+    const tableRows = rows.map((r) => {
         let badge = '';
         if (!includeChildren) {
             const { total, completed } = runStore.countChildren(r.id);
@@ -93,12 +88,31 @@ function cmdList(runStore, argv, out) {
                 badge = `  (${total} ${total === 1 ? 'child' : 'children'}, ${completed} OK)`;
             }
         }
-        out(`${String(r.id).padEnd(6)}  ${r.status.padEnd(11)}  ${finish.padEnd(11)}  ${started.padEnd(20)}  ${r.sessionId}${badge}\n`);
+        return {
+            runId: String(r.id),
+            status: r.status,
+            finish: r.finishReason ?? '-',
+            started: new Date(r.startedAt).toISOString().slice(0, 19) + 'Z',
+            sessionId: r.sessionId + badge,
+        };
+    });
+    out((0, table_1.renderTable)(tableRows, [
+        { key: 'runId', header: 'runId', align: 'left' },
+        { key: 'status', header: 'status', align: 'left' },
+        { key: 'finish', header: 'finish', align: 'left' },
+        { key: 'started', header: 'started', align: 'left' },
+        { key: 'sessionId', header: 'sessionId', align: 'left', flex: true },
+    ], {
+        title: 'Recent runs',
+        totalCount: `${rows.length} ${rows.length === 1 ? 'run' : 'runs'}`,
+        emptyMessage: 'no runs match the filter',
+    }));
+    if (rows.length > 0) {
+        const hint = includeChildren
+            ? '(parents + sub-agent children)'
+            : '(top-level; use --include-children for sub-agents)';
+        out(`  ${hint}\n`);
     }
-    const hint = includeChildren
-        ? ' (parents + sub-agent children)'
-        : ' (top-level; use --include-children for sub-agents)';
-    out(`\n${rows.length} run${rows.length === 1 ? '' : 's'} shown${hint}\n`);
     return 0;
 }
 // ── show ──────────────────────────────────────────────────────────────────
@@ -205,13 +219,17 @@ function cmdStats(db, out) {
             COUNT(*) AS n
        FROM runs
       WHERE status = 'completed' AND completed_at IS NOT NULL`).get();
-    out('Run status counts:\n');
-    if (counts.length === 0) {
-        out('  (no runs recorded)\n');
-    }
-    for (const r of counts) {
-        out(`  ${r.status.padEnd(12)}  ${r.c}\n`);
-    }
+    // v4.8.0 Slice 3 — framed table replaces the padEnd block. Right-
+    // align the count column so multi-digit totals don't break visual
+    // rhythm. Empty state paints a framed message.
+    out((0, table_1.renderTable)(counts.map((r) => ({ status: r.status, count: String(r.c) })), [
+        { key: 'status', header: 'status', align: 'left' },
+        { key: 'count', header: 'count', align: 'right' },
+    ], {
+        title: 'Run status counts',
+        totalCount: `${counts.length} ${counts.length === 1 ? 'status' : 'statuses'}`,
+        emptyMessage: 'no runs recorded',
+    }));
     if (completed.n > 0 && completed.mean !== null) {
         out('\nCompleted-run duration (ms):\n');
         out(`  mean  ${Math.round(completed.mean)}\n`);

package/dist/cli/v4/commands/skills.js

@@ -35,17 +35,17 @@ exports.skills = {
                 return {};
             }
             const skills = await ctx.skillLoader.list();
-            if (skills.length === 0) {
-                ctx.display.dim('(no skills installed)');
-                return {};
-            }
-            ctx.display.info(`Installed skills (${skills.length}):`);
+            // v4.8.0 Slice 3 — title + count in the top border replaces the
+            // separate `Installed skills (N):` info line. Empty state paints
+            // a framed message so layout weight matches populated tables.
             ctx.display.write((0, table_1.renderTable)(skills.map((s) => ({ name: s.name, description: s.description ?? '' })), [
                 { key: 'name', header: 'Name', align: 'left', minWidth: 16 },
-                // Tier-3.1b: drop the legacy `truncate: 60` cap so the
-                // description column flexes to fill available width.
                 { key: 'description', header: 'Description', align: 'left', flex: true },
-            ]));
+            ], {
+                title: 'Skills',
+                totalCount: `${skills.length} installed`,
+                emptyMessage: 'no skills installed',
+            }));
             return {};
         }
         if (sub === 'view') {
@@ -102,15 +102,7 @@ exports.skills = {
         const store = new candidateStore_1.CandidateStore();
         if (sub === 'review') {
             const candidates = await store.list();
-            if (candidates.length === 0) {
-                ctx.display.dim('(no pending candidates — mined skills appear here after a successful 3+ tool turn)');
-                return {};
-            }
-            ctx.display.info(`Pending mined candidates (${candidates.length}):`);
             ctx.display.write((0, table_1.renderTable)(candidates.map((c) => {
-                // Pull the name + 1-line description from the candidate's
-                // own SKILL.md so the table reflects what the user will
-                // accept verbatim.
                 let name = '(unparsed)';
                 let description = '';
                 try {
@@ -134,7 +126,13 @@ exports.skills = {
                 { key: 'session', header: 'Session', align: 'left' },
                 { key: 'created', header: 'Created', align: 'left' },
                 { key: 'description', header: 'Description', align: 'left', flex: true },
-            ]));
+            ], {
+                title: 'Pending skill candidates',
+                totalCount: `${candidates.length} pending`,
+                emptyMessage: 'no pending candidates — mined skills appear here after a successful 3+ tool turn',
+            }));
+            if (candidates.length === 0)
+                return {};
             ctx.display.dim('Use `/skills view-candidate <id-prefix>` to preview, `/skills accept <id>` to promote, `/skills reject <id> [reason]` to dismiss.');
             return {};
         }

package/dist/cli/v4/commands/update.js

@@ -78,14 +78,26 @@ async function runInstall(ctx) {
         return;
     }
     ctx.display.write(`Installing aiden-runtime v${status.latest} (current: v${status.installed})…\n`);
-    const result = await (0, executeInstall_1.executeInstall)();
+    // v4.8.1 Slice 2 — reuse the v4.8.0 sliding-block shimmer indicator
+    // so the user sees motion while npm install runs (typically 5–15s
+    // on a warm cache, longer on cold). The indicator paints to a TTY
+    // only — non-TTY callers (CI, pipes) see the static "Installing…"
+    // line above and the result row below, no shimmer.
+    const indicator = ctx.display.activityIndicator('updating');
+    let result;
+    try {
+        result = await (0, executeInstall_1.executeInstall)();
+    }
+    finally {
+        indicator.stop();
+    }
     if (result.success) {
         const v = result.installedVersion ?? status.latest;
         ctx.display.write(`\n  ✓ aiden-runtime v${v} installed.\n`);
         ctx.display.dim('Restart Aiden to apply: type /quit then re-run `aiden`.');
         return;
     }
-    ctx.display.warn(result.error ?? 'Install failed (no error message).');
+    ctx.display.write(`\n  ✗ Update failed: ${result.error ?? 'no error message'}\n`);
 }
 // ── v4.5 update system — skip + auto subcommands ───────────────────────────
 async function runSkip(ctx) {