| ID | Task | Description | Depends On | Estimate |
|---|---|---|---|---|
| T01 | Baseline + Safety Net | Create a baseline branch, capture current behavior checklist, and define a manual regression pass for modes/sliders/colors/SVG/audio startup. | None | 0.5 day |
| T02 | Central App State Model | Add a unified AppState object for sliders, colors, mode, media state, audio input selection, and UI flags. |
T01 | 1 day |
| T03 | Profile Data Format | Define JSON profile schema and serialization/deserialization for full runtime state. | T02 | 1 day |
| T04 | Profile Manager + Slots 1-10 | Implement profile storage paths, slot mapping logic, and profile manager APIs for save/load. | T03 | 1 day |
| T05 | Quick Save/Load Hotkeys | Add hotkeys for quick profile actions (1-0 load and Ctrl+1-0 save, or equivalent) with debounce. |
T04 | 0.5 day |
| T06 | Timed Mouse Hide | Hide cursor after 2 seconds of inactivity and immediately restore on movement/click. | T02 | 0.5 day |
| T07 | Space-Hold Help Overlay | Show temporary button labels/overlay only while Space is held; remove on key release. | T02 | 1 day |
| T08 | Resolution-Aware Layout Engine | Make sidebar/buttons/sliders scale and reposition with viewport so the full menu stays visible on different resolutions. | T02 | 1.5 days |
| T09 | Media Import Refactor | Add a shared media loader pipeline for SVG and raster formats. | T02 | 1 day |
| T10 | Auto-Scaling on Import | Standardize imported media size ratio and aspect-fit behavior for SVG/PNG/JPEG/GIF on load. | T09, T08 | 1 day |
| T11 | Persist Media in Profiles | Include media path, position, scale, and perturbation values in saved profiles. | T04, T10 | 0.5 day |
| T12 | Audio Device Enumeration | Enumerate available audio inputs and expose selectable device list in app state/menu. | T02 | 1 day |
| T13 | System Audio (Loopback) Mode | Support selecting system audio loopback as input in addition to microphone input. | T12 | 1.5 days |
| T14 | Persist Audio Selection | Save/load audio mode and selected device as part of profile state. | T04, T13 | 0.5 day |
| T15 | Controller Navigation Layer | Add controller-based focus navigation, selection, and slider adjustments while keeping mouse support active. | T08, T02 | 2 days |
| T16 | UX Polish + Input Conflict Pass | Resolve input conflicts, improve debounce behavior, and polish visual focus/feedback cues. | T05, T07, T15 | 1 day |
| T17 | Full Regression + Performance Pass | Run full manual matrix across resolutions, visualization modes, media formats, profiles, and audio source switching. | T16 | 1 day |
- Foundation and Profiles: T01 -> T02 -> T03 -> T04 -> T05
- Establishes stable state architecture and fast workflow wins (profile slots/hotkeys).
- Interaction and UI Scaling: T06 -> T07 -> T08
- Delivers core UX quality: cleaner presentation, contextual labels, and menu visibility at any resolution.
- Media Pipeline Expansion: T09 -> T10 -> T11
- Adds multi-format import and standardized sizing while keeping profile continuity.
- Audio Source Flexibility: T12 -> T13 -> T14
- Enables explicit input selection and system loopback, then persists it through profiles.
- Controller + Final Stabilization: T15 -> T16 -> T17
- Adds alternate navigation and finishes with integration polish and regression/perf validation.
- All requested features are implemented and integrated without breaking current visualization behavior.
- UI remains minimal-text by default, with temporary overlay labels only on Space hold.
- Full menu remains visible and usable across target resolutions.
- Profiles reliably save/load colors, mode, sliders, media state, and audio source.
- Mouse and controller inputs coexist without conflict, and quick profile switching is stable during playback.
T01complete: feature branch and baseline regression checklist exist.T02complete for current phase: centralized runtimeAppStateadded and wired to update/load flow.T03complete: JSON profile format in use.T04complete: slot-based profile save/load manager added (1-10).T05complete: quick hotkeys implemented (1-0load,Ctrl+1-0save).
Before starting Section 2 code, run and confirm:
- Manual pass on
BaselineRegressionChecklist.md. - Hotkey behavior validation in fullscreen and windowed mode.
- Profile slot validation for:
- empty slot load behavior,
- overwritten slot behavior,
- missing SVG path on load behavior.
- Build validation (
dotnet build) with zero errors. - Commit tag for Section 1 completion checkpoint.
- Run the full checklist and record pass/fail notes.
- Fix any regressions found in hotkeys/profile restore.
- Verify profile persistence on restart with at least 3 occupied slots.
- Finalize Section 1 with a checkpoint commit.
- Add inactivity timer state (
lastMouseMoveTime,mouseVisible). - Detect movement delta/click and reset timer.
- Hide cursor after 2 seconds without movement.
- Instantly restore cursor on movement/button input.
- Validate interaction safety for sidebar reveal, slider drag, SVG drag.
- Add overlay visibility state (
showHelpOverlay = Space held). - Define lightweight label map for key UI elements (buttons, sliders, modes).
- Render overlay only while Space is held; no persistent labels.
- Keep style minimal so base interface remains text-light.
- Validate that overlay does not block clicks or drag interaction.
- Create reference-resolution layout constants (for example: 1800x1200 baseline).
- Convert hard-coded menu/button/slider rectangles into computed layout functions.
- Recompute layout on startup, fullscreen toggle, and resize event.
- Ensure sidebar and all controls fit within low-height viewports.
- Validate on multiple resolutions:
1280x720,1920x1080,2560x1440, and3840x2160.
- T06-T08 merged and stable.
- No regressions in profile hotkeys/save-load flow.
- Menu fully visible and usable at target resolutions.
- Space overlay behaves as hold-to-show only.
T06implemented in code: cursor auto-hides after 2s inactivity and reappears immediately on movement/click/scroll.T07implemented in code: Space-hold overlay labels render only while key is held.T08implemented in code: sidebar/menu layout now recalculates from viewport height and rebuilds control geometry/textures on load, resize, and fullscreen toggle.- Overlay polish complete: help-label shading now matches the size of each target control.
- Small-window polish complete: color grid now compresses primarily in vertical dimension while preserving horizontal alignment/spacing for better usability.
- Manual validation pass completed for Section 2 behavior.
- Section 1 (
T01-T05) complete. - Section 2 (
T06-T08) complete and validated. - Next active section: Section 3 (
T09-T11) Media Pipeline Expansion.
T09implemented in code: shared media loader added for.svg,.png,.jpg,.jpeg, and.gif.T10implemented in code: imported media now applies standardized initial scale and centered placement.T11implemented in code: profile restore path now reloads persisted media through the shared loader.- Default startup media logic now supports supported extensions (
startup.svg/png/jpg/jpeg/gif). - Manual validation pass completed across supported import types and profile reload scenarios.
- Section 1 (
T01-T05) complete. - Section 2 (
T06-T08) complete and validated. - Section 3 (
T09-T11) complete and validated. - Next active section: Section 4 (
T12-T14) Audio Source Flexibility.
- Added right-panel audio control scaffold using the same button style as the left menu.
- Implemented audio source switching between microphone input and system loopback (
T13). - Implemented microphone input enumeration with explicit selectable device buttons plus previous/next cycling controls (
T12). - Added profile persistence for selected audio source and selected microphone device (
T14). - Manual validation completed for source switching, input cycling, and profile restore behavior.
- Section 1 (
T01-T05) complete. - Section 2 (
T06-T08) complete and validated. - Section 3 (
T09-T11) complete and validated. - Section 4 (
T12-T14) complete and validated. - Next active section: Section 5 (
T15-T17) Controller + Final Stabilization.
- Added controller-detected input mode switching with mouse/keyboard fallback behavior.
- Added bumper controls: left bumper toggles left panel open/close, right bumper toggles right panel open/close.
- Added controller focus system for menu controls with directional navigation and visible highlight.
- Added controller activation for buttons and controller slider adjustment behavior while focused.
- Added controller
Starthold behavior to mirrorSpacehold for temporary overlay display. - Improved focus visibility on light controls with high-contrast dual-outline highlight styling.
- Input conflict/debounce handling pass implemented and validated in iteration (
T16). - Remaining gate: final full regression/performance matrix sign-off (
T17).
T01-T16: implemented in code and validated in iterative manual checks.T17: pending final end-to-end regression/performance sign-off.
T17final sign-off matrix:- execute full manual matrix across target resolutions, visual modes, media types, profile slots, and audio source/device switching.
- capture outcomes in this document (pass/fail notes and any residual issues).
- Resolution/layout:
1280x720pass/fail:1920x1080pass/fail:2560x1440pass/fail:3840x2160pass/fail:
- Visualization modes:
- Standard:
- MirroredMiddle:
- MirroredCorners:
- Radial:
- CenterColumn:
- Puddle:
- Media import/restore:
- SVG import + profile restore:
- PNG import + profile restore:
- JPG/JPEG import + profile restore:
- GIF import + profile restore:
- Audio source/device:
- Microphone mode switch:
- System loopback mode switch:
- Explicit input-device button selection:
- Prev/next input-device cycling:
- Audio source/device profile restore:
- Input-method handoff:
- Controller focus/navigation:
- Left/right bumper panel toggles:
- Controller
Startoverlay hold: - Mouse fallback after controller use:
- Keyboard fallback after controller use: