agentvibes 5.6.8 → 5.7.0

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

@@ -1 +1 @@
-20260509
+20260511

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

@@ -0,0 +1,225 @@
+#!/usr/bin/env bash
+#
+# File: .claude/hooks/bmad-party-manager.sh
+#
+# AgentVibes - Finally, your AI Agents can Talk Back! Text-to-Speech WITH personality for AI Assistants!
+# Website: https://agentvibes.org
+# Repository: https://github.com/paulpreibisch/AgentVibes
+#
+# Co-created by Paul Preibisch with Claude AI
+# Copyright (c) 2025 Paul Preibisch
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# DISCLAIMER: This software is provided "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# express or implied, including but not limited to the warranties of
+# merchantability, fitness for a particular purpose and noninfringement.
+# In no event shall the authors or copyright holders be liable for any claim,
+# damages or other liability, whether in an action of contract, tort or
+# otherwise, arising from, out of or in connection with the software or the
+# use or other dealings in the software.
+#
+# ---
+#
+# @fileoverview BMAD Party Mode Voice Integration Manager
+# @context Controls auto-enable/disable of multi-agent voice switching during BMAD party mode
+# @architecture Opt-out flag management, auto-detection, status reporting
+# @dependencies .bmad/_cfg/agent-manifest.csv, bmad-voices-enabled.flag, user-prompt-output.sh
+# @entrypoints /agent-vibes:bmad-party slash command
+# @patterns Auto-enable with opt-out, graceful degradation, feature detection
+# @related user-prompt-output.sh, bmad-voice-manager.sh, Issue #33
+
+# Fix locale warnings
+export LC_ALL=C
+
+PLUGIN_DIR=".claude/plugins"
+DISABLE_FLAG="$PLUGIN_DIR/bmad-party-mode-disabled.flag"
+BMAD_VOICES_FLAG="$PLUGIN_DIR/bmad-voices-enabled.flag"
+BMAD_MANIFEST=".bmad/_cfg/agent-manifest.csv"
+
+# Colors
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+CYAN='\033[0;36m'
+GRAY='\033[0;90m'
+NC='\033[0m' # No Color
+
+#
+# @function is_bmad_installed
+# @context Check if BMAD v6 is installed
+# @returns 0=installed, 1=not installed
+#
+is_bmad_installed() {
+  [[ -f "$BMAD_MANIFEST" ]]
+}
+
+#
+# @function is_bmad_voices_enabled
+# @context Check if BMAD voice plugin is enabled
+# @returns 0=enabled, 1=disabled
+#
+is_bmad_voices_enabled() {
+  [[ -f "$BMAD_VOICES_FLAG" ]]
+}
+
+#
+# @function is_party_mode_enabled
+# @context Check if party mode voice integration is enabled
+# @returns 0=enabled, 1=disabled
+#
+is_party_mode_enabled() {
+  # Disabled if opt-out flag exists
+  [[ -f "$DISABLE_FLAG" ]] && return 1
+
+  # Enabled if BMAD + voice plugin active
+  is_bmad_installed && is_bmad_voices_enabled
+}
+
+#
+# @function show_status
+# @context Display current party mode voice integration status
+#
+show_status() {
+  echo -e "${CYAN}🎭 BMAD Party Mode Voice Integration${NC}"
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo ""
+
+  # Check BMAD installation
+  if ! is_bmad_installed; then
+    echo -e "${RED}❌ BMAD not installed${NC}"
+    echo -e "${GRAY}   Party mode voice integration requires BMAD v6${NC}"
+    echo -e "${GRAY}   Install: https://github.com/bmad-method/bmad${NC}"
+    echo ""
+    return 1
+  fi
+
+  echo -e "${GREEN}✅ BMAD v6 detected${NC}"
+
+  # Check voice plugin
+  if ! is_bmad_voices_enabled; then
+    echo -e "${RED}❌ BMAD voice plugin disabled${NC}"
+    echo -e "${GRAY}   Enable: /agent-vibes:bmad enable${NC}"
+    echo ""
+    return 1
+  fi
+
+  echo -e "${GREEN}✅ BMAD voice plugin enabled${NC}"
+
+  # Check party mode status
+  if is_party_mode_enabled; then
+    echo -e "${GREEN}✅ Party mode voices: ENABLED${NC}"
+    echo ""
+    echo -e "${CYAN}How it works:${NC}"
+    echo "  When you run /bmad:core:workflows:party-mode,"
+    echo "  each agent speaks with their unique voice:"
+    echo ""
+    echo "  🏗️  Winston (Architect) → Michael"
+    echo "  📋 John (PM) → Jessica Anne Bogart"
+    echo "  💻 Amelia (Dev) → Matthew Schmitz"
+    echo "  📊 Mary (Analyst) → kristin"
+    echo "  ... and more!"
+    echo ""
+    echo -e "${GRAY}Disable with: /agent-vibes:bmad-party disable${NC}"
+  else
+    echo -e "${YELLOW}⚠️  Party mode voices: DISABLED (opt-out active)${NC}"
+    echo ""
+    echo -e "${GRAY}Enable with: /agent-vibes:bmad-party enable${NC}"
+  fi
+
+  echo ""
+}
+
+#
+# @function enable_party_mode
+# @context Enable party mode voice integration (remove opt-out flag)
+#
+enable_party_mode() {
+  # Verify prerequisites
+  if ! is_bmad_installed; then
+    echo -e "${RED}❌ Cannot enable: BMAD not installed${NC}"
+    echo -e "${GRAY}   Install BMAD v6 first${NC}"
+    return 1
+  fi
+
+  if ! is_bmad_voices_enabled; then
+    echo -e "${RED}❌ Cannot enable: BMAD voice plugin disabled${NC}"
+    echo -e "${GRAY}   Enable with: /agent-vibes:bmad enable${NC}"
+    return 1
+  fi
+
+  # Remove opt-out flag if it exists
+  if [[ -f "$DISABLE_FLAG" ]]; then
+    rm -f "$DISABLE_FLAG"
+    echo -e "${GREEN}✅ Party mode voices enabled${NC}"
+    echo ""
+    echo -e "${CYAN}🎭 Multi-agent voice switching activated!${NC}"
+    echo "   Run /bmad:core:workflows:party-mode to hear agents speak"
+  else
+    echo -e "${GREEN}✅ Party mode voices already enabled${NC}"
+    echo ""
+    echo -e "${GRAY}(Auto-enabled when BMAD detected)${NC}"
+  fi
+
+  echo ""
+}
+
+#
+# @function disable_party_mode
+# @context Disable party mode voice integration (create opt-out flag)
+#
+disable_party_mode() {
+  mkdir -p "$PLUGIN_DIR"
+
+  if [[ -f "$DISABLE_FLAG" ]]; then
+    echo -e "${YELLOW}⚠️  Party mode voices already disabled${NC}"
+    return 0
+  fi
+
+  # Create opt-out flag
+  touch "$DISABLE_FLAG"
+
+  echo -e "${GREEN}✅ Party mode voices disabled${NC}"
+  echo ""
+  echo -e "${GRAY}Party mode will continue to work, but agents won't speak${NC}"
+  echo -e "${GRAY}Enable again with: /agent-vibes:bmad-party enable${NC}"
+  echo ""
+}
+
+# Main command dispatcher
+case "${1:-status}" in
+  enable)
+    enable_party_mode
+    ;;
+  disable)
+    disable_party_mode
+    ;;
+  status)
+    show_status
+    ;;
+  *)
+    echo -e "${CYAN}AgentVibes BMAD Party Mode Manager${NC}"
+    echo ""
+    echo "Usage: bmad-party-manager.sh {enable|disable|status}"
+    echo ""
+    echo "Commands:"
+    echo "  enable     Enable party mode voice integration"
+    echo "  disable    Disable party mode voice integration (opt-out)"
+    echo "  status     Show current status and configuration"
+    echo ""
+    echo "Party Mode Voice Integration:"
+    echo "  • Auto-enabled when BMAD v6 detected"
+    echo "  • Each agent speaks with unique voice during party mode"
+    echo "  • Opt-out available via disable command"
+    ;;
+esac

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

