[AlexGeslani]

Summary

Release StackLogic v0.2.0-beta.1 from the validated dev branch to main.

This beta minor release adds four persistent themes, theme-aware brick rendering, Matrix rain with bounded lifecycle ownership, pause-time theme switching, solid Matrix/Dark palettes, and input-capability-based controls for iPad-class touch devices.

Public production target: https://vector-sigma-works.github.io/StackLogic/

User-visible changes

• Default, Matrix, CandyPop, and Dark themes
• Persistent theme choice
• Matrix rain behind the interface and game
• Solid Matrix green bricks and solid Dark grayscale bricks
• Dedicated pause menu with theme selection
• Wide touch-device controls in landscape and portrait
• Reduced-motion handling that allocates no Matrix rain resources

Validated implementation chain

1. a38013d — title and theme scaffolding
2. bd9ff25 — theme-aware renderer foundation
3. 2bc4a6c — Matrix rain lifecycle controller
4. 712d2f4 — synchronous theme-change contract
5. a124129 — deterministic Matrix rain adapter
6. 156d81e — browser Matrix rain integration
7. def2ddc — solid palettes, tablet controls, and pause themes
8. e92bbab — PR test gate and test-dependent Pages deployment
9. 28f701d — release metadata, documentation, and cache-busted module graph
10. 1dc4980 — lockfile-only remediation of Express transitive advisories
11. 69aab58 — suppress implicit root favicon 404 on Pages subpath
12. 8f030df — isolate Pages write/OIDC authority to the deploy job
13. 50e50aa — close contrast, radio-keyboard, and live reduced-motion gaps

Merge method: merge commit, preserving this independently validated history.

Verification completed

• npm test: 91/91 PASS
• JavaScript syntax checks: PASS
• git diff --check: PASS
• Canonical dev browser Matrix acceptance: PASS
• Exact live canvas fill trace: PASS
  • Matrix observed only approved solid green values
  • Dark observed only approved grayscale values
• Matrix lifecycle, duplicate-owner, cleanup, resize/DPR, persistence, stacking, hit-testing, and reduced-motion gates: PASS
• iPad-class 1366×1024 and 1024×1366 touch-control visibility/hit-testing: PASS
• Pause-time Dark/Matrix switching with frozen board and explicit resume: PASS
• Browser console/page errors: zero
• npm audit --omit=dev: 0 vulnerabilities
• Full browser acceptance served beneath /StackLogic/: PASS
• Workflow authority contract: PR tests are read-only; deploy-only Pages/OIDC writes: PASS
• Selected-label contrast: Matrix 13.36:1, CandyPop 7.05:1
• ARIA radio Arrow/Home/End navigation and synchronized roving focus: PASS
• Live reduced-motion stop/restart without reload: PASS

Evidence is preserved under the local StackLogic loop run 20260725T074821-0400.

Release controls

• Pull requests run the test job without deploying.
• Pushes to main deploy only after the test job succeeds.
• Direct entry assets and the Matrix module import graph use the release version query string.
• Public HTML exposes <meta name="stacklogic-version" content="0.2.0-beta.1"> for deployment verification.

Documentation

• README.md version updated
• CHANGELOG.md structured into Unreleased, 0.2.0-beta.1, and 0.1.0-beta.1
• Detailed release note: docs/releases/v0.2.0-beta.1.md
• Package and lockfile versions aligned

Known boundary

Web applications cannot directly detect whether an iPad hardware keyboard is docked. The implementation uses (hover: none) and (pointer: coarse). Automated iPad-class viewport and hit-testing pass. Physical Safari remains a hardware/browser acceptance boundary and is not represented as physically verified in this PR.

Rollback

Before merge, tag current production commit 07e5f1772f1daab2764bbe5c5f3f3cb4d09fca34 as v0.1.0-beta.1.

If public verification fails:

1. Revert the release merge commit through a rollback PR using git revert -m 1 <merge-sha>.
2. Require the same test gate.
3. Let GitHub Pages deploy the revert.
4. Verify public production returned to the baseline behavior.

Do not force-reset main or move release tags.

Promotion checklist

• Candidate frozen
• Canonical dev URL accepted by automated browser gates
• Exact canvas colors verified
• Release metadata and cache boundaries tested
• Release documentation committed
• GitHub PR test check green
• Aggregate independent review complete
• main protected with required PR/check policy
• v0.1.0-beta.1 rollback tag created and verified
• Merge commit created
• GitHub Pages deployment green
• Public URL acceptance green
• v0.2.0-beta.1 tag and GitHub Release published