agentvibes 2.2.0 → 2.2.2

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

@@ -1 +1 @@
-20251102
+20251103

package/.mcp-minimal.json

@@ -71,6 +71,33 @@
      "env": {
       "ELEVENLABS_API_KEY": "${ELEVENLABS_API_KEY}"
      }
+    },
+    "sonarqube": {
+      "command": "docker",
+      "args": [
+        "run",
+        "-i",
+        "--name",
+        "sonarqube-mcp-server-agentvibes",
+        "--rm",
+        "-e",
+        "SONARQUBE_TOKEN=${SONARQUBE_TOKEN}",
+        "-e",
+        "SONARQUBE_URL=https://sonarcloud.io",
+        "-e",
+        "SONARQUBE_ORG=${SONARQUBE_ORG}",
+        "-e",
+        "SONARQUBE_PROJECT=${SONARQUBE_PROJECT}",
+        "-v",
+        "/home/fire/claude/AgentVibes/.sonarqube-storage:/storage",
+        "mcp/sonarqube"
+      ],
+      "env": {
+        "SONARQUBE_TOKEN": "${SONARQUBE_TOKEN}",
+        "SONARQUBE_URL": "https://sonarcloud.io",
+        "SONARQUBE_ORG": "${SONARQUBE_ORG}",
+        "SONARQUBE_PROJECT": "${SONARQUBE_PROJECT}"
+      }
     }
   }
 }

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.5
+**Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v2.2.1
 
 ---
 
@@ -92,18 +92,18 @@ Whether you're coding in Claude Code, chatting in Claude Desktop, or using Warp
 
 ## 📰 Latest Release
 
