@vincemakes/kiso-tui 0.46.1 → 0.47.0

package/dist/context-ledger.js

@@ -17,6 +17,8 @@
  * Every number is a count the ledger already carries. Nothing here
  * estimates, projects, or predicts.
  */
+import { SHEET_CLOSE, bandHeader } from "@vincemakes/kiso-tui-cells/strings";
+import { cutLine } from "@vincemakes/kiso-tui-cells/render";
 import { palette } from "./lines.js";
 const BAR_CELLS = 12;
 /** k-units for the ledger's columns: 25700 → 25.7k, 300 → 300, 11 → 11.
@@ -94,3 +96,63 @@ export function contextUnavailableRows(reason) {
     const p = palette();
     return [`${p.bold}context — no ledger yet${p.reset}`, `  ${p.dim}${reason}${p.reset}`];
 }
+/** §8.9 — the meter's cells, ONE rule for the status bar's ctx meter and
+ *  the `/context` sheet (the sheets round, owner 2026-10-06: the two
+ *  meters cannot disagree). Ten `▆` cells filled to the percentage SHOWN
+ *  (`0%` is empty; from 1% at least one cell), `ink2` below the soft
+ *  compaction tier, gold to the hard one, the failure colour past it; the
+ *  empty cells `track`. "" off a known ground: the colours carry nothing
+ *  there, and the percentage says it alone. `used`, `soft` and `hard`
+ *  are shares of the window. */
+export const METER_CELLS = 10;
+export function meterCells(used, soft, hard) {
+    const p = palette();
+    if (p.track === "")
+        return "";
+    const shown = Math.round(Math.max(0, used) * 100);
+    const filled = shown <= 0 ? 0 : Math.min(METER_CELLS, Math.max(1, Math.round(shown / 10)));
+    const tone = used >= hard ? p.fail : used >= soft ? p.gold : p.ink2;
+    return `${tone}${"\u2586".repeat(filled)}${p.track}${"\u2586".repeat(METER_CELLS - filled)}${p.fgEnd}`;
+}
+/**
+ * The sheets round (owner, 2026-10-06) — `/context` on a dock is a sheet
+ * over the input, the shape `/status` has (§8.16): the band names the
+ * total (`context · 2.7k of 200k · 1%`), the bar's meter with when
+ * compaction happens beside it, the surfaces as a table — the label, the
+ * count right-aligned, the detail dim — the free remainder dim, and the
+ * closing row. No blank rows: the printed form spent a cell per row and
+ * came out double-spaced. On a pipe `/context` prints `contextRows`,
+ * unchanged. `tiers` are the compaction thresholds as shares of the
+ * window, or null when the window is not known.
+ */
+export function contextSheetRows(ledger, tiers, W) {
+    const p = palette();
+    const used = ledger.systemPrompt + ledger.toolTable + ledger.skillsIndex + ledger.envelope + ledger.messages;
+    const free = Math.max(0, ledger.window - used);
+    const ratio = ledger.window > 0 ? Math.min(1, used / ledger.window) : 1;
+    const rows = [bandHeader(`context \u00b7 ${k(used)} of ${k(ledger.window)} \u00b7 ${Math.round(ratio * 100)}%`, W)];
+    const cells = meterCells(ratio, tiers?.soft ?? Number.POSITIVE_INFINITY, tiers?.hard ?? Number.POSITIVE_INFINITY);
+    const when = tiers === null ? "" : `compaction past ${Math.round(tiers.soft * 100)}% at a phase end, past ${Math.round(tiers.hard * 100)}% at once`;
+    if (cells !== "" || when !== "")
+        rows.push(`  ${cells}${cells !== "" && when !== "" ? "  " : ""}${when === "" ? "" : `${p.dim}${when}${p.reset}`}`);
+    const row = (label, value, detail) => `  ${label.padEnd(15)}${k(value).padStart(6)}${detail === "" ? "" : `   ${p.dim}${detail}${p.reset}`}`;
+    if (ledger.systemPrompt > 0)
+        rows.push(row("system prompt", ledger.systemPrompt, `base ${k(ledger.systemBase)}${ledger.appends > 0 ? ` + ${ledger.appends} extension append${ledger.appends === 1 ? "" : "s"}` : ""}`));
+    if (ledger.toolTable > 0)
+        rows.push(row("tool table", ledger.toolTable, `${ledger.tools} tool${ledger.tools === 1 ? "" : "s"}`));
+    if (ledger.skillsIndex > 0)
+        rows.push(row("skills index", ledger.skillsIndex, `${ledger.skills > 0 ? `${ledger.skills} skill${ledger.skills === 1 ? "" : "s"}, ` : ""}tier-1 lines only`));
+    if (ledger.envelope > 0)
+        rows.push(row("envelope", ledger.envelope, ""));
+    if (ledger.messages > 0)
+        rows.push(row("messages", ledger.messages, `${ledger.turns} turn${ledger.turns === 1 ? "" : "s"}`));
+    rows.push(`  ${p.dim}${"free".padEnd(15)}${k(free).padStart(6)}${p.reset}`);
+    rows.push(`  ${p.dim}${SHEET_CLOSE}${p.reset}`);
+    return rows.map((r) => cutLine(r, W));
+}
+/** The sheets round — `/context` before any request, as a sheet: the band
+ *  says there is no ledger yet, the row says what produces one. */
+export function contextUnavailableSheetRows(reason, W) {
+    const p = palette();
+    return [bandHeader("context \u00b7 no ledger yet", W), `  ${p.dim}${reason}${p.reset}`, `  ${p.dim}${SHEET_CLOSE}${p.reset}`].map((r) => cutLine(r, W));
+}

