agentvibes 2.0.20 → 2.0.22

package/RELEASE_NOTES.md

@@ -1,274 +1,67 @@
-# 🎤 AgentVibes v2.0.18 Release Notes
+# 🎤 AgentVibes Release Notes
 
-## 📦 v2.0.18 - Multi-Speaker Voices & HuggingFace Integration (2025-10-17)
+## 📦 v2.0.21 - Test Suite & Quality Improvements (2025-10-22)
 
 ### 🎯 Overview
 
-This release introduces **multi-speaker voice support** for Piper TTS, allowing users to select from 16 different voice personalities within a single voice model. Additionally, all custom voices are now hosted on **HuggingFace** for reliable, free access.
-
-**Release Date:** October 17, 2025
-**Git Tag:** v2.0.18
-**Commits Since v2.0.17:** 14 commits
-**Files Changed:** 72 files, +38,462 insertions, -544 deletions
-
----
-
-## 🌟 **New Features**
-
-### **1. Multi-Speaker Voice Support** 🎭
-
-AgentVibes now supports Piper voices that contain multiple speakers in one model:
-
-**New Format:** `voicename#speakerID`
-
-```bash
-# Switch to specific speaker
-/agent-vibes:switch 16Speakers#0   # Cori Samuel
-/agent-vibes:switch 16Speakers#2   # Kristin Hughes
-/agent-vibes:switch 16Speakers#15  # Martin Clifton
-```
-
-**Features:**
-- Auto-detection of multi-speaker voices via JSON metadata
-- Enhanced voice listing shows all speakers with names
-- Current speaker marked with `▶` indicator
-- Supports 0-based speaker indexing
-- Seamless switching between speakers
-
-**16Speakers Voice Personalities:**
-1. Cori Samuel (ID 0)
-2. Kara Shallenberg (ID 1)
-3. Kristin Hughes (ID 2)
-4. Maria Kasper (ID 3)
-5. Mike Pelton (ID 4)
-6. Mark Nelson (ID 5)
-7. Michael Scherer (ID 6)
-8. James K White (ID 7)
-9. Rose Ibex (ID 8)
-10. progressingamerica (ID 9)
-11. Steve C (ID 10)
-12. Owlivia (ID 11)
-13. Paul Hampton (ID 12)
-14. Jennifer Dorr (ID 13)
-15. Emily Cripps (ID 14)
-16. Martin Clifton (ID 15)
-
-### **2. HuggingFace Voice Repository** 🤗
-
-All custom AgentVibes voices are now hosted on HuggingFace:
-
-**Repository:** https://huggingface.co/agentvibes/piper-custom-voices
-
-**Available Voices:**
-- **16Speakers.onnx** (77MB) - Multi-speaker voice with 16 personalities
-- **kristin.onnx** (64MB) - US English female (Public Domain)
-- **jenny.onnx** (64MB) - UK English female, Irish accent (CC BY)
-
-**Benefits:**
-- ✅ Free, reliable CDN hosting
-- ✅ Version-controlled voice models
-- ✅ Automatic downloads during installation
-- ✅ Preview audio samples included
-- ✅ Community-accessible
-
-### **3. Enhanced Voice Listing** 📋
-
-The `/agent-vibes:list` command now intelligently displays multi-speaker voices:
-
-**Before:**
-```
-  en_US-lessac-medium
-  16Speakers
-  kristin
-```
-
-**After:**
-```
-  en_US-lessac-medium
-
-📢 16Speakers (Multi-speaker: 16 voices)
-  0️. Cori_Samuel
-  1️. Kara_Shallenberg
-▶ 2️. Kristin_Hughes (current)
-  ...
-
-  kristin
-```
-
-**Features:**
-- Groups speakers under parent voice
-- Shows speaker names and IDs
-- Marks current speaker selection
-- Automatic detection via `num_speakers` in JSON
-
----
-
-## 🔧 **Technical Improvements**
-
-### Voice Manager Enhancements
-- **Multi-speaker detection** - Reads `num_speakers` from voice JSON
-- **Speaker listing** - Displays all speakers with formatted names
-- **Current speaker tracking** - Parses `voicename#speakerID` format
-- **Custom voice fallback** - Supports non-standard voice paths
-
-### Piper TTS Provider Updates
-- **Speaker ID parsing** - Extracts speaker from `voicename#speakerID`
-- **Error suppression** - Hides voice path errors for custom voices
-- **Custom voice path support** - Bypasses standard voice manager
-- **Speaker parameter** - Passes `--speaker ID` to piper command
-
-### Download Script Integration
-- **HuggingFace URLs** - Updated from DigitalOcean to HuggingFace
-- **16Speakers download** - Added to custom voice list
-- **Attribution updates** - Credits AgentVibes + Bryce Beattie
-- **Usage instructions** - Shows multi-speaker format examples
-
----
-
-## 📚 **Documentation Updates**
-
-### New Documentation
-- `docs/bryce-beattie-voice-licensing.md` - Voice licensing information
-- `docs/huggingface-setup-guide.md` - HuggingFace upload guide
-- `mcp-server/voices/README.md` - Voice repository documentation
-
-### Updated Documentation
-- `docs/commands.md` - Added multi-speaker voice section
-- `docs/commands.md` - Added `/agent-vibes:switch <voice>#<speaker>` command
-- `.claude/hooks/piper-download-voices.sh` - HuggingFace integration
-
-### Command Examples Added
-```bash
-# List all speakers
-/agent-vibes:list
-
-# Switch to specific speaker
-/agent-vibes:switch 16Speakers#0   # Cori Samuel
-/agent-vibes:switch 16Speakers#15  # Martin Clifton
-
-# Preview voices
-/agent-vibes:preview
-```
-
----
-
-## 🐛 **Bug Fixes**
-
-### Voice Path Error Handling
-- **Fixed:** Error messages for custom voices not in standard paths
-- **Solution:** Added `2>/dev/null` to suppress stderr from `get_voice_path`
-- **Impact:** Cleaner output when using custom voices
-
-### Voice Detection
-- **Fixed:** Custom voices not recognized by voice manager
-- **Solution:** Added fallback to `~/.local/share/piper/voices/` directory
-- **Impact:** 16Speakers and other custom voices now work seamlessly
-
----
-
-## 📦 **Installation**
-
-### Fresh Install
-```bash
-npx agentvibes install
-```
-
-The installer will automatically offer to download:
-- Standard Piper voices (lessac, amy, joe, ryan, libritts)
-- **Custom voices: Kristin, Jenny, 16Speakers (NEW!)**
-
-### Update Existing Installation
-```bash
-npx agentvibes update
-```
-
-Then download new voices:
-```bash
-.claude/hooks/piper-download-voices.sh
-```
-
-Or download manually from HuggingFace:
-```bash
-# Download 16Speakers
-wget https://huggingface.co/agentvibes/piper-custom-voices/resolve/main/16Speakers.onnx
-wget https://huggingface.co/agentvibes/piper-custom-voices/resolve/main/16Speakers.onnx.json
-```
-
----
-
-## 🎨 **Voice Attribution**
-
-All custom voices created by **Bryce Beattie** (https://brycebeattie.com/files/tts/)
-
-### Licensing
-- **Kristin**: Public Domain (LibriVox recordings)
-- **16Speakers**: Public Domain (LibriVox recordings)
-- **Jenny**: CC BY (Dioco dataset - attribution required)
-
-### Creator's Permission
-> "Feel free to use these for any legal and ethical purpose. If somebody wants to upload these to HuggingFace or somewhere similar, you have my blessing." — Bryce Beattie
+This patch release focuses on **test reliability** and **user experience improvements**, making the testing process completely silent and replacing distracting tongue twisters with simple test messages.
 
----
-
-## 📝 **Breaking Changes**
-
-None. All changes are backward compatible.
+**Release Date:** October 22, 2025
+**Git Tag:** v2.0.21
+**NPM tests:** All 110 tests passing ✅
 
 ---
 
-## 🔗 **Links**
-
-- **NPM Package**: https://www.npmjs.com/package/agentvibes
-- **GitHub Repository**: https://github.com/paulpreibisch/AgentVibes
-- **HuggingFace Voices**: https://huggingface.co/agentvibes/piper-custom-voices
-- **Documentation**: https://github.com/paulpreibisch/AgentVibes/blob/master/README.md
-- **Voice Creator**: https://brycebeattie.com/files/tts/
-
----
+### ✨ New Features
 
-## 🙏 **Credits**
+- **Silent Test Mode**: Tests now run completely silently when `AGENTVIBES_TEST_MODE=true` is set
 
-- **Voice Models**: Bryce Beattie
-- **Multi-Speaker Implementation**: Paul Preibisch with Claude AI
-- **HuggingFace Integration**: AgentVibes Team
-- **Piper TTS**: rhasspy project
+### 🐛 Bug Fixes
 
----
+- **Fixed provider-manager tests**: Updated 2 failing tests that expected "voice reset to default" but code outputs "voice set to: [voice_name]"
+- **Removed tongue twisters**: Replaced distracting tongue twisters with simple test messages:
+  - "Testing speed change"
+  - "Speed test in progress"
+  - "Checking audio speed"
+  - "Speed configuration test"
+  - "Audio speed test"
 
-## 📊 **Statistics**
+### 🧪 Testing Improvements
 
-- **Total Voice Files Added**: 35 files
-- **Voice Model Size**: 205 MB total (16Speakers: 77MB, Kristin: 64MB, Jenny: 64MB)
-- **Preview Audio Samples**: 16 WAV files included
-- **Documentation Files**: 3 new guides
-- **Code Changes**: 72 files modified, +38,462 lines
+- **Test configuration**: `npm test` now automatically sets `AGENTVIBES_TEST_MODE=true` for silent execution
+- **Audio playback control**: Both Piper and ElevenLabs TTS scripts now respect `AGENTVIBES_TEST_MODE` flag
+- **Updated test assertions**: Speed manager tests now check for simple messages instead of tongue twisters
 
----
+### 📝 Files Changed
 
-## 🚀 **What's Next**
+- `.claude/hooks/play-tts-piper.sh` - Added AGENTVIBES_TEST_MODE check
+- `.claude/hooks/play-tts-elevenlabs.sh` - Added AGENTVIBES_TEST_MODE check
+- `.claude/hooks/speed-manager.sh` - Replaced tongue twisters with simple messages
+- `mcp-server/server.py` - Replaced tongue twisters with simple messages
+- `test/unit/provider-manager.bats` - Fixed 2 failing tests
+- `test/unit/speed-manager.bats` - Updated test assertions
+- `package.json` - Added AGENTVIBES_TEST_MODE to test scripts
 
-Future releases may include:
-- Additional multi-speaker voices
-- Voice browsing/preview command
-- Voice quality ratings
-- Community voice submissions
-- Per-speaker speed control
+### 🎓 User Impact
 
----
+**For Developers:**
+- Running `npm test` is now completely silent - no more disruptive audio during test runs
+- Clearer test output without tongue twister noise
+- More reliable test suite (all 110 tests passing)
 
-**Enjoy the new multi-speaker voices! 🎤✨**
+**For Users:**
+- Speed change demos now use simple, professional messages instead of tongue twisters
+- No functional changes to TTS or voice features
 
-Choose from 16 different personalities with a simple command:
-```bash
-/agent-vibes:switch 16Speakers#2   # Kristin Hughes
-```
+### 📊 Test Coverage
 
+- **110 tests passing** ✅
+- **0 tests failing**
+- **Silent execution** when run via npm test
 
 ---
 
 
-# 🎤 AgentVibes Release Notes
-
 ## 📦 v2.0.17 - Major Feature Release (2025-10-17)
 
 ### 🎯 Overview