agentvibes 4.2.0 → 4.4.0

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

@@ -1,291 +1,291 @@
-#!/usr/bin/env 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 Piper (length-scale) and macOS (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-macos.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 Piper and macOS 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 macOS"
-  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
+#!/usr/bin/env 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 Piper (length-scale) and macOS (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-macos.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 Piper and macOS 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 macOS"
+  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