agentvibes 2.5.0 → 2.7.0

package/RELEASE_NOTES.md

@@ -1,454 +1,255 @@
-# Release v2.4.3 - macOS Compatibility Fixes (2025-01-15)
+# Release v2.7.0 - Party Mode Voice Improvements
 
-## 🤖 AI Summary
+**Release Date:** 2025-11-18
+**Type:** Minor Release (New Features)
 
-This patch release resolves three critical macOS installation issues discovered during user testing. The fixes ensure seamless installation on macOS by adding proper audio playback support for ElevenLabs TTS, detecting the user's shell environment correctly (zsh vs bash), fixing Piper installer PATH issues, and handling optional plugin manifest files gracefully. These changes complete the macOS compatibility work started in v2.4.0, making AgentVibes fully functional across all platforms.
+## 🎯 AI Summary
 
-## 📋 Changes
+AgentVibes v2.7.0 transforms BMAD party mode into a professional multi-agent voice conversation system. This release introduces a sophisticated TTS queue architecture that enables sequential voice playback without blocking Claude Code, natural 2-second pauses between speakers, and customizable agent introductions. The configuration system has been reorganized to use the official `.claude/config/` directory, and several critical text-to-speech bugs have been fixed.
 
-### 🐛 Bug Fixes
-
-- **Fixed ElevenLabs Audio Playback on macOS**
-  - Added platform detection to use native `afplay` on macOS
-  - Previously used Linux-only players (paplay/aplay) that don't exist on macOS
-  - Audio files now play correctly instead of failing silently
-  - File: `.claude/hooks/play-tts-elevenlabs.sh` lines 387-399
-
-- **Fixed Shell Environment Detection**
-  - Installer now detects user's default shell (zsh vs bash)
-  - Environment variables written to correct config file (.zshrc or .bashrc)
-  - Scripts now execute using user's shell with proper environment
-  - Replaced hardcoded `bash` calls with shell-aware execution
-  - File: `src/installer.js` - Added `getUserShell()` and `execScript()` helpers
-
-- **Fixed Piper Version Check on macOS**
-  - Version check now uses full path `$INSTALL_DIR/piper --version`
-  - Previously failed because PATH wasn't updated in same shell session
-  - Eliminates false "piper: command not found" error after successful install
-  - File: `.claude/hooks/piper-installer.sh` line 200
-
-- **Fixed Plugin Manifest Installation Error**
-  - Installer now checks if source `.claude-plugin/plugin.json` exists
-  - Skips silently if file doesn't exist (optional feature)
-  - Prevents ENOENT error: "no such file or directory" during installation
-  - File: `src/installer.js` lines 682-704
-
-## 🎯 User Impact
-
-**For macOS Users**: All three critical installation issues are now fixed! You can install AgentVibes on macOS without errors:
-
-1. **ElevenLabs TTS audio plays correctly** - Uses native macOS `afplay` command
-2. **Environment variables work** - Installer detects zsh and writes to .zshrc
-3. **Piper installer succeeds** - No more false "command not found" errors
-4. **No plugin manifest errors** - Installation completes cleanly
-
-**What Was Broken**:
-- ElevenLabs audio generated but didn't play (wrong audio player for macOS)
-- API keys written to .zshrc but scripts ran with bash (no environment)
-- Piper binary installed successfully but version check failed
-- Plugin manifest copy failed with ENOENT error
-
-**What's Fixed**: Complete macOS installation workflow now works end-to-end.
-
-## 📦 Files Changed
-
-### Modified
-- `.claude/hooks/play-tts-elevenlabs.sh` - Added macOS audio playback support
-- `.claude/hooks/piper-installer.sh` - Fixed version check PATH issue
-- `src/installer.js` - Added shell detection, fixed plugin manifest handling
-
-### Statistics
-- 3 files changed
-- 26 insertions(+)
-- 7 deletions(-)
-
-## 🔄 Breaking Changes
-
-None. This release only fixes bugs without changing any existing functionality.
-
-## 🚀 Upgrade Notes
-
-Simply run:
-```bash
-npx agentvibes@latest install --yes
-```
-
-All fixes are applied automatically during installation. No manual configuration needed!
-
-## 🙏 Credits
-
-Special thanks to **Tyler Worley** and **Brian Madison** for thorough macOS testing and reporting these issues! Their detailed bug reports with screenshots made these fixes possible.
-
-## 🔗 Related
-
-- v2.4.2 - BMAD TTS Auto-Injection
-- v2.4.1 - macOS Piper Audio Playback Fix
-- v2.4.0 - macOS Piper TTS Support
-
----
-
-**Full Changelog**: https://github.com/paulpreibisch/AgentVibes/compare/v2.4.2...v2.4.3
+**Key Highlights:**
+- 🎭 **TTS Queue System** - Sequential non-blocking voice playback for party mode
+- ⏸️ **Natural Speaker Pauses** - 2-second delay between agents for conversation flow
+- 🎤 **Speaker Introductions** - Configurable intro text (e.g., "John, Product Manager here")
+- 📁 **Config Reorganization** - Moved from `.claude/plugins/` to official `.claude/config/`
+- 🐛 **Text Escaping Fixes** - No more "backslash exclamation" in speech
 
 ---
 
