bmad-method 6.0.0-alpha.2 → 6.0.0-alpha.4

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

@@ -1,298 +0,0 @@
-#!/bin/bash
-#
-# File: .claude/hooks/provider-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 TTS Provider Management Functions
-# @context Core provider abstraction layer for multi-provider TTS system
-# @architecture Provides functions to get/set/list/validate TTS providers
-# @dependencies None - pure bash implementation
-# @entrypoints Sourced by play-tts.sh and provider management commands
-# @patterns File-based state management with project-local and global fallback
-# @related play-tts.sh, play-tts-elevenlabs.sh, play-tts-piper.sh, provider-commands.sh
-#
-
-# @function get_provider_config_path
-# @intent Determine path to tts-provider.txt file
-# @why Supports both project-local (.claude/) and global (~/.claude/) storage
-# @returns Echoes path to provider config file
-# @exitcode 0=always succeeds
-# @sideeffects None
-# @edgecases Creates parent directory if missing
-get_provider_config_path() {
-  local provider_file
-
-  # Check project-local first
-  if [[ -n "$CLAUDE_PROJECT_DIR" ]] && [[ -d "$CLAUDE_PROJECT_DIR/.claude" ]]; then
-    provider_file="$CLAUDE_PROJECT_DIR/.claude/tts-provider.txt"
-  else
-    # Search up directory tree for .claude/
-    local current_dir="$PWD"
-    while [[ "$current_dir" != "/" ]]; do
-      if [[ -d "$current_dir/.claude" ]]; then
-        provider_file="$current_dir/.claude/tts-provider.txt"
-        break
-      fi
-      current_dir=$(dirname "$current_dir")
-    done
-
-    # Fallback to global if no project .claude found
-    if [[ -z "$provider_file" ]]; then
-      provider_file="$HOME/.claude/tts-provider.txt"
-    fi
-  fi
-
-  echo "$provider_file"
-}
-
-# @function get_active_provider
-# @intent Read currently active TTS provider from config file
-# @why Central function for determining which provider to use
-# @returns Echoes provider name (e.g., "elevenlabs", "piper")
-# @exitcode 0=success
-# @sideeffects None
-# @edgecases Returns "elevenlabs" if file missing or empty (default)
-get_active_provider() {
-  local provider_file
-  provider_file=$(get_provider_config_path)
-
-  # Read provider from file, default to piper if not found
-  if [[ -f "$provider_file" ]]; then
-    local provider
-    provider=$(cat "$provider_file" | tr -d '[:space:]')
-    if [[ -n "$provider" ]]; then
-      echo "$provider"
-      return 0
-    fi
-  fi
-
-  # Default to piper (free, offline)
-  echo "piper"
-}
-
-# @function set_active_provider
-# @intent Write active provider to config file
-# @why Allows runtime provider switching without restart
-# @param $1 {string} provider - Provider name (e.g., "elevenlabs", "piper")
-# @returns None (outputs success/error message)
-# @exitcode 0=success, 1=invalid provider
-# @sideeffects Writes to tts-provider.txt file
-# @edgecases Creates file and parent directory if missing
-set_active_provider() {
-  local provider="$1"
-
-  if [[ -z "$provider" ]]; then
-    echo "❌ Error: Provider name required"
-    echo "Usage: set_active_provider <provider_name>"
-    return 1
-  fi
-
-  # Validate provider exists
-  if ! validate_provider "$provider"; then
-    echo "❌ Error: Provider '$provider' not found"
-    echo "Available providers:"
-    list_providers
-    return 1
-  fi
-
-  local provider_file
-  provider_file=$(get_provider_config_path)
-
-  # Create directory if it doesn't exist
-  mkdir -p "$(dirname "$provider_file")"
-
-  # Write provider to file
-  echo "$provider" > "$provider_file"
-
-  # Reset voice when switching providers to avoid incompatible voices
-  # (e.g., ElevenLabs "Demon Monster" doesn't exist in Piper)
-  local voice_file
-  if [[ -n "$CLAUDE_PROJECT_DIR" ]] && [[ -d "$CLAUDE_PROJECT_DIR/.claude" ]]; then
-    voice_file="$CLAUDE_PROJECT_DIR/.claude/tts-voice.txt"
-  else
-    voice_file="$HOME/.claude/tts-voice.txt"
-  fi
-
-  # Set default voice for the new provider
-  local default_voice
-  case "$provider" in
-    piper)
-      # Default Piper voice
-      default_voice="en_US-lessac-medium"
-      ;;
-    elevenlabs)
-      # Default ElevenLabs voice (first in alphabetical order from voices-config.sh)
-      default_voice="Amy"
-      ;;
-    *)
-      # Unknown provider - remove voice file
-      if [[ -f "$voice_file" ]]; then
-        rm -f "$voice_file"
-      fi
-      echo "✓ Active provider set to: $provider (voice reset)"
-      return 0
-      ;;
-  esac
-
-  # Write default voice to file
-  echo "$default_voice" > "$voice_file"
-
-  echo "✓ Active provider set to: $provider (voice set to: $default_voice)"
-}
-
-# @function list_providers
-# @intent List all available TTS providers
-# @why Discover which providers are installed
-# @returns Echoes provider names (one per line)
-# @exitcode 0=success
-# @sideeffects None
-# @edgecases Returns empty if no play-tts-*.sh files found
-list_providers() {
-  local script_dir
-  script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-
-  # Find all play-tts-*.sh files
-  local providers=()
-  shopt -s nullglob  # Handle case where no files match
-  for file in "$script_dir"/play-tts-*.sh; do
-    if [[ -f "$file" ]] && [[ "$file" != *"play-tts.sh" ]]; then
-      # Extract provider name from filename (play-tts-elevenlabs.sh -> elevenlabs)
-      local basename
-      basename=$(basename "$file")
-      local provider
-      provider="${basename#play-tts-}"
-      provider="${provider%.sh}"
-      providers+=("$provider")
-    fi
-  done
-  shopt -u nullglob
-
-  # Output providers
-  if [[ ${#providers[@]} -eq 0 ]]; then
-    echo "⚠️ No providers found"
-    return 0
-  fi
-
-  for provider in "${providers[@]}"; do
-    echo "$provider"
-  done
-}
-
-# @function validate_provider
-# @intent Check if provider implementation exists
-# @why Prevent errors from switching to non-existent provider
-# @param $1 {string} provider - Provider name to validate
-# @returns None
-# @exitcode 0=provider exists, 1=provider not found
-# @sideeffects None
-# @edgecases Checks for corresponding play-tts-*.sh file
-validate_provider() {
-  local provider="$1"
-
-  if [[ -z "$provider" ]]; then
-    return 1
-  fi
-
-  local script_dir
-  script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-  local provider_script="$script_dir/play-tts-${provider}.sh"
-
-  [[ -f "$provider_script" ]]
-}
-
-# @function get_provider_script_path
-# @intent Get absolute path to provider implementation script
-# @why Used by router to execute provider-specific logic
-# @param $1 {string} provider - Provider name
-# @returns Echoes absolute path to play-tts-*.sh file
-# @exitcode 0=success, 1=provider not found
-# @sideeffects None
-get_provider_script_path() {
-  local provider="$1"
-
-  if [[ -z "$provider" ]]; then
-    echo "❌ Error: Provider name required" >&2
-    return 1
-  fi
-
-  local script_dir
-  script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-  local provider_script="$script_dir/play-tts-${provider}.sh"
-
-  if [[ ! -f "$provider_script" ]]; then
-    echo "❌ Error: Provider '$provider' not found at $provider_script" >&2
-    return 1
-  fi
-
-  echo "$provider_script"
-}
-
-# 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.
-
-# Command-line interface (when script is executed, not sourced)
-if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
-  case "${1:-}" in
-    get)
-      get_active_provider
-      ;;
-    switch|set)
-      if [[ -z "${2:-}" ]]; then
-        echo "❌ Error: Provider name required"
-        echo "Usage: $0 switch <provider>"
-        exit 1
-      fi
-      set_active_provider "$2"
-      ;;
-    list)
-      list_providers
-      ;;
-    validate)
-      if [[ -z "${2:-}" ]]; then
-        echo "❌ Error: Provider name required"
-        echo "Usage: $0 validate <provider>"
-        exit 1
-      fi
-      validate_provider "$2"
-      ;;
-    *)
-      echo "Usage: $0 {get|switch|list|validate} [provider]"
-      echo ""
-      echo "Commands:"
-      echo "  get              - Show active provider"
-      echo "  switch <name>    - Switch to provider"
-      echo "  list             - List available providers"
-      echo "  validate <name>  - Check if provider exists"
-      exit 1
-      ;;
-  esac
-fi

