Refresh stale docs and enrich seasonal scenery by sshcrack · Pull Request #138 · sshcrack/led-matrix

sshcrack · 2026-11-10T10:57:58Z

Refresh stale setup and architecture docs, move planned work out of the repository, and improve the two existing seasonal landscapes.

Documentation and tracking:

Correct PKCE Spotify setup, offload contracts, transactional deployment and CI guidance; remove conflicting scene counts and clearly date historical evidence.
Migrate actionable maintenance and investigation work into 11 tasks (Replace exported daemon globals with narrow dependencies #139–[Deferred] Design a shared palette and color system #149), grouped as native sub-issues of three tracking issues (Maintenance — dependencies and API boundaries #150–Rendering — Pi efficiency and visual design #152). The Led Matrix Road Map matches Talking Colonists: five configured views, P0–P2 priorities, XS–XL sizes, full review/status flow, area labels and wave milestones. The global-state refactor (Replace exported daemon globals with narrow dependencies #139) is P0; the palette idea ([Deferred] Design a shared palette and color system #149) stays deferred and outside active milestones.
Remove plans/ and planning lists from docs. Update AGENTS.md to search/update GitHub issues, maintain parent/sub-issue and real blocked-by links, and use project fields, statuses and milestones for future work; repository docs describe current behavior and evidence.
Replace obsolete AudioVisualizer TODO/packet documentation with current desktop setup and a link to the shared protocol.
Document ownership of sshcrack/rpi-rgb-led-matrix: required library changes follow a tier-3-equivalent PR/check/merge/release workflow, then led-matrix consumes that published release. The application retains its requested shipping tier.

Scenery:

Forest path: cached dappled daylight and small sky-reflecting rain pools with sparse ripples.
Cottage: wet paving with subtle warm highlights and ripples, roof/fence snow ledges and short icicles. Wet-ground details fade with snow cover.
Static additions reuse the environment backdrop cache; animations touch small bounded regions with a fixed ring stencil. Existing properties/runtime data/remote contracts are unchanged. No extra playback metrics or global-state refactor is included.

Validation:

Emulator preset build/install; all 51 CTest tests pass for the scene changes. ARM, Linux/Windows desktop, emulator, sanitizer and web CI all passed before the final documentation-only migration; checks rerun on the new head.
Rendered and visually inspected all 26 base/variant looks at quality 1.0 and 0.6, including holiday looks; inspected early/late rain and snow frames.
Regenerated and inspected season_forest_path.gif and season_cottage.gif; no other previewable scenes lacked a GIF. Previews remain untracked and are not published until merge.
Local Markdown link targets, git diff --check, shell syntax and repository size checks pass. Verified all 11 tasks have priority/size/status, all three parents have native sub-issue links, active work has wave milestones, and all five view layouts/groupings/filters match the reference. PR Refresh stale docs and enrich seasonal scenery #138 is In review on the project. Dates and numeric estimates remain unset.
No real-Pi performance measurement or physical-panel trial. No web layout change.

season_forest_path