seth
/
jam-cloud
mirror of https://bitbucket.org/jamkazam/jam-cloud.git
1
0
Fork 0
Code Issues Actions Packages Projects Releases Wiki Activity
8,301 Commits 118 Branches 1,306 Tags 359 MiB
Commit Graph

77 Commits

Author SHA1 Message Date
Nuwan 393bdfe057 docs(28): complete VU Meter Optimization phase 
Phase 28 verified and approved:
- VU data flows through external store (vuStore.js)
- VU components use refs for direct DOM updates
- React DevTools shows 0 re-renders from VU updates
- Session screen remains responsive

Requirements satisfied: VU-01, VU-02, VU-03

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-03-05 16:53:43 +05:30
Nuwan 6b6aeb1017 docs(28-02): complete Wire Components to External Store plan 
Tasks completed: 4/4
- Update useMixerStore to route VU data to external store
- Simplify useVuHelpers and VuContext
- Rewrite SessionTrackVU with direct DOM updates
- Human verification (approved)

Additional fix:
- getLevelSnapshot now checks pendingUpdates for immediate access

SUMMARY: .planning/phases/28-vu-meter-optimization/28-02-SUMMARY.md
 2026-03-05 15:18:31 +05:30
Nuwan 344ef27ae0 docs(28-01): complete External VU Store Infrastructure plan 
Tasks completed: 2/2
- Install useSyncExternalStore shim and create external VU store
- Create useVuStore React hooks

SUMMARY: .planning/phases/28-vu-meter-optimization/28-01-SUMMARY.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-03-03 20:22:13 +05:30
Nuwan 9174d161c6 docs: start milestone v1.7 Performance Optimization 
Goals:
- Eliminate page freezes from excessive React re-renders
- Optimize VU meter updates (50-70/sec → batched RAF)
- Prevent cascading re-renders with memoization
- Apply React best practices for granular updates

Phases:
28. VU Meter Optimization
29. Context Optimization
30. Component Memoization
31. Selector Optimization
32. State Update Optimization

19 requirements across 5 phases.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-03-03 19:57:32 +05:30
Nuwan 4c4ee9253b chore: complete v1.6 milestone 
Archived:
- milestones/v1.6-ROADMAP.md
- milestones/v1.6-REQUIREMENTS.md

Deleted (fresh for next milestone):
- ROADMAP.md
- REQUIREMENTS.md

Updated:
- MILESTONES.md (new entry)
- PROJECT.md (requirements → Validated)
- STATE.md (reset for next milestone)

v1.6 Media Features Polish shipped:
- JamTrack loading sequence, sizing, navigation fixed
- Backing track sync to session screen
- Prevent multiple media players simultaneously
- 2 phases, 5 plans, 7 days

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-03-03 16:33:44 +05:30
Nuwan 748e01f60a docs(27-01): complete backing track sync plan 
Tasks completed: 2/2
- Use openBackingTrack action in handleBackingTrackSelected
- Add ignore flag to duration fetch useEffect

SUMMARY: .planning/phases/27-backing-track-sync/27-01-SUMMARY.md
 2026-02-26 17:21:22 +05:30
Nuwan 38aacb49a5 docs(26-04): complete trigger download flow plan 
Tasks completed: 2/2
- Task 1: Call loadJamTrack when track is not synchronized
- Task 2: Build verification (syntax validated via Babel parser)

SUMMARY: .planning/phases/26-jamtrack-polish/26-04-SUMMARY.md
 2026-02-25 23:46:46 +05:30
Nuwan 6423df4b7b docs(26): complete JamTrack Polish phase with gap closure 2026-02-25 23:24:34 +05:30
Nuwan 4e5192d52f docs(26-03): complete JamTrack stems/controls render timing fix 
Tasks completed: 4/4
- Task 1: Call checkJamTrackSync in handleJamTrackSelect
- Task 2: Remove 'idle' from stems render condition
- Task 3: Remove 'idle' from controls render condition
- Task 4: Build verification

SUMMARY: .planning/phases/26-jamtrack-polish/26-03-SUMMARY.md
 2026-02-25 23:17:32 +05:30
Nuwan 00b912f801 docs(26-02): complete JamTrack callback cleanup plan 
Tasks completed: 3/3
- Add callback cleanup action to mediaSlice
- Call cleanup on unmount and defer controls rendering
- Build verification

SUMMARY: .planning/phases/26-jamtrack-polish/26-02-SUMMARY.md
 2026-02-25 19:15:12 +05:30
