# Changelog

## 3.2.1 — Monitor Desk — 2026-09-25

- Renamed to **Monitor Desk** (formerly Monitor Switcher). The plugin ID
  `case.monitor-switcher`, the `monitor-switcher` command, config and state
  paths, IPC target and shortcuts are unchanged; updating is seamless.
- The panel opens at its full height whenever the screen has room, so Text
  size and the shortcut row are no longer hidden below a fixed 600-unit cap.
  It still scrolls on screens too short to fit it.
- New artwork: the complete panel on the real MSI desktop (3840×2160,
  187.5%), with short feature bullets beside it.

## 3.2.0 — Monitor rotation — 2026-09-25

- Rotate any active display from a small button on its chin, or press `O`.
  A popup offers Landscape, Portrait (turned right or left) and Upside down,
  each with an orientation glyph; the current choice is checked.
- Every rotation is a verified 20-second Keep/Revert trial, from the panel or
  the new `monitor-switcher rotate <id> <0|90|180|270|next|prev|t0–t7>` verb.
  Revert restores config, generated rules and positions byte for byte.
- Pivot-stand reflow: a turned screen keeps its row/column edge and centres on
  the other axis; neighbours slide to stay touching. Other layouts pivot about
  the centre or take the nearest free touching edge. Impossible layouts are
  refused before any change. Half turns move nothing; mirroring is preserved.
- Portrait cards keep true proportions in a readable slot. Their refresh and
  scale controls stack; the card animates when its orientation changes.
- Arrange, returning-display placement and rotation share one connectivity
  check and one nearest-free-edge search.
- Narrow portrait tiles in Arrange show just their name instead of spilling
  the "Click to select" hint outside the tile.
- Fresh high-DPI MSI artwork: management hero, rotation menu and arrangement,
  with the Night Light menu linked.
- Tests: rotation trials, keep/revert, row/column/L-shaped reflow, value
  parsing and refusals (backend); portrait gallery geometry and rotation
  model (Node); chin popup targeting, upward opening and portrait control
  spacing (QML). Verified live on the Acer at 90° and 270°.

## 3.1.3 — Apps re-layout after display changes — 2026-09-20

- Windows on a monitor that was just enabled, re-scaled or repositioned now
  re-render correctly instead of keeping a stale buffer scale or workspace
  origin (which showed apps cut off at the screen edge while the compositor
  reported correct coordinates). After a verified change, the affected
  output is briefly bounced (disable → enable), making the compositor resend
  geometry and fractional scale to every client — GTK, Qt and terminal apps
  all re-adjust. Text-size changes made through the panel's scale controls
  are covered by the same path. Monitors whose configuration did not change
  are never bounced.

## 3.1.2 — Driver wedge recovery — 2026-09-20

- Recover from the NVIDIA/aquamarine "GPU wedge" without a reboot: when an
  expected-enabled, physically connected monitor comes back modeless (0×0)
  because the driver rejected every atomic modeset, the backend now bounces
  the output through a disable → settle → enable cycle, releasing and
  re-acquiring its CRTC. Works for any output, so any monitor combination is
  covered. A recoverable wedge completes the change; an unrecoverable one
  rolls back cleanly and names the driver as the cause.
- Regression tests simulate both a recoverable and an unrecoverable wedge in
  the fail-closed compositor fixture.

## 3.1.1 — Stability fixes — 2026-09-17

- Keep an interrupted arrangement drag (focus loss, lock screen) instead of
  discarding the draft.
- Bound every backend lock wait and panel process: a stuck compositor call now
  surfaces an error instead of leaving all panels disabled.
- Night Light survives transient compositor stalls and a mid-session broken
  monitor configuration, and reports when it cannot start at all.
- A failed background state read no longer hides a concurrent successful one
  across panels; the Night Light menu closes when the panel scrolls.
- Unchanged config and state files are no longer rewritten on every poll: the
  unchanged-check compared against a glob pattern, so JSON always "differed".
