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

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

@@ -0,0 +1,291 @@
+#!/bin/bash
+#
+# File: .claude/hooks/speed-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 Speech Speed Manager for Multi-Provider TTS
+# @context Manage speech rate for main and target language voices
+# @architecture Simple config file manager supporting both Piper (length-scale) and ElevenLabs (speed API parameter)
+# @dependencies .claude/config/tts-speech-rate.txt, .claude/config/tts-target-speech-rate.txt
+# @entrypoints Called by /agent-vibes:set-speed slash command
+# @patterns Provider-agnostic speed config, legacy file migration, random tongue twisters for testing
+# @related play-tts.sh, play-tts-piper.sh, play-tts-elevenlabs.sh, learn-manager.sh
+#
+
+# Get script directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Determine config directory (project-local first, then global)
+if [[ -n "$CLAUDE_PROJECT_DIR" ]] && [[ -d "$CLAUDE_PROJECT_DIR/.claude" ]]; then
+  CONFIG_DIR="$CLAUDE_PROJECT_DIR/.claude/config"
+else
+  # Try to find .claude in current path
+  CURRENT_DIR="$PWD"
+  while [[ "$CURRENT_DIR" != "/" ]]; do
+    if [[ -d "$CURRENT_DIR/.claude" ]]; then
+      CONFIG_DIR="$CURRENT_DIR/.claude/config"
+      break
+    fi
+    CURRENT_DIR=$(dirname "$CURRENT_DIR")
+  done
+  # Fallback to global
+  if [[ -z "$CONFIG_DIR" ]]; then
+    CONFIG_DIR="$HOME/.claude/config"
+  fi
+fi
+
+mkdir -p "$CONFIG_DIR"
+
+MAIN_SPEED_FILE="$CONFIG_DIR/tts-speech-rate.txt"
+TARGET_SPEED_FILE="$CONFIG_DIR/tts-target-speech-rate.txt"
+
+# Legacy file paths for backward compatibility (Piper-specific naming)
+LEGACY_MAIN_SPEED_FILE="$CONFIG_DIR/piper-speech-rate.txt"
+LEGACY_TARGET_SPEED_FILE="$CONFIG_DIR/piper-target-speech-rate.txt"
+
+# @function parse_speed_value
+# @intent Convert user-friendly speed notation to normalized speed multiplier
+# @param $1 Speed string (e.g., "2x", "0.5x", "normal")
+# @returns Numeric speed value (0.5=slower, 1.0=normal, 2.0=faster, 3.0=very fast)
+# @note This is the user-facing scale - provider scripts will convert as needed
+parse_speed_value() {
+  local input="$1"
+
+  # Handle special cases
+  case "$input" in
+    normal|1x|1.0)
+      echo "1.0"
+      return
+      ;;
+    slow|slower|0.5x)
+      echo "0.5"
+      return
+      ;;
+    fast|2x|2.0)
+      echo "2.0"
+      return
+      ;;
+    faster|3x|3.0)
+      echo "3.0"
+      return
+      ;;
+  esac
+
+  # Strip leading '+' or '-' if present
+  input="${input#+}"
+  input="${input#-}"
+
+  # Strip trailing 'x' if present
+  input="${input%x}"
+
+  # Validate it's a number
+  if [[ "$input" =~ ^[0-9]+\.?[0-9]*$ ]]; then
+    echo "$input"
+  else
+    echo "ERROR"
+  fi
+}
+
+# @function set_speed
+# @intent Set speech speed for main or target voice
+# @param $1 Target ("target" or empty for main)
+# @param $2 Speed value
+set_speed() {
+  local is_target=false
+  local speed_input=""
+
+  # Parse arguments
+  if [[ "$1" == "target" ]]; then
+    is_target=true
+    speed_input="$2"
+  else
+    speed_input="$1"
+  fi
+
+  if [[ -z "$speed_input" ]]; then
+    echo "❌ Error: Speed value required"
+    echo "Usage: /agent-vibes:set-speed [target] <speed>"
+    echo "Examples: 2x, 0.5x, normal, +3x"
+    return 1
+  fi
+
+  # Parse speed value
+  local speed_value
+  speed_value=$(parse_speed_value "$speed_input")
+
+  if [[ "$speed_value" == "ERROR" ]]; then
+    echo "❌ Invalid speed value: $speed_input"
+    echo "Valid values: normal, 0.5x, 1x, 2x, 3x, +2x, -2x"
+    return 1
+  fi
+
+  # Determine which file to write to
+  local config_file
+  local voice_type
+  if [[ "$is_target" == true ]]; then
+    config_file="$TARGET_SPEED_FILE"
+    voice_type="target language"
+  else
+    config_file="$MAIN_SPEED_FILE"
+    voice_type="main voice"
+  fi
+
+  # Write speed value
+  echo "$speed_value" > "$config_file"
+
+  # Show confirmation
+  echo "✓ Speech speed set for $voice_type"
+  echo ""
+  echo "Speed: ${speed_value}x"
+
+  case "$speed_value" in
+    0.5)
+      echo "Effect: Half speed (slower)"
+      ;;
+    1.0)
+      echo "Effect: Normal speed"
+      ;;
+    2.0)
+      echo "Effect: Double speed (faster)"
+      ;;
+    3.0)
+      echo "Effect: Triple speed (very fast)"
+      ;;
+    *)
+      if (( $(echo "$speed_value > 1.0" | bc -l) )); then
+        echo "Effect: Faster speech"
+      else
+        echo "Effect: Slower speech"
+      fi
+      ;;
+  esac
+
+  echo ""
+  echo "Note: Speed control works with both Piper and ElevenLabs providers"
+
+  # Array of simple test messages to demonstrate speed
+  local test_messages=(
+    "Testing speed change"
+    "Speed test in progress"
+    "Checking audio speed"
+    "Speed configuration test"
+    "Audio speed test"
+  )
+
+  # Pick a random test message
+  local random_index=$((RANDOM % ${#test_messages[@]}))
+  local test_msg="${test_messages[$random_index]}"
+
+  echo ""
+  echo "🔊 Testing new speed with: \"$test_msg\""
+  "$SCRIPT_DIR/play-tts.sh" "$test_msg" &
+}
+
+# @function migrate_legacy_files
+# @intent Migrate from old piper-specific files to provider-agnostic files
+# @why Ensure backward compatibility when upgrading from Piper-only to multi-provider
+migrate_legacy_files() {
+  # Migrate main speed file
+  if [[ -f "$LEGACY_MAIN_SPEED_FILE" ]] && [[ ! -f "$MAIN_SPEED_FILE" ]]; then
+    cp "$LEGACY_MAIN_SPEED_FILE" "$MAIN_SPEED_FILE"
+  fi
+
+  # Migrate target speed file
+  if [[ -f "$LEGACY_TARGET_SPEED_FILE" ]] && [[ ! -f "$TARGET_SPEED_FILE" ]]; then
+    cp "$LEGACY_TARGET_SPEED_FILE" "$TARGET_SPEED_FILE"
+  fi
+}
+
+# @function get_speed
+# @intent Display current speech speed settings
+get_speed() {
+  # Migrate legacy files if needed
+  migrate_legacy_files
+
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo "   Current Speech Speed Settings"
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo ""
+
+  # Main voice speed
+  if [[ -f "$MAIN_SPEED_FILE" ]]; then
+    local main_speed=$(grep -v '^#' "$MAIN_SPEED_FILE" 2>/dev/null | grep -v '^$' | tail -1)
+    echo "Main voice: ${main_speed}x"
+  else
+    echo "Main voice: 1.0x (default, normal speed)"
+  fi
+
+  # Target voice speed
+  if [[ -f "$TARGET_SPEED_FILE" ]]; then
+    local target_speed=$(cat "$TARGET_SPEED_FILE" 2>/dev/null)
+    echo "Target language: ${target_speed}x"
+  else
+    echo "Target language: 0.5x (default, slower for learning)"
+  fi
+
+  echo ""
+  echo "Scale: 0.5x=slower, 1.0x=normal, 2.0x=faster, 3.0x=very fast"
+  echo "Works with: Piper TTS and ElevenLabs"
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+}
+
+# Main command handler
+case "${1:-}" in
+  target)
+    set_speed "target" "$2"
+    ;;
+  get|status)
+    get_speed
+    ;;
+  normal|fast|slow|slower|*x|*.*|+*|-*)
+    set_speed "$1"
+    ;;
+  *)
+    echo "Speech Speed Manager"
+    echo ""
+    echo "Usage:"
+    echo "  /agent-vibes:set-speed <speed>         Set main voice speed"
+    echo "  /agent-vibes:set-speed target <speed>  Set target language speed"
+    echo "  /agent-vibes:set-speed get              Show current speeds"
+    echo ""
+    echo "Speed values:"
+    echo "  0.5x or slow/slower = Half speed (slower)"
+    echo "  1x or normal        = Normal speed"
+    echo "  2x or fast          = Double speed (faster)"
+    echo "  3x or faster        = Triple speed (very fast)"
+    echo ""
+    echo "Examples:"
+    echo "  /agent-vibes:set-speed 2x        # Make voice faster"
+    echo "  /agent-vibes:set-speed 0.5x      # Make voice slower"
+    echo "  /agent-vibes:set-speed target 0.5x  # Slow down target language for learning"
+    echo "  /agent-vibes:set-speed normal    # Reset to normal"
+    ;;
+esac