v3.3.4 - Windows Native Support & Comprehensive Documentation

🪟 Full Windows Native Support & Cross-Platform Improvements

This release adds comprehensive Windows native support and improves cross-platform compatibility across all environments.

✨ New Features

1. Windows PowerShell Installer

• New: Native PowerShell installer for Windows users who don't use Git Bash
• Run: .\scripts\install-windows.ps1
• Supports non-interactive mode: .\scripts\install-windows.ps1 -NonInteractive

2. Diagnostic Tool

• New: Cross-platform diagnostic utility for troubleshooting
• Run: python scripts/diagnose.py -v --test-audio
• Checks: Python version, platform detection, hooks installation, configuration, audio files

3. Debug Logging Mode

• New: Set CLAUDE_HOOKS_DEBUG=1 to enable detailed logging
• Logs: Hook triggers, path normalization, audio playback attempts, errors
• Location: $TEMP/claude_audio_hooks_queue/logs/debug.log (Windows) or /tmp/... (Unix)

4. AI Assistant Guide (CLAUDE.md)

• New: Comprehensive guide for AI assistants (Claude Code, Cursor, Copilot)
• Includes: Platform detection decision tree, installation flowcharts, troubleshooting guides
• Uses Mermaid diagrams for visual documentation

🔧 Improvements

Enhanced hook_runner.py

• Multi-format path normalization (Git Bash, WSL2, Cygwin, Windows native)
• Safer PowerShell string escaping for special characters
• Cross-platform temp directory detection with fallbacks
• Granular exception handling with detailed error logging

Improved Installation Scripts

• install-complete.sh: Cross-platform temp directories, proper path format conversion
• hook_config.sh: Debug logging functions, unified path handling

📚 Documentation

Document	Description
CLAUDE.md	AI Assistant Guide with Mermaid diagrams
docs/ARCHITECTURE.md	System architecture details
docs/INSTALLATION_GUIDE.md	Platform-specific installation
docs/TROUBLESHOOTING.md	Debug guide and common fixes

✅ Cross-Platform Status

Platform	Status	Installer
Windows Native	✅ Full support	.\scripts\install-windows.ps1
Windows + Git Bash	✅ Full support	bash scripts/install-complete.sh
Windows + WSL	✅ Full support	bash scripts/install-complete.sh
macOS	✅ Full support	bash scripts/install-complete.sh
Linux	✅ Full support	bash scripts/install-complete.sh

📦 Upgrade Instructions

cd claude-code-audio-hooks
git pull origin master

# Re-run installer to update all components
bash scripts/install-complete.sh  # Linux/macOS/Git Bash
# Or: .\scripts\install-windows.ps1  # Windows PowerShell

🐛 Enable Debug Logging (for troubleshooting)

export CLAUDE_HOOKS_DEBUG=1  # Linux/macOS/Git Bash
# Or: $env:CLAUDE_HOOKS_DEBUG = "1"  # Windows PowerShell

---

Full Changelog: v3.3.3...v3.3.4