-# Release v2.4.2 - BMAD TTS Auto-Injection (2025-01-15)
-
-## 🤖 AI Summary
-
-This patch release makes BMAD integration completely automatic! Previously, the installer only created documentation about BMAD integration but didn't actually modify the agent files. Now the installer automatically runs `bmad-tts-injector.sh enable` when BMAD is detected, ensuring BMAD agents will speak immediately after installation without requiring manual configuration steps.
+## ✨ New Features
 
-## 📋 Changes
+### TTS Queue System for Party Mode
 
-### ✨ Improvements
-- **Automatic BMAD TTS Injection**
-  - Installer now automatically injects TTS hooks into BMAD agent files
-  - Detects BMAD installation and enables TTS during AgentVibes installation
-  - No manual steps required - agents speak immediately after install
-  - File: `src/installer.js` lines 1004-1036
+**Non-Blocking Sequential Playback** (commit: b4c7dd71)
+- New `tts-queue.sh` and `tts-queue-worker.sh` background queue system
+- Agents queue TTS requests and return immediately (non-blocking)
+- Queue worker plays audio sequentially in the background
+- Claude Code continues at full speed while voices play in order
+- Base64 encoding handles special characters safely (apostrophes, quotes, etc.)
+- Auto-starting worker with 5-second idle timeout
+- Prevents audio overlap in multi-agent party mode discussions
 
