@@ -0,0 +1,68 @@
1+# Handoff
2+
3+State as of 2026-11-09, after v1 and five commits on top of it. The app is stable and in daily
4+use. Read DESIGN.md for how conveyor works; this file covers where things stand and what's next.
5+
6+## The loop
7+
8+```
9+Ctrl+click ─▶ ticket ─▶ VM boot ─▶ push ─▶ agent ─▶ done ─▶ merge check ─▶ trial ─▶ Keep / Discard
10+ ready 12 s 0.5 s 30–250 s │ "Not done yet": app reloads
11+ (waits if │ agent merges the in place
12+ no image) ▼ trial, done again
13+ first build ~12 s
14+```
15+
16+## Run it
17+
18+| What | Command |
19+|---|---|
20+| Daemon | `cargo build --release -p conveyor && ./target/release/conveyor daemon` |
21+| App | `cargo app && ./target/app/release/conveyor-app` (`--safe` opens safe mode) |
22+| Tests | `cargo test --release -p conveyor trial` |
23+| Base image | delete `~/.local/share/conveyor/images/base.qcow2`, then `tools/bake.py bake` (about 10 min) |
24+
25+Rebake when the template's dependencies change (`templates/library/preview/Cargo.toml`, `Cargo.lock`)
26+or the bake's package list does: the image's warm cargo cache must match, or every ticket rebuilds
27+rune (38 s, against 12 s).
28+
29+## Next
30+
31+1. **Boot from a RAM snapshot.** Boot is 12 s of every ticket. Spike 1 measured 1.0–1.2 s to restore
32+ a snapshot with RAM. `spikes/1-vm/vm.py` has the QMP `snapshot-save`/`snapshot-load` code.
33+2. **Make `--at 1` jump ahead.** The preview renders a full second at 60 fps on the CPU (2.6 s), and
34+ an agent renders 8–25 times a ticket.
35+3. **Raise-on-click needs Rune.** Canvas cards can't come to the front on click until Rune supports it.
36+4. **The taskbar's armed ×.** In the user's library, the red "press again to forget" state doesn't show
37+ while the pointer stays on the ×, probably because the hover fill covers it. A second press still
38+ forgets. A Ctrl+click on it can fix it.
39+5. **The snapshot re-reads every ticket's events twice a second.** Fine at 20 tickets. Revisit if the
40+ app's poll gets slow with hundreds.
41+
42+## Loose ends
43+
44+- **Ticket #20** (widgets) is a QA build, discarded, left as a draft. Conveyor has no delete op.
45+- **Library branches `t-12` and `t-20`** belong to builds that will never be kept; delete them with
46+ `git -C ~/.local/share/conveyor/library branch -D t-12 t-20`.
47+- **Repo branches** `spike/builder-api`, `spike/builder-ceiling` and `spike/hot-reload` are merged
48+ history and can go.
49+- **Backups to delete when you're confident:**
50+
51+ | Path | What |
52+ |---|---|
53+ | `~/.local/share/conveyor/images/base.qcow2.old` | The previous image (20:07), 13 GB |
54+ | `~/.local/share/conveyor-before-slim-20261109` | The library before `target/` was removed, 4.1 GB |
55+ | `~/.local/share/conveyor-before-v1-20261109-1642` | State before the v1 wipe |
56+ | `~/.local/share/conveyor-kit-test-20261109-1640` | Starter kit test install |
57+ | `~/.local/share/conveyor-before-clean-20261109-1358` | State before an earlier clean |
58+ | `~/.local/share/conveyor-spike` | The spikes' VM state |
59+
60+## Since v1
61+
62+| Commit | What |
63+|---|---|
64+| `4ea51c5` | Helper modules, rune_kit and a shared image cache for widgets; Keep deletes the build's branch |
65+| `a08bae5` | The library ignores `target/` (the push went from 32 s to 0.5 s), and the bake warms `~/work` |
66+| `1e898fa` | A build that conflicts with one kept meanwhile merges it before `done` |
67+| `3c10db6` | Tickets wait as ready while the base image is missing or baking |
68+| `10cc698` | Ponytail pass: serde over hand-rolled formats, dead code removed |