agentvibes 2.13.8 → 2.14.0

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

@@ -0,0 +1,341 @@
+#!/usr/bin/env bash
+#
+# File: .claude/hooks/translate-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 Translation Manager - Auto-translate TTS to user's preferred language
+# @context Integrates with BMAD communication_language and provides manual override
+# @architecture Manages translation settings, detects BMAD config, translates text via translator.py
+# @dependencies translator.py, language-manager.sh, .bmad/core/config.yaml (optional)
+# @entrypoints Called by /agent-vibes:translate commands and play-tts.sh
+# @patterns Config cascade - manual override > BMAD config > default (no translation)
+# @related translator.py, play-tts.sh, language-manager.sh, learn-manager.sh
+
+# Only set strict mode when executed directly, not when sourced
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+    set -euo pipefail
+fi
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Use PWD for project dir when called from project context, fall back to script-relative
+if [[ -d "$PWD/.claude" ]]; then
+    PROJECT_DIR="$PWD"
+else
+    PROJECT_DIR="$SCRIPT_DIR/../.."
+fi
+
+# Configuration files
+TRANSLATE_FILE="$PROJECT_DIR/.claude/tts-translate-to.txt"
+GLOBAL_TRANSLATE_FILE="$HOME/.claude/tts-translate-to.txt"
+
+# Colors
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+RED='\033[0;31m'
+NC='\033[0m'
+
+# Supported languages (matching language-manager.sh)
+SUPPORTED_LANGUAGES="spanish french german italian portuguese chinese japanese korean russian polish dutch turkish arabic hindi swedish danish norwegian finnish czech romanian ukrainian greek bulgarian croatian slovak"
+
+# @function get_bmad_language
+# @intent Read communication_language from BMAD config
+# @why BMAD users can set their preferred language in .bmad/core/config.yaml
+# @returns Language name (lowercase) or empty if not set
+get_bmad_language() {
+    local bmad_config=""
+
+    # Search for BMAD config in project or parents
+    local search_dir="$PWD"
+    while [[ "$search_dir" != "/" ]]; do
+        if [[ -f "$search_dir/.bmad/core/config.yaml" ]]; then
+            bmad_config="$search_dir/.bmad/core/config.yaml"
+            break
+        fi
+        search_dir=$(dirname "$search_dir")
+    done
+
+    if [[ -z "$bmad_config" ]] || [[ ! -f "$bmad_config" ]]; then
+        echo ""
+        return
+    fi
+
+    # Security: Verify file ownership (should be owned by current user)
+    local owner
+    owner=$(stat -c '%u' "$bmad_config" 2>/dev/null || stat -f '%u' "$bmad_config" 2>/dev/null || echo "")
+    if [[ -n "$owner" ]] && [[ "$owner" != "$(id -u)" ]]; then
+        echo "Warning: BMAD config not owned by current user, skipping" >&2
+        echo ""
+        return
+    fi
+
+    # Extract communication_language from YAML (simple grep approach)
+    local lang
+    lang=$(grep -E "^communication_language:" "$bmad_config" 2>/dev/null | head -1 | cut -d: -f2 | tr -d ' "'"'" | tr '[:upper:]' '[:lower:]')
+
+    echo "$lang"
+}
+
+# @function get_translate_to
+# @intent Get the target language for translation
+# @why Implements priority: manual override > BMAD config > no translation
+# @returns Language name or empty if no translation
+get_translate_to() {
+    # Priority 1: Manual override
+    if [[ -f "$TRANSLATE_FILE" ]]; then
+        local manual
+        manual=$(cat "$TRANSLATE_FILE")
+        if [[ "$manual" != "off" ]] && [[ "$manual" != "auto" ]]; then
+            echo "$manual"
+            return
+        elif [[ "$manual" == "off" ]]; then
+            echo ""
+            return
+        fi
+        # If "auto", fall through to BMAD detection
+    elif [[ -f "$GLOBAL_TRANSLATE_FILE" ]]; then
+        local manual
+        manual=$(cat "$GLOBAL_TRANSLATE_FILE")
+        if [[ "$manual" != "off" ]] && [[ "$manual" != "auto" ]]; then
+            echo "$manual"
+            return
+        elif [[ "$manual" == "off" ]]; then
+            echo ""
+            return
+        fi
+    fi
+
+    # Priority 2: BMAD config
+    local bmad_lang
+    bmad_lang=$(get_bmad_language)
+    if [[ -n "$bmad_lang" ]] && [[ "$bmad_lang" != "english" ]]; then
+        echo "$bmad_lang"
+        return
+    fi
+
+    # Default: No translation
+    echo ""
+}
+
+# @function is_translation_enabled
+# @intent Check if translation should occur
+# @why Quick check for play-tts.sh to decide whether to translate
+# @returns 0 if enabled, 1 if disabled
+is_translation_enabled() {
+    local translate_to
+    translate_to=$(get_translate_to)
+    [[ -n "$translate_to" ]] && [[ "$translate_to" != "english" ]]
+}
+
+# @function translate_text
+# @intent Translate text to target language using translator.py
+# @why Central translation function for all TTS
+# @param $1 text to translate
+# @param $2 target language (optional, auto-detected if not provided)
+# @returns Translated text (or original if translation fails/disabled)
+translate_text() {
+    local text="$1"
+    local target="${2:-}"
+
+    if [[ -z "$target" ]]; then
+        target=$(get_translate_to)
+    fi
+
+    # Skip if no translation target or target is English
+    if [[ -z "$target" ]] || [[ "$target" == "english" ]]; then
+        echo "$text"
+        return
+    fi
+
+    # Call translator.py
+    local translated
+    translated=$(python3 "$SCRIPT_DIR/translator.py" "$text" "$target" 2>/dev/null) || translated="$text"
+
+    echo "$translated"
+}
+
+# @function set_translate
+# @intent Set manual translation override
+# @why Allows users to override BMAD config or force specific language
+# @param $1 language name, "auto", or "off"
+set_translate() {
+    local lang="$1"
+
+    if [[ -z "$lang" ]]; then
+        echo -e "${YELLOW}Usage: translate-manager.sh set <language|auto|off>${NC}"
+        exit 1
+    fi
+
+    lang=$(echo "$lang" | tr '[:upper:]' '[:lower:]')
+
+    mkdir -p "$PROJECT_DIR/.claude"
+
+    if [[ "$lang" == "off" ]]; then
+        echo "off" > "$TRANSLATE_FILE"
+        echo -e "${GREEN}✓${NC} Translation: ${YELLOW}DISABLED${NC}"
+        echo "  TTS will speak in English only"
+        return
+    fi
+
+    if [[ "$lang" == "auto" ]]; then
+        echo "auto" > "$TRANSLATE_FILE"
+        echo -e "${GREEN}✓${NC} Translation: ${BLUE}AUTO${NC}"
+        echo "  Will detect from BMAD config if available"
+
+        local bmad_lang
+        bmad_lang=$(get_bmad_language)
+        if [[ -n "$bmad_lang" ]]; then
+            echo -e "  ${BLUE}ℹ${NC}  BMAD config detected: $bmad_lang"
+        else
+            echo -e "  ${YELLOW}⚠${NC}  No BMAD config found, will speak English"
+        fi
+        return
+    fi
+
+    # Validate language
+    local valid=false
+    for supported in $SUPPORTED_LANGUAGES; do
+        if [[ "$lang" == "$supported" ]]; then
+            valid=true
+            break
+        fi
+    done
+
+    if [[ "$valid" != "true" ]]; then
+        echo -e "${RED}❌${NC} Language '$lang' not supported"
+        echo ""
+        echo "Supported languages:"
+        echo "$SUPPORTED_LANGUAGES" | tr ' ' '\n' | column
+        exit 1
+    fi
+
+    echo "$lang" > "$TRANSLATE_FILE"
+    echo -e "${GREEN}✓${NC} Translation set to: ${BLUE}$lang${NC}"
+    echo "  All TTS will be translated to $lang before speaking"
+
+    # Show voice recommendation
+    source "$SCRIPT_DIR/language-manager.sh" 2>/dev/null || true
+    if command -v get_voice_for_language &>/dev/null; then
+        local provider
+        provider=$(get_active_provider 2>/dev/null || echo "piper")
+        local voice
+        voice=$(get_voice_for_language "$lang" "$provider" 2>/dev/null || echo "")
+        if [[ -n "$voice" ]]; then
+            echo -e "  ${BLUE}💡${NC} Recommended voice: ${YELLOW}$voice${NC}"
+            echo -e "     Switch with: /agent-vibes:switch $voice"
+        fi
+    fi
+}
+
+# @function show_status
+# @intent Display current translation settings
+# @why Help users understand what's configured
+show_status() {
+    echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    echo -e "${BLUE}   Translation Settings${NC}"
+    echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    echo ""
+
+    # Check manual setting
+    local manual_setting=""
+    if [[ -f "$TRANSLATE_FILE" ]]; then
+        manual_setting=$(cat "$TRANSLATE_FILE")
+    elif [[ -f "$GLOBAL_TRANSLATE_FILE" ]]; then
+        manual_setting=$(cat "$GLOBAL_TRANSLATE_FILE")
+    fi
+
+    # Check BMAD config
+    local bmad_lang
+    bmad_lang=$(get_bmad_language)
+
+    # Get effective translation
+    local effective
+    effective=$(get_translate_to)
+
+    echo -e "  ${BLUE}Manual Setting:${NC}   ${manual_setting:-"(not set)"}"
+    echo -e "  ${BLUE}BMAD Language:${NC}    ${bmad_lang:-"(not detected)"}"
+    echo -e "  ${BLUE}Effective:${NC}        $(if [[ -n "$effective" ]]; then echo -e "${GREEN}$effective${NC}"; else echo -e "${YELLOW}No translation${NC}"; fi)"
+    echo ""
+
+    if [[ -n "$effective" ]]; then
+        echo -e "  ${GREEN}✓${NC} TTS will be translated to ${BLUE}$effective${NC}"
+    else
+        echo -e "  ${YELLOW}ℹ${NC}  TTS will speak in English"
+    fi
+
+    echo ""
+    echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    echo ""
+    echo -e "  ${BLUE}Commands:${NC}"
+    echo -e "    /agent-vibes:translate set <lang>  Set manual translation"
+    echo -e "    /agent-vibes:translate auto        Use BMAD config"
+    echo -e "    /agent-vibes:translate off         Disable translation"
+    echo ""
+}
+
+# Main command handler - only run if script is executed directly, not sourced
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+case "${1:-}" in
+    get-bmad-language)
+        get_bmad_language
+        ;;
+    get-translate-to)
+        get_translate_to
+        ;;
+    is-enabled)
+        if is_translation_enabled; then
+            echo "ON"
+            exit 0
+        else
+            echo "OFF"
+            exit 1
+        fi
+        ;;
+    translate)
+        if [[ -z "${2:-}" ]]; then
+            echo "Usage: translate-manager.sh translate <text> [target_lang]" >&2
+            exit 1
+        fi
+        translate_text "$2" "${3:-}"
+        ;;
+    set)
+        set_translate "${2:-}"
+        ;;
+    auto)
+        set_translate "auto"
+        ;;
+    off)
+        set_translate "off"
+        ;;
+    status)
+        show_status
+        ;;
+    *)
+        show_status
+        ;;
+esac
+fi

