Session Recovery

Detect and recover previous planning sessions, reconstructing lost context from persistent planning files.

Agent

Session Manager - pwf-session-manager

Workflow

1. Check project path for existing planning files
2. Check ~/.claude/projects/ for session data
3. Find last planning file update timestamp
4. Extract post-update conversation context (lost context)
5. Build catchup report summarizing accomplished work
6. Merge recovered state into current session

Inputs

• projectPath - Root path for planning files
• sessionId - Session identifier for recovery
• previousSessionPath - Path to previous session (optional)

Outputs

• Recovery report with completed phases and lost context estimate
• Merged session state with preserved checkboxes
• Catchup summary for manual sync

Process Files

• planning-orchestrator.js - Session recovery at startup
• planning-session.js - Full recovery pipeline