External/BMAD-METHOD
1
0
Fork 0
mirror of https://github.com/bmadcode/BMAD-METHOD.git synced 2025-12-29 16:14:59 +00:00
Code Issues Packages Projects Releases Wiki Activity
BMAD-METHOD/.claude/hooks/learn-manager.sh

476 lines
18 KiB
Bash
Raw Normal View History

opencode moved agents back to agent folder
2025-10-28 17:18:53 -05:00
#!/bin/bash
#
# File: .claude/hooks/learn-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. Use at your own risk. See the Apache License for details.
#
# ---
#
# @fileoverview Language Learning Mode Manager - Enables dual-language TTS for immersive learning
# @context Speaks responses in both main language (English) and target language (Spanish, French, etc.) for language practice
# @architecture Manages main/target language pairs with voice mappings, auto-configures recommended voices per language
# @dependencies play-tts.sh (dual invocation), language-manager.sh (voice recommendations), .claude/tts-*.txt state files
# @entrypoints Called by /agent-vibes:learn commands to enable/disable learning mode
# @patterns Dual-voice orchestration, auto-configuration, greeting on activation, provider-aware voice selection
# @related language-manager.sh, play-tts.sh, .claude/tts-learn-mode.txt, .claude/tts-target-language.txt
set -e
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
PROJECT_DIR="$SCRIPT_DIR/../.."
# Configuration files (project-local first, then global fallback)
MAIN_LANG_FILE="$PROJECT_DIR/.claude/tts-main-language.txt"
TARGET_LANG_FILE="$PROJECT_DIR/.claude/tts-target-language.txt"
TARGET_VOICE_FILE="$PROJECT_DIR/.claude/tts-target-voice.txt"
LEARN_MODE_FILE="$PROJECT_DIR/.claude/tts-learn-mode.txt"
GLOBAL_MAIN_LANG_FILE="$HOME/.claude/tts-main-language.txt"
GLOBAL_TARGET_LANG_FILE="$HOME/.claude/tts-target-language.txt"
GLOBAL_TARGET_VOICE_FILE="$HOME/.claude/tts-target-voice.txt"
GLOBAL_LEARN_MODE_FILE="$HOME/.claude/tts-learn-mode.txt"
# Colors
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
BLUE='\033[0;34m'
NC='\033[0m'
# Get main language
get_main_language() {
if [[ -f "$MAIN_LANG_FILE" ]]; then
cat "$MAIN_LANG_FILE"
elif [[ -f "$GLOBAL_MAIN_LANG_FILE" ]]; then
cat "$GLOBAL_MAIN_LANG_FILE"
else
echo "english"
fi
}
# Set main language
set_main_language() {
local language="$1"
if [[ -z "$language" ]]; then
echo -e "${YELLOW}Usage: learn-manager.sh set-main-language <language>${NC}"
exit 1
fi
mkdir -p "$PROJECT_DIR/.claude"
echo "$language" > "$MAIN_LANG_FILE"
echo -e "${GREEN}✓${NC} Main language set to: $language"
}
# Get target language
get_target_language() {
if [[ -f "$TARGET_LANG_FILE" ]]; then
cat "$TARGET_LANG_FILE"
elif [[ -f "$GLOBAL_TARGET_LANG_FILE" ]]; then
cat "$GLOBAL_TARGET_LANG_FILE"
else
echo ""
fi
}
# Get greeting message for a language
get_greeting_for_language() {
local language="$1"
case "${language,,}" in
spanish|español)
echo "¡Hola! Soy tu profesor de español. ¡Vamos a aprender juntos!"
;;
french|français)
echo "Bonjour! Je suis votre professeur de français. Apprenons ensemble!"
;;
german|deutsch)
echo "Hallo! Ich bin dein Deutschlehrer. Lass uns zusammen lernen!"
;;
italian|italiano)
echo "Ciao! Sono il tuo insegnante di italiano. Impariamo insieme!"
;;
portuguese|português)
echo "Olá! Sou seu professor de português. Vamos aprender juntos!"
;;
chinese|中文|mandarin)
echo "你好！我是你的中文老师。让我们一起学习吧！"
;;
japanese|日本語)
echo "こんにちは！私はあなたの日本語の先生です。一緒に勉強しましょう！"
;;
korean|한국어)
echo "안녕하세요! 저는 당신의 한국어 선생님입니다. 함께 배워봅시다!"
;;
russian|русский)
echo "Здравствуйте! Я ваш учитель русского языка. Давайте учиться вместе!"
;;
arabic|العربية)
echo "مرحبا! أنا معلمك للغة العربية. دعونا نتعلم معا!"
;;
hindi|हिन्दी)
echo "नमस्ते! मैं आपका हिंदी शिक्षक हूं। आइए साथ में सीखें!"
;;
dutch|nederlands)
echo "Hallo! Ik ben je Nederlandse leraar. Laten we samen leren!"
;;
polish|polski)
echo "Cześć! Jestem twoim nauczycielem polskiego. Uczmy się razem!"
;;
turkish|türkçe)
echo "Merhaba! Ben Türkçe öğretmeninizim. Birlikte öğrenelim!"
;;
swedish|svenska)
echo "Hej! Jag är din svenskalärare. Låt oss lära tillsammans!"
;;
*)
echo "Hello! I am your language teacher. Let's learn together!"
;;
esac
}
# Set target language
set_target_language() {
local language="$1"
if [[ -z "$language" ]]; then
echo -e "${YELLOW}Usage: learn-manager.sh set-target-language <language>${NC}"
exit 1
fi
mkdir -p "$PROJECT_DIR/.claude"
echo "$language" > "$TARGET_LANG_FILE"
echo -e "${GREEN}✓${NC} Target language set to: $language"
# Automatically set the recommended voice for this language
local recommended_voice=$(get_recommended_voice_for_language "$language")
if [[ -n "$recommended_voice" ]]; then
echo "$recommended_voice" > "$TARGET_VOICE_FILE"
echo -e "${GREEN}✓${NC} Target voice automatically set to: ${YELLOW}$recommended_voice${NC}"
# Detect provider for display
local provider=""
if [[ -f "$PROJECT_DIR/.claude/tts-provider.txt" ]]; then
provider=$(cat "$PROJECT_DIR/.claude/tts-provider.txt")
elif [[ -f "$HOME/.claude/tts-provider.txt" ]]; then
provider=$(cat "$HOME/.claude/tts-provider.txt")
else
provider="elevenlabs"
fi
echo -e " (for ${GREEN}$provider${NC} TTS)"
echo ""
# Greet user in the target language with the target voice
local greeting=$(get_greeting_for_language "$language")
echo -e "${BLUE}🎓${NC} Your language teacher says:"
# Check if we're using Piper and if the voice is available
if [[ "$provider" == "piper" ]]; then
# Quick check: does the voice file exist?
local voice_dir="${HOME}/.claude/piper-voices"
if [[ -f "${voice_dir}/${recommended_voice}.onnx" ]]; then
# Voice exists, play greeting in background
nohup "$SCRIPT_DIR/play-tts.sh" "$greeting" "$recommended_voice" >/dev/null 2>&1 &
else
echo -e "${YELLOW} (Voice not yet downloaded - greeting will play after first download)${NC}"
fi
else
# ElevenLabs - just play it in background
nohup "$SCRIPT_DIR/play-tts.sh" "$greeting" "$recommended_voice" >/dev/null 2>&1 &
fi
else
# Fallback to suggestion if auto-set failed
suggest_voice_for_language "$language"
fi
}
# Get recommended voice for a language (returns voice string, no output)
get_recommended_voice_for_language() {
local language="$1"
local recommended_voice=""
local provider=""
# Detect active provider
if [[ -f "$PROJECT_DIR/.claude/tts-provider.txt" ]]; then
provider=$(cat "$PROJECT_DIR/.claude/tts-provider.txt")
elif [[ -f "$HOME/.claude/tts-provider.txt" ]]; then
provider=$(cat "$HOME/.claude/tts-provider.txt")
else
provider="elevenlabs" # Default
fi
# Source language manager and get provider-specific voice
if [[ -f "$SCRIPT_DIR/language-manager.sh" ]]; then
source "$SCRIPT_DIR/language-manager.sh" 2>/dev/null
recommended_voice=$(get_voice_for_language "$language" "$provider" 2>/dev/null)
fi
# Fallback to hardcoded suggestions if function failed
if [[ -z "$recommended_voice" ]]; then
case "${language,,}" in
spanish|español)
recommended_voice=$([ "$provider" = "piper" ] && echo "es_ES-davefx-medium" || echo "Antoni")
;;
french|français)
recommended_voice=$([ "$provider" = "piper" ] && echo "fr_FR-siwis-medium" || echo "Rachel")
;;
german|deutsch)
recommended_voice=$([ "$provider" = "piper" ] && echo "de_DE-thorsten-medium" || echo "Domi")
;;
italian|italiano)
recommended_voice=$([ "$provider" = "piper" ] && echo "it_IT-riccardo-x_low" || echo "Bella")
;;
portuguese|português)
recommended_voice=$([ "$provider" = "piper" ] && echo "pt_BR-faber-medium" || echo "Matilda")
;;
chinese|中文|mandarin)
recommended_voice=$([ "$provider" = "piper" ] && echo "zh_CN-huayan-medium" || echo "Amy")
;;
*)
recommended_voice=$([ "$provider" = "piper" ] && echo "en_US-lessac-medium" || echo "Antoni")
;;
esac
fi
echo "$recommended_voice"
}
# Suggest voice based on target language (displays suggestion message)
suggest_voice_for_language() {
local language="$1"
local suggested_voice=$(get_recommended_voice_for_language "$language")
# Detect provider for display
local provider=""
if [[ -f "$PROJECT_DIR/.claude/tts-provider.txt" ]]; then
provider=$(cat "$PROJECT_DIR/.claude/tts-provider.txt")
elif [[ -f "$HOME/.claude/tts-provider.txt" ]]; then
provider=$(cat "$HOME/.claude/tts-provider.txt")
else
provider="elevenlabs"
fi
echo ""
echo -e "${BLUE}💡 Tip:${NC} For $language (using ${GREEN}$provider${NC} TTS), we recommend: ${YELLOW}$suggested_voice${NC}"
echo -e " Set it with: ${YELLOW}/agent-vibes:target-voice $suggested_voice${NC}"
}
# Get target voice
get_target_voice() {
if [[ -f "$TARGET_VOICE_FILE" ]]; then
cat "$TARGET_VOICE_FILE"
elif [[ -f "$GLOBAL_TARGET_VOICE_FILE" ]]; then
cat "$GLOBAL_TARGET_VOICE_FILE"
else
echo ""
fi
}
# Set target voice
set_target_voice() {
local voice="$1"
if [[ -z "$voice" ]]; then
echo -e "${YELLOW}Usage: learn-manager.sh set-target-voice <voice>${NC}"
exit 1
fi
mkdir -p "$PROJECT_DIR/.claude"
echo "$voice" > "$TARGET_VOICE_FILE"
echo -e "${GREEN}✓${NC} Target voice set to: $voice"
}
# Check if learning mode is enabled
is_learn_mode_enabled() {
if [[ -f "$LEARN_MODE_FILE" ]]; then
local mode=$(cat "$LEARN_MODE_FILE")
[[ "$mode" == "ON" ]]
elif [[ -f "$GLOBAL_LEARN_MODE_FILE" ]]; then
local mode=$(cat "$GLOBAL_LEARN_MODE_FILE")
[[ "$mode" == "ON" ]]
else
return 1
fi
}
# Enable learning mode
enable_learn_mode() {
mkdir -p "$PROJECT_DIR/.claude"
echo "ON" > "$LEARN_MODE_FILE"
echo -e "${GREEN}✓${NC} Language learning mode: ${GREEN}ENABLED${NC}"
echo ""
# Auto-set target voice if target language is set but voice is not
local target_lang=$(get_target_language)
local target_voice=$(get_target_voice)
local voice_was_set=false
if [[ -n "$target_lang" ]] && [[ -z "$target_voice" ]]; then
echo -e "${BLUE}ℹ${NC} Auto-configuring voice for $target_lang..."
local recommended_voice=$(get_recommended_voice_for_language "$target_lang")
if [[ -n "$recommended_voice" ]]; then
echo "$recommended_voice" > "$TARGET_VOICE_FILE"
target_voice="$recommended_voice"
echo -e "${GREEN}✓${NC} Target voice automatically set to: ${YELLOW}$recommended_voice${NC}"
# Detect provider for display
local provider=""
if [[ -f "$PROJECT_DIR/.claude/tts-provider.txt" ]]; then
provider=$(cat "$PROJECT_DIR/.claude/tts-provider.txt")
elif [[ -f "$HOME/.claude/tts-provider.txt" ]]; then
provider=$(cat "$HOME/.claude/tts-provider.txt")
else
provider="elevenlabs"
fi
echo -e " (for ${GREEN}$provider${NC} TTS)"
echo ""
voice_was_set=true
fi
fi
show_status
# Greet user with language teacher if everything is configured
if [[ -n "$target_lang" ]] && [[ -n "$target_voice" ]]; then
echo ""
local greeting=$(get_greeting_for_language "$target_lang")
echo -e "${BLUE}🎓${NC} Your language teacher says:"
# Detect provider
local provider=""
if [[ -f "$PROJECT_DIR/.claude/tts-provider.txt" ]]; then
provider=$(cat "$PROJECT_DIR/.claude/tts-provider.txt")
elif [[ -f "$HOME/.claude/tts-provider.txt" ]]; then
provider=$(cat "$HOME/.claude/tts-provider.txt")
else
provider="elevenlabs"
fi
# Check if we're using Piper and if the voice is available
if [[ "$provider" == "piper" ]]; then
# Quick check: does the voice file exist?
local voice_dir="${HOME}/.claude/piper-voices"
if [[ -f "${voice_dir}/${target_voice}.onnx" ]]; then
# Voice exists, play greeting in background
nohup "$SCRIPT_DIR/play-tts.sh" "$greeting" "$target_voice" >/dev/null 2>&1 &
else
echo -e "${YELLOW} (Voice not yet downloaded - greeting will play after first download)${NC}"
fi
else
# ElevenLabs - just play it in background
nohup "$SCRIPT_DIR/play-tts.sh" "$greeting" "$target_voice" >/dev/null 2>&1 &
fi
fi
}
# Disable learning mode
disable_learn_mode() {
mkdir -p "$PROJECT_DIR/.claude"
echo "OFF" > "$LEARN_MODE_FILE"
echo -e "${GREEN}✓${NC} Language learning mode: ${YELLOW}DISABLED${NC}"
}
# Show learning mode status
show_status() {
local main_lang=$(get_main_language)
local target_lang=$(get_target_language)
local target_voice=$(get_target_voice)
local learn_mode="OFF"
if is_learn_mode_enabled; then
learn_mode="ON"
fi
echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
echo -e "${BLUE} Language Learning Mode Status${NC}"
echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
echo ""
echo -e " ${BLUE}Learning Mode:${NC} $(if [[ "$learn_mode" == "ON" ]]; then echo -e "${GREEN}ENABLED${NC}"; else echo -e "${YELLOW}DISABLED${NC}"; fi)"
echo -e " ${BLUE}Main Language:${NC} $main_lang"
echo -e " ${BLUE}Target Language:${NC} ${target_lang:-"(not set)"}"
echo -e " ${BLUE}Target Voice:${NC} ${target_voice:-"(not set)"}"
echo ""
if [[ "$learn_mode" == "ON" ]]; then
if [[ -z "$target_lang" ]]; then
echo -e " ${YELLOW}⚠${NC} Please set a target language: ${YELLOW}/agent-vibes:target <language>${NC}"
fi
if [[ -z "$target_voice" ]]; then
echo -e " ${YELLOW}⚠${NC} Please set a target voice: ${YELLOW}/agent-vibes:target-voice <voice>${NC}"
fi
if [[ -n "$target_lang" ]] && [[ -n "$target_voice" ]]; then
echo -e " ${GREEN}✓${NC} All set! TTS will speak in both languages."
echo ""
echo -e " ${BLUE}How it works:${NC}"
echo -e " 1. First: Speak in ${BLUE}$main_lang${NC} (your current voice)"
echo -e " 2. Then: Speak in ${BLUE}$target_lang${NC} ($target_voice voice)"
fi
else
echo -e " ${BLUE}💡 Tip:${NC} Enable learning mode with: ${YELLOW}/agent-vibes:learn${NC}"
fi
echo ""
echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
}
# Main command handler
case "${1:-}" in
get-main-language)
get_main_language
;;
set-main-language)
set_main_language "$2"
;;
get-target-language)
get_target_language
;;
set-target-language)
set_target_language "$2"
;;
get-target-voice)
get_target_voice
;;
set-target-voice)
set_target_voice "$2"
;;
is-enabled)
if is_learn_mode_enabled; then
echo "ON"
exit 0
else
echo "OFF"
exit 1
fi
;;
enable)
enable_learn_mode
;;
disable)
disable_learn_mode
;;
status)
show_status
;;
*)
echo "Usage: learn-manager.sh {get-main-language|set-main-language|get-target-language|set-target-language|get-target-voice|set-target-voice|is-enabled|enable|disable|status}"
exit 1
;;
esac
Reference in New Issue Copy Permalink