- Inject IIFE with re-entry guard to prevent duplicate listeners on SPA
  navigation
- Poll for MusicKit availability with 500ms intervals
- Attach six event listeners: playbackStateDidChange,
  nowPlayingItemDidChange, playbackTimeDidChange, repeatModeDidChange,
  shuffleModeDidChange, volumeDidChange
- Expose control object at window.__sidra with nine control methods for
  testing
- IPC bridge implemented (main process wiring)

Signed-off-by: Martin Wimpress <code@wimpress.io>

- Inject musicKitHook.js via executeJavaScript() in did-finish-load
  handler
- Instantiate Player after menu setup completion
- Register six ipcMain.on listeners forwarding track change events to
  player handlers

Completes end-to-end pipeline: renderer hook captures MusicKit events →
IPC forwards payloads → main process player logs and re-emits.

Signed-off-by: Martin Wimpress <code@wimpress.io>

…intervals

- Add lastTimeLogAt instance field to track last log timestamp
- Throttle debug output to max once per 10 seconds while maintaining
  event emission on every tick
- Preserves MPRIS and integration compatibility by keeping events
  unthrottled

Event emission frequency unchanged; only log output is rate-limited to
reduce debug noise during continuous playback.

Signed-off-by: Martin Wimpress <code@wimpress.io>

- Add PLAYBACK_STATES lookup map to decode numeric state values
  (0→none, 1→loading, 2→playing, 3→paused, 4→stopped, 5→ended,
  6→seeking, 7→waiting, 8→stalled, 9→completed)
- Decode state before logging for improved readability
- Preserve original numeric payload for event emission to MPRIS and
  other downstream consumers

Improves log readability without affecting message content or APIs.

Signed-off-by: Martin Wimpress <code@wimpress.io>

…bug logs

- Add REPEAT_MODES and SHUFFLE_MODES lookup maps to translate numeric
  payloads to human-readable strings (repeat: 0→none, 1→one, 2→all;
  shuffle: 0→off, 1→songs)
- Decode values before logging in handleRepeatModeDidChange and
  handleShuffleModeDidChange for improved readability
- Pass original numeric payloads unchanged to this.emit() to preserve
  compatibility with MPRIS and other downstream consumers

Signed-off-by: Martin Wimpress <code@wimpress.io>

The music.apple.com volume slider writes directly to
HTMLMediaElement.volume, bypassing MusicKit's setter where
volumeDidChange would normally fire. Poll mk.volume at 250ms intervals
and emit IPC events when the value changes to catch all volume
adjustments. The existing addEventListener listener is preserved and
continues to work for volume changes that do trigger the event.

Signed-off-by: Martin Wimpress <code@wimpress.io>

…round

- AGENTS.md: Added src/paths.ts to project structure and documented
  volume polling workaround for music.apple.com's slider bypassing
  MusicKit's volumeDidChange event
- docs/SPECIFICATION.md: Added MusicKit.js enum values subsection with
  PlaybackStates (0-9), RepeatMode (0-2), and ShuffleMode (0-1)
  mappings; explained HTMLMediaElement volume event workaround and
  polling fallback; documented audioTraits, bitrate, and codec
  availability caveats

Signed-off-by: Martin Wimpress <code@wimpress.io>