1# Demo and sandbox scripts
2
3- `run.sh`, `demo.tape`, `smoke.tape`, `compose.demo.yaml`: VHS demo recording
4  (`make demo`). One remote container, `remote-a`.
5- `sandbox-run.sh`: automated acceptance. Client and two remotes all run in
6  containers on an internal network.
7- `test-remotes.sh`: two containerised remotes for manual testing from your own
8  terminal.
9
10All of them build `build/vev` and bake it into the `scripts/demo/Dockerfile`
11image, so local and remote vev are the same binary. Docker must be rootless.
12
13## Manual remote testing
14
15```sh
16scripts/demo/test-remotes.sh up       # build, start remote-a/remote-b, register both hosts
17scripts/demo/test-remotes.sh shell    # print the client command
18scripts/demo/test-remotes.sh status   # containers, ports, vev host list, vev ls --all
19scripts/demo/test-remotes.sh broker-restart  # stop only the test broker; the next vev call respawns it
20scripts/demo/test-remotes.sh down     # stop the test broker/daemon, remove containers and keys
21```
22
23Run the printed command from a real terminal, or `scripts/demo/test-remotes.sh
24shell --exec [vev args]`. It sets:
25
26- `VEV_ENV=test` and `VEV_ENV_ROOT=<checkout>/.dev`: all vev state lives in
27  `.dev/test/`, apart from your installed vev.
28- `PATH=.dev/test/bin:$PATH`: vev runs `ssh` from `PATH` and has no ssh config
29  option, so `.dev/test/bin/ssh` wraps the real client with
30  `-F .dev/test/ssh/config`. The key, `known_hosts` and config are generated in
31  `.dev/test/ssh/`. `~/.ssh` and your agent are never used.
32- `vev host add --transport ssh`: hosts are registered with the SSH-only carriage.
33  QUIC cannot work here. The remote proxy listens on a random UDP port, and
34  the client dials that port on the SSH target name (`remote-a`), which does
35  not resolve to the loopback port mapping.
36- `-u VEV`: a client started from a pane of your real vev is not treated as
37  nested.
38
39sshd is published on `127.0.0.1:2222` (remote-a) and `127.0.0.1:2223`
40(remote-b). Override the ports with `VEV_TEST_SSH_PORT_A` and
41`VEV_TEST_SSH_PORT_B`, and the environment name with `VEV_TEST_ENV`. Plain
42shell access: `.dev/test/bin/ssh remote-a`.
43
44`up` is idempotent: it recreates the containers, reinstalls the key and
45skips hosts that are already registered. A `VEV_ENV=test` broker started by an
46older build keeps running until it is stopped, and `up` warns when it finds
47one. Run `down` then `up` after a rebuild. `down` stops **every**
48`VEV_ENV=test` daemon of this checkout, including sessions you opened
49there by hand.
50
51Remote sessions live in the containers and disappear on `down`.
52
53### Checklist
54
55Open a few sessions first, with at least two tabs in one of them, local and on
56each remote: `vev new work`, `vev new ra remote-a`, `vev new rb remote-b`
57(each run with the environment above).
58
59- [ ] Picker over a session (`Alt+Space`, `SSP`): opens over the live
60      session; `Esc` returns to the same session, tab and pane.
61- [ ] Move pane (`MFP`) and move tab (`MAT`): the destination picker lists
62      local and remote sessions and tabs; the move lands where you chose.
63- [ ] `x` in the picker kills the selected session (local and remote); the
64      row disappears and `vev ls --all` agrees.
65- [ ] Tab rows: expand a session and see one row per tab, with the right names
66      and active marker. Selecting a tab row lands on that tab.
67- [ ] MRU order: switch A → B → C, reopen the picker, and check the order is
68      C, B, A.
69- [ ] Bell icons: in a background tab or session run `sleep 2; printf '\a'`,
70      switch away, and check that the bell icon shows on that session and tab
71      row. It clears once you visit it. Try it on a remote session too.
72- [ ] Live preview: moving the cursor over a local session, then over a remote
73      one, shows its current screen. Run `ticker` there to check that the
74      preview updates live.
75- [ ] Remote attach and switch: `vev attach demo@remote-a:<session>` from
76      the shell (this also adds the learned target `demo@remote-a`), then
77      switch between local, remote-a and remote-b sessions from the picker
78      without dropping input or output.
79- [ ] Broker restart: `scripts/demo/test-remotes.sh broker-restart` stops only
80      the test broker. Reopen the picker from a running client and check that
81      hosts and sessions come back.