agentvibes 4.4.1 → 4.5.7

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

@@ -21,6 +21,7 @@ import {
 import { buildAudioEnv, detectWavPlayer } from '../audio-env.js';
 import { destroyList } from '../widgets/destroy-list.js';
 import { BRAND_PINK } from '../brand-colors.js';
+import { t } from '../../i18n/strings.js';
 import crypto from 'node:crypto';
 import fs from 'node:fs';
 import os from 'node:os';
@@ -57,8 +58,8 @@ const COLORS = {
   linkFg:     'bright-cyan',
 };
 
-const FOOTER_TEXT_BMAD   = '[↑↓/jk] Navigate  [Space] Preview  [Enter] Configure  [A] Auto-assign  [B] Bulk  [X] Reset  [Q] Quit';
-const FOOTER_TEXT_NOBMAD = '[Tab] Switch Tab  [Q] Quit';
+const _FOOTER_BMAD_EN   = '[↑↓/jk] Navigate  [Space] Preview  [Enter] Configure  [A] Auto-assign  [B] Bulk  [X] Reset  [Q] Quit';
+const _FOOTER_NOBMAD_EN = '[Tab] Switch Tab  [Q] Quit';
 
 const _modalTitle = (text) => ` {${BRAND_PINK}-fg}${text}{/${BRAND_PINK}-fg} `;
 
@@ -85,53 +86,43 @@ function createTestStub() {
     hide: () => {},
     onFocus: () => {},
     onBlur: () => {},
-    getFooterText: () => FOOTER_TEXT_BMAD,
+    getFooterText: () => _FOOTER_BMAD_EN,
     getFooterColor: () => COLORS.footerBg,
   };
 }
 
 // ---------------------------------------------------------------------------
-// No-BMAD onboarding content
 
