feat: update ESP32 board version and add LSP configs

.clangd

@@ -1,18 +1,23 @@
 CompileFlags:
   Add:
-    - "-I/home/david/.arduino15/packages/esp32/hardware/esp32/3.3.6/cores/esp32"
+    - "-I/home/david/.arduino15/packages/esp32/hardware/esp32/3.3.7/cores/esp32"
-    - "-I/home/david/.arduino15/packages/esp32/hardware/esp32/3.3.6/tools/sdk/esp32/include"
+    - "-I/home/david/.arduino15/packages/esp32/tools/esp32-libs/3.3.7/include"
-    - "-I/home/david/.arduino15/packages/esp32/hardware/esp32/3.3.6/tools/sdk/esp32/include/esp_hw_support"
+    - "-I/home/david/.arduino15/packages/esp32/hardware/esp32/3.3.7/libraries/WiFi/src"
-    - "-I/home/david/.arduino15/packages/esp32/hardware/esp32/3.3.6/libraries/WiFi/src"
+    - "-I/home/david/.arduino15/packages/esp32/hardware/esp32/3.3.7/libraries/EEPROM/src"
-    - "-I/home/david/.arduino15/packages/esp32/hardware/esp32/3.3.6/libraries/EEPROM/src"
+    - "-I/home/david/.arduino15/packages/esp32/hardware/esp32/3.3.7/libraries/HTTPClient/src"
-    - "-I/home/david/Arduino/sketches/doorbell-touch/vendor/esp32-s3-lcd-43/LovyanGFX/src"
+    - "-I/home/david/.arduino15/packages/esp32/hardware/esp32/3.3.7/libraries/Network/src"
+    - "-I/home/david/.arduino15/packages/esp32/hardware/esp32/3.3.7/libraries/NetworkClientSecure/src"
+    - "-I/home/david/.arduino15/packages/esp32/hardware/esp32/3.3.7/libraries/NTPClient/src"
+    - "-I/home/david/Arduino/libraries/ArduinoJson/src"
     - "-I/home/david/Arduino/libraries/TFT_eSPI"
+    - "-I/home/david/Arduino/sketches/doorbell-touch/vendor/esp32-s3-lcd-43/LovyanGFX/src"
     - "-I/home/david/Arduino/sketches/doorbell-touch/libraries/KlubhausCore/src"
     - "-I/home/david/Arduino/sketches/doorbell-touch/boards/esp32-32e-4"
     - "-DARDUINO=200"
     - "-DESC32"
     - "-DESP_PLATFORM"
     - "-Dcore_debug=0"
+    - "-DARDUINO_ESP32_DEV"
 
 Diagnostics:
   ClangTidy:

.crush.json

@@ -0,0 +1,11 @@
+{
+  "lsp": {
+    "arduino": {
+      "command": "arduino-language-server",
+      "args": [
+        "-fqbn",
+        "$(cat boards/${BOARD:-esp32-32e-4}/board-config.sh | grep '^FQBN=' | cut -d'\"' -f2)"
+      ]
+    }
+  }
+}

.crushmemory

@@ -33,3 +33,38 @@ BOARD=esp32-32e-4 mise run install   # Install libs (shared + board)
 
 ## Known Fixes
 - dashboard/off admin commands now reset inactivity timer (DoorbellLogic.cpp:234,240)