package/.claude/hooks/replay-target-audio.sh

@@ -1,95 +0,0 @@
-#!/bin/bash
-#
-# File: .claude/hooks/replay-target-audio.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 Replay Last Target Language Audio
-# @context Replays the most recent target language TTS for language learning
-# @architecture Simple audio replay with lock mechanism for sequential playback
-# @dependencies ffprobe, paplay/aplay/mpg123/mpv, .claude/last-target-audio.txt
-# @entrypoints Called by /agent-vibes:replay-target slash command
-# @patterns Sequential audio playback with lock file, duration-based lock release
-# @related play-tts-piper.sh, play-tts-elevenlabs.sh, learn-manager.sh
-#
-
-# Fix locale warnings
-export LC_ALL=C
-
-TARGET_AUDIO_FILE="${CLAUDE_PROJECT_DIR:-.}/.claude/last-target-audio.txt"
-
-# Check if target audio tracking file exists
-if [ ! -f "$TARGET_AUDIO_FILE" ]; then
-  echo "❌ No target language audio found."
-  echo "   Language learning mode may not be active."
-  echo "   Activate with: /agent-vibes:learn"
-  exit 1
-fi
-
-# Read last target audio file path
-LAST_AUDIO=$(cat "$TARGET_AUDIO_FILE")
-
-# Verify audio file exists
-if [ ! -f "$LAST_AUDIO" ]; then
-  echo "❌ Audio file not found: $LAST_AUDIO"
-  echo "   The file may have been deleted or moved."
-  exit 1
-fi
-
-echo "🔁 Replaying target language audio..."
-
-# Use lock file for sequential playback
-LOCK_FILE="/tmp/agentvibes-audio.lock"
-
-# Wait for any current audio to finish (max 30 seconds)
-for i in {1..60}; do
-  if [ ! -f "$LOCK_FILE" ]; then
-    break
-  fi
-  sleep 0.5
-done
-
-# Create lock
-touch "$LOCK_FILE"
-
-# Get audio duration for proper lock timing
-DURATION=$(ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 "$LAST_AUDIO" 2>/dev/null)
-DURATION=${DURATION%.*}  # Round to integer
-DURATION=${DURATION:-1}   # Default to 1 second if detection fails
-
-# Play audio
-(paplay "$LAST_AUDIO" || aplay "$LAST_AUDIO" || mpg123 "$LAST_AUDIO" || mpv "$LAST_AUDIO") >/dev/null 2>&1 &
-PLAYER_PID=$!
-
-# Wait for audio to finish, then release lock
-(sleep $DURATION; rm -f "$LOCK_FILE") &
-disown
-
-echo "✅ Replay complete: $(basename "$LAST_AUDIO")"

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

