v0.14.0-0

Happy CLI v0.14.0-0 Release Notes

This release introduces significant improvements to alternative AI backend support (Gemini, Codex), enhanced offline resilience, better session management, and comprehensive Bun runtime support.

🚀 New Features

• Gemini ACP Integration: Full Google Cloud Project support with unified messaging, conversation history preservation when switching models, and improved error handling
• Graceful Offline Mode: Background reconnection with deduplicated offline warnings and improved server error handling
• Bun Runtime Support: Add --js-runtime option to use Bun instead of Node.js with transparent runtime compatibility layer
• Profile System Enhancements:
  • Add defaultSessionType, defaultPermissionMode, and defaultModelMode to profile schema
  • Profile validation and schema migration with backwards compatibility
  • Expand ${VAR} references in profile environment variables
• tmux Integration: Improved session spawning with seamless fallback, environment variable support, and defaults to first existing session when unspecified
• Development Tooling: Add happy-dev global binary and dev/stable variant management with automatic environment switching
• Claude Path Configuration: Add HAPPY_CLAUDE_PATH env var override and fallback path detection

🐛 Bug Fixes

• Session Management: Fix --continue flag to resume sessions across all Claude Code versions; resolve --continue/--session-id flag conflict in Claude 2.0.64
• API Reliability: Handle 5xx server errors gracefully; improve 403/409 error handling with recovery actions; gracefully handle 404 when /v1/machines endpoint unavailable
• Path Handling: Handle spaces and underscores in project paths correctly
• ACP Backend: Fix stdout filtering allowing invalid JSON to pass through
• RPC: Allow root path in bash handler for CLI detection
• Socket Connections: Add cleanup calls and socket connection check
• Abort Handling: Make abort graceful; force-close MCP on kill/exit
• Permission Modes: Enable bypassPermissions and acceptEdits modes; add cross-agent permission mode fallback mapping
• tmux Fixes: Ensure complete environment inheritance; use native -P flag for process PID; enable working directory and fix window creation bugs
• Utils: Use Node.js isDeepStrictEqual directly to prevent stack overflow
• Logging: Fix circular dependency with persistence module
• Tests: Resolve Vitest hoisting and threading/resource contention issues; use getProjectPath in sessionScanner test for consistent path calculation

♻️ Refactoring

• Gemini Backend: Prevent session swap race conditions, dedupe history, unify model resolution
• ACP Backend: Improve architecture and reliability
• Agent Module: Restructure agent module architecture
• Code Consolidation: DRY consolidation of Codex/Gemini shared code

🔧 Other Changes

• Update @anthropic-ai/claude-code to 2.0.53 and @anthropic-ai/sdk to 0.71.0
• Reorganize documentation with clear user/developer separation
• Move development docs to CONTRIBUTING.md
• Make happy-dev a development-only command
• Remove non-working show backup feature