+
+## Reverted Changes Log
+Track changes that were reverted to avoid flapping:
+- 2025-02-18: Initially configured LSP via neovim/mason (`.config/nvim/lua/plugins/arduino.lua`) — user clarified they wanted Crush-native LSP config instead
+
+## Documentation Lookup Rule
+When uncertain about CLI tool flags or argument syntax:
+1. Run the tool with `-h` or `--help` first
+2. If unclear, search for official documentation matching the tool version
+3. Prefer checking the tool's own help/docs over guessing
+4. For Arduino CLI, check `arduino-cli <command> --help` or official Arduino CLI docs
+
+## Neovim LSP Configuration
+For Neovim projects:
+- Use Mason + mason-lspconfig to manage LSP installations
+- Add LSP configs to `~/.config/nvim/lua/plugins/` as separate plugin files
+- Use `on_new_config` for dynamic settings (e.g., BOARD env var → FQBN mapping)
+- Example: `~/.config/nvim/lua/plugins/arduino.lua` (arduino-language-server)
+
+## Crush LSP Configuration
+- Configure via `.crush.json` in project root (or `$HOME/.config/crush/crush.json` globally)
+- Supports env var interpolation: `$BOARD` or `${BOARD}`
+- Supports command substitution: `$(cat boards/$BOARD/board-config.sh | grep '^FQBN=' | cut -d'"' -f2)`
+- Example for Arduino (auto-detects FQBN from BOARD):
+```json
+{
+  "lsp": {
+    "arduino": {
+      "command": "arduino-language-server",
+      "args": ["-fqbn", "$(cat boards/${BOARD:-esp32-32e-4}/board-config.sh | grep '^FQBN=' | cut -d'\"' -f2)"]
+    }
+  }
+}
+```
+- Run `mise run gen-crush-config` to regenerate static config

AGENTS.md

@@ -2,15 +2,33 @@
 
 Multi-target Arduino/ESP32 doorbell alert system using ntfy.sh.
 
+## Quick Reference
+
+```bash
+# Compile, upload, monitor
+BOARD=esp32-32e-4 mise run compile   # compile
+BOARD=esp32-32e-4 mise run upload    # upload (auto-kills monitor)
+BOARD=esp32-32e-4 mise run monitor   # start JSON monitor daemon
+BOARD=esp32-32e-4 mise run log-tail  # watch colored logs
+BOARD=esp32-32e-4 mise run cmd COMMAND=dashboard  # send command
+BOARD=esp32-32e-4 mise run state     # show device state
+
+# Install libs (run after cloning)
+mise run install-libs-shared              # shared libs (ArduinoJson, NTPClient)
+BOARD=esp32-32e-4 mise run install      # shared + board-specific libs
+```
+
+**Default BOARD**: `esp32-32e-4` (set in mise.toml)
+
 ## Project Overview
 
 Three board targets share business logic via a common library:
 
-| Board | Display | Library | Build Target |
+| Board | Display | Library | Build Command |
 |-------|---------|---------|--------------|
-| ESP32-32E | SPI TFT 320x240 (ILI9341) | TFT_eSPI | `compile-32e` |
+| ESP32-32E | SPI TFT 320x240 (ILI9341) | TFT_eSPI | `BOARD=esp32-32e mise run compile` |
-| ESP32-32E-4" | SPI TFT 320x480 (ST7796) | TFT_eSPI | `compile-32e-4` |
+| ESP32-32E-4" | SPI TFT 320x480 (ST7796) | TFT_eSPI | `BOARD=esp32-32e-4 mise run compile` |
-| ESP32-S3-Touch-LCD-4.3 | 800x480 RGB parallel | LovyanGFX | `compile-s3-43` |
+| ESP32-S3-Touch-LCD-4.3 | 800x480 RGB parallel | LovyanGFX | `BOARD=esp32-s3-lcd-43 mise run compile` |
 
 ## Essential Commands
 
