agentvibes 2.17.0 → 2.17.2

package/.claude/commands/release.md

@@ -264,10 +264,13 @@ When executing this command, Claude MUST follow these steps in order:
    - Replace the "WHAT'S NEW" summary (2-4 sentences from RELEASE_NOTES.md AI Summary)
    - Replace all "KEY HIGHLIGHTS" bullets (extract from RELEASE_NOTES.md)
    - Keep the same format/structure, just update content
-6. **Update README.md**:
-   - Update version badge in header (line ~14)
-   - Update "Latest Release" section (line ~95+) with new title and summary
-   - Update key highlights list
+6. **Update README.md** ⚠️ **CRITICAL - Must complete BEFORE npm publish**:
+   - Update version badge in header (line ~14): `**Version**: v2.X.X`
+   - Update "Latest Release" section (line ~112+):
+     - Replace the title and URL: `**[vX.X.X - Release Title](github.com/...)**`
+     - Replace the AI summary paragraph (first paragraph after title)
+     - Replace all "Key Highlights" bullet points (extract from RELEASE_NOTES.md)
+   - This ensures GitHub README and npm package page show correct version
 7. **Human Review Checkpoint 2**: Show what will be updated, wait for approval
 8. **Bump package.json**: Use npm version (patch/minor/major)
 9. **Commit all changes**: Single commit with RELEASE_NOTES.md, installer.js, README.md, package.json

package/.claude/config/audio-effects.cfg

@@ -49,4 +49,4 @@ BMad Master|reverb 50 60 100 pitch -100|agentvibes_soft_flamenco_loop.mp3|0.30
 _party_mode|compand 0.3,1 6:-70,-60,-20|agent_vibes_dark_chill_step_loop.mp3|0.40
 
 # Default (no agent specified) - clean with subtle enhancement and chillwave background
-default|gain -8|agent_vibes_chillwave_v2_loop.mp3|0.30
+default||agentvibes_soft_flamenco_loop.mp3|0.30

package/.claude/config/audio-effects.cfg.sample

@@ -49,4 +49,4 @@ BMad Master|reverb 50 60 100 pitch -100|agentvibes_soft_flamenco_loop.mp3|0.30
 _party_mode|compand 0.3,1 6:-70,-60,-20|agent_vibes_dark_chill_step_loop.mp3|0.40
 
 # Default (no agent specified) - clean with subtle enhancement and chillwave background
-default|gain -8|agentvibes_soft_flamenco_loop.mp3|0.30
+default||agentvibes_soft_flamenco_loop.mp3|0.30

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

@@ -140,8 +140,8 @@ fi
 # @why Provide seamless experience with automatic downloads
 # @param Uses global: $VOICE_MODEL
 # @sideeffects Downloads voice model files
-# @edgecases Prompts user for consent before downloading
-if ! verify_voice "$VOICE_MODEL"; then
+# @edgecases Prompts user for consent before downloading, skipped in test mode
+if [[ "${AGENTVIBES_TEST_MODE:-false}" != "true" ]] && ! verify_voice "$VOICE_MODEL"; then
   echo "📥 Voice model not found: $VOICE_MODEL"
   echo "   File size: ~25MB"
   echo "   Preview: https://huggingface.co/rhasspy/piper-voices"
@@ -162,10 +162,15 @@ if ! verify_voice "$VOICE_MODEL"; then
 fi
 
 # Get voice model path
-VOICE_PATH=$(get_voice_path "$VOICE_MODEL")
-if [[ $? -ne 0 ]]; then
-  echo "❌ Voice model path not found: $VOICE_MODEL"
-  exit 3
+# In test mode, use a fake path since we have mock piper that doesn't need real files
+if [[ "${AGENTVIBES_TEST_MODE:-false}" == "true" ]]; then
+  VOICE_PATH="/tmp/mock-voice-${VOICE_MODEL}.onnx"
+else
+  VOICE_PATH=$(get_voice_path "$VOICE_MODEL")
+  if [[ $? -ne 0 ]]; then
+    echo "❌ Voice model path not found: $VOICE_MODEL"
+    exit 3
+  fi
 fi
 
 # @function determine_audio_directory

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

