agentvibes 5.2.0 → 5.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (49) hide show
  1. package/.claude/config/audio-effects.cfg +1 -1
  2. package/.claude/hooks/audio-cache-utils.sh +246 -246
  3. package/.claude/hooks/background-music-manager.sh +404 -404
  4. package/.claude/hooks/bmad-speak-enhanced.sh +165 -165
  5. package/.claude/hooks/bmad-speak.sh +290 -290
  6. package/.claude/hooks/bmad-tts-injector.sh +568 -568
  7. package/.claude/hooks/bmad-voice-manager.sh +928 -928
  8. package/.claude/hooks/clawdbot-receiver-SECURE.sh +129 -129
  9. package/.claude/hooks/clawdbot-receiver.sh +107 -107
  10. package/.claude/hooks/clean-audio-cache.sh +22 -22
  11. package/.claude/hooks/cleanup-cache.sh +106 -106
  12. package/.claude/hooks/configure-rdp-mode.sh +137 -137
  13. package/.claude/hooks/download-extra-voices.sh +244 -244
  14. package/.claude/hooks/effects-manager.sh +268 -268
  15. package/.claude/hooks/github-star-reminder.sh +154 -154
  16. package/.claude/hooks/language-manager.sh +362 -362
  17. package/.claude/hooks/learn-manager.sh +492 -492
  18. package/.claude/hooks/macos-voice-manager.sh +205 -205
  19. package/.claude/hooks/migrate-background-music.sh +125 -125
  20. package/.claude/hooks/migrate-to-agentvibes.sh +161 -161
  21. package/.claude/hooks/optimize-background-music.sh +87 -87
  22. package/.claude/hooks/path-resolver.sh +60 -60
  23. package/.claude/hooks/personality-manager.sh +448 -448
  24. package/.claude/hooks/piper-installer.sh +292 -292
  25. package/.claude/hooks/piper-multispeaker-registry.sh +171 -171
  26. package/.claude/hooks/play-tts-enhanced.sh +105 -105
  27. package/.claude/hooks/play-tts-termux-ssh.sh +169 -169
  28. package/.claude/hooks/play-tts.sh +14 -5
  29. package/.claude/hooks/prepare-release.sh +54 -54
  30. package/.claude/hooks/provider-commands.sh +617 -617
  31. package/.claude/hooks/provider-manager.sh +399 -399
  32. package/.claude/hooks/replay-target-audio.sh +95 -95
  33. package/.claude/hooks/sentiment-manager.sh +201 -201
  34. package/.claude/hooks/speed-manager.sh +291 -291
  35. package/.claude/hooks/stop-tts.sh +84 -84
  36. package/.claude/hooks/termux-installer.sh +261 -261
  37. package/.claude/hooks/translate-manager.sh +341 -341
  38. package/.claude/hooks/tts-queue-worker.sh +145 -145
  39. package/.claude/hooks/tts-queue.sh +165 -165
  40. package/.claude/hooks/voice-manager.sh +552 -548
  41. package/.claude/hooks-windows/play-tts.ps1 +2 -2
  42. package/README.md +11 -2
  43. package/RELEASE_NOTES.md +38 -0
  44. package/bin/mcp-server.sh +206 -206
  45. package/mcp-server/server.py +35 -6
  46. package/package.json +1 -1
  47. package/src/console/tabs/setup-tab.js +59 -23
  48. package/src/installer.js +79 -213
  49. package/src/services/llm-provider-service.js +126 -75