package/dist/editor.d.ts

@@ -142,6 +142,17 @@ export declare class Editor {
     /** TUI2-R1 (D): whether the keys sheet is up — the compositor's slot
      *  read (bound like the menu and the picker). */
     sheetOpen(): boolean;
+    /** Graphite R3e: what the sheet shows — false when it is closed, true for
+     *  the keys sheet, the caller's rows otherwise. */
+    sheetContent(): boolean | ((W: number) => string[]);
+    /** Graphite R3e: open a read-only sheet over the input with the caller's
+     *  rows (`/status`, `/context`, `/skills`). Any key closes it, and what
+     *  is typed goes to the input; esc is eaten. */
+    openSheet(rows: (W: number) => string[]): void;
+    /** The sheets round (owner, 2026-10-06): `/help` opens the command
+     *  list — the band a typed `/` opens, filtered as the person types. On
+     *  an empty composer only: a line already being written is theirs. */
+    openCommands(): void;
     clearLine(): void;
     /** The dock's input-row state — ADDITIVE (§5): `line` + `cursor` keep
      *  their legacy meaning (the CURSOR LINE's visible slice and the
@@ -165,6 +176,9 @@ export declare class Editor {
     menuState(): {
         items: readonly MenuItem[];
         selected: number;
+        total?: number;
+        query?: string;
+        nameCol?: number;
     } | null;
     /** 0.40.1 — bind the menu's extra entries (the CLI binds the installed
      *  skills). A function, read per keystroke, never a snapshot. */
@@ -182,6 +196,9 @@ export declare class Editor {
         matches: readonly AtMatch[];
         selected: number;
         capped: boolean;
+        query: string;
+        total: number;
+        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;

package/dist/editor.js

@@ -31,7 +31,7 @@ import {} from "./approval-panel.js";
 // KC3.5: the panel-slot dispatchers — the ask branch folded into the
 // W21 lead/rows, so this file keeps ONE panel and one key owner.
 import { panelLead } from "./ask-panel.js";
-import { AT_VISIBLE, atFilter } from "./at-picker.js";
+import { AT_CAP, atFilter, atNameWidth, bandVisible } from "./at-picker.js";
 // TUI2-R2 ②: the session picker — the band's THIRD occupant. Its filter
 // is the @ picker's rank aimed at the session id; the editor owns the
 // keys, the compositor draws the rows.
@@ -137,6 +137,8 @@ export const MENU_ITEMS = [
     // never be re-wrapped in place (ADR-0046); this appends it re-folded.
     { name: "/rewrap", desc: "re-print the recent prose at the current width" },
     { name: "/status", desc: "show session id, event count, and context estimate" },
+    // Graphite R3d: the session's own name (the title, the /resume row)
+    { name: "/name", desc: "name this session · /name shows it · /name - clears it" },
     { name: "/settings", desc: "show the settings in force, each value's source, and how to change it" },
     // TUI2-R1 (E): the rent-ledger attribution — where the context went
     { name: "/context", desc: "show where the context went — the last request's rent ledger" },
@@ -374,6 +376,9 @@ export class Editor {
      *  exists for interactions (a lead, a status, a reducer, a stashed
      *  buffer), and the sheet has no interaction to speak of. */
     #sheetOpen = false;
+    /** Graphite R3e: a sheet with the CALLER's rows (`/status`), null for the
+     *  keys sheet. Any key closes either. */
+    #sheetRows = null;
     #menuOpen = false; // v3 §04: the slash-command menu
     /** 0.40.1: the menu's extra entries (the installed skills), read LIVE on
      *  every keystroke — a skill added by /reload appears without rebinding. */
@@ -394,6 +399,9 @@ export class Editor {
     // bit with no token under the cursor is inert by construction — the
     // next open re-snapshots, so a stale list can never be shown.
     #atList = null;
+    /** Graphite P2: the widest file name in the list, in cells — measured
+     *  once per open, as the list is listed */
+    #atNameCol = 0;
     #atItems = null;
     // TUI2-R2 ② — the session picker. Two fields: the bound source (its
     // presence IS "the picker is up") and the selection. The query, like
@@ -618,6 +626,30 @@ export class Editor {
     sheetOpen() {
         return this.#sheetOpen;
     }
+    /** Graphite R3e: what the sheet shows — false when it is closed, true for
+     *  the keys sheet, the caller's rows otherwise. */
+    sheetContent() {
+        return !this.#sheetOpen ? false : (this.#sheetRows ?? true);
+    }
+    /** Graphite R3e: open a read-only sheet over the input with the caller's
+     *  rows (`/status`, `/context`, `/skills`). Any key closes it, and what
+     *  is typed goes to the input; esc is eaten. */
+    openSheet(rows) {
+        this.#sheetRows = rows;
+        this.#sheetOpen = true;
+        this.#onRender();
+    }
+    /** The sheets round (owner, 2026-10-06): `/help` opens the command
+     *  list — the band a typed `/` opens, filtered as the person types. On
+     *  an empty composer only: a line already being written is theirs. */
+    openCommands() {
+        if (this.#chars.length > 0)
+            return;
+        this.#chars = ["/".codePointAt(0)];
+        this.#cursor = 1;
+        this.#verticalGoalCol = null;
+        this.#refreshMenu();
+    }
     clearLine() {
         this.#undoStack.length = 0; // UD-1
         this.#redoStack.length = 0;
@@ -783,7 +815,7 @@ export class Editor {
      *  the frame's clamp is the authority. */
     #visibleRows(lineCount) {
         const H = process.stdout.rows ?? 24;
-        const bands = (this.#menuOpen ? this.#menuFiltered().length : 0) + this.#atRows() + this.#pickInput.rows() + this.#queueState().length;
+        const bands = (this.#menuOpen ? Math.min(this.#menuFiltered().length, bandVisible(H)) + 2 : 0) + this.#atRows() + this.#pickInput.rows(H) + this.#queueState().length;
         return Math.max(1, Math.min(lineCount, N_MAX, Math.max(1, H - 3 - bands)));
     }
     /** The dock's input-row state — ADDITIVE (§5): `line` + `cursor` keep
@@ -825,7 +857,16 @@ export class Editor {
     menuState() {
         if (!this.#menuOpen)
             return null;
-        return { items: this.#menuFiltered(), selected: this.#menuSel };
+        // Graphite P2: the whole list's size and its widest name (the column
+        // never moves while the person types), and the typed prefix
+        const all = this.#menuAll();
+        return { items: this.#menuFiltered(), selected: this.#menuSel, total: all.length, query: this.line().slice(1), nameCol: all.reduce((n, m) => Math.max(n, m.name.length - 1), 0) };
+    }
+    /** Every entry the menu can show: the built-ins, then the extras that do
+     *  not shadow one (0.40.1's rule, shared with #menuFiltered). */
+    #menuAll() {
+        const builtins = new Set(MENU_ITEMS.map((m) => m.name));
+        return [...MENU_ITEMS, ...this.#menuExtras().filter((m) => !builtins.has(m.name))];
     }
     /** v3 §04: the filtered command list for the current buffer.
      *
@@ -845,9 +886,13 @@ export class Editor {
         // 0.40.1: the built-ins first, then the extras (skills) — and a
         // built-in WINS a shared name, so a skill named like a command is
         // never listed twice and never shadows it (the dispatcher's rule)
-        const builtins = new Set(MENU_ITEMS.map((m) => m.name));
-        const all = [...MENU_ITEMS, ...this.#menuExtras().filter((m) => !builtins.has(m.name))];
-        return all.filter((m) => m.name.startsWith(line));
+        const matches = this.#menuAll().filter((m) => m.name.startsWith(line));
+        // the last sweep (owner, 2026-10-06): a line that IS a command's name
+        // lists that command first, so ⏎ runs it. `/skill` listed `/skills`
+        // first (the table's order) and ⏎ completed the line to it — the
+        // command typed in full never ran. The rest keep the table's order.
+        const exact = matches.findIndex((m) => m.name === line);
+        return exact <= 0 ? matches : [matches[exact], ...matches.slice(0, exact), ...matches.slice(exact + 1)];
     }
     /** 0.40.1 — bind the menu's extra entries (the CLI binds the installed
      *  skills). A function, read per keystroke, never a snapshot. */
@@ -936,7 +981,10 @@ export class Editor {
         const view = this.#atView();
         if (view === null)
             return null;
-        return { matches: view.matches, selected: view.selected, capped: view.capped };
+        // Graphite P2: the band counts the whole list and lays its name column
+        // over it, so the folder column never moves while the person types
+        const total = Math.min(this.#atList?.length ?? 0, AT_CAP);
+        return { matches: view.matches, selected: view.selected, capped: view.capped, query: this.#atToken()?.query ?? "", total, nameCol: this.#atNameCol };
     }
     /** KC3 §3 — arm the picker at a freshly typed `@`. The gate is the
      *  KC2 precedence pattern: the approval panel, the slash menu and a
@@ -959,12 +1007,16 @@ export class Editor {
         this.#atOpen = true;
         this.#atSel = 0;
         this.#atList = this.#atItems(); // §5: listed per OPEN, never per keystroke
+        this.#atNameCol = 0;
+        for (const item of this.#atList.slice(0, AT_CAP))
+            this.#atNameCol = Math.max(this.#atNameCol, atNameWidth(item.path));
         this.#syncMouse();
     }
     #atClose() {
         this.#atOpen = false;
         this.#atSel = 0;
         this.#atList = null;
+        this.#atNameCol = 0;
         this.#syncMouse();
     }
     /**
@@ -999,7 +1051,8 @@ export class Editor {
      *  plus the counter row. */
     #atRows() {
         const view = this.#atView();
-        return view === null ? 0 : Math.min(view.matches.length, AT_VISIBLE) + 1;
+        // Graphite P2: the band's name, its window, its key row
+        return view === null ? 0 : Math.min(view.matches.length, bandVisible(process.stdout.rows ?? 24)) + 2;
     }
     // ── TUI2-R2 ② — the session picker ───────────────────────────────
     /** Open the picker on a bound card source (PickInput, S5). */
@@ -1153,16 +1206,23 @@ export class Editor {
     #feedKeys(raw) {
         const text = this.#pending + this.#decoder.decode(raw, { stream: true });
         this.#pending = "";
-        // TUI2-R1 (D): the sheet is up — ANY key closes it, and the key
-        // that closed it is CONSUMED. The whole chunk goes, deliberately:
-        // an arrow key is three bytes, and closing on the first while
-        // letting `[A` fall through as literal text would be a sheet that
-        // types into your composer on the way out. A dismissal costs one
-        // keystroke; that is the entire contract.
+        // TUI2-R1 (D): the sheet is up — ANY key closes it. Graphite R3e: a
+        // sheet is read and then typed past — the whole chunk is typed as it
+        // would have been (it is parsed whole, so an arrow is an arrow, never
+        // `[A`); only esc, which means nothing else here, is eaten.
+        //
+        // DECLARED REVERSAL (the sheets round, owner, 2026-10-06): the keys
+        // sheet ate the key that closed it, where `/status` let it through;
+        // every sheet now closes the same way, and says so on its last row.
+        // The `?` that opens the keys sheet is eaten too: typed onto an
+        // empty composer it would open the sheet it just closed.
         if (this.#sheetOpen) {
+            const keys = this.#sheetRows === null;
             this.#sheetOpen = false;
+            this.#sheetRows = null;
             this.#onRender();
-            return;
+            if (text === "\x1b" || (keys && text === "?"))
+                return;
         }
         // R5 — while the viewer is up it OWNS the keyboard. Unlike the
         // sheet (which any key dismisses) this surface is INTERACTIVE, so
@@ -1723,6 +1783,7 @@ export class Editor {
                 // already encodes "no panel, no menu, no picker, no browse".
                 // The precedence can only ever ADD: every state that used to
                 // insert a `?` still inserts one.
+                this.#sheetRows = null;
                 this.#sheetOpen = true;
                 this.#onRender();
                 i += 1;

package/dist/index.d.ts

@@ -7,17 +7,17 @@
  * editor, the diff renderer, and the palette.
  */
 export { Body, Dock, CURSOR_MARKER, type BodyOptions } from "./compositor.js";
-export { panelAffordance, panelBlockRows, panelLead, panelLeadPlain, panelLeadWidth, panelStatus, PICK_MAX, modePickView, modelPickView, namedPickView, pickAffordance, pickBlockRows, pickLeadPlain, type PickOption, type PickResult, type PickRuntime, type PickSpec, type PanelArgs, type PanelFlavor, type PanelPhase, deletionRiskHint, SAFER_BACK, SAFER_DEGRADED, SAFER_DEGRADED_TRUNCATED, saferDegradedNote, type SaferAnswer, type SaferFailure, type SaferOption, type SaferRuntime, panelOptions, type PanelOption, type PanelOptionKind, type PanelState, type PanelVerdict, type PanelView, } from "./approval-panel.js";
-export { Container, foldLine, foldWords, visibleWidth, SPINNER, type Component, type FrameCtx } from "./components.js";
+export { panelAffordance, panelBlockRows, panelLead, panelLeadPlain, panelLeadWidth, panelStatus, PICK_MAX, modePickView, modelPickView, settingsPickView, namedPickView, pickAffordance, pickBlockRows, pickLeadPlain, type PickOption, type PickResult, type PickRuntime, type PickSpec, type PanelArgs, type PanelFlavor, type PanelPhase, deletionRiskHint, SAFER_BACK, SAFER_DEGRADED, SAFER_DEGRADED_TRUNCATED, saferDegradedNote, type SaferAnswer, type SaferFailure, type SaferOption, type SaferRuntime, panelOptions, type PanelOption, type PanelOptionKind, type PanelState, type PanelVerdict, type PanelView, } from "./approval-panel.js";
+export { Container, foldLine, foldWords, infoSheetRows, visibleWidth, SPINNER, type Component, type FrameCtx, type NoticeMark, type RecallSection } from "./components.js";
 export { Editor, MENU_ITEMS, PROMPT, PROMPT_WIDTH, displayWidth, charWidth, widthOf, type MenuItem, } from "./editor.js";
-export { bannerLines, COLOR_OFF, COLOR_ON, currentGround, setGround, escapeTerminal, foldResult, foldThinking, kUnit, palette, renderEvent, renderRecap, renderResumeList, renderSessionLine, renderStatusLine, relativeTime, renderTerminalGap, renderToolSummary, TAGLINE, toolTarget, truncateRow, type Palette, type PathResolver, type RecapStats, type ResumeMeta, type RenderInput, type RenderResult, type RunUsage, } from "./lines.js";
-export { editFileDiff, truncateDiff, writeFileDiff, type DiffLine, type DiffResult } from "./diff.js";
-export { STATUS_GLYPHS, cacheHitPct, compactingStatus, composeRow, decodeRate, idleStatus, retrySegment, runningStatus, tasksSegment, type CompactingProgress, type RetryOnRow, type RowSegment, type StatusMeter, type TaskCountsOnRow } from "./status.js";
-export { contextRows, contextUnavailableRows, type ContextLedger } from "./context-ledger.js";
+export { bannerLines, COLOR_OFF, COLOR_ON, currentGround, setGround, escapeTerminal, foldResult, foldThinking, kUnit, palette, renderEvent, renderRecap, sealTiers, renderResumeList, renderSessionLine, renderStatusLine, relativeTime, renderTerminalGap, renderToolSummary, TAGLINE, MOTTO, WORDMARK_W, type BannerFact, type BannerMeta, toolTarget, truncateRow, type Palette, type PathResolver, type RecapStats, type ResumeMeta, type RenderInput, type RenderResult, type RunUsage, } from "./lines.js";
+export { editFileDiff, editFileHunksDiff, hunksDiff, hunksOf, truncateDiff, writeFileDiff, type DiffLine, type DiffResult, type Hunk } from "./diff.js";
+export { STATUS_GLYPHS, cacheHitPct, compactingStatus, composeRow, ctxMeter, decodeRate, liveRow, retrySegment, statusBar, tasksSegment, workingRow, type BarInput, type CompactingProgress, type RetryOnRow, type RowSegment, type TaskCountsOnRow } from "./status.js";
+export { contextRows, contextSheetRows, contextUnavailableRows, contextUnavailableSheetRows, meterCells, type ContextLedger } from "./context-ledger.js";
 export { interactivePrompt, projectTrustRows, projectTrustView, projectUntrustedNote, uncertainView, type TrustArtifact } from "./strings.js";
-export { AT_CAP, AT_SKIP, AT_VISIBLE, atEmbed, atFilter, atPanelRows, atWindow, bandHeader, longestRun, type AtItem, type AtMatch } from "./at-picker.js";
-export { idColumn, sessionAge, sessionCounterRow, sessionFilter, sessionListFooter, sessionListHeader, sessionListUnknownLine, sessionListRow, sessionNote, sessionPickerRows, sessionRow, scopeSessions, scopeTitle, type PickScopeState, type SessionCardView, type SessionPickState, } from "./session-picker.js";
+export { AT_CAP, AT_SKIP, AT_VISIBLE, atEmbed, atFilter, atPanelRows, bandHeader, longestRun, type AtItem, type AtMatch } from "./at-picker.js";
+export { idColumn, sessionAge, sessionFilter, sessionListFooter, sessionListHeader, sessionListUnknownLine, sessionListRow, sessionNote, sessionPickerRows, scopeSessions, scopeTitle, type PickScopeState, type SessionCardView, type SessionPickState, } from "./session-picker.js";
 export { ASK_HEADER_CAP, ASK_MAX_OPTIONS, ASK_MAX_QUESTIONS, ASK_MIN_OPTIONS, askAffordance, askAnswers, askBlockRows, askCommitCustom, askDeclineAll, askDeclineList, askKey, askLeadPlain, askStart, askStatus, askView, type AskAnswer, type AskOption, type AskQuestion, type AskResult, type AskRuntime, type AskSpec, type AskStep, } from "./ask-panel.js";
-export { resolveGround, type Ground } from "@vincemakes/kiso-tui-cells";
+export { currentGroundRgb, parseOscColor, resolveGround, type Ground, type Rgb } from "@vincemakes/kiso-tui-cells";
 export { settledLabel } from "@vincemakes/kiso-tui-cells";
-export { KEY_BINDINGS, PANEL_KEYS_ROW, coldResumeLine, coldResumeView, displayVerb, extensionsBannerText, helpRows, keysHelpRow, keysSheetRows, slashCommandNames, unansweredAskView, type BannerExtension, type KeyBinding } from "./strings.js";
+export { KEY_BINDINGS, SHEET_CLOSE, coldResumeLine, coldResumeView, displayVerb, extensionsBannerText, extensionsFact, helpRows, keysHelpRow, keysSheetRows, slashCommandNames, unansweredAskView, type BannerExtension, type KeyBinding } from "./strings.js";

package/dist/index.js

@@ -12,28 +12,28 @@ export { Body, Dock, CURSOR_MARKER } from "./compositor.js";
 // approval is pending (the shape authority is the committed preview).
 export { panelAffordance, panelBlockRows, panelLead, panelLeadPlain, panelLeadWidth, panelStatus, 
 // TUI2-R2 ④: the pick payload — the panel slot's third occupant.
-PICK_MAX, modePickView, modelPickView, namedPickView, pickAffordance, pickBlockRows, pickLeadPlain, deletionRiskHint, SAFER_BACK, SAFER_DEGRADED, SAFER_DEGRADED_TRUNCATED, saferDegradedNote, panelOptions, } from "./approval-panel.js";
-export { Container, foldLine, foldWords, visibleWidth, SPINNER } from "./components.js";
+PICK_MAX, modePickView, modelPickView, settingsPickView, namedPickView, pickAffordance, pickBlockRows, pickLeadPlain, deletionRiskHint, SAFER_BACK, SAFER_DEGRADED, SAFER_DEGRADED_TRUNCATED, saferDegradedNote, panelOptions, } from "./approval-panel.js";
+export { Container, foldLine, foldWords, infoSheetRows, visibleWidth, SPINNER } from "./components.js";
 export { Editor, MENU_ITEMS, PROMPT, PROMPT_WIDTH, displayWidth, charWidth, widthOf, } from "./editor.js";
-export { bannerLines, COLOR_OFF, COLOR_ON, currentGround, setGround, escapeTerminal, foldResult, foldThinking, kUnit, palette, renderEvent, renderRecap, renderResumeList, renderSessionLine, renderStatusLine, relativeTime, renderTerminalGap, renderToolSummary, TAGLINE, toolTarget, truncateRow, } from "./lines.js";
-export { editFileDiff, truncateDiff, writeFileDiff } from "./diff.js";
+export { bannerLines, COLOR_OFF, COLOR_ON, currentGround, setGround, escapeTerminal, foldResult, foldThinking, kUnit, palette, renderEvent, renderRecap, sealTiers, renderResumeList, renderSessionLine, renderStatusLine, relativeTime, renderTerminalGap, renderToolSummary, TAGLINE, MOTTO, WORDMARK_W, toolTarget, truncateRow, } from "./lines.js";
+export { editFileDiff, editFileHunksDiff, hunksDiff, hunksOf, truncateDiff, writeFileDiff } from "./diff.js";
 // KC2 §5: the status rows' formatters — the CLI keeps the state and the
 // repaint, the terminal layer owns what the row says.
-export { STATUS_GLYPHS, cacheHitPct, compactingStatus, composeRow, decodeRate, idleStatus, retrySegment, runningStatus, tasksSegment } from "./status.js";
+export { STATUS_GLYPHS, cacheHitPct, compactingStatus, composeRow, ctxMeter, decodeRate, liveRow, retrySegment, statusBar, tasksSegment, workingRow } from "./status.js";
 // TUI2-R1 (E): /context's attribution rows — a pure function of the
 // counts the trace sidecar already records (the CLI reads, this renders).
-export { contextRows, contextUnavailableRows } from "./context-ledger.js";
+export { contextRows, contextSheetRows, contextUnavailableRows, contextUnavailableSheetRows, meterCells } from "./context-ledger.js";
 // KC3 §1 (the extraction): the human-facing strings — the prompt, the
 // project-trust listing/view/note, the uncertain execution's view. The
 // FLOW (who is asked, what a verdict means) stays in the cli.
 export { interactivePrompt, projectTrustRows, projectTrustView, projectUntrustedNote, uncertainView } from "./strings.js";
 // KC3 §3/§5: the @ file picker's pure half — the subsequence filter, the
 // deterministic rank, and the ONE cap the CLI's file source shares.
-export { AT_CAP, AT_SKIP, AT_VISIBLE, atEmbed, atFilter, atPanelRows, atWindow, bandHeader, longestRun } from "./at-picker.js";
+export { AT_CAP, AT_SKIP, AT_VISIBLE, atEmbed, atFilter, atPanelRows, bandHeader, longestRun } from "./at-picker.js";
 // TUI2-R2 ①–③: the session picker's pure half — the durability badge,
 // the row (picked or printed), the band, and the filter. The CARDS are
 // the cli's projection (session-cards.ts); this turns them into bytes.
-export { idColumn, sessionAge, sessionCounterRow, sessionFilter, sessionListFooter, sessionListHeader, sessionListUnknownLine, sessionListRow, sessionNote, sessionPickerRows, sessionRow, 
+export { idColumn, sessionAge, sessionFilter, sessionListFooter, sessionListHeader, sessionListUnknownLine, sessionListRow, sessionNote, sessionPickerRows, 
 // 0.40.0: the workspace scope — pure, so `kiso sessions` and the picker
 // scope by one rule
 scopeSessions, scopeTitle, } from "./session-picker.js";
@@ -45,8 +45,8 @@ export { ASK_HEADER_CAP, ASK_MAX_OPTIONS, ASK_MAX_QUESTIONS, ASK_MIN_OPTIONS, as
 // honestly for a question nobody answered (the ① probe's surface).
 // TUI2-R1 (D): the keys sheet + THE key table — one source for the ?
 // overlay and /help's keys row.
-export { resolveGround } from "@vincemakes/kiso-tui-cells";
+export { currentGroundRgb, parseOscColor, resolveGround } from "@vincemakes/kiso-tui-cells";
 // one duration form: the CLI's own surfaces label a settled duration the
 // way a settled card does, rather than writing a second one.
 export { settledLabel } from "@vincemakes/kiso-tui-cells";
-export { KEY_BINDINGS, PANEL_KEYS_ROW, coldResumeLine, coldResumeView, displayVerb, extensionsBannerText, helpRows, keysHelpRow, keysSheetRows, slashCommandNames, unansweredAskView } from "./strings.js";
+export { KEY_BINDINGS, SHEET_CLOSE, coldResumeLine, coldResumeView, displayVerb, extensionsBannerText, extensionsFact, helpRows, keysHelpRow, keysSheetRows, slashCommandNames, unansweredAskView } from "./strings.js";

package/dist/lines.d.ts

@@ -181,7 +181,18 @@ export interface RecapStats {
      *  the plan, not the tool count — the timing and tool-count parts
      *  drop, and the two /mode hints replace them. */
     readonly mode?: string;
+    /** Graphite §7.11 — the person stopped the turn (esc): the seal says
+     *  so, and that everything before the stop is on disk. */
+    readonly stopped?: boolean;
 }
+/**
+ * Graphite §7.11 — THE SEAL's forms, widest first, without the `✦`: the
+ * compositor draws the mark and picks the widest form that fits. The
+ * same facts as `renderRecap`, in its words, with two differences: no
+ * context share — the status bar's meter carries it — and a stopped turn
+ * says so. The pipe keeps `renderRecap`'s line.
+ */
+export declare function sealTiers(s: RecapStats): string[];
 export declare function renderRecap(s: RecapStats): string;
 /** One-line summary of a session, for `kiso sessions`. */
 export declare function renderSessionLine(meta: {

package/dist/lines.js

@@ -155,6 +155,44 @@ export function renderStatusLine(turn, usage, ctxRatio, faux = false) {
         return null;
     return `[turn ${turn} · ${parts.join(" · ")}]`;
 }
+/**
+ * Graphite §7.11 — THE SEAL's forms, widest first, without the `✦`: the
+ * compositor draws the mark and picks the widest form that fits. The
+ * same facts as `renderRecap`, in its words, with two differences: no
+ * context share — the status bar's meter carries it — and a stopped turn
+ * says so. The pipe keeps `renderRecap`'s line.
+ */
+export function sealTiers(s) {
+    if (s.mode === "plan")
+        return [["plan ready", "/mode default executes", "/mode accept-edits auto-approves edits"].join(" \u00b7 ")];
+    const time = s.stopped === true ? `stopped by you after ${elapsedLabel(s.seconds)}` : `took ${elapsedLabel(s.seconds)}`;
+    const parts = [time];
+    const cold = s.coldAfterMinutes !== undefined && s.usage.known && s.usage.in !== null;
+    let coldLabel = null;
+    if (cold) {
+        coldLabel = `cache cold after ${s.coldAfterMinutes} min`;
+        parts.push(coldLabel, `re-read ${kUnit(s.missed ?? s.usage.in ?? 0)}`);
+        if (s.usage.out !== null)
+            parts.push(`out ${kUnit(s.usage.out)}`);
+    }
+    else if (s.usage.known) {
+        const seg = `${s.usage.in !== null ? `fresh ${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 || s.usage.cache > 0)) {
+            const hit = `cache ${Math.round((s.usage.cache / (s.usage.in + s.usage.cache)) * 100)}%`;
+            parts.push(s.missed !== undefined && s.missed > 0 ? `${hit} \u00b7 miss ${kUnit(s.missed)}` : hit);
+        }
+    }
+    if (s.stopped === true)
+        parts.push("everything up to here is saved");
+    const full = parts.join(" \u00b7 ");
+    if (coldLabel === null)
+        return [full];
+    // R3g: a cold turn sheds its LABEL before anything is cut — the gap and
+    // the re-read are the facts.
+    return [full, parts.map((x) => (x === coldLabel ? `cold ${s.coldAfterMinutes} min` : x)).join(" \u00b7 ")];
+}
 /** R3d — the per-tool terms of a settled turn (`read 4 files · ran 1
  *  shell command`, zero terms dropped). One wording for "what a run
  *  did", wherever it is said. */

package/dist/notice-meta.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Graphite §7.12 — a notice's META ROW: the label and the sentence.
+ *
+ * kiso's notices are sentences the CLI writes in a handful of shapes, and
+ * a pipe prints them exactly as written. On a terminal each becomes a meta
+ * row — a word label and the sentence beside it — so this maps the shapes
+ * to their labels in ONE place, and the call sites keep their text.
+ *
+ * The `✦` some notices open with retires on the terminal: `✦` is the
+ * turn's seal (§4), and a label says what the row is.
+ */
+import type { NoticeMark } from "./components.js";
+export interface NoticeMeta {
+    /** The row's label; absent for a sentence that has no kind of its own
+     *  (a command's confirmation — `mode → plan`, `[/compact] …` without
+     *  its brackets), which stays whole at the content edge. `""`
+     *  continues the row above. */
+    readonly label?: string;
+    readonly sentence: string;
+    /** The word the row marks, and its colour — a lost task's gold. */
+    readonly mark?: NoticeMark;
+    /** One row, cut with `…` — a row that names a thing (§7.12). */
+    readonly oneRow?: true;
+}
+export declare function noticeMeta(text: string): NoticeMeta;

package/dist/notice-meta.js

@@ -0,0 +1,83 @@
+/**
+ * Graphite §7.12 — a notice's META ROW: the label and the sentence.
+ *
+ * kiso's notices are sentences the CLI writes in a handful of shapes, and
+ * a pipe prints them exactly as written. On a terminal each becomes a meta
+ * row — a word label and the sentence beside it — so this maps the shapes
+ * to their labels in ONE place, and the call sites keep their text.
+ *
+ * The `✦` some notices open with retires on the terminal: `✦` is the
+ * turn's seal (§4), and a label says what the row is.
+ */
+/** kiso's session events — the notices that are a KIND of thing, first
+ *  match wins. A command's own confirmation is not one of them: its words
+ *  are read as a whole, and a label would only split them. */
+const SHAPES = [
+    [/^✦ compacted (.*)$/s, "COMPACTED", (m) => m[1]],
+    [/^\[\/compact\] ✦ compacted(?: · )?(.*)$/s, "COMPACTED", (m) => m[1]],
+    [/^✦ pruned (.*)$/s, "PRUNED", (m) => m[1]],
+    [/^✦ window learned — (.*)$/s, "WINDOW", (m) => `learned — ${m[1]}`],
+    // the main-sync round: a background task's delivery (ADR-0058, main's
+    // task-notice.ts) is a session event like the others
+    [/^✦ task (.*)$/s, "TASK", (m) => m[1]],
+    [/^run failed — (.*)$/s, "FAILED", (m) => m[1]],
+    [/^(\S+) FAILED — (.*)$/s, "UNCERTAIN", (m) => `${m[1]} — ${m[2]}`],
+    // Graphite P1b (owner, 2026-09-30): dontAsk leaves an interrupted call
+    // undecided — said as what it is, and when it will be asked
+    [/^\[dontAsk\] (\d+) uncertain executions? left unresolved — resolve them in an asking mode$/s, "UNCERTAIN", (m) => `${m[1]} interrupted command${m[1] === "1" ? "" : "s"} left undecided — asked once don't ask is off`],
+    // the main-sync round (owner, 2026-09-30): a call refused because the
+    // don't-ask switch is on — the person set this up, so the label is dim,
+    // not a failure's red
+    [/^\[dontAsk\] (\S+) would ask — denied$/s, "DENIED", (m) => `${m[1]} would ask — denied`],
+    [/^(stopped at the .*-turn limit.*)$/s, "LIMIT", (m) => m[1]],
+    [/^(answer truncated at max_tokens.*)$/s, "LIMIT", (m) => m[1]],
+    [/^stream interrupted — (.*)$/s, "INTERRUPTED", (m) => m[1]],
+    [/^(no reply recorded — .*)$/s, "INTERRUPTED", (m) => m[1]],
+    [/^verification pass$/s, "VERIFY", () => ""],
+    // the last sweep (owner, 2026-10-06): a session switch (`/clear`,
+    // `/resume <id>`) is a session event — the id it opened and the way back
+    [/^session (\S+) \(switched — previous: (\S+), \/resume \S+ returns\)\n?$/s, "SESSION", (m) => `${m[1]} · /resume ${m[2]} returns`],
+    [/^--- re-wrapped (\d+ blocks?) at the current width \(appended — the history above is unchanged\) ---$/s, "REWRAPPED", (m) => `${m[1]} at the current width · the history above is unchanged`],
+    [/^\[dontAsk\] the model's question was declined — nothing asks in dontAsk$/s, "DENIED", () => "the model's question — nothing asks while don't ask is on"],
+    // …and a command's own reply. It wore its command in brackets
+    // (`[/compact] …`, `[reload] …`), or brackets alone (`[no thinking
+    // yet]`), or `--- … ---` rules; on the terminal the person has just
+    // typed the command, so the reply is a sentence at the content edge.
+    // A pipe keeps every bracket.
+    [/^\[reload\] (\d+ extensions?\b.*)$/s, null, (m) => `reloaded ${m[1]}`],
+    [/^\[reload\] (.*)$/s, null, (m) => `reload failed: ${m[1]}`],
+    [/^\[\/([a-z-]+)\] failed: (.*)$/s, null, (m) => `/${m[1]} failed: ${m[2]}`],
+    [/^\[\/[a-z-]+\] (.*)$/s, null, (m) => m[1]],
+    [/^\[(turn held — [^\]]+)\] (.*)$/s, null, (m) => `${m[1]} · ${m[2]}`],
+    [/^\[([^[\]\n]+)\]$/s, null, (m) => m[1]],
+    [/^no such mode: (.*)\ntiers: (.*)$/s, null, (m) => `no such mode: ${m[1]} · tiers: ${m[2]}`],
+    [/^--- (\d+ earlier blocks?) not re-wrapped \(bounded at two screens\) ---$/s, null, (m) => `${m[1]} not re-wrapped — bounded at two screens`],
+];
+/** The main sync (0.46.2, Amendment 8) — a task kiso lost track of, said
+ *  the moment it is concluded: `✦ lost track of <id> (<what>) — it may
+ *  still be running · /tasks shows it` (the parenthesis only when the
+ *  command is known; the last ` — ` opens the tail — both pinned by the
+ *  line's own test). On the terminal it is the TASK row a delivery draws,
+ *  `lost track — may still be running` in gold. */
+const LOST = /^✦ lost track of (\S+)(?: \((.*)\))? — (it may still be running.*)$/s;
+export function noticeMeta(text) {
+    const lost = LOST.exec(text);
+    if (lost !== null) {
+        const word = "lost track — may still be running";
+        // one row, as every row that names a thing (§7.12): where to look before
+        // what ran, so a cut takes the command, never the way to it
+        return { label: "TASK", sentence: `${lost[1]} ${word} · /tasks shows it${lost[2] !== undefined ? ` · ${lost[2]}` : ""}`, mark: { text: word, tone: "gold" }, oneRow: true };
+    }
+    // a notice that opens with spaces continues the one above it (the
+    // verification pass's content): no label of its own
+    if (/^ {2}\S/.test(text))
+        return { label: "", sentence: text.trim() };
+    for (const [re, label, sentence] of SHAPES) {
+        const m = re.exec(text);
+        if (m !== null)
+            return label === null ? { sentence: sentence(m) } : { label, sentence: sentence(m) };
+    }
+    // no kind of its own: the sentence stays whole — only the `✦`, which is
+    // the seal's mark on a terminal (§4), comes off
+    return { sentence: text.replace(/^✦ /, "") };
+}

package/dist/panel-input.d.ts

@@ -6,8 +6,8 @@
  * one band, in an order the editor keeps in one place: the panel first,
  * then the session picker, then the composer's own bands. What the
  * panel may do to the composer is the `BandHost` surface and nothing
- * else: it types its amend reason, its custom ask answer and its custom
- * pick into the composer, stashes the composer at open, restores it at
+ * else: it types its amend reason, its custom ask answer and a pick's
+ * filter into the composer, stashes the composer at open, restores it at
  * close — that is the whole coupling, and it is visible here.
  *
  * DECLARED MOVE (S5, 2026-09-06): every method below stood in editor.ts