-### 🔧 Technical Changes
-- **Enhanced Installer Logic**
-  - Import `execSync` from `node:child_process` to run shell scripts
-  - Automatically execute `bmad-tts-injector.sh enable` when BMAD detected
-  - Add comprehensive error handling with user-friendly fallback messages
-  - Update success message to reflect automatic TTS injection status
-  - Show injection status and available commands in completion box
-
-## 🎯 User Impact
-
-**For BMAD Users**: When you install AgentVibes, TTS is now **automatically injected** into all your BMAD agent files. Your agents will speak immediately - no need to run `bmad-tts-injector.sh enable` manually!
-
-**What Changed**: The installer detects BMAD and automatically runs the TTS injection script, modifying agent files to include TTS hooks. If injection fails for any reason, you'll see a friendly error message with manual fallback instructions.
-
-**Installation is Simple**:
-```bash
-npx agentvibes install --yes
-# TTS is automatically injected into BMAD agents!
+**Benefits:**
+```
+Before: Agent 1 text → [WAIT 3s] → Agent 2 text → [WAIT 3s] → Agent 3 text
+After:  Agent 1, 2, 3 text (instant) → [Audio plays sequentially in background]
 ```
 
-## 📦 Files Changed
-
-### Modified
-- `src/installer.js` - Added automatic BMAD TTS injection during installation
-
-### Statistics
-- 1 file changed
-- 40 insertions(+)
-- 4 deletions(-)
-
-## 🔄 Breaking Changes
+### Natural Conversation Flow
 
-None. This release enhances the installation experience for BMAD users without affecting existing functionality.
+**2-Second Pause Between Speakers** (commit: b4c7dd71)
+- Automatic pause added after each agent finishes speaking
+- Gives users time to process what was said before next agent speaks
+- Creates natural conversation rhythm in party mode
+- Implemented in queue worker for consistent timing
 
-## 🚀 Upgrade Notes
+### Customizable Speaker Introductions
 
-Simply run:
-```bash
-npx agentvibes@latest install --yes
-```
+**Agent Identification System** (commit: b4c7dd71)
+- New "Intro" column in voice mapping table
+- Default introductions for all 10 BMAD agents:
+  - "John, Product Manager here"
+  - "Mary, Business Analyst here"
+  - "Winston, Architect here"
+  - And 7 more specialized intros
+- Intro text automatically prepended before dialogue
+- Fully customizable via markdown table
+- Leave blank to disable intro for specific agents
+- New `get-intro` command in `bmad-voice-manager.sh`
 
-If you previously installed AgentVibes and manually ran `bmad-tts-injector.sh enable`, this update won't affect you. The injection script is idempotent and safe to run multiple times.
+---
 
-## 🙏 Credits
+## 🔧 Configuration Improvements
 
-This improvement eliminates a manual configuration step that users frequently asked about, making BMAD integration seamless.
+### Official Config Directory Migration
 
-## 🔗 Related
+**Moved to .claude/config/** (commit: b4c7dd71)
+- Migrated `bmad-voices.md` from `.claude/plugins/` to `.claude/config/`
+- Moved `bmad-voices-enabled.flag` to config directory
+- Updated all references in `bmad-voice-manager.sh`
+- Aligns with Claude Code's official directory structure
+- Avoids potential conflicts with future plugin system
 
-- v2.4.1 - macOS Audio Playback Fix
-- v2.4.0 - macOS Piper TTS Support
-- BMAD Plugin Documentation: `docs/bmad-plugin.md`
+**Why This Matters:**
+- `.claude/config/` is the official location for configuration files
+- `.claude/plugins/` was never an official Claude Code directory
+- Better organization alongside `agentvibes.json`
+- Future-proof against official plugin system conflicts
 
 ---
 
-**Full Changelog**: https://github.com/paulpreibisch/AgentVibes/compare/v2.4.1...v2.4.2
+## 🐛 Bug Fixes
 
----
+### Text Escaping Issues
 
-# Release v2.4.1 - macOS Audio Playback Fix (2025-01-15)
+**Backslash Escaping Fix** (commit: b4c7dd71)
+- Fixed: TTS would speak "backslash exclamation" when text contained `\!`
+- Solution: Added defensive stripping in `play-tts.sh` lines 49-52
+- Removes `\!` and `\$` escape sequences before TTS
+- Clean speech output without unwanted "backslash" words
+- Also applied to `bmad-speak.sh` for BMAD agent dialogue
 
-## 🤖 AI Summary
+### Voice Mapping Column Numbers
 
-This patch release fixes a critical audio playback issue on macOS where Piper TTS audio files were being created but not playing. The fix adds platform detection to use the native macOS `afplay` audio player instead of trying to use Linux-only audio players (mpv/aplay/paplay) that don't exist on macOS.
+**AWK Column Parsing** (commit: b4c7dd71)
+- Fixed: Voice lookups after adding Intro column
+- AWK pipe-delimited parsing has empty $1, shifted all columns
+- Updated all column references in `bmad-voice-manager.sh`:
+  - Voice columns: 5 (ElevenLabs), 6 (Piper)
+  - Intro column: 4
+  - Personality column: 7
+- Voice selection now works correctly with new table structure
 
-## 📋 Changes
+---
 
-### 🐛 Bug Fixes
-- **Fixed macOS Audio Playback in Piper TTS**
-  - Added platform detection to use `afplay` on macOS (Darwin)
-  - Keeps existing Linux audio players (mpv/aplay/paplay) for WSL/Linux
-  - Audio files now play correctly on macOS instead of silently failing
-  - File: `.claude/hooks/play-tts-piper.sh` line 329-339
+## 📚 Documentation
 
-## 🎯 User Impact
+### TTS Queue Architecture
 
-**For macOS Users**: Audio playback now works! If you were seeing "🎵 Saved to:" messages but hearing no sound, this update fixes that. Simply run `npx agentvibes@latest install --yes` to get the fix.
+**New Documentation** (commit: b4c7dd71)
+- Added comprehensive `README-TTS-QUEUE.md` (135 lines)
+- Architecture diagrams and flow explanations
+- Queue file format and worker lifecycle details
+- Troubleshooting guide for common issues
+- Performance benefits comparison (before/after)
+- Thread safety and auto-restart behavior
 
-**What Was Broken**: After v2.4.0 added macOS Piper TTS support, audio files were being generated successfully but the playback failed silently because the script was trying to use Linux audio players that don't exist on macOS.
+### Voice Configuration Guide
 
-**What's Fixed**: The script now detects macOS and uses the native `afplay` command for audio playback.
+**Updated Table Format** (commit: b4c7dd71)
+- Documented new 6-column format with Intro field
+- Clear instructions for editing introductions
+- Examples of customizing agent identification
+- Explanation of leaving Intro blank to disable
 
-## 📦 Files Changed
+---
 
-### Modified
-- `.claude/hooks/play-tts-piper.sh` - Added macOS platform detection for audio playback
+## 🔧 Technical Details
 
-### Statistics
-- 1 file changed
-- 10 insertions(+)
-- 2 deletions(-)
+### Files Added
+- `.claude/hooks/tts-queue.sh` (105 lines) - Queue manager for TTS requests
+- `.claude/hooks/tts-queue-worker.sh` (68 lines) - Background sequential audio player
+- `.claude/hooks/README-TTS-QUEUE.md` (135 lines) - Queue system documentation
+- `.claude/config/bmad-voices.md` (moved from plugins)
+- `.claude/config/bmad-voices-enabled.flag` (moved from plugins)
 
-## 🔄 Breaking Changes
+### Files Modified
+- `.claude/hooks/bmad-speak.sh` - Display name mapping, intro support, queue integration
+- `.claude/hooks/bmad-voice-manager.sh` - Config path update, intro functions, column fixes
+- `.claude/hooks/play-tts.sh` - Backslash escaping fix
 
-None. This is a pure bug fix release.
+### Files Removed
+- `.claude/plugins/bmad-voices.md` (moved to config)
 
-## 🚀 Upgrade Notes
+### Queue System Architecture
 
-Simply run:
+**Queue File Format** (Base64 encoded):
 ```bash
