various tidyups

PROJECTS.md

@@ -0,0 +1,138 @@
+# Project Tracker
+
+Use this file as the source of truth for projects being worked on with OpenCode.
+
+- Associate each user request with a project ID before beginning work.
+- Ask the user which project applies when the request is ambiguous.
+- Keep project IDs stable and use the relevant section to store durable context.
+- Update context as work progresses, subject to the approval rules in `AGENTS.md`.
+- Never mark a project complete unless the user explicitly confirms it is complete.
+- Ask the user before closing a project that appears complete.
+- Use these statuses: `Active`, `Paused`, and `Complete`.
+
+| ID | Project | Status | Next Step | Last Updated |
+| --- | --- | --- | --- | --- |
+| P001 | Bedside panel alarm audio | Active | Deploy and verify alarm audio and volume behavior. | 2026-07-20 |
+| P002 | reTerminal E1001 dashboard | Active | Test display refresh, wake buttons, MQTT control, and deep sleep. | 2026-07-20 |
+| P003 | ESPHome MQTT topic normalization | Active | Deploy paired devices and verify retained synchronization and external clients. | 2026-07-20 |
+| P004 | Appliance completion announcements | Active | Test an appliance cycle and resolve feed/timestamp inconsistencies. | 2026-07-20 |
+| P005 | Jobs and Chore Tracker V2.3 | Active | Test completion boundaries and resolve stale or duplicated entities. | 2026-07-20 |
+| P006 | Bedside rain forecast | Active | Verify forecast boundaries and API-failure handling. | 2026-07-20 |
+| P007 | Bedtime stair shutdown | Active | Verify both stair relays during a bedtime run. | 2026-07-20 |
+| P008 | Spook unused entity cleanup | Complete | None. | 2026-07-21 |
+| P009 | Lounge front-door camera layout | Complete | None. | 2026-07-21 |
+| P010 | Main-page Jobs timing gauges | Complete | None. | 2026-07-21 |
+| P011 | Downstairs occupancy helper cleanup | Complete | None. | 2026-07-21 |
+| P012 | EdgeRouter X SNMP monitoring | Active | Investigate the current EdgeOS failure and v3.0.x-compatible SNMP approach. | 2026-07-21 |
+
+## P001: Bedside Panel Alarm Audio
+
+- Objective: Provide reliable local alarm audio and user-adjustable volume on the bedside panel.
+- Current context: ES8311 and I2S output, amplifier control, persistent volume, and Beep/Alarm/Stop controls were added and repeatedly tuned. Compilation, deployment, and hardware behavior have not been confirmed.
+- Key files: `esphome/esp-bedside-panel.yaml`.
+- Known issue: The file changelog records V1.47 while `project_version` still reports v1.46.
+- Next step: Compile and deploy, then test startup noise, Beep/Alarm/Stop, volume endpoints, persistence, and amplifier shutdown.
+- Activity: 2026-07-20 - Implemented and tuned the alarm-audio feature through V1.47.
+
+## P002: reTerminal E1001 Dashboard
+
+- Objective: Build a low-power e-paper dashboard for job and appliance status.
+- Current context: Added ESP32-S3 hardware support, Jobs and Appliances pages, Home Assistant entity imports, icons, buttons, MQTT controls, change-only refresh, retained page hashes, wake-source handling, and deep sleep. Runtime behavior has not been confirmed.
+- Key files: `esphome/esp-reterminal-e1001.yaml`.
+- Next step: Compile and deploy, then test entity data, rendering, page buttons, timer and button wake, MQTT keep-awake control, fallback sleep, and battery usage.
+- Activity: 2026-07-20 - Created the device configuration and developed it through v0.6.1.
+
+## P003: ESPHome MQTT Topic Normalization
+
+- Objective: Simplify MQTT command and status topics across related ESPHome devices while preserving synchronization.
+- Current context: Flattened component-specific MQTT topics to logical device roots across eleven devices. Updated paired lounge and master-bedroom consumers and restored direct pantry-light control. Deployment and external-client compatibility have not been confirmed.
+- Key files: Related device configurations under `esphome/`, including lounge, kitchen, office, bedroom, breakfast-bar, and master-bedroom devices.
+- Next step: Compile and deploy paired devices together, verify root commands and retained state, audit external MQTT consumers, and remove stale retained messages from superseded topics when safe.
+- Activity: 2026-07-20 - Applied the MQTT topic normalization across the related devices.
+
+## P004: Appliance Completion Announcements
+
+- Objective: Route appliance completion events to configured announcement channels and MQTT activity feeds.
+- Current context: Added per-appliance announcement settings, payloads, channels, LED-matrix indicators, MQTT feed suffixes, suppression logging, retained attributes, and expanded washer, dryer, dishwasher, and EV-charger handling.
+- Key files: `packages/Appliance_Monitoring/appliance_monitor_processor.yaml`, `packages/Appliance_Monitoring/appliances_status_monitoring.yaml`, `packages/view_road_announcement_router.yaml`, and `packages/appliance_status_mqttfeed.yaml`.
+- Known issues: MQTT feed channels may not yet be enabled for each appliance, and timestamp sensors may receive time-only payloads.
+- Next step: Resolve the feed and timestamp inconsistencies, then test a complete appliance cycle end to end.
+- Activity: 2026-07-20 - Expanded appliance monitoring and completion-feed routing.
+
+## P005: Jobs and Chore Tracker V2.3
+
+- Objective: Maintain household jobs through a registry-driven tracker with discovery entities and completion windows.
+- Current context: Centralized five jobs, added generic completion routing, morning and evening dog-feeding windows, MQTT Discovery entities, summary and count entities, manual buttons, missed-job handling, and completion-window expiry.
+- Key files: `packages/Job_Chore_Tracking/jobs_tracker_jobs.yaml` and `packages/Job_Chore_Tracking/jobs_tracker_processor.yaml`.
+- Known issue: Some count entities may be stale or have duplicated `jobs_tracker` naming.
+- Next step: Test completion-window boundaries and clean up stale or double-prefixed entities after confirming which entities are current.
+- Activity: 2026-07-20 - Implemented the V2.3 registry and processor changes.
+
+## P006: Bedside Rain Forecast
+
+- Objective: Supply the bedside panel with useful rain-chance forecasts for today and tomorrow.
+- Current context: Added Open-Meteo REST sensors for today's remaining forecast period and tomorrow's daylight period using the Home zone coordinates.
+- Key files: `packages/open_meteo_rain_chance.yaml` and `esphome/esp-bedside-panel.yaml`.
+- Next step: Verify sunrise and sunset boundary behavior, stale-data handling, and API-failure recovery.
+- Activity: 2026-07-20 - Added the Open-Meteo rain forecast package and bedside-panel inputs.
+
+## P007: Bedtime Stair Shutdown
+
+- Objective: Ensure the central stair lighting turns off as part of bedtime mode.
+- Current context: Added the lower main stair lights and stair footer lights to the bedtime shutdown sequence with no delay.
+- Key files: `packages/bedtime_mode_actions.yaml`.
+- Next step: Run bedtime mode and verify both relays switch off as intended.
+- Activity: 2026-07-20 - Added both central stair relays to bedtime shutdown.
+
+## P008: Spook Unused Entity Cleanup
+
+- Objective: Resolve Spook warnings caused by stale entity references.
+- Current context: The Master Bedroom Echo Show Environment view now uses the live Bedroom 1 Environment (Z19TH) temperature and humidity entities, and the related Spook repair has cleared.
+- Replacement entities: `sensor.bedroom_1_environment_z19th_temperature` and `sensor.bedroom_1_environment_z19th_humidity`.
+- Verification: The stored card definitions reference the replacement entities, and Spook no longer reports the Master Bedroom Echo Show issue. Automated visual verification was unavailable because the screenshot tool is disabled.
+- Next step: None.
+- Activity: 2026-07-21 - Created the project and selected the live Bedroom 1 Environment (Z19TH) sensor pair.
+- Activity: 2026-07-21 - Replaced both stale dashboard references and confirmed that the Spook repair cleared.
+- Activity: 2026-07-21 - User confirmed completion.
+
+## P009: Lounge Front-Door Camera Layout
+
+- Objective: Display the Front Door Camera in landscape orientation on the Lounge dashboard.
+- Current context: The Lounge Home view now displays the live `camera.camera2` card at a 4:3 landscape aspect ratio.
+- Verification: The saved view retains all seven cards and the Front Door Camera live-view settings, and `camera.camera2` is streaming. Automated visual verification was unavailable because the screenshot tool is disabled.
+- Next step: None.
+- Activity: 2026-07-21 - Created the project and identified the Front Door Camera card on the Lounge Home view.
+- Activity: 2026-07-21 - Changed the Front Door Camera card from 3:4 to 4:3 and verified the saved dashboard configuration.
+- Activity: 2026-07-21 - User confirmed completion.
+
+## P010: Main-Page Jobs Timing Gauges
+
+- Objective: Make the Lounge Home dog-feeding and depooping gauges use timing from the Jobs routine.
+- Current context: The gauges now use Jobs-derived template sensors. Dog feeding uses the latest morning/evening completion, and depooping uses the weekly job completion.
+- Selected design: Keep two gauges. Dog feeding uses the latest morning/evening completion; depooping uses the weekly job completion.
+- Key file: `packages/pet_feeding_and_jobs.yaml`.
+- Verification: Home Assistant accepted the configuration, both template sensors loaded, the feeding gauge reports 17 hours, the depooping gauge reports 156 hours, and all other Home view cards were preserved. Automated visual verification was unavailable because the screenshot tool is disabled.
+- Next step: None.
+- Activity: 2026-07-21 - Created the project and selected the two-gauge Jobs-derived design.
+- Activity: 2026-07-21 - Added the Jobs-derived sensors, reloaded templates, and updated both Lounge Home gauges.
+- Activity: 2026-07-21 - User confirmed completion.
+
+## P011: Downstairs Occupancy Helper Cleanup
+
+- Objective: Eliminate the duplicate downstairs guest occupancy helper.
+- Canonical helper: `input_boolean.downstairs_flat_occupied`, which is YAML-managed and used by the downstairs lockout behavior.
+- Removed duplicate: `input_boolean.guest_area_occupied`, which was UI-managed and referenced only by the Test dashboard.
+- Current context: All nine stored Test dashboard references now use the canonical helper, the duplicate helper has been deleted, and the Lounge row of eight downstairs-flat light icons now greys out and blocks taps while occupied.
+- Verification: The duplicate returns entity not found, the canonical helper remains available with its automation and script relationships, no Test dashboard broken-reference repair was created, and the saved Lounge templates render both the enabled and occupied branches correctly. Automated visual verification was unavailable because the screenshot tool is disabled.
+- Next step: None.
+- Activity: 2026-07-21 - Created the project and completed the dependency audit.
+- Activity: 2026-07-21 - Migrated the Test dashboard references and deleted the duplicate helper.
+- Activity: 2026-07-21 - Added occupancy-driven greying and tap blocking to the Lounge downstairs-flat light row.
+- Activity: 2026-07-21 - User verified the Lounge lockout and confirmed completion.
+
+## P012: EdgeRouter X SNMP Monitoring
+
+- Objective: Restore EdgeRouter X monitoring on firmware v3.0.x using a compatible SNMP-based approach.
+- Current context: The existing EdgeRouter interface is not working after the router moved to firmware v3.0.x. Prior EdgeRouter/SNMP work was not recorded in project context.
+- Next step: Inspect the current configuration, entities, errors, and documentation without changing runtime behavior.
+- Activity: 2026-07-21 - Created the project and began the compatibility investigation.