@vincemakes/kiso-code 0.1.16 → 0.1.18

package/dist/body.js

@@ -26,8 +26,8 @@
 import { truncateDiff } from "./diff.js";
 import { displayWidth } from "./editor.js";
 import { escapeTerminal, foldResult, foldThinking, palette, renderTerminalGap, renderToolSummary, } from "./render.js";
-/** The spinner glyphs, cycled by the heartbeat. */
-const SPINNER = ["◐", "◓", "◑", "◒"];
+/** The spinner glyphs, cycled by the heartbeat (v3 §05 — the working family). */
+const SPINNER = ["▖", "▘", "▝", "▗"];
 const TOOL_SUMMARY_MAX = 60; // the tool line's parameter summary, chars
 const FRAME_MS = 16; // state changes coalesce to ≥16ms frames
 const HEARTBEAT_MS = 200; // spinner / elapsed cadence
@@ -54,6 +54,16 @@ export class Body {
         this.#active = opts.active();
         if (this.#isActive()) {
             this.#heartbeat = setInterval(() => {
+                // #14/#15: the idle heartbeat PAINTS NOTHING unless an
+                // ANIMATION advances — only a RUNNING tool's glyph/elapsed
+                // changes between beats. The #14 fix skipped an all-frozen
+                // body; #15 widened the skip to ANY no-change body: a cell
+                // that stays unfinished without animating (an unclosed text
+                // or thinking block) would otherwise re-paint the tail AND
+                // the dock every 200ms with zero change — the short-session
+                // leak (measured: 51KB / 46 beats after the recap, LF=0).
+                if (!this.#cells.some((c) => c.kind === "tool" && c.state === "running"))
+                    return;
                 this.#spinnerI = (this.#spinnerI + 1) % SPINNER.length;
                 this.#dirty = true; // the running cells' glyph/elapsed advance
                 this.#scheduleFrame();
@@ -318,7 +328,7 @@ export class Body {
             nextFrozen += 1;
         const tail = this.#cells.slice(nextFrozen);
         const tailHeight = tail.reduce((n, c) => n + this.#cellHeight(c, W), 0);
-        const tailTop = Math.max(1, H - 2 - tailHeight);
+        const tailTop = Math.max(1, H - 3 - tailHeight); // v3 §03: 4 dock rows below
         const writeRow = Math.max(1, tailTop - 1); // the frozen area's bottom row
         let scrolled = 0;
         for (let i = this.#nextFrozen; i < nextFrozen; i += 1) {
@@ -339,7 +349,7 @@ export class Body {
         // scrolls) and the current area, draw the cells at the body's bottom.
         out.push("\x1b[?2026h");
         const clearFrom = Math.min(this.#oldTailTop === 0 ? tailTop : this.#oldTailTop - scrolled, tailTop);
-        for (let row = clearFrom; row <= H - 3; row += 1) {
+        for (let row = clearFrom; row <= H - 4; row += 1) {
             out.push(`\x1b[${row};1H\x1b[0K`);
         }
         let row = tailTop;
@@ -362,13 +372,16 @@ export class Body {
         const p = palette();
         switch (cell.kind) {
             case "user":
-                return [`${p.blue}you> ${escapeTerminal(cell.text)}${p.reset}`];
+                // v3 §02: the user message is a SGR BACKGROUND block, no
+                // prefix — every line carries the block's background
+                // (multi-line whole; resize-safe). Pipes stay plain.
+                return cell.text.split("\n").map((l) => `${p.bg}${escapeTerminal(l)}${p.reset}`);
             case "thinking": {
                 const block = cell.text;
                 const trimmed = escapeTerminal(block.trim());
                 if (trimmed.length <= 100)
                     return [`${p.dim}…${trimmed}${p.reset}`];
-                return [`${p.dim}…${trimmed.slice(0, 100)} (… ${block.length} chars · /think shows full)${p.reset}`];
+                return [`${p.dim}…${trimmed.slice(0, 100)} (${block.length} chars · /think)${p.reset}`];
             }
             case "tool": {
                 const name = escapeTerminal(cell.name);

package/dist/dock.d.ts

@@ -4,14 +4,16 @@
  * implementation: zero dependencies, line-level ANSI, no differential
  * renderer.
  *
- * Layout (H = terminal height): rows 1..H-3 = the scroll region (the body
- * streams and scrolls here, never touching the bottom), row H-2 = the dim
- * dotted separator (╌), row H-1 = the live status bar (or a takeover
- * question), row H = the input line (the blue brick ▌you> + the v2c
- * editor's row — readline is gone from the TTY path). Bottom redraws are
- * wrapped in CSI 2026 (synchronized output) to avoid flicker — the pi
- * trick. The visual identity is the kiso brick motif — ▌ half-block,
- * dotted separator — deliberately NOT the CC rounded frame nor the pi
+ * Layout (H = terminal height): rows 1..H-4 = the scroll region (the body
+ * streams and scrolls here, never touching the bottom), row H-3 = the
+ * upper dim dotted separator (╌), row H-2 = the input line (the blue
+ * brick ▌you> + the v2c editor's row — readline is gone from the TTY
+ * path), row H-1 = the lower dotted separator, row H = the live status
+ * bar (v3 §03: idle "▸ <mode> · /mode to switch · …", running
+ * "▖ working Ns · …"; a takeover question replaces it). Bottom redraws
+ * are wrapped in CSI 2026 (synchronized output) to avoid flicker — the
+ * pi trick. The visual identity is the kiso brick motif — ▌ half-block,
+ * dotted separators — deliberately NOT the CC rounded frame nor the pi
  * editor (ADR-0039 Amendment 2).
  *
  * Pipes / NO_COLOR: the dock never activates; the v2a line mode stays
@@ -42,6 +44,13 @@ export declare class Dock {
     exit(): void;
     /** SIGWINCH: recompute the size, redraw the chrome. */
     onResize(): void;
+    /** v3 §04: bind the editor's slash-command menu state — the menu rows
+     *  render ABOVE the chrome (over the body's bottom rows; the menu
+     *  opens while the buffer is a "/" prefix, when no tail is live). */
+    bindMenu(state: () => {
+        items: readonly import("./editor.js").MenuItem[];
+        selected: number;
+    } | null): void;
     /** The input line's edit column — prompt width + cursor + 1. The
      *  dock's redraw and the body's cursor return both end here, so the
      *  ACTUAL cursor always equals what the editor tracks. The width is
@@ -57,11 +66,10 @@ export declare class Dock {
      *  input line by the caller's readline); clearQuestion() restores. */
     showQuestion(question: string): void;
     clearQuestion(): void;
-    /** The bottom three rows, wrapped in CSI 2026 (synchronized output —
+    /** The bottom four rows, wrapped in CSI 2026 (synchronized output —
      *  the pi trick against flicker). The cursor ends at the input line's
-     *  edit position. v2c: the separator is the dim dotted ╌ (a weaker
-     *  presence than the solid ─), the status line is dim (blue accents
-     *  inside come from the CLI's composition), the input row is the blue
-     *  brick ▌you> + the editor's visible slice. */
+     *  edit position. v3 §03: the upper ╌ row, the input row, the lower
+     *  ╌ row, the status row — the status is dim (blue accents inside
+     *  come from the CLI's composition). */
     redraw(): void;
 }

package/dist/dock.js

@@ -4,14 +4,16 @@
  * implementation: zero dependencies, line-level ANSI, no differential
  * renderer.
  *
- * Layout (H = terminal height): rows 1..H-3 = the scroll region (the body
- * streams and scrolls here, never touching the bottom), row H-2 = the dim
- * dotted separator (╌), row H-1 = the live status bar (or a takeover
- * question), row H = the input line (the blue brick ▌you> + the v2c
- * editor's row — readline is gone from the TTY path). Bottom redraws are
- * wrapped in CSI 2026 (synchronized output) to avoid flicker — the pi
- * trick. The visual identity is the kiso brick motif — ▌ half-block,
- * dotted separator — deliberately NOT the CC rounded frame nor the pi
+ * Layout (H = terminal height): rows 1..H-4 = the scroll region (the body
+ * streams and scrolls here, never touching the bottom), row H-3 = the
+ * upper dim dotted separator (╌), row H-2 = the input line (the blue
+ * brick ▌you> + the v2c editor's row — readline is gone from the TTY
+ * path), row H-1 = the lower dotted separator, row H = the live status
+ * bar (v3 §03: idle "▸ <mode> · /mode to switch · …", running
+ * "▖ working Ns · …"; a takeover question replaces it). Bottom redraws
+ * are wrapped in CSI 2026 (synchronized output) to avoid flicker — the
+ * pi trick. The visual identity is the kiso brick motif — ▌ half-block,
+ * dotted separators — deliberately NOT the CC rounded frame nor the pi
  * editor (ADR-0039 Amendment 2).
  *
  * Pipes / NO_COLOR: the dock never activates; the v2a line mode stays
@@ -75,8 +77,8 @@ export class Dock {
         }
         const H = this.#height;
         process.stdout.write("\x1b[r"); // reset the scroll region
-        for (let row = H - 2; row <= H; row += 1) {
-            process.stdout.write(`\x1b[${row};1H\x1b[0K`); // clear the three rows
+        for (let row = H - 3; row <= H; row += 1) {
+            process.stdout.write(`\x1b[${row};1H\x1b[0K`); // clear the four rows
         }
         process.stdout.write(`\x1b[${H};1H`);
     }
@@ -88,6 +90,13 @@ export class Dock {
         this.#width = process.stdout.columns ?? this.#width;
         this.redraw();
     }
+    #menuState = null;
+    /** v3 §04: bind the editor's slash-command menu state — the menu rows
+     *  render ABOVE the chrome (over the body's bottom rows; the menu
+     *  opens while the buffer is a "/" prefix, when no tail is live). */
+    bindMenu(state) {
+        this.#menuState = state;
+    }
     /** The input line's edit column — prompt width + cursor + 1. The
      *  dock's redraw and the body's cursor return both end here, so the
      *  ACTUAL cursor always equals what the editor tracks. The width is
@@ -122,12 +131,11 @@ export class Dock {
         this.#question = null;
         this.redraw();
     }
-    /** The bottom three rows, wrapped in CSI 2026 (synchronized output —
+    /** The bottom four rows, wrapped in CSI 2026 (synchronized output —
      *  the pi trick against flicker). The cursor ends at the input line's
-     *  edit position. v2c: the separator is the dim dotted ╌ (a weaker
-     *  presence than the solid ─), the status line is dim (blue accents
-     *  inside come from the CLI's composition), the input row is the blue
-     *  brick ▌you> + the editor's visible slice. */
+     *  edit position. v3 §03: the upper ╌ row, the input row, the lower
+     *  ╌ row, the status row — the status is dim (blue accents inside
+     *  come from the CLI's composition). */
     redraw() {
         if (!this.#active)
             return;
@@ -143,10 +151,25 @@ export class Dock {
         // \x1b[?2026h/l, the pi source's exact form. Without it terminals
         // silently ignore the mode and the anti-flicker never engages.
         out.push("\x1b[?2026h"); // synchronized output ON (DEC 2026)
-        out.push(`\x1b[${H - 2};1H\x1b[0K${sep}`);
-        out.push(`\x1b[${H - 1};1H\x1b[0K${statusLine}`);
-        out.push(`\x1b[${H};1H\x1b[0K${this.#inputPrompt}${inp.line}`);
-        out.push(`\x1b[${H};${this.#inputCol()}H`); // back to the edit position
+        // v3 §04: the slash-command menu — above the chrome, one row per
+        // filtered command, the selection highlighted. Drawn first so the
+        // chrome rows repaint on top of any overlap.
+        const menu = this.#menuState?.();
+        if (menu !== null && menu !== undefined) {
+            for (let i = 0; i < menu.items.length; i += 1) {
+                const item = menu.items[i];
+                const row = H - 4 - (menu.items.length - 1 - i);
+                const text = i === menu.selected
+                    ? `${p.blue}▸ ${item.name}${p.reset} ${item.desc}`
+                    : `${p.dim}  ${item.name} ${item.desc}${p.reset}`;
+                out.push(`\x1b[${row};1H\x1b[0K${text}`);
+            }
+        }
+        out.push(`\x1b[${H - 3};1H\x1b[0K${sep}`);
+        out.push(`\x1b[${H - 2};1H\x1b[0K${this.#inputPrompt}${inp.line}`);
+        out.push(`\x1b[${H - 1};1H\x1b[0K${sep}`);
+        out.push(`\x1b[${H};1H\x1b[0K${statusLine}`);
+        out.push(`\x1b[${H - 2};${this.#inputCol()}H`); // back to the edit position
         out.push("\x1b[?2026l"); // synchronized output OFF
         process.stdout.write(out.join(""));
     }

package/dist/editor.d.ts

@@ -24,6 +24,12 @@ export declare function widthOf(chars: readonly number[]): number;
 export declare function displayWidth(text: string): number;
 export declare const PROMPT = "\u258Cyou> ";
 export declare const PROMPT_WIDTH: number;
+/** v3 §04 — the slash-command menu's command table (English one-liners). */
+export interface MenuItem {
+    readonly name: string;
+    readonly desc: string;
+}
+export declare const MENU_ITEMS: readonly MenuItem[];
 /**
  * The editor. Raw mode + bracketed paste (?2004h) on enter, restored on
  * exit. The input row is rendered by `onRender` (the CLI wires it to the
@@ -48,6 +54,11 @@ export declare class Editor {
         line: string;
         cursor: number;
     };
+    /** v3 §04: the menu's visible state for the dock — null when closed. */
+    menuState(): {
+        items: readonly MenuItem[];
+        selected: number;
+    } | null;
     /** One-shot question mode: the NEXT submit answers, not a turn. */
     question(_query: string, cb: (answer: string) => void): void;
     /** Cancel a pending question — the buffer stays (its text becomes the

package/dist/editor.js

@@ -69,6 +69,13 @@ export function displayWidth(text) {
 import { palette } from "./render.js";
 export const PROMPT = "▌you> "; // the kiso brick motif: one blue half-block, then you>
 export const PROMPT_WIDTH = displayWidth(PROMPT);
+export const MENU_ITEMS = [
+    { name: "/mode", desc: "switch the approval tier (manual/default/accept-edits/plan/bypass)" },
+    { name: "/think", desc: "show the last full thinking block" },
+    { name: "/last", desc: "show the most recent tool call's input and output" },
+    { name: "/status", desc: "show session id, event count, and context estimate" },
+    { name: "/help", desc: "print this list of commands" },
+];
 /**
  * The editor. Raw mode + bracketed paste (?2004h) on enter, restored on
  * exit. The input row is rendered by `onRender` (the CLI wires it to the
@@ -88,6 +95,8 @@ export class Editor {
     #eotCb = null;
     #escapeCb = null;
     #onRender;
+    #menuOpen = false; // v3 §04: the slash-command menu
+    #menuSel = 0;
     #pending = ""; // an incomplete ESC/CSI prefix across chunks
     #decoder = new TextDecoder();
     #entered = false;
@@ -136,6 +145,27 @@ export class Editor {
         const col = (this.#scroll > 0 ? 1 : 0) + widthOf(this.#chars.slice(this.#scroll, this.#cursor));
         return { line: `${prefix}${visible}`, cursor: col };
     }
+    /** v3 §04: the menu's visible state for the dock — null when closed. */
+    menuState() {
+        if (!this.#menuOpen)
+            return null;
+        return { items: this.#menuFiltered(), selected: this.#menuSel };
+    }
+    /** v3 §04: the filtered command list for the current buffer — open
+     *  only while the line is "/" + something (a bare "/" waits). */
+    #menuFiltered() {
+        const line = this.line();
+        if (!line.startsWith("/") || line === "/")
+            return [];
+        return MENU_ITEMS.filter((m) => m.name.startsWith(line));
+    }
+    #refreshMenu() {
+        const f = this.#menuFiltered();
+        this.#menuOpen = f.length > 0;
+        if (this.#menuSel >= f.length)
+            this.#menuSel = 0;
+        this.#onRender();
+    }
     /** One-shot question mode: the NEXT submit answers, not a turn. */
     question(_query, cb) {
         this.#questionCb = cb;
@@ -195,6 +225,13 @@ export class Editor {
                 else if (rest.startsWith("O")) {
                     i += 3; // SS3 (function keys) — ignored
                 }
+                else if (this.#menuOpen) {
+                    // v3 §04: Esc closes the menu and clears the buffer.
+                    this.#chars = [];
+                    this.#cursor = 0;
+                    this.#scroll = 0;
+                    this.#refreshMenu();
+                }
                 else {
                     this.#escapeCb?.();
                     i += 1;
@@ -245,6 +282,18 @@ export class Editor {
                 this.#onRender();
                 i += 1;
             }
+            else if (c === "\t" && this.#menuOpen) {
+                // v3 §04: Tab completes the buffer to the selected command.
+                const f = this.#menuFiltered();
+                const m = f[this.#menuSel];
+                if (m !== undefined) {
+                    this.#chars = [...m.name].map((ch) => ch.codePointAt(0));
+                    this.#cursor = this.#chars.length;
+                    this.#reflow();
+                    this.#refreshMenu();
+                }
+                i += 1;
+            }
             else if (c !== undefined && c < " ") {
                 i += 1; // other control — ignored
             }
@@ -266,6 +315,15 @@ export class Editor {
                 this.#onRender();
             }
         }
+        else if (final === "A" && this.#menuOpen) {
+            // v3 §04: ↑↓ move the menu selection, never the cursor.
+            this.#menuSel = Math.max(0, this.#menuSel - 1);
+            this.#onRender();
+        }
+        else if (final === "B" && this.#menuOpen) {
+            this.#menuSel = Math.min(this.#menuFiltered().length - 1, this.#menuSel + 1);
+            this.#onRender();
+        }
         else if (final === "D") {
             this.#move(-1);
         }
@@ -287,7 +345,7 @@ export class Editor {
         this.#cursor += 1;
         this.#reflow();
         if (!this.#pasting)
-            this.#onRender();
+            this.#refreshMenu();
     }
     #backspace() {
         if (this.#cursor === 0)
@@ -296,7 +354,7 @@ export class Editor {
         this.#cursor -= 1;
         this.#reflow();
         if (!this.#pasting)
-            this.#onRender();
+            this.#refreshMenu();
     }
     #delete() {
         if (this.#cursor >= this.#chars.length)
@@ -304,7 +362,7 @@ export class Editor {
         this.#chars.splice(this.#cursor, 1);
         this.#reflow();
         if (!this.#pasting)
-            this.#onRender();
+            this.#refreshMenu();
     }
     #move(delta) {
         this.#cursor = Math.max(0, Math.min(this.#chars.length, this.#cursor + delta));
@@ -336,10 +394,18 @@ export class Editor {
         this.#reflow();
     }
     #submit() {
-        const line = String.fromCodePoint(...this.#chars);
+        let line = String.fromCodePoint(...this.#chars);
+        if (this.#menuOpen) {
+            // v3 §04: Enter submits the SELECTED command.
+            const m = this.#menuFiltered()[this.#menuSel];
+            if (m !== undefined)
+                line = m.name;
+        }
         this.#chars = [];
         this.#cursor = 0;
         this.#scroll = 0;
+        this.#menuOpen = false;
+        this.#menuSel = 0;
         const cb = this.#questionCb;
         this.#questionCb = null;
         if (cb !== null) {

package/dist/index.js

@@ -27,7 +27,7 @@ import { fileURLToPath } from "node:url";
 import { createAgent, disposeExtensions, loadExtensions, loadProjectExtensions, projectArtifacts, recordTrust, SessionStore, trustFor, } from "@vincemakes/kiso-runtime";
 import { createFauxProvider } from "@vincemakes/kiso-evals";
 import { createCodingTools } from "@vincemakes/kiso-tools-node";
-import { escapeTerminal, foldResult, foldThinking, palette, renderEvent, renderSessionLine, renderStatusLine, renderTerminalGap, renderToolSummary, } from "./render.js";
+import { escapeTerminal, foldResult, foldThinking, palette, renderEvent, renderSessionLine, renderStatusLine, renderTerminalGap, renderToolSummary, bannerLines, kUnit, renderRecap, truncateRow, } from "./render.js";
 import { Dock } from "./dock.js";
 /** 发现#11: KISO_HOME is the ONE root — every default path derives from
  *  it (sessions, trust, extensions, mcp config, skills). The dedicated
@@ -67,17 +67,18 @@ catch {
  *  merges into the third row on TTY and stays a standalone line off-TTY.
  *  v2a: the logo rows stay dim; the TAGLINE (row 2) is the blue identity
  *  accent. */
-const LOGO_TOP = "█ █ ▀█▀ █▀▀ █▀█\n█▀▄  █  ▀▀█ █ █   ";
-const TAGLINE = "the coding agent that survives kill -9";
-const LOGO_BOTTOM = "\n▀ ▀ ▀▀▀ ▀▀▀ ▀▀▀";
 function startupBanner() {
-    // The historical `[N extensions: names]` text merges VERBATIM into the
-    // third row — the existing e2e assertions keep matching (天然不破). E3:
-    // project-level extensions are counted in N and listed after `project:`
-    // — `[3 extensions: safe-defaults · project: lint-rules, mcp]`.
+    // v3 §01: the banner is block-split — three independent logo rows
+    // (TOP / tagline / BOTTOM), then TWO info rows (version,
+    // extensions), each truncated at the window width; < 40 columns
+    // skips the logo. The historical `[N extensions: names]` text rides
+    // the extensions row verbatim (the e2e assertions keep matching).
     const p = palette();
-    const names = bannerExtensionText();
-    return `${p.dim}${LOGO_TOP}${p.blue}${TAGLINE}${p.reset}${p.dim}${LOGO_BOTTOM}   v${VERSION}${names}${p.reset}\n`;
+    // A pty without a winsize reports columns = 0 (not undefined) — treat
+    // it as the default width, never as a 0-column truncation.
+    const W = process.stdout.columns ?? 0;
+    const rows = bannerLines(W > 0 ? W : 80, VERSION, bannerExtensionText().replace(/^ · /, ""));
+    return `${rows.map((r) => `${p.dim}${r}${p.reset}`).join("\n")}\n`;
 }
 /** v2a: the interactive prompt — blue, the identity accent. readline owns
  *  the echo of what the user types; we own the prompt's color. (v2c: the
@@ -194,6 +195,7 @@ function makeLineInput() {
         editor.enter();
         const p = palette();
         dock.bindInput(() => editor.dockState(), `${p.blue}${EDITOR_PROMPT}${p.reset}`);
+        dock.bindMenu(() => editor.menuState()); // v3 §04: the slash-command menu
         return editorInput(editor);
     }
     return readlineInput(createInterface({ input: process.stdin, output: process.stdout }));
@@ -214,27 +216,19 @@ function bodyLog(text) {
 /** v2b: the spinner merged into the STATUS BAR (the v2a standalone glyph
  *  is gone) — docked only, 200ms rotation between the request and the
  *  first event. */
-function startStatusSpinner() {
+function startStatusSpinner(onTick) {
     if (!dock.active)
         return () => { };
-    const GLYPHS = ["◐", "◓", "◑", "◒"];
+    // v3 §03/§05: the working glyph family ▖▘▝▗, 200ms rotation — the
+    // callback repaints the running status line with the new glyph.
+    const GLYPHS = ["▖", "▘", "▝", "▗"];
     let i = 0;
-    const timer = setInterval(() => dock.setTail(GLYPHS[i++ % GLYPHS.length]), 200);
+    const timer = setInterval(() => onTick(GLYPHS[i++ % GLYPHS.length]), 200);
     timer.unref();
-    return () => dock.setTail("");
-}
-/** v2b: "running <tool> Ns" in the status bar while a tool executes. */
-function startRunningTimer(name) {
-    if (!dock.active)
-        return () => { };
-    const started = Date.now();
-    const timer = setInterval(() => dock.setTail(`running ${name} ${Math.round((Date.now() - started) / 1000)}s`), 1000);
-    timer.unref();
-    return () => {
-        clearInterval(timer);
-        dock.setTail("");
-    };
+    return () => clearInterval(timer);
 }
+/** v3 §03: "running <tool> Ns" is gone — the running status line owns
+ *  the wall clock; the per-tool timer was the old tail mechanism. */
 /** The model name for the status bar — set by makeAgent. */
 let agentModel = "faux";
 /** E3: the `[N extensions: ...]` text — user-level names, then project-level
@@ -251,21 +245,6 @@ function bannerExtensionText() {
         parts.push(`project: ${projectExtensions.map((e) => e.name).join(", ")}`);
     return ` · [${total} extension${total === 1 ? "" : "s"}: ${parts.join(" · ")}]`;
 }
-/** Modes: the status-bar indicator — the default tier shows nothing; the
- *  others show their blue name, the dangerous ones (plan/bypass) with the
- *  ⚠ prefix. */
-function modeStatusText() {
-    if (getMode() === "default")
-        return "";
-    const p = palette();
-    const danger = getMode() === "plan" || getMode() === "bypass" ? "⚠ " : "";
-    return `${p.blue}${danger}${getMode()}${p.reset}`;
-}
-/** Modes: append the mode indicator to a composed status base. */
-function statusWithMode(base) {
-    const mode = modeStatusText();
-    return mode === "" ? base : `${base} · ${mode}`;
-}
 /** E1: the startup banner line(s) — TTY: logo + merged extensions; off-TTY:
  *  the historical `[N extensions: ...]` standalone line (zero change). */
 function extensionsBanner() {
@@ -751,6 +730,11 @@ function approvalDiff(name, input) {
 async function consumeRun(session, run, input, turnNo, faux, liveInput, statusCb) {
     let last;
     let usage = { in: null, out: null, cache: null, known: false };
+    // v3 §02: the recap line derives ENTIRELY from the local event stream
+    // (zero tokens) — wall seconds, tool/edit counts, usage, ctx left.
+    const turnStart = Date.now();
+    let toolCount = 0;
+    let editCount = 0;
     try {
         for await (const ev of run) {
             last = ev;
@@ -776,6 +760,9 @@ async function consumeRun(session, run, input, turnNo, faux, liveInput, statusCb
                     body.thinkingAppend(ev.text);
                     break;
                 case "tool_call_end":
+                    toolCount += 1;
+                    if (ev.name === "edit_file")
+                        editCount += 1;
                     body.toolStart(ev.name, ev.callId, ev.input ?? {});
                     break;
                 case "tool_execution_started":
@@ -828,14 +815,21 @@ async function consumeRun(session, run, input, turnNo, faux, liveInput, statusCb
                     await session.approve(decisionId, answer.trim().toLowerCase().startsWith("y"));
                     break;
                 }
-                case "terminal":
-                    statusCb?.(usage, estimateCtxRatio(session));
+                case "terminal": {
+                    // v3 §02: the run's recap line REPLACES the old "done" label
+                    // + status line — one local line, derived from this run's
+                    // events (zero tokens). The dock's status bar still paints.
                     statusCb?.(usage, estimateCtxRatio(session));
-                    // v2a rhythm: the honest label (\ndone\n — the completed
-                    // marker), the status line hugging it, then EXACTLY one blank
-                    // line before the next prompt.
-                    body.terminal(renderEvent(ev).text, renderStatusLine(turnNo, usage, estimateCtxRatio(session), faux) ?? "");
+                    const ratio = estimateCtxRatio(session);
+                    bodyLog(renderRecap({
+                        seconds: Math.round((Date.now() - turnStart) / 1000),
+                        tools: toolCount,
+                        edits: editCount,
+                        usage,
+                        ctxLeftPct: Number.isFinite(ratio) ? (1 - ratio) * 100 : null,
+                    }));
                     break;
+                }
                 default: {
                     // Events without a cell (stop, …) — the generic render, byte-
                     // preserved for the pipe path.
@@ -892,10 +886,20 @@ async function chat(session, faux, input) {
         currentRun = run;
         turnNo += 1;
         const myTurn = turnNo;
+        // v3 §03: the running state owns the status bar — the glyph
+        // rotates every 200ms; the idle state returns after the run.
+        runStart = Date.now();
+        runUsage = { in: null, out: null, cache: null, known: false };
+        const stopSpinner = startStatusSpinner((g) => {
+            runGlyph = g;
+            paintRunning();
+        });
         (async () => {
             let last;
             try {
                 last = await consumeRun(session, run, input, myTurn, faux, liveInput, statusCb);
+                stopSpinner();
+                paintIdle();
                 currentRun = null;
                 // 八: a faux script that ran out of declared turns exits
                 // loudly with a non-zero status — never a silent status 0.
@@ -980,18 +984,31 @@ async function chat(session, faux, input) {
     let queued = 0;
     // v2b: the live status bar (docked only). Modes: /mode switches repaint
     // it immediately through paintStatus (the last turn stats are kept).
-    let statusSt = null;
-    const statusCb = (u, ctx) => {
+    // v3 §03: the status bar has TWO states. Idle: the mode is ALWAYS
+    // shown (default included) with the /mode hint. Running: the working
+    // glyph (▖▘▝▗ — the spinner drives it) + wall seconds + ↓ out tokens
+    // + the interrupt hint. ctx left is the live estimate everywhere.
+    let runUsage = { in: null, out: null, cache: null, known: false };
+    let runGlyph = "▖";
+    let runStart = Date.now();
+    const paintRunning = () => {
         if (!dock.active)
             return;
-        statusSt = renderStatusLine(turnNo, u, ctx, faux);
-        paintStatus();
+        const ratio = estimateCtxRatio(session);
+        const pct = Number.isFinite(ratio) ? Math.round((1 - ratio) * 100) : null;
+        const out = runUsage.out !== null ? ` ↓ ${kUnit(runUsage.out)} tokens` : "";
+        dock.setStatus(`${runGlyph} working ${Math.max(1, Math.round((Date.now() - runStart) / 1000))}s${out} · esc to interrupt · ctx left ~${pct}%`);
     };
-    const paintStatus = () => {
+    const paintIdle = () => {
         if (!dock.active)
             return;
-        const base = statusSt === null ? `${session.id} · ${agentModel}` : `${session.id} · ${agentModel} · ${statusSt}`;
-        dock.setStatus(`${statusWithMode(base)}${queued > 0 ? ` · +${queued} queued` : ""}`);
+        const ratio = estimateCtxRatio(session);
+        const pct = Number.isFinite(ratio) ? Math.round((1 - ratio) * 100) : null;
+        dock.setStatus(`▸ ${getMode()} · /mode to switch · ${agentModel} · ctx left ~${pct}%`);
+    };
+    const statusCb = (u, ctx) => {
+        runUsage = u;
+        paintRunning();
     };
     // The ONE dispatcher: slash commands, exit, and turns. The recovery
     // replay routes through it too — a queued "/last" must never become a
@@ -1080,7 +1097,7 @@ async function chat(session, faux, input) {
                 else {
                     setMode(m);
                     body.notice(`mode → ${m}`);
-                    paintStatus();
+                    paintIdle();
                 }
                 input.prompt();
             });
@@ -1147,22 +1164,41 @@ async function resume(session, prompt, faux, input) {
     let currentRun = null;
     let cancelled = false;
     let turnNo = 0;
-    // v2b: the live status bar (docked only).
+    // v3 §03: the two-state status bar (see chat — same shapes).
+    let runUsage = { in: null, out: null, cache: null, known: false };
+    let runGlyph = "▖";
+    let runStart = Date.now();
     const statusCb = (u, ctx) => {
+        runUsage = u;
         if (!dock.active)
             return;
-        const st = renderStatusLine(turnNo, u, ctx, faux);
-        const base = st === null ? `${session.id} · ${agentModel}` : `${session.id} · ${agentModel} · ${st}`;
-        dock.setStatus(statusWithMode(base));
+        const pct = Number.isFinite(ctx) ? Math.round((1 - ctx) * 100) : null;
+        const out = runUsage.out !== null ? ` ↓ ${kUnit(runUsage.out)} tokens` : "";
+        dock.setStatus(`${runGlyph} working ${Math.max(1, Math.round((Date.now() - runStart) / 1000))}s${out} · esc to interrupt · ctx left ~${pct}%`);
+    };
+    const paintIdle = () => {
+        if (!dock.active)
+            return;
+        const ratio = estimateCtxRatio(session);
+        const pct = Number.isFinite(ratio) ? Math.round((1 - ratio) * 100) : null;
+        dock.setStatus(`▸ ${getMode()} · /mode to switch · ${agentModel} · ctx left ~${pct}%`);
     };
     const withRun = async (run) => {
         currentRun = run;
+        runStart = Date.now();
+        runUsage = { in: null, out: null, cache: null, known: false };
+        const stopSpinner = startStatusSpinner((g) => {
+            runGlyph = g;
+            statusCb(runUsage, estimateCtxRatio(session));
+        });
         try {
             turnNo += 1;
             const last = await consumeRun(session, run, input, turnNo, faux, null, statusCb);
             failOnFauxExhaustion(last, faux, input);
         }
         finally {
+            stopSpinner();
+            paintIdle();
             currentRun = null;
         }
     };
@@ -1287,7 +1323,7 @@ async function main() {
             }
             case "help": {
                 const p = palette();
-                console.log(`${p.dim}${LOGO_TOP}${p.blue}${TAGLINE}${p.reset}${p.dim}${LOGO_BOTTOM}${p.reset}\n\n` +
+                console.log(`${p.dim}${bannerLines(80, VERSION, "").join("\n")}${p.reset}\n\n` +
                     "kiso — the coding agent that survives kill -9\n\n" +
                     "  kiso [sessionId]         interactive session (default command)\n" +
                     "  kiso chat [sessionId]    same as above\n" +

package/dist/render.d.ts

@@ -11,12 +11,14 @@ import { canonicalTargetPath } from "@vincemakes/kiso-tools-node";
  * errors; dim for metadata. NO_COLOR set, or a non-TTY output → every
  * code is empty, so pipes and CI carry ZERO ANSI (the existing byte-level
  * e2e assertions guard it). Everything not listed here is plain.
+ * v3: `bg` — the user-message block background (SGR 48, dark gray 237).
  */
 export interface Palette {
     readonly blue: string;
     readonly dim: string;
     readonly red: string;
     readonly green: string;
+    readonly bg: string;
     readonly reset: string;
 }
 export declare const COLOR_ON: Palette;
@@ -73,6 +75,8 @@ export declare function renderToolSummary(name: string, input: Record<string, un
     content: string;
     isError: boolean;
 }): string;
+/** k-units for the status line: 12345 → 12.3k, 800 → 800, null → ?. */
+export declare function kUnit(value: number | null): string;
 /** B 区: usage data gathered from the run's usage events. */
 export interface RunUsage {
     readonly in: number | null;
@@ -96,6 +100,31 @@ export declare function renderStatusLine(turn: number, usage: RunUsage, ctxRatio
  * this verbatim; the render tests pin the sequence.
  */
 export declare function renderTerminalGap(statusLine: string | null): string;
+/**
+ * v3 §01 — the banner, block-split. The logo is three INDEPENDENT rows
+ * (TOP / the tagline / BOTTOM), then TWO info rows (version,
+ * extensions). Every row truncates at the terminal width with a " (+N)"
+ * marker (N = the hidden display width); a window narrower than 40
+ * columns skips the logo entirely — only the info rows. Pure.
+ */
+export declare const TAGLINE = "the coding agent that survives kill -9";
+/** v3 §01: truncate a row at `width`, marking the hidden span " (+N)". */
+export declare function truncateRow(row: string, width: number): string;
+/** v3 §01: the banner lines for a width W — logo (skipped under 40
+ *  columns) + version + extensions. */
+export declare function bannerLines(W: number, version: string, extensionsText: string): string[];
+/** v3 §02 — the recap line that ends a run, replacing the "done" label +
+ *  the old status line. All fields derive LOCALLY from the event stream
+ *  (zero tokens): wall seconds, tool counts, usage, cache hit %, ctx left.
+ */
+export interface RecapStats {
+    readonly seconds: number;
+    readonly tools: number;
+    readonly edits: number;
+    readonly usage: RunUsage;
+    readonly ctxLeftPct: number | null;
+}
+export declare function renderRecap(s: RecapStats): string;
 /** One-line summary of a session, for `kiso sessions`. */
 export declare function renderSessionLine(meta: {
     id: string;

package/dist/render.js

@@ -3,8 +3,8 @@
  * the lines a human sees. Colors are raw ANSI — no dependencies.
  */
 import { canonicalTargetPath } from "@vincemakes/kiso-tools-node";
-export const COLOR_ON = { blue: "\x1b[38;5;75m", dim: "\x1b[2m", red: "\x1b[31m", green: "\x1b[32m", reset: "\x1b[0m" };
-export const COLOR_OFF = { blue: "", dim: "", red: "", green: "", reset: "" };
+export const COLOR_ON = { blue: "\x1b[38;5;75m", dim: "\x1b[2m", red: "\x1b[31m", green: "\x1b[32m", bg: "\x1b[48;5;237m", reset: "\x1b[0m" };
+export const COLOR_OFF = { blue: "", dim: "", red: "", green: "", bg: "", reset: "" };
 export function palette() {
     return process.env.NO_COLOR === undefined && process.stdout.isTTY ? COLOR_ON : COLOR_OFF;
 }
@@ -50,7 +50,7 @@ export function foldThinking(block) {
     const p = palette();
     const trimmed = escapeTerminal(block.trim());
     const truncated = trimmed.length > 100;
-    return `${p.dim}…${trimmed.slice(0, 100)}${truncated ? " (… /think shows full)" : ""}${p.reset}\n`;
+    return `${p.dim}…${trimmed.slice(0, 100)}${truncated ? ` (${block.length} chars · /think)` : ""}${p.reset}\n`;
 }
 /** v2b — the [result] echo truncates at 160 chars + a /last hint. */
 export function foldResult(content) {
@@ -215,7 +215,7 @@ function exitCodeOf(result) {
     return m !== null ? Number(m[1]) : 1;
 }
 /** k-units for the status line: 12345 → 12.3k, 800 → 800, null → ?. */
-function kUnit(value) {
+export function kUnit(value) {
     if (value === null)
         return "?";
     if (value >= 1000)
@@ -257,6 +257,66 @@ export function renderStatusLine(turn, usage, ctxRatio, faux = false) {
 export function renderTerminalGap(statusLine) {
     return `${statusLine === null ? "" : `${statusLine}\n`}\n`;
 }
+/**
+ * v3 §01 — the banner, block-split. The logo is three INDEPENDENT rows
+ * (TOP / the tagline / BOTTOM), then TWO info rows (version,
+ * extensions). Every row truncates at the terminal width with a " (+N)"
+ * marker (N = the hidden display width); a window narrower than 40
+ * columns skips the logo entirely — only the info rows. Pure.
+ */
+export const TAGLINE = "the coding agent that survives kill -9";
+const LOGO_ROWS = ["█ █ ▀█▀ █▀▀ █▀█", TAGLINE, "▀ ▀ ▀▀▀ ▀▀▀ ▀▀▀"];
+/** Display width of a row (1-cell ASCII; 2-cell CJK/wide). */
+function displayW(row) {
+    let w = 0;
+    for (let i = 0; i < row.length; i += 1) {
+        const cp = row.codePointAt(i);
+        w += cp > 0xff ? 2 : 1;
+    }
+    return w;
+}
+/** v3 §01: truncate a row at `width`, marking the hidden span " (+N)". */
+export function truncateRow(row, width) {
+    if (displayW(row) <= width)
+        return row;
+    const cut = Math.max(0, width - 4);
+    let w = 0;
+    let i = 0;
+    for (; i < row.length; i += 1) {
+        const cw = row.codePointAt(i) > 0xff ? 2 : 1;
+        if (w + cw > cut)
+            break;
+        w += cw;
+    }
+    return `${row.slice(0, i)} (+${displayW(row) - w})`;
+}
+/** v3 §01: the banner lines for a width W — logo (skipped under 40
+ *  columns) + version + extensions. */
+export function bannerLines(W, version, extensionsText) {
+    const rows = [];
+    if (W >= 40)
+        for (const r of LOGO_ROWS)
+            rows.push(truncateRow(r, W));
+    rows.push(truncateRow(`v${version}`, W));
+    if (extensionsText !== "")
+        rows.push(truncateRow(extensionsText, W));
+    return rows;
+}
+export function renderRecap(s) {
+    const p = palette();
+    const parts = [`${s.seconds}s`, `${s.tools} tool${s.tools === 1 ? "" : "s"}${s.edits > 0 ? ` (${s.edits} edit${s.edits === 1 ? "" : "s"})` : ""}`];
+    if (s.usage.known) {
+        const seg = `${s.usage.in !== null ? `in ${kUnit(s.usage.in)}` : ""}${s.usage.in !== null && s.usage.out !== null ? " " : ""}${s.usage.out !== null ? `out ${kUnit(s.usage.out)}` : ""}`;
+        if (seg !== "")
+            parts.push(seg);
+        if (s.usage.cache !== null && s.usage.in !== null && s.usage.in > 0) {
+            parts.push(`cache ${Math.round((s.usage.cache / s.usage.in) * 100)}%`);
+        }
+    }
+    if (s.ctxLeftPct !== null)
+        parts.push(`ctx left ~${Math.round(s.ctxLeftPct)}%`);
+    return `${p.blue}▞${p.reset} ${parts.join(" · ")}\n`;
+}
 /** One-line summary of a session, for `kiso sessions`. */
 export function renderSessionLine(meta) {
     const when = meta.updatedAt ? new Date(meta.updatedAt).toISOString().slice(0, 16) : "—";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vincemakes/kiso-code",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "description": "kiso CLI — the coding-agent reference product: kiso chat / kiso resume / kiso sessions.",
   "type": "module",
   "license": "MIT",
@@ -18,12 +18,12 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@vincemakes/kiso-core": "0.1.16",
-    "@vincemakes/kiso-evals": "0.1.16",
-    "@vincemakes/kiso-provider-anthropic": "0.1.16",
-    "@vincemakes/kiso-provider-openai": "0.1.16",
-    "@vincemakes/kiso-runtime": "0.1.16",
-    "@vincemakes/kiso-tools-node": "0.1.16"
+    "@vincemakes/kiso-core": "0.1.18",
+    "@vincemakes/kiso-evals": "0.1.18",
+    "@vincemakes/kiso-provider-anthropic": "0.1.18",
+    "@vincemakes/kiso-provider-openai": "0.1.18",
+    "@vincemakes/kiso-runtime": "0.1.18",
+    "@vincemakes/kiso-tools-node": "0.1.18"
   },
   "devDependencies": {
     "@types/node": "^26.1.2",