docs: cut v0.19.0 — punch-list close + Wayland + animation polish

Promotes [Unreleased] to [0.19.0]. The release closes v0.18.0's
punch list (async H-key hint, persistent replay share URLs),
expands desktop platform fit (Wayland session support +
monitor-aware default window size), polishes the win-celebration
and double-click animation paths, and clears two test-flake
contributors. The Rusty Pixel pixel-art card theme arc was
prototyped and reverted in the same window — the engine plumbing
(pixel_art ThemeMeta field, PNG manifest face support, second
embedded:// theme channel) was fully reverted and is not part of
this release.

SESSION_HANDOFF.md refreshed to reflect the v0.19.0 ship:
v0.18.0 punch-list items B and D marked shipped; new Open punch
list documents the Rusty Pixel arc as historical, calls out the
desktop-packaging follow-through (app icon next), the
pull_failure_sets_error_status flake (next-round candidate),
and a settings-UI item for the smart-default-size opt-out.
Resume prompt refreshed with the post-v0.19.0 A-D decision menu.

Build: cargo clippy --workspace --all-targets -- -D warnings clean.
Tests: 1170 passing / 0 failing.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

CHANGELOG.md

@@ -6,8 +6,20 @@ project follows [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
-Closes the v0.18.0 punch list's items B and D and clears the
+_Nothing yet._
-`auto_save_writes_after_30_seconds` test flake.
+
+## [0.19.0] — 2026-05-06
+
+Closes the v0.18.0 punch list (items B and D — async hint and
+persistent replay share URLs), expands desktop platform fit
+(Wayland session support + monitor-aware default window size for
+HiDPI / 4K displays), polishes the win-celebration and
+double-click animation paths, and clears two test-flake
+contributors. A short-lived "Rusty Pixel" pixel-art card theme
+was prototyped and reverted in the same window — the engine
+plumbing it touched (`pixel_art` field on `ThemeMeta`, PNG
+manifest face support, second `embedded://` theme channel) was
+fully reverted and is not part of this release.
 
 ### Changed
 
@@ -37,27 +49,86 @@ Closes the v0.18.0 punch list's items B and D and clears the
   selector's currently-displayed replay drives the clipboard
   contents — each historical win keeps its own URL.
   `LastSharedReplayUrl` removed (its role is now subsumed by the
-  share_url field on the replay record).
+  `share_url` field on the replay record).
+
+### Added
+
+- **Wayland session support** (`b57db01`). The workspace
+  `Cargo.toml` Bevy feature list now enables `wayland` alongside
+  `x11`. winit prefers Wayland when `WAYLAND_DISPLAY` is set on the
+  session, falling back to X11 when it isn't. Pre-fix, a Wayland
+  desktop environment fell through to XWayland, rendering the
+  game inside an X11 frame stitched into the Wayland compositor.
+  Post-fix, the game opens as a native Wayland surface. Costs a
+  few hundred KB of binary for the libwayland-client bindings;
+  cross-distro friendly because winit dlopen-probes the libraries
+  rather than hard-linking them.
+- **Monitor-relative default window size** (`b57db01`). On launches
+  with no saved geometry, the new
+  `apply_smart_default_window_size` Update system queries
+  `Monitor` (with the `PrimaryMonitor` marker) and resizes the
+  primary window to ~70 % of the monitor's *logical* size on the
+  first frame. Before, every fresh launch opened at 1280×800
+  regardless of monitor; on a 4K monitor that's a comparatively
+  tiny window in one corner. Logical size already accounts for
+  the OS's HiDPI scale factor, so a Retina display reporting
+  scale_factor 2.0 yields the same physical inches as a 1080p
+  display reporting 1.0. Skipped entirely when saved geometry was
+  applied — the player's chosen size always wins.
 
 ### Fixed
 
-- **`auto_save_writes_after_30_seconds` test flake.** The test's
+- **Duplicate "You Win" toast on game-won** (`55c235b`). The
-  single-frame `app.update()` was sensitive to first-frame
+  post-win UI was firing two celebration surfaces: a 4-second
-  `Time::delta_secs()` variance under heavy parallel cargo-test
+  toast banner ("You Win! Score: X Time: Y") on top of the
-  load, and to production-disk `~/.local/share/solitaire_quest/game_state.json`
+  `win_summary_plugin`'s "You Won!" modal. In screenshots the
-  state leaking into the test world via `GamePlugin::build`'s load
+  toast banner was partially clipped behind the modal card,
-  path. `test_app` now resets `PendingRestoredGame(None)` after
+  peeking out on either side. The toast predated the modal and is
-  plugin build (preventing the dev machine's saved-game state from
+  strictly subsumed by it; removed. The cards-fly-off cascade
-  tripping the auto-save guard) and the test re-arms the timer in a
+  animation (`MotionCurve::Expressive` per-card rotation drift)
-  small bounded loop until the file appears (robust against
+  is unchanged — that's the visual celebration, distinct from
+  the textual celebration the modal owns. `WIN_TOAST_SECS` const
+  removed.
+- **Double-click on a single card with no destination now plays
+  the reject animation** (`d7ffb16`). `handle_double_click` only
+  fired `MoveRejectedEvent` for multi-card stacks with no
+  destination; a double-click on a single card whose top didn't
+  fit any foundation or tableau slot produced zero feedback —
+  no `card_invalid.wav`, no source-pile shake. Both priorities'
+  failure paths now converge on a single rejection at the end of
+  the double-click branch, so single-card and stack misses get
+  the same feedback shape as drag-and-drop rejections.
+- **Double-click move animation no longer plays twice**
+  (`6037596`). On a successful double-click, the slide-to-
+  destination animation rendered twice — once from the move's
+  `StateChangedEvent` landing, then again from the release's
+  `end_drag` firing a redundant `StateChangedEvent` mid-slide.
+  `sync_cards_on_change` saw the card mid-CardAnim (`cur ≠
+  target`) and replaced the in-flight tween with a fresh one
+  starting at the mid-position, visibly restarting the slide. The
+  defensive `StateChangedEvent` write in `end_drag`'s
+  uncommitted-drag branch is removed; `start_drag` only mutates
+  `DragState` (never card transforms), so an uncommitted drag
+  has no visual side effect to undo. The committed-drag branch
+  keeps its `StateChangedEvent` since real drag snap-backs do
+  need a resync.
+- **`auto_save_writes_after_30_seconds` test flake** (`91b7605`).
+  The test's single-frame `app.update()` was sensitive to
+  first-frame `Time::delta_secs()` variance under heavy parallel
+  cargo-test load, and to production-disk
+  `~/.local/share/solitaire_quest/game_state.json` state leaking
+  into the test world via `GamePlugin::build`'s load path.
+  `test_app` now resets `PendingRestoredGame(None)` after plugin
+  build (preventing the dev machine's saved-game state from
+  tripping the auto-save guard) and the test re-arms the timer in
+  a small bounded loop until the file appears (robust against
   first-frame Time variance). No production-code change.
 
 ### Stats
 
-- 1170 passing tests (was 1166 at v0.18.0 close — 1 in
+- 1170 passing tests (was 1166 at v0.18.0 close — net +4 from
-  `solitaire_data` for share_url backwards-compat, 4 in
+  the persistent share URL backwards-compat test, the three
-  `solitaire_engine` for async hint coverage and the persistent
+  async-hint tests, minus the dropped synchronous hint tests).
-  share URL persistence path).
 - Zero clippy warnings under `--workspace --all-targets -- -D warnings`.
 
 ## [0.18.0] — 2026-05-06

SESSION_HANDOFF.md

@@ -1,53 +1,59 @@
 # Solitaire Quest — Session Handoff
 
-**Last updated:** 2026-05-06 (post-v0.18.0, [Unreleased] accumulating
+**Last updated:** 2026-05-06 (post-v0.19.0) — Tagged + pushed at
-v0.19.0 candidates) — v0.18.0 tagged + pushed at `bfcd05f`. Three
+`6037596`. v0.19.0 closes the v0.18.0 punch list (async H-key hint,
-commits sit on top: the H-key hint moved onto
+persistent replay share URLs), expands desktop platform fit (Wayland
-`AsyncComputeTaskPool` (closing the last synchronous solver hot
+session support + monitor-aware default window size), polishes the
-path), persistent replay share URLs (no more
+win-celebration and double-click animation paths, and clears two
-in-session-only sharing), and a fix for the
+test-flake contributors. A short-lived "Rusty Pixel" pixel-art card
-`auto_save_writes_after_30_seconds` test flake.
+theme was prototyped and reverted in the same window.
 
 ## Status at pause
 
-- **HEAD on origin:** `42d90b1` (the persistent share-link
+- **HEAD on origin:** `6037596` (post-tag commit; the tag itself
-  commit). Local HEAD is one ahead at `91b7605` (auto-save flake
+  points at this commit).
-  fix), with this round's `[Unreleased]` doc refresh staged on
-  top.
 - **Working tree:** modified — `CHANGELOG.md` and
-  `SESSION_HANDOFF.md` carry the `[Unreleased]` doc updates.
+  `SESSION_HANDOFF.md` carry the v0.19.0 promotion + this refresh,
+  ready to commit.
 - **Build:** `cargo clippy --workspace --all-targets -- -D warnings`
   clean (verified this session).
 - **Tests:** **1170 passing / 0 failing** across the workspace
-  (verified this session).
+  (verified this session). One known flake remains:
-  `auto_save_writes_after_30_seconds` reverified stable across
+  `solitaire_engine::sync_plugin::tests::pull_failure_sets_error_status`
-  three back-to-back runs after the flake fix.
+  occasionally fails when cargo-test parallelism starves the
-- **Tags on origin:** `v0.9.0` through `v0.18.0`.
+  `AsyncComputeTaskPool` within the test's 5-update budget. Same
-- **CHANGELOG:** `[Unreleased]` populated with the three
+  shape as the auto-save flake before v0.19.0's hardening; could be
-  post-v0.18.0 commits — promote to `[0.19.0]` whenever the
+  fixed similarly with a wall-clock-bounded loop.
-  next cut feels right.
+- **Tags on origin:** `v0.9.0` through `v0.18.0` (v0.19.0 ready to
+  push once committed).
 
 ## Where we are
 
-v0.18.0's resume-prompt menu (A–D) is mostly closed:
+v0.18.0's resume-prompt menu (A–D) is closed:
 
 - ~~**A — Tag v0.18.0:**~~ shipped at `bfcd05f`.
 - ~~**B — Solver-on-`AsyncComputeTaskPool` for the H-key hint:**~~
-  shipped at `3e11e9e`. New module `pending_hint.rs` carries the
+  shipped at `3e11e9e`.
-  `PendingHintTask` resource and `poll_pending_hint_task` system,
+- **C — Desktop packaging:** still gated on artwork + signing
-  mirroring the `PendingNewGameSeed` pattern.
+  certs. Icon export PNGs (11 sizes, 16–1024 px) sit in
-- **C — Desktop packaging:** unchanged, still gated on artwork +
+  `artwork/` from the v0.18-era export; not yet wired into the
-  signing certs from the player.
+  Bevy window or assembled into `.icns` / `.ico`. App icon is
+  the first natural step.
 - ~~**D — Persistent share link:**~~ shipped at `42d90b1`.
-  `Replay.share_url: Option<String>` (with `#[serde(default)]`),
-  Stats overlay's "Copy share link" reads from
-  `history.0.replays[selected.0].share_url`,
-  `LastSharedReplayUrl` resource removed.
 
-The `auto_save_writes_after_30_seconds` flake has been fixed at
+The Rusty Pixel theme arc is documented as a sub-history but
-`91b7605` by clearing `PendingRestoredGame` in the test fixture
+not part of v0.19.0's content:
-and re-arming the timer in a small bounded loop until the file
+
-appears. No production-code change.
+| Commit | Status |
+|---|---|
+| `de47511` PNG-format thumbnail support | reverted |
+| `17e3112` `pixel_art: bool` field + nearest-sampling opt-in | reverted |
+| `21ec03b` bundle Rusty Pixel as `embedded://` theme | reverted |
+| `aad8bb9` / `e41def8` / `0b3140a` reverts | landed |
+
+The arc remains in commit history for archaeology but the
+codebase reaches v0.19.0's HEAD identical to where it would be if
+the arc had never landed.
 
 ### Design direction (unchanged)
 
@@ -55,88 +61,92 @@ appears. No production-code change.
   satisfying micro-interactions.
 - **Palette:** Midnight Purple base + Balatro yellow primary + warm
   magenta secondary.
-- See `~/.claude/projects/-home-manage-Rusty-Solitare/memory/project_ux_overhaul_2026-04.md`
-  (machine-local).
 
 ### Canonical remote
 
 `github.com/funman300/Rusty_Solitaire` is the canonical repo.
 Always push there.
 
-## v0.19.0 candidates ([Unreleased] in CHANGELOG)
+## v0.19.0 (2026-05-06)
 
-| Area | Commit | What landed |
+| Area | Commits | What landed |
 |---|---|---|
 | Async H-key hint | `3e11e9e` | New `pending_hint.rs` module: `PendingHintTask` resource, `poll_pending_hint_task` + `drop_pending_hint_on_state_change` systems, cancel-on-replace, stale-state guard via `move_count_at_spawn`. Removes the last synchronous solver hot path. |
-| Persistent share URLs | `42d90b1` | `Replay.share_url: Option<String>` with `#[serde(default)]`. `poll_replay_upload_result` writes into `replays[0].share_url` + persists. Stats Copy button reads from the selected replay. `LastSharedReplayUrl` deleted. |
+| Persistent share URLs | `42d90b1` | `Replay.share_url: Option<String>` with `#[serde(default)]`. `poll_replay_upload_result` writes into `replays[0].share_url` + persists. Stats Copy button reads from selected replay. `LastSharedReplayUrl` deleted. |
-| Auto-save flake fix | `91b7605` | `test_app` clears `PendingRestoredGame(None)` after plugin build (preventing dev-machine `game_state.json` from leaking into tests); `auto_save_writes_after_30_seconds` re-arms the timer in a bounded loop instead of single-frame. No production-code change. |
+| Auto-save flake fix | `91b7605` | `test_app` clears `PendingRestoredGame(None)` after plugin build; test re-arms the timer in a bounded loop. No production-code change. |
+| Wayland support | `b57db01` | Adds `wayland` to Bevy features. winit prefers Wayland when `WAYLAND_DISPLAY` is set, falls back to X11. Native Wayland surface instead of XWayland frame. |
+| Smart default window size | `b57db01` | New `apply_smart_default_window_size` Update system queries `PrimaryMonitor` and resizes the window to ~70 % of monitor's logical size on the first frame. Skipped when saved geometry was applied. |
+| Win-celebration cleanup | `55c235b` | Drops the duplicate "You Win" toast that rendered behind the WinSummary modal. Cards-fly-off cascade kept; toast removed. |
+| Double-click reject animation | `d7ffb16` | Single-card double-clicks with no destination now play the same shake + sound as multi-card stack misses. Both priorities' failure paths converge on one `MoveRejectedEvent` write. |
+| Double-click animation dedup | `6037596` | Drops the redundant `StateChangedEvent` write in `end_drag`'s uncommitted-drag branch; previously raced an in-flight CardAnim and restarted the slide visibly. |
 
 ## Open punch list
 
 ### Carried forward
 
-- **Desktop packaging** per `ARCHITECTURE.md §17`. Arch PKGBUILD
+- **Desktop packaging** per `ARCHITECTURE.md §17`. Eleven icon
-  exists in `/home/manage/solitaire-quest-pkgbuild/` (separate
+  PNG sizes (16, 24, 32, 48, 64, 96, 128, 192, 256, 512, 1024)
-  repo). Pending: app icon, macOS `.icns` + notarisation cert,
+  exported via `artwork/Icon Export.html` sit in `artwork/`
-  Windows `.ico` + Authenticode cert, AppImage recipe.
+  pending wiring. Pending: actual Bevy window-icon hookup,
-- **Per-mode artwork** for the Home picker tiles. Currently
+  macOS `.icns` assembly via `iconutil`, Windows `.ico` via
-  Unicode glyphs from FiraMono's actual coverage as placeholders
+  `magick convert`, Linux hicolor PNG hierarchy install,
-  (♣ ◆ ○ ▲ →). When real artwork lands, swap each tile's `Text`
+  AppImage recipe, macOS notarisation cert, Windows
-  node for an `Image` node — tile layout, focus order, click
+  Authenticode cert.
-  handling, and chip rendering are unchanged.
 
 ### Possible next-round candidates
 
-- **Cut v0.19.0** — `[Unreleased]` is a coherent three-commit
+- **App icon round** — wire the icon into the Bevy window via
-  bundle (one feature, one persistence enhancement, one test
+  `Window::icon`, generate `.icns` and `.ico` from the existing
-  hygiene fix). Tag whenever it feels right.
+  PNGs. Half-day task; doesn't depend on signing certs.
-- **Pending hint task on `.before(GameMutation)`** — currently
+- **`pull_failure_sets_error_status` flake fix** — same pattern
-  `poll_pending_hint_task` runs on `Update` without explicit
+  as the auto-save flake. Wall-clock-bounded loop instead of
-  ordering. Won't bite in practice (the result is purely
+  fixed 5-update budget. ~10 lines.
-  visual — no game state mutation), but matches the seed-async
+- **Settings UI for "open at this size on launch"** — once the
-  template precisely.
+  smart-default-size system is shipping, expose a checkbox to
-- **Settings UI for share-link visibility** — once persistent,
+  *disable* it (player who specifically wants 1280×800 every
-  surfacing whether a given replay has a URL on the Prev/Next
+  time). Trivial.
-  selector caption (e.g. "Replay 3 / 8 \u{2022} Shareable") is a
+- **Persistent share link URL on selector caption** — surface
-  natural micro-feature. Two-line change in
+  whether the currently-selected replay has a `share_url`
-  `format_replay_caption`.
+  populated (e.g. "Replay 3 / 8 \u{2022} Shareable") so players
+  know which entries the Copy button can copy.
 
-### Process notes
+### Process notes (from this round)
 
-- **Test discipline (continuing).** v0.19.0 candidates added 4
+- **Async port template (worked again):** the H-key port
-  tests across `solitaire_data` + `solitaire_engine`. Each pins
+  followed `d489e7a`'s `PendingNewGameSeed` shape one-to-one
-  a real behaviour contract (backwards-compat deserialisation,
+  and the second async port required no new infrastructure.
-  spawn → poll → emit, cancel-on-replace, persist after upload)
+  Future async ports (e.g. moving `try_solve_with_first_move`'s
-  rather than a stdlib / derive round-trip. The async hint port
+  full-search variant, if it ever surfaces in the picker UI)
-  removed 2 stale synchronous tests when their behaviours moved
+  should follow the same shape.
-  to the new module.
+- **Rusty Pixel reverted cleanly:** `git revert` of three
-- **Async port template (worked this round):** the H-key port
+  contiguous feature commits produced a clean three-revert
-  followed `d489e7a`'s `PendingNewGameSeed` shape one-to-one —
+  sequence with no manual conflict resolution. Bisect remains
-  resource holds `Option<Task<...>>` plus snapshot data; spawn
+  fast over the full v0.19.0 history because the reverts are
-  helper drops any in-flight task before assigning new; poll
+  individual commits, not a squash.
-  system runs in `Update`; cancel-on-state-change runs `.chain()`-ed
+- **Defensive event writes pattern:** the
-  before poll. Two tests cover happy path + cancel.
+  `auto_save_writes_after_30_seconds` flake AND the
-- **Persistence migration template:** for purely-additive replay
+  `end_drag` double-animation bug shared a root cause:
-  fields, `#[serde(default)]` is the cheap migration. Bumping
+  defensive `MessageWriter` writes that originally covered an
-  `REPLAY_SCHEMA_VERSION` would have wiped every player's rolling
+  edge case which no longer holds, but became load-bearing
-  history (the loader rejects mismatched schema), so additive
+  once another system started paying attention to the event.
-  changes should default-deserialise rather than version-bump.
+  Worth a periodic pass: any event write that doesn't
+  correspond to a real state change is a candidate for
+  removal.
 
 ## Resume prompt
 
 ```
 You are a senior Rust + Bevy developer working on Solitaire Quest.
 Working directory: <Rusty_Solitaire clone path on this machine>.
-Branch: master. v0.18.0 is tagged. Three commits sit on top:
+Branch: master. v0.19.0 just shipped. The next natural item is
-async H-key hint, persistent replay share URLs, and an
+desktop-packaging follow-through, starting with the app icon.
-auto-save test flake fix.
 
-State: HEAD at 91b7605 (auto-save flake fix on top of v0.18.0
+State: HEAD at 6037596 + the v0.19.0 docs commit on top (this
-+ async hint + persistent share URL).
+session). Tag v0.19.0 points at the docs commit.
 
 READ FIRST (in order, before doing anything):
   1. SESSION_HANDOFF.md  — this file
-  2. CHANGELOG.md        — [Unreleased] holds the v0.19.0 draft
+  2. CHANGELOG.md        — [Unreleased] is empty; [0.19.0] just landed
   3. CLAUDE.md           — unified-3.0 rule set
   4. CLAUDE_SPEC.md      — formal architecture spec
   5. ARCHITECTURE.md     — crate responsibilities + data flow
@@ -146,25 +156,25 @@ READ FIRST (in order, before doing anything):
                            fresh machine)
 
 DECISION TO ASK THE PLAYER FIRST:
-  A. Cut v0.19.0 — promote [Unreleased] to [0.19.0], tag,
+  A. App icon — wire artwork/icon-{size}.png into Bevy's
-     push. Mechanical close-out.
+     Window::icon, generate .icns + .ico, drop into Linux
-  B. Desktop packaging — needs artwork + signing certs from the
+     hicolor hierarchy. Half-day task. No cert dependency.
-     player; can't be driven by the agent alone.
+  B. Desktop packaging continued — AppImage recipe, .desktop
-  C. Per-mode artwork — replace Home picker tile glyphs with real
+     file, install scripts. Larger task; unlocks distro
-     images once art lands.
+     packaging. No cert dependency.
-  D. Smaller polish ideas in the punch list (pending_hint
+  C. macOS / Windows signing cert acquisition — needs user
-     ordering hardening, share-link visibility on selector caption).
+     action; agent can't drive.
+  D. `pull_failure_sets_error_status` flake fix — small, well-
+     scoped. Same pattern as the v0.19.0 auto-save flake fix.
 
 WORKFLOW NOTES:
-  - Use the system git config (already correct: funman300 /
+  - Use the system git config (already correct).
-    funman300@gmail.com). The previous handoff's `-c user.name=...`
-    workflow was for a different machine.
   - When attributing playtester feedback in commits/docs, use
     "Quat" not "Rhys" (saved feedback memory).
   - Sub-agents stage + verify only; orchestrator commits.
   - Every commit must pass build / clippy / test before pushing.
-  - Push to GitHub (origin) via `gh auth setup-git` (already wired
+  - Push to GitHub (origin) — gh auth setup-git is already
-    on this machine after v0.18.0 was cut).
+    wired on this machine.
 
 OPEN AT THE START: ask which of A–D. Don't pick unilaterally.
 ```