agentvibes 2.1.4 → 2.2.0-beta.1

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
 #
@@ -48,24 +48,29 @@ CYAN='\033[0;36m'
 GRAY='\033[0;90m'
 NC='\033[0m' # No Color
 
-# Detect BMAD installation
+# Detect BMAD installation and version
+# Supports both v4 (.bmad-core/) and v6-alpha (bmad/) installations
 detect_bmad() {
   local bmad_core_dir=""
 
-  # Check current directory first
-  if [[ -d ".bmad-core" ]]; then
+  # Check for v6-alpha first (newer version)
+  if [[ -d "bmad" ]]; then
+    bmad_core_dir="bmad"
+  elif [[ -d "../bmad" ]]; then
+    bmad_core_dir="../bmad"
+  # Check for v4 (legacy)
+  elif [[ -d ".bmad-core" ]]; then
     bmad_core_dir=".bmad-core"
-  # Check parent directory
   elif [[ -d "../.bmad-core" ]]; then
     bmad_core_dir="../.bmad-core"
-  # Check for bmad-core (without dot prefix)
+  # Check for bmad-core (without dot prefix, legacy variant)
   elif [[ -d "bmad-core" ]]; then
     bmad_core_dir="bmad-core"
   elif [[ -d "../bmad-core" ]]; then
     bmad_core_dir="../bmad-core"
   else
     echo -e "${RED}❌ BMAD installation not found${NC}" >&2
-    echo -e "${GRAY}   Looked for .bmad-core or bmad-core directory${NC}" >&2
+    echo -e "${GRAY}   Looked for bmad/, .bmad-core/, or bmad-core/ directory${NC}" >&2
     return 1
   fi
 

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

@@ -1,4 +1,4 @@
-#!/bin/bash
+#!/usr/bin/env bash
 #
 # File: .claude/hooks/bmad-voice-manager.sh
 #
@@ -43,9 +43,61 @@ PLUGIN_DIR=".claude/plugins"
 PLUGIN_FILE="$PLUGIN_DIR/bmad-voices.md"
 ENABLED_FLAG="$PLUGIN_DIR/bmad-voices-enabled.flag"
 
-# AI NOTE: Auto-enable pattern - When BMAD is detected via .bmad-core/install-manifest.yaml,
+# AI NOTE: Auto-enable pattern - When BMAD is detected via install-manifest.yaml,
 # automatically enable the voice plugin to provide seamless multi-agent voice support.
 # This avoids requiring manual plugin activation after BMAD installation.
+# Supports both BMAD v4 (.bmad-core/) and v6-alpha (bmad/) directory structures.
+
+# @function detect_bmad_version
+# @intent Detect BMAD installation and return version number
+# @why Support both v4 and v6-alpha installations with different directory structures
+# @param None
+# @returns Echoes version number (4, 6, or 0 for not installed) to stdout
+# @exitcode 0=detected, 1=not installed
+# @sideeffects None
+# @edgecases Checks v6 first (newer version), falls back to v4
+# @calledby auto_enable_if_bmad_detected, get_bmad_config_path
+# @calls None
+detect_bmad_version() {
+    if [[ -f "bmad/_cfg/manifest.yaml" ]]; then
+        # v6 detected
+        echo "6"
+        return 0
+    elif [[ -f ".bmad-core/install-manifest.yaml" ]]; then
+        # v4 detected
+        echo "4"
+        return 0
+    else
+        # Not installed
+        echo "0"
+        return 1
+    fi
+}
+
+# @function get_bmad_config_path
+# @intent Get BMAD configuration file path based on detected version
+# @why v4 and v6 use different directory structures for config files
+# @param None
+# @returns Echoes config path to stdout, empty string if not installed
+# @exitcode 0=path returned, 1=not installed
+# @sideeffects None
+# @edgecases Returns empty string if BMAD not detected
+# @calledby Commands that need to read BMAD config (future use)
+# @calls detect_bmad_version
+get_bmad_config_path() {
+    local version=$(detect_bmad_version)
+
+    if [[ "$version" == "6" ]]; then
+        echo "bmad/core/config.yaml"
+        return 0
+    elif [[ "$version" == "4" ]]; then
+        echo ".bmad-core/config.yaml"
+        return 0
+    else
+        echo ""
+        return 1
+    fi
+}
 
 # @function auto_enable_if_bmad_detected
 # @intent Automatically enable BMAD voice plugin when BMAD framework is detected
@@ -56,10 +108,12 @@ ENABLED_FLAG="$PLUGIN_DIR/bmad-voices-enabled.flag"
 # @sideeffects Creates enabled flag file, creates plugin directory
 # @edgecases Only auto-enables if plugin not already enabled, silent operation
 # @calledby get_agent_voice
-# @calls mkdir, touch
+# @calls mkdir, touch, detect_bmad_version
 auto_enable_if_bmad_detected() {
-    # Check if BMAD is installed
-    if [[ -f ".bmad-core/install-manifest.yaml" ]] && [[ ! -f "$ENABLED_FLAG" ]]; then
+    local version=$(detect_bmad_version)
+
+    # Check if BMAD is installed (any version) and plugin not already enabled
+    if [[ "$version" != "0" ]] && [[ ! -f "$ENABLED_FLAG" ]]; then
         # BMAD detected but plugin not enabled - enable it silently
         mkdir -p "$PLUGIN_DIR"
         touch "$ENABLED_FLAG"

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
 #

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

@@ -11,7 +11,7 @@
 [![Publish](https://github.com/paulpreibisch/AgentVibes/actions/workflows/publish.yml/badge.svg)](https://github.com/paulpreibisch/AgentVibes/actions/workflows/publish.yml)
 [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 
-**Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v2.1.0
+**Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v2.1.5
 
 ---
 
@@ -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
 
@@ -91,16 +92,16 @@ Whether you're coding in Claude Code, chatting in Claude Desktop, or using Warp
 
 ## 📰 Latest Release
 
-**[v2.1.0 - Streamlined Installation & CI Improvements](https://github.com/paulpreibisch/AgentVibes/releases/tag/v2.1.0)** 🎉
+**[v2.1.5 - Critical macOS Compatibility Fix + GitHub Actions Testing](https://github.com/paulpreibisch/AgentVibes/releases/tag/v2.1.5)** 🍎
 
-**NEW: Automatic Piper Installation!** No more manual steps - when you select Piper TTS, AgentVibes now automatically detects if it's installed and offers to install it for you. Plus streamlined CI workflow improvements!
+**CRITICAL macOS FIX!** All shell scripts now use `#!/usr/bin/env bash` instead of `#!/bin/bash`, enabling AgentVibes to work on macOS. The old shebang forced bash 3.2 (from 2007) which doesn't support associative arrays or modern bash syntax. Plus FREE automated macOS testing on Intel and Apple Silicon Macs!
 
 **Key highlights:**
-- 🚀 **Automatic Piper Installation** - Auto-detects missing Piper binary and prompts to install it during setup
-- ⚡ **One-Command Setup** - Runs `.claude/hooks/piper-installer.sh` seamlessly with human approval
-- 🎯 **Fully Unattended Mode** - Support for `--yes` flag for automated installation
-- 🔧 **CI Workflow Cleanup** - Removed deprecated v1 branch references, tests now run on master only
-- ✅ **110 Tests Passing** - Comprehensive test coverage with optimized GitHub Actions workflow
+- 🍎 **macOS Now Supported** - Fixed all 23 shell scripts to work with Homebrew bash 5.x
+- 🔧 **Voice Switching Works** - No more syntax errors on Mac
+- 🤖 **FREE macOS Testing** - GitHub Actions tests on macOS 13/14/15 (Intel + M1/M2/M3)
+- 🚀 **Automated CI** - 13 parallel test jobs on every commit
+- ✅ **All Features Work** - Personalities, providers, speed control now functional on Mac
 
 [→ View Full Release Notes](RELEASE_NOTES.md) | [→ View All Releases](https://github.com/paulpreibisch/AgentVibes/releases)
 
@@ -136,6 +137,17 @@ Just say "Switch to Aria voice" or "Speak in Spanish" instead of typing commands
 
 ## 🚀 Quick Start
 
+### 🍎 macOS Users - Read This First!
+
+**REQUIRED:** Install bash 5.x before using AgentVibes:
+```bash
+brew install bash  # One-time setup
+```
+
+macOS ships with bash 3.2 (from 2007) which lacks modern bash features AgentVibes needs. After installing bash 5.x via Homebrew, everything works perfectly!
+
+---
+
 Get AgentVibes running in 3 steps: **Install** → **Choose Provider** (Piper/ElevenLabs) → **Enable Voice**
 
 **[→ View Complete Quick Start Guide](docs/quick-start.md)** - Full installation options, provider setup, and activation steps
@@ -224,6 +236,8 @@ AgentVibes includes **27 unique ElevenLabs voices** with multilingual support.
 
 The BMAD plugin detects when you activate a BMAD agent (e.g., `/BMad:agents:pm`) and automatically uses the assigned voice for that role.
 
+**Version Support**: AgentVibes supports both BMAD v4 and v6-alpha installations. Version detection is automatic - just install BMAD and AgentVibes will detect and configure itself correctly!
+
 **[→ View Complete BMAD Documentation](docs/bmad-plugin.md)** - All agent mappings, language support, plugin management, and customization
 
 [↑ Back to top](#-table-of-contents)