Root cause: loadManuallyCreatedProjects() was restoring projects with stale session arrays from localStorage. When loadProjects() tried to merge with fresh API data, the stale sessions would override. Fix 1: In loadManuallyCreatedProjects(), reset the sessions array to empty for each loaded project. This ensures sessions always come from the API (authoritative source) rather than localStorage. Fix 2: In createSessionInFolder(), remove the redundant initialize() call after loadProjects(). initialize() would reload stale localStorage data, undoing the fresh data fetched by loadProjects(). Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1.9 KiB
1.9 KiB
Session Persistence Bug - Scratchpad
Task Overview
Fix bug where sessions disappear from manually created projects after page refresh.
Root Cause Analysis
When a session is created in a manually created project:
createSessionInFolder()creates the session via API- It calls
await this.loadProjects()- fetches fresh session data from API - BUG: It then calls
await this.initialize() initialize()callsloadManuallyCreatedProjects()which RESTores projects with STALE session data from localStorage- Then
loadProjects()is called again, but the damage is done
The problem is that saveManuallyCreatedProjects() saves the entire project object including its sessions array. When the page refreshes:
loadManuallyCreatedProjects()restores projects with their saved (stale) sessions- The merge logic in
loadProjects()tries to add virtual sessions to these projects - BUT the session array from localStorage already exists and may be empty/stale
The Fix
The session arrays stored in localStorage for manually created projects are stale and should be ignored. The loadManuallyCreatedProjects() function should:
- Load the project metadata (name, id, workingDir, manuallyCreated flag)
- NOT load the sessions array - it should start empty
- Let
loadProjects()populate the sessions from the API
This ensures sessions always come from the authoritative source (the backend API) rather than stale localStorage data.
Implementation
Remove the await this.initialize() call from createSessionInFolder() after loadProjects(). The loadProjects() call already refreshes the data from the API, so we don't need to re-initialize.
Testing Steps
- Create new project named 'test'
- Start new session in 'test' project
- Check that session appears in left sidebar
- Refresh page
- Verify session still appears in 'test' project