feat(cli): Add session ID support to resume command (v3.0)

[A13xSM]

Summary

• Rebased PR feat(cli): Add session ID support to resume command #561 against v3.0 (previously targeted v2.5 paths that no longer exist)
• Added ability to resume specific Claude Code sessions by passing a session ID to the -r/--resume flag
• Modified cmdLaunch function to accept resume as either boolean or string (session ID)
• Updated argument parsing to detect UUID format after --resume flag
• Enhanced help text with session ID usage examples

Motivation

Currently, users can only resume the most recent session with pai -r. If they want to return to an older session, they must use the claude --resume <session-id> command directly, bypassing the PAI wrapper and losing PAI's startup configuration (MCP profiles, directory changes, voice notifications, etc.).

This enhancement allows direct navigation to any session by ID while maintaining all PAI wrapper functionality.

Usage

# Resume last session (existing behavior)
pai -r

# Resume specific session by ID (new feature)
pai -r 285728b4-8814-40c4-b643-bb7a8e81859e

Test Plan

• Tested with valid session IDs
• Tested backward compatibility with pai -r (no session ID)
• Verified help text displays correctly with pai help
• Confirmed UUID validation rejects non-UUID arguments
• Verified that invalid session IDs are handled by Claude Code (not the wrapper)

Implementation Details

• UUID pattern matching (/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i) ensures only valid session IDs are accepted
• extractSessionCwd() searches ~/.claude/projects/ subdirectories for the session JSONL file and extracts the original working directory
• Falls back to "resume last" behavior if next argument is not a UUID
• Falls back to CLAUDE_DIR if session cwd cannot be determined
• Fully backward compatible: existing pai -r usage continues to work
• No breaking changes

Changes from original PR #561

• File path updated from Releases/v2.5/ to Releases/v3.0/
• Code applied cleanly against the v3.0 pai.ts (identical structure)
• No other changes needed — the v3.0 file had the same relevant code sections

🤖 Generated with Claude Code

[Copilot]

Pull request overview

Adds support for resuming a specific Claude Code session from the PAI wrapper by allowing -r/--resume to optionally take a session UUID, so users can resume older sessions while still getting PAI’s startup behavior (profiles/cwd/notifications).

Changes:

• Extend --resume parsing to accept either boolean (resume last) or a UUID session ID.
• Add extractSessionCwd() to locate a session’s JSONL file and recover its original working directory.
• Update cmdLaunch behavior and help text to support pai -r <session-id>.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[danielmiessler]

Thanks for this contribution! PAI v4.0 significantly restructured the architecture — new directory layout, Algorithm v3.6.0 (up from v1.x), hooks/lib/paths.ts for path resolution, and many of the underlying systems this PR targets have been rewritten.

This PR targets the v3.0 architecture and can't be cleanly applied to v4.0.x. Closing as superseded.

The latest release is v4.0.2. We're actively working on platform compatibility and other bigger items. If there's still a gap not covered by the new releases, we'd welcome a fresh PR against the current codebase. Thanks again!