agentvibes 2.12.1 → 2.12.3

package/.mcp.json

@@ -0,0 +1,88 @@
+{
+  "mcpServers": {
+    "sentry": {
+      "command": "npx",
+      "args": [
+        "@sentry/mcp-server@latest",
+        "--host=sentry.io"
+      ],
+      "env": {
+        "SENTRY_ACCESS_TOKEN": "${SENTRY_ACCESS_TOKEN}",
+        "OPENAI_API_KEY": "${OPENAI_API_KEY}"
+      }
+    },
+     "whatsapp": {
+      "command": "/home/fire/.local/bin/uv",
+      "args": [
+        "--directory",
+        "/home/fire/claude/whatsapp-mcp/whatsapp-mcp-server",
+        "run",
+        "main.py"
+      ]
+    },
+     "chrome-devtools": {
+      "command": "/home/fire/.nvm/versions/node/v22.20.0/bin/npx",
+      "args": [
+        "chrome-devtools-mcp@latest",
+        "--browserUrl=http://localhost:9222"
+      ],
+      "env": {
+        "PATH": "/home/fire/.nvm/versions/node/v22.20.0/bin:${PATH}",
+        "NODE_PATH": "/home/fire/.nvm/versions/node/v22.20.0/lib/node_modules"
+      }
+    },
+    "obsidian": {
+      "command": "/home/fire/.local/bin/uv",
+      "args": [
+        "--directory",
+        "/home/fire/claude/mcp_obsidian",
+        "run",
+        "mcp-obsidian"
+      ],
+      "env": {
+        "OBSIDIAN_API_KEY": "${MAIN_VAULT_OBSIDIAN_KEY}",
+        "OBSIDIAN_HOST": "${OBSIDIAN_HOST:-127.0.0.1}",
+        "OBSIDIAN_PORT": "27124",
+        "OBSIDIAN_HTTPS": "true",
+        "OBSIDIAN_VERIFY_SSL": "false"
+      }
+    },
+    "elevenlabs": {
+      "command": "npx",
+      "args": ["@microagents/mcp-server-elevenlabs"],
+      "env": {
+        "ELEVENLABS_API_KEY": "${ELEVENLABS_API_KEY}",
+        "ELEVENLABS_MCP_BASE_PATH": "/home/fire/claude/SoraSage/teams/team-10/dev__globify__production/.claude/audio"
+      }
+    },
+    "spaceship": {
+      "command": "node",
+      "args": [
+        "/home/fire/claude/spaceship-mcp/dist/index.js"
+      ],
+      "env": {
+        "SPACESHIP_API_KEY": "${SPACESHIP_API_KEY}",
+        "SPACESHIP_API_SECRET": "${SPACESHIP_API_SECRET}"
+      }
+    },
+    "sonarqube": {
+      "command": "docker",
+      "args": [
+        "run",
+        "-i",
+        "--name",
+        "sonarqube-mcp-server-agentvibes",
+        "--rm",
+        "-e",
+        "SONARQUBE_TOKEN",
+        "-e",
+        "SONARQUBE_ORG",
+        "mcp/sonarqube"
+      ],
+      "env": {
+        "SONARQUBE_TOKEN": "${AGENTVIBES_SONARQUBE_TOKEN}",
+        "SONARQUBE_ORG": "${AGENTVIBES_SONARQUBE_ORG}"
+      }
+    }
+  }
+}

package/BMAD_PR_TESTING_INSTRUCTIONS.md

@@ -136,7 +136,7 @@ npx agentvibes@latest install
 
 ```bash
 # Start Claude Code session
-claude-code
+claude
 
 # Run party mode
 /bmad:core:workflows:party-mode

package/RELEASE_NOTES_v2.4.0_DRAFT.md

@@ -0,0 +1,116 @@
+# 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)
+
+### 🐛 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
+
+### 📚 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
+
+## 🎯 User Impact
+
+**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).
+
+**For All Users**: The updated documentation now correctly reflects that Piper TTS works on **ALL platforms**: Windows, macOS, Linux, and WSL.
+
+**Installation is Simple**:
+```bash
+# Run AgentVibes installer
+npx agentvibes install --yes
+
+# Or directly run Piper installer
+.claude/hooks/piper-installer.sh
+
+# Add to PATH (if needed)
+echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
+source ~/.zshrc
+```
+
+**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(-)
+
+## 🔄 Breaking Changes
+
+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
+```
+
+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

