Preserve terminal input across resize events with level-triggered polling

Author: ShadowfetchStudio

CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## 0.20.0 — native development (unreleased)
 
+- Native terminal input uses level-triggered polling after CI exposed dropped
+  keys around resize events. Full-color PTY checks verify Escape closes Help
+  before the next task submission.
+
 - Reviewed CLI and desktop worktree return prepare incoming commits in the source index
   without committing. Stale reviews and active work are rejected; conflicts and
   ignored local files are preserved for explicit resolution.

Cargo.lock

@@ -68,7 +68,8 @@ terminal settings. Drafts and prompt recall are currently in memory.
 ## Verification and remaining work
 
 `node scripts/test-native-tui.mjs` drives a real PTY and scripted compatible model
-with no display. It covers multiline Unicode paste, actual file inspection, shared
+with no display and full terminal colors. It checks that Escape restores the
+composer before the next key, and covers multiline Unicode paste, actual file inspection, shared
 CLI attachment, explicit command approval, planning mode, owned task cancellation
 and terminal restoration. Live PTY resizing covers the below-minimum warning,
 compact help scrolling to its final line and Home, expanded-dialog recovery, and

docs/NATIVE_TUI.md

@@ -304,6 +304,25 @@ these transitions. Assertions inspect fresh complete frames because incremental
 ANSI updates can split words. This covers resize recovery; broader picker
 navigation, visual review and sustained terminal stress remain open.
 
+## Terminal input after resize
+
+CI run `35544397210` failed the terminal probe after Help stayed open and the
+following Enter did not submit the draft. Its retained ANSI recording showed
+the Help overlay still present. A local full-color run reproduced a related
+Home/resize timeout, which the previous inherited `NO_COLOR` environment had
+not exposed. Crossterm now uses its level-triggered `use-dev-tty` input backend
+instead of the edge-triggered Mio source, avoiding dropped readiness across
+simultaneous input and resize notifications. The PTY fixture explicitly enables
+truecolor and waits for the visible composer cursor after Escape before sending
+another key.
+
+Three consecutive full-color PTY runs pass, each with eight scripted model
+requests, resize/help navigation, approvals, cancellation and terminal restoration.
+The native build, library tests and workspace Clippy pass. Dependency notice
+generation includes the new locked `filedescriptor` dependency and now covers
+576 application dependencies. These local results address the observed failure;
+the replacement CI run must still complete before its result is claimed.
+
 ## Reviewed return of worktree commits
 
 Nine worktree tests pass. Return-specific scenarios exercise diverged branches,

docs/NATIVE_VERIFICATION.md

@@ -34,7 +34,8 @@ hyper = { version = "1", features = ["http1", "server"] }
 hyper-util = { version = "0.1", features = ["tokio"] }
 tower-service = "0.3"
 ratatui = { version = "=0.30.2", default-features = false, features = ["crossterm_0_29"] }
-crossterm = { version = "=0.29.0", default-features = false, features = ["event-stream", "bracketed-paste"] }
+# Level-triggered terminal polling preserves input readiness across resize events.
+crossterm = { version = "=0.29.0", default-features = false, features = ["event-stream", "bracketed-paste", "use-dev-tty"] }
 unicode-segmentation = "1"
 unicode-width = "0.2"
 

native/core/Cargo.toml

@@ -33,6 +33,9 @@ await rm(path.join(artifacts, "failure.txt"), { force: true });
 const env = { ...process.env, TERM: "xterm-256color" };
 delete env.DISPLAY;
 delete env.WAYLAND_DISPLAY;
+// Exercise real color output even when the invoking tool disables colors.
+delete env.NO_COLOR;
+env.COLORTERM = "truecolor";
 const children = new Set(),
   sockets = new Set(),
   requests = [];
@@ -248,8 +251,11 @@ try {
   tui.child.stdin.write("\x1b[6~".repeat(40));
   await delay(150);
   await resize(tui, 40, 110, "unrelated tasks continue.");
+  const closingHelp = tui.output.stdout.length;
   tui.child.stdin.write("\x1b");
-  await delay(150);
+  await until("Escape closes help before another key", () =>
+    tui.output.stdout.slice(closingHelp).includes("\x1b[?25h"),
+  );
   await resize(tui, 32, 110, "SHADOWCODE");
   assert.equal(
     requests.length,