agentvibes 4.6.3 → 4.6.6

package/src/console/tabs/settings-tab.js

@@ -751,7 +751,7 @@ export function createSettingsTab(screen, services) {
 
   const box = blessed.box({
     parent: screen,
-    top: 4,       // Below header (row 0-2) + tab bar (row 3)
+    top: 5,       // Below header (rows 0-3) + tab bar (row 4)
     left: 0,
     width: '100%',
     bottom: 2,    // Above context footer + GitHub footer
@@ -1760,37 +1760,57 @@ export function createSettingsTab(screen, services) {
     style: { fg: COLORS.valueFg, bg: COLORS.contentBg },
   });
 
-  let _langListIdx = 0;
+  // Visible list height — cap at 10 rows (fits standard 24-row terminals with headers)
+  const LANG_LIST_HEIGHT = Math.min(SUPPORTED_LANGUAGES.length, 10);
 
-  const languageList = blessed.box({
+  // blessed.list: natively focusable, handles selection highlight, scrolling.
+  // keys:true needed so keypress events propagate to the element (keyable=true).
+  // We immediately removeAllListeners('keypress') to strip blessed's built-in up/down nav —
+  // our manual .key() handlers (registered on 'key down'/'key up') are the sole navigators.
+  const languageList = blessed.list({
     parent: box,
     top: 7,
     left: 4,
-    width: 40,
-    height: Math.min(SUPPORTED_LANGUAGES.length + 2, 12),
-    tags: true,
-    content: '',
-    style: { fg: COLORS.labelFg, bg: COLORS.contentBg },
+    width: 44,
+    height: LANG_LIST_HEIGHT + 2,  // +2 for border
+    keys: true,
+    mouse: true,
+    tags: false,
+    items: SUPPORTED_LANGUAGES.map(l => l.name),
+    style: {
+      selected: { bg: 'green', fg: 'white', bold: true },
+      item: { fg: 'white' },
+      border: { fg: 'cyan' },
+      focus: { border: { fg: 'yellow' } },
+    },
+    border: { type: 'line' },
+    scrollable: true,
+    scrollbar: { style: { bg: 'blue' } },
   });
+  // Strip blessed's built-in keypress nav (up/down/j/k/etc.) — our .key() handlers take over.
+  // .key() registers on 'key <name>' events (not 'keypress'), so they survive this removal.
+  languageList.removeAllListeners('keypress');
 
-  function _renderLangList() {
-    const lines = SUPPORTED_LANGUAGES.map((l, i) =>
-      i === _langListIdx
-        ? `{green-fg}► ${l.name}{/green-fg}`
-        : `  ${l.name}`
-    );
-    languageList.setContent(lines.join('\n'));
-  }
+  // Hint shown below the list
+  const langHint = blessed.text({
+    parent: box,
+    top: 7 + LANG_LIST_HEIGHT + 3,
+    left: 4,
+    content: '{gray-fg}↑↓ navigate · Enter to apply{/gray-fg}',
+    tags: true,
+    style: { bg: COLORS.contentBg },
+  });
 
+  // Apply button — kept for mouse users; keyboard users just press Enter on the list
   const langApplyBtn = _createButton(box, screen, '✓ Apply Language', COLORS, () => {
-    const selected = SUPPORTED_LANGUAGES[_langListIdx];
+    const selected = SUPPORTED_LANGUAGES[languageList.selected ?? 0];
     if (selected && services.languageService) {
       services.languageService.setLang(selected.value);
       refreshLanguageDisplay();
       _showNotice(screen, `Language: ${selected.name}`);
     }
   }, { bg: '#2e7d32' });
-  langApplyBtn.top = 7 + Math.min(SUPPORTED_LANGUAGES.length + 2, 12) + 1;
+  langApplyBtn.top = 7 + LANG_LIST_HEIGHT + 5;
   langApplyBtn.left = 4;
 
   function refreshLanguageDisplay() {
@@ -1798,19 +1818,11 @@ export function createSettingsTab(screen, services) {
     const found = SUPPORTED_LANGUAGES.find(l => l.value === currentLang);
     languageCurrentValue.setContent(found ? found.name : currentLang);
     const idx = SUPPORTED_LANGUAGES.findIndex(l => l.value === currentLang);
-    if (idx >= 0) _langListIdx = idx;
-    _renderLangList();
+    if (idx >= 0) languageList.select(idx);
     screen.render();
   }
 
-  // Key navigation for language list
-  box.key(['up', 'down'], (ch, key) => {
-    if (_activeSubTab !== 'language') return;
-    if (key.name === 'up') _langListIdx = Math.max(0, _langListIdx - 1);
-    if (key.name === 'down') _langListIdx = Math.min(SUPPORTED_LANGUAGES.length - 1, _langListIdx + 1);
-    _renderLangList();
-    screen.render();
-  });
+  // Key navigation wired after _navigateRow is defined (see below)
 
   // -------------------------------------------------------------------------
   // Display state + button-level focus navigation (story 7.6)
@@ -1847,8 +1859,7 @@ export function createSettingsTab(screen, services) {
     language: [
       languageSectionHeader,
       languageCurrentLabel, languageCurrentValue,
-      languageList,
-      langApplyBtn,
+      languageList, langHint, langApplyBtn,
     ],
   };
 
@@ -1858,7 +1869,7 @@ export function createSettingsTab(screen, services) {
     effects:     [[reverbChangeBtn, reverbTestBtn], [trackChangeBtn, musicToggleBtn, musicTestBtn], [volumeChangeBtn]],
     personality: [[verbosityChangeBtn], [personalityChangeBtn, personalityTestBtn], [introEditBtn, introClearBtn]],
     output:      [[audioDstChangeBtn], [audioSshEditBtn, audioStreamModeBtn]],
-    language:    [[langApplyBtn]],
+    language:    [[languageList], [langApplyBtn]],
   };
 
   const _subTabItemsArray = SUB_TABS.map(id => _subTabItemsMap[id]);
@@ -1906,7 +1917,7 @@ export function createSettingsTab(screen, services) {
 
   const _buttons = [
     _subTabItemsMap.voice, _subTabItemsMap.effects,
-    _subTabItemsMap.personality, _subTabItemsMap.output,
+    _subTabItemsMap.personality, _subTabItemsMap.output, _subTabItemsMap.language,
     switchBtn, changeBtn, playBtn,
     reverbChangeBtn, reverbTestBtn,
     trackChangeBtn, musicToggleBtn, musicTestBtn,
@@ -1914,6 +1925,7 @@ export function createSettingsTab(screen, services) {
     verbosityChangeBtn, personalityChangeBtn, personalityTestBtn,
     introEditBtn, introClearBtn,
     audioDstChangeBtn, audioSshEditBtn, audioStreamModeBtn,
+    languageList, langApplyBtn,
     fullPreviewBtn,
     saveGloballyBtn, saveLocallyBtn, cancelChangesBtn,
   ];
@@ -2030,74 +2042,6 @@ export function createSettingsTab(screen, services) {
       return;
     }
 
-    // _rows layout: [0]=sub-tab bar, [1..lastContent]=per-tab rows, then 3 shared bottom rows
-    const BOTTOM_ROWS = 2; // [fullPreviewBtn], [saveGlobally+saveLocally+cancelChanges]
-    const lastContentIdx = _rows.length - BOTTOM_ROWS - 1;
-
-    // Cross-tab forward: ↓ from the effective last visible content row → jump to next sub-tab
-    if (delta > 0 && rowIdx >= 1 && rowIdx <= lastContentIdx) {
-      let isEffectiveLast = true;
-      for (let r = rowIdx + 1; r <= lastContentIdx; r++) {
-        if (_isRowVisible(_rows[r])) { isEffectiveLast = false; break; }
-      }
-      if (isEffectiveLast) {
-        const tabIdx = SUB_TABS.indexOf(_activeSubTab);
-        if (tabIdx < SUB_TABS.length - 1) {
-          const nextTab = SUB_TABS[tabIdx + 1];
-          _showSubTab(nextTab, true);
-          const firstRow = _rowsBySubTab[nextTab].find(row => _isRowVisible(row));
-          if (firstRow) {
-            const btn = _firstVisibleBtn(firstRow);
-            _currentIdx = _buttons.indexOf(btn);
-            _focusButton(btn);
-            return;
-          }
-        }
-        // On the last sub-tab: fall through to normal (go to fullPreviewBtn)
-      }
-    }
-
-    // Cross-tab backward: ↑ from first content row (row 1) → jump to previous sub-tab's last row
-    if (delta < 0 && rowIdx === 1) {
-      const tabIdx = SUB_TABS.indexOf(_activeSubTab);
-      if (tabIdx > 0) {
-        const prevTab = SUB_TABS[tabIdx - 1];
-        _showSubTab(prevTab, true);
-        const prevRows = _rowsBySubTab[prevTab];
-        let lastRow = null;
-        for (let i = prevRows.length - 1; i >= 0; i--) {
-          if (_isRowVisible(prevRows[i])) { lastRow = prevRows[i]; break; }
-        }
-        if (lastRow) {
-          const btn = _firstVisibleBtn(lastRow);
-          _currentIdx = _buttons.indexOf(btn);
-          _focusButton(btn);
-          return;
-        }
-      }
-      // First sub-tab: fall through (goes to sub-tab bar at row 0)
-    }
-
-    // In the bottom save row: ↓ navigates to the next visible sibling within the row
-    // rather than wrapping to row 0 (sub-tab bar) via modulo.
-    const lastRowIdx = _rows.length - 1;
-    if (delta > 0 && rowIdx === lastRowIdx) {
-      const row = _rows[lastRowIdx];
-      const posInRow = row.indexOf(focused);
-      for (let i = posInRow + 1; i < row.length; i++) {
-        if (!row[i].hidden) {
-          _currentIdx = _buttons.indexOf(row[i]);
-          _focusButton(row[i]);
-          return;
-        }
-      }
-      // Last sibling in the row — wrap up to sub-tab bar (row 0)
-      const topBtn = _firstVisibleBtn(_rows[0]);
-      _currentIdx = _buttons.indexOf(topBtn);
-      _focusButton(topBtn);
-      return;
-    }
-
     // Skip rows where ALL buttons are hidden (e.g. SSH alias row when destination is local).
     // Use _firstVisibleBtn so we land on the first visible button in a mixed row.
     let attempts = 0;
@@ -2105,17 +2049,56 @@ export function createSettingsTab(screen, services) {
       rowIdx = (rowIdx + delta + _rows.length) % _rows.length;
       attempts++;
     } while (!_isRowVisible(_rows[rowIdx]) && attempts < _rows.length);
-    const btn = _firstVisibleBtn(_rows[rowIdx]);
+    // When landing on the sub-tab bar (row 0), focus the ACTIVE sub-tab item, not the first one
+    const btn = rowIdx === 0
+      ? (_subTabItemsMap[_activeSubTab] ?? _firstVisibleBtn(_rows[0]))
+      : _firstVisibleBtn(_rows[rowIdx]);
     _currentIdx = _buttons.indexOf(btn);
     _focusButton(btn);
   }
 
   for (const btn of _buttons) {
-    btn.key(['down'],   () => _navigateRow(1));
-    btn.key(['up'],     () => _navigateRow(-1));
+    btn.key(['down'], () => {
+      if (btn === languageList) return;  // languageList has its own boundary-aware down handler
+      _navigateRow(1);
+    });
+    btn.key(['up'], () => {
+      if (btn === languageList) return;  // languageList has its own boundary-aware up handler
+      _navigateRow(-1);
+    });
     btn.key(['escape'], () => { if (typeof focusMainTabBar === 'function') setTimeout(() => focusMainTabBar(), 0); });
   }
 
+  // Language list — fully manual navigation (keys:false on the list disables blessed's built-in
+  // so only our handlers run, giving us clean boundary detection without double-move issues).
+  languageList.key(['down'], () => {
+    const cur = languageList.selected ?? 0;
+    if (cur >= SUPPORTED_LANGUAGES.length - 1) {
+      _navigateRow(1);  // past last item → Apply button
+    } else {
+      languageList.select(cur + 1);
+      screen.render();
+    }
+  });
+  languageList.key(['up'], () => {
+    const cur = languageList.selected ?? 0;
+    if (cur <= 0) {
+      _navigateRow(-1);  // past first item → sub-tab bar
+    } else {
+      languageList.select(cur - 1);
+      screen.render();
+    }
+  });
+  languageList.key(['enter', 'return', 'space'], () => {
+    const selected = SUPPORTED_LANGUAGES[languageList.selected ?? 0];
+    if (selected && services.languageService) {
+      services.languageService.setLang(selected.value);
+      refreshLanguageDisplay();
+      _showNotice(screen, `Language: ${selected.name}`);
+    }
+  });
+  languageList.key(['escape'], () => { if (typeof focusMainTabBar === 'function') setTimeout(() => focusMainTabBar(), 0); });
+
   // ← / → within content rows — uses _buttonGroups (static); sub-tab bar has its own wiring
   const _rows = [];  // populated dynamically by _showSubTab()
 
@@ -2129,8 +2112,9 @@ export function createSettingsTab(screen, services) {
     [introEditBtn, introClearBtn],
     [audioDstChangeBtn],
     [audioSshEditBtn, audioStreamModeBtn],
-    [fullPreviewBtn],
-    [saveGloballyBtn, saveLocallyBtn, cancelChangesBtn],
+    [languageList],
+    [langApplyBtn],
+    [fullPreviewBtn, saveGloballyBtn, saveLocallyBtn, cancelChangesBtn],
   ];
 
   for (const row of _buttonGroups) {
@@ -2425,9 +2409,12 @@ export function createSettingsTab(screen, services) {
     },
 
     onFocus() {
+      // Land on the active sub-tab bar item so the user can ↑↓ from there.
       // Use _focusButton (not raw .focus()) so olines get invalidated before render,
       // preventing the ghost-duplicate-row artifact on initial tab activation.
-      _focusButton(_buttons[_currentIdx]);
+      const activeSubTabItem = _subTabItemsMap[_activeSubTab];
+      _currentIdx = _buttons.indexOf(activeSubTabItem);
+      _focusButton(activeSubTabItem);
     },
 
     onBlur() {

package/src/console/tabs/voices-tab.js

@@ -493,7 +493,7 @@ export function createVoicesTab(screen, services) {
 
   const box = blessed.box({
     parent: screen,
-    top: 4,
+    top: 5,
     left: 0,
     width: '100%',
     bottom: 2,

package/src/installer.js

@@ -2669,25 +2669,54 @@ function showWelcome() {
 
 /**
  * Display latest release information box
- * Shown during install and update commands
+ * Reads the first section from RELEASE_NOTES.md so it's always current.
+ * Falls back to a minimal static string if the file is missing.
  */
 function getReleaseInfoBoxen() {
-  return chalk.cyan.bold('📦 AgentVibes v4.0.0 - Interactive Console & Voice Explorer\n\n') +
-    chalk.green.bold('🎙️ WHAT\'S NEW:\n\n') +
-    chalk.cyan('Major release with a full interactive TUI console, voice browser with 914+ voices,\n') +
-    chalk.cyan('and comprehensive platform support. Includes 58 security fixes, reliable TTS hooks,\n') +
-    chalk.cyan('and support for Windows, macOS, Android/Termux, and SSH-remote audio.\n\n') +
-    chalk.green.bold('✨ KEY HIGHLIGHTS:\n\n') +
-    chalk.gray('   🖥️  Interactive TUI Console - Settings, Voices, Music tabs with live preview\n') +
-    chalk.gray('   🎤 Voice Browser - Browse and preview 914+ Piper TTS voices\n') +
-    chalk.gray('   🔧 Reliable TTS Hooks - JSON context injection, auto git-init\n') +
-    chalk.gray('   🌍 Multi-Platform - Windows, macOS, Android/Termux, SSH-remote\n') +
-    chalk.gray('   🔐 Security Hardened - 58 issues fixed, 180+ security tests\n\n') +
-    chalk.gray('📖 Full Release Notes: RELEASE_NOTES.md\n') +
-    chalk.gray('🌐 Website: https://agentvibes.org\n') +
-    chalk.gray('📦 Repository: https://github.com/paulpreibisch/AgentVibes\n\n') +
-    chalk.gray('Co-created by Paul Preibisch with Claude AI\n') +
-    chalk.gray('Copyright © 2026 Paul Preibisch | Apache-2.0 License');
+  try {
+    const notesPath = path.join(__dirname, '..', 'RELEASE_NOTES.md');
+    const raw = fsSync.readFileSync(notesPath, 'utf8');
+    const lines = raw.split('\n');
+
+    // Find the first ## heading (latest release section)
+    const startIdx = lines.findIndex(l => l.startsWith('## '));
+    if (startIdx < 0) return '';
+
+    // Collect lines until the next ## heading (or end of file)
+    const sectionLines = [];
+    for (let i = startIdx; i < lines.length; i++) {
+      if (i !== startIdx && lines[i].startsWith('## ')) break;
+      sectionLines.push(lines[i]);
+    }
+
+    // Strip markdown syntax from a line for plain display
+    const stripMd = (s) => s
+      .replace(/^#{1,6}\s*/, '')           // ## headings
+      .replace(/\*\*([^*]+)\*\*/g, '$1')  // **bold**
+      .replace(/`([^`]+)`/g, '$1')        // `code`
+      .replace(/\[([^\]]+)\]\([^)]+\)/g, '$1'); // [text](url)
+
+    // Render: heading in cyan, bullets as gray, skip blank/hr lines at end
+    return sectionLines
+      .map((line, i) => {
+        if (i === 0) return chalk.cyan.bold(stripMd(line));
+        if (line.startsWith('### ')) return chalk.green.bold(stripMd(line));
+        if (line.startsWith('- ')) return chalk.gray('  ' + stripMd(line));
+        if (line === '---') return '';
+        return chalk.gray(stripMd(line));
+      })
+      .join('\n')
+      .trimEnd() + '\n\n' +
+      chalk.gray('📖 Full Release Notes: RELEASE_NOTES.md\n') +
+      chalk.gray('🌐 Website: https://agentvibes.org\n') +
+      chalk.gray('📦 Repository: https://github.com/paulpreibisch/AgentVibes\n\n') +
+      chalk.gray('Co-created by Paul Preibisch with Claude AI\n') +
+      chalk.gray('Copyright © 2026 Paul Preibisch | Apache-2.0 License');
+  } catch {
+    return chalk.cyan.bold(`📦 AgentVibes v${VERSION}\n`) +
+      chalk.gray('📖 Full Release Notes: RELEASE_NOTES.md\n') +
+      chalk.gray('🌐 Website: https://agentvibes.org');
+  }
 }
 
 /**
@@ -4126,6 +4155,12 @@ async function checkAndInstallPiperWindows(targetDir, options) {
     return;
   }
 
+  // Also check PATH — piper may be installed outside the standard location
+  if (isPiperInstalled()) {
+    console.log(chalk.green('✓ Piper TTS is already available in PATH\n'));
+    return;
+  }
+
   spinner.start('Downloading Piper TTS for Windows...');
   try {
     await fs.mkdir(piperDir, { recursive: true });
@@ -4237,7 +4272,7 @@ async function handleMcpConfiguration(targetDir, options) {
         chalk.white('to your ') + chalk.cyan('mcpServers') + chalk.white(' section:'),
         {
           padding: 1,
-          margin: 1,
+          margin: { top: 1, bottom: 1, left: 0, right: 0 },
           borderStyle: 'round',
           borderColor: 'yellow',
         }
@@ -4260,7 +4295,7 @@ async function handleMcpConfiguration(targetDir, options) {
         chalk.cyan.bold('https://github.com/paulpreibisch/AgentVibes#mcp-server'),
         {
           padding: 1,
-          margin: 1,
+          margin: { top: 1, bottom: 1, left: 0, right: 0 },
           borderStyle: 'round',
           borderColor: 'cyan',
         }
@@ -4280,7 +4315,7 @@ async function handleMcpConfiguration(targetDir, options) {
       chalk.white('No ') + chalk.cyan('.mcp.json') + chalk.white(' found in this project.'),
       {
         padding: 1,
-        margin: 1,
+        margin: { top: 1, bottom: 1, left: 0, right: 0 },
         borderStyle: 'round',
         borderColor: 'cyan',
       }
@@ -4315,12 +4350,15 @@ async function handleMcpConfiguration(targetDir, options) {
           chalk.green('The MCP server is now installed and ready to use!'),
           {
             padding: 1,
-            margin: 1,
+            margin: { top: 1, bottom: 1, left: 0, right: 0 },
             borderStyle: 'double',
             borderColor: 'green',
           }
         )
       );
+
+      // Show the installed JSON so users can see exactly what was written
+      console.log(chalk.gray(JSON.stringify(mcpConfig, null, 2)) + '\n');
     } catch (error) {
       console.log(chalk.red(`\n✗ Failed to create .mcp.json: ${error.message}`));
       console.log(chalk.gray('   You can create it manually with the config shown below.\n'));
@@ -4337,7 +4375,7 @@ async function handleMcpConfiguration(targetDir, options) {
         chalk.white('Create a ') + chalk.cyan('.mcp.json') + chalk.white(' file in your project with:'),
         {
           padding: 1,
-          margin: 1,
+          margin: { top: 1, bottom: 1, left: 0, right: 0 },
           borderStyle: 'round',
           borderColor: 'cyan',
         }
@@ -4366,7 +4404,7 @@ async function handleMcpConfiguration(targetDir, options) {
         chalk.cyan.bold('https://github.com/paulpreibisch/AgentVibes#mcp-server'),
         {
           padding: 1,
-          margin: 1,
+          margin: { top: 1, bottom: 1, left: 0, right: 0 },
           borderStyle: 'round',
           borderColor: 'cyan',
         }
@@ -5314,6 +5352,12 @@ Troubleshooting:
       await fs.writeFile(langConfigPath, lang, { mode: 0o600 });
     }
 
+    // Default translation to auto: syncs with BMAD communication_language if set, otherwise no translation
+    const translateFile = path.join(claudeDir, 'tts-translate-to.txt');
+    try { await fs.access(translateFile); } catch {
+      await fs.writeFile(translateFile, 'auto', { mode: 0o600 });
+    }
+
     // Apply verbosity, personality, pretext
     await fs.writeFile(path.join(claudeDir, 'tts-verbosity.txt'), userConfig.verbosity);
     if (userConfig.personality && userConfig.personality !== 'none') {
@@ -5344,12 +5388,17 @@ Troubleshooting:
     await createDefaultBmadVoiceAssignmentsProactive(targetDir);
     await handleBmadIntegration(targetDir, { ...options, yes: true });
 
-    spinner.succeed(chalk.green('AgentVibes installed successfully!'));
-
     if (options.nonInteractive || process.env.AGENT_VIBES_NON_INTERACTIVE === '1') {
-      console.log(`[AV] Installation complete`);
       console.log(`[AV] Provider: ${selectedProvider} | Location: ${targetDir}/.claude/ | Version: ${VERSION}`);
-    } else {
+    }
+
+    console.log('');
+    spinner.succeed(chalk.green('AgentVibes installed successfully!'));
+    console.log('');
+    console.log(chalk.magenta('  \u2661  Sponsor this Developer  github.com/sponsors/paulpreibisch'));
+    console.log('');
+
+    if (!(options.nonInteractive || process.env.AGENT_VIBES_NON_INTERACTIVE === '1')) {
       // Clean final summary
       console.log('');
       console.log(chalk.green.bold('  ✅ Installation Complete'));

package/.claude/config/background-music-enabled.txt

@@ -1 +0,0 @@
-true