package/RELEASE_NOTES_v2.4.1_DRAFT.md

@@ -0,0 +1,61 @@
+# Release v2.4.1 - macOS Audio Playback Fix (2025-01-15)
+
+## 🤖 AI Summary
+
+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.
+
+## 📋 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
+
+## 🎯 User Impact
+
+**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.
+
+**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.
+
+**What's Fixed**: The script now detects macOS and uses the native `afplay` command for audio playback.
+
+## 📦 Files Changed
+
+### Modified
+- `.claude/hooks/play-tts-piper.sh` - Added macOS platform detection for audio playback
+
+### Statistics
+- 1 file changed
+- 10 insertions(+)
+- 2 deletions(-)
+
+## 🔄 Breaking Changes
+
+None. This is a pure bug fix release.
+
+## 🚀 Upgrade Notes
+
+Simply run:
+```bash
+npx agentvibes@latest install --yes
+```
+
+This will update the hooks with the fixed audio playback script.
+
+## 🙏 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

package/docs/macos-piper-issue.md

@@ -0,0 +1,172 @@
+# macOS Piper TTS Installation Issue
+
+## Problem
+
+User `BMadCode` on macOS reported installation failure when trying to use Piper TTS:
+
+### Error 1: Installer blocks macOS
+```bash
+➜ .claude/hooks/piper-installer.sh
+🎤 Piper TTS Installer
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+❌ Piper TTS is only supported on WSL and Linux
+   Your platform: Darwin
+
+   For macOS/Windows, use ElevenLabs instead:
+   /agent-vibes:provider switch elevenlabs
+```
+
+### Error 2: Direct pipx installation fails
+```bash
+➜ pipx install piper-tts
+
+Fatal error from pip prevented installation. Full pip output in file:
+    /Users/brianmadison/.local/pipx/logs/cmd_2025-11-15_09.14.02_pip_errors.log
+
+pip seemed to fail to build package:
+    piper-tts
+
+Some possibly relevant errors from pip install:
+    ERROR: Cannot install piper-tts==1.1.0, piper-tts==1.2.0 and piper-tts==1.3.0 because these package versions have conflicting dependencies.
+    ERROR: ResolutionImpossible: for help visit https://pip.pypa.io/en/latest/topics/dependency-resolution/#dealing-with-dependency-conflicts
+```
+
+## Root Cause Analysis
+
+### Documentation Inconsistency
+**File: `docs/providers.md`** (lines 32 and 90) claims:
+- "Cross-platform support (Windows, macOS, Linux)"
+- Platform Support: "Windows, macOS, Linux, WSL"
+
+**File: `.claude/hooks/piper-installer.sh`** (lines 50-56) explicitly blocks macOS:
+```bash
+# Check if running on WSL or Linux
+if ! grep -qi microsoft /proc/version 2>/dev/null && [[ "$(uname -s)" != "Linux" ]]; then
+  echo "❌ Piper TTS is only supported on WSL and Linux"
+  echo "   Your platform: $(uname -s)"
+  exit 1
+fi
+```
+
+### Why Piper Installation Fails on macOS
+
+1. **piper-tts PyPI package has dependency conflicts** - The `piper-tts` package on PyPI (versions 1.1.0-1.3.0) has unresolved dependency conflicts that prevent installation on macOS
+
+2. **Installer intentionally blocks macOS** - The script checks for Linux/WSL and rejects Darwin (macOS)
+
+3. **README says bash 5.x required** - README.md (lines 140-146) states macOS users need to install bash 5.x via Homebrew, but this is for AgentVibes hooks, not Piper itself
+
+## Solutions
+
+### Recommended Solution: Use ElevenLabs on macOS
+The installer's guidance is correct - macOS users should use **ElevenLabs** instead of Piper TTS:
+
+```bash
+# Switch to ElevenLabs provider
+/agent-vibes:provider switch elevenlabs
+
+# Set your API key
+export ELEVENLABS_API_KEY="your_key_here"
+```
+
+**Why?**
+- ✅ Works perfectly on macOS
+- ✅ No dependency conflicts
+- ✅ 150+ professional voices
+- ✅ Free tier: 10,000 chars/month
+- ✅ Get API key at https://elevenlabs.io
+
+### Alternative: Piper Binary (If Available)
+If Piper precompiled binaries for macOS exist, users could:
+1. Download macOS Piper binary
+2. Install manually to PATH
+3. Skip the Python/pipx installation
+
+**Note:** This requires Piper project to provide macOS binaries.
+
+## Proposed Fixes
+
+### Fix 1: Update Documentation (Priority: HIGH)
+Update `docs/providers.md` to reflect accurate platform support:
+
+**Current (incorrect):**
+```markdown
+| **Platform Support** | All platforms | Windows, macOS, Linux, WSL |
+```
+
+**Should be:**
+```markdown
+| **Platform Support** | All platforms | Windows, Linux, WSL |
+```
+
+**And add note:**
+```markdown
+**Note:** Piper TTS is not currently supported on macOS due to Python dependency conflicts.
+macOS users should use ElevenLabs instead.
+```
+
+### Fix 2: Update Troubleshooting Guide (Priority: MEDIUM)
+Add to `docs/troubleshooting.md`:
+
+```markdown
+## Piper TTS Installation Fails on macOS
+
+**Symptom:** `pipx install piper-tts` fails with dependency conflicts
+
+**Solution:** macOS is not currently supported for Piper TTS. Use ElevenLabs instead:
+
+1. Switch provider: `/agent-vibes:provider switch elevenlabs`
+2. Get API key: https://elevenlabs.io (free tier available)
+3. Set key: `export ELEVENLABS_API_KEY="your_key"`
+4. Test: `/agent-vibes:sample Aria`
+```
+
+### Fix 3: Improve Installer Error Message (Priority: LOW)
+Update `.claude/hooks/piper-installer.sh` error message to be more helpful:
+
+**Current:**
+```bash
+echo "❌ Piper TTS is only supported on WSL and Linux"
+echo "   Your platform: $(uname -s)"
+echo ""
+echo "   For macOS/Windows, use ElevenLabs instead:"
+echo "   /agent-vibes:provider switch elevenlabs"
+```
+
+**Improved:**
+```bash
+echo "❌ Piper TTS is not supported on macOS"
+echo "   Your platform: $(uname -s)"
+echo ""
+echo "   🎤 Recommended: Use ElevenLabs (150+ voices, free tier available)"
+echo "   1. Get API key: https://elevenlabs.io"
+echo "   2. Set key: export ELEVENLABS_API_KEY=\"your_key\""
+echo "   3. Switch provider: /agent-vibes:provider switch elevenlabs"
+echo ""
+echo "   Free tier: 10,000 chars/month"
+```
+
+## Testing Checklist
+
+- [ ] Update `docs/providers.md` platform support table
+- [ ] Add macOS note to Piper TTS section in `docs/providers.md`
+- [ ] Add macOS troubleshooting entry to `docs/troubleshooting.md`
+- [ ] Improve error message in `.claude/hooks/piper-installer.sh`
+- [ ] Verify ElevenLabs works correctly on macOS
+- [ ] Update README.md if needed
+- [ ] Test installer on macOS to confirm helpful error messages
+
+## References
+
+- User report: BMadCode via Discord/Slack (2025-11-15)
+- Piper TTS GitHub: https://github.com/rhasspy/piper
+- ElevenLabs: https://elevenlabs.io
+- Related: README.md bash 5.x requirement (lines 140-146)
+
+## Labels
+- `bug` - Documentation bug
+- `macos` - Platform-specific issue
+- `piper-tts` - Provider-specific
+- `documentation` - Needs doc updates
+- `good first issue` - Clear, well-defined fix