stack/agents/darkwing/work/queue-69/build.md

Row 69, terminal app follow-up after row 55, build (Darkwing)

Issue #1562. Brief: docs/plans/2026-10-11_terminal-app-follow-up.md. Reviewers: Dewey and Filbert. The notes come from row 55 round 3: Dewey's comment 27308 and Filbert's comment 27309.

Base dad20531. No commit from dad20531 to 15ed3513 touches the four paths. Row 92's 57948a81 changed packages/cli/README.md after the old base the row was opened on, so I started from a fresh worktree.

build.patch is git diff --binary dad20531 of the four paths. Apply it with git apply --index to a detached worktree of dad20531, and sha256sum -c candidate-manifest.sha256 then gives 4/4 OK (checked on a fresh worktree).

What changed

• packages/cli/src/screens.mjs, the hidden box only. It gains a third line, "Resize, or use mosaic decide.", shown while asking and while resolving.
• packages/cli/src/app.mjs, render() only. While the overlay is a decide box and decideShown() is false, the frame's status line says "Too small to confirm here." in the warning style. state.status is left alone, so when the terminal grows and the box shows again, the Inbox's "Press 1-n to choose. You will see the decision again and confirm with y." comes back with it. Nothing else about y changed.
• packages/cli/tests/app.test.mjs: three tests and one code point.
• packages/cli/README.md: the hidden box's text, the status line, the too-small screen under 40 columns at any height, and the row counts as an example for a plain decision.

Two choices

The way out is short because of the smallest frame. At 40x10 the body has 5 rows and the box is 38 cells wide, 34 inside. The brief's sentence, "Make the terminal bigger, or use mosaic decide .", wraps to two rows there, so the box is 6 rows and draw()'s general cut keeps the top, a cut line and the last two rows. That drops "Any key answers No." and adds a cut line pointing at mosaic inbox --json. "Resize, or use mosaic decide." is 29 cells, so the hidden box is 5 rows at every size and is never cut. The second test pins that at 40x10. The tradeoff: the box no longer spells out <decision> <option>; mosaic decide prints its usage.

The status text is 26 cells for the same reason. "Too small to confirm this decision here." filled a 40-column status line and lost its last character to the ellipsis.

The tests

Test	What it pins	From
under 40 columns a tall terminal shows the too-small screen even where the decide box would fit; y sends nothing	at 39x29, 35x31, 30x35, 39x33, 39x40, 39x60, 36x60 and 30x80, 1 then y shows the too-small screen with "A decision question is open; any key answers No." and sends no decision.resolve. Then every size from 30 to 39 columns and 33 to 60 rows, short and long question: decideShown() is false and draw() gives the too-small screen	Filbert N10, Dewey r3-shown-no-min; Dewey's and Filbert's probe sizes
a hidden decide box names the way out, and the status line under it does not promise y	at 80x24 the status says "confirm with y." before and after 1; shrunk to 80x18 the box shows its three lines, the status says "Too small to confirm here." and nothing on screen says "with y"; grown back, both return; at 40x10 the hidden box is whole, with no cut line; y then sends nothing	Filbert N12, Dewey's note
width counts terminal cells (existing)	U+18D08 measures 2	Filbert N11
help or a detail box cut to fit keeps its last line, Esc included	at 80x10 the cut help keeps the row the full help ends on (the wrapped end of "Esc closes this help."), and a cut decision detail keeps │ Esc back │	Dewey cut-drops-choice

Mutants

mutants.sh runs the brief's four and two on this row's own lines, with a copy of agents/darkwing/work/queue-59-review/r1/mut.mjs (sha256 a1ed6bca…) against packages/cli/tests/app.test.mjs, 22:49:16Z to 22:51:14Z, after a check that exits on another seat's gate or mutant run. 6 of 6 killed (mutants.txt). Every file was restored and still matches the manifest.

Mutant	Edit	Killed by
shown-no-min-cols	decideShown without cols >= MIN_COLS	under 40 columns a tall terminal…
r3-shown-no-min	decideShown without the 40x10 check	under 40 columns a tall terminal…
n9-17000-end-off	0x18d08 to 0x18cff	width counts terminal cells…
cut-drops-choice	the general cut keeps one tail row, not two	help or a detail box cut to fit…
hidden-no-way-out	the hidden box without its third line	a hidden decide box names the way out…
hidden-status-promises-y	render() never swaps the status	a hidden decide box names the way out…

Each dies in its own test and in no other.

Found, not fixed

When help is cut, its cut line says "the whole text is in mosaic inbox --json". Help has no whole, so draw() falls back to the decide box's pointer, which is wrong for help (? shows the whole help on a taller terminal). The help test's screen at 80x10 shows it. That line sits in draw(), outside this row's lines of screens.mjs, so I left it for a follow-up.

Gate

gate.sh, run sequentially in ~/darkwing-scratch/r69/wt (dad20531 plus this patch, node_modules symlinked), 22:56:22Z to 22:59:22Z, after the busy check found no other seat's run for two minutes (gate-summary.txt). All 13 suites exited 0, 0 skipped:

• node: cli 123 (row 55's 120 plus the three new tests), queue 150;
• scripts: auth 15, conductor 17, config 24, discord 66, extension-package 18, foundation 44, queue 27, release 14, task 26 (DOCKER_HOST at a dead socket).

test-release left an empty wt_default network, created at 22:59:08Z inside my test-release window, and I removed it.