-npx agentvibes@latest install --yes
+TEXT_B64=<base64-encoded-text>
+VOICE_B64=<base64-encoded-voice-name>
 ```
 
-This will update the hooks with the fixed audio playback script.
+**Worker Lifecycle:**
+1. Auto-starts when first item added to empty queue
+2. Processes oldest items first (timestamp-sorted)
+3. Blocks during audio playback (lock mechanism)
+4. Adds 2-second pause after each item
+5. Auto-exits after 5 seconds idle
 
-## 🙏 Credits
-
-Special thanks to:
-- **BMadCode** for reporting the issue and testing on macOS! (Official AgentVibes contributor 🎉)
-- macOS users who helped identify the silent audio playback problem
-
-## 🔗 Related
-
-- v2.4.0 - Initial macOS Piper TTS support
-- Issue: Audio files created but not playing on macOS
-- Fix: Platform detection for native audio player selection
-
----
-
-**Full Changelog**: https://github.com/paulpreibisch/AgentVibes/compare/v2.4.0...v2.4.1
+**Thread Safety:**
+- Queue items use nanosecond timestamps for uniqueness
+- Audio lock file prevents simultaneous playback
+- Worker PID tracking prevents multiple workers
 
 ---
 
-# Release v2.4.0 - macOS Piper TTS Support (2025-01-15)
-
-## 🤖 AI Summary
-
-This minor release brings **full Piper TTS support to macOS** via precompiled binaries, eliminating the Python dependency conflicts that previously prevented macOS users from using free offline TTS. Mac users can now install Piper TTS with zero Python dependencies - just download and run! The installer automatically detects your Mac architecture (Intel or Apple Silicon) and downloads the appropriate binary. This release also includes comprehensive GitHub Actions CI testing to validate Piper installation across all macOS versions (13, 14, 15) and both architectures.
-
-## 📋 Changes
-
-### ✨ New Features
-- **macOS Piper TTS Support via Precompiled Binaries**
-  - Downloads official Piper binaries from rhasspy/piper releases
-  - Automatic architecture detection (Apple Silicon M1/M2/M3 vs Intel)
-  - Installs to `~/.local/bin/piper` with no Python dependencies
-  - Zero pipx or pip conflicts - pure binary installation
-  - Supports both `arm64` (Apple Silicon) and `x86_64` (Intel) architectures
-
-- **Comprehensive macOS CI Testing**
-  - Tests Piper binary installation on macOS 13, 14, and 15
-  - Tests user-reported `--no-deps` pip workaround method
-  - Validates both Intel and Apple Silicon architectures
-  - Confirms standard pipx failure and binary success
-  - Runs across 9 macOS configurations (3 OS × 3 Node versions)
+## 📊 Stats
 
-### 🐛 Bug Fixes
-- **Fixed macOS Piper Installation Failures**
-  - Resolved pipx dependency conflict issues reported by users
-  - Removed incorrect platform restriction blocking macOS
-  - Fixed "Piper TTS is only supported on WSL and Linux" error
+- **Commits:** 1
+- **Files Changed:** 8
+- **Lines Added:** 420
+- **Lines Removed:** 50
+- **New Scripts:** 2 (queue manager + worker)
+- **Documentation:** 1 comprehensive guide
 
-### 📚 Documentation
-- **Updated Provider Documentation**
-  - Corrected platform support matrix to include macOS
-  - Added macOS-specific installation requirements
-  - Clarified binary vs pipx installation methods
-  - Updated "Choose Piper TTS if" section with macOS callout
-
-- **Installer Script Documentation**
-  - Added platform detection logic documentation
-  - Documented binary download and extraction process
-  - Added PATH setup instructions for macOS users
+---
 
-### 🔧 Maintenance
-- **Refactored Release Process**
-  - Extracted `showReleaseInfo()` function for code reuse
-  - Added critical ordering warning to `/release` command
-  - Documented README update before npm publish requirement
+## 🚀 Upgrade Guide
 
-## 🎯 User Impact
+### From v2.6.0
 
-**For macOS Users**: You can now use **completely free offline Piper TTS** on your Mac! No more ElevenLabs API key required. No more Python/pipx dependency hell. Just run `.claude/hooks/piper-installer.sh` and you're done. Works on both Intel Macs and Apple Silicon (M1/M2/M3).
+**No breaking changes** - this is a backward-compatible feature release.
 
-**For All Users**: The updated documentation now correctly reflects that Piper TTS works on **ALL platforms**: Windows, macOS, Linux, and WSL.
+To get the new features:
 
-**Installation is Simple**:
 ```bash
