@vincemakes/kiso-code 0.1.15 → 0.1.17

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
@@ -41,7 +43,11 @@ export class Dock {
         this.#inputState = state;
         this.#inputPrompt = prompt;
     }
-    /** Enter docked mode: DECSTBM the scroll region, draw the chrome. A
+    /** Enter docked mode: draw the chrome. #13 (P1): the DECSTBM scroll
+     *  region is GONE — v2d-B (ADR-0040): the body uses plain LF scrolling
+     *  so frozen lines enter the native scrollback deterministically
+     *  (region-scrolled lines are terminal-dependent — some terminals drop
+     *  them). The dock rows are redrawn by the body after every scroll. A
      *  TTY without a real window size (rows < 4) stays in the v2a line
      *  mode — the bottom three rows need room to exist. */
     enter() {
@@ -53,7 +59,6 @@ export class Dock {
         this.#width = process.stdout.columns ?? 80;
         this.#bodyRow = 1;
         this.#bodyCol = 1;
-        process.stdout.write(`\x1b[1;${this.#height - 3}r`); // scroll region: top .. H-3
         this.redraw();
         this.#resizeHandler = () => this.onResize();
         process.stdout.on("resize", this.#resizeHandler);
@@ -72,51 +77,25 @@ 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`);
     }
-    /** SIGWINCH: recompute the region, redraw the chrome. */
+    /** SIGWINCH: recompute the size, redraw the chrome. */
     onResize() {
         if (!this.#active)
             return;
         this.#height = process.stdout.rows ?? this.#height;
         this.#width = process.stdout.columns ?? this.#width;
-        process.stdout.write(`\x1b[1;${this.#height - 3}r`);
         this.redraw();
     }
-    /** Body output: position the cursor inside the scroll region at the
-     *  body's tracked position, write, and hand the cursor back to the
-     *  input line's EDIT position. The row/col tracking is approximate for
-     *  width-wrapped and wide-char lines (documented) — the region clamp
-     *  keeps the bottom rows safe regardless.
-     *
-     *  The edit-position return is a correctness requirement, not
-     *  cosmetics: readline tracks its cursor internally and NEVER
-     *  re-syncs after an external move — a body write that left the
-     *  cursor at column 1 made the next keystroke overwrite the prompt
-     *  (probe-confirmed; the dock's redraw self-repaired ~200ms later,
-     *  which read the user as cursor drift). */
-    writeBody(text) {
-        if (!this.#active) {
-            process.stdout.write(text);
-            return;
-        }
-        const row = Math.min(this.#bodyRow, this.#height - 3);
-        const col = this.#bodyCol > this.#width ? this.#width : this.#bodyCol;
-        process.stdout.write(`\x1b[${row};${col}H`);
-        process.stdout.write(text);
-        for (const ch of text) {
-            if (ch === "\n") {
-                this.#bodyRow += 1;
-                this.#bodyCol = 1;
-            }
-            else {
-                this.#bodyCol += 1;
-            }
-        }
-        process.stdout.write(`\x1b[${this.#height};${this.#inputCol()}H`); // back to the edit position
+    #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
@@ -152,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;
@@ -173,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) {