-**[v2.1.5 - Critical macOS Compatibility Fix + GitHub Actions Testing](https://github.com/paulpreibisch/AgentVibes/releases/tag/v2.1.5)** 🍎
+**[v2.2.0 - Provider-Aware Features, BMAD v6 Support & MCP Improvements](https://github.com/paulpreibisch/AgentVibes/releases/tag/v2.2.1)** 🎉
 
-**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!
+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.
 
 **Key highlights:**
-- 🍎 **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
+- 🎯 **Provider-Aware Voice Switching** - Automatically detects and uses the correct provider (ElevenLabs or Piper)
+- 🤖 **BMAD v6 Support** - Full backward compatibility with v4, with improved agent voice mappings
+- 🔧 **MCP NPX Fix** - Corrected NPX configuration for seamless MCP server setup
+- ✨ **Improved Installer UX** - Cleaner prompts and better visual formatting
+- 🎭 **Better Voice Mappings** - Provider-aware BMAD agent voices (PM: Ryan, Analyst: Kristin)
 
-[→ View Full Release Notes](RELEASE_NOTES.md) | [→ View All Releases](https://github.com/paulpreibisch/AgentVibes/releases)
+[→ View All Releases](https://github.com/paulpreibisch/AgentVibes/releases)
 
 [↑ Back to top](#-table-of-contents)
 

package/RELEASE_NOTES.md

@@ -0,0 +1,106 @@
+# AgentVibes Release Notes
+
+## 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
+
+#### ✨ 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
+
+#### 📚 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.
+
+### 📦 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
+
+---
+
+## v2.2.0 - Provider-Aware Features, BMAD v6 Support & MCP Improvements (2025-11-02)
+
+### 🤖 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.
+
+### 📋 Changes
+
+#### ✨ New Features
+- **Provider-Aware Voice Switching**: Automatically detects whether you're using ElevenLabs or Piper TTS
+- **BMAD v6 Support**: Full support for BMAD-METHOD v6-alpha with backward compatibility to v4
+- **Improved Voice Mappings**: Provider-aware BMAD agent voices (PM: Ryan on Piper, Analyst: Kristin)
+- **SessionStart Hook Support**: Reorganized repository structure for better hook integration
+
+#### 🔧 Fixes
+- **MCP NPX Configuration**: Corrected NPX command configuration for seamless MCP server setup
+- **Voice Manager**: Made `/agent-vibes:switch` and `voice-manager.sh` provider-aware
+- **Installer Prompts**: Removed redundant BMAD enable messages and duplicate pause prompts
+- **JSON Formatting**: Removed color codes from MCP JSON output for clean copy-paste
+
+#### 📚 Documentation
+- Added prominent macOS bash 5.x requirement to README
+- Updated documentation to remove deprecated output-style references
+- Improved BMAD v6 TTS support documentation
+
+### 🎯 User Impact
+
+**Provider Awareness**: AgentVibes now intelligently works with both ElevenLabs and Piper TTS providers without manual configuration. Voice switching commands automatically use the correct provider's voice list.
+
+**BMAD Integration**: If you're using BMAD-METHOD (v4 or v6), AgentVibes will automatically assign appropriate voices to each agent based on your TTS provider, with full backward compatibility.
+
+**MCP Setup**: The corrected NPX configuration means MCP server setup is now seamless with the command: `npx -y --package=agentvibes agentvibes-mcp-server`
+
+### 📦 Commits Since v2.1.5
+```
+01f5283 docs: Update README version to v2.2.0
+ca47e74 chore: Release v2.2.0
+8b6cae9 Merge v6-alpha: Provider-aware features, BMAD improvements, MCP NPX fix
+a9c5439 fix: Correct MCP server NPX configuration
+9965372 chore: Bump version to 2.2.0-beta.9
+3d2c9da feat: Set BMAD analyst voice to Kristin (Piper)
+0241dc0 feat: Make BMAD voice mappings provider-aware
+bfd887d feat: Change BMAD Project Manager voice to Ryan (Piper)
+34ae021 chore: Bump version to 2.2.0-beta.8
+041c475 fix: Make /agent-vibes:switch and voice-manager.sh provider-aware
+eb0b3ec fix: Remove color codes from MCP JSON for clean copy-paste
+0ae1c4d fix: Remove redundant BMAD enable message and simplify prompts
+cf6e1cd fix: Remove duplicate 'recent changes' pause in installer
+d01de85 docs: Remove deprecated output-style references
+ffa1696 feat: Add BMAD v6 TTS support and improve installer UX
+24d77f3 chore: Bump version to 2.2.0-beta.2
+18ce2d3 refactor: Reorganize repository structure and add SessionStart hook support
+8dec688 chore: Bump version to 2.2.0-beta.1 for beta release
+ccad898 feat: Add BMAD-METHOD v6-alpha support with backward compatibility
+```
+
+---
+
+## Previous Releases
+
+For release notes prior to v2.2.0, please see the [GitHub Releases page](https://github.com/paulpreibisch/AgentVibes/releases).

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "agentvibes",
-  "version": "2.2.0",
+  "version": "2.2.2",
   "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/sonar

@@ -0,0 +1,141 @@
+#!/usr/bin/env bash
+#
+# SonarQube Analysis Wrapper Script
+# Run SonarCloud analysis on the AgentVibes project
+#
+
+set -euo pipefail
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+NC='\033[0m' # No Color
+
+# Configuration
+PROJECT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+STORAGE_DIR="$PROJECT_DIR/.sonarqube-storage"
+CONTAINER_NAME="sonarqube-mcp-server-agentvibes"
+IMAGE_NAME="mcp/sonarqube"
+
+# Check required environment variables
+check_env_vars() {
+    local missing=0
+
+    # Use AgentVibes-prefixed environment variables
+    if [[ -z "${AGENTVIBES_SONARQUBE_TOKEN:-}" ]]; then
+        echo -e "${RED}❌ AGENTVIBES_SONARQUBE_TOKEN is not set${NC}"
+        missing=1
+    fi
+
+    if [[ -z "${AGENTVIBES_SONARQUBE_ORG:-}" ]]; then
+        echo -e "${RED}❌ AGENTVIBES_SONARQUBE_ORG is not set${NC}"
+        missing=1
+    fi
+
+    if [[ -z "${AGENTVIBES_SONARQUBE_PROJECT:-}" ]]; then
+        echo -e "${RED}❌ AGENTVIBES_SONARQUBE_PROJECT is not set${NC}"
+        missing=1
+    fi
+
+    if [[ $missing -eq 1 ]]; then
+        echo -e "\n${YELLOW}💡 Set these environment variables in ~/.zshrc:${NC}"
+        echo "   export AGENTVIBES_SONARQUBE_TOKEN='your-token'"
+        echo "   export AGENTVIBES_SONARQUBE_ORG='paulpreibisch'"
+        echo "   export AGENTVIBES_SONARQUBE_PROJECT='AgentVibes'"
+        echo -e "\n${YELLOW}Then reload: source ~/.zshrc${NC}"
+        exit 1
+    fi
+
+    # Set standard variable names for Docker container
+    export SONARQUBE_TOKEN="${AGENTVIBES_SONARQUBE_TOKEN}"
+    export SONARQUBE_ORG="${AGENTVIBES_SONARQUBE_ORG}"
+    export SONARQUBE_PROJECT="${AGENTVIBES_SONARQUBE_PROJECT}"
+}
+
+# Check if Docker is available
+check_docker() {
+    if ! command -v docker &> /dev/null; then
+        echo -e "${RED}❌ Docker is not available${NC}"
+        echo -e "${YELLOW}💡 Please start Docker Desktop or enable Docker in WSL2${NC}"
+        exit 1
+    fi
+
+    if ! docker info &> /dev/null; then
+        echo -e "${RED}❌ Docker daemon is not running${NC}"
+        echo -e "${YELLOW}💡 Please start Docker Desktop${NC}"
+        exit 1
+    fi
+}
+
+# Create storage directory if it doesn't exist
+setup_storage() {
+    if [[ ! -d "$STORAGE_DIR" ]]; then
+        echo -e "${CYAN}📁 Creating storage directory...${NC}"
+        mkdir -p "$STORAGE_DIR"
+    fi
+}
+
+# Pull the latest image if needed
+pull_image() {
+    if ! docker images | grep -q "mcp/sonarqube"; then
+        echo -e "${CYAN}📦 Pulling SonarQube MCP image...${NC}"
+        docker pull "$IMAGE_NAME" || {
+            echo -e "${RED}❌ Failed to pull image${NC}"
+            echo -e "${YELLOW}💡 Make sure you have access to the mcp/sonarqube image${NC}"
+            exit 1
+        }
+    fi
+}
+
+# Stop any existing container
+cleanup() {
+    if docker ps -a | grep -q "$CONTAINER_NAME"; then
+        echo -e "${CYAN}🧹 Cleaning up existing container...${NC}"
+        docker rm -f "$CONTAINER_NAME" &> /dev/null || true
+    fi
+}
+
+# Run the analysis
+run_analysis() {
+    echo -e "${GREEN}🚀 Starting SonarCloud analysis...${NC}"
+    echo -e "${CYAN}   Organization: ${SONARQUBE_ORG}${NC}"
+    echo -e "${CYAN}   Project: ${SONARQUBE_PROJECT}${NC}"
+    echo -e "${CYAN}   URL: https://sonarcloud.io${NC}"
+    echo ""
+
+    docker run -i \
+        --name "$CONTAINER_NAME" \
+        --rm \
+        -e "SONARQUBE_TOKEN=${SONARQUBE_TOKEN}" \
+        -e "SONARQUBE_URL=https://sonarcloud.io" \
+        -e "SONARQUBE_ORG=${SONARQUBE_ORG}" \
+        -e "SONARQUBE_PROJECT=${SONARQUBE_PROJECT}" \
+        -v "${STORAGE_DIR}:/storage" \
+        "$IMAGE_NAME" "$@"
+}
+
+# Main execution
+main() {
+    echo -e "${CYAN}═══════════════════════════════════════════${NC}"
+    echo -e "${CYAN}   SonarQube Analysis - AgentVibes${NC}"
+    echo -e "${CYAN}═══════════════════════════════════════════${NC}"
+    echo ""
+
+    check_env_vars
+    check_docker
+    setup_storage
+    pull_image
+    cleanup
+    run_analysis "$@"
+
+    echo ""
+    echo -e "${GREEN}✅ Analysis complete!${NC}"
+    echo -e "${CYAN}🔗 View results: https://sonarcloud.io/project/overview?id=${SONARQUBE_PROJECT}${NC}"
+}
+
+# Handle Ctrl+C gracefully
+trap cleanup EXIT
+
+main "$@"

package/src/installer.js

@@ -925,15 +925,31 @@ async function install(options = {}) {
         chalk.gray('   "Switch to Aria voice" instead of /agent-vibes:switch "Aria"\n') +
         chalk.gray('   "Set personality to sarcastic" instead of /agent-vibes:personality sarcastic\n\n') +
         chalk.cyan('📋 Claude Code MCP Configuration:\n\n') +
-        chalk.white('Add this to your ') + chalk.cyan('~/.claude/mcp.json') + chalk.white(':\n\n') +
-        '{\n' +
-        '  "mcpServers": {\n' +
-        '    "agentvibes": {\n' +
-        '      "command": "npx",\n' +
-        '      "args": ["-y", "--package=agentvibes", "agentvibes-mcp-server"]\n' +
-        '    }\n' +
-        '  }\n' +
-        '}\n\n' +
+        chalk.white('Add this to your ') + chalk.cyan('~/.claude/mcp.json') + chalk.white(':'),
+        {
+          padding: 1,
+          margin: 1,
+          borderStyle: 'round',
+          borderColor: 'cyan',
+        }
+      )
+    );
+
+    // Display JSON config without border
+    console.log(
+      '\n{\n' +
+      '  "mcpServers": {\n' +
+      '    "agentvibes": {\n' +
+      '      "command": "npx",\n' +
+      '      "args": ["-y", "--package=agentvibes", "agentvibes-mcp-server"]\n' +
+      '    }\n' +
+      '  }\n' +
+      '}\n'
+    );
+
+    // Bottom section with border
+    console.log(
+      boxen(
         chalk.cyan('📱 Claude Desktop / Warp Terminal:\n') +
         chalk.white('   npx agentvibes setup-mcp-for-claude-desktop\n\n') +
         chalk.cyan('📖 Full Guide:\n') +