@tiens.nguyen/gu-cli 1.0.786 → 1.0.787

package/gu-repl.mjs

@@ -3649,6 +3649,33 @@ function jumpToBottom() {
   paintLiveTail();
 }
 /** Paint the tail, put the output position on it, and let the bar drop the jump affordance. */
+/**
+ * DIAGNOSTIC — `GU_SCREEN_DUMP=<file> gu` writes, a few times a second, what gu BELIEVES the
+ * scrolling area shows (#324, #326). A display bug in this terminal is always the same thing: the
+ * screen and gu's record of it disagree, and from then on text is drawn over its neighbour. With
+ * this file beside a terminal emulator's own screen the first step where they part is found by
+ * comparing, not by reading a paste. Off unless the variable is set; never written otherwise.
+ */
+if (process.env.GU_SCREEN_DUMP) {
+  setInterval(() => {
+    try {
+      const rows = displayRows(transcript.lines(), Math.max(20, process.stdout.columns || 80) - 1).length;
+      writeFileSync(
+        process.env.GU_SCREEN_DUMP,
+        JSON.stringify({
+          at: Date.now(),
+          pad: currentPad(rows),
+          height: viewportHeight(),
+          reserved: barReserved,
+          scrolledBack: scrolledBack(),
+          view: viewportSlice(screenRows(), scrollOffset, viewportHeight()).rows.map((r) => r.replace(/\x1b\[[0-9;?]*[A-Za-z]/g, "")),
+        })
+      );
+    } catch {
+      /* a diagnostic must never be the thing that breaks */
+    }
+  }, 150).unref();
+}
 function paintLiveTail() {
   scrollOffset = 0;
   const width = Math.max(20, process.stdout.columns || 80);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiens.nguyen/gu-cli",
-  "version": "1.0.786",
+  "version": "1.0.787",
   "description": "Gu CLI — the gu terminal plus the local worker that runs agent / OCR / PDF / embedding jobs on your Mac (Ollama / MLX / OpenAI-compatible).",
   "type": "module",
   "license": "MIT",