Nuwan 2314c29b9e docs(26-01): complete JamTrack player fixes plan 
Tasks completed: 2/2
- Fix WindowPortal sizing for JamTrack player
- Implement create custom mix navigation

SUMMARY: .planning/phases/26-jamtrack-polish/26-01-SUMMARY.md
 2026-02-25 19:11:29 +05:30
Nuwan eab0b0d19a docs(v1.6): create roadmap for Media Features Polish 
- 3 phases: JamTrack Polish, Backing Track Sync, Metronome Responsiveness
- 8 requirements mapped to phases
- Research complete for all features

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-02-25 18:51:18 +05:30
Nuwan daaa37a84e chore: complete v1.5 milestone 
Archived:
- milestones/v1.5-ROADMAP.md
- milestones/v1.5-REQUIREMENTS.md
- milestones/v1.5-MILESTONE-AUDIT.md

Deleted (fresh for next milestone):
- ROADMAP.md
- REQUIREMENTS.md

Updated:
- MILESTONES.md (new entry)
- PROJECT.md (requirements → Validated)
- STATE.md (reset for next milestone)

v1.5 Fix Session Recording shipped:
- Fixed C++ client crash on Start Recording (JSON parsing)
- Fixed memory leaks in recording modal
- User verified 15+ minute recording stability

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-02-25 11:56:26 +05:30
Nuwan af71f8e500 docs(25-01): complete memory leak audit plan 
Tasks completed: 4/4
- Fix timer and callback cleanup in useRecordingHelpers
- Fix async cleanup in JKSessionRecordingModal
- Create UAT checklist for memory verification
- Verify memory stability with UAT checklist (user approved)

SUMMARY: .planning/phases/25-memory-leak-audit/25-01-SUMMARY.md
 2026-02-24 23:59:52 +05:30
Nuwan b2bad70b5d chore: remove phase 25 (Verify Basic Controls) 2026-02-23 21:08:17 +05:30
Nuwan e50845dcd1 docs(24-01): complete Fix Recording Crash plan 
Tasks completed: 2/2
- Fix useRecordingHelpers.js method names and parameters
- Fix JKSessionScreen.js doStartRecording method

SUMMARY: .planning/phases/24-fix-recording-crash/24-01-SUMMARY.md
 2026-02-19 15:22:55 +05:30
Nuwan 1512f646ea docs: start milestone v1.5 Fix Session Recording 
Scope:
- Phase 24: Fix C++ client crash on Start Recording
- Phase 25: Verify Start/Stop/Pause work like desktop native app
- Phase 26: Memory leak audit for recording modal

Research findings:
- Missing RegisterRecordingCallbacks call
- Wrong method names (StartMediaRecording vs StartRecording)
- Parameter format mismatch

10 requirements across 3 phases.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-02-19 15:04:30 +05:30
Nuwan 4f74da017f chore: complete v1.4 milestone 
Archived:
- milestones/v1.4-ROADMAP.md
- milestones/v1.4-REQUIREMENTS.md

Deleted (fresh for next milestone):
- ROADMAP.md
- REQUIREMENTS.md

Updated:
- MILESTONES.md (v1.3 and v1.4 entries)
- PROJECT.md (requirements → Validated)
- STATE.md (reset for next milestone)

Tagged: v1.4

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-02-18 18:51:29 +05:30
Nuwan 895b283f30 docs(23-01): complete Memory Leak Verification plan 
Tasks completed: 3/3
- Task 1: Run Playwright regression tests (36 pass, 14 pre-existing failures)
- Task 2: Create UAT checklist for memory verification
- Task 3: Execute manual memory verification (user approved)

v1.4 Memory Leak Prevention milestone complete.
User verified 15+ minute session stability with no freezes.

SUMMARY: .planning/phases/23-verification/23-01-SUMMARY.md
 2026-02-10 17:19:04 +05:30
Nuwan 41972973ca docs(22): complete Session Screen Fixes phase 
Phase 22 verified: 3/3 must-haves passed (SESS-01, SESS-02, SESS-03)
- SESS-01: Callback cleanup hardened with useRef pattern
- SESS-02: Polling intervals verified OK (Phase 19)
- SESS-03: Event listeners verified OK (Phase 19)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-02-08 21:55:15 +05:30
Nuwan 8a5047a615 docs(22-01): complete Session Callback Cleanup plan 
Tasks completed: 1/1
- Task 1: Improve callback cleanup reliability with useRef

SUMMARY: .planning/phases/22-session-screen-fixes/22-01-SUMMARY.md
 2026-02-08 21:52:00 +05:30
