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.
TypeScript 3d-modelingagent-frameworkagent-harnessai-agentscadclaude-codecodexcoding-agentsdeveloper-toolsesp32game-developmentmcp-servermulti-agentopen-hardwareopencodeopenharnesspcbroboticsterminaltmux
Move the firmware to device/harness-device/firmware, and drop its design/ folder
0xdiego25d5a5178d43a8
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.mdindex 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 agreediff --git a/Makefile b/Makefileindex 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.shdiff --git a/README.md b/README.mdindex 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 currentboards and build commands.https://github.com/user-attachments/assets/97848065-61c6-40df-be66-a8247f69aa4cdiff --git a/cli/scripts/sync-cable-vectors.sh b/cli/scripts/sync-cable-vectors.shindex 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 pipefailhere="$(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" ]; thenecho "source vectors not found: $src"diff --git a/cli/src/cable/cableFrame.spec.ts b/cli/src/cable/cableFrame.spec.tsindex 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.tsindex 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.tsindex 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.txtindex 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/.gitignoresimilarity index 100%rename from device/harness/.gitignorerename to device/harness-device/firmware/.gitignorediff --git a/device/harness/CMakeLists.txt b/device/harness-device/firmware/CMakeLists.txtsimilarity index 100%rename from device/harness/CMakeLists.txtrename to device/harness-device/firmware/CMakeLists.txtdiff --git a/device/harness/README.md b/device/harness-device/firmware/README.mdsimilarity index 98%rename from device/harness/README.mdrename to device/harness-device/firmware/README.mdindex 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 MCUInstall and activate ESP-IDF 5.5 or newer. From the repository root:```bash-cd device/harness+cd device/harness-device/firmwareidf.py set-target esp32s3idf.py buildidf.py -p PORT flash monitordiff --git a/device/harness/RELEASE.md b/device/harness-device/firmware/RELEASE.mdsimilarity index 95%rename from device/harness/RELEASE.mdrename to device/harness-device/firmware/RELEASE.mdindex 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 + uploadmake 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 → **gitcommit + push** the `version.txt` bump). You can call the script directly too. It auto-sources the ESP-IDF envfrom `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 themin 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 3to 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`, manifestdiff --git a/device/harness/device-stages.html b/device/harness-device/firmware/device-stages.htmlsimilarity index 100%rename from device/harness/device-stages.htmlrename to device/harness-device/firmware/device-stages.htmldiff --git a/device/harness/docs/INTERNAL_RAM_OPTIMIZATION.md b/device/harness-device/firmware/docs/INTERNAL_RAM_OPTIMIZATION.mdsimilarity index 99%rename from device/harness/docs/INTERNAL_RAM_OPTIMIZATION.mdrename to device/harness-device/firmware/docs/INTERNAL_RAM_OPTIMIZATION.mdindex 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/firmwaresource ~/esp/esp-idf/export.shidf.py -B build-arm buildidf.py -B build-arm sizediff --git a/device/harness/docs/UI_FLOWS.md b/device/harness-device/firmware/docs/UI_FLOWS.mdsimilarity index 100%rename from device/harness/docs/UI_FLOWS.mdrename to device/harness-device/firmware/docs/UI_FLOWS.mddiff --git a/device/harness/docs/UI_REDESIGN.md b/device/harness-device/firmware/docs/UI_REDESIGN.mdsimilarity index 100%rename from device/harness/docs/UI_REDESIGN.mdrename to device/harness-device/firmware/docs/UI_REDESIGN.mddiff --git a/device/harness/fonts/Geist-Medium.ttf b/device/harness-device/firmware/fonts/Geist-Medium.ttfsimilarity index 100%rename from device/harness/fonts/Geist-Medium.ttfrename to device/harness-device/firmware/fonts/Geist-Medium.ttfdiff --git a/device/harness/fonts/Geist-Regular.ttf b/device/harness-device/firmware/fonts/Geist-Regular.ttfsimilarity index 100%rename from device/harness/fonts/Geist-Regular.ttfrename to device/harness-device/firmware/fonts/Geist-Regular.ttfdiff --git a/device/harness/fonts/Geist-SemiBold.ttf b/device/harness-device/firmware/fonts/Geist-SemiBold.ttfsimilarity index 100%rename from device/harness/fonts/Geist-SemiBold.ttfrename to device/harness-device/firmware/fonts/Geist-SemiBold.ttfdiff --git a/device/harness/fonts/OFL.txt b/device/harness-device/firmware/fonts/OFL.txtsimilarity index 100%rename from device/harness/fonts/OFL.txtrename to device/harness-device/firmware/fonts/OFL.txtdiff --git a/device/harness/main/CMakeLists.txt b/device/harness-device/firmware/main/CMakeLists.txtsimilarity index 100%rename from device/harness/main/CMakeLists.txtrename to device/harness-device/firmware/main/CMakeLists.txtdiff --git a/device/harness/main/app_main.c b/device/harness-device/firmware/main/app_main.csimilarity index 100%rename from device/harness/main/app_main.crename to device/harness-device/firmware/main/app_main.cdiff --git a/device/harness/main/audio_capture.c b/device/harness-device/firmware/main/audio_capture.csimilarity index 100%rename from device/harness/main/audio_capture.crename to device/harness-device/firmware/main/audio_capture.cdiff --git a/device/harness/main/audio_capture.h b/device/harness-device/firmware/main/audio_capture.hsimilarity index 100%rename from device/harness/main/audio_capture.hrename to device/harness-device/firmware/main/audio_capture.hdiff --git a/device/harness/main/audio_client.c b/device/harness-device/firmware/main/audio_client.csimilarity index 100%rename from device/harness/main/audio_client.crename to device/harness-device/firmware/main/audio_client.cdiff --git a/device/harness/main/audio_client.h b/device/harness-device/firmware/main/audio_client.hsimilarity index 100%rename from device/harness/main/audio_client.hrename to device/harness-device/firmware/main/audio_client.hdiff --git a/device/harness/main/board/board.c b/device/harness-device/firmware/main/board/board.csimilarity index 100%rename from device/harness/main/board/board.crename to device/harness-device/firmware/main/board/board.cdiff --git a/device/harness/main/board/board.h b/device/harness-device/firmware/main/board/board.hsimilarity index 100%rename from device/harness/main/board/board.hrename to device/harness-device/firmware/main/board/board.hdiff --git a/device/harness/main/board/board_i2c.c b/device/harness-device/firmware/main/board/board_i2c.csimilarity index 100%rename from device/harness/main/board/board_i2c.crename to device/harness-device/firmware/main/board/board_i2c.cdiff --git a/device/harness/main/board/board_i2c.h b/device/harness-device/firmware/main/board/board_i2c.hsimilarity index 100%rename from device/harness/main/board/board_i2c.hrename to device/harness-device/firmware/main/board/board_i2c.hdiff --git a/device/harness/main/board/board_pins.h b/device/harness-device/firmware/main/board/board_pins.hsimilarity index 100%rename from device/harness/main/board/board_pins.hrename to device/harness-device/firmware/main/board/board_pins.hdiff --git a/device/harness/main/board/board_probe.c b/device/harness-device/firmware/main/board/board_probe.csimilarity index 100%rename from device/harness/main/board/board_probe.crename to device/harness-device/firmware/main/board/board_probe.cdiff --git a/device/harness/main/board/board_probe.h b/device/harness-device/firmware/main/board/board_probe.hsimilarity index 100%rename from device/harness/main/board/board_probe.hrename to device/harness-device/firmware/main/board/board_probe.hdiff --git a/device/harness/main/board/board_table.c b/device/harness-device/firmware/main/board/board_table.csimilarity index 100%rename from device/harness/main/board/board_table.crename to device/harness-device/firmware/main/board/board_table.cdiff --git a/device/harness/main/board/power.c b/device/harness-device/firmware/main/board/power.csimilarity index 100%rename from device/harness/main/board/power.crename to device/harness-device/firmware/main/board/power.cdiff --git a/device/harness/main/board/power.h b/device/harness-device/firmware/main/board/power.hsimilarity index 100%rename from device/harness/main/board/power.hrename to device/harness-device/firmware/main/board/power.hdiff --git a/device/harness/main/cable_client.c b/device/harness-device/firmware/main/cable_client.csimilarity index 100%rename from device/harness/main/cable_client.crename to device/harness-device/firmware/main/cable_client.cdiff --git a/device/harness/main/cable_client.h b/device/harness-device/firmware/main/cable_client.hsimilarity index 100%rename from device/harness/main/cable_client.hrename to device/harness-device/firmware/main/cable_client.hdiff --git a/device/harness/main/cable_frame.c b/device/harness-device/firmware/main/cable_frame.csimilarity index 100%rename from device/harness/main/cable_frame.crename to device/harness-device/firmware/main/cable_frame.cdiff --git a/device/harness/main/cable_frame.h b/device/harness-device/firmware/main/cable_frame.hsimilarity index 100%rename from device/harness/main/cable_frame.hrename to device/harness-device/firmware/main/cable_frame.hdiff --git a/device/harness/main/cable_link.c b/device/harness-device/firmware/main/cable_link.csimilarity index 100%rename from device/harness/main/cable_link.crename to device/harness-device/firmware/main/cable_link.cdiff --git a/device/harness/main/cable_link.h b/device/harness-device/firmware/main/cable_link.hsimilarity index 100%rename from device/harness/main/cable_link.hrename to device/harness-device/firmware/main/cable_link.hdiff --git a/device/harness/main/cable_machines.c b/device/harness-device/firmware/main/cable_machines.csimilarity index 100%rename from device/harness/main/cable_machines.crename to device/harness-device/firmware/main/cable_machines.cdiff --git a/device/harness/main/cable_machines.h b/device/harness-device/firmware/main/cable_machines.hsimilarity index 100%rename from device/harness/main/cable_machines.hrename to device/harness-device/firmware/main/cable_machines.hdiff --git a/device/harness/main/config_store.c b/device/harness-device/firmware/main/config_store.csimilarity index 100%rename from device/harness/main/config_store.crename to device/harness-device/firmware/main/config_store.cdiff --git a/device/harness/main/config_store.h b/device/harness-device/firmware/main/config_store.hsimilarity index 100%rename from device/harness/main/config_store.hrename to device/harness-device/firmware/main/config_store.hdiff --git a/device/harness/main/device_mac.c b/device/harness-device/firmware/main/device_mac.csimilarity index 100%rename from device/harness/main/device_mac.crename to device/harness-device/firmware/main/device_mac.cdiff --git a/device/harness/main/device_mac.h b/device/harness-device/firmware/main/device_mac.hsimilarity index 100%rename from device/harness/main/device_mac.hrename to device/harness-device/firmware/main/device_mac.hdiff --git a/device/harness/main/fw_update.c b/device/harness-device/firmware/main/fw_update.csimilarity index 100%rename from device/harness/main/fw_update.crename to device/harness-device/firmware/main/fw_update.cdiff --git a/device/harness/main/fw_update.h b/device/harness-device/firmware/main/fw_update.hsimilarity index 100%rename from device/harness/main/fw_update.hrename to device/harness-device/firmware/main/fw_update.hdiff --git a/device/harness/main/idf_component.yml b/device/harness-device/firmware/main/idf_component.ymlsimilarity index 91%rename from device/harness/main/idf_component.ymlrename to device/harness-device/firmware/main/idf_component.ymlindex 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.csimilarity index 100%rename from device/harness/main/last_words.crename to device/harness-device/firmware/main/last_words.cdiff --git a/device/harness/main/last_words.h b/device/harness-device/firmware/main/last_words.hsimilarity index 100%rename from device/harness/main/last_words.hrename to device/harness-device/firmware/main/last_words.hdiff --git a/device/harness/main/provisioned_config.h.example b/device/harness-device/firmware/main/provisioned_config.h.examplesimilarity index 100%rename from device/harness/main/provisioned_config.h.examplerename to device/harness-device/firmware/main/provisioned_config.h.examplediff --git a/device/harness/main/ptt.c b/device/harness-device/firmware/main/ptt.csimilarity index 100%rename from device/harness/main/ptt.crename to device/harness-device/firmware/main/ptt.cdiff --git a/device/harness/main/ptt.h b/device/harness-device/firmware/main/ptt.hsimilarity index 100%rename from device/harness/main/ptt.hrename to device/harness-device/firmware/main/ptt.hdiff --git a/device/harness/main/ram_telemetry.c b/device/harness-device/firmware/main/ram_telemetry.csimilarity index 100%rename from device/harness/main/ram_telemetry.crename to device/harness-device/firmware/main/ram_telemetry.cdiff --git a/device/harness/main/ram_telemetry.h b/device/harness-device/firmware/main/ram_telemetry.hsimilarity index 100%rename from device/harness/main/ram_telemetry.hrename to device/harness-device/firmware/main/ram_telemetry.hdiff --git a/device/harness/main/ui/carousel_ring.c b/device/harness-device/firmware/main/ui/carousel_ring.csimilarity index 100%rename from device/harness/main/ui/carousel_ring.crename to device/harness-device/firmware/main/ui/carousel_ring.cdiff --git a/device/harness/main/ui/carousel_ring.h b/device/harness-device/firmware/main/ui/carousel_ring.hsimilarity index 100%rename from device/harness/main/ui/carousel_ring.hrename to device/harness-device/firmware/main/ui/carousel_ring.hdiff --git a/device/harness/main/ui/display.c b/device/harness-device/firmware/main/ui/display.csimilarity index 100%rename from device/harness/main/ui/display.crename to device/harness-device/firmware/main/ui/display.cdiff --git a/device/harness/main/ui/display.h b/device/harness-device/firmware/main/ui/display.hsimilarity index 100%rename from device/harness/main/ui/display.hrename to device/harness-device/firmware/main/ui/display.hdiff --git a/device/harness/main/ui/geist_med_28.c b/device/harness-device/firmware/main/ui/geist_med_28.csimilarity index 100%rename from device/harness/main/ui/geist_med_28.crename to device/harness-device/firmware/main/ui/geist_med_28.cdiff --git a/device/harness/main/ui/geist_med_32.c b/device/harness-device/firmware/main/ui/geist_med_32.csimilarity index 100%rename from device/harness/main/ui/geist_med_32.crename to device/harness-device/firmware/main/ui/geist_med_32.cdiff --git a/device/harness/main/ui/geist_med_38.c b/device/harness-device/firmware/main/ui/geist_med_38.csimilarity index 100%rename from device/harness/main/ui/geist_med_38.crename to device/harness-device/firmware/main/ui/geist_med_38.cdiff --git a/device/harness/main/ui/geist_med_48.c b/device/harness-device/firmware/main/ui/geist_med_48.csimilarity index 100%rename from device/harness/main/ui/geist_med_48.crename to device/harness-device/firmware/main/ui/geist_med_48.cdiff --git a/device/harness/main/ui/geist_med_64.c b/device/harness-device/firmware/main/ui/geist_med_64.csimilarity index 100%rename from device/harness/main/ui/geist_med_64.crename to device/harness-device/firmware/main/ui/geist_med_64.cdiff --git a/device/harness/main/ui/geist_reg_16.c b/device/harness-device/firmware/main/ui/geist_reg_16.csimilarity index 100%rename from device/harness/main/ui/geist_reg_16.crename to device/harness-device/firmware/main/ui/geist_reg_16.cdiff --git a/device/harness/main/ui/geist_reg_20.c b/device/harness-device/firmware/main/ui/geist_reg_20.csimilarity index 100%rename from device/harness/main/ui/geist_reg_20.crename to device/harness-device/firmware/main/ui/geist_reg_20.cdiff --git a/device/harness/main/ui/geist_reg_24.c b/device/harness-device/firmware/main/ui/geist_reg_24.csimilarity index 100%rename from device/harness/main/ui/geist_reg_24.crename to device/harness-device/firmware/main/ui/geist_reg_24.cdiff --git a/device/harness/main/ui/geist_reg_25.c b/device/harness-device/firmware/main/ui/geist_reg_25.csimilarity index 100%rename from device/harness/main/ui/geist_reg_25.crename to device/harness-device/firmware/main/ui/geist_reg_25.cdiff --git a/device/harness/main/ui/geist_reg_32.c b/device/harness-device/firmware/main/ui/geist_reg_32.csimilarity index 100%rename from device/harness/main/ui/geist_reg_32.crename to device/harness-device/firmware/main/ui/geist_reg_32.cdiff --git a/device/harness/main/ui/geist_reg_34.c b/device/harness-device/firmware/main/ui/geist_reg_34.csimilarity index 100%rename from device/harness/main/ui/geist_reg_34.crename to device/harness-device/firmware/main/ui/geist_reg_34.cdiff --git a/device/harness/main/ui/geist_reg_38.c b/device/harness-device/firmware/main/ui/geist_reg_38.csimilarity index 100%rename from device/harness/main/ui/geist_reg_38.crename to device/harness-device/firmware/main/ui/geist_reg_38.cdiff --git a/device/harness/main/ui/geist_sem_24.c b/device/harness-device/firmware/main/ui/geist_sem_24.csimilarity index 100%rename from device/harness/main/ui/geist_sem_24.crename to device/harness-device/firmware/main/ui/geist_sem_24.cdiff --git a/device/harness/main/ui/icons_engine.c b/device/harness-device/firmware/main/ui/icons_engine.csimilarity index 100%rename from device/harness/main/ui/icons_engine.crename to device/harness-device/firmware/main/ui/icons_engine.cdiff --git a/device/harness/main/ui/icons_engine.h b/device/harness-device/firmware/main/ui/icons_engine.hsimilarity index 100%rename from device/harness/main/ui/icons_engine.hrename to device/harness-device/firmware/main/ui/icons_engine.hdiff --git a/device/harness/main/ui/icons_settings.c b/device/harness-device/firmware/main/ui/icons_settings.csimilarity index 100%rename from device/harness/main/ui/icons_settings.crename to device/harness-device/firmware/main/ui/icons_settings.cdiff --git a/device/harness/main/ui/icons_settings.h b/device/harness-device/firmware/main/ui/icons_settings.hsimilarity index 100%rename from device/harness/main/ui/icons_settings.hrename to device/harness-device/firmware/main/ui/icons_settings.hdiff --git a/device/harness/main/ui/icons_voice.c b/device/harness-device/firmware/main/ui/icons_voice.csimilarity index 100%rename from device/harness/main/ui/icons_voice.crename to device/harness-device/firmware/main/ui/icons_voice.cdiff --git a/device/harness/main/ui/icons_voice.h b/device/harness-device/firmware/main/ui/icons_voice.hsimilarity index 100%rename from device/harness/main/ui/icons_voice.hrename to device/harness-device/firmware/main/ui/icons_voice.hdiff --git a/device/harness/main/ui/spinner_spokes.c b/device/harness-device/firmware/main/ui/spinner_spokes.csimilarity index 100%rename from device/harness/main/ui/spinner_spokes.crename to device/harness-device/firmware/main/ui/spinner_spokes.cdiff --git a/device/harness/main/ui/spinner_spokes.h b/device/harness-device/firmware/main/ui/spinner_spokes.hsimilarity index 100%rename from device/harness/main/ui/spinner_spokes.hrename to device/harness-device/firmware/main/ui/spinner_spokes.hdiff --git a/device/harness/main/ui/touch.c b/device/harness-device/firmware/main/ui/touch.csimilarity index 100%rename from device/harness/main/ui/touch.crename to device/harness-device/firmware/main/ui/touch.cdiff --git a/device/harness/main/ui/touch.h b/device/harness-device/firmware/main/ui/touch.hsimilarity index 100%rename from device/harness/main/ui/touch.hrename to device/harness-device/firmware/main/ui/touch.hdiff --git a/device/harness/main/ui/ui_screens.c b/device/harness-device/firmware/main/ui/ui_screens.csimilarity index 100%rename from device/harness/main/ui/ui_screens.crename to device/harness-device/firmware/main/ui/ui_screens.cdiff --git a/device/harness/main/ui/ui_screens.h b/device/harness-device/firmware/main/ui/ui_screens.hsimilarity index 100%rename from device/harness/main/ui/ui_screens.hrename to device/harness-device/firmware/main/ui/ui_screens.hdiff --git a/device/harness/partitions.csv b/device/harness-device/firmware/partitions.csvsimilarity index 100%rename from device/harness/partitions.csvrename to device/harness-device/firmware/partitions.csvdiff --git a/device/harness/screen.html b/device/harness-device/firmware/screen.htmlsimilarity index 99%rename from device/harness/screen.htmlrename to device/harness-device/firmware/screen.htmlindex 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 & type scale.+ Commander device UI — device/harness-device/firmware/main/ui/ui_screens.c · round 466×466 CO5300 AMOLED · rendered from the live palette & type scale.</footer></div>diff --git a/device/harness/scripts/flash-station.sh b/device/harness-device/firmware/scripts/flash-station.shsimilarity index 100%rename from device/harness/scripts/flash-station.shrename to device/harness-device/firmware/scripts/flash-station.shdiff --git a/device/harness/scripts/gen_cable_vectors.py b/device/harness-device/firmware/scripts/gen_cable_vectors.pysimilarity index 96%rename from device/harness/scripts/gen_cable_vectors.pyrename to device/harness-device/firmware/scripts/gen_cable_vectors.pyindex 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 differsA THIRD implementation, written from the format description in main/cable_frame.h and from nothingelse. 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.shsimilarity index 100%rename from device/harness/scripts/gen_fonts.shrename to device/harness-device/firmware/scripts/gen_fonts.shdiff --git a/device/harness/scripts/upload-firmware.sh b/device/harness-device/firmware/scripts/upload-firmware.shsimilarity index 99%rename from device/harness/scripts/upload-firmware.shrename to device/harness-device/firmware/scripts/upload-firmware.shindex 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/firmwareVER_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.shsimilarity index 100%rename from device/harness/scripts/upload-flasher.shrename to device/harness-device/firmware/scripts/upload-flasher.shdiff --git a/device/harness/sdkconfig.defaults b/device/harness-device/firmware/sdkconfig.defaultssimilarity index 100%rename from device/harness/sdkconfig.defaultsrename to device/harness-device/firmware/sdkconfig.defaultsdiff --git a/device/harness/test/run.sh b/device/harness-device/firmware/test/run.shsimilarity index 97%rename from device/harness/test/run.shrename to device/harness-device/firmware/test/run.shindex 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 eitherdiff --git a/device/harness/test/test_board.c b/device/harness-device/firmware/test/test_board.csimilarity index 100%rename from device/harness/test/test_board.crename to device/harness-device/firmware/test/test_board.cdiff --git a/device/harness/test/test_cable_frame.c b/device/harness-device/firmware/test/test_cable_frame.csimilarity index 99%rename from device/harness/test/test_cable_frame.crename to device/harness-device/firmware/test/test_cable_frame.cindex 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 isdiff --git a/device/harness/test/test_cable_machines.c b/device/harness-device/firmware/test/test_cable_machines.csimilarity index 99%rename from device/harness/test/test_cable_machines.crename to device/harness-device/firmware/test/test_cable_machines.cindex 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 wheeldiff --git a/device/harness/test/test_carousel_ring.c b/device/harness-device/firmware/test/test_carousel_ring.csimilarity index 100%rename from device/harness/test/test_carousel_ring.crename to device/harness-device/firmware/test/test_carousel_ring.cdiff --git a/device/harness/test/vectors/cable_frame.txt b/device/harness-device/firmware/test/vectors/cable_frame.txtsimilarity index 99%rename from device/harness/test/vectors/cable_frame.txtrename to device/harness-device/firmware/test/vectors/cable_frame.txtindex 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.pysimilarity index 96%rename from device/harness/tools/generate_engine_icons.pyrename to device/harness-device/firmware/tools/generate_engine_icons.pyindex 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 = 20EXPECTED_SHA256 = {"codex.png": "8e82b26c98a10e45798ce48124515720657f7735fb8d0853b3f087eaa8a6b74e",diff --git a/device/harness/version.txt b/device/harness-device/firmware/version.txtsimilarity index 100%rename from device/harness/version.txtrename to device/harness-device/firmware/version.txtdiff --git a/device/harness/design/agent-switcher-local-remote.html b/device/harness/design/agent-switcher-local-remote.htmldeleted file mode 100644index 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->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.htmldeleted file mode 100644index 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 < 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<44 · taps swallowed</b></div>- <div class="bell"><span class="b">🔔</span><span class="n">2</span></div>- <div class="ctl">- <div class="mark">✦</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">› 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">✦</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">› 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">✦</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">› 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">✦</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">› 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">✦</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">› 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">✦</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">› 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">✦</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">› 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">✦</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)">› Working… 1m 04s</div>- <div class="sub" style="top:312px;line-height:35px;font-size:22px">Retries now back off instead…</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.htmldeleted file mode 100644index 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 & 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 & 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 & 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"> 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 & 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.mdindex 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 instrFirmware updates travel over the same cable in 16 KB credit windows, offered from the publishedmetadata 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.mdindex 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 tercli/ the harness daemon and CLI (TypeScript, one bundle). src/engines/ is one folder per enginebackend/ 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```