- 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.
43 lines
1.4 KiB
Markdown
43 lines
1.4 KiB
Markdown
# T-Deck workspace — agent notes
|
|
|
|
## Common pitfalls
|
|
|
|
- never run searches across the whole disk; `find /` commands are forbidden because they take ages
|
|
|
|
## Toolchain
|
|
|
|
- platformio `pio` is in `~/.platformio/` (`~/.platformio/penv/bin/pio`), or
|
|
on `PATH` if 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 update
|
|
`src/netdeck/STATUS.md` in the same commit.
|