@@ -1,341 +1,341 @@
1
- #!/usr/bin/env bash
2
- #
3
- # File: .claude/hooks/translate-manager.sh
4
- #
5
- # AgentVibes - Finally, your AI Agents can Talk Back! Text-to-Speech WITH personality for AI Assistants!
6
- # Website: https://agentvibes.org
7
- # Repository: https://github.com/paulpreibisch/AgentVibes
8
- #
9
- # Co-created by Paul Preibisch with Claude AI
10
- # Copyright (c) 2025 Paul Preibisch
11
- #
12
- # Licensed under the Apache License, Version 2.0 (the "License");
13
- # you may not use this file except in compliance with the License.
14
- # You may obtain a copy of the License at
15
- #
16
- # http://www.apache.org/licenses/LICENSE-2.0
17
- #
18
- # Unless required by applicable law or agreed to in writing, software
19
- # distributed under the License is distributed on an "AS IS" BASIS,
20
- # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
21
- # See the License for the specific language governing permissions and
22
- # limitations under the License.
23
- #
24
- # DISCLAIMER: This software is provided "AS IS", WITHOUT WARRANTY OF ANY KIND,
25
- # express or implied. Use at your own risk. See the Apache License for details.
26
- #
27
- # ---
28
- #
29
- # @fileoverview Translation Manager - Auto-translate TTS to user's preferred language
30
- # @context Integrates with BMAD communication_language and provides manual override
31
- # @architecture Manages translation settings, detects BMAD config, translates text via translator.py
32
- # @dependencies translator.py, language-manager.sh, .bmad/core/config.yaml (optional)
33
- # @entrypoints Called by /agent-vibes:translate commands and play-tts.sh
34
- # @patterns Config cascade - manual override > BMAD config > default (no translation)
35
- # @related translator.py, play-tts.sh, language-manager.sh, learn-manager.sh
36
-
37
- # Only set strict mode when executed directly, not when sourced
38
- if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
39
- set -euo pipefail
40
- fi
41
-
42
- SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
43
-
44
- # Use PWD for project dir when called from project context, fall back to script-relative
45
- if [[ -d "$PWD/.claude" ]]; then
46
- PROJECT_DIR="$PWD"
47
- else
48
- PROJECT_DIR="$SCRIPT_DIR/../.."
49
- fi
50
-
51
- # Configuration files
52
- TRANSLATE_FILE="$PROJECT_DIR/.claude/tts-translate-to.txt"
53
- GLOBAL_TRANSLATE_FILE="$HOME/.claude/tts-translate-to.txt"
54
-
55
- # Colors
56
- GREEN='\033[0;32m'
57
- YELLOW='\033[1;33m'
58
- BLUE='\033[0;34m'
59
- RED='\033[0;31m'
60
- NC='\033[0m'
61
-
62
- # Supported languages (matching language-manager.sh)
63
- 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"
64
-
65
- # @function get_bmad_language
66
- # @intent Read communication_language from BMAD config
67
- # @why BMAD users can set their preferred language in .bmad/core/config.yaml
68
- # @returns Language name (lowercase) or empty if not set
69
- get_bmad_language() {
70
- local bmad_config=""
71
-
72
- # Search for BMAD config in project or parents
73
- local search_dir="$PWD"
74
- while [[ "$search_dir" != "/" ]]; do
75
- if [[ -f "$search_dir/.bmad/core/config.yaml" ]]; then
76
- bmad_config="$search_dir/.bmad/core/config.yaml"
77
- break
78
- fi
79
- search_dir=$(dirname "$search_dir")
80
- done
81
-
82
- if [[ -z "$bmad_config" ]] || [[ ! -f "$bmad_config" ]]; then
83
- echo ""
84
- return
85
- fi
86
-
87
- # Security: Verify file ownership (should be owned by current user)
88
- local owner
89
- owner=$(stat -c '%u' "$bmad_config" 2>/dev/null || stat -f '%u' "$bmad_config" 2>/dev/null || echo "")
90
- if [[ -n "$owner" ]] && [[ "$owner" != "$(id -u)" ]]; then
91
- echo "Warning: BMAD config not owned by current user, skipping" >&2
92
- echo ""
93
- return
94
- fi
95
-
96
- # Extract communication_language from YAML (simple grep approach)
97
- local lang
98
- lang=$(grep -E "^communication_language:" "$bmad_config" 2>/dev/null | head -1 | cut -d: -f2 | tr -d ' "'"'" | tr '[:upper:]' '[:lower:]')
99
-
100
- echo "$lang"
101
- }
102
-
103
- # @function get_translate_to
104
- # @intent Get the target language for translation
105
- # @why Implements priority: manual override > BMAD config > no translation
106
- # @returns Language name or empty if no translation
107
- get_translate_to() {
108
- # Priority 1: Manual override
109
- if [[ -f "$TRANSLATE_FILE" ]]; then
110
- local manual
111
- manual=$(cat "$TRANSLATE_FILE")
112
- if [[ "$manual" != "off" ]] && [[ "$manual" != "auto" ]]; then
113
- echo "$manual"
114
- return
115
- elif [[ "$manual" == "off" ]]; then
116
- echo ""
117
- return
118
- fi
119
- # If "auto", fall through to BMAD detection
120
- elif [[ -f "$GLOBAL_TRANSLATE_FILE" ]]; then
121
- local manual
122
- manual=$(cat "$GLOBAL_TRANSLATE_FILE")
123
- if [[ "$manual" != "off" ]] && [[ "$manual" != "auto" ]]; then
124
- echo "$manual"
125
- return
126
- elif [[ "$manual" == "off" ]]; then
127
- echo ""
128
- return
129
- fi
130
- fi
131
-
132
- # Priority 2: BMAD config
133
- local bmad_lang
134
- bmad_lang=$(get_bmad_language)
135
- if [[ -n "$bmad_lang" ]] && [[ "$bmad_lang" != "english" ]]; then
136
- echo "$bmad_lang"
137
- return
138
- fi
139
-
140
- # Default: No translation
141
- echo ""
142
- }
143
-
144
- # @function is_translation_enabled
145
- # @intent Check if translation should occur
146
- # @why Quick check for play-tts.sh to decide whether to translate
147
- # @returns 0 if enabled, 1 if disabled
148
- is_translation_enabled() {
149
- local translate_to
150
- translate_to=$(get_translate_to)
151
- [[ -n "$translate_to" ]] && [[ "$translate_to" != "english" ]]
152
- }
153
-
154
- # @function translate_text
155
- # @intent Translate text to target language using translator.py
156
- # @why Central translation function for all TTS
157
- # @param $1 text to translate
158
- # @param $2 target language (optional, auto-detected if not provided)
159
- # @returns Translated text (or original if translation fails/disabled)
160
- translate_text() {
161
- local text="$1"
162
- local target="${2:-}"
163
-
164
- if [[ -z "$target" ]]; then
165
- target=$(get_translate_to)
166
- fi
167
-
168
- # Skip if no translation target or target is English
169
- if [[ -z "$target" ]] || [[ "$target" == "english" ]]; then
170
- echo "$text"
171
- return
172
- fi
173
-
174
- # Call translator.py
175
- local translated
176
- translated=$(python3 "$SCRIPT_DIR/translator.py" "$text" "$target" 2>/dev/null) || translated="$text"
177
-
178
- echo "$translated"
179
- }
180
-
181
- # @function set_translate
182
- # @intent Set manual translation override
183
- # @why Allows users to override BMAD config or force specific language
184
- # @param $1 language name, "auto", or "off"
185
- set_translate() {
186
- local lang="$1"
187
-
188
- if [[ -z "$lang" ]]; then
189
- echo -e "${YELLOW}Usage: translate-manager.sh set <language|auto|off>${NC}"
190
- exit 1
191
- fi
192
-
193
- lang=$(echo "$lang" | tr '[:upper:]' '[:lower:]')
194
-
195
- mkdir -p "$PROJECT_DIR/.claude"
196
-
197
- if [[ "$lang" == "off" ]]; then
198
- echo "off" > "$TRANSLATE_FILE"
199
- echo -e "${GREEN}✓${NC} Translation: ${YELLOW}DISABLED${NC}"
200
- echo " TTS will speak in English only"
201
- return
202
- fi
203
-
204
- if [[ "$lang" == "auto" ]]; then
205
- echo "auto" > "$TRANSLATE_FILE"
206
- echo -e "${GREEN}✓${NC} Translation: ${BLUE}AUTO${NC}"
207
- echo " Will detect from BMAD config if available"
208
-
209
- local bmad_lang
210
- bmad_lang=$(get_bmad_language)
211
- if [[ -n "$bmad_lang" ]]; then
212
- echo -e " ${BLUE}ℹ${NC} BMAD config detected: $bmad_lang"
213
- else
214
- echo -e " ${YELLOW}⚠${NC} No BMAD config found, will speak English"
215
- fi
216
- return
217
- fi
218
-
219
- # Validate language
220
- local valid=false
221
- for supported in $SUPPORTED_LANGUAGES; do
222
- if [[ "$lang" == "$supported" ]]; then
223
- valid=true
224
- break
225
- fi
226
- done
227
-
228
- if [[ "$valid" != "true" ]]; then
229
- echo -e "${RED}❌${NC} Language '$lang' not supported"
230
- echo ""
231
- echo "Supported languages:"
232
- echo "$SUPPORTED_LANGUAGES" | tr ' ' '\n' | column
233
- exit 1
234
- fi
235
-
236
- echo "$lang" > "$TRANSLATE_FILE"
237
- echo -e "${GREEN}✓${NC} Translation set to: ${BLUE}$lang${NC}"
238
- echo " All TTS will be translated to $lang before speaking"
239
-
240
- # Show voice recommendation
241
- source "$SCRIPT_DIR/language-manager.sh" 2>/dev/null || true
242
- if command -v get_voice_for_language &>/dev/null; then
243
- local provider
244
- provider=$(get_active_provider 2>/dev/null || echo "piper")
245
- local voice
246
- voice=$(get_voice_for_language "$lang" "$provider" 2>/dev/null || echo "")
247
- if [[ -n "$voice" ]]; then
248
- echo -e " ${BLUE}💡${NC} Recommended voice: ${YELLOW}$voice${NC}"
249
- echo -e " Switch with: /agent-vibes:switch $voice"
250
- fi
251
- fi
252
- }
253
-
254
- # @function show_status
255
- # @intent Display current translation settings
256
- # @why Help users understand what's configured
257
- show_status() {
258
- echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
259
- echo -e "${BLUE} Translation Settings${NC}"
260
- echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
261
- echo ""
262
-
263
- # Check manual setting
264
- local manual_setting=""
265
- if [[ -f "$TRANSLATE_FILE" ]]; then
266
- manual_setting=$(cat "$TRANSLATE_FILE")
267
- elif [[ -f "$GLOBAL_TRANSLATE_FILE" ]]; then
268
- manual_setting=$(cat "$GLOBAL_TRANSLATE_FILE")
269
- fi
270
-
271
- # Check BMAD config
272
- local bmad_lang
273
- bmad_lang=$(get_bmad_language)
274
-
275
- # Get effective translation
276
- local effective
277
- effective=$(get_translate_to)
278
-
279
- echo -e " ${BLUE}Manual Setting:${NC} ${manual_setting:-"(not set)"}"
280
- echo -e " ${BLUE}BMAD Language:${NC} ${bmad_lang:-"(not detected)"}"
281
- echo -e " ${BLUE}Effective:${NC} $(if [[ -n "$effective" ]]; then echo -e "${GREEN}$effective${NC}"; else echo -e "${YELLOW}No translation${NC}"; fi)"
282
- echo ""
283
-
284
- if [[ -n "$effective" ]]; then
285
- echo -e " ${GREEN}✓${NC} TTS will be translated to ${BLUE}$effective${NC}"
286
- else
287
- echo -e " ${YELLOW}ℹ${NC} TTS will speak in English"
288
- fi
289
-
290
- echo ""
291
- echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
292
- echo ""
293
- echo -e " ${BLUE}Commands:${NC}"
294
- echo -e " /agent-vibes:translate set <lang> Set manual translation"
295
- echo -e " /agent-vibes:translate auto Use BMAD config"
296
- echo -e " /agent-vibes:translate off Disable translation"
297
- echo ""
298
- }
299
-
300
- # Main command handler - only run if script is executed directly, not sourced
301
- if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
302
- case "${1:-}" in
303
- get-bmad-language)
304
- get_bmad_language
305
- ;;
306
- get-translate-to)
307
- get_translate_to
308
- ;;
309
- is-enabled)
310
- if is_translation_enabled; then
311
- echo "ON"
312
- exit 0
313
- else
314
- echo "OFF"
315
- exit 1
316
- fi
317
- ;;
318
- translate)
319
- if [[ -z "${2:-}" ]]; then
320
- echo "Usage: translate-manager.sh translate <text> [target_lang]" >&2
321
- exit 1
322
- fi
323
- translate_text "$2" "${3:-}"
324
- ;;
325
- set)
326
- set_translate "${2:-}"
327
- ;;
328
- auto)
329
- set_translate "auto"
330
- ;;
331
- off)
332
- set_translate "off"
333
- ;;
334
- status)
335
- show_status
336
- ;;
337
- *)
338
- show_status
339
- ;;
340
- esac
341
- fi
1
+ #!/usr/bin/env bash
2
+ #
3
+ # File: .claude/hooks/translate-manager.sh
4
+ #
5
+ # AgentVibes - Finally, your AI Agents can Talk Back! Text-to-Speech WITH personality for AI Assistants!
6
+ # Website: https://agentvibes.org
7
+ # Repository: https://github.com/paulpreibisch/AgentVibes
8
+ #
9
+ # Co-created by Paul Preibisch with Claude AI
10
+ # Copyright (c) 2025 Paul Preibisch
11
+ #
12
+ # Licensed under the Apache License, Version 2.0 (the "License");
13
+ # you may not use this file except in compliance with the License.
14
+ # You may obtain a copy of the License at
15
+ #
16
+ # http://www.apache.org/licenses/LICENSE-2.0
17
+ #
18
+ # Unless required by applicable law or agreed to in writing, software
19
+ # distributed under the License is distributed on an "AS IS" BASIS,
20
+ # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
21
+ # See the License for the specific language governing permissions and
22
+ # limitations under the License.
23
+ #
24
+ # DISCLAIMER: This software is provided "AS IS", WITHOUT WARRANTY OF ANY KIND,
25
+ # express or implied. Use at your own risk. See the Apache License for details.
26
+ #
27
+ # ---
28
+ #
29
+ # @fileoverview Translation Manager - Auto-translate TTS to user's preferred language
30
+ # @context Integrates with BMAD communication_language and provides manual override
31
+ # @architecture Manages translation settings, detects BMAD config, translates text via translator.py
32
+ # @dependencies translator.py, language-manager.sh, .bmad/core/config.yaml (optional)
33
+ # @entrypoints Called by /agent-vibes:translate commands and play-tts.sh
34
+ # @patterns Config cascade - manual override > BMAD config > default (no translation)
35
+ # @related translator.py, play-tts.sh, language-manager.sh, learn-manager.sh
36
+
37
+ # Only set strict mode when executed directly, not when sourced
38
+ if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
39
+ set -euo pipefail
40
+ fi
41
+
42
+ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
43
+
44
+ # Use PWD for project dir when called from project context, fall back to script-relative
45
+ if [[ -d "$PWD/.claude" ]]; then
46
+ PROJECT_DIR="$PWD"
47
+ else
48
+ PROJECT_DIR="$SCRIPT_DIR/../.."
49
+ fi
50
+
51
+ # Configuration files
52
+ TRANSLATE_FILE="$PROJECT_DIR/.claude/tts-translate-to.txt"
53
+ GLOBAL_TRANSLATE_FILE="$HOME/.claude/tts-translate-to.txt"
54
+
55
+ # Colors
56
+ GREEN='\033[0;32m'
57
+ YELLOW='\033[1;33m'
58
+ BLUE='\033[0;34m'
59
+ RED='\033[0;31m'
60
+ NC='\033[0m'
61
+
62
+ # Supported languages (matching language-manager.sh)
63
+ 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"
64
+
65
+ # @function get_bmad_language
66
+ # @intent Read communication_language from BMAD config
67
+ # @why BMAD users can set their preferred language in .bmad/core/config.yaml
68
+ # @returns Language name (lowercase) or empty if not set
69
+ get_bmad_language() {
70
+ local bmad_config=""
71
+
72
+ # Search for BMAD config in project or parents
73
+ local search_dir="$PWD"
74
+ while [[ "$search_dir" != "/" ]]; do
75
+ if [[ -f "$search_dir/.bmad/core/config.yaml" ]]; then
76
+ bmad_config="$search_dir/.bmad/core/config.yaml"
77
+ break
78
+ fi
79
+ search_dir=$(dirname "$search_dir")
80
+ done
81
+
82
+ if [[ -z "$bmad_config" ]] || [[ ! -f "$bmad_config" ]]; then
83
+ echo ""
84
+ return
85
+ fi
86
+
87
+ # Security: Verify file ownership (should be owned by current user)
88
+ local owner
89
+ owner=$(stat -c '%u' "$bmad_config" 2>/dev/null || stat -f '%u' "$bmad_config" 2>/dev/null || echo "")
90
+ if [[ -n "$owner" ]] && [[ "$owner" != "$(id -u)" ]]; then
91
+ echo "Warning: BMAD config not owned by current user, skipping" >&2
92
+ echo ""
93
+ return
94
+ fi
95
+
96
+ # Extract communication_language from YAML (simple grep approach)
97
+ local lang
98
+ lang=$(grep -E "^communication_language:" "$bmad_config" 2>/dev/null | head -1 | cut -d: -f2 | tr -d ' "'"'" | tr '[:upper:]' '[:lower:]')
99
+
100
+ echo "$lang"
101
+ }
102
+
103
+ # @function get_translate_to
104
+ # @intent Get the target language for translation
105
+ # @why Implements priority: manual override > BMAD config > no translation
106
+ # @returns Language name or empty if no translation
107
+ get_translate_to() {
108
+ # Priority 1: Manual override
109
+ if [[ -f "$TRANSLATE_FILE" ]]; then
110
+ local manual
111
+ manual=$(cat "$TRANSLATE_FILE")
112
+ if [[ "$manual" != "off" ]] && [[ "$manual" != "auto" ]]; then
113
+ echo "$manual"
114
+ return
115
+ elif [[ "$manual" == "off" ]]; then
116
+ echo ""
117
+ return
118
+ fi
119
+ # If "auto", fall through to BMAD detection
120
+ elif [[ -f "$GLOBAL_TRANSLATE_FILE" ]]; then
121
+ local manual
122
+ manual=$(cat "$GLOBAL_TRANSLATE_FILE")
123
+ if [[ "$manual" != "off" ]] && [[ "$manual" != "auto" ]]; then
124
+ echo "$manual"
125
+ return
126
+ elif [[ "$manual" == "off" ]]; then
127
+ echo ""
128
+ return
129
+ fi
130
+ fi
131
+
132
+ # Priority 2: BMAD config
133
+ local bmad_lang
134
+ bmad_lang=$(get_bmad_language)
135
+ if [[ -n "$bmad_lang" ]] && [[ "$bmad_lang" != "english" ]]; then
136
+ echo "$bmad_lang"
137
+ return
138
+ fi
139
+
140
+ # Default: No translation
141
+ echo ""
142
+ }
143
+
144
+ # @function is_translation_enabled
145
+ # @intent Check if translation should occur
146
+ # @why Quick check for play-tts.sh to decide whether to translate
147
+ # @returns 0 if enabled, 1 if disabled
148
+ is_translation_enabled() {
149
+ local translate_to
150
+ translate_to=$(get_translate_to)
151
+ [[ -n "$translate_to" ]] && [[ "$translate_to" != "english" ]]
152
+ }
153
+
154
+ # @function translate_text
155
+ # @intent Translate text to target language using translator.py
156
+ # @why Central translation function for all TTS
157
+ # @param $1 text to translate
158
+ # @param $2 target language (optional, auto-detected if not provided)
159
+ # @returns Translated text (or original if translation fails/disabled)
160
+ translate_text() {
161
+ local text="$1"
162
+ local target="${2:-}"
163
+
164
+ if [[ -z "$target" ]]; then
165
+ target=$(get_translate_to)
166
+ fi
167
+
168
+ # Skip if no translation target or target is English
169
+ if [[ -z "$target" ]] || [[ "$target" == "english" ]]; then
170
+ echo "$text"
171
+ return
172
+ fi
173
+
174
+ # Call translator.py
175
+ local translated
176
+ translated=$(python3 "$SCRIPT_DIR/translator.py" "$text" "$target" 2>/dev/null) || translated="$text"
177
+
178
+ echo "$translated"
179
+ }
180
+
181
+ # @function set_translate
182
+ # @intent Set manual translation override
183
+ # @why Allows users to override BMAD config or force specific language
184
+ # @param $1 language name, "auto", or "off"
185
+ set_translate() {
186
+ local lang="$1"
187
+
188
+ if [[ -z "$lang" ]]; then
189
+ echo -e "${YELLOW}Usage: translate-manager.sh set <language|auto|off>${NC}"
190
+ exit 1
191
+ fi
192
+
193
+ lang=$(echo "$lang" | tr '[:upper:]' '[:lower:]')
194
+
195
+ mkdir -p "$PROJECT_DIR/.claude"
196
+
197
+ if [[ "$lang" == "off" ]]; then
198
+ echo "off" > "$TRANSLATE_FILE"
199
+ echo -e "${GREEN}✓${NC} Translation: ${YELLOW}DISABLED${NC}"
200
+ echo " TTS will speak in English only"
201
+ return
202
+ fi
203
+
204
+ if [[ "$lang" == "auto" ]]; then
205
+ echo "auto" > "$TRANSLATE_FILE"
206
+ echo -e "${GREEN}✓${NC} Translation: ${BLUE}AUTO${NC}"
207
+ echo " Will detect from BMAD config if available"
208
+
209
+ local bmad_lang
210
+ bmad_lang=$(get_bmad_language)
211
+ if [[ -n "$bmad_lang" ]]; then
212
+ echo -e " ${BLUE}ℹ${NC} BMAD config detected: $bmad_lang"
213
+ else
214
+ echo -e " ${YELLOW}⚠${NC} No BMAD config found, will speak English"
215
+ fi
216
+ return
217
+ fi
218
+
219
+ # Validate language
220
+ local valid=false
221
+ for supported in $SUPPORTED_LANGUAGES; do
222
+ if [[ "$lang" == "$supported" ]]; then
223
+ valid=true
224
+ break
225
+ fi
226
+ done
227
+
228
+ if [[ "$valid" != "true" ]]; then
229
+ echo -e "${RED}❌${NC} Language '$lang' not supported"
230
+ echo ""
231
+ echo "Supported languages:"
232
+ echo "$SUPPORTED_LANGUAGES" | tr ' ' '\n' | column
233
+ exit 1
234
+ fi
235
+
236
+ echo "$lang" > "$TRANSLATE_FILE"
237
+ echo -e "${GREEN}✓${NC} Translation set to: ${BLUE}$lang${NC}"
238
+ echo " All TTS will be translated to $lang before speaking"
239
+
240
+ # Show voice recommendation
241
+ source "$SCRIPT_DIR/language-manager.sh" 2>/dev/null || true
242
+ if command -v get_voice_for_language &>/dev/null; then
243
+ local provider
244
+ provider=$(get_active_provider 2>/dev/null || echo "piper")
245
+ local voice
246
+ voice=$(get_voice_for_language "$lang" "$provider" 2>/dev/null || echo "")
247
+ if [[ -n "$voice" ]]; then
248
+ echo -e " ${BLUE}💡${NC} Recommended voice: ${YELLOW}$voice${NC}"
249
+ echo -e " Switch with: /agent-vibes:switch $voice"
250
+ fi
251
+ fi
252
+ }
253
+
254
+ # @function show_status
255
+ # @intent Display current translation settings
256
+ # @why Help users understand what's configured
257
+ show_status() {
258
+ echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
259
+ echo -e "${BLUE} Translation Settings${NC}"
260
+ echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
261
+ echo ""
262
+
263
+ # Check manual setting
264
+ local manual_setting=""
265
+ if [[ -f "$TRANSLATE_FILE" ]]; then
266
+ manual_setting=$(cat "$TRANSLATE_FILE")
267
+ elif [[ -f "$GLOBAL_TRANSLATE_FILE" ]]; then
268
+ manual_setting=$(cat "$GLOBAL_TRANSLATE_FILE")
269
+ fi
270
+
271
+ # Check BMAD config
272
+ local bmad_lang
273
+ bmad_lang=$(get_bmad_language)
274
+
275
+ # Get effective translation
276
+ local effective
277
+ effective=$(get_translate_to)
278
+
279
+ echo -e " ${BLUE}Manual Setting:${NC} ${manual_setting:-"(not set)"}"
280
+ echo -e " ${BLUE}BMAD Language:${NC} ${bmad_lang:-"(not detected)"}"
281
+ echo -e " ${BLUE}Effective:${NC} $(if [[ -n "$effective" ]]; then echo -e "${GREEN}$effective${NC}"; else echo -e "${YELLOW}No translation${NC}"; fi)"
282
+ echo ""
283
+
284
+ if [[ -n "$effective" ]]; then
285
+ echo -e " ${GREEN}✓${NC} TTS will be translated to ${BLUE}$effective${NC}"
286
+ else
287
+ echo -e " ${YELLOW}ℹ${NC} TTS will speak in English"
288
+ fi
289
+
290
+ echo ""
291
+ echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
292
+ echo ""
293
+ echo -e " ${BLUE}Commands:${NC}"
294
+ echo -e " /agent-vibes:translate set <lang> Set manual translation"
295
+ echo -e " /agent-vibes:translate auto Use BMAD config"
296
+ echo -e " /agent-vibes:translate off Disable translation"
297
+ echo ""
298
+ }
299
+
300
+ # Main command handler - only run if script is executed directly, not sourced
301
+ if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
302
+ case "${1:-}" in
303
+ get-bmad-language)
304
+ get_bmad_language
305
+ ;;
306
+ get-translate-to)
307
+ get_translate_to
308
+ ;;
309
+ is-enabled)
310
+ if is_translation_enabled; then
311
+ echo "ON"
312
+ exit 0
313
+ else
314
+ echo "OFF"
315
+ exit 1
316
+ fi
317
+ ;;
318
+ translate)
319
+ if [[ -z "${2:-}" ]]; then
320
+ echo "Usage: translate-manager.sh translate <text> [target_lang]" >&2
321
+ exit 1
322
+ fi
323
+ translate_text "$2" "${3:-}"
324
+ ;;
325
+ set)
326
+ set_translate "${2:-}"
327
+ ;;
328
+ auto)
329
+ set_translate "auto"
330
+ ;;
331
+ off)
332
+ set_translate "off"
333
+ ;;
334
+ status)
335
+ show_status
336
+ ;;
337
+ *)
338
+ show_status
339
+ ;;
340
+ esac
341
+ fi