-# Run AgentVibes installer
-npx agentvibes install --yes
-
-# Or directly run Piper installer
-.claude/hooks/piper-installer.sh
+# Update AgentVibes
+npx agentvibes update
 
-# Add to PATH (if needed)
-echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
-source ~/.zshrc
+# Party mode will automatically use the queue system
+# Voice introductions work immediately with defaults
+# Config files automatically migrated to .claude/config/
 ```
 
-**Architecture Support**:
-- ✅ Apple Silicon (M1/M2/M3): Downloads `piper_macos_aarch64.tar.gz`
-- ✅ Intel Mac (x86_64): Downloads `piper_macos_x64.tar.gz`
-
-## 📦 Files Changed
-
-### Modified
-- `.claude/hooks/piper-installer.sh` - Added macOS binary installation support
-- `.github/workflows/test-macos.yml` - Added comprehensive Piper installation tests
-- `docs/providers.md` - Updated macOS support documentation
-- `.claude/commands/release.md` - Added README update ordering warning
-- `src/installer.js` - Refactored release info display
-
-### Statistics
-- 5 files changed
-- 241 insertions(+)
-- 130 deletions(-)
+### Customizing Speaker Introductions
 
-## 🔄 Breaking Changes
+Edit `.claude/config/bmad-voices.md`:
 
-None. This release is fully backward compatible. Linux/WSL users continue using pipx installation, macOS users now get binary installation.
-
-## 🚀 Upgrade Notes
-
-Simply run:
-```bash
-npx agentvibes@latest install --yes
+```markdown
+| Agent ID | Agent Name | Intro | ElevenLabs Voice | Piper Voice | Personality |
+|----------|------------|-------|------------------|-------------|-------------|
+| pm | John | John here | Matthew Schmitz | en_US-ryan-high | professional |
 ```
 
-Existing configurations are preserved. If you're on macOS and previously couldn't install Piper, it will work now!
-
-## 🙏 Credits
-
-Special thanks to:
-- **BMadCode** for reporting the macOS installation issue
-- **rhasspy/piper** project for providing macOS binaries
-- Community members who suggested the `--no-deps` workaround
-
-## 📊 Testing
-
-This release includes extensive CI testing:
-- ✅ 9 macOS configurations (macOS 13/14/15 × Node 18/20/22)
-- ✅ Both architecture types (Intel and Apple Silicon)
-- ✅ Binary download and extraction validation
-- ✅ Piper execution tests
-- ✅ Fallback to pipx testing (confirms original issue)
-
----
-
-**Full Changelog**: https://github.com/paulpreibisch/AgentVibes/compare/v2.3.1...v2.4.0
+Change "John here" to your preferred introduction text, or leave blank to disable.
 
 ---
 
