@vincemakes/kiso-tui 0.52.0 → 0.54.0

package/dist/compositor.js

@@ -55,7 +55,7 @@ import { MOUSE_OFF } from "./editor.js";
 import { pickWindowOf } from "./approval-panel.js";
 import { atPanelRows, bandHeader, bandKeyRow, bandVisible, bandWindow, moreMark } from "./at-picker.js";
 // TUI2-R2 ②: the session picker's rows — the band's third occupant.
-import { RESUME_FILTER_HINT, sessionPickerRows } from "./session-picker.js";
+import { FORK_FILTER_HINT, RESUME_FILTER_HINT, sessionPickerRows } from "./session-picker.js";
 import { CAP_PREVIEW, thinkingRow, Container, MOTION_FRAMES, MdStream, bodySpacing, boxBottom, boxTop, cellComponent, cutLine, pendingQueueRows, selectionBar, statusLine, visibleWidth, breathFrame, widthCut, } from "./components.js";
 import { bannerLines, escapeTerminal, foldResult, foldThinking, palette, renderTerminalGap, renderToolSummary } from "./lines.js";
 import { oneRow } from "@vincemakes/kiso-tui-cells/render";
@@ -2657,7 +2657,7 @@ export class Body {
         // in the row's pad, so the cursor and the columns do not move.
         // Graphite P3: the same exception for a pick that filters (/model) —
         // its input is the filter too, and its hint is the caller's words.
-        const hint = panel === null ? (this.#pickState?.() != null ? RESUME_FILTER_HINT : null) : panelHintOf(panel);
+        const hint = panel === null ? (this.#pickState?.() != null ? (this.#pickState?.()?.kind === "fork" ? FORK_FILTER_HINT : RESUME_FILTER_HINT) : null) : panelHintOf(panel);
         if (hint !== null && rows.length === 1 && rows[0] === "") {
             const pad = / +$/.exec(out[0]);
             const hintW = visibleWidth(hint);

package/dist/editor.d.ts

@@ -132,6 +132,7 @@ export declare class Editor {
      *  pop walks them (each pop leaves the queue, cancelling the turn);
      *  esc ends the walk after one more pop. */
     bindQueue(state: () => readonly string[], pop: () => string | null): void;
+    setGhost(text: string | null): void;
     /** ADR-0057: put text back into the buffer — the steers a stop handed
      *  back before they landed. It goes AHEAD of a draft already there, on
      *  its own line, and the draft stays recoverable (undo). */
@@ -201,7 +202,7 @@ export declare class Editor {
         nameCol: number;
     } | null;
     /** Open the picker on a bound card source (PickInput, S5). */
-    beginPick(cards: () => readonly SessionCardView[], onPick: (id: string | null) => void, here?: string): void;
+    beginPick(cards: () => readonly SessionCardView[], onPick: (id: string | null) => void, here?: string, kind?: "resume" | "fork"): void;
     pickState(): SessionPickState | null;
     /** One-shot question mode: the NEXT submit answers, not a turn. */
     question(_query: string, cb: (answer: string) => void): void;

package/dist/editor.js

@@ -123,6 +123,8 @@ export const MENU_ITEMS = [
     // the /resume+/clear mini-spec: the session-navigation pair
     { name: "/clear", desc: "start a fresh conversation (the old session stays resumable)" },
     { name: "/resume", desc: "switch to another session; /resume <id> goes directly" },
+    // owner 2026-11-03: the web app's fork, one rule — after a reply, then switch
+    { name: "/fork", desc: "a new session from after one of this session's replies, then switch to it" },
     // 0.39.2: `/reload` has been dispatchable since §2.5 and `/help` lists
     // it, and typing `/` never offered it — the one place a person who does
     // not know a command exists goes to find one. Caught with `/copy` by the
@@ -589,6 +591,16 @@ export class Editor {
         this.#queueState = state;
         this.#queuePop = pop;
     }
+    /** The follow-up (owner 2026-11-03): a line the person may send next, drawn dim in the EMPTY box; Tab takes it into
+     *  the buffer as real text. Null clears it. Typing hides it (the box is no longer empty); it is never sent by itself. */
+    #ghost = null;
+    setGhost(text) {
+        if (this.#ghost === text)
+            return;
+        this.#ghost = text === "" ? null : text;
+        if (this.#chars.length === 0)
+            this.#onRender();
+    }
     /** ADR-0057: put text back into the buffer — the steers a stop handed
      *  back before they landed. It goes AHEAD of a draft already there, on
      *  its own line, and the draft stays recoverable (undo). */
@@ -834,6 +846,21 @@ export class Editor {
         // the window, the markers and the cursor all count them the same
         // way — N_MAX has always been about how tall the box may get, and
         // a folded line is as tall as a pasted one.
+        if (this.#chars.length === 0 && this.#ghost !== null) {
+            // the follow-up stands in the empty box, dim, cut to one row; the cursor waits at its start
+            const budget = this.#budget();
+            let shownGhost = "";
+            for (const ch of this.#ghost) {
+                if (widthOf([...`${shownGhost}${ch}`].map((x) => x.codePointAt(0))) > budget - 1) {
+                    shownGhost += "\u2026";
+                    break;
+                }
+                shownGhost += ch;
+            }
+            const p = palette();
+            const line = `${p.dim}${shownGhost}${p.reset}`;
+            return { line, cursor: 0, lines: [line], cursorRow: 0, cursorCol: 0 };
+        }
         const rows = this.#visualRows();
         const cursorLine = this.#cursorVisualRow(rows);
         const n = this.#visibleRows(rows.length);
@@ -1056,8 +1083,8 @@ export class Editor {
     }
     // ── TUI2-R2 ② — the session picker ───────────────────────────────
     /** Open the picker on a bound card source (PickInput, S5). */
-    beginPick(cards, onPick, here) {
-        this.#pickInput.begin(cards, onPick, here);
+    beginPick(cards, onPick, here, kind) {
+        this.#pickInput.begin(cards, onPick, here, kind);
     }
     pickState() {
         return this.#pickInput.state();
@@ -1659,6 +1686,11 @@ export class Editor {
                 this.#atAccept();
                 i += 1;
             }
+            else if (c === "\t" && this.#chars.length === 0 && this.#ghost !== null) {
+                // the follow-up: Tab on the empty box takes it as real text
+                this.restore(this.#ghost);
+                i += 1;
+            }
             else if (c === "\x16") {
                 // REL-0152-D15: ctrl+V asks for the clipboard. Inert with no
                 // hook wired, and 0x16 must NEVER reach the buffer — an

package/dist/pick-input.d.ts

@@ -28,7 +28,7 @@ export declare class PickInput {
      *  (the buffer becomes the filter query) and `onPick` receives the
      *  chosen id — or null when the human leaves without picking, which
      *  is a first-class outcome and not an error. */
-    begin(cards: () => readonly SessionCardView[], onPick: (id: string | null) => void, here?: string): void;
+    begin(cards: () => readonly SessionCardView[], onPick: (id: string | null) => void, here?: string, kind?: "resume" | "fork"): void;
     /** The picker's state, derived: the full card list (the id column
      *  measures over ALL of them, so the columns never jump), the
      *  filtered matches, and the selection CLAMPED at read time — the

package/dist/pick-input.js

@@ -8,6 +8,7 @@ export class PickInput {
      *  whether the person flipped to ALL. */
     #here = undefined;
     #all = false;
+    #kind = "resume";
     constructor(host) {
         this.host = host;
     }
@@ -18,8 +19,9 @@ export class PickInput {
      *  (the buffer becomes the filter query) and `onPick` receives the
      *  chosen id — or null when the human leaves without picking, which
      *  is a first-class outcome and not an error. */
-    begin(cards, onPick, here) {
+    begin(cards, onPick, here, kind = "resume") {
         this.#cards = cards;
+        this.#kind = kind;
         this.#commit = onPick;
         this.#sel = 0;
         this.#here = here;
@@ -43,7 +45,7 @@ export class PickInput {
         const cards = scoped === null ? this.#cards() : scoped.cards;
         const query = this.host.line();
         const matches = sessionFilter(cards, query);
-        return { cards, matches, selected: Math.max(0, Math.min(this.#sel, matches.length - 1)), scope: scoped?.scope ?? null, query };
+        return { cards, matches, selected: Math.max(0, Math.min(this.#sel, matches.length - 1)), scope: scoped?.scope ?? null, query, kind: this.#kind };
     }
     /** 0.40.0 — tab flips CURRENT ↔ ALL. The filter owns every printable
      *  key (the buffer IS the query), so the toggle cannot be one. True when

package/dist/session-picker.d.ts

@@ -39,6 +39,9 @@ export interface SessionCardView {
     /** 0.40.0: its project was inferred by the one-time migration, never
      *  recorded — the row says so. */
     readonly inferred?: boolean;
+    /** /fork's card: the opened row says this instead of a session's facts
+     *  (the line the reply answered). */
+    readonly detail?: string;
 }
 /** 0.40.0 — which sessions the picker shows. `here` is the running
  *  workspace's realpath; `all` is the person's choice; `unknown` counts
@@ -125,6 +128,9 @@ export interface SessionPickState {
     /** Graphite P1: the filter as typed — the title lights the letters it
      *  matched, and the band says how many match. Absent = no filter. */
     readonly query?: string;
+    /** /fork (owner 2026-11-03): the same band picks a REPLY to fork after —
+     *  its name, its enter and its empty line say so. Absent = /resume. */
+    readonly kind?: "resume" | "fork";
 }
 /** How many sessions the band shows: eight on a terminal 30 rows or
  *  taller, five below (owner, 2026-09-30). */
@@ -145,6 +151,7 @@ export declare function sessionStateWord(card: SessionCardView): string;
 export declare function sessionStarted(id: string): string | null;
 /** What the empty input says while the picker is up: typing there filters. */
 export declare const RESUME_FILTER_HINT = "filter by title or id";
+export declare const FORK_FILTER_HINT = "filter replies";
 /**
  * The whole band: the named hairline, the windowed table with the
  * selected row opened, and the key row. Returned as plain strings for the

package/dist/session-picker.js

@@ -438,6 +438,10 @@ export function sessionStarted(id) {
 function openedRow(card, W, where) {
     const p = palette();
     const room = Math.max(0, W - 3);
+    if (card.detail !== undefined) {
+        const said = widthCut(escapeTerminal(card.detail), room);
+        return selectionBar(` ${p.dim}${said}${p.reset}`, visibleWidth(said) + 1, W);
+    }
     const note = sessionNote(card);
     const dash = note.indexOf(" — ");
     const head = widthCut(dash < 0 ? note : note.slice(0, dash), room);
@@ -476,11 +480,12 @@ function resumeKeyRow(state, W, table) {
     const scope = state.scope ?? null;
     const elsewhere = scope === null ? 0 : scope.total - scope.inHere;
     const tab = scope === null ? null : scope.all ? "tab this workspace" : elsewhere > 0 ? `tab ${elsewhere} more elsewhere` : null;
-    const keys = ["↑↓ move", "⏎ resumes", tab, "esc"].filter((k) => k !== null);
+    const enter = state.kind === "fork" ? "⏎ forks" : "⏎ resumes";
+    const keys = ["↑↓ move", enter, tab, "esc"].filter((k) => k !== null);
     const edge = Math.min(W, Math.max(table, visibleWidth(keys.join(" · ")) + count.length + 5));
     const fits = (ks) => 2 + visibleWidth(ks.join(" · ")) + 2 + count.length + 1 <= edge;
     let kept = keys;
-    for (const drop of [tab, "↑↓ move", "⏎ resumes", "esc"]) {
+    for (const drop of [tab, "↑↓ move", enter, "esc"]) {
         if (fits(kept))
             break;
         kept = kept.filter((k) => k !== drop);
@@ -491,6 +496,7 @@ function resumeKeyRow(state, W, table) {
 }
 /** What the empty input says while the picker is up: typing there filters. */
 export const RESUME_FILTER_HINT = "filter by title or id";
+export const FORK_FILTER_HINT = "filter replies";
 /**
  * The whole band: the named hairline, the windowed table with the
  * selected row opened, and the key row. Returned as plain strings for the
@@ -503,13 +509,15 @@ export function sessionPickerRows(state, W, now, height = 24) {
     const p = palette();
     const scope = state.scope ?? null;
     const query = state.query ?? "";
-    const rows = [bandHeader(scopeTitle(scope, query === "" ? null : { matches: state.matches.length, of: state.cards.length }), W)];
+    const filter = query === "" ? null : { matches: state.matches.length, of: state.cards.length };
+    const title = state.kind === "fork" ? (filter === null ? "fork after a reply" : `fork after a reply · ${filter.matches} of ${filter.of} match`) : scopeTitle(scope, filter);
+    const rows = [bandHeader(title, W)];
     // the workspace column shows only when every workspace is listed
     const where = scope !== null && scope.all ? scope.here : null;
     const cols = resumeColumns(state.cards, W, now, where);
     if (state.matches.length === 0) {
         // an empty view says why, rather than an empty band
-        const empty = query !== "" ? `nothing matches “${escapeTerminal(query)}”` : scope !== null && !scope.all && scope.inHere === 0 ? "no session from this workspace yet" : "nothing to resume yet";
+        const empty = query !== "" ? `nothing matches “${escapeTerminal(query)}”` : state.kind === "fork" ? "no finished reply to fork after yet" : scope !== null && !scope.all && scope.inHere === 0 ? "no session from this workspace yet" : "nothing to resume yet";
         rows.push(`${p.dim}${widthCut(`  ${empty}`, W)}${p.reset}`);
         rows.push(resumeKeyRow(state, W, cols.table));
         return rows;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vincemakes/kiso-tui",
-	"version": "0.52.0",
+	"version": "0.54.0",
 	"description": "kiso tui \u2014 the pure terminal layer (cell renderer, dock, raw editor, diff, palette). Zero runtime dependencies: input is data, output is bytes.",
 	"type": "module",
 	"license": "MIT",
@@ -35,6 +35,6 @@
 	},
 	"homepage": "https://github.com/vincemakes/kiso/tree/main/packages/tui#readme",
 	"dependencies": {
-		"@vincemakes/kiso-tui-cells": "0.52.0"
+		"@vincemakes/kiso-tui-cells": "0.54.0"
 	}
 }