- Tests: green-path move/swap/pack coverage, poll byte-stability, Night Light
  fault recovery, and a lint gate compiling every shipped QML file.

## 3.1.0 — Monitor management and independent Night Light — 2026-09-16

- Set and save Night Light independently for each monitor; open its temperature
  menu from its own toggle without hiding the monitor specifications.
- Keep the temperature menu onscreen, opening above the toggle when space is tight.
- Adapt the gallery to logical screen dimensions and scaling; wrap before the
  status/resolution and refresh/scale controls become crowded.
- Add subtle screen/casing gradients, reflected light and clear focus borders.
- Make room for a returning middle monitor after closing its gap; reopen the
  horizontal slot or choose a free adjoining edge, with verified rollback.
- Restore the last verified layout for the connected monitor combination.
- Finish power changes even when disabling their initiating monitor panel.
- Verify rollback before discarding backups and preserve first-run positions.
- Surface bounded brightness/text-size command failures.
- Replace the old text-heavy artwork with three fresh high-DPI MSI captures:
  monitor-management hero, independent Night Light feature and arrangement.
- Keep the public name “Monitor Switcher”; versions belong in release metadata.
- Add responsive QML and returning-display/rollback tests; see HANDOFF.md.

## 3.0.1 — Clearer confirmations — 2026-09-16

- Fixed stale red “refresh change pending” messages after a preview finished.
- Synchronize pending state across monitor panels. Extra clicks stay blocked
  until fresh compositor state arrives, including after reopening the panel.
- Selecting the current setting no longer starts a preview. Focus can change
  while a preview is pending.
- Expected confirmation conflicts and timeouts use normal status feedback;
  genuine failures remain visible and can be dismissed.
- Keep first-run diagnostics separate from JSON state. Added regressions for
  cross-panel timing, stale reads, expiry, no-op selections and initialization.

## 3.0.0 — A major redesign — 2026-09-16

**Your desk. In order.** A major overhaul of the display panel: settings on the
screen, switches beneath it, and a new way to arrange your desktop.

- Click resolution, refresh or scale to edit.
- Turn each display on or off with its own switch.
- Drag and snap screens into place.
- Try changes with 20-second Keep / Revert.
- Keep the original shortcut. Reveal more when you need them.

### Details

- Refined the panel with rounded surfaces, sans-serif typography, subtle focus
  accents and clearly clickable resolution, refresh and scale chips.
- Embedded specifications and diagonal size markers in physically proportioned
  monitors. Added On/Off switches below the stands with pending feedback.
- Kept the original Super+Shift+Ctrl+1…N hint; additional controls are available
  through More shortcuts instead of a dense default footer.
- Added Arrange: drag-and-snap desktop positions, relative placement buttons,
  horizontal alignment, overlap/connectivity validation and atomic Keep/Revert.
- Added focus through Hyprland's typed Lua dispatcher and per-card mode/scale
  trials. One panel instance owns IPC and routes requests to the focused screen.
- Modeless monitors no longer block discovery of every display. Running and
  saved settings are distinct, errors are visible, and changes verify actual
  mode, scale, rotation, position and power before reporting success.
- Reject duplicate output entries, reconcile unambiguous hardware reconnection,
  exclude FALLBACK adoption and preserve exact power intent on failures.
- Expanded backend/model regressions and added offscreen UI tests for dragging,
  per-card targeting, wheel behavior and power-switch feedback.

## 2.6.1 - 2026-09-08

- Added an original two-monitor/slider logo to the bar, panel header and
  README. The live vector follows the active theme without changing controls.
- Refreshed the MSI 4K/240 Hz screenshots to show the branded panel header.

## 2.6.0 - 2026-09-08

- Integrated On/Off buttons and number/size/resolution/scale metadata into
  the gallery, removing the duplicate bottom display list. Keyboard shortcuts
  and the existing footer are preserved. Scale uses the same stepped slider
  design as refresh, including custom current settings.
- Wheel gestures now scroll the panel without changing settings; removed
  scroll-to-change brightness from the bar icon.
