agentvibes 5.5.0 → 5.6.1

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

@@ -1,272 +1,272 @@
-/**
- * AgentVibes TUI Console — Readme Tab
- * Epic 13: Story 13.2
- *
- * Implements the Tab Component Contract:
- *   createReadmeTab(screen, services) → { box, show, hide, onFocus, onBlur, getFooterText, getFooterColor }
- *
- * Features: renders README.md with styled markdown, scrolling, search.
- */
-
-import fs from 'node:fs';
-import path from 'node:path';
-import { t } from '../../i18n/strings.js';
-
-const IS_TEST = process.env.AGENTVIBES_TEST_MODE === 'true';
-
-let blessed;
-if (!IS_TEST) {
-  const { default: b } = await import('blessed');
-  blessed = b;
-}
-
-// ---------------------------------------------------------------------------
-
-const COLORS = {
-  contentBg:  '#0a0e1a',
-  h1Fg:       '#69f0ae',  // Green — H1
-  h2Fg:       '#82b1ff',  // Blue — H2
-  h3Fg:       '#80d8ff',  // Light blue — H3
-  codeFg:     '#ffff00',  // Yellow — code spans
-  boldFg:     '#e3f2fd',  // Bright — bold text
-  quoteFg:    '#90a4ae',  // Gray — blockquotes
-  labelFg:    '#e3f2fd',
-  borderFg:   '#455a64',
-  footerBg:   '#455a64',  // Dark gray — Readme tab footer
-};
-
-const _FOOTER_TEXT_EN = '[↑↓/jk] Scroll  [PgUp/PgDn] Page  [/] Search  [S/V/M/A/R] Tab  [Q] Quit';
-
-// ---------------------------------------------------------------------------
-// Markdown renderer (story 13.2)
-
-/**
- * Render a single markdown line to blessed tagged string.
- * Handles: H1/H2/H3, bold (**), code spans (`), blockquotes (>), plain text.
- *
- * @param {string} line
- * @returns {string}
- */
-export function renderMarkdownLine(line) {
-  // H1
-  if (/^# /.test(line)) {
-    const text = line.replace(/^# /, '');
-    return `{bold}{${COLORS.h1Fg}-fg}${text}{/${COLORS.h1Fg}-fg}{/bold}`;
-  }
-  // H2
-  if (/^## /.test(line)) {
-    const text = line.replace(/^## /, '');
-    return `{bold}{${COLORS.h2Fg}-fg}${text}{/${COLORS.h2Fg}-fg}{/bold}`;
-  }
-  // H3
-  if (/^### /.test(line)) {
-    const text = line.replace(/^### /, '');
-    return `{${COLORS.h3Fg}-fg}${text}{/${COLORS.h3Fg}-fg}`;
-  }
-  // Blockquote
-  if (/^> /.test(line)) {
-    const text = line.replace(/^> /, '');
-    return `{${COLORS.quoteFg}-fg}│ ${text}{/${COLORS.quoteFg}-fg}`;
-  }
-  // Horizontal rule
-  if (/^---+$/.test(line.trim())) {
-    return `{${COLORS.quoteFg}-fg}${'─'.repeat(66)}{/${COLORS.quoteFg}-fg}`;
-  }
-
-  // Inline: code spans, bold
-  let result = line;
-  // Escape existing blessed tags (literal braces in content)
-  // Code spans: `text`
-  result = result.replace(/`([^`]+)`/g, `{${COLORS.codeFg}-fg}$1{/${COLORS.codeFg}-fg}`);
-  // Bold: **text**
-  result = result.replace(/\*\*([^*]+)\*\*/g, `{bold}$1{/bold}`);
-  // Italic: *text*
-  result = result.replace(/\*([^*]+)\*/g, `{${COLORS.h3Fg}-fg}$1{/${COLORS.h3Fg}-fg}`);
-
-  return result;
-}
-
-/**
- * Render full markdown content to blessed tagged multi-line string.
- * @param {string} markdown
- * @returns {string}
- */
-export function renderMarkdown(markdown) {
-  return markdown
-    .split('\n')
-    .map(line => renderMarkdownLine(line))
-    .join('\n');
-}
-
-// ---------------------------------------------------------------------------
-
-function createTestStub() {
-  return {
-    box: {},
-    show: () => {},
-    hide: () => {},
-    onFocus: () => {},
-    onBlur: () => {},
-    getFooterText: () => _FOOTER_TEXT_EN,
-    getFooterColor: () => COLORS.footerBg,
-  };
-}
-
-// ---------------------------------------------------------------------------
-
-/**
- * Create the Readme tab component.
- *
- * @param {object} screen   - Blessed screen instance
- * @param {object} services
- * @returns {{ box, show, hide, onFocus, onBlur, getFooterText, getFooterColor }}
- */
-export function createReadmeTab(screen, services) {
-  if (IS_TEST) return createTestStub();
-
-  const { focusMainTabBar, languageService } = services;
-  const _tl = (key) => languageService ? languageService.t(key) : t('en', key);
-
-  // -------------------------------------------------------------------------
-  // Container
-
-  const box = blessed.box({
-    parent: screen,
-    top: 5,
-    left: 0,
-    width: '100%',
-    bottom: 2,
-    hidden: true,
-    style: { fg: COLORS.labelFg, bg: COLORS.contentBg },
-    border: { type: 'line' },
-    borderStyle: { fg: COLORS.borderFg },
-  });
-
-  // -------------------------------------------------------------------------
-  // Load README.md
-
-  function _loadReadme() {
-    // Package root — works whether installed globally (node_modules/.bin) or run from source
-    const pkgRoot = path.resolve(new URL(import.meta.url).pathname, '..', '..', '..', '..');
-    const candidates = [
-      path.resolve(process.cwd(), 'README.md'),
-      path.resolve(process.cwd(), 'readme.md'),
-      path.resolve(pkgRoot, 'README.md'),  // AgentVibes package README fallback
-    ];
-    for (const p of candidates) {
-      if (fs.existsSync(p)) {
-        try {
-          return fs.readFileSync(p, 'utf8');
-        } catch {
-          // Unreadable
-        }
-      }
-    }
-    return `# README\n\n${_tl('readmeNotFound')}`;
-  }
-
-  // -------------------------------------------------------------------------
-  // Scrollable content
-
-  const scrollBox = blessed.box({
-    parent: box,
-    top: 1,
-    left: 2,
-    width: '96%',
-    bottom: 4,
-    scrollable: true,
-    alwaysScroll: true,
-    tags: true,
-    keys: true,
-    vi: true,
-    mouse: true,
-    scrollbar: { ch: '│', style: { fg: COLORS.borderFg } },
-    content: '',
-    style: { fg: COLORS.labelFg, bg: COLORS.contentBg },
-  });
-
-  // Scroll indicator
-  const scrollIndicator = blessed.text({
-    parent: box,
-    bottom: 2,
-    right: 2,
-    content: '',
-    tags: true,
-    style: { fg: COLORS.quoteFg, bg: COLORS.contentBg },
-  });
-
-  // -------------------------------------------------------------------------
-  // Render
-
-  function refreshContent() {
-    const markdown = _loadReadme();
-    const rendered = renderMarkdown(markdown);
-    scrollBox.setContent(rendered);
-    scrollIndicator.setContent(`{#607d8b-fg}${_tl('readmeScrollMore')}{/#607d8b-fg}`);
-    screen.render();
-  }
-
-  // Scroll events update indicator
-  scrollBox.on('scroll', () => {
-    const atBottom = scrollBox.getScrollPerc() >= 99;
-    scrollIndicator.setContent(
-      atBottom ? '' : `{#607d8b-fg}${_tl('readmeScrollMore')}{/#607d8b-fg}`
-    );
-    screen.render();
-  });
-
-  // PgUp/PgDn
-  scrollBox.key(['pageup'], () => {
-    scrollBox.scroll(-10);
-    screen.render();
-  });
-  scrollBox.key(['pagedown'], () => {
-    scrollBox.scroll(10);
-    screen.render();
-  });
-
-  // [↑] at top of content → jump to main header tab bar
-  scrollBox.key(['up'], () => {
-    if (scrollBox.getScroll() === 0 && typeof focusMainTabBar === 'function') {
-      focusMainTabBar();
-    }
-  });
-
-  // Escape → return to header tab bar
-  scrollBox.key(['escape'], () => {
-    if (typeof focusMainTabBar === 'function') { focusMainTabBar(); screen.render(); }
-  });
-
-  // -------------------------------------------------------------------------
-  // Tab Component Contract
-
-  return {
-    box,
-
-    show() {
-      box.show();
-      refreshContent();
-      screen.render();
-    },
-
-    hide() {
-      box.hide();
-      screen.render();
-    },
-
-    onFocus() {
-      scrollBox.focus();
-      screen.render();
-    },
-
-    onBlur() {},
-
-    getFooterText() {
-      return _tl('readmeFooter');
-    },
-
-    getFooterColor() {
-      return COLORS.footerBg;
-    },
-  };
-}
+/**
+ * AgentVibes TUI Console — Readme Tab
+ * Epic 13: Story 13.2
+ *
+ * Implements the Tab Component Contract:
+ *   createReadmeTab(screen, services) → { box, show, hide, onFocus, onBlur, getFooterText, getFooterColor }
+ *
+ * Features: renders README.md with styled markdown, scrolling, search.
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+import { t } from '../../i18n/strings.js';
+
+const IS_TEST = process.env.AGENTVIBES_TEST_MODE === 'true';
+
+let blessed;
+if (!IS_TEST) {
+  const { default: b } = await import('blessed');
+  blessed = b;
+}
+
+// ---------------------------------------------------------------------------
+
+const COLORS = {
+  contentBg:  '#0a0e1a',
+  h1Fg:       '#69f0ae',  // Green — H1
+  h2Fg:       '#82b1ff',  // Blue — H2
+  h3Fg:       '#80d8ff',  // Light blue — H3
+  codeFg:     '#ffff00',  // Yellow — code spans
+  boldFg:     '#e3f2fd',  // Bright — bold text
+  quoteFg:    '#90a4ae',  // Gray — blockquotes
+  labelFg:    '#e3f2fd',
+  borderFg:   '#455a64',
+  footerBg:   '#455a64',  // Dark gray — Readme tab footer
+};
+
+const _FOOTER_TEXT_EN = '[↑↓/jk] Scroll  [PgUp/PgDn] Page  [/] Search  [S/V/M/A/R] Tab  [Q] Quit';
+
+// ---------------------------------------------------------------------------
+// Markdown renderer (story 13.2)
+
+/**
+ * Render a single markdown line to blessed tagged string.
+ * Handles: H1/H2/H3, bold (**), code spans (`), blockquotes (>), plain text.
+ *
+ * @param {string} line
+ * @returns {string}
+ */
+export function renderMarkdownLine(line) {
+  // H1
+  if (/^# /.test(line)) {
+    const text = line.replace(/^# /, '');
+    return `{bold}{${COLORS.h1Fg}-fg}${text}{/${COLORS.h1Fg}-fg}{/bold}`;
+  }
+  // H2
+  if (/^## /.test(line)) {
+    const text = line.replace(/^## /, '');
+    return `{bold}{${COLORS.h2Fg}-fg}${text}{/${COLORS.h2Fg}-fg}{/bold}`;
+  }
+  // H3
+  if (/^### /.test(line)) {
+    const text = line.replace(/^### /, '');
+    return `{${COLORS.h3Fg}-fg}${text}{/${COLORS.h3Fg}-fg}`;
+  }
+  // Blockquote
+  if (/^> /.test(line)) {
+    const text = line.replace(/^> /, '');
+    return `{${COLORS.quoteFg}-fg}│ ${text}{/${COLORS.quoteFg}-fg}`;
+  }
+  // Horizontal rule
+  if (/^---+$/.test(line.trim())) {
+    return `{${COLORS.quoteFg}-fg}${'─'.repeat(66)}{/${COLORS.quoteFg}-fg}`;
+  }
+
+  // Inline: code spans, bold
+  let result = line;
+  // Escape existing blessed tags (literal braces in content)
+  // Code spans: `text`
+  result = result.replace(/`([^`]+)`/g, `{${COLORS.codeFg}-fg}$1{/${COLORS.codeFg}-fg}`);
+  // Bold: **text**
+  result = result.replace(/\*\*([^*]+)\*\*/g, `{bold}$1{/bold}`);
+  // Italic: *text*
+  result = result.replace(/\*([^*]+)\*/g, `{${COLORS.h3Fg}-fg}$1{/${COLORS.h3Fg}-fg}`);
+
+  return result;
+}
+
+/**
+ * Render full markdown content to blessed tagged multi-line string.
+ * @param {string} markdown
+ * @returns {string}
+ */
+export function renderMarkdown(markdown) {
+  return markdown
+    .split('\n')
+    .map(line => renderMarkdownLine(line))
+    .join('\n');
+}
+
+// ---------------------------------------------------------------------------
+
+function createTestStub() {
+  return {
+    box: {},
+    show: () => {},
+    hide: () => {},
+    onFocus: () => {},
+    onBlur: () => {},
+    getFooterText: () => _FOOTER_TEXT_EN,
+    getFooterColor: () => COLORS.footerBg,
+  };
+}
+
+// ---------------------------------------------------------------------------
+
+/**
+ * Create the Readme tab component.
+ *
+ * @param {object} screen   - Blessed screen instance
+ * @param {object} services
+ * @returns {{ box, show, hide, onFocus, onBlur, getFooterText, getFooterColor }}
+ */
+export function createReadmeTab(screen, services) {
+  if (IS_TEST) return createTestStub();
+
+  const { focusMainTabBar, languageService } = services;
+  const _tl = (key) => languageService ? languageService.t(key) : t('en', key);
+
+  // -------------------------------------------------------------------------
+  // Container
+
+  const box = blessed.box({
+    parent: screen,
+    top: 5,
+    left: 0,
+    width: '100%',
+    bottom: 2,
+    hidden: true,
+    style: { fg: COLORS.labelFg, bg: COLORS.contentBg },
+    border: { type: 'line' },
+    borderStyle: { fg: COLORS.borderFg },
+  });
+
+  // -------------------------------------------------------------------------
+  // Load README.md
+
+  function _loadReadme() {
+    // Package root — works whether installed globally (node_modules/.bin) or run from source
+    const pkgRoot = path.resolve(new URL(import.meta.url).pathname, '..', '..', '..', '..');
+    const candidates = [
+      path.resolve(process.cwd(), 'README.md'),
+      path.resolve(process.cwd(), 'readme.md'),
+      path.resolve(pkgRoot, 'README.md'),  // AgentVibes package README fallback
+    ];
+    for (const p of candidates) {
+      if (fs.existsSync(p)) {
+        try {
+          return fs.readFileSync(p, 'utf8');
+        } catch {
+          // Unreadable
+        }
+      }
+    }
+    return `# README\n\n${_tl('readmeNotFound')}`;
+  }
+
+  // -------------------------------------------------------------------------
+  // Scrollable content
+
+  const scrollBox = blessed.box({
+    parent: box,
+    top: 1,
+    left: 2,
+    width: '96%',
+    bottom: 4,
+    scrollable: true,
+    alwaysScroll: true,
+    tags: true,
+    keys: true,
+    vi: true,
+    mouse: true,
+    scrollbar: { ch: '│', style: { fg: COLORS.borderFg } },
+    content: '',
+    style: { fg: COLORS.labelFg, bg: COLORS.contentBg },
+  });
+
+  // Scroll indicator
+  const scrollIndicator = blessed.text({
+    parent: box,
+    bottom: 2,
+    right: 2,
+    content: '',
+    tags: true,
+    style: { fg: COLORS.quoteFg, bg: COLORS.contentBg },
+  });
+
+  // -------------------------------------------------------------------------
+  // Render
+
+  function refreshContent() {
+    const markdown = _loadReadme();
+    const rendered = renderMarkdown(markdown);
+    scrollBox.setContent(rendered);
+    scrollIndicator.setContent(`{#607d8b-fg}${_tl('readmeScrollMore')}{/#607d8b-fg}`);
+    screen.render();
+  }
+
+  // Scroll events update indicator
+  scrollBox.on('scroll', () => {
+    const atBottom = scrollBox.getScrollPerc() >= 99;
+    scrollIndicator.setContent(
+      atBottom ? '' : `{#607d8b-fg}${_tl('readmeScrollMore')}{/#607d8b-fg}`
+    );
+    screen.render();
+  });
+
+  // PgUp/PgDn
+  scrollBox.key(['pageup'], () => {
+    scrollBox.scroll(-10);
+    screen.render();
+  });
+  scrollBox.key(['pagedown'], () => {
+    scrollBox.scroll(10);
+    screen.render();
+  });
+
+  // [↑] at top of content → jump to main header tab bar
+  scrollBox.key(['up'], () => {
+    if (scrollBox.getScroll() === 0 && typeof focusMainTabBar === 'function') {
+      focusMainTabBar();
+    }
+  });
+
+  // Escape → return to header tab bar
+  scrollBox.key(['escape'], () => {
+    if (typeof focusMainTabBar === 'function') { focusMainTabBar(); screen.render(); }
+  });
+
+  // -------------------------------------------------------------------------
+  // Tab Component Contract
+
+  return {
+    box,
+
+    show() {
+      box.show();
+      refreshContent();
+      screen.render();
+    },
+
+    hide() {
+      box.hide();
+      screen.render();
+    },
+
+    onFocus() {
+      scrollBox.focus();
+      screen.render();
+    },
+
+    onBlur() {},
+
+    getFooterText() {
+      return _tl('readmeFooter');
+    },
+
+    getFooterColor() {
+      return COLORS.footerBg;
+    },
+  };
+}

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

@@ -725,7 +725,7 @@ export function createSetupTab(screen, services) {
     // Guard against double-open (key repeat, double-click)
     if (navigationService?.isModalOpen()) return;
     let _closed = false;
-    navigationService?.openModal();
+    navigationService?.openModal(null, _closeModal);
 
     const defaultPretext = {
       'claude-code': 'Claude Code here',
@@ -1035,7 +1035,7 @@ export function createSetupTab(screen, services) {
       }
     });
 
-    fieldList.key(['escape'], _closeModal);
+    fieldList.key(['escape', 'q', 'Q'], _closeModal);
 
     // Remove selection highlight when field list loses focus
     fieldList.on('blur', () => {
@@ -1081,14 +1081,14 @@ export function createSetupTab(screen, services) {
         allBtns[(i - 1 + allBtns.length) % allBtns.length].focus();
         screen.render();
       });
-      allBtns[i].key(['escape'], _closeModal);
+      allBtns[i].key(['escape', 'q', 'Q'], _closeModal);
       allBtns[i].key(['up'], () => {
         fieldList.focus();
         screen.render();
       });
     }
 
-    modal.key(['escape'], _closeModal);
+    modal.key(['escape', 'q', 'Q'], _closeModal);
     fieldList.focus();
     screen.render();
   }
@@ -1096,7 +1096,12 @@ export function createSetupTab(screen, services) {
   // ── TTS Engine picker (for config modal) ──────────────────────────────────
 
   function _openTtsEnginePicker(draft, onDone) {
-    navigationService?.openModal();
+    function _closePicker() {
+      navigationService?.closeModal();
+      destroyList(picker, screen);
+      onDone();
+    }
+    navigationService?.openModal(null, _closePicker);
 
     const engines = getEngineStatuses();
     const items = engines.map(e => {
@@ -1136,16 +1141,10 @@ export function createSetupTab(screen, services) {
       } else {
         draft.ttsEngine = engines[idx - 1].id;
       }
-      navigationService?.closeModal();
-      destroyList(picker, screen);
-      onDone();
+      _closePicker();
     });
 
-    picker.key(['escape'], () => {
-      navigationService?.closeModal();
-      destroyList(picker, screen);
-      onDone();
-    });
+    picker.key(['escape', 'q', 'Q'], _closePicker);
 
     picker.focus();
     screen.render();
@@ -1162,7 +1161,7 @@ export function createSetupTab(screen, services) {
   }
 
   function _openVoicePickerForLlm(draft, onDone) {
-    navigationService?.openModal();
+    navigationService?.openModal(null, _closeVP);
 
     let _allVoices = [];
     let _previewProc = null;
@@ -1355,7 +1354,16 @@ export function createSetupTab(screen, services) {
 
       piper.on('exit', (code) => {
         if (_previewVoiceId !== voiceId) { try { fs.unlinkSync(tempWav); } catch {} return; }
-        if (code !== 0) { _previewProc = null; _previewVoiceId = null; try { fs.unlinkSync(tempWav); } catch {} return; }
+        if (code !== 0) {
+          _previewProc = null; _previewVoiceId = null;
+          if (!_vpClosed) {
+            vpPreviewLine.setContent('{red-fg}♪ Preview failed — is Piper installed?{/red-fg}');
+            screen.render();
+            setTimeout(() => { if (!_vpClosed) { vpPreviewLine.setContent(''); screen.render(); } }, 4000);
+          }
+          try { fs.unlinkSync(tempWav); } catch {};
+          return;
+        }
         const wp = detectWavPlayer(_spawnEnv);
         if (!wp) return;
         const pp = spawn(wp.bin, wp.args(tempWav), {
@@ -1371,7 +1379,14 @@ export function createSetupTab(screen, services) {
           try { fs.unlinkSync(tempWav); } catch {}
         });
       });
-      piper.on('error', () => { _previewProc = null; _previewVoiceId = null; });
+      piper.on('error', () => {
+        _previewProc = null; _previewVoiceId = null;
+        if (!_vpClosed) {
+          vpPreviewLine.setContent('{red-fg}♪ Cannot find Piper — install it first{/red-fg}');
+          screen.render();
+          setTimeout(() => { if (!_vpClosed) { vpPreviewLine.setContent(''); screen.render(); } }, 4000);
+        }
+      });
     }
 
     vpList.key(['enter'], () => {
@@ -1390,7 +1405,7 @@ export function createSetupTab(screen, services) {
       const sel = _allVoices[vpList.selected];
       if (sel) { toggleThumbsDown(configService, sel); _refreshVP(); }
     });
-    vpList.key(['escape', 'q'], _closeVP);
+    vpList.key(['escape', 'q', 'Q'], _closeVP);
 
     // PageUp / PageDown / Home / End navigation
     const _pageSize = () => Math.max(1, (vpList.height ?? 10) - 2);

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

@@ -1349,7 +1349,7 @@ export function createVoicesTab(screen, services) {
     okGlobalBtn.key(['left'],           () => { okLocalBtn.focus();  screen.render(); });
     okLocalBtn.key(['left'],            () => { previewBtn.focus();  screen.render(); });
 
-    modal.key(['escape', 'q'], _close);
+    modal.key(['escape', 'q', 'Q'], _close);
 
     modal.setFront();
     okLocalBtn.focus();
@@ -1550,7 +1550,7 @@ export function createVoicesTab(screen, services) {
     dlBtn.key(['left'], () => { cancelBtn.focus(); screen.render(); });
     cancelBtn.key(['left'], () => { dlBtn.focus(); screen.render(); });
 
-    modal.key(['escape', 'q'], () => { if (!_downloading) _close(); });
+    modal.key(['escape', 'q', 'Q'], () => { if (!_downloading) _close(); });
 
     modal.setFront();
     dlBtn.focus();