-const ONBOARDING_TEXT = `{bold}{#ce93d8-fg}🧙 BMAD Agents{/#ce93d8-fg}{/bold}
+/**
+ * Create the Agents tab component.
+ */
+export function createAgentsTab(screen, services) {
+  if (IS_TEST) return createTestStub();
+
+  const { configService, providerService, focusMainTabBar, navigationService, languageService } = services;
+  const _tl = (key) => languageService ? languageService.t(key) : t('en', key);
 
-{bold}What is BMAD?{/bold}
+  function _buildOnboardingText() {
+    return `{bold}{#ce93d8-fg}${_tl('bmadTitle')}{/#ce93d8-fg}{/bold}
 
-The BMad Method (Build More Architect Dreams) is an AI-driven development
-framework module within the BMad Method Ecosystem that helps you build
-software through the whole process from ideation and planning all the way
-through agentic implementation. It provides specialized AI agents, guided
-workflows, and intelligent planning that adapts to your project's
-complexity, whether you're fixing a bug or building an enterprise platform.
+{bold}${_tl('bmadWhatIsHeader')}{/bold}
 
-If you're comfortable working with AI coding assistants like Claude,
-Cursor, or GitHub Copilot, you're ready to get started.
+${_tl('bmadDesc')}
 
 
-{bold}Install BMAD in your project:{/bold}
+{bold}${_tl('bmadInstallHeader')}{/bold}
 
   {bright-cyan-fg}npx bmad-method install{/bright-cyan-fg}
 
 
-{bold}Learn more:{/bold}
+{bold}${_tl('bmadLearnMoreHeader')}{/bold}
 
   {bright-cyan-fg}https://docs.bmad-method.org/{/bright-cyan-fg}
   {bright-cyan-fg}https://github.com/bmad-code-org/BMAD-METHOD{/bright-cyan-fg}
 
 
-{#90a4ae-fg}Once BMAD is installed, this tab will show all your agents and let you
-customize each agent's voice, pretext, reverb, personality, and background
-music independently.{/#90a4ae-fg}`;
-
-// ---------------------------------------------------------------------------
-
-/**
- * Create the Agents tab component.
- */
-export function createAgentsTab(screen, services) {
-  if (IS_TEST) return createTestStub();
-
-  const { configService, providerService, focusMainTabBar, navigationService } = services;
+{#90a4ae-fg}${_tl('bmadInstalledNote')}{/#90a4ae-fg}`;
+  }
   const voiceStore = new AgentVoiceStore();
 
   // Capture cwd once at construction (L1 fix)
@@ -183,10 +174,14 @@ export function createAgentsTab(screen, services) {
     keys: true,
     vi: true,
     mouse: true,
-    content: ONBOARDING_TEXT,
+    content: _buildOnboardingText(),
     style: { fg: COLORS.labelFg, bg: COLORS.contentBg },
   });
 
+  onboardingBox.key(['escape'], () => {
+    if (typeof focusMainTabBar === 'function') { focusMainTabBar(); screen.render(); }
+  });
+
   // -------------------------------------------------------------------------
   // BMAD state — section header
 
@@ -324,7 +319,7 @@ export function createAgentsTab(screen, services) {
   }
 
   const resetBtn = _createBtn('[X] Reset', () => {
-    const agent = _agents[agentList.selected];
+    const agent = _agents[agentList.selected ?? 0];
     if (agent) {
       voiceStore.resetAgentProfile(agent.id);
       refreshDisplay();
@@ -379,7 +374,7 @@ export function createAgentsTab(screen, services) {
         ? formatTrackName(profile.backgroundMusic.track)
         : '(global)')).padEnd(COL_MUSIC).slice(0, COL_MUSIC);
       const vol = profile.backgroundMusic?.enabled
-        ? ` ${profile.backgroundMusic.volume ?? 70}%`.padEnd(COL_VOL)
+        ? ` ${profile.backgroundMusic.volume ?? 20}%`.padEnd(COL_VOL)
         : '  —  ';
       const pretext = ' ' + (profile.pretext || '(default)').slice(0, COL_PRETEXT - 1);
       return ` ${icon}${name}${voice}${gender}${provider}${reverb}${music}${vol}  ${pretext}`;
@@ -486,20 +481,6 @@ export function createAgentsTab(screen, services) {
     }
   }
 
-  // -------------------------------------------------------------------------
-  // Resolve piper binary — shared helper to avoid duplication (#153)
-
-  function _resolvePiperBin() {
-    if (process.platform !== 'win32' || process.env.WSL_DISTRO_NAME) return 'piper';
-    const localAppData = process.env.LOCALAPPDATA ||
-      (process.env.USERPROFILE ? path.join(process.env.USERPROFILE, 'AppData', 'Local') : null);
-    if (localAppData) {
-      const exePath = path.join(localAppData, 'Programs', 'Piper', 'piper.exe');
-      if (fs.existsSync(exePath)) return exePath;
-    }
-    return 'piper';
-  }
-
   // -------------------------------------------------------------------------
   // Kill any playing preview
 
@@ -532,7 +513,7 @@ export function createAgentsTab(screen, services) {
       personality:     profile.personality   || globalCfg.personality || 'none',
       backgroundMusic: {
         track:   profile.backgroundMusic?.track   || globalCfg.backgroundMusic?.track || '',
-        volume:  profile.backgroundMusic?.volume  ?? globalCfg.backgroundMusic?.volume ?? 70,
+        volume:  profile.backgroundMusic?.volume  ?? globalCfg.backgroundMusic?.volume ?? 20,
         enabled: profile.backgroundMusic?.enabled ?? globalCfg.backgroundMusic?.enabled ?? false,
       },
     });
@@ -553,7 +534,7 @@ export function createAgentsTab(screen, services) {
       personality:     profile.personality   || globalCfg.personality || 'none',
       backgroundMusic: {
         track:   profile.backgroundMusic?.track   || globalCfg.backgroundMusic?.track || '',
-        volume:  profile.backgroundMusic?.volume  ?? globalCfg.backgroundMusic?.volume ?? 70,
+        volume:  profile.backgroundMusic?.volume  ?? globalCfg.backgroundMusic?.volume ?? 20,
         enabled: profile.backgroundMusic?.enabled ?? globalCfg.backgroundMusic?.enabled ?? false,
       },
     };
@@ -676,7 +657,7 @@ export function createAgentsTab(screen, services) {
       if (draft.reverbPreset !== (globalCfg.effects?.reverbPreset || 'light')) toSave.reverbPreset = draft.reverbPreset;
       if (draft.personality !== (globalCfg.personality || 'none')) toSave.personality = draft.personality;
       if (draft.backgroundMusic.track !== (globalCfg.backgroundMusic?.track || '') ||
-          draft.backgroundMusic.volume !== (globalCfg.backgroundMusic?.volume ?? 70) ||
+          draft.backgroundMusic.volume !== (globalCfg.backgroundMusic?.volume ?? 20) ||
           draft.backgroundMusic.enabled !== (globalCfg.backgroundMusic?.enabled ?? false)) {
         toSave.backgroundMusic = draft.backgroundMusic;
       }
@@ -935,7 +916,16 @@ export function createAgentsTab(screen, services) {
       const tempWav = _secureTempWav('vp');
       const phrase = SAMPLE_PHRASES[Math.floor(Math.random() * SAMPLE_PHRASES.length)];
 
-      const _piperBin = _resolvePiperBin();
+      // Resolve piper binary (on Windows, find piper.exe)
+      let _piperBin = 'piper';
+      if (_isWin) {
+        const _lad = process.env.LOCALAPPDATA ||
+          (process.env.USERPROFILE ? path.join(process.env.USERPROFILE, 'AppData', 'Local') : null);
+        if (_lad) {
+          const _ep = path.join(_lad, 'Programs', 'Piper', 'piper.exe');
+          if (fs.existsSync(_ep)) _piperBin = _ep;
+        }
+      }
 
       const args = ['--model', voicePath, '--output_file', tempWav];
       if (_ms.speakerId != null) args.push('--speaker', String(_ms.speakerId));
@@ -1112,7 +1102,15 @@ export function createAgentsTab(screen, services) {
   /** Windows-native sample: piper.exe → wav → detectWavPlayer */
   function _sampleWithPiperDirect(gen, voiceId, phrase) {
     const _spawnEnv = buildAudioEnv();
-    const piperBin = _resolvePiperBin();
+
+    // Resolve piper binary
+    let piperBin = 'piper';
+    const localAppData = process.env.LOCALAPPDATA ||
+      (process.env.USERPROFILE ? path.join(process.env.USERPROFILE, 'AppData', 'Local') : null);
+    if (localAppData) {
+      const exePath = path.join(localAppData, 'Programs', 'Piper', 'piper.exe');
+      if (fs.existsSync(exePath)) piperBin = exePath;
+    }
 
     // Resolve voice model path
     const ms = parseMultiSpeaker(voiceId);
@@ -1138,7 +1136,6 @@ export function createAgentsTab(screen, services) {
     _playingProcess = piper;
 
     piper.on('exit', (code) => {
-      // Generation changed — another preview was triggered; clean up silently
       if (gen !== _playGeneration) {
         try { fs.unlinkSync(tempWav); } catch {}
         return;
@@ -1150,12 +1147,6 @@ export function createAgentsTab(screen, services) {
         return;
       }
 
-      // Re-check generation after piper exit to close the race window (#154)
-      if (gen !== _playGeneration) {
-        try { fs.unlinkSync(tempWav); } catch {}
-        return;
-      }
-
       // Play the synthesized wav
       const wavPlayer = detectWavPlayer(_spawnEnv);
       if (!wavPlayer) {
@@ -1184,7 +1175,6 @@ export function createAgentsTab(screen, services) {
 
     piper.on('error', () => {
       if (gen === _playGeneration) { _playingProcess = null; _stopSpinner(); }
-      try { fs.unlinkSync(tempWav); } catch {}
     });
   }
 
@@ -1202,12 +1192,10 @@ export function createAgentsTab(screen, services) {
 
   // Common first-name → gender map for gender-aware auto-assign.
   // Only needs to cover names likely used as BMAD agent display names.
-  // Ambiguous names (sam, charlie, dana, max, pat, etc.) are intentionally
-  // omitted so they fall through to the gender-neutral 'other' pool (#156).
   const _NAME_GENDER = {
     // Female
     amelia: 'Female', amy: 'Female', anna: 'Female', betty: 'Female',
-    claire: 'Female', emma: 'Female', faye: 'Female',
+    claire: 'Female', dana: 'Female', emma: 'Female', faye: 'Female',
     grace: 'Female', heather: 'Female', ivy: 'Female', jane: 'Female',
     jenny: 'Female', julia: 'Female', kate: 'Female', laura: 'Female',
     lily: 'Female', maria: 'Female', mary: 'Female', nina: 'Female',
@@ -1216,12 +1204,12 @@ export function createAgentsTab(screen, services) {
     wendy: 'Female', zoe: 'Female',
     // Male
     alan: 'Male', barry: 'Male', bob: 'Male', carl: 'Male',
-    dan: 'Male', david: 'Male', eric: 'Male',
+    charlie: 'Male', dan: 'Male', david: 'Male', eric: 'Male',
     frank: 'Male', george: 'Male', hank: 'Male', jack: 'Male',
     james: 'Male', joe: 'Male', john: 'Male', kevin: 'Male',
-    leo: 'Male', mark: 'Male', murat: 'Male',
+    leo: 'Male', mark: 'Male', max: 'Male', murat: 'Male',
     nick: 'Male', oscar: 'Male', paul: 'Male', ray: 'Male',
-    ryan: 'Male', saif: 'Male', steve: 'Male',
+    ryan: 'Male', saif: 'Male', sam: 'Male', steve: 'Male',
     tom: 'Male', victor: 'Male', winston: 'Male', zach: 'Male',
   };
 
@@ -1250,17 +1238,15 @@ export function createAgentsTab(screen, services) {
     // Assign matching-gender voices first, then fall back to any available
     function assignGroup(agents, preferredPool, fallbackPools) {
       const allPools = [preferredPool, ...fallbackPools];
-      let reuseIdx = 0;
       agents.forEach(agent => {
         let voice = null;
         for (const pool of allPools) {
           voice = pool.find(v => !usedVoices.has(v));
           if (voice) break;
         }
-        // If all unique voices exhausted, round-robin reuse from preferred pool
+        // If all unique voices exhausted, reuse from preferred pool
         if (!voice && preferredPool.length > 0) {
-          voice = preferredPool[reuseIdx % preferredPool.length];
-          reuseIdx++;
+          voice = preferredPool[usedVoices.size % preferredPool.length];
         }
         if (voice) {
           usedVoices.add(voice);
@@ -1289,7 +1275,7 @@ export function createAgentsTab(screen, services) {
       const track = shuffled[i % shuffled.length];
       const existing = voiceStore.getAgentProfile(agent.id);
       voiceStore.setAgentProfile(agent.id, {
-        backgroundMusic: { track, volume: existing.backgroundMusic?.volume ?? 70, enabled: true },
+        backgroundMusic: { track, volume: existing.backgroundMusic?.volume ?? 20, enabled: true },
       });
     });
     return true;
@@ -1387,7 +1373,7 @@ export function createAgentsTab(screen, services) {
 
         case 'setMusic':
           _closeMenu(() => {
-            openTrackPicker(screen, '', 70, (track, volume) => {
+            openTrackPicker(screen, '', 20, (track, volume) => {
               _agents.forEach(agent => {
                 const p = voiceStore.getAgentProfile(agent.id);
                 voiceStore.setAgentProfile(agent.id, {
@@ -1403,7 +1389,7 @@ export function createAgentsTab(screen, services) {
 
         case 'setVolume':
           _closeMenu(() => {
-            const curVol = voiceStore.getAgentProfile(_agents[0]?.id)?.backgroundMusic?.volume ?? 70;
+            const curVol = voiceStore.getAgentProfile(_agents[0]?.id)?.backgroundMusic?.volume ?? 20;
             openVolumeInput(screen, curVol, (volume) => {
               _agents.forEach(agent => {
                 const p = voiceStore.getAgentProfile(agent.id);
@@ -1518,7 +1504,7 @@ export function createAgentsTab(screen, services) {
   // Key bindings
 
   agentList.key(['x', 'X'], () => {
-    const agent = _agents[agentList.selected];
+    const agent = _agents[agentList.selected ?? 0];
     if (agent) {
       voiceStore.resetAgentProfile(agent.id);
       refreshDisplay();
@@ -1527,12 +1513,12 @@ export function createAgentsTab(screen, services) {
 
 
   agentList.key(['enter'], () => {
-    const agent = _agents[agentList.selected];
+    const agent = _agents[agentList.selected ?? 0];
     if (agent) _openAgentDetailPanel(agent);
   });
 
   agentList.key(['space'], () => {
-    const agent = _agents[agentList.selected];
+    const agent = _agents[agentList.selected ?? 0];
     if (agent) _sampleAgent(agent);
   });
 
@@ -1642,6 +1628,16 @@ export function createAgentsTab(screen, services) {
     if (typeof focusMainTabBar === 'function') { focusMainTabBar(); screen.render(); }
   });
 
+  // -------------------------------------------------------------------------
+  // Language change handler
+
+  if (languageService) {
+    languageService.onChange(() => {
+      onboardingBox.setContent(_buildOnboardingText());
+      screen.render();
+    });
+  }
+
   // -------------------------------------------------------------------------
   // Tab Component Contract
 
@@ -1674,7 +1670,7 @@ export function createAgentsTab(screen, services) {
     },
 
     getFooterText() {
-      return _bmadDetected ? FOOTER_TEXT_BMAD : FOOTER_TEXT_NOBMAD;
+      return _bmadDetected ? _tl('bmadFooterBmad') : _tl('bmadFooterNobmad');
     },
 
     getFooterColor() {

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

@@ -8,6 +8,8 @@
  * Features: keyboard shortcuts reference, two sections, [/] search.
  */
 
+import { t } from '../../i18n/strings.js';
+
 const IS_TEST = process.env.AGENTVIBES_TEST_MODE === 'true';
 
 let blessed;
@@ -28,65 +30,60 @@ const COLORS = {
   footerBg:   '#607d8b',  // Gray — Help tab footer
 };
 
-const FOOTER_TEXT = '[↑↓/jk] Scroll  [/] Search  [PgUp/PgDn] Page  [S/V/M/A/R] Tab  [Q] Quit';
-
 // ---------------------------------------------------------------------------
-// Keyboard shortcuts data
-
-const SHORTCUT_SECTIONS = Object.freeze([
-  {
-    title: 'Global Shortcuts',
-    shortcuts: [
-      { key: 'Q',         desc: 'Quit the console' },
-      { key: 'Ctrl+C',    desc: 'Force quit' },
-      { key: 'S',         desc: 'Switch to Settings tab' },
-      { key: 'V',         desc: 'Switch to Voices tab' },
-      { key: 'M',         desc: 'Switch to Music tab' },
-      { key: 'R',         desc: 'Switch to Readme tab' },
-      { key: 'H',         desc: 'Switch to Help tab' },
-      { key: 'I',         desc: 'Switch to Install tab' },
-      { key: 'Esc',       desc: 'Close modal / go back' },
-    ],
-  },
-  {
-    title: 'Navigation Shortcuts',
-    shortcuts: [
-      { key: '↑↓ / j k',  desc: 'Navigate lists' },
-      { key: 'Enter',      desc: 'Select / activate' },
-      { key: 'Space',      desc: 'Toggle / preview' },
-      { key: 'Tab',        desc: 'Next button' },
-      { key: 'Shift+Tab',  desc: 'Previous button' },
-      { key: '/',          desc: 'Open search/filter' },
-      { key: 'F',          desc: 'Toggle favorites filter (Voices/Music)' },
-      { key: '*',          desc: 'Toggle favorite (Music tab)' },
-      { key: 'M',          desc: 'Toggle music on/off (Music tab)' },
-
-    ],
-  },
-  {
-    title: 'Tab Color Guide',
-    shortcuts: [
-      { key: 'Blue   (#2196f3)',  desc: 'Settings tab footer' },
-      { key: 'Teal   (#00695c)',  desc: 'Voices tab footer' },
-      { key: 'Orange (#ff9800)',  desc: 'Music tab footer' },
-
-      { key: 'Dark   (#455a64)',  desc: 'Readme tab footer' },
-      { key: 'Gray   (#607d8b)',  desc: 'Help tab footer' },
-      { key: 'Indigo (#3f51b5)',  desc: 'Install tab footer' },
-    ],
-  },
-]);
 
 /**
  * Return all shortcut sections.
  * @returns {{ title: string, shortcuts: { key: string, desc: string }[] }[]}
  */
 export function getShortcutSections() {
-  return [...SHORTCUT_SECTIONS];
+  return [
+    {
+      title: 'Global Shortcuts',
+      shortcuts: [
+        { key: 'Q',   desc: 'Quit the console' },
+        { key: 'Ctrl+C', desc: 'Force quit' },
+        { key: 'S',   desc: 'Switch to Settings tab' },
+        { key: 'V',   desc: 'Switch to Voices tab' },
+        { key: 'M',   desc: 'Switch to Music tab' },
+        { key: 'R',   desc: 'Switch to Readme tab' },
+        { key: 'H',   desc: 'Switch to Help tab' },
+        { key: 'I',   desc: 'Switch to Install tab' },
+        { key: 'Esc', desc: 'Close modal / go back' },
+      ],
+    },
+    {
+      title: 'Navigation Shortcuts',
+      shortcuts: [
+        { key: '↑↓ / j k', desc: 'Navigate lists' },
+        { key: 'Enter',     desc: 'Select / activate' },
+        { key: 'Space',     desc: 'Toggle / preview' },
+        { key: 'Tab',       desc: 'Next button' },
+        { key: 'Shift+Tab', desc: 'Previous button' },
+        { key: '/',         desc: 'Open search/filter' },
+        { key: 'F',         desc: 'Toggle favorites filter (Voices/Music)' },
+        { key: '*',         desc: 'Toggle favorite (Music tab)' },
+        { key: 'M',         desc: 'Toggle music on/off (Music tab)' },
+      ],
+    },
+    {
+      title: 'Tab Color Guide',
+      shortcuts: [
+        { key: 'Blue   (#2196f3)', desc: 'Settings tab footer' },
+        { key: 'Teal   (#00695c)', desc: 'Voices tab footer' },
+        { key: 'Orange (#ff9800)', desc: 'Music tab footer' },
+        { key: 'Dark   (#455a64)', desc: 'Readme tab footer' },
+        { key: 'Gray   (#607d8b)', desc: 'Help tab footer' },
+        { key: 'Indigo (#3f51b5)', desc: 'Install tab footer' },
+      ],
+    },
+  ];
 }
 
 // ---------------------------------------------------------------------------
 
+const _FOOTER_TEXT_EN = '[↑↓/jk] Scroll  [/] Search  [PgUp/PgDn] Page  [S/V/M/A/R] Tab  [Q] Quit';
+
 function createTestStub() {
   return {
     box: {},
@@ -94,7 +91,7 @@ function createTestStub() {
     hide: () => {},
     onFocus: () => {},
     onBlur: () => {},
-    getFooterText: () => FOOTER_TEXT,
+    getFooterText: () => _FOOTER_TEXT_EN,
     getFooterColor: () => COLORS.footerBg,
   };
 }
@@ -111,7 +108,52 @@ function createTestStub() {
 export function createHelpTab(screen, services) {
   if (IS_TEST) return createTestStub();
 
-  const { focusMainTabBar } = services;
+  const { focusMainTabBar, languageService } = services;
+  const _tl = (key) => languageService ? languageService.t(key) : t('en', key);
+
+  function _buildSections() {
+    return [
+      {
+        title: _tl('helpSectionGlobal'),
+        shortcuts: [
+          { key: 'Q',         desc: _tl('helpQuit') },
+          { key: 'Ctrl+C',    desc: _tl('helpForceQuit') },
+          { key: 'S',         desc: _tl('helpSwitchSettings') },
+          { key: 'V',         desc: _tl('helpSwitchVoices') },
+          { key: 'M',         desc: _tl('helpSwitchMusic') },
+          { key: 'R',         desc: _tl('helpSwitchReadme') },
+          { key: 'H',         desc: _tl('helpSwitchHelp') },
+          { key: 'I',         desc: _tl('helpSwitchInstall') },
+          { key: 'Esc',       desc: _tl('helpCloseModal') },
+        ],
+      },
+      {
+        title: _tl('helpSectionNavigation'),
+        shortcuts: [
+          { key: '↑↓ / j k',  desc: _tl('helpNavigateLists') },
+          { key: 'Enter',      desc: _tl('helpSelectActivate') },
+          { key: 'Space',      desc: _tl('helpTogglePreview') },
+          { key: 'Tab',        desc: _tl('helpNextButton') },
+          { key: 'Shift+Tab',  desc: _tl('helpPrevButton') },
+          { key: '/',          desc: _tl('helpOpenSearch') },
+          { key: 'F',          desc: _tl('helpToggleFavFilter') },
+          { key: '*',          desc: _tl('helpToggleFav') },
+          { key: 'M',          desc: _tl('helpToggleMusic') },
+        ],
+      },
+      {
+        title: _tl('helpSectionColors'),
+        shortcuts: [
+          { key: 'Blue   (#2196f3)', desc: _tl('helpColorSettings') },
+          { key: 'Teal   (#00695c)', desc: _tl('helpColorVoices') },
+          { key: 'Orange (#ff9800)', desc: _tl('helpColorMusic') },
+          { key: 'Dark   (#455a64)', desc: _tl('helpColorReadme') },
+          { key: 'Gray   (#607d8b)', desc: _tl('helpColorHelp') },
+          { key: 'Indigo (#3f51b5)', desc: _tl('helpColorInstall') },
+        ],
+      },
+    ];
+  }
 
   // -------------------------------------------------------------------------
   // Container
@@ -133,7 +175,7 @@ export function createHelpTab(screen, services) {
 
   function _buildContent(filterText) {
     const lines = [];
-    for (const section of SHORTCUT_SECTIONS) {
+    for (const section of _buildSections()) {
       lines.push(`{bold}{#546e7a-fg}── ${section.title} ${'─'.repeat(Math.max(0, 60 - section.title.length))}{/#546e7a-fg}{/bold}`);
       for (const { key, desc } of section.shortcuts) {
         const displayKey = key.padEnd(20);
@@ -183,11 +225,11 @@ export function createHelpTab(screen, services) {
     style: { fg: COLORS.keyFg, bg: '#1a3a5c', focus: { bg: '#245a80' } },
   });
 
-  blessed.text({
+  const searchLabel = blessed.text({
     parent: box,
     bottom: 2,
     left: 2,
-    content: 'Search:',
+    content: _tl('helpSearchLabel'),
     style: { fg: COLORS.descFg, bg: COLORS.contentBg },
   });
 
@@ -226,6 +268,17 @@ export function createHelpTab(screen, services) {
     if (typeof focusMainTabBar === 'function') { focusMainTabBar(); screen.render(); }
   });
 
+  // -------------------------------------------------------------------------
+  // Language change handler
+
+  if (languageService) {
+    languageService.onChange(() => {
+      scrollBox.setContent(_buildContent(''));
+      searchLabel.setContent(_tl('helpSearchLabel'));
+      screen.render();
+    });
+  }
+
   // -------------------------------------------------------------------------
   // Tab Component Contract
 
@@ -251,7 +304,7 @@ export function createHelpTab(screen, services) {
     onBlur() {},
 
     getFooterText() {
-      return FOOTER_TEXT;
+      return _tl('helpFooter');
     },
 
     getFooterColor() {