updateupdate

backlog/archive/tasks/task-20 - Implement-content-bounded-overlay-windows-and-decoupled-secondary-top-bar.md

@@ -0,0 +1,26 @@
+---
+id: TASK-20
+title: Implement content-bounded overlay windows and decoupled secondary top bar
+status: To Do
+assignee: []
+created_date: '2026-02-12 08:47'
+updated_date: '2026-02-12 09:42'
+labels: []
+dependencies: []
+priority: high
+---
+
+## Description
+
+<!-- SECTION:DESCRIPTION:BEGIN -->
+Implement the overlay sizing redesign documented in `overlay_window.md`: move visible/invisible overlays from fullscreen bounds to content-bounded sizing, and decouple secondary subtitle rendering into an independent top bar window/lifecycle.
+<!-- SECTION:DESCRIPTION:END -->
+
+## Acceptance Criteria
+<!-- AC:BEGIN -->
+- [ ] #1 Per-layer bounds ownership is implemented for overlay windows (no shared full-bounds setter for all layers).
+- [ ] #2 Renderer-to-main IPC contract exists for measured overlay content bounds with layer identity and safe validation.
+- [ ] #3 Visible and invisible overlays use content-bounded sizing with padding/clamp/jitter protections and full-bounds fallback when measurements are unavailable.
+- [ ] #4 Secondary subtitle top bar is decoupled from primary overlay visibility and follows mode-specific behavior.
+- [ ] #5 Automated tests and manual validation matrix cover wrapping, style changes, monitor moves, tracker churn, and simultaneous overlay states.
+<!-- AC:END -->

backlog/archive/tasks/task-20.3 - Implement-content-bounded-sizing-algorithm-for-visible-and-invisible-overlay-windows.md

@@ -0,0 +1,28 @@
+---
+id: TASK-20.3
+title: >-
+  Implement content-bounded sizing algorithm for visible and invisible overlay
+  windows
+status: To Do
+assignee: []
+created_date: '2026-02-12 08:47'
+updated_date: '2026-02-12 09:42'
+labels: []
+dependencies: []
+parent_task_id: TASK-20
+priority: medium
+---
+
+## Description
+
+<!-- SECTION:DESCRIPTION:BEGIN -->
+Implement content-bounded sizing for visible/invisible windows using measured rects plus tracker origin, with robust clamping and jitter resistance.
+<!-- SECTION:DESCRIPTION:END -->
+
+## Acceptance Criteria
+<!-- AC:BEGIN -->
+- [ ] #1 Bounds algorithm applies configurable padding, minimum size, display-workarea clamp, and integer snap.
+- [ ] #2 Main-process bounds updates are thresholded/debounced to reduce jitter and unnecessary `setBounds` churn.
+- [ ] #3 When no valid measurement exists, layer falls back to safe tracker/display bounds without breaking interaction.
+- [ ] #4 Visible+invisible overlays can coexist without full-window overlap/input conflicts caused by shared fullscreen bounds.
+<!-- AC:END -->

backlog/archive/tasks/task-20.4 - Implement-dedicated-secondary-top-bar-overlay-window.md

@@ -0,0 +1,26 @@
+---
+id: TASK-20.4
+title: Implement dedicated secondary top-bar overlay window
+status: To Do
+assignee: []
+created_date: '2026-02-12 09:43'
+labels: []
+dependencies: []
+parent_task_id: TASK-20
+priority: medium
+---
+
+## Description
+
+<!-- SECTION:DESCRIPTION:BEGIN -->
+Create and integrate a dedicated secondary subtitle overlay window with independent lifecycle, z-order, bounds, and pointer policy, decoupled from primary visible/invisible overlay windows.
+<!-- SECTION:DESCRIPTION:END -->
+
+## Acceptance Criteria
+<!-- AC:BEGIN -->
+- [ ] #1 A third overlay window dedicated to secondary subtitles is created and managed alongside existing visible/invisible windows.
+- [ ] #2 Secondary window visibility follows secondary mode semantics (`hidden`/`visible`/`hover`) independent of primary overlay visibility.
+- [ ] #3 Secondary subtitle text/mode/style updates are routed directly to the secondary window renderer path.
+- [ ] #4 Pointer passthrough/interaction behavior for secondary window is explicit and does not regress existing hover/selection interactions.
+- [ ] #5 Window cleanup/lifecycle (create, close, restore) integrates with existing overlay runtime lifecycle.
+<!-- AC:END -->

backlog/archive/tasks/task-20.5 - Add-rollout-guards-tests-and-validation-matrix-for-content-bounded-overlays.md

@@ -0,0 +1,26 @@
+---
+id: TASK-20.5
+title: 'Add rollout guards, tests, and validation matrix for content-bounded overlays'
+status: To Do
+assignee: []
+created_date: '2026-02-12 09:43'
+labels: []
+dependencies: []
+parent_task_id: TASK-20
+priority: medium
+---
+
+## Description
+
+<!-- SECTION:DESCRIPTION:BEGIN -->
+Add safety controls and verification coverage for the new content-bounded overlay architecture and secondary top-bar window.
+<!-- SECTION:DESCRIPTION:END -->
+
+## Acceptance Criteria
+<!-- AC:BEGIN -->
+- [ ] #1 Feature flag or equivalent rollout guard exists for switching to new sizing/window behavior.
+- [ ] #2 Service-level/unit tests cover bounds clamping, jitter thresholding, invalid measurement fallback, and per-layer updates.
+- [ ] #3 Manual validation checklist documents and verifies wrap/no-wrap, style changes, monitor moves, tracker churn, modal interactions, and simultaneous overlay states.
+- [ ] #4 Regression checks confirm existing single-layer and startup/shutdown behavior remain stable.
+- [ ] #5 Task includes explicit pass/fail notes from validation run(s).
+<!-- AC:END -->