Nuwan fd0a3bf450 docs(21-01): complete Chat State Cleanup plan 
Tasks completed: 2/2
- Add MAX_MESSAGES limit to sessionChatSlice.js
- Add clearAllMessages action and dispatch on session leave

SUMMARY: .planning/phases/21-chat-window-fixes/21-01-SUMMARY.md
 2026-02-08 20:53:25 +05:30
Nuwan 8c724a6ca0 docs(20-01): complete VU state cleanup plan 
Tasks completed: 3/3
- Add removeVuState function to useVuHelpers
- Verify removeVuState exposed through VuContext
- Integrate removeVuState with mixer lifecycle

SUMMARY: .planning/phases/20-vumeter-fixes/20-01-SUMMARY.md
 2026-02-08 19:29:21 +05:30
Nuwan ab2a3254b7 docs(19-01): complete memory leak audit plan 
Tasks completed: 3/3
- Task 1: Audit VU Meter Components
- Task 2: Audit Chat Window Components
- Task 3: Audit Session Screen and Finalize Report

SUMMARY: .planning/phases/19-audit-and-discovery/19-01-SUMMARY.md

Key findings:
- VUMTR-02/03: vuStates grows unbounded (HIGH)
- CHAT-01: messages accumulate without limit (HIGH)
- Session screen base has proper cleanup (LOW)
 2026-02-08 14:21:19 +05:30
Nuwan 5fbb51158f docs: create milestone v1.4 roadmap (5 phases) 
Phases:
19. Audit and Discovery: investigate all areas, identify leaks
20. VU Meter Fixes: VUMTR-01, VUMTR-02, VUMTR-03
21. Chat Window Fixes: CHAT-01, CHAT-02, CHAT-03
22. Session Screen Fixes: SESS-01, SESS-02, SESS-03
23. Verification: VRFY-01, VRFY-02

All 11 milestone requirements mapped to phases.
 2026-02-08 13:57:58 +05:30
Nuwan e272494e15 docs: start milestone v1.4 Memory Leak Prevention 2026-02-08 13:21:44 +05:30
Nuwan 26de20ad92 docs(18-01): complete Session Settings integration tests plan 
Tasks completed: 3/3
- INT-01: Settings button opens modal
- INT-02: Save settings makes PUT /sessions/{id} API call
- INT-03: Cancel closes modal without API call

SUMMARY: .planning/phases/18-integration-tests-playwright/18-01-SUMMARY.md
 2026-02-08 12:45:14 +05:30
Nuwan 815e0a6099 docs(18): plan Playwright integration tests for Session Settings 
Plan 18-01: Create integration tests covering:
- INT-01: Settings button opens modal
- INT-02: Save makes PUT /sessions/{id} API call
- INT-03: Cancel closes modal without API call

Plan verification passed.
 2026-02-08 12:33:31 +05:30
Nuwan 58e421d0bc docs(17): complete Unit Tests (Jest) phase 
Phase 17 verified:
- UNIT-01: Modal renders with currentSession props ✓
- UNIT-02: Save button calls onSave with correct payload ✓
- UNIT-03: Loading state disables form interactions ✓

9 tests passing in JKSessionSettingsModal.test.js
 2026-02-08 12:25:38 +05:30
Nuwan 50461d0bf3 docs(17-01): complete JKSessionSettingsModal tests plan 
Tasks completed: 3/3
- Task 1: Create test file with setup and mocks
- Task 2: Write tests for all three requirements
- Task 3: Verify full test suite and clean up

SUMMARY: .planning/phases/17-unit-tests-jest/17-01-SUMMARY.md
 2026-02-08 12:22:06 +05:30
Nuwan 6b4acce615 docs(17): plan Jest unit tests for JKSessionSettingsModal 
Plan 17-01: Create unit tests covering:
- UNIT-01: Modal renders with currentSession props
- UNIT-02: Save button calls onSave with correct payload
- UNIT-03: Loading state disables form interactions

Plan verification passed.
 2026-02-08 12:17:14 +05:30
Nuwan c5600e9315 docs: create milestone v1.3 roadmap (2 phases) 
Phases:
17. Unit Tests (Jest): UNIT-01, UNIT-02, UNIT-03
18. Integration Tests (Playwright): INT-01, INT-02, INT-03

All 6 requirements mapped to phases.
 2026-02-08 12:05:50 +05:30
Nuwan 98183f7efa docs: start milestone v1.3 Session Settings Tests 2026-02-07 21:28:37 +05:30
Nuwan 460dd5b4cb chore: complete v1.2 Session Attachments milestone 
Archived:
- milestones/v1.2-ROADMAP.md (full phase details)
- milestones/v1.2-REQUIREMENTS.md (all 24 requirements marked complete)