@@ -49,7 +49,7 @@ GRAY='\033[0;90m'
 NC='\033[0m' # No Color
 
 # Detect BMAD installation and version
-# Supports both v4 (.bmad-core/) and v6-alpha (.bmad/) installations
+# Supports both v4 (.bmad-core/) and v6-alpha (.bmad/, _bmad/) installations
 detect_bmad() {
   local bmad_core_dir=""
 
@@ -58,6 +58,11 @@ detect_bmad() {
     bmad_core_dir=".bmad"
   elif [[ -d "../.bmad" ]]; then
     bmad_core_dir="../.bmad"
+  # Check for _bmad (current BMAD installer default — underscore prefix, project-local)
+  elif [[ -d "_bmad" ]]; then
+    bmad_core_dir="_bmad"
+  elif [[ -d "../_bmad" ]]; then
+    bmad_core_dir="../_bmad"
   # Check for v6-alpha without dot (legacy naming)
   elif [[ -d "bmad" ]]; then
     bmad_core_dir="bmad"
@@ -73,6 +78,11 @@ detect_bmad() {
     bmad_core_dir="bmad-core"
   elif [[ -d "../bmad-core" ]]; then
     bmad_core_dir="../bmad-core"
+  # Check home-dir global BMAD install (~/_bmad is the default for standalone BMAD installs)
+  elif [[ -d "$HOME/_bmad" ]]; then
+    bmad_core_dir="$HOME/_bmad"
+  elif [[ -d "$HOME/.bmad" ]]; then
+    bmad_core_dir="$HOME/.bmad"
   else
     echo -e "${RED}❌ BMAD installation not found${NC}" >&2
     echo -e "${GRAY}   Looked for bmad/, .bmad-core/, or bmad-core/ directory${NC}" >&2
@@ -85,21 +95,34 @@ detect_bmad() {
 # Find all BMAD agents
 find_agents() {
   local bmad_core="$1"
-  local agents_dir=""
+  local found=0
+
+  # v6.6+: agents under .claude/skills/*/agents/ (new BMAD structure)
+  local skills_dir=".claude/skills"
+  if [[ -d "$skills_dir" ]]; then
+    while IFS= read -r -d '' agent_file; do
+      echo "$agent_file"
+      found=1
+    done < <(find "$skills_dir" -path "*/agents/*.md" -type f -print0 2>/dev/null)
+  fi
 
-  # Check for v6-alpha structure (bmad/bmm/agents/)
+  # v6.x: bmad/bmm/agents/
   if [[ -d "$bmad_core/bmm/agents" ]]; then
-    agents_dir="$bmad_core/bmm/agents"
-  # Check for v4 structure (.bmad-core/agents/)
-  elif [[ -d "$bmad_core/agents" ]]; then
-    agents_dir="$bmad_core/agents"
-  else
+    find "$bmad_core/bmm/agents" -name "*.md" -type f
+    found=1
+  fi
+
+  # v4: .bmad-core/agents/
+  if [[ -d "$bmad_core/agents" ]]; then
+    find "$bmad_core/agents" -name "*.md" -type f
+    found=1
+  fi
+
+  if [[ $found -eq 0 ]]; then
     echo -e "${RED}❌ Agents directory not found in $bmad_core${NC}" >&2
-    echo -e "${GRAY}   Tried: $bmad_core/bmm/agents/ and $bmad_core/agents/${NC}" >&2
+    echo -e "${GRAY}   Tried: $bmad_core/bmm/agents/, $bmad_core/agents/, .claude/skills/*/agents/${NC}" >&2
     return 1
   fi
-
-  find "$agents_dir" -name "*.md" -type f
 }
 
 # Check if agent has TTS injection
@@ -217,6 +240,15 @@ inject_tts() {
     return 0
   fi
 
+  # Detect format BEFORE creating backups — skip v6.6+ plain Markdown agents (no activation section)
+  local is_v6=false
+  if grep -q "<activation" "$agent_file"; then
+    is_v6=true
+  elif ! grep -q "activation-instructions:" "$agent_file"; then
+    echo -e "${GRAY}   ℹ️  Skipped (v6.6+ format): $(basename "$agent_file")${NC}"
+    return 2
+  fi
+
   # Create backup directory for centralized timestamped backups
   local backup_dir=".agentvibes/backups/agents"
   mkdir -p "$backup_dir"
@@ -231,15 +263,6 @@ inject_tts() {
 
   echo -e "${GRAY}   📦 Backup saved: $backup_dir/$backup_name${NC}"
 
-  # Detect v4 vs v6 structure
-  local is_v6=false
-  if grep -q "<activation" "$agent_file"; then
-    is_v6=true
-  elif ! grep -q "activation-instructions:" "$agent_file"; then
-    echo -e "${RED}❌ No activation section found in: $(basename "$agent_file")${NC}"
-    return 1
-  fi
-
   # Create TTS injection script based on version
   if [[ "$is_v6" == "true" ]]; then
     # v6 format: XML-style with <step n="4.5">
@@ -411,6 +434,7 @@ enable_all() {
   local agents=$(find_agents "$bmad_core")
   local success_count=0
   local skip_count=0
+  local format_skip_count=0
   local fail_count=0
 
   # Track modified files and backups for summary
@@ -423,7 +447,10 @@ enable_all() {
       continue
     fi
 
-    if inject_tts "$agent_file"; then
+    inject_tts "$agent_file" && local inject_result=0 || local inject_result=$?
+    if [[ $inject_result -eq 2 ]]; then
+      format_skip_count=$((format_skip_count + 1))
+    elif [[ $inject_result -eq 0 ]]; then
       success_count=$((success_count + 1))
       modified_files+=("$agent_file")
       # Track the backup file that was created
@@ -444,6 +471,7 @@ enable_all() {
   # Show results
   echo -e "${GREEN}✅ Successfully modified: $success_count agents${NC}"
   [[ $skip_count -gt 0 ]] && echo -e "${YELLOW}⏭️  Skipped (already enabled): $skip_count agents${NC}"
+  [[ $format_skip_count -gt 0 ]] && echo -e "${GRAY}   ℹ️  Skipped (v6.6+ format, not supported): $format_skip_count agents${NC}"
   [[ $fail_count -gt 0 ]] && echo -e "${RED}❌ Failed: $fail_count agents${NC}"
   echo ""
 

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

@@ -468,7 +468,7 @@ if [[ -f "$SCRIPT_DIR/audio-processor.sh" ]]; then
   # audio-processor.sh returns: FILE_PATH|BACKGROUND_FILE
   # Lookup order: LLM key (from --llm) → default
   _AGENT_KEY="${AGENTVIBES_LLM_KEY:-default}"
-  PROCESSOR_OUTPUT=$("$SCRIPT_DIR/audio-processor.sh" "$TEMP_FILE" "$_AGENT_KEY" "$PROCESSED_FILE" "$AGENT_PROFILE_FILE" 2>/dev/null) || {
+  PROCESSOR_OUTPUT=$(bash "$SCRIPT_DIR/audio-processor.sh" "$TEMP_FILE" "$_AGENT_KEY" "$PROCESSED_FILE" "$AGENT_PROFILE_FILE" 2>/dev/null) || {
     echo "Warning: Audio processing failed, using unprocessed audio" >&2
     PROCESSED_FILE="$TEMP_FILE"
     PROCESSOR_OUTPUT="$TEMP_FILE|"

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

@@ -203,6 +203,10 @@ if [[ -n "$LLM_PROVIDER" ]]; then
   fi
   # Export LLM key for child scripts (process-local, not system-wide)
   export AGENTVIBES_LLM_KEY="llm:${LLM_PROVIDER}"
+  # Emit routing info when verbose debugging is enabled (used by tests and diagnostics)
+  if [[ "${AGENTVIBES_VERBOSE:-0}" == "1" ]]; then
+    echo "llm=${LLM_PROVIDER}" >&2
+  fi
 fi
 
 # Prepend intro text (pretext) if configured

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

@@ -449,6 +449,14 @@ provider_preview() {
   echo "🎤 Voice Preview ($current_provider)"
   echo ""
 
+  # Detect routing LLM so preview audio reaches SSH/remote receivers
+  # (without --llm, play-tts.sh plays locally on headless servers instead of
+  # forwarding to the configured Windows/remote receiver)
+  local _preview_llm _preview_llm_args
+  _preview_llm=$(detect_routing_llm 2>/dev/null || echo "")
+  _preview_llm_args=()
+  [[ -n "$_preview_llm" ]] && _preview_llm_args=(--llm "$_preview_llm")
+
   case "$current_provider" in
     piper)
       # Use the Piper voice manager's list functionality
@@ -468,7 +476,8 @@ provider_preview() {
           if verify_voice "$voice_arg"; then
             echo "🎤 Previewing Piper voice: $voice_arg"
             echo ""
-            "$SCRIPT_DIR/play-tts.sh" "Hello, this is the $voice_arg voice. How do you like it?" "$voice_arg"
+            "$SCRIPT_DIR/play-tts.sh" "Hello, this is the $voice_arg voice. How do you like it?" \
+              "$voice_arg" "${_preview_llm_args[@]+"${_preview_llm_args[@]}"}"
           else
             echo "❌ Voice model not found: $voice_arg"
             echo ""
@@ -506,7 +515,8 @@ provider_preview() {
         local display_name="${voice_entry##*:}"
 
         echo "🔊 ${display_name}..."
-        "$SCRIPT_DIR/play-tts.sh" "Hi, my name is ${display_name}" "$voice_name"
+        "$SCRIPT_DIR/play-tts.sh" "Hi, my name is ${display_name}" \
+          "$voice_name" "${_preview_llm_args[@]+"${_preview_llm_args[@]}"}"
 
         # Wait for the voice to finish playing before starting next one
         sleep 3
@@ -532,7 +542,8 @@ provider_preview() {
         if say -v ? 2>/dev/null | grep -qi "^${voice_arg} "; then
           echo "🎤 Previewing macOS voice: $voice_arg"
           echo ""
-          "$SCRIPT_DIR/play-tts.sh" "Hello, this is ${voice_arg}. How do you like my voice?" "$voice_arg"
+          "$SCRIPT_DIR/play-tts.sh" "Hello, this is ${voice_arg}. How do you like my voice?" \
+            "$voice_arg" "${_preview_llm_args[@]+"${_preview_llm_args[@]}"}"
         else
           echo "❌ Voice not found: $voice_arg"
           echo ""
@@ -554,7 +565,8 @@ provider_preview() {
       for voice in "${sample_voices[@]}"; do
         if say -v ? 2>/dev/null | grep -qi "^${voice} "; then
           echo "🔊 ${voice}..."
-          "$SCRIPT_DIR/play-tts.sh" "Hi, my name is ${voice}" "$voice"
+          "$SCRIPT_DIR/play-tts.sh" "Hi, my name is ${voice}" \
+            "$voice" "${_preview_llm_args[@]+"${_preview_llm_args[@]}"}"
           sleep 3
         fi
       done

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

@@ -356,6 +356,44 @@ get_provider_script_path() {
   echo "$provider_script"
 }
 
+# @function detect_routing_llm
+# @intent Detect the LLM name to use for SSH/remote routing in preview and sample commands
+# @why preview/sample call play-tts.sh without --llm, so SSH routing is skipped and audio
+#      plays locally (no sound on headless servers). Detecting the remote LLM and passing
+#      --llm mirrors normal hook behaviour so audio reaches the configured receiver.
+# @returns Echoes LLM name (e.g. "claude-code") or empty string if no remote routing configured
+# @exitcode 0=always
+detect_routing_llm() {
+  # Priority 1: AGENTVIBES_LLM_KEY env var (set during active TTS sessions)
+  if [[ -n "${AGENTVIBES_LLM_KEY:-}" ]] && [[ "$AGENTVIBES_LLM_KEY" =~ ^llm:([a-zA-Z0-9][a-zA-Z0-9_-]*)$ ]]; then
+    echo "${BASH_REMATCH[1]}"
+    return 0
+  fi
+
+  # Priority 2: First mode=remote entry in transport-config.json
+  local _transport_cfg="$HOME/.agentvibes/transport-config.json"
+  if [[ -f "$_transport_cfg" ]] && command -v python3 &>/dev/null; then
+    local _remote_llm
+    _remote_llm=$(AGENTVIBES_CFG="$_transport_cfg" python3 - <<'PYEOF'
+import json, os, sys
+try:
+    d = json.load(open(os.environ['AGENTVIBES_CFG'], encoding='utf-8'))
+    hits = [k for k, v in d.items() if isinstance(v, dict) and v.get('mode') == 'remote']
+    print(hits[0] if hits else '')
+except Exception:
+    print('')
+PYEOF
+)
+    # Validate the key is a safe LLM name before returning
+    if [[ -n "$_remote_llm" ]] && [[ "$_remote_llm" =~ ^[a-zA-Z0-9][a-zA-Z0-9_-]*$ ]]; then
+      echo "$_remote_llm"
+      return 0
+    fi
+  fi
+
+  echo ""
+}
+
 # AI NOTE: This file provides the core abstraction layer for multi-provider TTS.
 # All provider state is managed through simple text files for simplicity and reliability.
 # Project-local configuration takes precedence over global to support per-project providers.

package/.claude/hooks/stop.sh

@@ -0,0 +1,38 @@
+#!/usr/bin/env bash
+#
+# File: .claude/hooks/stop.sh
+#
+# AgentVibes Stop Hook - Wrapper that delegates to .agentvibes/
+# This hook runs in LITE mode to extract and speak "Audio Summary:" markers
+#
+
+# Fix locale warnings
+export LC_ALL=C
+
+# Get script directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+
+# Path to mode configuration
+MODE_FILE="$PROJECT_ROOT/.agentvibes/config/mode.txt"
+
+# Check if AgentVibes is installed
+AGENTVIBES_HOOKS="$PROJECT_ROOT/.agentvibes/hooks"
+if [[ ! -d "$AGENTVIBES_HOOKS" ]]; then
+  # AgentVibes not installed, exit silently
+  exit 0
+fi
+
+# Read current mode (default to full if not set)
+CURRENT_MODE="full"
+if [[ -f "$MODE_FILE" ]]; then
+  CURRENT_MODE=$(cat "$MODE_FILE" 2>/dev/null | tr -d '[:space:]')
+fi
+
+# Only run stop hook in LITE mode
+# (Full mode uses tool calls for TTS, not stop hooks)
+if [[ "$CURRENT_MODE" == "lite" ]]; then
+  if [[ -f "$AGENTVIBES_HOOKS/stop-lite.sh" ]]; then
+    bash "$AGENTVIBES_HOOKS/stop-lite.sh" "$@"
+  fi
+fi