jam-cloud/.planning/ROADMAP.md

2.6 KiB

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

  • Phase 26: JamTrack Polish - Fix loading sequence, sizing, navigation, and cleanup ✓
  • 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:

  • 26-01-PLAN.md - Fix window sizing and create custom mix navigation ✓
  • 26-02-PLAN.md - Add callback cleanup and defer controls rendering ✓
  • 26-03-PLAN.md - Remove 'idle' from valid render states (gap closure) ✓
  • 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:

  • 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)