Deleted (fresh for next milestone):
- REQUIREMENTS.md

Updated:
- MILESTONES.md (new entry with stats and accomplishments)
- ROADMAP.md (collapsed v1.2 phases into details tag)
- STATE.md (reset for next milestone)

v1.2 Session Attachments shipped 2026-02-07:
- 5 phases (12-16), 11 plans
- 12 files, 1,868 lines
- 5 days from start to ship

Key features delivered:
- File upload with validation (10 MB, approved types)
- Attachment display in chat with clickable links
- Real-time sync via WebSocket
- Error handling with toast notifications
- Unread badge persistence

Bugs fixed during UAT:
- Attachment message deduplication race condition
- Unread count not persisting across page reloads

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-02-07 02:19:32 +05:30
Nuwan f2138f8d0d docs(16-01): complete error handling & user feedback plan 
Tasks completed: 5/5
- Upload success toast (REQ-5.4)
- Validation error messages (REQ-5.1, REQ-5.2)
- Network error message (REQ-5.3)
- S3 404 error handling (REQ-5.5)
- Integration tests for error scenarios

SUMMARY: .planning/phases/16-attachment-finalization/16-01-SUMMARY.md
 2026-02-07 01:23:23 +05:30
Nuwan 8cf0b661a7 docs(15): complete Phase 15 - Real-time Synchronization 
Phase 15 verified and complete with bug fixes:
- WebSocket handler extracts attachment fields correctly
- Deduplication works for both WebSocket and REST API paths
- Integration tests created (test/attachments/real-time-sync.spec.ts)
- Human verification passed

Bug fixes applied during UAT:
- Optimistic update for uploader (sender excluded from WebSocket)
- fetchChatHistory dispatch on channel activation
- API field name (chats not messages)
- API parameter name (music_session not session_id)
- Infinite loop prevention in fetch

Known limitation documented:
- WebSocket only broadcasts to musicians (as_musician: true filter)
- Pre-existing backend behavior, not introduced by v1.2

Requirements satisfied: REQ-3.1*, REQ-3.2
* REQ-3.1 has known limitation for non-musician participants

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
 2026-02-06 18:20:44 +05:30
Nuwan 24ce6a6beb docs(14-03): complete REST API attachment transformation gap closure plan 
Tasks completed: 2/2
- Task 1: Add REST API attachment transformation (TDD)
- Task 2: Verify gap closure with integration test

SUMMARY: .planning/phases/14-chat-integration-and-display/14-03-SUMMARY.md
 2026-02-06 01:55:07 +05:30
Nuwan c9b2ba7f10 docs(14-02): complete clickable links and responsive layout plan 
Tasks completed: 3/3
- Task 1: Add click handler to fetch signed URL and open file
- Task 2: Add responsive styling with filename truncation
- Task 3: Human verification checkpoint (approved)

SUMMARY: .planning/phases/14-chat-integration-and-display/14-02-SUMMARY.md
 2026-02-06 00:55:44 +05:30
Nuwan 38fea32f22 docs(14-01): complete attachment message display plan 
Tasks completed: 2/2
- Task 1: WebSocket transformation with attachment fields
- Task 2: JKChatMessage attachment rendering

SUMMARY: .planning/phases/14-chat-integration-and-display/14-01-SUMMARY.md
 2026-02-05 19:45:28 +05:30
Nuwan ff6042e884 docs(13-03): complete file upload UI integration plan 
Tasks completed: 3/3
- Wire up Attach button in session toolbar
- Create upload progress component for chat window
- Display upload progress in chat message list

User verification: APPROVED
- File dialog opens on button click
- Invalid files rejected with error toast
- Valid files upload to backend (201 Created)
- Upload progress displayed in chat

SUMMARY: .planning/phases/13-file-upload-infrastructure/13-03-SUMMARY.md
 2026-02-05 18:58:49 +05:30
Nuwan 765fcba8fe docs(13-02): complete phase plan with summary and state updates 
Tasks completed: 1/1
- Redux upload state management and REST helpers with TDD

SUMMARY: .planning/phases/13-file-upload-infrastructure/13-02-SUMMARY.md

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-05 11:02:47 +05:30
Nuwan 3dfbb57eaf docs(13-01): complete file validation service plan 
Tasks completed: 1/1
- File validation service with TDD methodology
- 37 tests passing, 100% coverage
- All 5 functions implemented and documented