@@ -312,7 +312,8 @@ case "$1" in
         fi
       fi
 
-      if [[ -z "$FOUND" ]]; then
+      # In test mode, allow switching to any voice name without file validation
+      if [[ -z "$FOUND" ]] && [[ "${AGENTVIBES_TEST_MODE:-false}" != "true" ]]; then
         echo "❌ Piper voice not found: $VOICE_NAME"
         echo ""
         echo "Available Piper voices:"
@@ -347,15 +348,17 @@ case "$1" in
       exit 1
     fi
 
-    echo "$FOUND" > "$VOICE_FILE"
-    echo "✅ Voice switched to: $FOUND"
+    # In test mode, use the requested voice name even if not found
+    VOICE_TO_SAVE="${FOUND:-$VOICE_NAME}"
+    echo "$VOICE_TO_SAVE" > "$VOICE_FILE"
+    echo "✅ Voice switched to: $VOICE_TO_SAVE"
 
     # Have the new voice introduce itself (unless silent mode)
-    if [[ "$SILENT_MODE" != "true" ]]; then
+    if [[ "$SILENT_MODE" != "true" ]] && [[ "${AGENTVIBES_TEST_MODE:-false}" != "true" ]]; then
       SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
       PLAY_TTS="$SCRIPT_DIR/play-tts.sh"
       if [ -x "$PLAY_TTS" ]; then
-        "$PLAY_TTS" "Hi, I'm $FOUND. I'll be your voice assistant moving forward." "$FOUND" > /dev/null 2>&1 &
+        "$PLAY_TTS" "Hi, I'm $VOICE_TO_SAVE. I'll be your voice assistant moving forward." "$VOICE_TO_SAVE" > /dev/null 2>&1 &
       fi
 
       echo ""

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.17.0
+**Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v2.17.2
 
 ---
 
@@ -111,17 +111,17 @@ All 50+ Piper voices AgentVibes provides are sourced from Hugging Face's open-so
 
 ## 📰 Latest Release
 