package/.claude/hooks/translator.py

@@ -0,0 +1,237 @@
+#!/usr/bin/env python3
+#
+# File: .claude/hooks/translator.py
+#
+# 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 Text translator for multi-language TTS and learning mode
+# @context Provides automatic translation using Google Translate via deep-translator library
+# @architecture Standalone CLI module callable from bash scripts, with library mode for Python imports
+# @dependencies deep-translator, langdetect (pip install deep-translator langdetect)
+# @entrypoints CLI: python3 translator.py <text> <target_lang>, Library: from translator import translate
+# @patterns Command pattern - supports translate, detect, and batch operations
+# @related play-tts.sh, learn-manager.sh, language-manager.sh
+#
+
+"""
+Text translation utilities for AgentVibes multi-language TTS.
+
+Provides automatic translation of TTS text to the user's preferred language,
+supporting both BMAD communication_language settings and learning mode.
+
+Usage:
+    CLI: python3 translator.py <text> <target_language>
+    Library: from translator import translate, detect_language
+"""
+
+import sys
+import os
+from typing import Optional, Tuple
+
+# Language name to ISO code mapping
+LANG_CODES = {
+    'spanish': 'es', 'español': 'es', 'es': 'es',
+    'french': 'fr', 'français': 'fr', 'fr': 'fr',
+    'german': 'de', 'deutsch': 'de', 'de': 'de',
+    'italian': 'it', 'italiano': 'it', 'it': 'it',
+    'portuguese': 'pt', 'português': 'pt', 'pt': 'pt',
+    'chinese': 'zh-CN', 'mandarin': 'zh-CN', 'zh': 'zh-CN', '中文': 'zh-CN',
+    'japanese': 'ja', '日本語': 'ja', 'ja': 'ja',
+    'korean': 'ko', '한국어': 'ko', 'ko': 'ko',
+    'russian': 'ru', 'русский': 'ru', 'ru': 'ru',
+    'polish': 'pl', 'polski': 'pl', 'pl': 'pl',
+    'dutch': 'nl', 'nederlands': 'nl', 'nl': 'nl',
+    'turkish': 'tr', 'türkçe': 'tr', 'tr': 'tr',
+    'arabic': 'ar', 'العربية': 'ar', 'ar': 'ar',
+    'hindi': 'hi', 'हिन्दी': 'hi', 'hi': 'hi',
+    'swedish': 'sv', 'svenska': 'sv', 'sv': 'sv',
+    'danish': 'da', 'dansk': 'da', 'da': 'da',
+    'norwegian': 'no', 'norsk': 'no', 'no': 'no',
+    'finnish': 'fi', 'suomi': 'fi', 'fi': 'fi',
+    'czech': 'cs', 'čeština': 'cs', 'cs': 'cs',
+    'romanian': 'ro', 'română': 'ro', 'ro': 'ro',
+    'ukrainian': 'uk', 'українська': 'uk', 'uk': 'uk',
+    'greek': 'el', 'ελληνικά': 'el', 'el': 'el',
+    'bulgarian': 'bg', 'български': 'bg', 'bg': 'bg',
+    'croatian': 'hr', 'hrvatski': 'hr', 'hr': 'hr',
+    'slovak': 'sk', 'slovenčina': 'sk', 'sk': 'sk',
+    'english': 'en', 'en': 'en',
+}
+
+
+def get_lang_code(language: str) -> str:
+    """
+    Convert language name to ISO code.
+
+    Args:
+        language: Language name or code (e.g., 'spanish', 'es', 'español')
+
+    Returns:
+        ISO language code (e.g., 'es')
+    """
+    lang_lower = language.lower().strip()
+    return LANG_CODES.get(lang_lower, lang_lower)
+
+
+def detect_language(text: str) -> Optional[str]:
+    """
+    Detect the language of given text.
+
+    Args:
+        text: Text to analyze
+
+    Returns:
+        Language code (e.g., 'es', 'fr', 'en') or None if detection fails
+    """
+    if not text or len(text.strip()) < 3:
+        return None
+
+    try:
+        from langdetect import detect, LangDetectException
+        return detect(text)
+    except ImportError:
+        print("Warning: langdetect not installed. Run: pip install langdetect", file=sys.stderr)
+        return None
+    except Exception:
+        return None
+
+
+def translate(text: str, target_lang: str, source_lang: str = 'en') -> Tuple[str, bool]:
+    """
+    Translate text to target language.
+
+    Args:
+        text: Text to translate
+        target_lang: Target language (name or code)
+        source_lang: Source language (default: 'en')
+
+    Returns:
+        Tuple of (translated_text, success)
+    """
+    if not text or not text.strip():
+        return text, False
+
+    # Convert language names to codes
+    target_code = get_lang_code(target_lang)
+    source_code = get_lang_code(source_lang)
+
+    # Skip if source and target are the same
+    if target_code == source_code:
+        return text, False
+
+    # Skip if target is English and source is also English
+    if target_code == 'en' and source_code == 'en':
+        return text, False
+
+    try:
+        from deep_translator import GoogleTranslator
+
+        translator = GoogleTranslator(source=source_code, target=target_code)
+        translated = translator.translate(text)
+
+        if translated:
+            return translated, True
+        return text, False
+
+    except ImportError:
+        print("Error: deep-translator not installed. Run: pip install deep-translator", file=sys.stderr)
+        return text, False
+    except Exception as e:
+        print(f"Translation error: {e}", file=sys.stderr)
+        return text, False
+
+
+def translate_auto(text: str, target_lang: str) -> Tuple[str, bool, Optional[str]]:
+    """
+    Translate text to target language with auto-detection of source language.
+
+    Args:
+        text: Text to translate
+        target_lang: Target language (name or code)
+
+    Returns:
+        Tuple of (translated_text, success, detected_source_lang)
+    """
+    if not text or not text.strip():
+        return text, False, None
+
+    # Detect source language
+    detected = detect_language(text)
+
+    # Convert target to code
+    target_code = get_lang_code(target_lang)
+
+    # Skip if detected language matches target
+    if detected and detected == target_code:
+        return text, False, detected
+
+    # Translate
+    translated, success = translate(text, target_lang, source_lang=detected or 'en')
+    return translated, success, detected
+
+
+def main():
+    """CLI entry point for translator."""
+    if len(sys.argv) < 3:
+        print("Usage: translator.py <text> <target_language> [source_language]", file=sys.stderr)
+        print("       translator.py detect <text>", file=sys.stderr)
+        print("", file=sys.stderr)
+        print("Examples:", file=sys.stderr)
+        print("  translator.py 'Hello world' spanish", file=sys.stderr)
+        print("  translator.py 'Hello world' es en", file=sys.stderr)
+        print("  translator.py detect 'Hola mundo'", file=sys.stderr)
+        sys.exit(1)
+
+    command = sys.argv[1]
+
+    # Detection mode
+    if command == 'detect':
+        if len(sys.argv) < 3:
+            print("Usage: translator.py detect <text>", file=sys.stderr)
+            sys.exit(1)
+        text = sys.argv[2]
+        detected = detect_language(text)
+        if detected:
+            print(detected)
+        else:
+            print("unknown")
+        sys.exit(0)
+
+    # Translation mode
+    text = sys.argv[1]
+    target_lang = sys.argv[2]
+    source_lang = sys.argv[3] if len(sys.argv) > 3 else 'en'
+
+    translated, success = translate(text, target_lang, source_lang)
+
+    # Output the result (for shell script consumption)
+    print(translated)
+
+    # Exit with appropriate code
+    sys.exit(0 if success else 1)
+
+
+if __name__ == '__main__':
+    main()

