The immersion tracker is persistence-heavy, but its SQLite-backed tests are conditionally skipped in the standard Bun run when node:sqlite support is unavailable. That creates a blind spot around session finalization, telemetry persistence, and retention behavior. This task should establish a reliable automated verification path for the database-backed cases and make the prerequisite/runtime behavior explicit to contributors and CI.
Acceptance Criteria
#1 Database-backed immersion tracking tests run in at least one documented automated command that is practical for contributors or CI to execute.
#2 If the current runtime cannot execute the SQLite-backed tests, the repository exposes that limitation clearly instead of silently reporting a misleading green result.
#3 Contributor-facing documentation explains how to run the immersion tracker verification lane and any environment prerequisites it depends on.
#4 The resulting verification covers session persistence or finalization behavior that is not exercised by the pure seam tests alone.
Implementation Plan
Confirm which SQLite-backed immersion tests are currently skipped and why in the standard Bun environment.
Establish a reproducible command or lane for the DB-backed cases, or make the unsupported-runtime limitation explicit and actionable.
Document prerequisites and expected behavior for contributors and CI.
Verify at least one persistence/finalization path beyond the seam tests is exercised by the new lane.