@modelstatus/cli 0.1.49 → 0.1.50

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modelstatus/cli",
-  "version": "0.1.49",
+  "version": "0.1.50",
   "description": "Track which AI models you use, where, and never get surprised by a retirement. Free offline model-health for any repo (mm status), browser sign-in for cloud inventory + alerts.",
   "keywords": [
     "llm",

package/src/tui/app.js

@@ -40,6 +40,42 @@ const GATE_KEYS = [{ k: "1-8", label: "switch" }, { k: "7", label: "sign in" }];
 // toast, status, keybar, bottomRule) — the body fills whatever rows remain.
 const CHROME_ROWS = 10;
 
+/**
+ * How many rows to leave UN-rendered below the frame so the window never clips.
+ *
+ *  - 1 row everywhere: a frame that fills the full height makes ink write+newline
+ *    the bottom line, which scrolls the buffer up by 1 each render; reserving the
+ *    last row keeps it blank so nothing ever scrolls.
+ *  - 6 rows in Warp: Warp keeps ~5 rows of block chrome (sticky command header +
+ *    pinned input) drawn OVER the alternate screen and over-reports stdout.rows by
+ *    that much, so the TOP clips unless we also subtract them (1 guard + 5 chrome;
+ *    measured against the user's Warp build — see Warp issues #6428/#2373, the
+ *    chrome area can't be reclaimed via alt_screen_padding). Gated on TERM_PROGRAM
+ *    so non-Warp terminals keep the plain 1-row reserve (an extra reserve elsewhere
+ *    would leave a blank band).
+ *
+ * MM_TUI_RESERVE_ROWS (integer ≥ 0) overrides the whole reserve so a user on a
+ * different Warp version / input position / timing-line setting can self-tune
+ * (e.g. =5 or =7) without waiting for a release; 0 opts out entirely.
+ */
+export function rowsReserve(env = process.env) {
+  // Only a non-blank, integer-valued string overrides (so `MM_TUI_RESERVE_ROWS=`
+  // or stray whitespace falls back to the default rather than being read as 0 —
+  // `Number("")` is 0). `=0` is honored as an explicit opt-out.
+  const raw = env.MM_TUI_RESERVE_ROWS;
+  if (typeof raw === "string" && raw.trim() !== "") {
+    const n = Number(raw);
+    if (Number.isInteger(n) && n >= 0) return n;
+  }
+  return env.TERM_PROGRAM === "WarpTerminal" ? 6 : 1;
+}
+
+/** Frame height for a terminal of `rows` rows: reserve rows, then clamp to a
+ * sane window [8, 200]. Pure (env-injectable) so it's unit-testable. */
+export function computeTermRows(rows, env = process.env) {
+  return Math.max(8, Math.min((rows || 24) - rowsReserve(env), 200));
+}
+
 /** Full terminal dims, resize-aware. Fills the screen edge-to-edge.
  * MM_TUI_WIDTH / MM_TUI_HEIGHT force exact dims (reproducible screenshots). */
 function useTermDims() {
@@ -69,17 +105,10 @@ function useTermDims() {
   const cols = Number.isFinite(fw) && fw > 0 ? fw : dims.cols;
   const rows = Number.isFinite(fh) && fh > 0 ? fh : dims.rows;
   // Never exceed the real terminal width (a wider frame soft-wraps every chrome
-  // line and shatters the window).
-  //
-  // Height: RESERVE THE LAST ROW (rows - 1). A frame that fills the full height
-  // makes ink write+newline the bottom line, which scrolls the buffer up by 1
-  // EVERY render; across the handful of renders during load/settle that scroll
-  // accumulates and creeps the window's top off-screen (the "not full-screen after
-  // the game / in Warp" clip). One row short keeps the last line blank so nothing
-  // ever scrolls. This is safe now that the TUI lives in the ALT SCREEN: ink's
-  // cursor-up diffing (which it uses when the frame is shorter than the terminal)
-  // stays inside the fixed alt buffer and can't drift the way it did inline.
-  return { outer: Math.min(cols || 80, 220), termRows: Math.max(8, Math.min((rows || 24) - 1, 200)) };
+  // line and shatters the window). Height reserves rows (see rowsReserve) so the
+  // frame never fills the screen and clips the top — 1 row everywhere (scroll
+  // guard), 6 in Warp (block chrome over-reports rows), MM_TUI_RESERVE_ROWS tunes.
+  return { outer: Math.min(cols || 80, 220), termRows: computeTermRows(rows) };
 }
 
 function PromptRow({ prompt }) {