bearwave-mac/TODO.md

TODO

This file tracks the next practical work items for BearWave on macOS.

High Priority

• Harden packaging and distribution

  • move beyond the current SwiftPM-staged debug-style app bundle
  • clarify signing, entitlements, and notarization path

• Expand playback diagnostics

  • expose clearer failure reasons per stream
  • improve visibility into buffering, retry, offline, and codec issues

• Add more verification around playback behavior

  • playback state transitions
  • metadata updates
  • retry behavior

Medium Priority

• Improve cache management

  • add eviction for API cache
  • add eviction for artwork cache
  • review memory growth during long sessions

• Refine artwork behavior

  • make fallback ordering more explicit
  • verify radio artwork behavior across edge cases

• Tighten documentation drift

  • keep README.md, AGENTS.md, and ARCHITECTURE.md aligned with code changes

Lower Priority

• More advanced favorites/folder workflows
• Additional menu bar workflows
• More targeted UI polish for empty/loading/error states

Technical Debt

• AppModel should stay under control as the app grows; watch for coordinator bloat
• script/build_and_run.sh is central to local development and currently carries packaging assumptions that should eventually move into a cleaner release pipeline
• The share-folder copy of the repo should not be treated as the current source of truth

Things Not To Regress

• Global search must stay independent from the current browse page
• Search ranking must stay stricter than raw API substring results
• Explicit playback states must remain visible in the model and UI