package/README.md

@@ -11,7 +11,7 @@
 [![Publish](https://github.com/paulpreibisch/AgentVibes/actions/workflows/publish.yml/badge.svg)](https://github.com/paulpreibisch/AgentVibes/actions/workflows/publish.yml)
 [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 
-**Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v2.13.8
+**Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v2.14.0
 
 ---
 
@@ -94,16 +94,17 @@ Whether you're coding in Claude Code, chatting in Claude Desktop, or using Warp
 
 ## 📰 Latest Release
 
-**[v2.13.7 - Voice Intros & PR Workflow](https://github.com/paulpreibisch/AgentVibes/releases/tag/v2.13.8)** 🎉
+**[v2.14.0 - Auto-Translation for BMAD & Learning Mode](https://github.com/paulpreibisch/AgentVibes/releases/tag/v2.14.0)** 🎉
 
-AgentVibes v2.13.7 adds voice map with intro messages for BMAD party mode and improves voice assignments for better persona fit.
+AgentVibes v2.14.0 introduces automatic translation for TTS output (Issues #50 and #51). When AgentVibes speaks acknowledgments like "Starting the build" or completions like "All tests passed!", this text is normally in English. Now, BMAD users who set `communication_language: Spanish` in `.bmad/core/config.yaml` will hear these spoken messages automatically translated to Spanish - matching their project's communication preference. This version also updates our Language Learning Mode feature to utilize Google Deep Translate, reducing token usage (Claude no longer needs to do the translation! Google now does it for free!).
 
 **Key Highlights:**
-- 🎤 **Voice Map with Intros** - Default BMAD voice assignments now include intro messages for party mode
-- 🔄 **Voice Swap** - bmad-master and pm (John) voices swapped for better persona fit
-- 📋 **PR Workflow Rules** - Added CLAUDE.md guidelines for safer PR workflows
-- ✅ **110/110 Tests Passing** - All functionality verified and working
-- 🔄 **Zero Breaking Changes** - Fully backward compatible with v2.13.6
+- 🌐 **BMAD Multi-Language TTS** - Auto-detect `communication_language` from BMAD config and translate TTS
+- 🎓 **Learning Mode Auto-Translation** - Hear English + auto-translated target language (Google does it free!)
+- 🔄 **Translation Manager** - New `/agent-vibes:translate` command for manual control
+- 🐍 **translator.py** - Core translation engine using deep-translator (Google Translate)
+- ✅ **140 Tests Passing** - 18 new translation tests + all existing tests
+- 🔄 **Zero Breaking Changes** - Fully backward compatible with v2.13.9
 
 💡 **Tip:** If `npx agentvibes` shows an older version or missing commands, clear your npm cache: `npm cache clean --force && npx agentvibes@latest --help`