agentvibes 2.1.3 → 2.1.5

package/.claude/github-star-reminder.txt

@@ -1 +1 @@
-20251026
+20251031

package/.claude/hooks/bmad-tts-injector.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #
 # File: .claude/hooks/bmad-tts-injector.sh
 #

package/.claude/hooks/bmad-voice-manager.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #
 # File: .claude/hooks/bmad-voice-manager.sh
 #

package/.claude/hooks/check-output-style.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #
 # File: .claude/hooks/check-output-style.sh
 #

package/.claude/hooks/download-extra-voices.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #
 # File: .claude/hooks/download-extra-voices.sh
 #

package/.claude/hooks/github-star-reminder.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #
 # File: .claude/hooks/github-star-reminder.sh
 #

package/.claude/hooks/language-manager.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #
 # File: .claude/hooks/language-manager.sh
 #

package/.claude/hooks/learn-manager.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #
 # File: .claude/hooks/learn-manager.sh
 #

package/.claude/hooks/personality-manager.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #
 # File: .claude/hooks/personality-manager.sh
 #

package/.claude/hooks/piper-download-voices.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #
 # File: .claude/hooks/piper-download-voices.sh
 #

package/.claude/hooks/piper-installer.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #
 # File: .claude/hooks/piper-installer.sh
 #

package/.claude/hooks/piper-multispeaker-registry.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #
 # File: .claude/hooks/piper-multispeaker-registry.sh
 #

package/.claude/hooks/piper-voice-manager.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #
 # File: .claude/hooks/piper-voice-manager.sh
 #

package/.claude/hooks/play-tts-elevenlabs.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #
 # File: .claude/hooks/play-tts-elevenlabs.sh
 #

package/.claude/hooks/play-tts-piper.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #
 # File: .claude/hooks/play-tts-piper.sh
 #
@@ -65,11 +65,22 @@ if [[ -n "$VOICE_OVERRIDE" ]]; then
   VOICE_MODEL="$VOICE_OVERRIDE"
   echo "🎤 Using voice: $VOICE_OVERRIDE (session-specific)"
 else
-  # Try to get voice from voice file (project-local first, then global)
+  # Try to get voice from voice file (check CLAUDE_PROJECT_DIR first for MCP context)
   VOICE_FILE=""
-  if [[ -f "$SCRIPT_DIR/../tts-voice.txt" ]]; then
+
+  # Priority order:
+  # 1. CLAUDE_PROJECT_DIR env var (set by MCP for project-specific settings)
+  # 2. Script location (for direct slash command usage)
+  # 3. Global ~/.claude (fallback)
+
+  if [[ -n "$CLAUDE_PROJECT_DIR" ]] && [[ -f "$CLAUDE_PROJECT_DIR/.claude/tts-voice.txt" ]]; then
+    # MCP context: Use the project directory where MCP was invoked
+    VOICE_FILE="$CLAUDE_PROJECT_DIR/.claude/tts-voice.txt"
+  elif [[ -f "$SCRIPT_DIR/../tts-voice.txt" ]]; then
+    # Direct usage: Use script location
     VOICE_FILE="$SCRIPT_DIR/../tts-voice.txt"
   elif [[ -f "$HOME/.claude/tts-voice.txt" ]]; then
+    # Fallback: Use global
     VOICE_FILE="$HOME/.claude/tts-voice.txt"
   fi
 
@@ -77,8 +88,10 @@ else
     FILE_VOICE=$(cat "$VOICE_FILE" 2>/dev/null)
 
     # Check for multi-speaker voice (model + speaker ID stored separately)
-    MODEL_FILE="$SCRIPT_DIR/../tts-piper-model.txt"
-    SPEAKER_ID_FILE="$SCRIPT_DIR/../tts-piper-speaker-id.txt"
+    # Use same directory as VOICE_FILE for consistency
+    VOICE_DIR=$(dirname "$VOICE_FILE")
+    MODEL_FILE="$VOICE_DIR/tts-piper-model.txt"
+    SPEAKER_ID_FILE="$VOICE_DIR/tts-piper-speaker-id.txt"
 
     if [[ -f "$MODEL_FILE" ]] && [[ -f "$SPEAKER_ID_FILE" ]]; then
       # Multi-speaker voice

package/.claude/hooks/play-tts.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #
 # File: .claude/hooks/play-tts.sh
 #