@@ -1,201 +0,0 @@
-#!/bin/bash
-#
-# File: .claude/hooks/sentiment-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 Sentiment Manager - Applies personality styles to current voice without changing the voice itself
-# @context Allows adding emotional/tonal layers (flirty, sarcastic, etc.) to any voice while preserving voice identity
-# @architecture Reuses personality markdown files, stores sentiment separately from personality
-# @dependencies .claude/personalities/*.md files, play-tts.sh for acknowledgment
-# @entrypoints Called by /agent-vibes:sentiment slash command
-# @patterns Personality/sentiment separation, state file management, random example selection
-# @related personality-manager.sh, .claude/personalities/*.md, .claude/tts-sentiment.txt
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PERSONALITIES_DIR="$SCRIPT_DIR/../personalities"
-
-# Project-local file first, global fallback
-# Use logical path (not physical) to handle symlinked .claude directories
-# Script is at .claude/hooks/sentiment-manager.sh, so .claude is ..
-CLAUDE_DIR="$(cd "$SCRIPT_DIR/.." 2>/dev/null && pwd)"
-
-# Check if we have a project-local .claude directory
-if [[ -d "$CLAUDE_DIR" ]] && [[ "$CLAUDE_DIR" != "$HOME/.claude" ]]; then
-  SENTIMENT_FILE="$CLAUDE_DIR/tts-sentiment.txt"
-else
-  SENTIMENT_FILE="$HOME/.claude/tts-sentiment.txt"
-fi
-
-# Function to get personality data from markdown file
-get_personality_data() {
-  local personality="$1"
-  local field="$2"
-  local file="$PERSONALITIES_DIR/${personality}.md"
-
-  if [[ ! -f "$file" ]]; then
-    return 1
-  fi
-
-  case "$field" in
-    description)
-      grep "^description:" "$file" | cut -d: -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'
-      ;;
-  esac
-}
-
-# Function to list all available personalities
-list_personalities() {
-  if [[ -d "$PERSONALITIES_DIR" ]]; then
-    for file in "$PERSONALITIES_DIR"/*.md; do
-      if [[ -f "$file" ]]; then
-        basename "$file" .md
-      fi
-    done
-  fi
-}
-
-case "$1" in
-  list)
-    echo "🎭 Available Sentiments:"
-    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-
-    # Get current sentiment
-    CURRENT="none"
-    if [ -f "$SENTIMENT_FILE" ]; then
-      CURRENT=$(cat "$SENTIMENT_FILE")
-    fi
-
-    # List personalities from markdown files
-    echo "Available sentiment styles:"
-    for personality in $(list_personalities | sort); do
-      desc=$(get_personality_data "$personality" "description")
-      if [[ "$personality" == "$CURRENT" ]]; then
-        echo "  ✓ $personality - $desc (current)"
-      else
-        echo "  - $personality - $desc"
-      fi
-    done
-
-    echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-    echo ""
-    echo "Usage: /agent-vibes:sentiment <name>"
-    echo "       /agent-vibes:sentiment clear"
-    ;;
-
-  set)
-    SENTIMENT="$2"
-
-    if [[ -z "$SENTIMENT" ]]; then
-      echo "❌ Please specify a sentiment name"
-      echo "Usage: $0 set <sentiment>"
-      exit 1
-    fi
-
-    # Check if sentiment file exists
-    if [[ ! -f "$PERSONALITIES_DIR/${SENTIMENT}.md" ]]; then
-      echo "❌ Sentiment not found: $SENTIMENT"
-      echo ""
-      echo "Available sentiments:"
-      for p in $(list_personalities | sort); do
-        echo "  • $p"
-      done
-      exit 1
-    fi
-
-    # Save the sentiment (but don't change personality or voice)
-    echo "$SENTIMENT" > "$SENTIMENT_FILE"
-    echo "🎭 Sentiment set to: $SENTIMENT"
-    echo "🎤 Voice remains unchanged"
-    echo ""
-
-    # Make a sentiment-appropriate remark with TTS
-    TTS_SCRIPT="$SCRIPT_DIR/play-tts.sh"
-
-    # Try to get acknowledgment from personality file (sentiments use same personality files)
-    PERSONALITY_FILE_PATH="$PERSONALITIES_DIR/${SENTIMENT}.md"
-    REMARK=""
-
-    if [[ -f "$PERSONALITY_FILE_PATH" ]]; then
-      # Extract example responses from personality file (lines starting with "- ")
-      mapfile -t EXAMPLES < <(grep '^- "' "$PERSONALITY_FILE_PATH" | sed 's/^- "//; s/"$//')
-
-      if [[ ${#EXAMPLES[@]} -gt 0 ]]; then
-        # Pick a random example
-        REMARK="${EXAMPLES[$RANDOM % ${#EXAMPLES[@]}]}"
-      fi
-    fi
-
-    # Fallback if no examples found
-    if [[ -z "$REMARK" ]]; then
-      REMARK="Sentiment set to ${SENTIMENT} while maintaining current voice"
-    fi
-
-    echo "💬 $REMARK"
-    "$TTS_SCRIPT" "$REMARK"
-    ;;
-
-  get)
-    if [ -f "$SENTIMENT_FILE" ]; then
-      CURRENT=$(cat "$SENTIMENT_FILE")
-      echo "Current sentiment: $CURRENT"
-
-      desc=$(get_personality_data "$CURRENT" "description")
-      [[ -n "$desc" ]] && echo "Description: $desc"
-    else
-      echo "Current sentiment: none (voice personality only)"
-    fi
-    ;;
-
-  clear)
-    rm -f "$SENTIMENT_FILE"
-    echo "🎭 Sentiment cleared - using voice personality only"
-    ;;
-
-  *)
-    # If a single argument is provided and it's not a command, treat it as "set <sentiment>"
-    if [[ -n "$1" ]] && [[ -f "$PERSONALITIES_DIR/${1}.md" ]]; then
-      exec "$0" set "$1"
-    else
-      echo "AgentVibes Sentiment Manager"
-      echo ""
-      echo "Commands:"
-      echo "  list                - List all sentiments"
-      echo "  set <name>          - Set sentiment for current voice"
-      echo "  get                 - Show current sentiment"
-      echo "  clear               - Clear sentiment"
-      echo ""
-      echo "Examples:"
-      echo "  /agent-vibes:sentiment flirty     # Add flirty style to current voice"
-      echo "  /agent-vibes:sentiment sarcastic  # Add sarcasm to current voice"
-      echo "  /agent-vibes:sentiment clear      # Remove sentiment"
-    fi
-    ;;
-esac