@@ -18,26 +36,43 @@ All commands run via **mise**:
 
 ```bash
 # Install all dependencies (shared libs + vendored display libs)
-mise run install-libs
+mise run install-libs-shared
+mise run install               # install shared + board-specific libs (requires BOARD env)
 
-# Build ESP32-32E
+# Generic commands (set BOARD environment variable)
-mise run compile-32e
+BOARD=esp32-32e mise run compile   # compile for ESP32-32E
-mise run upload-32e
+BOARD=esp32-32e mise run upload    # upload to ESP32-32E
-mise run monitor-32e
+BOARD=esp32-32e mise run monitor   # monitor ESP32-32E
 
-# Build ESP32-S3-LCD-4.3
+BOARD=esp32-32e-4 mise run compile # compile for ESP32-32E-4"
-mise run compile-s3-43
+BOARD=esp32-32e-4 mise run upload  # upload to ESP32-32E-4"
-mise run upload-s3-43
+BOARD=esp32-32e-4 mise run monitor # monitor ESP32-32E-4"
-mise run monitor-s3-43
 
-# Format code
+BOARD=esp32-s3-lcd-43 mise run compile # compile for ESP32-S3-LCD-4.3
-mise run format
+BOARD=esp32-s3-lcd-43 mise run upload  # upload to ESP32-S3-LCD-4.3
+BOARD=esp32-s3-lcd-43 mise run monitor # monitor ESP32-S3-LCD-4.3
 
-# Clean build artifacts
+# Other useful tasks
-mise run clean
+mise run format               # format code
+mise run clean                # clean build artifacts
+mise run kill                 # kill running monitor/upload for BOARD
+mise run log-tail             # tail colored logs (requires BOARD)
+mise run cmd COMMAND=dashboard # send command to device (requires BOARD)
+mise run state                # show device state (requires BOARD)
+
+# LSP / IDE support
+mise run gen-compile-commands  # generate compile_commands.json for LSP
+mise run gen-crush-config      # generate .crush.json with BOARD-based FQBN
+
+# Arduino maintenance
+mise run arduino-clean         # clear Arduino CLI cache (staging + packages)
+
+# Raw serial access
+mise run monitor-raw           # raw serial monitor (arduino-cli)
+mise run monitor-tio           # show tio command for terminal UI
 ```
 
-**Upload port override**: `PORT=/dev/ttyXXX mise run upload-32e`
+**Upload port override**: `PORT=/dev/ttyXXX BOARD=esp32-32e mise run upload`
 
 **Prerequisites**: arduino-cli with `esp32:esp32` platform installed, mise.
 
@@ -60,6 +95,12 @@ boards/
 │   ├── secrets.h              WiFi creds (gitignored, copy from .example)
 │   ├── tft_user_setup.h       TFT_eSPI config
 │   └── DisplayDriverTFT.*     Concrete IDisplayDriver for TFT
+├── esp32-32e-4/
+│   ├── esp32-32e-4.ino        Main sketch
+│   ├── board_config.h         Board-specific config
+│   ├── secrets.h              WiFi creds (gitignored, copy from .example)
+│   ├── tft_user_setup.h       TFT_eSPI config
+│   └── DisplayDriverTFT.*     Concrete IDisplayDriver for TFT
 └── esp32-s3-lcd-43/
     ├── esp32-s3-lcd-43.ino     Main sketch
     ├── board_config.h          Board-specific config
@@ -69,6 +110,7 @@ boards/
 
 vendor/                        Vendored display libs (recreated by install-libs)
 ├── esp32-32e/TFT_eSPI/
+├── esp32-32e-4/TFT_eSPI/
 └── esp32-s3-lcd-43/LovyanGFX/
 ```
 
@@ -107,11 +149,31 @@ Use `#pragma once` (not `#ifndef` guards).
 | `status` | Print state + memory info |
 | `reboot` | Restart device |
 
+## Monitor Daemon and Logging
+
+The build system includes a Python-based monitor agent that provides JSON logging and command pipes.
+
+- **JSON log**: `/tmp/doorbell-$BOARD.jsonl` – each line is `{"ts":123.456,"line":"..."}`
+- **State file**: `/tmp/doorbell-$BOARD-state.json` – current device state (screen, alert status, etc.)
+- **Command FIFO**: `/tmp/doorbell-$BOARD-cmd.fifo` – send commands via `echo 'dashboard' > /tmp/doorbell-$BOARD-cmd.fifo`
+
+Commands to interact with the daemon:
+
+```bash
+BOARD=esp32-32e mise run monitor   # Start monitor daemon (background)
+BOARD=esp32-32e mise run log-tail  # Tail colored logs
+BOARD=esp32-32e mise run cmd COMMAND=dashboard  # Send command
+BOARD=esp32-32e mise run state     # Show current device state
+```
+
+The monitor daemon automatically starts after upload and is killed before upload to avoid serial port conflicts.
+
 ## Gotchas
 
 1. **secrets.h is gitignored**: Copy from `.example` before building:
    ```bash
    cp boards/esp32-32e/secrets.h.example boards/esp32-32e/secrets.h
+   cp boards/esp32-32e-4/secrets.h.example boards/esp32-32e-4/secrets.h
    cp boards/esp32-s3-lcd-43/secrets.h.example boards/esp32-s3-lcd-43/secrets.h
    ```
 
