Song links, House of the Rising Sun showcase, and a wake-lock fix (v2026.08.26.005)

[cdburgess75]

Two commits. The wake-lock fix is the urgent one — the app has been failing to keep the screen awake since v2026.08.21.001.

Fix: the screen slept on a song (v2026.08.26.005)

navigator.wakeLock.request() returns a WakeLockSentinel that the browser auto-releases every time the page hides, but wakeLock kept pointing at the dead sentinel. The guard if(!wakeLock)requestWake() was therefore never true again, so from the first background/foreground cycle onward the app held no lock at all — on every screen, song view included.

This was masked until v2026.08.21.001: show() used to re-request the lock on each navigation and gig mode held its own, so the stale handle kept getting replaced. Making the lock app-wide removed those calls and left the broken guard as the only re-acquire path.

• requestWake() now tests wakeLock.released rather than the handle, nulls the handle from the sentinel's release event so an OS reclaim is recoverable, and self-guards so redundant calls are free
• visibilitychange re-requests unconditionally; openCurrent() and startScroll() re-assert
• Removed releaseWake() (defined, never called — nothing releases the lock deliberately, the OS does) and an orphaned gig-mode comment block describing code deleted in .21.001
• Corrected CLAUDE.md §4, which still claimed show() manages the wake lock

Feature: share a song as a link (v2026.08.26.003)

Previously a song could only be moved between devices as a file. shareSong() packs {app,kind:"song",version:1,song} into the URL fragment, deflate-raw'd via CompressionStream (z. tag; j. plain-JSON fallback). A full chart fits in ~800 characters.

The fragment is load-bearing: browsers never send it to the server, so a shared chart never reaches a Pages access log. A ?query= would break the no-server constraint in spirit.

Two receive paths, both needed. maybeImportFromLink() reads a #s= fragment at boot, always confirms before writing, then strips the hash so a reload can't re-prompt. The Library-tools paste field takes a pasted URL — on iOS an installed A2HS app has storage separate from Safari's, so a tapped link lands in a copy of the app the owner never opens. Incoming songs are untrusted input and go through mergeSetImport's coerce/clamp/fresh-id shape.

index.html now redirects in script; a meta refresh drops the fragment.

Feature: House of the Rising Sun as the showcase (v2026.08.26.004)

retireShowcase() removed Danny Boy in .26.001 and left the app with no worked example at all. HotRS (traditional, public domain) grows from a four-line stub into a full arrangement — intro/solo/outro bar rows, five verses, a {soc} chorus, section headings and a banter line. Fits an iPad screen in two columns with no scrolling.

One-time upgradeShowcase() reaches existing libraries but replaces the body only when it still matches the old stub exactly, so an owner-edited chart is never overwritten.

Also fixed: restoreData's toast("Restored") had been swallowed into a trailing // comment and never ran.

Verification

The wake-lock suite was written against the unfixed build first and failed 8 of 11 assertions (live: 0 after a single hide/show cycle); it passes 11/11 after. navigator.wakeLock is stubbed with a sentinel that auto-releases on hide, matching real UA behaviour, since the real API isn't usable headless.

• wake lock: 11/11 — boot, 1/2/5 hide-show cycles, idempotence, OS-initiated release recovery, song view, auto-scroll, refused permission
• song links: 24/24 — field round-trip incl. unicode/quotes/tabs, six malformed payloads rejected without throwing, cold end-to-end open in a separate browser context, fragment stripping, no re-prompt on reload, paste path, duplicate detection
• showcase: 11/11 — headings, chorus bar, banter, every chord resolving to a diagram, two-column layout, and the migration's untouched/edited/missing/re-run cases

CI equivalents run locally: node --check on the extracted script and sw.js, duplicate-id scan, brand == CACHE, manifest parse, PRECACHE existence.

Still outstanding: a real-device check. Headless proves the wake-lock logic, not iPadOS's actual behaviour. After deploy, leave a song open, switch apps, come back, and confirm the screen stays lit.

🤖 Generated with Claude Code

https://claude.ai/code/session_01RFni8j63y7ynwzmNLMPMTB

---

Generated by Claude Code

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.