Revive Dead Koi Frames and Add an Opt-In Vitals Overlay

[AndrewRedican]

Description

On Android the OS can kill one koi's iframe mid-run; today that fish is gone until reload and the failure leaves no evidence. This PR makes the pond re-open a session whose frame died (with grace, backoff, and a cap) and adds an opt-in ?vitals=1 diagnostics overlay that records session events, frame health, and context loss on the device, persisting its log across a page death.

Type of Change

✨ Feature

Changes Made

• Add resurrection.ts: re-opens a dead session after a 4s grace, backoff 4/12/36s, 3 attempts per episode, budget restored after 60s of stability
• Add vitals.ts + styles: opt-in overlay with session log, 5s frame probe, buffer/heap readings, context-loss listeners, and a copyable persisted log
• Wire both into pond.ts via a new optional onDiagnostic hook; reset the open-retry budget on successful open
• File findings F-018 and F-019; record the new machinery in the koi pond skill

Testing

• 24 new specs; all ten koi projects green on test/build/lint/typecheck
• Browser-verified on the built composed site: simulated frame kill heals back to 8/8 with zero console errors; without the flag nothing changes

Checklist

• I have performed a self-review of my code
• I have added/updated tests as needed
• I have updated relevant documentation
• I have used npm run commit for conventional commit messages

AI Assistance

Claude was used to generate this code under direct supervision.

Additional Notes

• Host-only: no contract change, no shell repack; the S24 Ultra device-evidence pass runs after this deploys

---

📝 CLA Requirement

By submitting this pull request, you acknowledge that:

• You have read and agree to sign our Contributor License Agreement (CLA)
• The CLA Assistant bot will automatically check your signature status
• If you haven't signed yet, the bot will provide instructions in the comments
• By signing, you grant the project maintainer exclusive rights to your contributions

For more information, see our Contributing Guide.

---

Thank you for contributing to hyperfrontend! 🚀

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
docs-site	Ready	Preview	Aug 21, 2026 7:52pm

[nx-cloud]

View your CI Pipeline Execution ↗ for commit 5d65ef3

Command	Status	Duration	Result
nx run-many -t=e2e --projects=@hyperfrontend/wo...	✅ Succeeded	<1s	View ↗
nx run-many -t=build --projects=@hyperfrontend/...	✅ Succeeded	2m 17s	View ↗
nx run-many -t=test --projects=@hyperfrontend/w...	✅ Succeeded	28s	View ↗
nx run-many -t=typecheck --projects=@hyperfront...	✅ Succeeded	14s	View ↗
nx run-many -t=lint --projects=@hyperfrontend/w...	✅ Succeeded	5s	View ↗
nx run-many -t=format:check --projects=@hyperfr...	✅ Succeeded	<1s	View ↗

💡 Verify your cache is correct by running tasks in a sandbox. Read docs ↗

---

☁️ Nx Cloud last updated this comment at 2026-08-21 19:58:03 UTC