-## v2.3.0 - Command Visibility Management & Maintenance (2025-11-06)
-
-### 🤖 AI Summary
-
-This minor release introduces command visibility management features allowing MCP users to hide/show AgentVibes slash commands, plus important maintenance improvements. Users who primarily interact with AgentVibes through MCP tools can now declutter their Claude Code command palette by hiding slash commands, while still retaining full MCP functionality. The release also includes improved .gitignore rules to exclude runtime and user-generated files from version control.
-
-### 📋 Changes
-
-#### ✨ New Features
-- **Command Visibility Management**: New `/agent-vibes:hide` and `/agent-vibes:show` commands
-  - Hide all AgentVibes slash commands from Claude Code interface
-  - Keeps only hide/show commands visible when hidden
-  - MCP functionality remains completely unaffected
-  - Commands safely backed up to `.claude/.agentvibes-backup/`
-  - Perfect for users who prefer MCP tools over slash commands
-
-#### 🔧 Maintenance
-- **Enhanced .gitignore**: Improved exclusion rules for runtime files
-  - `.claude/plugins/*.flag` - Plugin state flags
-  - `.claude/piper-voices/` - Downloaded voice models
-  - `.claude/piper-voices-dir.txt` - Voice directory config
-  - `.claude/github-star-reminder.txt` - UI reminder state
-  - `.claude/.agentvibes-backup/` - Hidden command backups
-  - `.claude/.agentvibes-hidden.flag` - Command visibility state
-
-#### 📚 Documentation
-- **README**: Updated version to v2.2.3
-- **MCP Config**: Cleaned up `.mcp-minimal.json` configuration
+## 💡 Usage Examples
 
-### 🎯 User Impact
+### Queue Status Commands
 
-**For MCP Users**: If you primarily use AgentVibes through MCP tools and find the slash commands cluttering your command palette, you can now use `/agent-vibes:hide` to clean up the interface. Your MCP functionality will work exactly the same. Use `/agent-vibes:show` anytime to restore commands.
+```bash
+# Check queue status
+bash .claude/hooks/tts-queue.sh status
 
-**For All Users**: The improved .gitignore ensures that runtime-generated files (voice models, state flags, reminders) are never accidentally committed to version control, keeping your git history clean.
+# Clear all pending TTS (emergency stop)
+bash .claude/hooks/tts-queue.sh clear
+```
 
-**Command Organization**: The 29 AgentVibes slash commands can now be completely hidden with a single command, leaving only the hide/show toggles visible. This is ideal for users who:
-- Prefer using MCP tools directly
-- Want a cleaner command palette
-- Are setting up AgentVibes for others
-- Have memorized their favorite commands
+### Party Mode Improvements
 
-### 📦 Files Changed
-- `.claude/commands/agent-vibes/hide.md` - NEW: Hide commands feature
-- `.claude/commands/agent-vibes/show.md` - NEW: Show commands feature
-- `.gitignore` - Enhanced runtime file exclusions
-- `.mcp-minimal.json` - Configuration cleanup
-- `README.md` - Version update to v2.2.3
+When multiple BMAD agents respond:
 
-### 🔄 Breaking Changes
-None. This release is fully backward compatible.
+**Before:**
+- All voices spoke simultaneously (overlapping audio)
+- No natural pauses between speakers
+- No identification of which agent is speaking
 
-### 🚀 Upgrade Notes
-Simply run `npx agentvibes@latest` to get the new features. Existing configurations and settings are preserved.
+**After:**
+- Sequential playback with correct voices
+- 2-second pauses for natural flow
+- Each agent identifies themselves (e.g., "Mary, Business Analyst here")
+- Claude Code remains responsive during TTS
 
 ---
 
-## v2.2.1 - Documentation & Installer UX Improvements (2025-11-03)
-
-### 🤖 AI Summary
-
-This patch release improves the user experience during installation and updates the documentation to reflect the latest v2.2.0 features. The MCP server configuration display has been redesigned with cleaner visual formatting, making it easier to copy the JSON configuration without accidentally including border characters. The README now properly highlights v2.2.0's provider-aware features, BMAD v6 support, and the transition from output-styles to SessionStart hooks.
-
-### 📋 Changes
+## 🤝 Contributors
 
