@vincemakes/kiso-code 0.16.2 → 0.16.4

package/dist/chat.js

@@ -378,7 +378,7 @@ function taskVerdictWords(kind) {
 }
 /** W21 — the panel view for a permission_requested: the rule line (the
  *  why-asked speaker + the §3.5 fix hint), the toolTarget title, the
- *  "▸ run paused" status, and the ALWAYS-verbose args. */
+ *  "⏸ run paused" status, and the ALWAYS-verbose args. */
 function approvalView(name, ev, amended = false) {
     const speaker = ev.speaker ?? "kiso";
     const input = ev.input ?? {};
@@ -396,7 +396,7 @@ function approvalView(name, ev, amended = false) {
         speaker,
         ...(hint !== undefined ? { hint } : {}),
         ...(risk !== null ? { riskHint: risk } : {}),
-        statusText: "▸ run paused",
+        statusText: "⏸ run paused",
         args: approvalArgs(name, input),
         fallbackQuestion: `approve ${escapeTerminal(name)}? (y/n) `,
         // TUI2-R3v2 ③: the v4 frame's "(amended)" marker. It says WHY this
@@ -549,7 +549,9 @@ submitTurn) {
                     // user's words. Provenance is honest on screen, not only in
                     // the log.
                     if (ev.source === "system") {
-                        body.notice("\u25c6 verification pass");
+                        // R2 (law 1.3): the ◆ said nothing the words did not. What
+                        // makes this row honest is that it NAMES itself machinery.
+                        body.notice("verification pass");
                         body.notice(`  ${typeof ev.content === "string" ? ev.content : ""}`);
                         break;
                     }
@@ -761,7 +763,9 @@ submitTurn) {
                     // recap (the truncation-guard philosophy: the cut is visible
                     // in the scrollback, the model's own text intact).
                     if (ev.outcome.kind === "max_tokens") {
-                        body.notice('┌ answer truncated at max_tokens — say "continue" to finish');
+                        // R2 (law 1.1): the notice was wearing a box corner. A notice
+                        // is a sentence addressed to a human; it needs no edge.
+                        body.notice('answer truncated at max_tokens — say "continue" to finish');
                     }
                     bodyLog(renderRecap({
                         seconds: Math.round((Date.now() - turnStart) / 1000),

package/dist/dispatch.js

@@ -203,7 +203,11 @@ export function dispatch(line, ctx) {
                         // user who sees it is exactly the user who needs
                         // the path spelled out
                         ...(names.length === 0 ? { emptyNote: "no profiles — define models in ~/.kiso/config.json" } : {}),
-                    }, ctx.isRunning() ? "▸ run paused" : `▸ ${getMode()}`), (v) => resolve(v.action === "picked" ? v.result : null));
+                    }, 
+                    // DC-12 (design §4): a panel WAITING ON A HUMAN says ⏸. The
+                    // else-branch keeps ▸ — it names the current tier, which is
+                    // what ▸ means everywhere else.
+                    ctx.isRunning() ? "⏸ run paused" : `▸ ${getMode()}`), (v) => resolve(v.action === "picked" ? v.result : null));
                 });
                 ctx.paintIdle();
                 if (picked === null) {
@@ -365,7 +369,7 @@ export function dispatch(line, ctx) {
                     const elapsed = compactStart > 0 ? ((Date.now() - compactStart) / 1000).toFixed(1) : "?";
                     // a non-null result implies onStart ran — the "?" is
                     // reachable only at the type level
-                    body.notice(`[/compact] ▞ compacted · ${compactInfo?.rounds ?? "?"} rounds → 1 summary · saved ~${kUnit(result.savedTokens)} · ctx ${ctxBefore ?? "?"}% → ${ctxAfter}% · ${elapsed}s`);
+                    body.notice(`[/compact] ✦ compacted · ${compactInfo?.rounds ?? "?"} rounds → 1 summary · saved ~${kUnit(result.savedTokens)} · ctx ${ctxBefore ?? "?"}% → ${ctxAfter}% · ${elapsed}s`);
                 }
             }
             catch (err) {

package/dist/index.js

@@ -28,7 +28,7 @@ import { newSessionId } from "./session-id.js";
 import { createInterface } from "node:readline";
 import { fileURLToPath } from "node:url";
 import { join } from "node:path";
-import { BADGE_GLYPH, Body, Editor, bannerLines, escapeTerminal, extensionsBannerText, idColumn, idleStatus, interactivePrompt, palette, renderSessionLine, sessionListFooter, sessionListRow } from "@vincemakes/kiso-tui";
+import { Body, Editor, bannerLines, currentGround, resolveGround, setGround, escapeTerminal, extensionsBannerText, idColumn, idleStatus, interactivePrompt, palette, renderSessionLine, sessionListFooter, sessionListRow } from "@vincemakes/kiso-tui";
 import { createAgent, disposeExtensions, loadExtensions, loadProjectExtensions, SessionStore, } from "@vincemakes/kiso-runtime";
 import { createFauxProvider } from "@vincemakes/kiso-evals";
 import { createCodingTools } from "@vincemakes/kiso-tools-node";
@@ -43,7 +43,7 @@ import { loadProjectConfig, loadUserConfig, mergeConfigs, resolveAutoCompact, re
 import { resume } from "./resume.js";
 import { resumeTail } from "./resume-tail.js";
 import { armByteTrace } from "./byte-trace.js";
-import { tmpdir } from "node:os";
+import { tmpdir, homedir } from "node:os";
 import { clipboardImage } from "./clipboard.js";
 import { collectSessionCards, projectSessionCard } from "./session-cards.js";
 // The moved exports stay reachable from this entry — the test imports
@@ -233,10 +233,52 @@ function makeLineInput() {
     if (process.stdin.isTTY) {
         const editor = new Editor(() => (dock.active ? dock.redraw() : editor.selfRender()));
         editor.enter();
+        // DC-3: ask the terminal what its background is, and paint the
+        // first frame without waiting for the answer.
+        //
+        // Every grey in the palette is a claim about the background, and
+        // kiso had never established one — inline code was chosen on a dark
+        // terminal and measured 1.54:1 on a white one. The question is one
+        // write; the answer comes back through the editor, which is already
+        // the process's single reader of stdin (DC-7 taught it to swallow
+        // OSC rather than type it into the draft). No timer, no second
+        // reader, nothing blocking: an answer that never arrives leaves the
+        // ground `unknown`, and `unknown` is a supported palette, not a
+        // failure — see packages/tui-cells/src/ground.ts.
+        // DC-14 (P1): the ladder is walked ONCE AT STARTUP, before the query
+        // and independently of it. It used to be walked only inside the
+        // reply callback below — so on a terminal that does not answer OSC
+        // 11 (tmux does not forward the reply by default), rung 1 never
+        // ran: `KISO_THEME=dark` is SETTLED as "an explicit answer always
+        // wins" and won nothing. Rung 3 was worse than dead — `COLORFGBG`
+        // exists FOR the terminals without OSC 11, and could only ever be
+        // consulted when an OSC reply had arrived and been malformed. With
+        // §3.2 recording that rung 2 is unmeasured, that was the mainline.
+        setGround(resolveGround({ theme: process.env.KISO_THEME, colorfgbg: process.env.COLORFGBG }));
+        // the reply, when there is one, re-walks the ladder WITH it — and
+        // `theme` goes in first again, so an explicit answer still wins.
+        editor.onOsc((reply) => {
+            const next = resolveGround({ theme: process.env.KISO_THEME, osc: reply, colorfgbg: process.env.COLORFGBG });
+            if (next === currentGround())
+                return;
+            setGround(next);
+            body.onGroundChange();
+        });
+        // The query is COLOUR machinery, so it obeys the colour gate: a piped
+        // stdout and NO_COLOR both carry zero ANSI, and an OSC written into a
+        // pipe would be the first byte to break that. `palette().bold` is the
+        // same test the dock activates on — one gate, not a second opinion.
+        if (palette().bold !== "" && process.stdout.isTTY)
+            process.stdout.write("\x1b]11;?\x07");
         // W6: the box's prompt goes light — "› " (the box already says
         // "input lives here"; the line-mode path keeps the brick ▌, so
         // pipe bytes do not change)
-        dock.bindInput(() => editor.dockState(), "› ");
+        // R2 (owner, 2026-08-27): no prompt glyph. The cursor sits at column
+        // one, between the two rules — the rules already say "input lives
+        // here", which is the argument W6 made for the box and the only part
+        // of it that survives. A prompt character is a third thing saying
+        // the same thing, and it cost the row a column.
+        dock.bindInput(() => editor.dockState(), "");
         // TUI2-R3v2 ②: the click hit-test's wiring — the compositor places
         // the panel's option rows, so the compositor is what the editor asks
         // where they are. Neither side computes the other's geometry.
@@ -274,38 +316,19 @@ function extensionsBanner(resume = []) {
             bodyLog(`${text}\n`);
         return;
     }
-    body.banner(VERSION, text.replace(/^ · /, ""), resume);
-}
-/** W5: the opening-screen resume list — up to 3 recent sessions, newest
- *  first, the CURRENT session excluded (it is not something to pick back
- *  up). Every field already exists behind the store's SessionMeta (the
- *  `kiso sessions` line shows the same data) — only the projection and
- *  the sort live here.
- *
- *  TT-1B (W5 unification): each row carries the picker's badge glyph,
- *  derived through the SAME projection the picker uses (session-cards —
- *  one source of truth about durability; a second derivation would be
- *  none). Only the 3 chosen sessions are opened — the read-only listing
- *  rule holds (projectSessionCard's own guarantee), and the cost is
- *  bounded by the list, never the home. */
-async function recentSessions(id, agent) {
-    const picked = agent
-        .sessions()
-        .filter((m) => m.id !== id)
-        .sort((a, b) => b.updatedAt - a.updatedAt)
-        .slice(0, 3);
-    const store = sessionStoreRef;
-    const out = [];
-    for (const m of picked) {
-        let badge;
-        if (store !== null) {
-            const session = await agent.session({ id: m.id, ...(acceptDrift() ? { acceptDrift: true } : {}) });
-            const card = projectSessionCard({ id: m.id, updatedAt: m.updatedAt, records: store.load(m.id), asks: session.pendingApprovals().length });
-            badge = BADGE_GLYPH[card.badge];
-        }
-        out.push({ title: m.title, events: m.events, runs: m.runs, updatedAt: m.updatedAt, ...(badge === undefined ? {} : { badge }) });
-    }
-    return out;
+    // R2: the opening answers the three questions a first screen is asked.
+    // The model and the tier come from the same state the status line reads
+    // (one source, so the two can never disagree); the workspace is the
+    // home-relative cwd, because `~/Desktop/devv/kiso` is what a human
+    // calls the place and `/Users/vinve/Desktop/devv/kiso` is what a
+    // filesystem calls it.
+    const home = homedir();
+    const cwd = process.cwd();
+    body.banner(VERSION, text.replace(/^ · /, ""), resume, {
+        model: agentModel,
+        mode: getMode() === "plan" ? "plan (read-only)" : getMode(),
+        cwd: cwd.startsWith(home) ? `~${cwd.slice(home.length)}` : cwd,
+    });
 }
 /**
  * A area: the coding-agent system prompt — ONE constant, byte-stable for the
@@ -606,13 +629,21 @@ async function chatLoop(agent, firstId, input, autoCompact) {
             // prompt inside a conversation with thousands of events — the
             // durable log was right there and none of it was shown. Empty for
             // a fresh session, so `kiso chat` is byte-identical.
-            for (const line of resumeTail(session.log.all))
+            for (const line of resumeTail(session.log.all, process.stdout.columns ?? 80))
                 bodyLog(line);
-            extensionsBanner(await recentSessions(id, agent));
+            // R2 (owner, 2026-08-27): the resume list is NOT on the opening
+            // screen. `/resume` is where you go looking for a session; the
+            // opening's job is to say what THIS one is.
+            //
+            // It takes DC-8 with it: building those rows opened the three most
+            // recent sessions just to draw a badge, and `agent.session()`
+            // throws on profile drift — so one drifted session anywhere in the
+            // history stopped kiso from starting at all.
+            extensionsBanner();
         }
         else {
             bodyLog(`session ${id} (switched — previous: ${prev}, /resume ${prev} returns)\n`);
-            for (const line of resumeTail(session.log.all))
+            for (const line of resumeTail(session.log.all, process.stdout.columns ?? 80))
                 bodyLog(line);
             if (currentFaux)
                 session.setAdapter(createFauxProvider(readFauxScript().slice(fauxSkip(id))));
@@ -880,7 +911,7 @@ async function main() {
                     session.setAdapter(createFauxProvider(readFauxScript().slice(fauxSkip(id))));
                 // REL-0152-D5 — the same tail on the explicit-id form. NOT on
                 // the -p path above: that one's stdout is a machine's input.
-                for (const line of resumeTail(session.log.all))
+                for (const line of resumeTail(session.log.all, process.stdout.columns ?? 80))
                     bodyLog(line);
                 await resume(session, prompt, faux, input);
                 break;

package/dist/resume-tail.d.ts

@@ -23,4 +23,4 @@
  */
 export declare function resumeTail(events: readonly {
     readonly type: string;
-}[]): string[];
+}[], W?: number): string[];

package/dist/resume-tail.js

@@ -28,7 +28,7 @@ const clip = (s, n) => (s.length <= n ? s : `${s.slice(0, n - 1)}…`);
  * prompt. Empty when there is nothing to show, and the caller prints
  * nothing rather than an empty frame.
  */
-export function resumeTail(events) {
+export function resumeTail(events, W = 80) {
     const turns = [];
     let ask = null;
     let reply = "";
@@ -51,9 +51,22 @@ export function resumeTail(events) {
         return [];
     const lines = [];
     const skipped = turns.length - shown.length;
-    lines.push(skipped > 0 ? `─ resuming · ${turns.length} turns, showing the last ${shown.length} ─` : `─ resuming · ${turns.length} turn${turns.length === 1 ? "" : "s"} ─`);
+    // R2 (law 1.1): the head is the ONE rule, labelled the way every
+    // other band on screen labels itself. It used to be `─ … ─`, a second
+    // divider weight that existed nowhere else in the product.
+    const label = skipped > 0 ? `resuming · ${turns.length} turns, showing the last ${shown.length}` : `resuming · ${turns.length} turn${turns.length === 1 ? "" : "s"}`;
+    const head = `\u254c\u254c\u254c ${label} `;
+    // the cut floor is the WIDTH, never a constant: `Math.max(4, W)` let a
+    // four-cell rule out at W=1..3, i.e. a chrome row wider than the
+    // terminal. Every glyph here is one cell (the label is ascii plus
+    // `·`), so a code-unit slice is a cell slice.
+    lines.push(`${head}${"\u254c".repeat(Math.max(1, W - head.length))}`.slice(0, Math.max(1, W)));
     for (const t of shown) {
-        lines.push(`  › ${clip(oneLine(t.ask), 100)}`);
+        // the human's turn keeps the quote gutter — the one glyph in the
+        // product that means "these are somebody's exact words". The `\u203a`
+        // it used to carry is the composer's prompt, and the composer no
+        // longer has one.
+        lines.push(`  \u2502 ${clip(oneLine(t.ask), 100)}`);
         const body = oneLine(t.reply);
         // A turn with no reply is a turn that was INTERRUPTED — the case
         // resume exists for. Saying so beats printing a blank line.

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@vincemakes/kiso-code",
-	"version": "0.16.2",
-	"description": "kiso CLI \u2014 the durable coding agent that survives kill -9: kiso chat / kiso resume / kiso sessions.",
+	"version": "0.16.4",
+	"description": "kiso CLI — the durable coding agent that survives kill -9: kiso chat / kiso resume / kiso sessions.",
 	"type": "module",
 	"license": "MIT",
 	"bin": {
@@ -18,19 +18,19 @@
 		"test": "vitest run"
 	},
 	"dependencies": {
-		"@vincemakes/kiso-ask-ext": "0.16.2",
-		"@vincemakes/kiso-core": "0.16.2",
-		"@vincemakes/kiso-evals": "0.16.2",
-		"@vincemakes/kiso-mcp-ext": "0.16.2",
-		"@vincemakes/kiso-provider-anthropic": "0.16.2",
-		"@vincemakes/kiso-provider-openai": "0.16.2",
-		"@vincemakes/kiso-runtime": "0.16.2",
-		"@vincemakes/kiso-skills-ext": "0.16.2",
-		"@vincemakes/kiso-subagent-ext": "0.16.2",
-		"@vincemakes/kiso-task-ext": "0.16.2",
-		"@vincemakes/kiso-tools-node": "0.16.2",
-		"@vincemakes/kiso-tui": "0.16.2",
-		"@vincemakes/kiso-tui-cells": "0.16.2"
+		"@vincemakes/kiso-ask-ext": "0.16.4",
+		"@vincemakes/kiso-core": "0.16.4",
+		"@vincemakes/kiso-evals": "0.16.4",
+		"@vincemakes/kiso-mcp-ext": "0.16.4",
+		"@vincemakes/kiso-provider-anthropic": "0.16.4",
+		"@vincemakes/kiso-provider-openai": "0.16.4",
+		"@vincemakes/kiso-runtime": "0.16.4",
+		"@vincemakes/kiso-skills-ext": "0.16.4",
+		"@vincemakes/kiso-subagent-ext": "0.16.4",
+		"@vincemakes/kiso-task-ext": "0.16.4",
+		"@vincemakes/kiso-tools-node": "0.16.4",
+		"@vincemakes/kiso-tui": "0.16.4",
+		"@vincemakes/kiso-tui-cells": "0.16.4"
 	},
 	"devDependencies": {
 		"@types/node": "^26.1.2",