# Roadmap: JamKazam Media Features Modernization

## Milestones

- v1.0 Media Players (Phases 1-4) - SHIPPED 2026-01-14
- v1.1 Music Session Chat (Phases 5-10) - SHIPPED 2026-01-27
- v1.2 Session Attachments (Phases 11-14) - SHIPPED 2026-02-07
- v1.3 Session Settings Tests (Phases 15-17) - SHIPPED 2026-02-08
- v1.4 Memory Leak Prevention (Phases 18-22) - SHIPPED 2026-02-10
- v1.5 Fix Session Recording (Phases 23-25) - SHIPPED 2026-02-25
- **v1.6 Media Features Polish** (Phases 26-27) - IN PROGRESS

## Overview

v1.6 addresses usability issues in JamTrack (loading sequence bug, sizing, navigation) and Backing Track (sync integration). Metronome responsiveness was determined to be satisfactory after phases 26-27 improvements.

## Phases

- [x] **Phase 26: JamTrack Polish** - Fix loading sequence, sizing, navigation, and cleanup ✓
- [x] **Phase 27: Backing Track Sync** - Enable track sync and async cleanup ✓

## Phase Details

### Phase 26: JamTrack Polish
**Goal**: JamTrack player works correctly from selection through playback without freezes
**Depends on**: v1.5 complete
**Requirements**: JT-01, JT-02, JT-03, JT-04
**Success Criteria** (what must be TRUE):
  1. User sees loading indicator while backend processes track (not premature stem UI)
  2. JamTrack player fits properly in popup window without scrollbars
  3. "Create custom mix" button opens JamTrack editor in new tab
  4. No console warnings about leaked callbacks when closing JamTrack or navigating away
**Plans**: 4 plans

Plans:
- [x] 26-01-PLAN.md - Fix window sizing and create custom mix navigation ✓
- [x] 26-02-PLAN.md - Add callback cleanup and defer controls rendering ✓
- [x] 26-03-PLAN.md - Remove 'idle' from valid render states (gap closure) ✓
- [x] 26-04-PLAN.md - Trigger loadJamTrack when not synchronized (gap closure) ✓

### Phase 27: Backing Track Sync
**Goal**: Backing Track appears in session screen when opened
**Depends on**: Nothing (independent of Phase 26)
**Requirements**: BT-01, BT-02
**Success Criteria** (what must be TRUE):
  1. Opening a backing track file shows the track in session screen (not just popup)
  2. No "state update on unmounted component" warnings when closing backing track quickly
**Plans**: 1 plan

Plans:
- [x] 27-01-PLAN.md - Use openBackingTrack action and add async cleanup ✓

## Progress

| Phase | Milestone | Plans Complete | Status | Completed |
|-------|-----------|----------------|--------|-----------|
| 26. JamTrack Polish | v1.6 | 4/4 | Complete | 2026-02-25 |
| 27. Backing Track Sync | v1.6 | 1/1 | Complete | 2026-02-26 |

---
*v1.6 roadmap created 2026-02-25, updated 2026-03-03 (Phase 28 descoped)*