-**[v2.16.1 - Test Suite & Audio Quality](https://github.com/paulpreibisch/AgentVibes/releases/tag/v2.17.0)** 🎉
+**[v2.17.0 - Installer UX Revolution](https://github.com/paulpreibisch/AgentVibes/releases/tag/v2.17.2)** 🎉
 
-AgentVibes v2.16.1 achieves 100% test pass rate (140/140 tests), fixes audio clipping issues, and completes ElevenLabs removal. Production-ready quality with comprehensive system requirements documentation.
+AgentVibes v2.17.0 delivers a complete installer user experience transformation with intelligent system dependency checking, paginated configuration flow, and comprehensive inline help.
 
 **Key Highlights:**
-- ✅ **100% Test Pass Rate** - All 140 unit tests passing (12 critical fixes)
-- 🎚️ **Audio Quality Fix** - Eliminated clipping with -8 dB gain (removed compressor)
-- 🧹 **ElevenLabs Cleanup** - Complete removal from all tests, hooks, and MCP server
-- 📦 **Config Management** - Template pattern: .cfg.sample (tracked) + .cfg (gitignored)
-- 📖 **System Requirements** - Comprehensive docs for macOS, Linux, Windows WSL
-- 🔧 **Provider Updates** - MCP server now uses piper/macos validation only
+- 🔧 **System Dependency Checker** - Validates Node, Python, bash, sox, ffmpeg, curl, etc.
+- 📄 **Paginated Configuration** - Beautiful headers with Agent Vibes branding on every page
+- 💡 **Inline Help & Commands** - TTS explanations and examples throughout installer
+- 🎵 **New Music Track** - Salsa v2 background music now available
+- 🎨 **Professional UI** - Consistent sunshine yellow styling and dynamic page numbering
+- ✅ **Quality Assurance** - 140 tests passing, SonarCloud integration
 
 💡 **Tip:** If `npx agentvibes` shows an older version or missing commands, clear your npm cache: `npm cache clean --force && npx agentvibes@latest --help`
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "agentvibes",
-  "version": "2.17.0",
+  "version": "2.17.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": [
@@ -34,7 +34,14 @@
   "files": [
     "bin/",
     "src/",
-    "mcp-server/",
+    "mcp-server/*.py",
+    "mcp-server/*.js",
+    "mcp-server/*.md",
+    "mcp-server/*.txt",
+    "mcp-server/*.toml",
+    "mcp-server/*.json",
+    "mcp-server/docs/",
+    "mcp-server/examples/",
     ".claude/commands/",
     ".claude/hooks/",
     ".claude/personalities/",

package/src/cli/list-voices.js

@@ -46,7 +46,7 @@ function getMacOSVoices(currentVoice) {
   }
 
   try {
-    const output = execFileSync('say', ['-v', '?'], { encoding: 'utf8' });
+    const output = execFileSync('say', ['-v', '?'], { encoding: 'utf8' }); // NOSONAR - Safe: checking macOS say voices from system PATH
     const lines = output.split('\n');
 
     for (const line of lines) {

package/src/installer.js

@@ -721,15 +721,15 @@ async function playWelcomeDemo(targetDir, spinner, options = {}) {
   let audioPlayer = null;
 
   try {
-    execSync('which paplay 2>/dev/null', { stdio: 'pipe' });
+    execSync('which paplay 2>/dev/null', { stdio: 'pipe' }); // NOSONAR - Safe: checking system PATH for audio player
     audioPlayer = 'paplay';
   } catch {
     try {
-      execSync('which afplay 2>/dev/null', { stdio: 'pipe' });
+      execSync('which afplay 2>/dev/null', { stdio: 'pipe' }); // NOSONAR - Safe: checking system PATH for audio player
       audioPlayer = 'afplay';
     } catch {
       try {
-        execSync('which mpv 2>/dev/null', { stdio: 'pipe' });
+        execSync('which mpv 2>/dev/null', { stdio: 'pipe' }); // NOSONAR - Safe: checking system PATH for audio player
         audioPlayer = 'mpv';
       } catch {}
     }
@@ -2893,12 +2893,16 @@ async function install(options = {}) {
     // Apply reverb setting if not "off" (using dynamic import for ES modules)
     if (selectedReverb && selectedReverb !== 'off') {
       const effectsManagerPath = path.join(targetDir, '.claude', 'hooks', 'effects-manager.sh');
-      try {
-        execSync(`bash "${effectsManagerPath}" set-reverb ${selectedReverb} default`, {
-          stdio: 'pipe',
-        });
-      } catch (error) {
-        // Silent fail - will be shown in success message if needed
+      // Validate reverb value to prevent command injection
+      const validReverb = ['light', 'medium', 'heavy', 'cathedral'];
+      if (validReverb.includes(selectedReverb)) {
+        try {
+          execFileSync('bash', [effectsManagerPath, 'set-reverb', selectedReverb, 'default'], {
+            stdio: 'pipe',
+          });
+        } catch (error) {
+          // Silent fail - will be shown in success message if needed
+        }
       }
     }
 

package/src/utils/dependency-checker.js

@@ -35,7 +35,7 @@ function commandExists(command) {
  */
 function checkBashVersion() {
   try {
-    const version = execFileSync('bash', ['--version'], { encoding: 'utf8' });
+    const version = execFileSync('bash', ['--version'], { encoding: 'utf8' }); // NOSONAR - Safe: checking bash version from system PATH
     const match = version.match(/version (\d+)\.(\d+)/);
     if (match) {
       const major = parseInt(match[1]);