agentvibes 4.4.1 → 4.5.7

package/RELEASE_NOTES.md

@@ -1,5 +1,83 @@
 # AgentVibes Release Notes
 
+## 🐛 v4.5.7 — Patch Release
+
+**Release Date:** April 2026
+
+### Bug Fixes
+
+- **Background music volume default** — All volume defaults lowered from 70% to 20% across the UI (settings tab, agents tab, music tab, track picker). New installs and newly configured agents will default to a much more reasonable background music level.
+- **bmad-speak volume inheritance** — `bmad-speak.sh` and `bmad-speak.ps1` now read the global `background-music-volume.txt` config file as the fallback volume instead of a hardcoded value. Per-agent background music volume now correctly inherits the global setting when no explicit per-agent override is saved.
+
+---
+
+## 🐛 v4.5.1 — Patch Release
+
+**Release Date:** April 2026
+
+### Bug Fix
+
+- **Music tab preview** — Pressing Space on a track in the Music tab now plays correctly
+  when running `npx agentvibes` from a fresh directory. Previously, if `.claude/audio/tracks/`
+  didn't exist in the current working directory, the track list showed built-in tracks but
+  Space did nothing (the player was spawned against a non-existent path). Now falls back to
+  the package-bundled tracks directory automatically.
+
+---
+
+## 🌍 v4.5.0 — "Speak Every Language" Release
+
+**Release Date:** April 2026
+
+Full multilingual TUI support across all 9 languages, complete Windows security hardening, and zero failing tests.
+
+### 🌍 Multilingual TUI — 9 Languages
+
+Every screen, tab, button, and label in the `npx agentvibes` TUI is now fully translated:
+
+- **English, Spanish, French, German, Portuguese, Japanese, Korean, Chinese (Simplified), Italian**
+- Language selection on first launch (Screen 0 of the installer wizard)
+- Language sub-tab in Settings — switch language live without restarting
+- All tab bar labels, button text, footer hints, and status messages translated
+- BMAD tab and SSH Receiver tab fully localized
+- Per-language i18n files (`src/i18n/en.js`, `es.js`, `fr.js`, ...) with English fallback
+
+### 🪟 Windows Security & Bug Fixes
+
+- **Temp filenames** — All `Date.now()` temp filenames replaced with `randomUUID()` across JS and PowerShell (unpredictable, prevents temp file hijacking)
+- **Shell injection** — `execSync('which ...', { shell: true })` replaced with `spawnSync` (no shell expansion)
+- **Music player** — Hardcoded `ffplay` on Windows replaced with `detectMp3Player()` (respects user's installed player)
+- **Boolean coercion** — `isWindowsTerminal` now correctly returns `true/false` instead of leaking `WT_SESSION` UUID string
+- **Network mount detection** — `.match()` result properly coerced to boolean
+
+### 🎙️ Cross-Platform BMAD Speak
+
+BMAD (Build More Architect Dreams) is an AI multi-agent framework where specialized agents — Architect, PM, Developer, QA, and Analyst — collaborate to build software. With this release, every agent in a BMAD party mode session now speaks aloud with their own unique voice, personality, and music on Windows — making each role instantly recognizable.
+
+## 🐛 v4.5.1 — Patch Release
+
+**Release Date:** April 2026
+
+### Bug Fix
+
+- **Music tab preview** — Pressing Space on a track in the Music tab now plays correctly
+  when running `npx agentvibes` from a fresh directory. Previously, if `.claude/audio/tracks/`
+  didn't exist in the current working directory, the track list showed built-in tracks but
+  Space did nothing (the player was spawned against a non-existent path). Now falls back to
+  the package-bundled tracks directory automatically.
+
+---
+
+- `bin/bmad-speak.js` — cross-platform entry point for BMAD agent speech
+- `.claude/hooks-windows/bmad-speak.ps1` — native Windows BMAD speak with per-agent personality routing
+
+### 🧪 Test Suite
+
+- 600 tests, 0 failures
+- Full cross-platform coverage (Windows path separators, chmod skip, provider file restore)
+
+---
+
 ## 🎉 v4.4.0 — "Full Platform Parity" Release
 
 **Release Date:** March 2026

package/bin/agent-vibes

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 /**
  * AgentVibes - Beautiful ElevenLabs TTS voice commands for Claude Code

package/bin/agentvibes-voice-browser.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 /**
  * AgentVibes Voice Browser

package/bin/bmad-speak.js

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+
+/**
+ * AgentVibes - Cross-platform BMAD agent TTS entry point
+ *
+ * Delegates to the correct platform script:
+ *   Windows (non-WSL) → .claude/hooks-windows/bmad-speak.ps1
+ *   Linux/Mac/WSL     → .claude/hooks/bmad-speak.sh
+ *
+ * Usage: node bin/bmad-speak.js "Agent Name" "dialogue text"
+ */
+
+import { spawnSync } from 'node:child_process';
+import path from 'node:path';
+import fs from 'node:fs';
+import os from 'node:os';
+
+const [, , agentName, dialogue] = process.argv;
+
+if (!agentName || !dialogue) {
+  process.stderr.write('Usage: bmad-speak.js "Agent Name" "dialogue text"\n');
+  process.exit(1);
+}
+
+const IS_WINDOWS = process.platform === 'win32' && !process.env.WSL_DISTRO_NAME;
+
+// Resolve script path — prefer project-local, fall back to global ~/.claude install
+function resolveScript(relPath) {
+  const cwdPath = path.join(process.cwd(), relPath);
+  const homePath = path.join(os.homedir(), relPath.replace(/^\.claude[\\/]/, '.claude/'));
+  if (fs.existsSync(cwdPath)) return cwdPath;
+  if (fs.existsSync(homePath)) return homePath;
+  return null;
+}
+
+let result;
+
+if (IS_WINDOWS) {
+  const script = resolveScript('.claude/hooks-windows/bmad-speak.ps1');
+  if (!script) process.exit(0);
+  result = spawnSync(
+    'powershell',
+    ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', script, agentName, dialogue],
+    { stdio: 'inherit' }
+  );
+} else {
+  const script = resolveScript('.claude/hooks/bmad-speak.sh');
+  if (!script) process.exit(0);
+  result = spawnSync('bash', [script, agentName, dialogue], { stdio: 'inherit' });
+}
+
+process.exit(result.status ?? 0);

package/bin/mcp-server.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 /**
  * AgentVibes MCP Server Launcher (Cross-Platform)

package/bin/test-bmad-pr

@@ -1,4 +1,4 @@
-#!/usr/bin/env bash
+#!/usr/bin/env bash
 #
 # AgentVibes BMAD PR Testing Command
 # Quick command to test BMAD PRs with AgentVibes integration

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "agentvibes",
-  "version": "4.4.1",
+  "version": "4.5.7",
   "description": "Now your AI Agents can finally talk back! Professional TTS voice for Claude Code, Claude Desktop (via MCP), and Clawdbot with multi-provider support.",
   "homepage": "https://agentvibes.org",
   "keywords": [

package/setup-windows.ps1

@@ -283,8 +283,8 @@ if (-not (Test-Path $HooksDir)) {
 $HookScriptInfo = @(
     @{ Name = "play-tts.ps1"; Desc = "Main TTS router - dispatches to active provider" },
     @{ Name = "play-tts-soprano.ps1"; Desc = "Soprano neural voice provider (fastest)" },
-    @{ Name = "play-tts-windows-piper.ps1"; Desc = "Piper offline neural voice provider" },
-    @{ Name = "play-tts-windows-sapi.ps1"; Desc = "Windows built-in SAPI voice provider" },
+    @{ Name = "play-tts-piper.ps1"; Desc = "Piper offline neural voice provider" },
+    @{ Name = "play-tts-sapi.ps1"; Desc = "Windows built-in SAPI voice provider" },
     @{ Name = "provider-manager.ps1"; Desc = "Switch between TTS providers" },
     @{ Name = "voice-manager-windows.ps1"; Desc = "Browse and select voice models" },
     @{ Name = "audio-cache-utils.ps1"; Desc = "Manage TTS audio file cache" },
@@ -765,11 +765,11 @@ try {
             }
         }
         "piper" {
-            & "$HooksDir\play-tts-windows-piper.ps1" $TestMessage | Out-Null
+            & "$HooksDir\play-tts-piper.ps1" $TestMessage | Out-Null
             Write-Ok "Piper TTS is working"
         }
         "sapi" {
-            & "$HooksDir\play-tts-windows-sapi.ps1" $TestMessage | Out-Null
+            & "$HooksDir\play-tts-sapi.ps1" $TestMessage | Out-Null
             Write-Ok "Windows SAPI is working"
         }
     }

package/src/console/app.js

@@ -14,7 +14,9 @@ import { fileURLToPath } from 'node:url';
 import { spawnSync, execFileSync } from 'node:child_process';
 import { NavigationService, TAB_ORDER } from '../services/navigation-service.js';
 import { setupNavigation } from './navigation.js';
-import { createPlaceholderTab, TAB_DISPLAY_LABELS, TAB_SHORTCUT_KEYS } from './tabs/placeholder-tab.js';
+import { createPlaceholderTab, TAB_DISPLAY_LABELS, TAB_SHORTCUT_KEYS, getTabLabel } from './tabs/placeholder-tab.js';
+import { LanguageService } from '../services/language-service.js';
+import { t } from '../i18n/strings.js';
 import { FOOTER_CONFIG, DEFAULT_FOOTER_COLOR } from './footer-config.js';
 import { createModalOverlay } from './modals/modal-overlay.js';
 import { BRAND_PINK } from './brand-colors.js';
@@ -169,7 +171,7 @@ export class AgentVibesConsole {
     });
 
     // Row 1: subtitle
-    blessed.text({
+    this._headerSubtitleText = blessed.text({
       parent: this.headerBox,
       top: 1,
       left: 2,
@@ -180,7 +182,7 @@ export class AgentVibesConsole {
     });
 
     // Row 1: Quit shortcut — left-anchored after "Customization Tool" (18 chars at left:2)
-    blessed.text({
+    this._headerQuitText = blessed.text({
       parent: this.headerBox,
       top: 1,
       left: 22,
@@ -291,9 +293,11 @@ export class AgentVibesConsole {
 
     // One box per tab — direct screen children at absolute top:3. No tag parsing, no wrapping.
     this._tabItems = {};
+    this._tabItemXOffsets = {};  // track x positions for label refresh
     let xOffset = 1;
     for (const id of TAB_ORDER) {
-      const label = TAB_DISPLAY_LABELS[id];
+      const lang = this._languageService?.getLang() ?? 'en';
+      const label = getTabLabel(id, lang);
       const shortcutKey = TAB_SHORTCUT_KEYS[id] || label[0];
       const text = ` [${shortcutKey}] ${label} `;
       const el = blessed.box({
@@ -304,11 +308,13 @@ export class AgentVibesConsole {
         height: 1,
         content: text,
         tags: false,
+        wrap: false,
         keys: true,
         focusable: true,
         style: { fg: COLORS.focusCyan, bg: COLORS.tabBarBg },
       });
       this._tabItems[id] = el;
+      this._tabItemXOffsets[id] = xOffset;
       xOffset += text.length + 1; // 1-space gap between tabs
     }
 
@@ -359,9 +365,8 @@ export class AgentVibesConsole {
       const el = this._tabItems[tabIds[i]];
 
       // Blinking block cursor: replace trailing space with █, toggle at 500ms
-      const _tabLabel     = TAB_DISPLAY_LABELS[tabIds[i]];
-      const _baseContent  = ` [${_tabLabel[0]}] ${_tabLabel} `;
-      const _blockContent = _baseContent.slice(0, -1) + '█';
+      // Always derive from current el.content so language changes are preserved.
+      const _getBaseContent = () => el.content.replace(/█$/, ' ');
       let _cursorInterval = null;
       let _cursorOn       = false;
 
@@ -369,18 +374,21 @@ export class AgentVibesConsole {
         el.style.fg = 'white';
         el.style.bg = '#9c27b0'; // purple — cursor on this tab item
         _cursorOn = true;
-        el.setContent(_blockContent);
+        const _base  = _getBaseContent();
+        const _block = _base.slice(0, -1) + '█';
+        el.setContent(_block);
         this.screen.render();
         if (_cursorInterval) { clearInterval(_cursorInterval); _cursorInterval = null; }
         _cursorInterval = setInterval(() => {
           _cursorOn = !_cursorOn;
-          el.setContent(_cursorOn ? _blockContent : _baseContent);
+          const b = _getBaseContent();
+          el.setContent(_cursorOn ? b.slice(0, -1) + '█' : b);
           this.screen.render();
         }, 500);
       });
       el.on('blur', () => {
         if (_cursorInterval) { clearInterval(_cursorInterval); _cursorInterval = null; }
-        el.setContent(_baseContent);
+        el.setContent(_getBaseContent());
         // navigationService set up after _createTabBar, but blur fires lazily — safe
         this._updateTabBar(this.navigationService?.getActiveTab() ?? tabIds[0]);
         this.screen.render();
@@ -474,13 +482,47 @@ export class AgentVibesConsole {
     }
   }
 
+  // ---------------------------------------------------------------------------
+  // Private: Refresh all chrome strings (header subtitle, tab bar labels) when lang changes
+
+  _refreshChrome(lang) {
+    // Update header subtitle "Customization Tool"
+    if (this._headerSubtitleText) {
+      this._headerSubtitleText.setContent(`{green-fg}${t(lang, 'customizationTool')}{/green-fg}`);
+    }
+    if (this._headerQuitText) {
+      this._headerQuitText.setContent(`{#ef9a9a-fg}${t(lang, 'quitLabel')}{/#ef9a9a-fg}`);
+    }
+
+    // Update tab bar item labels — resize and reposition to fit translated labels
+    let xOffset = 1;
+    for (const id of TAB_ORDER) {
+      const el = this._tabItems?.[id];
+      if (!el) continue;
+      const label = getTabLabel(id, lang);
+      const shortcutKey = TAB_SHORTCUT_KEYS[id] || label[0];
+      const text = ` [${shortcutKey}] ${label} `;
+      el.left = xOffset;
+      el.width = text.length;
+      el.setContent(text);
+      xOffset += text.length + 1;
+    }
+
+    // Update active tab's footer text if it supports language-aware footer
+    const activeId = this.navigationService?.getActiveTab();
+    if (activeId) this._updateContextFooter(activeId);
+
+    this.screen.render();
+  }
+
   // ---------------------------------------------------------------------------
   // Private: Render tab bar content string for given active tab
   // (kept as a pure helper for unit tests; real rendering uses _updateTabBar)
 
   _renderTabBarContent(activeTabId) {
+    const lang = this._languageService?.getLang() ?? 'en';
     return TAB_ORDER.map(id => {
-      const label = TAB_DISPLAY_LABELS[id];
+      const label = getTabLabel(id, lang);
       const shortcutKey = TAB_SHORTCUT_KEYS[id] || label[0];
       if (id === activeTabId) {
         return `{bold}{white-fg}[${shortcutKey}] ${label}{/white-fg}{/bold}`;
@@ -614,9 +656,14 @@ export class AgentVibesConsole {
     const providerService = new ProviderService(configService);
     this._configService = configService;
     this._providerService = providerService;
+    const languageService = new LanguageService();
+    this._languageService = languageService;
+    // Refresh UI chrome when language changes
+    languageService.onChange(lang => this._refreshChrome(lang));
     const services = {
       configService,
       providerService,
+      languageService,
       navigationService: this.navigationService,
       updateHeaderStatus: () => this._updateHeaderStatus(),
       focusMainTabBar: () => {
@@ -778,7 +825,11 @@ export class AgentVibesConsole {
     });
 
     // Register global key bindings (S/V/M/A/R/H/I/T/Esc)
-    setupNavigation(this.screen, this.navigationService);
+    setupNavigation(this.screen, this.navigationService, () => {
+      const id = this.navigationService.getActiveTab();
+      const item = this._tabItems?.[id];
+      if (item) item.focus();
+    });
   }
 
   // ---------------------------------------------------------------------------

package/src/console/navigation.js

@@ -35,8 +35,9 @@ const KEY_TO_TAB = {
  *
  * @param {object} screen - Blessed screen instance (or stub in tests)
  * @param {import('../services/navigation-service.js').NavigationService} navigationService
+ * @param {function} [focusMainTabBar] - Optional callback to return focus to the tab bar
  */
-export function setupNavigation(screen, navigationService) {
+export function setupNavigation(screen, navigationService, focusMainTabBar) {
   // Tab switching shortcuts — one handler per key (both cases)
   for (const [key, tabId] of Object.entries(KEY_TO_TAB)) {
     screen.key([key], () => {
@@ -53,10 +54,12 @@ export function setupNavigation(screen, navigationService) {
     }
   });
 
-  // Escape — close modal (story 6.4 will expand modal handling)
+  // Escape — close modal if open, otherwise return focus to tab bar
   screen.key(['escape'], () => {
     if (navigationService.isModalOpen()) {
       navigationService.closeModal();
+    } else if (typeof focusMainTabBar === 'function') {
+      focusMainTabBar();
     }
   });
 }