Skip to content

The ultimate harness for coding agents and beyond. All your agents. All your machines. One command center. Start with code, then follow your curiosity and build across disciplines: CAD, circuits, robots, games and music.

Move the firmware to device/harness-device/firmware, and drop its design/ folder

0xdiego25d5a5178d43a8
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 97bcba432..86f458845 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -148,7 +148,7 @@ read what you submit and run the example yourself.
| Add an API provider | [Provider guide](provider/README.md) |
| Improve terminal behavior, shortcuts, or accessibility | [Development guide](docs/development.md), [keyboard guide](docs/keyboard.md) |
| Help with Linux or Windows compatibility | [Development guide](docs/development.md#platform-support) |
-| Support another hardware board | [Firmware guide](device/harness/README.md) |
+| Support another hardware board | [Firmware guide](device/harness-device/firmware/README.md) |
| Fix documentation or report a bug | A small PR, or an issue with steps to reproduce |
For a new engine, multiplexer, or a change to a shared protocol, open an issue first so we can agree
diff --git a/Makefile b/Makefile
index 3660fda02..cac9e173a 100644
--- a/Makefile
+++ b/Makefile
@@ -69,16 +69,16 @@ remote-machine:
## NOT a tag-triggered release like the three above, and deliberately so: this builds with a local
## ESP-IDF toolchain and writes straight to the GCS bucket every running dial polls, so it needs an
## authenticated `gcloud storage` and a sourced IDF env on the machine that runs it. There is no CI runner with
-## a board attached to check the result. See device/harness/RELEASE.md.
+## a board attached to check the result. See device/harness-device/firmware/RELEASE.md.
##
## ARGS="--dry-run" to preview, ARGS="X.Y.Z" for an explicit version, ARGS="--no-bump" to rebuild and
## upload what version.txt already says.
upload-circle:
- bash device/harness/scripts/upload-firmware.sh $(ARGS)
+ bash device/harness-device/firmware/scripts/upload-firmware.sh $(ARGS)
## device-test: the firmware's host-side unit tests — frame codec, machine list, carousel ring.
##
## Plain `cc` on the host, no board and no ESP-IDF: the parts worth testing here are arithmetic and
## parsing, and a test that needed hardware attached is a test nobody runs.
device-test:
- bash device/harness/test/run.sh
+ bash device/harness-device/firmware/test/run.sh
diff --git a/README.md b/README.md
index 8c6d95a39..4c81957ef 100644
--- a/README.md
+++ b/README.md
@@ -166,12 +166,12 @@ The [architecture docs](docs/architecture.md) describe transport, identity, and
## Device firmware
-[`device/harness/`](device/harness/) contains ESP32-S3 firmware for a round USB companion display.
+[`device/harness-device/firmware/`](device/harness-device/firmware/) contains ESP32-S3 firmware for a round USB companion display.
It shows agent status and supports responses and voice input through the host daemon.
The device connects over USB; it doesn't need Wi-Fi credentials.
Build and flash it onto a supported board, or add a board port. Schematics and enclosure designs
-are not in the repository yet. The [hardware guide](device/harness/README.md) lists the current
+are not in the repository yet. The [hardware guide](device/harness-device/firmware/README.md) lists the current
boards and build commands.
https://github.com/user-attachments/assets/97848065-61c6-40df-be66-a8247f69aa4c
diff --git a/cli/scripts/sync-cable-vectors.sh b/cli/scripts/sync-cable-vectors.sh
index cd2bab068..e549e1cf9 100755
--- a/cli/scripts/sync-cable-vectors.sh
+++ b/cli/scripts/sync-cable-vectors.sh
@@ -4,7 +4,7 @@
# scripts/sync-cable-vectors.sh # copy in, report whether anything changed
# scripts/sync-cable-vectors.sh --check # fail if the copy is stale (for CI, when the source is there)
#
-# The vectors are generated by device/harness/scripts/gen_cable_vectors.py — a third implementation
+# The vectors are generated by device/harness-device/firmware/scripts/gen_cable_vectors.py — a third implementation
# written from the format description, so neither the firmware's decoder nor this repository's blesses its
# own misreading. That only holds while the copy here is current: a stale copy lets both suites pass while
# the real cable disagrees.
@@ -15,7 +15,7 @@ set -euo pipefail
here="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
dest="$here/../src/cable/vectors/cable_frame.txt"
-src="$here/../../device/harness/test/vectors/cable_frame.txt"
+src="$here/../../device/harness-device/firmware/test/vectors/cable_frame.txt"
if [ ! -f "$src" ]; then
echo "source vectors not found: $src"
diff --git a/cli/src/cable/cableFrame.spec.ts b/cli/src/cable/cableFrame.spec.ts
index abc85d21a..ef356745f 100644
--- a/cli/src/cable/cableFrame.spec.ts
+++ b/cli/src/cable/cableFrame.spec.ts
@@ -1,7 +1,7 @@
// The TypeScript half of the framing agreement — see cableFrame.ts.
//
// The vectors in vectors/cable_frame.txt are a COPY. They are generated by
-// device/harness/scripts/gen_cable_vectors.py, an implementation that is neither this one nor the
+// device/harness-device/firmware/scripts/gen_cable_vectors.py, an implementation that is neither this one nor the
// firmware's, and the firmware's own host test asserts against the same file. Refresh the
// copy with scripts/sync-cable-vectors.sh; a stale copy makes this suite pass while the real link
// disagrees, which is the failure this whole arrangement exists to prevent.
diff --git a/cli/src/cable/cableFrame.ts b/cli/src/cable/cableFrame.ts
index 13dc7c6ec..f766484da 100644
--- a/cli/src/cable/cableFrame.ts
+++ b/cli/src/cable/cableFrame.ts
@@ -1,7 +1,7 @@
// Framing for the USB link to the dial — turns a byte stream into messages, and messages back into bytes.
//
-// The mirror image of device/harness/main/cable_frame.c. Both halves are checked against ONE shared
-// vector file (vectors/cable_frame.txt here, generated by device/harness/scripts/gen_cable_vectors.py from
+// The mirror image of device/harness-device/firmware/main/cable_frame.c. Both halves are checked against ONE shared
+// vector file (vectors/cable_frame.txt here, generated by device/harness-device/firmware/scripts/gen_cable_vectors.py from
// the format description rather than from either implementation), so a shared misreading shows up as a
// disagreement instead of being blessed by both. The two halves are written in two languages and share no
// code; the vectors are the only thing they share.
diff --git a/cli/src/cable/cableSession.ts b/cli/src/cable/cableSession.ts
index b9e6a6b74..a6c5b4aee 100644
--- a/cli/src/cable/cableSession.ts
+++ b/cli/src/cable/cableSession.ts
@@ -1,6 +1,6 @@
// The message layer: what the daemon and the dial SAY to each other, on top of the bytes serial.ts moves.
//
-// Written twice — here and in device/harness/main/cable_client.c — with no shared code, because one half
+// Written twice — here and in device/harness-device/firmware/main/cable_client.c — with no shared code, because one half
// is TypeScript on a laptop and the other is C on an MCU. The framing underneath agrees by shared vectors;
// this layer agrees by docs/cable-protocol.md and by being small enough to read in one sitting.
//
diff --git a/cli/src/cable/vectors/cable_frame.txt b/cli/src/cable/vectors/cable_frame.txt
index 71da64ac0..3f71defe6 100644
--- a/cli/src/cable/vectors/cable_frame.txt
+++ b/cli/src/cable/vectors/cable_frame.txt
@@ -1,5 +1,5 @@
# Shared framing vectors for the harness USB cable link.
-# Generated by device/harness/scripts/gen_cable_vectors.py — a third implementation, written
+# Generated by device/harness-device/firmware/scripts/gen_cable_vectors.py — a third implementation, written
# from main/cable_frame.h's format description and from neither half's code. Do not hand-edit.
#
# encode <name> <type> <payload-hex> <frame-hex>
diff --git a/device/harness/.gitignore b/device/harness-device/firmware/.gitignore
similarity index 100%
rename from device/harness/.gitignore
rename to device/harness-device/firmware/.gitignore
diff --git a/device/harness/CMakeLists.txt b/device/harness-device/firmware/CMakeLists.txt
similarity index 100%
rename from device/harness/CMakeLists.txt
rename to device/harness-device/firmware/CMakeLists.txt
diff --git a/device/harness/README.md b/device/harness-device/firmware/README.md
similarity index 98%
rename from device/harness/README.md
rename to device/harness-device/firmware/README.md
index 31cebab54..42d56a273 100644
--- a/device/harness/README.md
+++ b/device/harness-device/firmware/README.md
@@ -30,7 +30,7 @@ for the shared pin definitions. Other ESP32 boards need a port; matching the MCU
Install and activate ESP-IDF 5.5 or newer. From the repository root:
```bash
-cd device/harness
+cd device/harness-device/firmware
idf.py set-target esp32s3
idf.py build
idf.py -p PORT flash monitor
diff --git a/device/harness/RELEASE.md b/device/harness-device/firmware/RELEASE.md
similarity index 95%
rename from device/harness/RELEASE.md
rename to device/harness-device/firmware/RELEASE.md
index 9667e706d..7984a9952 100644
--- a/device/harness/RELEASE.md
+++ b/device/harness-device/firmware/RELEASE.md
@@ -53,8 +53,8 @@ make upload-circle ARGS="--no-bump" # keep version.txt as-is, build + upload
make upload-circle ARGS="--no-commit" # don't git-commit the version.txt bump
```
-`make upload-circle` just runs `device/harness/scripts/upload-firmware.sh` (a full pipeline: bump
-`version.txt` → `idf.py -C device/harness build` → upload `.bin` + merge `metadata.json` to GCS → **git
+`make upload-circle` just runs `device/harness-device/firmware/scripts/upload-firmware.sh` (a full pipeline: bump
+`version.txt` → `idf.py -C device/harness-device/firmware build` → upload `.bin` + merge `metadata.json` to GCS → **git
commit + push** the `version.txt` bump). You can call the script directly too. It auto-sources the ESP-IDF env
from `IDF_PATH` or `~/esp/esp-idf`; if a step fails before publishing, it reverts the `version.txt`
bump so a failed run leaves no dangling version.
@@ -66,9 +66,9 @@ devices can download without credentials.
Notes:
- The version baked **into the binary** (`esp_app_desc.version`) and the version in the **manifest**
- both come from the same `device/harness/version.txt`, so the device's equality check is exact. Keep them
+ both come from the same `device/harness-device/firmware/version.txt`, so the device's equality check is exact. Keep them
in sync by only ever changing the version there.
-- If a rebuild doesn't seem to pick up the new version, `touch device/harness/version.txt` before step 3
+- If a rebuild doesn't seem to pick up the new version, `touch device/harness-device/firmware/version.txt` before step 3
to force the app-descriptor to regenerate.
- GCS layout (all overridable via env in `scripts/upload-firmware.sh`): bucket
`s3-autonomous-upgrade-3`, binary `harness/esp32/bin/<version>.bin`, manifest
diff --git a/device/harness/device-stages.html b/device/harness-device/firmware/device-stages.html
similarity index 100%
rename from device/harness/device-stages.html
rename to device/harness-device/firmware/device-stages.html
diff --git a/device/harness/docs/INTERNAL_RAM_OPTIMIZATION.md b/device/harness-device/firmware/docs/INTERNAL_RAM_OPTIMIZATION.md
similarity index 99%
rename from device/harness/docs/INTERNAL_RAM_OPTIMIZATION.md
rename to device/harness-device/firmware/docs/INTERNAL_RAM_OPTIMIZATION.md
index fec0a6034..e4cf11bd9 100644
--- a/device/harness/docs/INTERNAL_RAM_OPTIMIZATION.md
+++ b/device/harness-device/firmware/docs/INTERNAL_RAM_OPTIMIZATION.md
@@ -81,7 +81,7 @@ implied by the RAM-focused tests.
Build command:
```bash
-cd device/harness
+cd device/harness-device/firmware
source ~/esp/esp-idf/export.sh
idf.py -B build-arm build
idf.py -B build-arm size
diff --git a/device/harness/docs/UI_FLOWS.md b/device/harness-device/firmware/docs/UI_FLOWS.md
similarity index 100%
rename from device/harness/docs/UI_FLOWS.md
rename to device/harness-device/firmware/docs/UI_FLOWS.md
diff --git a/device/harness/docs/UI_REDESIGN.md b/device/harness-device/firmware/docs/UI_REDESIGN.md
similarity index 100%
rename from device/harness/docs/UI_REDESIGN.md
rename to device/harness-device/firmware/docs/UI_REDESIGN.md
diff --git a/device/harness/fonts/Geist-Medium.ttf b/device/harness-device/firmware/fonts/Geist-Medium.ttf
similarity index 100%
rename from device/harness/fonts/Geist-Medium.ttf
rename to device/harness-device/firmware/fonts/Geist-Medium.ttf
diff --git a/device/harness/fonts/Geist-Regular.ttf b/device/harness-device/firmware/fonts/Geist-Regular.ttf
similarity index 100%
rename from device/harness/fonts/Geist-Regular.ttf
rename to device/harness-device/firmware/fonts/Geist-Regular.ttf
diff --git a/device/harness/fonts/Geist-SemiBold.ttf b/device/harness-device/firmware/fonts/Geist-SemiBold.ttf
similarity index 100%
rename from device/harness/fonts/Geist-SemiBold.ttf
rename to device/harness-device/firmware/fonts/Geist-SemiBold.ttf
diff --git a/device/harness/fonts/OFL.txt b/device/harness-device/firmware/fonts/OFL.txt
similarity index 100%
rename from device/harness/fonts/OFL.txt
rename to device/harness-device/firmware/fonts/OFL.txt
diff --git a/device/harness/main/CMakeLists.txt b/device/harness-device/firmware/main/CMakeLists.txt
similarity index 100%
rename from device/harness/main/CMakeLists.txt
rename to device/harness-device/firmware/main/CMakeLists.txt
diff --git a/device/harness/main/app_main.c b/device/harness-device/firmware/main/app_main.c
similarity index 100%
rename from device/harness/main/app_main.c
rename to device/harness-device/firmware/main/app_main.c
diff --git a/device/harness/main/audio_capture.c b/device/harness-device/firmware/main/audio_capture.c
similarity index 100%
rename from device/harness/main/audio_capture.c
rename to device/harness-device/firmware/main/audio_capture.c
diff --git a/device/harness/main/audio_capture.h b/device/harness-device/firmware/main/audio_capture.h
similarity index 100%
rename from device/harness/main/audio_capture.h
rename to device/harness-device/firmware/main/audio_capture.h
diff --git a/device/harness/main/audio_client.c b/device/harness-device/firmware/main/audio_client.c
similarity index 100%
rename from device/harness/main/audio_client.c
rename to device/harness-device/firmware/main/audio_client.c
diff --git a/device/harness/main/audio_client.h b/device/harness-device/firmware/main/audio_client.h
similarity index 100%
rename from device/harness/main/audio_client.h
rename to device/harness-device/firmware/main/audio_client.h
diff --git a/device/harness/main/board/board.c b/device/harness-device/firmware/main/board/board.c
similarity index 100%
rename from device/harness/main/board/board.c
rename to device/harness-device/firmware/main/board/board.c
diff --git a/device/harness/main/board/board.h b/device/harness-device/firmware/main/board/board.h
similarity index 100%
rename from device/harness/main/board/board.h
rename to device/harness-device/firmware/main/board/board.h
diff --git a/device/harness/main/board/board_i2c.c b/device/harness-device/firmware/main/board/board_i2c.c
similarity index 100%
rename from device/harness/main/board/board_i2c.c
rename to device/harness-device/firmware/main/board/board_i2c.c
diff --git a/device/harness/main/board/board_i2c.h b/device/harness-device/firmware/main/board/board_i2c.h
similarity index 100%
rename from device/harness/main/board/board_i2c.h
rename to device/harness-device/firmware/main/board/board_i2c.h
diff --git a/device/harness/main/board/board_pins.h b/device/harness-device/firmware/main/board/board_pins.h
similarity index 100%
rename from device/harness/main/board/board_pins.h
rename to device/harness-device/firmware/main/board/board_pins.h
diff --git a/device/harness/main/board/board_probe.c b/device/harness-device/firmware/main/board/board_probe.c
similarity index 100%
rename from device/harness/main/board/board_probe.c
rename to device/harness-device/firmware/main/board/board_probe.c
diff --git a/device/harness/main/board/board_probe.h b/device/harness-device/firmware/main/board/board_probe.h
similarity index 100%
rename from device/harness/main/board/board_probe.h
rename to device/harness-device/firmware/main/board/board_probe.h
diff --git a/device/harness/main/board/board_table.c b/device/harness-device/firmware/main/board/board_table.c
similarity index 100%
rename from device/harness/main/board/board_table.c
rename to device/harness-device/firmware/main/board/board_table.c
diff --git a/device/harness/main/board/power.c b/device/harness-device/firmware/main/board/power.c
similarity index 100%
rename from device/harness/main/board/power.c
rename to device/harness-device/firmware/main/board/power.c
diff --git a/device/harness/main/board/power.h b/device/harness-device/firmware/main/board/power.h
similarity index 100%
rename from device/harness/main/board/power.h
rename to device/harness-device/firmware/main/board/power.h
diff --git a/device/harness/main/cable_client.c b/device/harness-device/firmware/main/cable_client.c
similarity index 100%
rename from device/harness/main/cable_client.c
rename to device/harness-device/firmware/main/cable_client.c
diff --git a/device/harness/main/cable_client.h b/device/harness-device/firmware/main/cable_client.h
similarity index 100%
rename from device/harness/main/cable_client.h
rename to device/harness-device/firmware/main/cable_client.h
diff --git a/device/harness/main/cable_frame.c b/device/harness-device/firmware/main/cable_frame.c
similarity index 100%
rename from device/harness/main/cable_frame.c
rename to device/harness-device/firmware/main/cable_frame.c
diff --git a/device/harness/main/cable_frame.h b/device/harness-device/firmware/main/cable_frame.h
similarity index 100%
rename from device/harness/main/cable_frame.h
rename to device/harness-device/firmware/main/cable_frame.h
diff --git a/device/harness/main/cable_link.c b/device/harness-device/firmware/main/cable_link.c
similarity index 100%
rename from device/harness/main/cable_link.c
rename to device/harness-device/firmware/main/cable_link.c
diff --git a/device/harness/main/cable_link.h b/device/harness-device/firmware/main/cable_link.h
similarity index 100%
rename from device/harness/main/cable_link.h
rename to device/harness-device/firmware/main/cable_link.h
diff --git a/device/harness/main/cable_machines.c b/device/harness-device/firmware/main/cable_machines.c
similarity index 100%
rename from device/harness/main/cable_machines.c
rename to device/harness-device/firmware/main/cable_machines.c
diff --git a/device/harness/main/cable_machines.h b/device/harness-device/firmware/main/cable_machines.h
similarity index 100%
rename from device/harness/main/cable_machines.h
rename to device/harness-device/firmware/main/cable_machines.h
diff --git a/device/harness/main/config_store.c b/device/harness-device/firmware/main/config_store.c
similarity index 100%
rename from device/harness/main/config_store.c
rename to device/harness-device/firmware/main/config_store.c
diff --git a/device/harness/main/config_store.h b/device/harness-device/firmware/main/config_store.h
similarity index 100%
rename from device/harness/main/config_store.h
rename to device/harness-device/firmware/main/config_store.h
diff --git a/device/harness/main/device_mac.c b/device/harness-device/firmware/main/device_mac.c
similarity index 100%
rename from device/harness/main/device_mac.c
rename to device/harness-device/firmware/main/device_mac.c
diff --git a/device/harness/main/device_mac.h b/device/harness-device/firmware/main/device_mac.h
similarity index 100%
rename from device/harness/main/device_mac.h
rename to device/harness-device/firmware/main/device_mac.h
diff --git a/device/harness/main/fw_update.c b/device/harness-device/firmware/main/fw_update.c
similarity index 100%
rename from device/harness/main/fw_update.c
rename to device/harness-device/firmware/main/fw_update.c
diff --git a/device/harness/main/fw_update.h b/device/harness-device/firmware/main/fw_update.h
similarity index 100%
rename from device/harness/main/fw_update.h
rename to device/harness-device/firmware/main/fw_update.h
diff --git a/device/harness/main/idf_component.yml b/device/harness-device/firmware/main/idf_component.yml
similarity index 91%
rename from device/harness/main/idf_component.yml
rename to device/harness-device/firmware/main/idf_component.yml
index a410f3724..2433917ea 100644
--- a/device/harness/main/idf_component.yml
+++ b/device/harness-device/firmware/main/idf_component.yml
@@ -18,6 +18,6 @@ dependencies:
# tcp_transport does not provide (no HTTP-redirect support).
espressif/esp_websocket_client: "~1.2.0"
# libsodium — the E2EE crypto stack (Ed25519, X25519, ristretto255 CPace, ChaCha20-Poly1305,
- # SHA-2, HKDF/HMAC). Backs device/harness/main/e2ee/e2ee_core.c (byte-identical twin of the web/adapter
+ # SHA-2, HKDF/HMAC). Backs device/harness-device/firmware/main/e2ee/e2ee_core.c (byte-identical twin of the web/adapter
# TS core). The Espressif port wires randombytes to the hardware RNG. See e2ee_core.h.
espressif/libsodium: "^1.0.20"
diff --git a/device/harness/main/last_words.c b/device/harness-device/firmware/main/last_words.c
similarity index 100%
rename from device/harness/main/last_words.c
rename to device/harness-device/firmware/main/last_words.c
diff --git a/device/harness/main/last_words.h b/device/harness-device/firmware/main/last_words.h
similarity index 100%
rename from device/harness/main/last_words.h
rename to device/harness-device/firmware/main/last_words.h
diff --git a/device/harness/main/provisioned_config.h.example b/device/harness-device/firmware/main/provisioned_config.h.example
similarity index 100%
rename from device/harness/main/provisioned_config.h.example
rename to device/harness-device/firmware/main/provisioned_config.h.example
diff --git a/device/harness/main/ptt.c b/device/harness-device/firmware/main/ptt.c
similarity index 100%
rename from device/harness/main/ptt.c
rename to device/harness-device/firmware/main/ptt.c
diff --git a/device/harness/main/ptt.h b/device/harness-device/firmware/main/ptt.h
similarity index 100%
rename from device/harness/main/ptt.h
rename to device/harness-device/firmware/main/ptt.h
diff --git a/device/harness/main/ram_telemetry.c b/device/harness-device/firmware/main/ram_telemetry.c
similarity index 100%
rename from device/harness/main/ram_telemetry.c
rename to device/harness-device/firmware/main/ram_telemetry.c
diff --git a/device/harness/main/ram_telemetry.h b/device/harness-device/firmware/main/ram_telemetry.h
similarity index 100%
rename from device/harness/main/ram_telemetry.h
rename to device/harness-device/firmware/main/ram_telemetry.h
diff --git a/device/harness/main/ui/carousel_ring.c b/device/harness-device/firmware/main/ui/carousel_ring.c
similarity index 100%
rename from device/harness/main/ui/carousel_ring.c
rename to device/harness-device/firmware/main/ui/carousel_ring.c
diff --git a/device/harness/main/ui/carousel_ring.h b/device/harness-device/firmware/main/ui/carousel_ring.h
similarity index 100%
rename from device/harness/main/ui/carousel_ring.h
rename to device/harness-device/firmware/main/ui/carousel_ring.h
diff --git a/device/harness/main/ui/display.c b/device/harness-device/firmware/main/ui/display.c
similarity index 100%
rename from device/harness/main/ui/display.c
rename to device/harness-device/firmware/main/ui/display.c
diff --git a/device/harness/main/ui/display.h b/device/harness-device/firmware/main/ui/display.h
similarity index 100%
rename from device/harness/main/ui/display.h
rename to device/harness-device/firmware/main/ui/display.h
diff --git a/device/harness/main/ui/geist_med_28.c b/device/harness-device/firmware/main/ui/geist_med_28.c
similarity index 100%
rename from device/harness/main/ui/geist_med_28.c
rename to device/harness-device/firmware/main/ui/geist_med_28.c
diff --git a/device/harness/main/ui/geist_med_32.c b/device/harness-device/firmware/main/ui/geist_med_32.c
similarity index 100%
rename from device/harness/main/ui/geist_med_32.c
rename to device/harness-device/firmware/main/ui/geist_med_32.c
diff --git a/device/harness/main/ui/geist_med_38.c b/device/harness-device/firmware/main/ui/geist_med_38.c
similarity index 100%
rename from device/harness/main/ui/geist_med_38.c
rename to device/harness-device/firmware/main/ui/geist_med_38.c
diff --git a/device/harness/main/ui/geist_med_48.c b/device/harness-device/firmware/main/ui/geist_med_48.c
similarity index 100%
rename from device/harness/main/ui/geist_med_48.c
rename to device/harness-device/firmware/main/ui/geist_med_48.c
diff --git a/device/harness/main/ui/geist_med_64.c b/device/harness-device/firmware/main/ui/geist_med_64.c
similarity index 100%
rename from device/harness/main/ui/geist_med_64.c
rename to device/harness-device/firmware/main/ui/geist_med_64.c
diff --git a/device/harness/main/ui/geist_reg_16.c b/device/harness-device/firmware/main/ui/geist_reg_16.c
similarity index 100%
rename from device/harness/main/ui/geist_reg_16.c
rename to device/harness-device/firmware/main/ui/geist_reg_16.c
diff --git a/device/harness/main/ui/geist_reg_20.c b/device/harness-device/firmware/main/ui/geist_reg_20.c
similarity index 100%
rename from device/harness/main/ui/geist_reg_20.c
rename to device/harness-device/firmware/main/ui/geist_reg_20.c
diff --git a/device/harness/main/ui/geist_reg_24.c b/device/harness-device/firmware/main/ui/geist_reg_24.c
similarity index 100%
rename from device/harness/main/ui/geist_reg_24.c
rename to device/harness-device/firmware/main/ui/geist_reg_24.c
diff --git a/device/harness/main/ui/geist_reg_25.c b/device/harness-device/firmware/main/ui/geist_reg_25.c
similarity index 100%
rename from device/harness/main/ui/geist_reg_25.c
rename to device/harness-device/firmware/main/ui/geist_reg_25.c
diff --git a/device/harness/main/ui/geist_reg_32.c b/device/harness-device/firmware/main/ui/geist_reg_32.c
similarity index 100%
rename from device/harness/main/ui/geist_reg_32.c
rename to device/harness-device/firmware/main/ui/geist_reg_32.c
diff --git a/device/harness/main/ui/geist_reg_34.c b/device/harness-device/firmware/main/ui/geist_reg_34.c
similarity index 100%
rename from device/harness/main/ui/geist_reg_34.c
rename to device/harness-device/firmware/main/ui/geist_reg_34.c
diff --git a/device/harness/main/ui/geist_reg_38.c b/device/harness-device/firmware/main/ui/geist_reg_38.c
similarity index 100%
rename from device/harness/main/ui/geist_reg_38.c
rename to device/harness-device/firmware/main/ui/geist_reg_38.c
diff --git a/device/harness/main/ui/geist_sem_24.c b/device/harness-device/firmware/main/ui/geist_sem_24.c
similarity index 100%
rename from device/harness/main/ui/geist_sem_24.c
rename to device/harness-device/firmware/main/ui/geist_sem_24.c
diff --git a/device/harness/main/ui/icons_engine.c b/device/harness-device/firmware/main/ui/icons_engine.c
similarity index 100%
rename from device/harness/main/ui/icons_engine.c
rename to device/harness-device/firmware/main/ui/icons_engine.c
diff --git a/device/harness/main/ui/icons_engine.h b/device/harness-device/firmware/main/ui/icons_engine.h
similarity index 100%
rename from device/harness/main/ui/icons_engine.h
rename to device/harness-device/firmware/main/ui/icons_engine.h
diff --git a/device/harness/main/ui/icons_settings.c b/device/harness-device/firmware/main/ui/icons_settings.c
similarity index 100%
rename from device/harness/main/ui/icons_settings.c
rename to device/harness-device/firmware/main/ui/icons_settings.c
diff --git a/device/harness/main/ui/icons_settings.h b/device/harness-device/firmware/main/ui/icons_settings.h
similarity index 100%
rename from device/harness/main/ui/icons_settings.h
rename to device/harness-device/firmware/main/ui/icons_settings.h
diff --git a/device/harness/main/ui/icons_voice.c b/device/harness-device/firmware/main/ui/icons_voice.c
similarity index 100%
rename from device/harness/main/ui/icons_voice.c
rename to device/harness-device/firmware/main/ui/icons_voice.c
diff --git a/device/harness/main/ui/icons_voice.h b/device/harness-device/firmware/main/ui/icons_voice.h
similarity index 100%
rename from device/harness/main/ui/icons_voice.h
rename to device/harness-device/firmware/main/ui/icons_voice.h
diff --git a/device/harness/main/ui/spinner_spokes.c b/device/harness-device/firmware/main/ui/spinner_spokes.c
similarity index 100%
rename from device/harness/main/ui/spinner_spokes.c
rename to device/harness-device/firmware/main/ui/spinner_spokes.c
diff --git a/device/harness/main/ui/spinner_spokes.h b/device/harness-device/firmware/main/ui/spinner_spokes.h
similarity index 100%
rename from device/harness/main/ui/spinner_spokes.h
rename to device/harness-device/firmware/main/ui/spinner_spokes.h
diff --git a/device/harness/main/ui/touch.c b/device/harness-device/firmware/main/ui/touch.c
similarity index 100%
rename from device/harness/main/ui/touch.c
rename to device/harness-device/firmware/main/ui/touch.c
diff --git a/device/harness/main/ui/touch.h b/device/harness-device/firmware/main/ui/touch.h
similarity index 100%
rename from device/harness/main/ui/touch.h
rename to device/harness-device/firmware/main/ui/touch.h
diff --git a/device/harness/main/ui/ui_screens.c b/device/harness-device/firmware/main/ui/ui_screens.c
similarity index 100%
rename from device/harness/main/ui/ui_screens.c
rename to device/harness-device/firmware/main/ui/ui_screens.c
diff --git a/device/harness/main/ui/ui_screens.h b/device/harness-device/firmware/main/ui/ui_screens.h
similarity index 100%
rename from device/harness/main/ui/ui_screens.h
rename to device/harness-device/firmware/main/ui/ui_screens.h
diff --git a/device/harness/partitions.csv b/device/harness-device/firmware/partitions.csv
similarity index 100%
rename from device/harness/partitions.csv
rename to device/harness-device/firmware/partitions.csv
diff --git a/device/harness/screen.html b/device/harness-device/firmware/screen.html
similarity index 99%
rename from device/harness/screen.html
rename to device/harness-device/firmware/screen.html
index a29a0ff44..b2376f8c3 100644
--- a/device/harness/screen.html
+++ b/device/harness-device/firmware/screen.html
@@ -402,6 +402,6 @@
</section>
<footer>
- Commander device UI — device/harness/main/ui/ui_screens.c · round 466×466 CO5300 AMOLED · rendered from the live palette &amp; type scale.
+ Commander device UI — device/harness-device/firmware/main/ui/ui_screens.c · round 466×466 CO5300 AMOLED · rendered from the live palette &amp; type scale.
</footer>
</div>
diff --git a/device/harness/scripts/flash-station.sh b/device/harness-device/firmware/scripts/flash-station.sh
similarity index 100%
rename from device/harness/scripts/flash-station.sh
rename to device/harness-device/firmware/scripts/flash-station.sh
diff --git a/device/harness/scripts/gen_cable_vectors.py b/device/harness-device/firmware/scripts/gen_cable_vectors.py
similarity index 96%
rename from device/harness/scripts/gen_cable_vectors.py
rename to device/harness-device/firmware/scripts/gen_cable_vectors.py
index 89629b8dd..4efc407b6 100644
--- a/device/harness/scripts/gen_cable_vectors.py
+++ b/device/harness-device/firmware/scripts/gen_cable_vectors.py
@@ -1,8 +1,8 @@
#!/usr/bin/env python3
"""Generate the shared framing vectors for the USB cable link.
- device/harness/scripts/gen_cable_vectors.py # writes test/vectors/cable_frame.txt
- device/harness/scripts/gen_cable_vectors.py --check # fails if the file on disk differs
+ device/harness-device/firmware/scripts/gen_cable_vectors.py # writes test/vectors/cable_frame.txt
+ device/harness-device/firmware/scripts/gen_cable_vectors.py --check # fails if the file on disk differs
A THIRD implementation, written from the format description in main/cable_frame.h and from nothing
else. That is the entire point: the firmware (C) and the daemon (TypeScript, in the autonomous-harness
@@ -136,7 +136,7 @@ def stream_cases():
def render() -> str:
out = [
"# Shared framing vectors for the harness USB cable link.",
- "# Generated by device/harness/scripts/gen_cable_vectors.py — a third implementation, written",
+ "# Generated by device/harness-device/firmware/scripts/gen_cable_vectors.py — a third implementation, written",
"# from main/cable_frame.h's format description and from neither half's code. Do not hand-edit.",
"#",
"# encode <name> <type> <payload-hex> <frame-hex>",
diff --git a/device/harness/scripts/gen_fonts.sh b/device/harness-device/firmware/scripts/gen_fonts.sh
similarity index 100%
rename from device/harness/scripts/gen_fonts.sh
rename to device/harness-device/firmware/scripts/gen_fonts.sh
diff --git a/device/harness/scripts/upload-firmware.sh b/device/harness-device/firmware/scripts/upload-firmware.sh
similarity index 99%
rename from device/harness/scripts/upload-firmware.sh
rename to device/harness-device/firmware/scripts/upload-firmware.sh
index 86e06bfd2..5997ea071 100755
--- a/device/harness/scripts/upload-firmware.sh
+++ b/device/harness-device/firmware/scripts/upload-firmware.sh
@@ -19,7 +19,7 @@
# must be public-read so devices can download without credentials. `idf.py` on PATH (or IDF_PATH set).
set -euo pipefail
-HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)" # device/harness
+HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)" # device/harness-device/firmware
VER_FILE="$HERE/version.txt"
# A DEDICATED prod build dir + DEVICE_FORCE_PROD so a published binary is always production (ignores any
# local provisioned_config.h) WITHOUT moving the header, and without clobbering the interactive `build/`
@@ -157,7 +157,7 @@ if [ "$DO_BUILD" -eq 1 ]; then
# 10 KiB landed, producing firmware that crashed mid-OTA and could not update itself.
#
# Deleting it costs a reconfigure (~10s) per release and makes the published binary a function of the
- # tracked defaults alone. The developer's interactive device/harness/sdkconfig is left untouched.
+ # tracked defaults alone. The developer's interactive device/harness-device/firmware/sdkconfig is left untouched.
RELEASE_SDKCONFIG="$BUILD_DIR/sdkconfig.release"
rm -f "$RELEASE_SDKCONFIG"
echo ">> building… (prod: -DDEVICE_FORCE_PROD=1, build dir $BUILD_DIR, fresh config from sdkconfig.defaults)"
diff --git a/device/harness/scripts/upload-flasher.sh b/device/harness-device/firmware/scripts/upload-flasher.sh
similarity index 100%
rename from device/harness/scripts/upload-flasher.sh
rename to device/harness-device/firmware/scripts/upload-flasher.sh
diff --git a/device/harness/sdkconfig.defaults b/device/harness-device/firmware/sdkconfig.defaults
similarity index 100%
rename from device/harness/sdkconfig.defaults
rename to device/harness-device/firmware/sdkconfig.defaults
diff --git a/device/harness/test/run.sh b/device/harness-device/firmware/test/run.sh
similarity index 97%
rename from device/harness/test/run.sh
rename to device/harness-device/firmware/test/run.sh
index 06adcbdc0..c5025e327 100755
--- a/device/harness/test/run.sh
+++ b/device/harness-device/firmware/test/run.sh
@@ -1,7 +1,7 @@
#!/usr/bin/env bash
# Host tests for the parts of the firmware that do not need the board.
#
-# device/harness/test/run.sh
+# device/harness-device/firmware/test/run.sh
#
# No ESP-IDF, no flash cycle, no cable: cable_frame.c compiles with a plain compiler on purpose, so the
# framing both halves of the link depend on can be checked in milliseconds. Run it before touching either
diff --git a/device/harness/test/test_board.c b/device/harness-device/firmware/test/test_board.c
similarity index 100%
rename from device/harness/test/test_board.c
rename to device/harness-device/firmware/test/test_board.c
diff --git a/device/harness/test/test_cable_frame.c b/device/harness-device/firmware/test/test_cable_frame.c
similarity index 99%
rename from device/harness/test/test_cable_frame.c
rename to device/harness-device/firmware/test/test_cable_frame.c
index bb17670e0..ea2b0267f 100644
--- a/device/harness/test/test_cable_frame.c
+++ b/device/harness-device/firmware/test/test_cable_frame.c
@@ -1,6 +1,6 @@
// Runs the shared framing vectors against the firmware's own decoder, on a laptop.
//
-// device/harness/test/run.sh
+// device/harness-device/firmware/test/run.sh
//
// This is the C half of the agreement described in main/cable_frame.h: the daemon's TypeScript decoder
// asserts against the same test/vectors/cable_frame.txt, generated by a third implementation. Nothing is
diff --git a/device/harness/test/test_cable_machines.c b/device/harness-device/firmware/test/test_cable_machines.c
similarity index 99%
rename from device/harness/test/test_cable_machines.c
rename to device/harness-device/firmware/test/test_cable_machines.c
index 37e70f130..33716ba23 100644
--- a/device/harness/test/test_cable_machines.c
+++ b/device/harness-device/firmware/test/test_cable_machines.c
@@ -1,6 +1,6 @@
// The machine-wheel ingest gate, on a laptop.
//
-// device/harness/test/run.sh
+// device/harness-device/firmware/test/run.sh
//
// What is under test is one question — "did anything actually change?" — and every case here is a way of
// getting that wrong that would look completely normal on the screen. An over-eager `true` costs a wheel
diff --git a/device/harness/test/test_carousel_ring.c b/device/harness-device/firmware/test/test_carousel_ring.c
similarity index 100%
rename from device/harness/test/test_carousel_ring.c
rename to device/harness-device/firmware/test/test_carousel_ring.c
diff --git a/device/harness/test/vectors/cable_frame.txt b/device/harness-device/firmware/test/vectors/cable_frame.txt
similarity index 99%
rename from device/harness/test/vectors/cable_frame.txt
rename to device/harness-device/firmware/test/vectors/cable_frame.txt
index 71da64ac0..3f71defe6 100644
--- a/device/harness/test/vectors/cable_frame.txt
+++ b/device/harness-device/firmware/test/vectors/cable_frame.txt
@@ -1,5 +1,5 @@
# Shared framing vectors for the harness USB cable link.
-# Generated by device/harness/scripts/gen_cable_vectors.py — a third implementation, written
+# Generated by device/harness-device/firmware/scripts/gen_cable_vectors.py — a third implementation, written
# from main/cable_frame.h's format description and from neither half's code. Do not hand-edit.
#
# encode <name> <type> <payload-hex> <frame-hex>
diff --git a/device/harness/tools/generate_engine_icons.py b/device/harness-device/firmware/tools/generate_engine_icons.py
similarity index 96%
rename from device/harness/tools/generate_engine_icons.py
rename to device/harness-device/firmware/tools/generate_engine_icons.py
index 56a12bac8..63f4f78c1 100644
--- a/device/harness/tools/generate_engine_icons.py
+++ b/device/harness-device/firmware/tools/generate_engine_icons.py
@@ -18,7 +18,7 @@ REPO_ROOT = Path(__file__).resolve().parents[3]
# to be pointed at a checkout of it:
#
# HARNESS_ENGINE_ICONS=~/src/autonomous-code/apps/web/public/engine-icons \
-# python3 device/harness/tools/generate_engine_icons.py
+# python3 device/harness-device/firmware/tools/generate_engine_icons.py
#
# The SHA-256 table below is what makes that safe to do across two repos: an icon
# that has changed on the web side fails the check rather than silently
@@ -27,7 +27,7 @@ ASSET_DIR = Path(
os.environ.get("HARNESS_ENGINE_ICONS")
or REPO_ROOT / "../autonomous-code/apps/web/public/engine-icons"
).expanduser()
-TARGET = REPO_ROOT / "device/harness/main/ui/icons_engine.c"
+TARGET = REPO_ROOT / "device/harness-device/firmware/main/ui/icons_engine.c"
ICON_SIZE = 20
EXPECTED_SHA256 = {
"codex.png": "8e82b26c98a10e45798ce48124515720657f7735fb8d0853b3f087eaa8a6b74e",
diff --git a/device/harness/version.txt b/device/harness-device/firmware/version.txt
similarity index 100%
rename from device/harness/version.txt
rename to device/harness-device/firmware/version.txt
diff --git a/device/harness/design/agent-switcher-local-remote.html b/device/harness/design/agent-switcher-local-remote.html
deleted file mode 100644
index 8c6bb24ed..000000000
--- a/device/harness/design/agent-switcher-local-remote.html
+++ /dev/null
@@ -1,223 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-<meta charset="UTF-8">
-<meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>Agent switcher — telling local from remote · design options</title>
-<style>
- /* ---- Design tokens (mirror device/harness/main/ui/ui_screens.c) ---- */
- :root{
- --bg:#000000; --fg:#eaeaf0; --muted:#8a8a99; --card:#16161c;
- --accent:#5b8cff; --green:#35c46a; --voice:#00ff2f; --dotoff:#4c4c4c;
- --sans: system-ui, -apple-system, "Helvetica Neue", Arial, sans-serif;
- --mont: "Montserrat", var(--sans);
- }
- *{box-sizing:border-box}
- html,body{margin:0;background:#0c0c10;color:#d8d8e0;font-family:var(--sans);-webkit-font-smoothing:antialiased}
- header.page{padding:32px 40px 8px}
- header.page h1{margin:0 0 6px;font-family:var(--mont);font-weight:700;font-size:26px;color:#fff}
- header.page p{margin:6px 0;max-width:940px;line-height:1.55;color:#a9a9b6;font-size:14px}
- header.page code{background:#1b1b22;padding:1px 6px;border-radius:5px;color:#c9d4ff;font-size:12.5px}
- header.page b{color:#e6e6ee}
-
- section.group-title{padding:26px 40px 2px}
- section.group-title h2{margin:0;font-family:var(--mont);font-weight:600;font-size:15px;letter-spacing:.08em;
- text-transform:uppercase;color:#6f7cff}
- .grid{display:flex;flex-wrap:wrap;gap:34px 30px;padding:18px 40px 10px;align-items:flex-start}
- figure.dev{margin:0;width:300px}
- .screen-wrap{width:300px;height:300px;position:relative}
- .screen{position:absolute;top:0;left:0;width:466px;height:466px;transform:scale(.6437);transform-origin:top left;
- border-radius:50%;overflow:hidden;background:var(--bg);
- box-shadow:0 0 0 6px #17171d, 0 12px 34px rgba(0,0,0,.6)}
- figcaption{margin-top:12px}
- figcaption .name{font-weight:650;color:#eaeaf0;font-size:14px}
- figcaption .tag{font-family:var(--mont);font-size:10.5px;color:#7f8cff;background:#14141b;padding:1px 6px;
- border-radius:5px;margin-left:6px;letter-spacing:.04em}
- figcaption .tag.pick{color:#0c0c10;background:var(--green)}
- figcaption .tag.bad{color:#ffb4b4;background:#2a1618}
- figcaption .note{display:block;margin-top:6px;color:#8a8a96;font-size:12.5px;line-height:1.5}
- figcaption .note b{color:#c9c9d4;font-weight:600}
-
- /* ---------- device internals, authored at true 466px ---------- */
- /* switch_build(): full-bleed black backdrop; a 384-wide column, centred, max-height 360, 8px row gap. */
- .sw-back{position:absolute;inset:0;background:var(--bg)}
- .sw-list{position:absolute;left:50%;top:50%;transform:translate(-50%,-50%);
- width:384px;max-height:360px;display:flex;flex-direction:column;gap:8px;overflow:hidden}
- /* switch_rebuild(): lv_button, radius 16, pad 16 hor / 10 ver, column, 2px row gap, centred */
- .row{border-radius:16px;padding:10px 16px;display:flex;flex-direction:column;align-items:center;gap:2px;
- background:rgba(22,22,28,.6)}
- .row.here{background:var(--card);box-shadow:inset 0 0 0 1px var(--accent)}
- .nm{font-size:28px;font-weight:500;color:var(--fg);line-height:1.15;white-space:nowrap;
- overflow:hidden;text-overflow:ellipsis;max-width:100%}
- .nm.busy{color:var(--voice)}
- .sub{font-size:25px;color:var(--muted);line-height:1.15;display:flex;align-items:center;gap:8px}
- .sub.local{color:var(--green)}
- /* the leading marker used by options C / E */
- .dot{width:11px;height:11px;border-radius:50%;flex:none}
- .dot.local{background:var(--green)}
- .dot.remote{background:transparent;box-shadow:inset 0 0 0 2px var(--dotoff)}
- /* option D: a machine heading above each run of rows */
- .hdr{font-size:20px;letter-spacing:.10em;text-transform:uppercase;color:var(--dotoff);
- padding:2px 4px 0;align-self:flex-start}
- /* option E: the whole card tinted rather than the text */
- .row.tintlocal{background:rgba(53,196,106,.10)}
- .row.tintlocal.here{background:rgba(53,196,106,.16);box-shadow:inset 0 0 0 1px var(--accent)}
-
- table.cmp{border-collapse:collapse;margin:6px 40px 40px;font-size:13.5px;max-width:1000px}
- table.cmp th,table.cmp td{border-bottom:1px solid #1e1e26;padding:9px 14px;text-align:left;vertical-align:top}
- table.cmp th{color:#8a8a99;font-weight:600;font-size:11.5px;letter-spacing:.06em;text-transform:uppercase}
- table.cmp td{color:#b6b6c2;line-height:1.5}
- table.cmp td b{color:#e6e6ee}
- table.cmp tr.pick td{background:#101a13}
- footer.page{padding:0 40px 60px;color:#8a8a96;font-size:13px;line-height:1.6;max-width:940px}
- footer.page b{color:#d0d0da}
- footer.page code{background:#1b1b22;padding:1px 6px;border-radius:5px;color:#c9d4ff;font-size:12.5px}
-</style>
-</head>
-<body>
-
-<header class="page">
- <h1>Agent switcher — telling local from remote</h1>
- <p>Swipe down from any carousel page and this list opens (<code>ui_switch_open</code> →
- <code>switch_rebuild</code> in <code>main/ui/ui_screens.c</code>). Since the carousel started spanning
- every machine, the list mixes agents from this computer with agents reached over the cloud — and
- <b>every row looks the same</b>, so there is nothing to tell them apart at a glance.</p>
- <p>Line two already carries the machine name. All five options below change only how that line is
- <i>presented</i>; none of them adds a line or changes the row's height, except D, which spends one
- header row per machine.</p>
- <p><b>The device already has a word for this.</b> The Machines wheel calls the cabled machine
- <code>"This computer"</code> (<code>machine_meta_line</code>, ui_screens.c:6396) — chosen because the
- cable is the evidence and that is the only row that can claim it. Options D and E reuse that exact
- phrase rather than inventing a second vocabulary for the same fact.</p>
- <p><b>Rendered at true 466 px and scaled</b>, with the real geometry: 384-wide column, 16 px radius,
- 16/10 padding, 28 px name over a 25 px machine line. Fonts are approximated — the device uses Geist.</p>
-</header>
-
-<section class="group-title"><h2>Today — and four ways to fix it</h2></section>
-<div class="grid">
-
- <!-- A: current -->
- <figure class="dev"><div class="screen-wrap"><div class="screen">
- <div class="sw-back"></div>
- <div class="sw-list">
- <div class="row here"><div class="nm">api refactor</div><div class="sub">MacbookPro.local</div></div>
- <div class="row"><div class="nm busy">payments</div><div class="sub">office-imac</div></div>
- <div class="row"><div class="nm">device firmware</div><div class="sub">MacbookPro.local</div></div>
- <div class="row"><div class="nm">docs sweep</div><div class="sub">studio</div></div>
- </div>
- </div></div>
- <figcaption>
- <span class="name">A · Today</span><span class="tag bad">the complaint</span>
- <span class="note">Four rows, two computers, one appearance. The machine name is there but reads as a
- label rather than a distinction — you have to <b>read and know</b> which of those names is the one
- you are plugged into.</span>
- </figcaption>
-
- <!-- B: colour the machine line -->
- <figure class="dev"><div class="screen-wrap"><div class="screen">
- <div class="sw-back"></div>
- <div class="sw-list">
- <div class="row here"><div class="nm">api refactor</div><div class="sub local">MacbookPro.local</div></div>
- <div class="row"><div class="nm busy">payments</div><div class="sub">office-imac</div></div>
- <div class="row"><div class="nm">device firmware</div><div class="sub local">MacbookPro.local</div></div>
- <div class="row"><div class="nm">docs sweep</div><div class="sub">studio</div></div>
- </div>
- </div></div>
- <figcaption>
- <span class="name">B · Colour the machine line</span><span class="tag">1 line of code</span>
- <span class="note">Local goes <b>COL_GREEN</b>, remote stays <b>COL_MUTED</b>. Marks local rather than
- colouring both, so nothing collides with the blue selection border. Cheapest possible change —
- but hue is the only cue, which the dim overlay and colour blindness both erode.</span>
- </figcaption>
-
- <!-- C: dot + colour -->
- <figure class="dev"><div class="screen-wrap"><div class="screen">
- <div class="sw-back"></div>
- <div class="sw-list">
- <div class="row here"><div class="nm">api refactor</div>
- <div class="sub local"><i class="dot local"></i>MacbookPro.local</div></div>
- <div class="row"><div class="nm busy">payments</div>
- <div class="sub"><i class="dot remote"></i>office-imac</div></div>
- <div class="row"><div class="nm">device firmware</div>
- <div class="sub local"><i class="dot local"></i>MacbookPro.local</div></div>
- <div class="row"><div class="nm">docs sweep</div>
- <div class="sub"><i class="dot remote"></i>studio</div></div>
- </div>
- </div></div>
- <figcaption>
- <span class="name">C · Dot + colour</span><span class="tag">shape, not just hue</span>
- <span class="note">A filled green dot for local, a hollow grey ring for remote. <b>Survives the dim
- overlay and colour blindness</b> because filled-vs-hollow is a shape difference. Reuses the page-dot
- idiom already on this face (<code>COL_DOT_OFF</code>).</span>
- </figcaption>
-
- <!-- D: grouped under machine headings -->
- <figure class="dev"><div class="screen-wrap"><div class="screen">
- <div class="sw-back"></div>
- <div class="sw-list">
- <div class="hdr">This computer</div>
- <div class="row here"><div class="nm">api refactor</div><div class="sub">Claude</div></div>
- <div class="row"><div class="nm">device firmware</div><div class="sub">Codex</div></div>
- <div class="hdr">office-imac</div>
- <div class="row"><div class="nm busy">payments</div><div class="sub">Claude</div></div>
- </div>
- </div></div>
- <figcaption>
- <span class="name">D · Group under the machine</span><span class="tag">strongest grouping</span>
- <span class="note">Rows sort by machine already, so a heading per run costs nothing to compute. The
- machine name leaves the row, which <b>gives line two back to the engine</b>. Costs ~30 px per
- machine out of a 360 px list — with three machines that is one row's worth of agents lost.</span>
- </figcaption>
-
- <!-- E: "This computer" + dot -->
- <figure class="dev"><div class="screen-wrap"><div class="screen">
- <div class="sw-back"></div>
- <div class="sw-list">
- <div class="row here"><div class="nm">api refactor</div>
- <div class="sub local"><i class="dot local"></i>This computer</div></div>
- <div class="row"><div class="nm busy">payments</div>
- <div class="sub"><i class="dot remote"></i>office-imac</div></div>
- <div class="row"><div class="nm">device firmware</div>
- <div class="sub local"><i class="dot local"></i>This computer</div></div>
- <div class="row"><div class="nm">docs sweep</div>
- <div class="sub"><i class="dot remote"></i>studio</div></div>
- </div>
- </div></div>
- <figcaption>
- <span class="name">E · “This computer” + dot</span><span class="tag pick">recommended</span>
- <span class="note">Three cues that agree — <b>words, shape, colour</b> — and the words are the ones the
- Machines wheel already uses, so the two screens cannot drift apart. Costs no vertical space. Local
- rows trade a machine name you must recognise for a fact you cannot misread.</span>
- </figcaption>
-
-</div>
-
-<section class="group-title"><h2>Trade-offs</h2></section>
-<table class="cmp">
- <tr><th>Option</th><th>Cues</th><th>Vertical cost</th><th>Where it is weak</th></tr>
- <tr><td><b>B</b> colour only</td><td>hue</td><td>none</td>
- <td>Hue alone. The brightness dim is a black wash over this same layer, so a dimmed screen flattens
- green toward grey — exactly when the user is least able to squint at it.</td></tr>
- <tr><td><b>C</b> dot + colour</td><td>hue + shape</td><td>none</td>
- <td>Still asks the user to learn what the dot means. Nothing on screen says it.</td></tr>
- <tr><td><b>D</b> grouped</td><td>position + words</td><td>~30 px per machine</td>
- <td>The most screen spent. Also the only option that changes the list's structure, so scroll
- position and the row-index → agent mapping both need care.</td></tr>
- <tr class="pick"><td><b>E</b> words + dot</td><td>words + shape + hue</td><td>none</td>
- <td>Local rows stop naming their machine — fine while <b>one computer per machine</b> holds, which
- is an invariant of the product, not a coincidence.</td></tr>
-</table>
-
-<footer class="page">
- <p><b>How the firmware would know.</b> Every row already carries it: <code>project_t.machine_id</code>
- arrives with the agent list, and <code>cable_client_machine_id()</code> is the cabled computer's own
- id. Local is <code>strcmp(p-&gt;machine_id, cable_client_machine_id()) == 0</code> — no new wire field
- and no new RPC. A daemon too old to send <code>machineId</code> sends <code>""</code>, which matches
- nothing, so every row simply falls back to today's appearance rather than claiming to be remote.</p>
- <p><b>All five keep the existing busy rule.</b> An agent mid-turn still shows its name in
- <code>COL_VOICE</code> green (<code>payments</code> above). That is a different fact from where it
- lives, which is why the local marker is on line two and never on the name.</p>
-</footer>
-
-</body>
-</html>
diff --git a/device/harness/design/agent-tile-machine.html b/device/harness/design/agent-tile-machine.html
deleted file mode 100644
index 4d1de38f5..000000000
--- a/device/harness/design/agent-tile-machine.html
+++ /dev/null
@@ -1,310 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-<meta charset="UTF-8">
-<meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>Agent tile — saying which machine · design options</title>
-<style>
- :root{
- --bg:#000000; --fg:#eaeaf0; --muted:#8a8a99; --card:#16161c; --dotoff:#4c4c4c;
- --accent:#5b8cff; --green:#35c46a; --voice:#00ff2f; --orange:#ff8a4c; --claude:#cc7c5e;
- --pillbord:#333333; --pillfill:#1c1c1c; --bell:#006fff;
- --sans: system-ui, -apple-system, "Helvetica Neue", Arial, sans-serif;
- --mont: "Montserrat", var(--sans);
- }
- *{box-sizing:border-box}
- html,body{margin:0;background:#0c0c10;color:#d8d8e0;font-family:var(--sans);-webkit-font-smoothing:antialiased}
- header.page{padding:32px 40px 8px}
- header.page h1{margin:0 0 6px;font-family:var(--mont);font-weight:700;font-size:26px;color:#fff}
- header.page p{margin:6px 0;max-width:960px;line-height:1.55;color:#a9a9b6;font-size:14px}
- header.page code{background:#1b1b22;padding:1px 6px;border-radius:5px;color:#c9d4ff;font-size:12.5px}
- header.page b{color:#e6e6ee}
- ul.budget{max-width:960px;margin:10px 0 0;padding-left:20px;color:#a9a9b6;font-size:14px;line-height:1.7}
- ul.budget b{color:#e6e6ee} ul.budget code{background:#1b1b22;padding:1px 6px;border-radius:5px;color:#c9d4ff;font-size:12.5px}
-
- section.group-title{padding:26px 40px 2px}
- section.group-title h2{margin:0;font-family:var(--mont);font-weight:600;font-size:15px;letter-spacing:.08em;
- text-transform:uppercase;color:#6f7cff}
- .grid{display:flex;flex-wrap:wrap;gap:34px 30px;padding:18px 40px 10px;align-items:flex-start}
- figure.dev{margin:0;width:300px}
- .screen-wrap{width:300px;height:300px;position:relative}
- .screen{position:absolute;top:0;left:0;width:466px;height:466px;transform:scale(.6437);transform-origin:top left;
- border-radius:50%;overflow:hidden;background:var(--bg);
- box-shadow:0 0 0 6px #17171d, 0 12px 34px rgba(0,0,0,.6)}
- figcaption{margin-top:12px}
- figcaption .name{font-weight:650;color:#eaeaf0;font-size:14px}
- figcaption .tag{font-family:var(--mont);font-size:10.5px;color:#7f8cff;background:#14141b;padding:1px 6px;
- border-radius:5px;margin-left:6px;letter-spacing:.04em}
- figcaption .tag.pick{color:#0c0c10;background:var(--green)}
- figcaption .tag.bad{color:#ffb4b4;background:#2a1618}
- figcaption .note{display:block;margin-top:6px;color:#8a8a96;font-size:12.5px;line-height:1.5}
- figcaption .note b{color:#c9c9d4;font-weight:600}
-
- /* ---------- device internals, authored at true 466px ---------- */
- .tile{position:absolute;inset:0}
- /* the bell: TOP_MID +22, only when there are unread turns */
- .bell{position:absolute;top:22px;left:50%;transform:translateX(-50%);background:var(--bell);
- border-radius:999px;padding:4px 13px;display:flex;align-items:center;gap:6px;color:var(--fg);
- font-family:var(--mont);height:36px}
- .bell .b{font-size:14px} .bell .n{font-size:22px}
- /* chip row: floating, top 69, pill height 40 */
- .ctl{position:absolute;top:69px;left:50%;transform:translateX(-50%);display:flex;align-items:center;gap:13px}
- .mark{width:40px;height:40px;border-radius:9px;display:flex;align-items:center;justify-content:center;
- background:transparent;color:var(--claude);font-size:26px;line-height:1}
- .pill{height:40px;border:1px solid var(--pillbord);background:var(--pillfill);border-radius:999px;
- padding:0 11px;display:flex;align-items:center;gap:7px;color:var(--fg);font-family:var(--mont);font-size:22px}
- .pill.mach{color:#c9c9d4}
- .pill .dot{width:11px;height:11px;border-radius:50%;background:var(--green);flex:none}
- .pill .dot.remote{background:transparent;box-shadow:inset 0 0 0 2px var(--dotoff)}
- /* the agent name: top 117, geist medium 38 */
- .nm{position:absolute;top:117px;left:41px;width:384px;height:48px;text-align:center;color:var(--fg);
- font-size:38px;font-weight:500;line-height:48px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
- /* option A: a machine line directly under the name */
- .sub{position:absolute;left:41px;width:384px;text-align:center;color:var(--muted);font-size:25px;line-height:30px}
- .sub .dot{display:inline-block;width:11px;height:11px;border-radius:50%;background:var(--green);
- vertical-align:middle;margin-right:8px}
- .sub .dot.remote{background:transparent;box-shadow:inset 0 0 0 2px var(--dotoff)}
- /* the recap card the body leads with */
- .card{position:absolute;left:41px;width:384px;background:var(--card);border-radius:18px;padding:16px 18px;
- color:#c9c9d4;font-size:25px;line-height:1.32;text-align:left}
- .card .k{display:block;color:var(--orange);font-size:22px;margin-bottom:6px}
- .dots{position:absolute;bottom:16px;left:0;right:0;display:flex;justify-content:center;gap:8px}
- .dots i{width:6px;height:6px;border-radius:50%;background:var(--dotoff)}
- .dots i.on{background:var(--fg)}
- /* the y<44 tap-swallowing band, drawn only in the annotated frame */
- .zone{position:absolute;top:0;left:0;right:0;height:44px;background:repeating-linear-gradient(
- 135deg,rgba(255,90,90,.12) 0 10px,transparent 10px 20px);border-bottom:1px dashed rgba(255,90,90,.5)}
- .zone b{position:absolute;right:120px;top:12px;color:#ff8f8f;font-family:var(--mont);font-size:16px;font-weight:400}
-
- table.cmp{border-collapse:collapse;margin:6px 40px 40px;font-size:13.5px;max-width:1040px}
- table.cmp th,table.cmp td{border-bottom:1px solid #1e1e26;padding:9px 14px;text-align:left;vertical-align:top}
- table.cmp th{color:#8a8a99;font-weight:600;font-size:11.5px;letter-spacing:.06em;text-transform:uppercase}
- table.cmp td{color:#b6b6c2;line-height:1.5}
- table.cmp td b{color:#e6e6ee}
- table.cmp tr.pick td{background:#101a13}
- footer.page{padding:0 40px 60px;color:#8a8a96;font-size:13px;line-height:1.6;max-width:960px}
- footer.page b{color:#d0d0da}
- footer.page code{background:#1b1b22;padding:1px 6px;border-radius:5px;color:#c9d4ff;font-size:12.5px}
-</style>
-</head>
-<body>
-
-<header class="page">
- <h1>Agent tile — saying which machine</h1>
- <p>The carousel spans machines now, but an agent's own tile never says which one it is on. You can reach
- it by swiping past agents from three computers and the tile looks identical either way.</p>
- <p><b>The tile is a tight space, and the budget is the whole design problem.</b> Measured from
- <code>ui_screens.c</code>, not estimated:</p>
- <ul class="budget">
- <li><code>y &lt; 44</code> — <b>swallowed by touch.c</b> for the switcher pull-down. Fine for a label,
- useless for anything tappable.</li>
- <li><code>y 22–58</code> — the <b>bell</b> (<code>LV_ALIGN_TOP_MID, 0, 22</code>), but only when there
- are unread turns. Anything centred here collides <i>sometimes</i>, which is worse than always.</li>
- <li><code>y 69–109</code> — the floating chip row <code>[mark] [Model] [Effort]</code>.</li>
- <li><code>y 117–165</code> — the agent name, <code>geist_med_38</code>, one line, ellipsised.</li>
- <li>The glass is <b>307 px wide at y=58</b>, 331 at y=69, 394 at y=109 — a round face, so anything up
- high is also narrow.</li>
- </ul>
- <p>So there is no free real estate up top: the only truly unclaimed band is <code>y 44–69</code>, which is
- 25 px, and it disappears under the bell whenever a turn finishes.</p>
-</header>
-
-<section class="group-title"><h2>Today, and three ways to fix it</h2></section>
-<div class="grid">
-
- <!-- A: today, annotated -->
- <figure class="dev"><div class="screen-wrap"><div class="screen"><div class="tile">
- <div class="zone"><b>y&lt;44 · taps swallowed</b></div>
- <div class="bell"><span class="b">&#128276;</span><span class="n">2</span></div>
- <div class="ctl">
- <div class="mark">&#10022;</div>
- <div class="pill">Sonnet</div>
- <div class="pill">Medium</div>
- </div>
- <div class="nm">payments</div>
- <div class="card" style="top:185px"><span class="k">&#8250; Fixed the webhook retry</span>
- Retries now back off instead of hammering the endpoint.</div>
- <div class="dots"><i></i><i class="on"></i><i></i><i></i></div>
- </div></div></div>
- <figcaption>
- <span class="name">Today</span><span class="tag bad">no machine anywhere</span>
- <span class="note">Name, engine mark, Model, Effort, recap. Nothing says whether
- <b>payments</b> is running on this laptop or on a computer in another room.</span>
- </figcaption>
-
- <!-- B: line under the name -->
- <figure class="dev"><div class="screen-wrap"><div class="screen"><div class="tile">
- <div class="ctl">
- <div class="mark">&#10022;</div>
- <div class="pill">Sonnet</div>
- <div class="pill">Medium</div>
- </div>
- <div class="nm">payments</div>
- <div class="sub" style="top:167px"><i class="dot remote"></i>office-imac</div>
- <div class="card" style="top:213px"><span class="k">&#8250; Fixed the webhook retry</span>
- Retries now back off instead of hammering the endpoint.</div>
- <div class="dots"><i></i><i class="on"></i><i></i><i></i></div>
- </div></div></div>
- <figcaption>
- <span class="name">A · A line under the name</span><span class="tag">costs 30 px</span>
- <span class="note">Exactly what the switcher shows, in the same order — name, then machine. Reads
- instantly and is the <b>same shape on both screens</b>. Pushes the recap card down ~30 px, which is
- real: the card's position came from Figma.</span>
- </figcaption>
-
- <!-- C: fourth pill -->
- <figure class="dev"><div class="screen-wrap"><div class="screen"><div class="tile">
- <div class="ctl">
- <div class="mark">&#10022;</div>
- <div class="pill mach"><i class="dot remote"></i>office-imac</div>
- <div class="pill">Sonnet</div>
- <div class="pill">Medium</div>
- </div>
- <div class="nm">payments</div>
- <div class="card" style="top:185px"><span class="k">&#8250; Fixed the webhook retry</span>
- Retries now back off instead of hammering the endpoint.</div>
- <div class="dots"><i></i><i class="on"></i><i></i><i></i></div>
- </div></div></div>
- <figcaption>
- <span class="name">B · A fourth pill in the row</span><span class="tag bad">does not fit</span>
- <span class="note">Free vertically, and that is its only virtue. Drawn honestly here the row is
- <b>~430 px on a 331 px chord</b> — both ends are off the glass. "Sonnet"+"Medium" already clipped
- their corners once and that is why the paddings are where they are.</span>
- </figcaption>
-
- <!-- D: machine folded into the engine mark's slot -->
- <figure class="dev"><div class="screen-wrap"><div class="screen"><div class="tile">
- <div class="ctl">
- <div class="pill mach"><span class="mark" style="width:26px;height:26px;font-size:20px">&#10022;</span>office-imac</div>
- <div class="pill">Sonnet</div>
- <div class="pill">Medium</div>
- </div>
- <div class="nm">payments</div>
- <div class="card" style="top:185px"><span class="k">&#8250; Fixed the webhook retry</span>
- Retries now back off instead of hammering the endpoint.</div>
- <div class="dots"><i></i><i class="on"></i><i></i><i></i></div>
- </div></div></div>
- <figcaption>
- <span class="name">C · Fold it into the engine mark</span><span class="tag">no vertical cost</span>
- <span class="note">The bare mark becomes a pill that carries the machine beside it, so the row keeps
- <b>three items, not four</b>. Fits — but the machine name has to clip to ~10 glyphs, and it puts
- identity in the row the eye reads as <i>settings</i>.</span>
- </figcaption>
-
- <!-- E: recommended — line under name, remote only -->
- <figure class="dev"><div class="screen-wrap"><div class="screen"><div class="tile">
- <div class="ctl">
- <div class="mark">&#10022;</div>
- <div class="pill">Sonnet</div>
- <div class="pill">Medium</div>
- </div>
- <div class="nm">device firmware</div>
- <div class="card" style="top:185px"><span class="k">&#8250; Flashed 0.0.43</span>
- Hash verified, the dial came back on the cable.</div>
- <div class="dots"><i class="on"></i><i></i><i></i><i></i></div>
- </div></div></div>
- <figcaption>
- <span class="name">D · Same as A, but only when it is <i>not</i> this computer</span>
- <span class="tag pick">recommended</span>
- <span class="note">A local agent (above) is <b>unchanged from today</b> — no line, card at its Figma
- position. A remote one gets the line, as in A. The tile only spends the 30 px on the agents where the
- answer is not the obvious one.</span>
- </figcaption>
-
-</div>
-
-<section class="group-title"><h2>As built — option A, real metrics</h2></section>
-<div class="grid">
-
- <figure class="dev"><div class="screen-wrap"><div class="screen"><div class="tile">
- <div class="ctl">
- <div class="mark">&#10022;</div>
- <div class="pill">Sonnet</div>
- <div class="pill">Medium</div>
- </div>
- <div class="nm" style="height:51px;line-height:51px">device firmware</div>
- <div class="sub" style="top:170px;line-height:35px"><i class="dot"></i>This computer</div>
- <div class="card" style="top:214px"><span class="k">&#8250; Flashed 0.0.43</span>
- Hash verified, the dial came back on the cable.</div>
- <div class="dots"><i class="on"></i><i></i><i></i><i></i></div>
- </div></div></div>
- <figcaption>
- <span class="name">Local agent — idle</span>
- <span class="note">Filled green dot, and the wheel's own words: <b>This computer</b>. Name occupies
- 117–168 (<code>geist_med_38</code> is 51 tall), machine line 170–205
- (<code>geist_reg_25</code> is 35, plus a 2 px gap).</span>
- </figcaption>
-
- <figure class="dev"><div class="screen-wrap"><div class="screen"><div class="tile">
- <div class="ctl">
- <div class="mark">&#10022;</div>
- <div class="pill">Opus</div>
- <div class="pill">High</div>
- </div>
- <div class="nm" style="height:51px;line-height:51px">payments</div>
- <div class="sub" style="top:170px;line-height:35px"><i class="dot remote"></i>office-imac</div>
- <div class="card" style="top:214px"><span class="k">&#8250; Fixed the webhook retry</span>
- Retries now back off instead of hammering the endpoint.</div>
- <div class="dots"><i></i><i class="on"></i><i></i><i></i></div>
- </div></div></div>
- <figcaption>
- <span class="name">Remote agent — idle</span>
- <span class="note">Hollow grey ring and the machine's name. The card sits at <b>214</b> where it used
- to sit at 177 — <b>37 px lower</b>, not the ~30 estimated before the fonts were measured.</span>
- </figcaption>
-
- <figure class="dev"><div class="screen-wrap"><div class="screen"><div class="tile">
- <div class="ctl" style="top:126px">
- <div class="mark">&#10022;</div>
- <div class="pill">Opus</div>
- <div class="pill">High</div>
- </div>
- <div class="nm" style="top:174px;height:51px;line-height:51px">payments</div>
- <div class="sub" style="top:227px;line-height:35px"><i class="dot remote"></i>office-imac</div>
- <div class="sub" style="top:274px;line-height:35px;color:var(--orange)">&#8250; Working&#8230; 1m 04s</div>
- <div class="sub" style="top:312px;line-height:35px;font-size:22px">Retries now back off instead&#8230;</div>
- <div class="dots"><i></i><i class="on"></i><i></i><i></i></div>
- </div></div></div>
- <figcaption>
- <span class="name">Remote agent — working</span>
- <span class="note">This state <b>centres</b> the whole [chips][name][status] group, so the extra line
- does not push anything off the top — it makes the centred block 37 px taller. The cost lands as
- <b>less headroom for a tall turn</b> (tool line + todo list), which is the overflow the layout
- comment already warns about.</span>
- </figcaption>
-
-</div>
-
-<section class="group-title"><h2>Trade-offs</h2></section>
-
-<table class="cmp">
- <tr><th>Option</th><th>Vertical cost</th><th>Fits the chord?</th><th>The honest objection</th></tr>
- <tr><td><b>A</b> line under the name</td><td>~30 px, always</td><td>yes — 384 wide at y=167</td>
- <td>Every tile pays, including the ones where the answer is "this computer, like everything else".</td></tr>
- <tr><td><b>B</b> fourth pill</td><td>none</td><td><b>no</b> — ~430 px on a 331 px chord</td>
- <td>Doesn't fit, and shortening the machine name enough to fit makes it unrecognisable.</td></tr>
- <tr><td><b>C</b> folded into the mark</td><td>none</td><td>tight — needs a ~10-glyph clip</td>
- <td>Puts identity in the row that means "what this agent is set to", next to two controls that open
- pickers. A machine name there looks tappable and isn't.</td></tr>
- <tr class="pick"><td><b>D</b> A, remote only</td><td>~30 px, remote tiles only</td><td>yes</td>
- <td>Two tile heights instead of one. The chip row already appears conditionally, so the layout
- copes — but it is a second reason for the body to move, and those interact.</td></tr>
-</table>
-
-<footer class="page">
- <p><b>Why not the top band.</b> <code>y 44–69</code> is the only unclaimed space and it is 25 px — enough
- for one <code>geist_reg_20</code> line. But the bell lands at <code>y 22–58</code> whenever a turn
- finishes, so that line would be clear most of the time and collide exactly when the user has just been
- notified. A layout that is correct until something happens is worse than one that always costs 30 px.</p>
- <p><b>Why "not this computer" and not "remote".</b> If D wins, the line should say the machine's name, and
- the local case should show nothing at all — the Machines wheel already treats the cabled machine as the
- unmarked default and names it <code>"This computer"</code> only when it has a row of its own
- (<code>machine_meta_line</code>). Marking the exception is the same rule, one screen along.</p>
- <p><b>The data is already there.</b> <code>project_t.machine_id</code> / <code>.machine</code> arrive with
- the agent list, and <code>cable_client_machine_id()</code> is this computer's id — so every option
- above is a rendering change with no new wire field. An older daemon sends <code>""</code>, which
- matches nothing and simply renders as today.</p>
-</footer>
-
-</body>
-</html>
diff --git a/device/harness/design/ui-mockups.html b/device/harness/design/ui-mockups.html
deleted file mode 100644
index e36f307c6..000000000
--- a/device/harness/design/ui-mockups.html
+++ /dev/null
@@ -1,513 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-<meta charset="UTF-8">
-<meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>Interns Commander — Device UI (current state) · design reference</title>
-<style>
- /* ---- Design tokens (mirror device/harness/main/ui/ui_screens.c) ---- */
- :root{
- --bg:#000000; --fg:#eaeaf0; --muted:#8a8a99; --card:#16161c; --card-press:#24242e;
- --accent:#5b8cff; --green:#35c46a; --red:#ff5a5a; --yellow:#f0b429; --orange:#ff8a4c;
- /* fonts: device uses "Arial Unicode" (Vietnamese) + Montserrat glyphs — approximated here */
- --sans: system-ui, -apple-system, "Helvetica Neue", Arial, sans-serif;
- --mont: "Montserrat", var(--sans);
- }
- *{box-sizing:border-box}
- html,body{margin:0;background:#0c0c10;color:#d8d8e0;font-family:var(--sans);-webkit-font-smoothing:antialiased}
- header.page{padding:32px 40px 8px}
- header.page h1{margin:0 0 6px;font-family:var(--mont);font-weight:700;font-size:26px;color:#fff}
- header.page p{margin:4px 0;max-width:900px;line-height:1.5;color:#a9a9b6;font-size:14px}
- header.page code{background:#1b1b22;padding:1px 6px;border-radius:5px;color:#c9d4ff;font-size:12px}
-
- /* tokens legend */
- .legend{display:flex;flex-wrap:wrap;gap:22px;padding:16px 40px 8px;align-items:flex-start}
- .legend .group{background:#111116;border:1px solid #20202a;border-radius:12px;padding:14px 16px}
- .legend h3{margin:0 0 10px;font-size:12px;letter-spacing:.06em;text-transform:uppercase;color:#8a8a99}
- .swatches{display:grid;grid-template-columns:repeat(2,minmax(140px,1fr));gap:8px 18px}
- .sw{display:flex;align-items:center;gap:8px;font-size:12px}
- .sw i{width:18px;height:18px;border-radius:5px;border:1px solid #2a2a34;flex:none}
- .sw b{color:#e6e6ee;font-weight:600}
- .sw span{color:#7d7d8a;font-variant-numeric:tabular-nums}
- .metrics{font-size:12px;line-height:1.7;color:#9a9aa8;max-width:340px}
- .metrics b{color:#d0d0da}
-
- /* gallery grid */
- section.group-title{padding:26px 40px 2px}
- section.group-title h2{margin:0;font-family:var(--mont);font-weight:600;font-size:15px;letter-spacing:.08em;
- text-transform:uppercase;color:#6f7cff}
- .grid{display:flex;flex-wrap:wrap;gap:34px 30px;padding:18px 40px 10px}
- figure.dev{margin:0;width:300px}
- /* the true 466 device, scaled to 300 for display */
- .screen-wrap{width:300px;height:300px;position:relative}
- .screen{position:absolute;top:0;left:0;width:466px;height:466px;transform:scale(.6437);transform-origin:top left;
- border-radius:50%;overflow:hidden;background:var(--bg);
- box-shadow:0 0 0 6px #17171d, 0 12px 34px rgba(0,0,0,.6)}
- figcaption{margin-top:12px}
- figcaption .name{font-weight:650;color:#eaeaf0;font-size:14px}
- figcaption .fn{font-family:var(--mont);font-size:11px;color:#7f8cff;background:#14141b;padding:1px 6px;border-radius:5px}
- figcaption .note{display:block;margin-top:5px;color:#8a8a96;font-size:12px;line-height:1.45}
-
- /* ---------- device-internal primitives (authored at true 466px) ---------- */
- .screen .safe{position:absolute;inset:0;display:flex;flex-direction:column;align-items:center;justify-content:center;
- padding:28px;text-align:center}
- .screen .col{display:flex;flex-direction:column;align-items:center}
- /* status bar overlay: TOP_MID +8, montserrat 14 */
- .statusbar{position:absolute;top:8px;left:0;right:0;display:flex;justify-content:center;align-items:center;gap:0;
- font-family:var(--mont);font-size:14px;color:var(--fg);letter-spacing:.02em;z-index:20}
- .statusbar.off{color:var(--muted)}
- .statusbar .seg{display:inline-flex;align-items:center;gap:5px;margin:0 8px}
- .statusbar svg{display:block}
- /* reconnect badge: TOP_MID +30, yellow, montserrat 14 */
- .recon{position:absolute;top:30px;left:0;right:0;text-align:center;color:var(--yellow);
- font-family:var(--mont);font-size:14px;z-index:19;display:flex;justify-content:center;align-items:center;gap:6px}
- /* page dots */
- .dots{position:absolute;bottom:8px;left:0;right:0;display:flex;justify-content:center;gap:8px}
- .dots i{width:6px;height:6px;border-radius:50%;background:var(--muted)}
- .dots i.on{background:var(--fg)}
-
- .t-fg{color:var(--fg)} .t-muted{color:var(--muted)} .t-accent{color:var(--accent)}
- .t-green{color:var(--green)} .t-red{color:var(--red)} .t-yellow{color:var(--yellow)} .t-orange{color:var(--orange)}
- .f20{font-size:20px} .f25{font-size:25px} .mont{font-family:var(--mont)}
- .m22{font-family:var(--mont);font-size:22px} .m40{font-family:var(--mont);font-size:40px}
-
- /* spinner */
- .spinner{width:72px;height:72px;border-radius:50%;border:6px solid #23232c;border-top-color:var(--accent)}
- /* cancel / creating pills */
- .pill{background:var(--card);border-radius:16px;padding:12px 24px;color:var(--fg);font-size:20px}
- .pill.abs-bottom{position:absolute;bottom:22px;left:50%;transform:translateX(-50%)}
- .creating{position:absolute;top:50%;left:50%;transform:translate(-50%,-50%);background:var(--card);
- border-radius:12px;padding:14px 20px;color:var(--accent);font-size:20px}
- .sending{position:absolute;bottom:34px;left:0;right:0;text-align:center;color:var(--accent);font-size:20px}
-
- /* project tile */
- .tile{position:absolute;inset:0;display:flex;flex-direction:column;align-items:center;justify-content:center;
- padding:28px;gap:12px;text-align:center}
- .hdr{display:flex;align-items:center;justify-content:center;gap:9px}
- .hdr .dot{width:10px;height:10px;border-radius:50%}
- .hdr .nm{font-size:25px;color:var(--fg)}
- .evlist{width:330px;display:flex;flex-direction:column;align-items:center;gap:14px}
- .evcard{width:100%;font-size:25px;line-height:1.15;text-align:center}
- .evcard.faded{opacity:.4}
- /* working status row: BOTTOM_MID -98 */
- .busy{position:absolute;left:0;right:0;bottom:98px;display:flex;justify-content:center;gap:5px;font-size:20px}
- /* stop / mic buttons: BOTTOM_MID -22 */
- .stop{position:absolute;bottom:22px;left:50%;transform:translateX(-50%);width:80px;height:80px;border-radius:14px;
- background:var(--red);display:flex;align-items:center;justify-content:center}
- .stop i{width:28px;height:28px;border-radius:4px;background:#fff}
- .mic{position:absolute;bottom:22px;left:50%;transform:translateX(-50%);width:88px;height:88px;border-radius:50%;
- background:var(--red);display:flex;align-items:center;justify-content:center}
- /* todo checklist */
- .todos{width:330px;display:flex;flex-direction:column;gap:7px;text-align:left}
- .todos .row{display:flex;align-items:center;gap:8px;font-size:20px;white-space:nowrap;overflow:hidden}
- .todos .g{width:12px;height:12px;border-radius:50%;flex:none}
- .todos .g.done{background:var(--green)}
- .todos .g.prog{background:var(--orange)}
- .todos .g.pend{background:transparent;border:2px solid var(--muted)}
-
- /* settings tile */
- .settings{position:absolute;inset:0;display:flex;flex-direction:column;align-items:center;justify-content:center;
- padding:54px 28px 80px;gap:10px}
- .settings .title{font-family:var(--mont);font-size:22px;color:var(--fg);display:flex;align-items:center;gap:8px}
- .settings .divider{width:36px;height:3px;border-radius:2px;background:var(--accent);margin-bottom:6px}
- .srow{width:100%;background:var(--card);border-radius:16px;padding:15px 16px;display:flex;align-items:center;gap:12px}
- .srow .ico{width:28px;display:flex;justify-content:center;color:var(--accent)}
- .srow .lbl{flex:1;font-size:20px;color:var(--fg);text-align:left}
- .srow .val{font-size:20px;color:var(--accent)}
- .srow .chev{color:var(--muted)}
-
- /* question screen */
- .q{position:absolute;inset:0;display:flex;flex-direction:column;align-items:center;justify-content:flex-start;
- padding:70px 54px 90px;gap:12px;text-align:center;overflow:hidden}
- .q .qmeta{font-size:20px;color:var(--muted)}
- .q .qtext{font-size:20px;color:var(--fg);line-height:1.25}
- .q .qhint{font-size:20px;color:var(--muted)}
- .qbtn{width:100%;border-radius:16px;padding:13px 10px;font-size:20px;line-height:1.15}
- .qbtn.accent{background:var(--accent);color:var(--bg)}
- .qbtn.card{background:var(--card);color:var(--fg)}
- .qbtn.green{background:var(--green);color:var(--bg)}
-
- /* reader */
- .reader{position:absolute;inset:0;padding:64px 68px;display:flex;align-items:center;justify-content:center}
- .reader p{margin:0;font-size:25px;color:var(--fg);line-height:1.35;text-align:center}
-</style>
-</head>
-<body>
-
-<header class="page">
- <h1>Interns Commander — Device UI (current state)</h1>
- <p><b>Round 466×466 AMOLED.</b> This is a <b>faithful reference of the UI as it ships today</b> — every
- stage, drawn with the real colors, fonts, sizes and layout pulled from
- <code>device/harness/main/ui/ui_screens.c</code>. It is the starting point for the design team to
- <b>polish</b>; nothing here is a proposal yet.</p>
- <p>Each frame is authored at true 466px and scaled to 300px for display, so proportions are exact. The
- <b>status bar</b> (top) and <b>page dots</b> (bottom) are persistent overlays shown on in-session screens.
- Fonts are approximated in the browser (device uses Arial Unicode for Vietnamese + Montserrat for
- titles/icons); icons are SVG approximations of the LVGL symbol glyphs.</p>
-</header>
-
-<div class="legend">
- <div class="group">
- <h3>Color tokens</h3>
- <div class="swatches">
- <div class="sw"><i style="background:#000"></i><b>COL_BG</b><span>#000000</span></div>
- <div class="sw"><i style="background:#eaeaf0"></i><b>COL_FG</b><span>#eaeaf0</span></div>
- <div class="sw"><i style="background:#8a8a99"></i><b>COL_MUTED</b><span>#8a8a99</span></div>
- <div class="sw"><i style="background:#16161c"></i><b>COL_CARD</b><span>#16161c</span></div>
- <div class="sw"><i style="background:#5b8cff"></i><b>COL_ACCENT</b><span>#5b8cff</span></div>
- <div class="sw"><i style="background:#35c46a"></i><b>COL_GREEN</b><span>#35c46a</span></div>
- <div class="sw"><i style="background:#ff5a5a"></i><b>COL_RED</b><span>#ff5a5a</span></div>
- <div class="sw"><i style="background:#f0b429"></i><b>COL_YELLOW</b><span>#f0b429</span></div>
- <div class="sw"><i style="background:#ff8a4c"></i><b>COL_ORANGE</b><span>#ff8a4c</span></div>
- <div class="sw"><i style="background:#24242e"></i><b>card pressed</b><span>#24242e</span></div>
- </div>
- </div>
- <div class="group">
- <h3>Type & metrics</h3>
- <div class="metrics">
- <b>Vietnamese body:</b> font_viet_20 (20px), font_viet_25 (25px)<br>
- <b>Titles / icons:</b> Montserrat 14 · 22 · 40<br>
- <b>Screen pad</b> 28 · <b>safe width</b> 330 · <b>card radius</b> 16<br>
- <b>Mic</b> 88×88 ● · <b>Stop</b> 80×80 r14 (inner 28×28) ▪<br>
- <b>Status bar</b> +8 · <b>Reconnect</b> +30 · <b>dots</b> 6×6 gap 8<br>
- <b>Busy row</b> bottom −98 · <b>Sending</b> bottom −34
- </div>
- </div>
-</div>
-
-<!-- ============================= CONNECTION / BOOT ============================= -->
-<section class="group-title"><h2>Connection &amp; boot</h2></section>
-<div class="grid">
-
- <!-- 1. Provisioning -->
- <figure class="dev"><div class="screen-wrap"><div class="screen">
- <div class="safe">
- <div class="col f20 t-fg" style="line-height:1.5">
- <span>Join WiFi</span><span class="t-accent">Interns-Setup</span>
- <span style="height:16px"></span>
- <span>then open</span><span class="t-accent">192.168.100.1</span>
- </div>
- </div>
- <div class="pill abs-bottom">Cancel</div>
- </div></div>
- <figcaption><span class="name">Provisioning / WiFi portal</span> <span class="fn">ui_show_provisioning</span>
- <span class="note">SoftAP setup screen; Cancel pill shown only when cancelable → reboots.</span></figcaption>
- </figure>
-
- <!-- 2. Pairing -->
- <figure class="dev"><div class="screen-wrap"><div class="screen">
- <div class="safe">
- <div class="col">
- <span class="m22 t-accent">Pair on the web</span>
- <span style="height:10px"></span>
- <span class="m40 t-fg" style="letter-spacing:4px">AB-1234</span>
- <span style="height:10px"></span>
- <span class="f20 t-muted">enter on the web · 4:59</span>
- </div>
- </div>
- </div></div>
- <figcaption><span class="name">Pairing</span> <span class="fn">ui_show_pairing</span>
- <span class="note">Big code (Montserrat 40, +4 letter-spacing) + 5-min countdown.</span></figcaption>
- </figure>
-
- <!-- 3. Connecting -->
- <figure class="dev"><div class="screen-wrap"><div class="screen">
- <div class="safe">
- <div class="col" style="gap:10px">
- <div class="spinner"></div>
- <span class="f20 t-fg">Linking to agent…</span>
- </div>
- </div>
- </div></div>
- <figcaption><span class="name">Connecting / Linking</span> <span class="fn">ui_show_connecting</span>
- <span class="note">72px spinner + step label ("Starting…", "Linking to agent…", "Connecting…").</span></figcaption>
- </figure>
-
- <!-- 4. Error -->
- <figure class="dev"><div class="screen-wrap"><div class="screen">
- <div class="safe">
- <div class="col" style="gap:10px">
- <span class="m22 t-red" id="ic-warn-wrap">⚠ Error</span>
- <span class="f20 t-fg">Server rejected the API key.<br>Re-pair with the correct key.</span>
- </div>
- </div>
- </div></div>
- <figcaption><span class="name">Error</span> <span class="fn">ui_show_error</span>
- <span class="note">Red title (warning glyph) + detail; auto-leaves to projects on WS reconnect.</span></figcaption>
- </figure>
-</div>
-
-<!-- ============================= PROJECTS TILEVIEW ============================= -->
-<section class="group-title"><h2>Projects tileview</h2></section>
-<div class="grid">
-
- <!-- 5. Empty -->
- <figure class="dev"><div class="screen-wrap"><div class="screen sb-host">
- <div class="safe"><span class="f20 t-muted">waiting for projects…</span></div>
- <div class="dots"><i class="on"></i></div>
- </div></div>
- <figcaption><span class="name">Empty (no projects)</span> <span class="fn">ui_show_projects</span>
- <span class="note">Placeholder until the first project arrives.</span></figcaption>
- </figure>
-
- <!-- 6. Completed with recap -->
- <figure class="dev"><div class="screen-wrap"><div class="screen sb-host">
- <div class="tile">
- <div class="hdr"><span class="dot" style="background:var(--green)"></span><span class="nm">Landing page</span></div>
- <div class="evlist"><div class="evcard t-fg">Added a responsive hero section with CTA and mobile nav.</div></div>
- </div>
- <div class="dots"><i class="on"></i><i></i><i></i></div>
- </div></div>
- <figcaption><span class="name">Project — completed (recap)</span> <span class="fn">ui_project_emit · summary</span>
- <span class="note">Recap headline shown in full; tap opens the full body in the reader. <b>NEW field: recap.</b></span></figcaption>
- </figure>
-
- <!-- 7. Event-card kind variants -->
- <figure class="dev"><div class="screen-wrap"><div class="screen">
- <div class="safe" style="justify-content:center">
- <div class="col f20" style="gap:14px;line-height:1.1">
- <span class="t-accent">› Editing app/page.tsx</span>
- <span class="t-yellow">? Which auth provider?</span>
- <span class="t-green">✓ Build passed</span>
- <span class="t-fg">Summary / say (neutral)</span>
- <span class="t-red">✗ Type error in api.ts</span>
- </div>
- </div>
- </div></div>
- <figcaption><span class="name">Event-card kind styles</span> <span class="fn">kind_style</span>
- <span class="note">Per-kind marker+color. <b>Live now:</b> summary / done / error. <b>History-replay only:</b> say / act / ask.</span></figcaption>
- </figure>
-
- <!-- 8. Processing -->
- <figure class="dev"><div class="screen-wrap"><div class="screen sb-host">
- <div class="tile">
- <div class="hdr"><span class="dot" style="background:var(--green)"></span><span class="nm">Landing page</span></div>
- <div class="evlist"><div class="evcard t-fg faded">Added a responsive hero section with CTA and mobile nav.</div></div>
- </div>
- <div class="busy"><span class="t-orange">Simmering…</span><span class="t-muted">(34s · 2.2k tokens)</span></div>
- <div class="stop"><i></i></div>
- <div class="dots"><i class="on"></i><i></i><i></i></div>
- </div></div>
- <figcaption><span class="name">Project — processing</span> <span class="fn">ui_project_emit · processing</span>
- <span class="note">Rotating gerund + elapsed·tokens; card faded to 40%; STOP button cancels the turn. <b>NEW: tokens.</b></span></figcaption>
- </figure>
-
- <!-- 9. Processing + todos -->
- <figure class="dev"><div class="screen-wrap"><div class="screen sb-host">
- <div class="tile" style="justify-content:center">
- <div class="hdr"><span class="dot" style="background:var(--green)"></span><span class="nm">Landing page</span></div>
- <div class="todos">
- <div class="row"><span class="g done"></span><span class="t-muted">Scaffold Next.js app</span></div>
- <div class="row"><span class="g prog"></span><span class="t-orange">Build the hero section</span></div>
- <div class="row"><span class="g pend"></span><span class="t-fg">Wire up the contact form</span></div>
- </div>
- </div>
- <div class="busy"><span class="t-orange">Wrangling…</span><span class="t-muted">(1m 05s · 4.1k tokens)</span></div>
- <div class="stop"><i></i></div>
- <div class="dots"><i class="on"></i><i></i><i></i></div>
- </div></div>
- <figcaption><span class="name">Project — processing + checklist</span> <span class="fn">ui_project_set_todos</span>
- <span class="note">3-row window (green done · orange in-progress, pulsing · grey-ring pending); hides the event card. <b>NEW: todos.</b></span></figcaption>
- </figure>
-
- <!-- 10. Voice recording -->
- <figure class="dev"><div class="screen-wrap"><div class="screen sb-host">
- <div class="tile">
- <div class="hdr"><span class="dot" style="background:var(--green)"></span><span class="nm">Landing page</span></div>
- <div class="evlist"><div class="evcard t-fg">Added a responsive hero section with CTA and mobile nav.</div></div>
- </div>
- <div class="mic">
- <svg width="30" height="46" viewBox="0 0 30 46"><rect x="4" y="0" width="22" height="32" rx="11" fill="#fff"/><rect x="13" y="30" width="4" height="9" rx="2" fill="#fff"/><rect x="4" y="39" width="22" height="4" rx="2" fill="#fff"/></svg>
- </div>
- <div class="dots"><i class="on"></i><i></i><i></i></div>
- </div></div>
- <figcaption><span class="name">Project — voice recording</span> <span class="fn">ui_voice_start</span>
- <span class="note">Red 88px mic button while holding-to-talk; tap to stop &amp; send.</span></figcaption>
- </figure>
-
- <!-- 11. Sending -->
- <figure class="dev"><div class="screen-wrap"><div class="screen sb-host">
- <div class="tile">
- <div class="hdr"><span class="dot" style="background:var(--green)"></span><span class="nm">Landing page</span></div>
- <div class="evlist"><div class="evcard t-fg">Added a responsive hero section with CTA and mobile nav.</div></div>
- </div>
- <div class="sending">Sending…</div>
- <div class="dots"><i class="on"></i><i></i><i></i></div>
- </div></div>
- <figcaption><span class="name">Voice clip uploading</span> <span class="fn">s_sending_lbl</span>
- <span class="note">Animated "Sending…" while the recorded clip is in flight to STT.</span></figcaption>
- </figure>
-
- <!-- 12. Creating -->
- <figure class="dev"><div class="screen-wrap"><div class="screen sb-host">
- <div class="tile">
- <div class="hdr"><span class="dot" style="background:var(--green)"></span><span class="nm">Landing page</span></div>
- <div class="evlist"><div class="evcard t-fg">Added a responsive hero section with CTA and mobile nav.</div></div>
- </div>
- <div class="creating">Creating…</div>
- <div class="dots"><i class="on"></i><i></i><i></i></div>
- </div></div>
- <figcaption><span class="name">Creating a project</span> <span class="fn">ui_set_creating</span>
- <span class="note">Animated pill during the new-project HTTP round-trip.</span></figcaption>
- </figure>
-
- <!-- 13. Reconnecting -->
- <figure class="dev"><div class="screen-wrap"><div class="screen sb-host">
- <div class="recon">Reconnecting
- <svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="#f0b429" stroke-width="2.4"><path d="M20 11a8 8 0 1 0-1.5 4.7"/><path d="M20 4v6h-6" stroke-linecap="round" stroke-linejoin="round"/></svg>
- </div>
- <div class="tile">
- <div class="hdr"><span class="dot" style="background:var(--yellow)"></span><span class="nm">Landing page</span></div>
- <div class="evlist"><div class="evcard t-fg">Added a responsive hero section with CTA and mobile nav.</div></div>
- </div>
- <div class="dots"><i class="on"></i><i></i><i></i></div>
- </div></div>
- <figcaption><span class="name">Reconnecting</span> <span class="fn">s_reconnect_badge</span>
- <span class="note">Yellow badge when WS drops but WiFi is up; header dot turns yellow.</span></figcaption>
- </figure>
-</div>
-
-<!-- ============================= SETTINGS ============================= -->
-<section class="group-title"><h2>Settings</h2></section>
-<div class="grid">
- <figure class="dev"><div class="screen-wrap"><div class="screen sb-host">
- <div class="settings">
- <div class="title">
- <svg width="20" height="20" viewBox="0 0 24 24" fill="#eaeaf0"><path d="M12 8a4 4 0 1 0 0 8 4 4 0 0 0 0-8zm9 4a7 7 0 0 0-.1-1.2l2-1.6-2-3.4-2.4 1a7 7 0 0 0-2-1.2L14 2h-4l-.5 2.6a7 7 0 0 0-2 1.2l-2.4-1-2 3.4 2 1.6A7 7 0 0 0 3 12c0 .4 0 .8.1 1.2l-2 1.6 2 3.4 2.4-1c.6.5 1.3.9 2 1.2L10 22h4l.5-2.6c.7-.3 1.4-.7 2-1.2l2.4 1 2-3.4-2-1.6c.1-.4.1-.8.1-1.2z"/></svg>
- Settings
- </div>
- <div class="divider"></div>
- <div class="srow">
- <span class="ico"><svg width="20" height="20" viewBox="0 0 24 24" fill="#5b8cff"><path d="M3 10v4h4l5 5V5L7 10H3zm13.5 2a4.5 4.5 0 0 0-2.5-4v8a4.5 4.5 0 0 0 2.5-4z"/></svg></span>
- <span class="lbl">Voice</span><span class="val">Tiếng Việt</span>
- </div>
- <div class="srow">
- <span class="ico"><svg width="20" height="16" viewBox="0 0 24 20" fill="#5b8cff"><path d="M12 18l3-3a4.2 4.2 0 0 0-6 0l3 3zm0-12c3 0 5.7 1.2 7.6 3.1l2-2A13.4 13.4 0 0 0 12 2 13.4 13.4 0 0 0 2.4 6.1l2 2A10.5 10.5 0 0 1 12 6zm0 6c1.4 0 2.7.5 3.7 1.5l2-2A9 9 0 0 0 12 9a9 9 0 0 0-5.7 2.5l2 2c1-1 2.3-1.5 3.7-1.5z"/></svg></span>
- <span class="lbl">WiFi</span>
- </div>
- <div class="srow">
- <span class="ico"><svg width="20" height="20" viewBox="0 0 24 24" fill="#5b8cff"><path d="M11 5h2v6h6v2h-6v6h-2v-6H5v-2h6z"/></svg></span>
- <span class="lbl">New project</span>
- </div>
- </div>
- <div class="dots"><i></i><i></i><i class="on"></i></div>
- </div></div>
- <figcaption><span class="name">Settings tile</span> <span class="fn">rebuild_settings_tile</span>
- <span class="note">Last swipe tile: gear title + accent divider + 3 rows (Voice shows current language; WiFi &amp; New project).</span></figcaption>
- </figure>
-</div>
-
-<!-- ============================= ASK-USER-QUESTION ============================= -->
-<section class="group-title"><h2>AskUserQuestion (agent asks · user answers on device)</h2></section>
-<div class="grid">
-
- <!-- 15. Single-select -->
- <figure class="dev"><div class="screen-wrap"><div class="screen">
- <div class="q">
- <span class="qmeta">Q 1/2</span>
- <span class="qtext">Which package manager?</span>
- <div class="qbtn accent">Speak answer</div>
- <div class="qbtn card">npm</div>
- <div class="qbtn card">pnpm</div>
- </div>
- </div></div>
- <figcaption><span class="name">Question — single-select</span> <span class="fn">ui_question_show</span>
- <span class="note">"Speak answer" (accent) always first, then option cards.</span></figcaption>
- </figure>
-
- <!-- 16. Multi-select -->
- <figure class="dev"><div class="screen-wrap"><div class="screen">
- <div class="q">
- <span class="qtext">Pick the features</span>
- <div class="qbtn accent">Speak answer</div>
- <span class="qhint">Or pick one or more, then Done</span>
- <div class="qbtn green">✓ Auth</div>
- <div class="qbtn card">&nbsp;&nbsp;Payments</div>
- <div class="qbtn green">✓ Done — Send</div>
- </div>
- </div></div>
- <figcaption><span class="name">Question — multi-select</span> <span class="fn">q_render (multi)</span>
- <span class="note">Selected options go green with ✓; "Done — Send" submits.</span></figcaption>
- </figure>
-
- <!-- 17. Voice: listening -->
- <figure class="dev"><div class="screen-wrap"><div class="screen">
- <div class="q" style="justify-content:center">
- <span class="qtext t-yellow">Listening…</span>
- <div class="qbtn green">✓ Stop &amp; transcribe</div>
- </div>
- </div></div>
- <figcaption><span class="name">Voice answer — listening</span> <span class="fn">q_voice_tap</span>
- <span class="note">Recording the spoken answer.</span></figcaption>
- </figure>
-
- <!-- 18. Voice: transcribing -->
- <figure class="dev"><div class="screen-wrap"><div class="screen">
- <div class="q" style="justify-content:center">
- <span class="qtext t-muted">Transcribing…</span>
- </div>
- </div></div>
- <figcaption><span class="name">Voice answer — transcribing</span> <span class="fn">q_voice_stop_tap</span>
- <span class="note">Waiting for STT result.</span></figcaption>
- </figure>
-
- <!-- 19. Voice: result -->
- <figure class="dev"><div class="screen-wrap"><div class="screen">
- <div class="q" style="justify-content:center">
- <span class="qtext">You said:<br>"use pnpm and enable auth"</span>
- <div class="qbtn green">✓ Use</div>
- <div class="qbtn accent">Redo</div>
- </div>
- </div></div>
- <figcaption><span class="name">Voice answer — result</span> <span class="fn">ui_question_voice_result</span>
- <span class="note">Transcript preview + Use / Redo.</span></figcaption>
- </figure>
-
- <!-- 20. Voice: failure -->
- <figure class="dev"><div class="screen-wrap"><div class="screen">
- <div class="q" style="justify-content:center">
- <span class="qtext t-red">Didn't catch that</span>
- <div class="qbtn accent">Redo</div>
- </div>
- </div></div>
- <figcaption><span class="name">Voice answer — failure</span> <span class="fn">ui_question_voice_result (empty)</span>
- <span class="note">Empty/too-short transcript → retry.</span></figcaption>
- </figure>
-</div>
-
-<!-- ============================= READER ============================= -->
-<section class="group-title"><h2>Reader (tap an event card)</h2></section>
-<div class="grid">
- <figure class="dev"><div class="screen-wrap"><div class="screen">
- <div class="reader"><p>Added a responsive hero section with a CTA button and a mobile hamburger nav.
- Refactored the layout to a CSS grid and fixed the overflow on small screens.</p></div>
- </div></div>
- <figcaption><span class="name">Reader — full text</span> <span class="fn">ev_card_tap / scr_reader</span>
- <span class="note">Full event body (font_viet_25, centered); tap anywhere returns to the project.</span></figcaption>
- </figure>
-</div>
-
-<!-- ============================= HANDOFF NOTES ============================= -->
-<section class="group-title"><h2>Notes for the design team</h2></section>
-<div class="legend">
- <div class="group" style="max-width:900px">
- <div class="metrics" style="max-width:none">
- <b>What's new since the old say/act/ask stream</b> — the <b>recap headline</b> (the one-line summary on
- the project tile) and the <b>todo checklist</b> (green done / orange in-progress / grey-ring pending),
- plus a live <b>token counter</b> in the processing row. All three already render on-device.<br><br>
- <b>Live event kinds today:</b> <span class="t-orange">processing</span> (working row + tokens + todos),
- <span class="t-fg">summary</span> (recap tile card), <span class="t-green">done</span>,
- <span class="t-red">error</span>. The <span class="t-accent">say / act / ask</span> styles still exist
- but are only seen when replaying history after a restart.<br><br>
- <b>Known gap worth a design call:</b> after a device <b>restart</b>, the history-restore path drops the
- <code>recap</code> and <code>todos</code> — restored cards fall back to plain text and no checklist is
- rebuilt. Consider how a restored project should look.<br><br>
- <b>Font constraint:</b> the Vietnamese font only covers Latin + Vietnamese + a few glyphs (› ✓ ✗). All
- agent text is UTF-8-filtered to that set, so emoji / CJK are stripped on-device — mockups should avoid
- relying on them.
- </div>
- </div>
-</div>
-
-</body>
-</html>
diff --git a/docs/architecture.md b/docs/architecture.md
index 63608c202..9a5887e1b 100644
--- a/docs/architecture.md
+++ b/docs/architecture.md
@@ -78,5 +78,5 @@ and Boss mode routes it. A voice turn can carry a mode — `/goal` runs an instr
Firmware updates travel over the same cable in 16 KB credit windows, offered from the published
metadata and never for a dev build. `harness flash` re-flashes a device from a USB port. The firmware
-is ESP-IDF ≥ 5.5 under [`device/harness/`](device/harness/) (`idf.py set-target esp32s3 &&
+is ESP-IDF ≥ 5.5 under [`device/harness-device/firmware/`](device/harness-device/firmware/) (`idf.py set-target esp32s3 &&
idf.py build`); `make device-test` runs the host-side tests with no board attached.
diff --git a/docs/development.md b/docs/development.md
index 3a5a33bc1..c5c19da9d 100644
--- a/docs/development.md
+++ b/docs/development.md
@@ -7,7 +7,7 @@ desktop/ the app (Flutter; macOS first). third_party/xterm is the patched ter
cli/ the harness daemon and CLI (TypeScript, one bundle). src/engines/ is one folder per engine
backend/ the relay (Node, Prisma/MongoDB, Redis)
provider/ the API-provider spec, reference and example providers, conformance runner
-device/ firmware for the Harness device (ESP-IDF, device/harness)
+device/ firmware for the Harness device (ESP-IDF, device/harness-device/firmware)
store/ harnesses, shared viewers, the registry, Hello World, starter, schemas, and author tools
```