@@ -125,6 +187,50 @@ Use `#pragma once` (not `#ifndef` guards).
 
 6. **WiFi credentials are per-board**: Each board directory has its own `secrets.h` because boards may be on different networks.
 
+7. **Use BOARD environment variable**: All build commands require the `BOARD` environment variable (e.g., `BOARD=esp32-32e mise run compile`). The default BOARD is `esp32-32e-4` (set in mise.toml).
+
+8. **Lockfile system**: The build system uses lockfiles (`/tmp/doorbell-$BOARD.lock`) to prevent concurrent upload/monitor operations. Use `mise run kill` to clean up stuck processes.
+
+## Known Fixes
+
+- **dashboard/off admin commands reset inactivity timer** (DoorbellLogic.cpp:234,240) — Admin commands like `dashboard` and `off` now reset the inactivity timer so the display doesn't turn off immediately after switching screens.
+
+## Documentation Lookup Rule
+
+When uncertain about CLI tool flags or argument syntax:
+1. Run the tool with `-h` or `--help` first
+2. If unclear, search for official documentation matching the tool version
+3. Prefer checking the tool's own help/docs over guessing
+4. For Arduino CLI, check `arduino-cli <command> --help` or official Arduino CLI docs
+
+## LSP / IDE Configuration
+
+The project uses clangd for C++ and arduino-language-server for Arduino. The `.crush.json` contains dynamic FQBN resolution:
+
+```json
+{
+  "lsp": {
+    "arduino": {
+      "command": "arduino-language-server",
+      "args": ["-fqbn", "$(cat boards/${BOARD:-esp32-32e-4}/board-config.sh | grep '^FQBN=' | cut -d'\"' -f2)"]
+    },
+    "cpp": {
+      "command": "clangd"
+    }
+  }
+}
+```
+
+**Generate compile_commands.json** for accurate IDE diagnostics:
+```bash
+BOARD=esp32-32e-4 mise run gen-compile-commands
+```
+
+**Generate static .crush.json** for a specific board:
+```bash
+BOARD=esp32-32e-4 mise run gen-crush-config
+```
+
 ## Hardware Research Log
 
 ### Hosyond ESP32-32E 4" (320x480) - Planned

mise.toml

@@ -193,5 +193,35 @@ clang-format -i --style=file \
                         libraries/KlubhausCore/*.properties
 """
 
+[tasks.gen-compile-commands]
+description = "Generate compile_commands.json for LSP (uses BOARD env var)"
+run = """
+rm -rf /tmp/arduino-build
+source ./boards/$BOARD/board-config.sh
+arduino-cli compile --only-compilation-database --fqbn "$FQBN" --build-path /tmp/arduino-build ./boards/$BOARD
+cp /tmp/arduino-build/compile_commands.json .
+echo "[OK] compile_commands.json generated"
+"""
+
+[tasks.gen-crush-config]
+description = "Generate .crush.json with BOARD-based FQBN"
+run = """
+source ./boards/$BOARD/board-config.sh
+cat > .crush.json << EOF
+{
+  "lsp": {
+    "arduino": {
+      "command": "arduino-language-server",
+      "args": ["-fqbn", "$FQBN"]
+    },
+    "cpp": {
+      "command": "clangd"
+    }
+  }
+}
+EOF
+echo "[OK] Generated .crush.json with FQBN: $FQBN"
+"""
+
 [env]
 BOARD = "esp32-32e-4"