-#### ✨ Improvements
-- **Installer UX**: Split MCP configuration display into three sections for cleaner formatting
-  - Top boxed section with intro and description
-  - Middle section (no box) showing only the JSON config for easy copy-paste
-  - Bottom boxed section with setup links and guides
-  - Prevents accidental copying of border characters when copying JSON config
+- Paul Preibisch (@paulpreibisch)
+- Claude AI (code generation assistant)
 
-#### 📚 Documentation
-- **README**: Updated latest release section to showcase v2.2.0 features
-  - Provider-aware voice switching
-  - **BMAD v6 support** with full backward compatibility to v4
-  - MCP NPX configuration improvements
-  - Improved installer UX highlights
-  - Better voice mapping details
-- **Architecture Change**: Documented transition from output-styles to SessionStart hooks
-  - SessionStart hook now automatically loads TTS protocol on every session
-  - Cleaner, more reliable activation mechanism
-  - No need for manual output-style selection
-
-### 🎯 User Impact
-
-**For New Users**: The improved installer display makes it much easier to copy the MCP server configuration into your `~/.claude/mcp.json` file without formatting issues. You'll also benefit from the new SessionStart hook architecture which automatically activates TTS on every Claude Code session.
-
-**For Existing Users**: When running `npx agentvibes install` or viewing installation instructions, you'll see a cleaner, more professional display that's easier to read and use. Note that AgentVibes now uses SessionStart hooks instead of output-styles for automatic activation.
+---
 
-**BMAD Users**: Full support for BMAD-METHOD v6-alpha with automatic agent voice assignment, while maintaining complete backward compatibility with v4.
+## 🔗 Links
 
-### 📦 Files Changed
-- `README.md` - Updated v2.2.0 release highlights
-- `src/installer.js` - Improved MCP configuration display formatting
-- `.claude/github-star-reminder.txt` - Updated reminder state
-- `AgentVibes.code-workspace` - Workspace configuration updates
+- **npm Package:** https://www.npmjs.com/package/agentvibes
+- **GitHub Repository:** https://github.com/paulpreibisch/AgentVibes
+- **GitHub Release:** https://github.com/paulpreibisch/AgentVibes/releases/tag/v2.7.0
 
 ---
 
-## v2.2.0 - Provider-Aware Features, BMAD v6 Support & MCP Improvements (2025-11-02)
+**Full Changelog:** https://github.com/paulpreibisch/AgentVibes/compare/v2.6.0...v2.7.0
 
-### 🤖 AI Summary
+---
 
-Major enhancements to multi-provider support, BMAD integration, and MCP server configuration! This release makes AgentVibes smarter about which TTS provider you're using and adds full support for BMAD-METHOD v6-alpha with complete backward compatibility to v4.

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "agentvibes",
-  "version": "2.5.0",
+  "version": "2.7.0",
   "description": "Now your AI Agents can finally talk back! Professional TTS voice for Claude Code and Claude Desktop (via MCP) with multi-provider support.",
   "homepage": "https://agentvibes.org",
   "keywords": [

package/src/bmad-detector.js

@@ -9,7 +9,7 @@ import yaml from 'js-yaml';
  */
 export async function detectBMAD(targetDir) {
   // Check v6 first (newer version)
-  const v6Manifest = path.join(targetDir, 'bmad/_cfg/manifest.yaml');
+  const v6Manifest = path.join(targetDir, '.bmad/_cfg/manifest.yaml');
   try {
     await fs.access(v6Manifest);
     const manifestContent = await fs.readFile(v6Manifest, 'utf8');
@@ -19,8 +19,8 @@ export async function detectBMAD(targetDir) {
       version: 6,
       detailedVersion: manifest.installation?.version || '6.0.0-alpha.x',
       manifestPath: v6Manifest,
-      configPath: path.join(targetDir, 'bmad/core/config.yaml'),
-      bmadPath: path.join(targetDir, 'bmad'),
+      configPath: path.join(targetDir, '.bmad/core/config.yaml'),
+      bmadPath: path.join(targetDir, '.bmad'),
       installed: true
     };
   } catch {}