Live TUI readiness after opening Ensemble
Ticket #287. This record covers the OpenCode 2.3.0 compatibility failure at the first TUI typing step and the harness changes that make opening the page and editing the command line deterministic. Status: PASS; confirmed by required CI at a7f1eb3.
Environment
| Item | Value |
|---|---|
| Base | a0c39c0 (ticket/287-tui-ready) |
| Platform | Linux/tmux 3.5a |
| Node | 26.12.1 |
| OpenCode | 2.3.0 and 2.2.7 |
| Isolation | scripts/lib/live-harness.sh; fresh HOME/XDG roots, project, workspace, fake provider, and host per run |
Changes
live_open_ensemblenow resizes the TUI window toENSEMBLE_LIVE_TUI_WIDTH/ENSEMBLE_LIVE_TUI_HEIGHT(default 160x60) after theENSEMBLEheader appears, forcing a redraw and tolerating a missing window. It then waits for a non-emptylive_status_linemode chip before returning, so a header-only first paint cannot accept input.src/v2/live-matrix.test.tsguards the readiness contract with a stubbed TUI: a header-only pane fails, a mode word inside another row does not satisfy the gate, a realNORMAL │ Agentsrow passes, and the resize is issued at the configured geometry.- The command-line editing step in
scripts/live-check-fake.shnow waits for:settingsto disappear after Backspace before retyping the singles.:settingis a prefix of:settings, so the old wait could pass on the pre-Backspace frame; the following retype then restored the exact pane the liveness check captured, andlive_typereported a lost key that had actually arrived. Assertions are unchanged in strength; the ordering is now unambiguous.
Evidence
| Command | Host | Result |
|---|---|---|
npm run test:live:fake:all (ENSEMBLE_LIVE_REQUIRE=1) | 2.3.0 | PASS — fake 404 s and fake-empty 9 s, 2 passed, 0 failed, 0 skipped, 0 retries |
npm run test:live:fake:all (ENSEMBLE_LIVE_REQUIRE=1) | 2.2.7 | PASS — fake 410 s and fake-empty 10 s, 2 passed, 0 failed, 0 skipped, 0 retries |
npm run verify | — | PASS — 2121 tests, typecheck clean |
npm run docs:check | — | PASS — contract v7; OpenCode 2.2.6, 2.2.7, 2.3.0; Node >=22.23.4; live Node 26.12.1 |
Required CI at a7f1eb3 | 2.2.6, 2.2.7, 2.3.0 | PASS — Verify, Compatibility, Docs, and Node Matrix green on the first attempt; no job rerun |
The fake runs use the committed fake provider only; no real model catalog and no network model calls are involved.
Limitations
- The CI failure was not reproducible locally: the same 2.3.0 fake suite already passed before this change, including the full walkthrough. The required CI at
a7f1eb3confirms the fix on all three host versions on the first attempt, with no job rerun. - The uploaded CI pane shows the statusline and command line present at the failure and the expected
:settingsvalue in the buffer. That is consistent with the retype identity race above, not a lost input surface; the readiness gate is the ticket's requested hardening and remains exercised by the guard test. - Linux/tmux only. No macOS, screenshot, or pointer-input evidence.