- Replace hardcoded with in NetDeck.ino (8 occurrences) - Add to nd_layout.h - Update test expectations in unit_tests.h and integration_tests.h from units[6] to units[7] to match the new reinforcement slot indexing This enables supporting more than 7 units in the future.
1.4 KiB
1.4 KiB
T-Deck workspace — agent notes
Common pitfalls
- never run searches across the whole disk;
find /commands are forbidden because they take ages
Toolchain
- platformio
piois in~/.platformio/(~/.platformio/penv/bin/pio), or onPATHif available.
alias pio=~/.platformio/penv/bin/pio
Build & test — one command each, from the repo root
make netdeck— builds BOTH targets of the app: ESP32-S3 firmware (pio) and SDL2 emulator. Both must stay green.make netdeck-test— full headless test suite: unit + integration (fast, deterministic) + E2E journeys (separate build, ~1-2 min).make netdeck-test-unit— fast layer only (unit + integration, seconds).emulator/tests/README.md— how the test layers work and how to add tests (unit/integration headers, E2E journeys).
Git hooks
A pre-commit hook runs the fast test layer (make netdeck-test-unit)
before every commit. Hooks are not versioned inside .git/hooks; this
repo ships them under .githooks/. Enable with:
make hooks # = git config core.hooksPath .githooks
- Bypass once with
git commit --no-verify(use sparingly, say why). - Disable:
git config --unset core.hooksPath.
Commit discipline
- Feature/increment commits:
make netdeck(dual build) + the relevant test layer must pass before committing. - Milestone commits: run
make netdeck-test(full suite) and updatesrc/netdeck/STATUS.mdin the same commit.