- Theme-aware monitor gallery with proportioned displays, dimmed off screens,
  focused-display highlighting, and a prominent live refresh readout.
- Supported-mode refresh step bar with drag preview, keyboard control and
  persistent changes. A 20-second Keep/Revert trial is protected by an
  independent watchdog, verified live modes and full config/layout rollback.
- Serialized backend changes, bounded reloads, retryable rollback and recovery
  of expired trials after interruption. Added isolated backend and model tests.
- Ordinary display actions now restore the previous generated rules as well
  as config/state when reload validation fails.
- Updated documentation and clean screenshots showing the MSI at 4K/240 Hz.

## 2.5.3 — 2026-08-24

- **Marketplace review round 2** (#1918): `safe_read()` no longer
  checks-then-opens. It opens the file first, then verifies type *and* true
  byte size through the open descriptor (`/proc/self/fd`), under a timeout
  so a swapped-in fifo fails closed instead of blocking. Oversized files
  are rejected by exact size — a capped prefix that happens to be valid
  JSON no longer passes.
- **Scale pills actually change scale now.** They previously routed to
  `omarchy-hyprland-monitor-scaling`, which applies a runtime-only rule
  with `position = "auto"` and a mode string built from the live refresh
  rate (e.g. `3840x1600@74.977`) that some panels reject outright — and
  anything that did apply was reverted by the generated layout on the next
  reload. New backend verb `monitor-switcher scale <id> <factor>` rounds to
  a Hyprland-clean scale against the configured mode, persists it to
  config.json, and re-applies through the overlap validator (packing
  reflows; pinned positions are still validated, with rollback on refusal).
  The panel's scale pills route through it. Fork patch list grows to
  eleven (UPSTREAM.md).

## 2.5.2 — 2026-08-24

- **Security hardening** (marketplace review on submission #1918): all
  backend file I/O now funnels through two guarded helpers. Reads refuse
  symlinks and non-regular files (a planted fifo would otherwise block a
  read forever), cap at 1 MB, and require valid JSON; writes refuse
  symlinked parents/targets and go through mktemp + atomic rename, so a
  link planted at a target path is *replaced*, never followed — and a crash
  mid-write never leaves a truncated file. Unreadable state degrades to the
  safe default with a warning; an unreadable config fails loudly with
  recovery guidance.
- Panel: every `Process` feeding a `StdioCollector` is output-capped at the
  command level (`| head -c N`, argv-safe) — the installed StdioCollector
  has no size limit, so the bound lives in the spawned command. Fork patch
  list grows to ten (UPSTREAM.md).

## 2.5.1 — 2026-08-23

- Popup footer simplified to a single line — "Keyboard shortcut:
  SUPER+SHIFT+CTRL+1…N" (shown with 2+ displays). The navigation-key
  rundown was crowded; the README already covers the keys.

## 2.5.0 — 2026-08-23

- **Numbered displays.** Every managed monitor now has a stable number — its
  place in the config/pack order (left-to-right). The CLI accepts it
  everywhere an output or alias works (`monitor-switcher toggle 2`), `state`
  prints it, and panel rows are prefixed with it (`2 · LG · focused`), so
  the keybind target is visible in-product. Numbers need no aliases and
  survive output renumbering, which makes generic keybinds possible:
  `SUPER+SHIFT+CTRL+1…N → monitor-switcher toggle 1…N` works on any
  multi-monitor setup with zero configuration.
- **Keybind discoverability**: the popup footer gains a second hint line
  suggesting exactly that convention ("keybind to adopt:
  SUPER+SHIFT+CTRL+1…N → toggle display N", shown when 2+ displays are
  managed), and the README now documents that described `o.bind` entries
  appear in Omarchy's `SUPER+K` keybindings sheet like first-party
  shortcuts.
- New preview.png: numbered rows, both footer hints, and a toggled-off
  monitor row (slashed glyph, no check).

## 2.4.0 — 2026-08-23

- **Keyboard hints footer in the popup** — a caption line under DISPLAYS
  (`↑↓ navigate · ←→ adjust · ⏎ toggle display · esc close`) so the
  keyboard-first flow is discoverable in-product, not just in the README.
  Fork patch list grows to nine; see UPSTREAM.md.
- New `preview.png`: real three-monitor battlestation data (aliases,
  physical sizes, resolution@scale) instead of generic content.
- README: leads with desktop multi-monitor switching and keyboard-driven
  on/off; documents the hints footer.

## 2.3.0 — 2026-08-23

- **Overlap-proof layouts.** `apply()` computes every monitor's box and
  validates the set before writing anything: a colliding layout is refused
  with a clear message and the last known-good generated file is kept, so
  Hyprland's "Monitor X overlaps with other monitor(s)" notification can no
  longer originate from this plugin. Refusals roll back config, state, and
  layout together (`move`/`swap`/`pack`/`toggle` all revert cleanly).
- **Geometry now comes from the config, never the live mode.** Packing
  previously measured each monitor's *currently running* mode while the
  generated rule applied the *configured* one — a monitor answering hyprctl
  with a transient fallback mode mid-toggle (hotplug re-enumeration, the
  watcher's modeless-recovery churn) shifted everything right of it and
  could produce an overlapping layout. Mode dimensions for `preferred`
  monitors are snapshotted into `mode_w`/`mode_h` at seed/adopt time;
  existing configs backfill automatically on the next run. (Regression-
  tested: live mode forced to 2560x1440 while `preferred` is 3840x2160 —
  computed layout unchanged.)
- **Transform-aware packing**: portrait monitors (transform 1/3/5/7) now
  advance the pack cursor by their rotated width instead of their panel
  width.
- **Settle-checked live reads**: a `hyprctl` answer is only trusted once it
  is complete (no enabled monitor at 0x0) and identical across two reads —
  partial/mid-transition data can no longer drop a monitor from the
  generated layout into the wildcard `auto` rule.
- **Manual arrangement (CLI)**: `move <id> XxY` and
  `move <id> left-of|right-of|above|below <id2>` (relative moves compute the
  pin for you, negative coordinates fine), `swap <a> <b>` (exchange places
  in the packing order), `pack` (clear all pins, re-pack), and
  `plan [--json]` (preview computed boxes, with an overlap warning, without
  touching anything). Config schema gains an optional per-monitor
  `"position": "XxY"` pin — vertical stacks, intentional gaps, any
  arrangement Hyprland allows.
- `state --json` gains per-monitor `x`/`y`/`position` and a top-level
  `overlaps` array computed from the live layout; plain `state` prints
  overlap warnings and per-monitor positions.

## 2.2.0 — 2026-08-23

- DISPLAYS rows now show each monitor's **physical size** (e.g.
  `27" · 3840×2160 @1.875x`), derived from EDID-reported dimensions via
  `hyprctl monitors all` (`physicalWidth`/`physicalHeight`) — nothing is
  hardcoded; 0 mm falls back to no size label.
- Per-row icons by display class, classified in the backend: laptop
  (internal eDP/LVDS/DSI), ultrawide (pixel aspect ≥ 2.3), tv (≥ 38"),
  otherwise a desktop monitor. Toggled-off rows always show the slashed
  monitor-off glyph.
- Hotplug reactivity: the panel refreshes state whenever the enabled-screen
  count changes (`Quickshell.screens`), so plugging/unplugging a monitor —
  or toggling one from a keybind while the panel is open — updates rows and
  the bar glyph immediately instead of waiting for the 5s poll.
- The popup now **reopens itself after a row toggle**: the backend's
  `hyprctl reload` remaps bars on screen-count changes, which destroyed the
  popup mid-flow. Toggling several monitors in one visit works again.
- Docs: added a "Why this exists" section — source-verified positioning
  against the built-in tooling (laptop-grade persistence for every output),
  with a who-it's-for list reusable for launch posts.
- Docs: corrected the watcher claim (verified against source) —
  `omarchy-hyprland-monitor-watch` only reloads for genuinely *modeless*
  monitors (enabled but 0x0; disabled outputs are excluded from its check),
  and each such reload reverts runtime `hyprctl keyword` toggles as
  collateral. The persistence claim itself is unchanged. Also confirmed: no
  default keybind/CLI/menu path toggles an external monitor (laptop-internal
  toggles exist and use the same toggles-dir mechanism as this plugin).
- Backend hardening after a real corruption event: `hyprctl` can answer
  empty while the compositor is mid-reload, and one such transient emptied
  `config.json` (every writer truncated-then-failed). `live()` now retries,
  config seeding requires a non-empty file (`-s`), derivations validate
  non-empty before writing, and the generated Lua is built fully before
  being written — no truncate-then-fail paths remain. Stress-tested: 10
  concurrent `state` calls during live toggles, zero failures.

## 2.1.0 — 2026-08-23

- DISPLAYS rows show each monitor's **alias** and a `resolution @scale`
  caption (from `bin/monitor-switcher state --json`, merged display-only over
  the upstream model) instead of bare output names.
- The BRIGHTNESS header now names the focused display it controls
  (`BRIGHTNESS · ACER`), mirroring the SCALE header. Upstream's single
  brightness slider only ever targets the focused monitor — and a monitor
  toggled off can't be focused, which read as "brightness missing" for
  switched-off displays. All three monitors here answer DDC fine; it was a
  labeling problem, not a hardware one.

## 2.0.0 — 2026-08-23

The plugin is now a **drop-in replacement** for Omarchy's built-in Display
widget instead of a separate minimal popup.

- Vendored Omarchy 4.0.0's Display panel (`Panel.qml`, `Model.js`; MIT) as a
  minimal-delta fork — every change fenced with `monitor-switcher fork`
  markers, tracked in `UPSTREAM.md`.
- The forked panel keeps all built-in features: brightness slider (+ scroll
  on the bar icon, with OSD), text size slider, scale presets, laptop
  internal/mirror handling, and keyboard navigation.
- `toggleDisplay()` now routes through `bin/monitor-switcher`, so the
  DISPLAYS rows are persistent and layout-aware instead of runtime-only.
- Own IPC target (`case.monitor-switcher`) so both widgets can coexist
  without handler collisions.
- Bar glyph tracks managed monitors (including toggled-off ones), so
  switching a monitor off no longer collapses it to the single-display icon.
- Panel hero reads "Monitor Switcher" for attribution in screenshots.
- `BarWidget.qml` removed — the manifest now points straight at `Panel.qml`,
  like every first-party panel.
- README: removal of the built-in widget is documented as
  `omarchy plugin disable omarchy.monitor` (official, reversible) instead of
  hand-editing `shell.json`; keyboard docs describe arrow keys only (the
  shell's shared key handler also answers to hjkl — that comes from Omarchy's
  `PanelKeyCatcher`, not this plugin).
- `preview.png` retaken with the forked panel.

## 1.0.0 — 2026-08-23

Initial release.

- Bar widget with a minimal checkbox popup: alias, output, resolution@scale
  per monitor; focused/disconnected states; last-enabled row locked.
- Keyboard navigation in the popup: `j`/`k` move, `Enter`/`Space` toggle,
  `Esc` close.
- `bin/monitor-switcher` CLI: `state [--json]`, `toggle|enable|disable`
  (by output name or alias), `apply`.
- Persistent toggles via a generated Lua file in Omarchy's Hyprland toggle
  directory — survives reloads, reboots, and `omarchy-hyprland-monitor-watch`.
- Layout memory: enabled monitors pack left-to-right in config order, each
  with its own `scale`, `mode`, and `transform`.
- Auto-adoption: config is seeded from the live setup on first run; newly
  connected monitors are appended automatically.
- Guards: refuses to disable the last active display; disconnected monitors
  keep their settings.