sam/paperclip-harness
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Read the two docs the handover named; drop the duplicated test procedure and list both in DOCMAP

Browse Source
This commit is contained in:
Sam
2026-11-10 11:37:41 +11:00
parent 8592bbdab7
commit 8cfe38ee84
2 changed files with 6 additions and 18 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
README.md
View File

@@ -47,24 +47,10 @@ TUIOS it has to close a box.
## How an interface change is tested
This machine runs TUIOS, and the program is used inside a TUIOS pane. A test in a plain
terminal, or in tmux, only proves that a program draws and survives a resize message. It
does not prove the program works where it will actually run, because TUIOS owns part of
the keyboard and sends its own resize messages.
So an interface change is checked by putting it in a real TUIOS pane and reading the pane
back:
```bash
tuios new-window -s "$TUIOS_SESSION" harness-check --no-focus --keep-open -- /tmp/harness-bin -project spike-2026-11-10
tuios capture-pane -s "$TUIOS_SESSION" -w harness-check
tuios send-keys -s "$TUIOS_SESSION" -w harness-check Down --repeat 2
tuios screenshot -w harness-check -o /tmp/harness-tuios.png
tuios close-window harness-check
```
`--no-focus` keeps the person's focus where it was, and the pane is closed afterwards, so
the layout is left as it was found.
Not in a plain terminal, and not in tmux. TUIOS owns part of the keyboard and forwards
clicks relative to the pane, so the check is a real TUIOS pane read back with
`capture-pane`. The commands are in `docs/TUIOS-RUNBOOK.md`, which is the one place they
live.
## Rules for this project