SUMMARY: .planning/phases/13-file-upload-infrastructure/13-01-SUMMARY.md

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-05 11:01:45 +05:30
Nuwan 8ef1c8df7e docs(12-02): complete phase plan with summary and state updates 
- Created 12-02-SUMMARY.md documenting backend validation and React design
- Updated STATE.md: Phase 12 complete (2/2 plans), 20% v1.2 progress
- Documented 5 key decisions (FormData, size limits, single file, etc.)
- Identified mp3 format support blocker (MEDIUM - decision needed)
- Next steps: Phase 13 implementation ready to begin

Phase 12 summary: Backend 95% ready, React integration fully designed

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-02 19:01:09 +05:30
Nuwan 3ef75d06ad docs(12-01): complete attachment research and API documentation 
Tasks completed: 2/2
- Task 1: Document legacy AttachmentStore implementation
- Task 2: Document backend API contract

SUMMARY: .planning/phases/12-attachment-research-&-backend-validation/12-01-SUMMARY.md

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-02 19:00:17 +05:30
Nuwan 631253d3f7 docs(roadmap): add v1.2 Session Attachments milestone 
Add comprehensive roadmap for file attachment feature:
- Update PROJECT.md with v1.2 milestone and requirements
- Create REQUIREMENTS.md with 24 requirements across 7 categories
- Add Phases 12-16 to ROADMAP.md (5 phases, 10 plans)
- Update STATE.md with milestone v1.2 status

Phases:
- Phase 12: Attachment Research & Backend Validation (2 plans)
- Phase 13: File Upload Infrastructure (3 plans)
- Phase 14: Chat Integration & Display (2 plans)
- Phase 15: Real-time Synchronization (1 plan)
- Phase 16: Attachment Finalization (2 plans)

Coverage: 24/24 requirements mapped (100%)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-02-02 18:38:34 +05:30
Nuwan b2327d77ae docs(11-02): complete UAT & final integration testing plan 
Tasks completed: 3/3
- Task 1: UAT checklist prepared (50+ test cases)
- Task 2: User found P0 bug, fixed immediately
- Task 3: Milestone documentation complete

P0 Critical Bug Fixed:
- Chat message submission parameter mismatch (session_id → music_session)
- Single-line fix in jam-ui/src/helpers/rest.js
- Commit: 5b940ae

Milestone v1.1 Status: COMPLETE
- All 11 plans across Phases 6-11 complete
- P0/P1 issues: 1 found, 1 resolved
- Ready for production deployment

SUMMARY: .planning/phases/11-chat-finalization/11-02-SUMMARY.md
 2026-01-31 19:22:42 +05:30
Nuwan a348e27985 docs(11-01): complete error handling & accessibility plan 
Tasks completed: 3/3
- Comprehensive error handling and status display
- Accessibility and keyboard navigation
- Polish and edge case handling

SUMMARY: .planning/phases/11-chat-finalization/11-01-SUMMARY.md
 2026-01-27 23:08:14 +05:30
Nuwan 0b5848cc05 docs(10-01): complete read/unread status validation plan 
Complete Phase 10 Plan 1 with comprehensive integration testing:
- 17 Playwright tests validating unread tracking system
- Badge behavior tests (8): visibility, count display, reset, increment
- localStorage persistence tests (7): save/load, error handling, multi-channel
- E2E workflow tests (2): complete user journeys with state validation
- 94% pass rate (16/17 tests passing when backend running)
- Documents actual vs expected behavior for timestamp-based filtering

Test suite validates Redux state, localStorage persistence, and UI rendering.
All integration tests follow established patterns from Phase 9.

Updates: STATE.md (Phase 10 progress), ROADMAP.md (Plan 10-01 complete)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2026-01-27 22:01:58 +05:30
Nuwan ae1beab3dc docs(09-02): complete send message integration plan 
Tasks completed: 3/3
- Integrate JKChatComposer into JKSessionChatWindow
- Write integration tests for send message flow (7 tests)
- Write integration tests for receive message flow (4 tests)

SUMMARY: .planning/phases/09-message-composition/09-02-SUMMARY.md
 2026-01-27 19:50:20 +05:30
Nuwan 538cdd0239 docs(09-01): complete message composer UI & validation plan 
Tasks completed: 3/3
- Create JKChatComposer component with textarea and send button
- Add keyboard handling for Enter and Shift+Enter
- Add character count validation feedback

SUMMARY: .planning/phases/09-message-composition/09-01-SUMMARY.md
 2026-01-27 15:23:48 +05:30