package/.claude/hooks/provider-commands.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #
 # File: .claude/hooks/provider-commands.sh
 #

package/.claude/hooks/provider-manager.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #
 # File: .claude/hooks/provider-manager.sh
 #

package/.claude/hooks/replay-target-audio.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #
 # File: .claude/hooks/replay-target-audio.sh
 #

package/.claude/hooks/sentiment-manager.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #
 # File: .claude/hooks/sentiment-manager.sh
 #

package/.claude/hooks/speed-manager.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #
 # File: .claude/hooks/speed-manager.sh
 #

package/.claude/hooks/voice-manager.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #
 # File: .claude/hooks/voice-manager.sh
 #

package/.claude/hooks/voices-config.sh

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #
 # File: .claude/hooks/voices-config.sh
 #

package/MACOS_TESTING_SETUP.md

@@ -0,0 +1,216 @@
+# 🍎 macOS Testing Setup Complete!
+
+## ✅ What's Been Added
+
+### 1. **Dual Workflow Setup**
+   - **Main Test Workflow** (`.github/workflows/test.yml`)
+     - Fast testing on Ubuntu + macOS
+     - Node 18, 20
+     - Runs on every push/PR
+
+   - **Dedicated macOS Workflow** (`.github/workflows/test-macos.yml`)
+     - Comprehensive macOS testing
+     - macOS 13 (Intel), 14 (M1), 15 (Latest)
+     - Node 18, 20, 22
+     - Manual trigger available
+
+### 2. **Test Coverage**
+   - ✅ Unit tests (BATS)
+   - ✅ System compatibility checks
+   - ✅ Audio stack validation (afplay, ffmpeg, mpv)
+   - ✅ Piper TTS architecture detection
+   - ✅ ElevenLabs API mock testing
+   - ✅ Python MCP dependencies
+   - ✅ Audio file generation
+   - ✅ Installation process
+
+### 3. **Documentation**
+   - 📖 [docs/macos-testing.md](docs/macos-testing.md) - Complete guide
+   - 📄 [.github/MACOS_TESTING_QUICKSTART.md](.github/MACOS_TESTING_QUICKSTART.md) - Quick reference
+   - 📋 Updated README with macOS testing link
+
+## 🎯 How to Use
+
+### Automatic Testing (Recommended)
+```bash
+# Just push your code - tests run automatically!
+git push origin master
+```
+
+Tests will run on:
+- 2 OS (Ubuntu + macOS) × 2 Node versions = **4 test jobs** (main workflow)
+- 3 macOS versions × 3 Node versions = **9 test jobs** (macOS workflow)
+
+### Manual Testing
+1. Go to GitHub → **Actions** tab
+2. Select **macOS Test Suite**
+3. Click **Run workflow**
+
+### Local Testing (If You Have a Mac)
+```bash
+brew install bats-core
+npm install
+npm test
+```
+
+## 💰 Cost Comparison
+
+| Option | Cost | Coverage |
+|--------|------|----------|
+| **GitHub Actions** | **$0** | Intel + M1 + Latest macOS |
+| Mac VPS (UltaHost) | $4.80-22.50/mo | Limited, no GUI, audio issues |
+| MacStadium | $79+/mo | Full Mac in cloud |
+| Buy a Mac | $599+ | One-time, real hardware |
+
+**Winner: GitHub Actions** - FREE + automatic + real hardware! 🏆
+
+## 🚀 What Happens Next
+
+### On Every Push:
+1. Tests trigger automatically
+2. Run on Ubuntu + macOS in parallel
+3. Results show in PR checks
+4. Badge updates in README
+
+### On Test Failure:
+1. Review logs in Actions tab
+2. Download artifacts if needed
+3. Fix locally or in GitHub
+4. Push again - retests automatically
+
+## 📊 Matrix Testing
+
+### Main Workflow (Fast)
+```yaml
+Ubuntu + Node 18 ✓
+Ubuntu + Node 20 ✓
+macOS + Node 18 ✓
+macOS + Node 20 ✓
+```
+
+### macOS Workflow (Comprehensive)
+```yaml
+macOS 13 (Intel) + Node 18 ✓
+macOS 13 (Intel) + Node 20 ✓
+macOS 13 (Intel) + Node 22 ✓
+macOS 14 (M1) + Node 18 ✓
+macOS 14 (M1) + Node 20 ✓
+macOS 14 (M1) + Node 22 ✓
+macOS 15 + Node 18 ✓
+macOS 15 + Node 20 ✓
+macOS 15 + Node 22 ✓
+```
+
+## 🎉 Benefits
+
+### No Mac VPS Needed!
+- ❌ No monthly fees
+- ❌ No SSH audio forwarding headaches
+- ❌ No VNC/GUI setup complexity
+- ❌ No limited server resources
+
+### GitHub Actions Gives You:
+- ✅ Real macOS hardware
+- ✅ Both Intel and Apple Silicon
+- ✅ Actual audio tools installed
+- ✅ Free on public repos
+- ✅ Automatic on every commit
+- ✅ Parallel test execution
+- ✅ Artifact storage for debugging
+
+## 🔍 Viewing Results
+
+### In Pull Requests
+Check the bottom of any PR:
+```
+✓ Test Suite / Test on ubuntu-latest (Node 18)
+✓ Test Suite / Test on ubuntu-latest (Node 20)
+✓ Test Suite / Test on macos-latest (Node 18)
+✓ Test Suite / Test on macos-latest (Node 20)
+```
+
+### In Actions Tab
+1. Click **Actions** at top of repo
+2. See all test runs
+3. Click any run for details
+4. Expand steps for full output
+
+### Status Badge
+README shows current status:
+```markdown
+[![Test Suite](https://github.com/paulpreibisch/AgentVibes/actions/workflows/test.yml/badge.svg)](...)
+```
+
+## 🐛 Troubleshooting
+
+### Tests Failing?
+1. Click **Details** in PR check
+2. Review failed step output
+3. Check system info section
+4. Download artifacts if available
+
+### Want More Details?
+See [docs/macos-testing.md](docs/macos-testing.md) for:
+- Running tests locally
+- Debugging tips
+- Adding new tests
+- Architecture-specific testing
+
+## 📝 Next Steps
+
+### Immediate:
+1. ✅ Push this commit
+2. ✅ Watch tests run
+3. ✅ Verify all pass
+
+### Future Enhancements:
+- [ ] Test real ElevenLabs API (with secrets)
+- [ ] Test Piper TTS full installation
+- [ ] Test Claude Desktop integration
+- [ ] Performance benchmarks
+- [ ] Audio quality validation
+
+## 🤝 Contributing
+
+Mac users can help by:
+- Running tests locally
+- Reporting macOS-specific issues
+- Testing on different macOS versions
+- Suggesting new test cases
+
+## 📚 Documentation Files
+
+1. **[docs/macos-testing.md](docs/macos-testing.md)**
+   - Complete testing guide
+   - Local testing instructions
+   - Debugging help
+   - Contributing guidelines
+
+2. **[.github/MACOS_TESTING_QUICKSTART.md](.github/MACOS_TESTING_QUICKSTART.md)**
+   - Quick reference
+   - TL;DR guide
+   - Common tasks
+
+3. **[.github/workflows/test.yml](.github/workflows/test.yml)**
+   - Main test workflow
+   - Ubuntu + macOS
+   - Fast execution
+
+4. **[.github/workflows/test-macos.yml](.github/workflows/test-macos.yml)**
+   - Dedicated macOS tests
+   - Comprehensive coverage
+   - Manual trigger
+
+---
+
+## 🎊 Conclusion
+
+**You don't need to rent a Mac VPS!**
+
+GitHub Actions provides FREE, automatic, comprehensive macOS testing on real hardware with both Intel and Apple Silicon support.
+
+Just push your code and let GitHub Actions handle the rest! 🚀
+
+---
+
+**Questions?** See [docs/macos-testing.md](docs/macos-testing.md) or open an issue.

package/README.md

@@ -84,6 +84,7 @@ Whether you're coding in Claude Code, chatting in Claude Desktop, or using Warp
 ### Additional Resources
 - [🔗 Useful Links](#-useful-links) - Voice typing & AI tools
 - [🔄 Updating](#-updating) - Keep AgentVibes current
+- [🍎 macOS Testing](docs/macos-testing.md) - Automated testing on macOS with GitHub Actions
 - [🙏 Credits](#-credits) - Acknowledgments
 - [🤝 Contributing](#-contributing) - Show support