agentvibes 4.6.3 → 4.6.6

package/RELEASE_NOTES.md

@@ -1,5 +1,65 @@
 # AgentVibes Release Notes
 
+## 🧭 v4.6.6 — Natural TUI Navigation
+
+**Release Date:** April 2026
+
+### Improvements
+
+The Settings TUI now navigates the way you'd expect. Arrow keys flow naturally top-to-bottom through the interface — main header → sub-tab bar → content → footer — with no surprising jumps or dead ends.
+
+- **Down from the main header** lands on the active sub-tab bar item, so you're always oriented before pressing further.
+- **Down through content** moves row-by-row within the current tab, reaching Full Preview and the Save buttons at the bottom. It no longer auto-jumps to the next sub-tab.
+- **Up from the first content row** returns you to the current sub-tab (not always Voice).
+- **Left/Right in the sub-tab bar** is the natural way to switch between Voice, Effects, Personality, Output, and Language tabs.
+- **Left/Right in the footer** moves between Full Preview, Save Globally, Save Locally, and Cancel Changes.
+- **Language tab** now has a proper scrollable list — arrow down to enter it, Up/Down to select a language, Enter to apply, Down past the last item to reach the footer.
+- **Readme tab** falls back to the AgentVibes package README when opened in a project folder that has no README of its own.
+- **Escape from the installer** now navigates cleanly to Settings instead of getting stuck.
+
+---
+
+## 🔧 v4.6.5 — Patch Release
+
+**Release Date:** April 2026
+
+### Improvements
+
+- **TUI non-interactive hint** — Installer header now shows a two-tone hint on row 2: `Skip this TUI?` (white) + `npx agentvibes install --non-interactive` (yellow), with a sponsor link on the right. Useful for CI/CD pipelines and scripted installs.
+
+- **`--non-interactive` routing fix** — `npx agentvibes install --non-interactive` (and `--yes`/`-y`) now correctly bypasses the TUI and routes directly to the CLI installer. Previously the TUI would still launch.
+
+- **Sponsor link in TUI header** — Row 2 of the header now shows a `♡ Sponsor this Developer  github.com/sponsors/paulpreibisch` link on the right side, alongside the non-interactive hint on the left.
+
+- **Consistent line endings via `.gitattributes`** — Added `.gitattributes` to enforce `LF` for shell scripts, JS, JSON, and markdown, and `CRLF` for PowerShell scripts. Prevents spurious `bin/` file modifications showing as dirty on Windows due to CRLF noise.
+
+- **`bin/` execute bits restored** — Re-indexed `bin/agent-vibes`, `bin/agentvibes-voice-browser.js`, `bin/mcp-server.js`, and `bin/test-bmad-pr` to ensure consistent line endings; verified all four retain `chmod +x` (`100755` mode).
+
+
+### User Impact
+
+- No functional changes — infrastructure and tooling improvements only
+
+---
+
+## 🐛 v4.6.4 — Patch Release
+
+**Release Date:** April 2026
+
+### Bug Fixes
+
+- **CI green on macOS** — `mktemp` with a file extension suffix (e.g. `tts-XXXXXX.wav`) works on Linux (GNU mktemp) but silently fails on macOS (BSD mktemp), which requires `XXXXXX` to be at the very end of the template. Fixed all 12 occurrences across `play-tts-piper.sh`, `play-tts-soprano.sh`, `play-tts-macos.sh`, and `audio-processor.sh` by creating the temp file without extension then renaming to add `.wav`/`.aiff`.
+
+- **macOS path symlink in test 213** — macOS transparently resolves `/var/folders/...` to `/private/var/folders/...` via a symlink. The voice-manager replay test was comparing against the unresolved path and failing. Fixed by using `cd && pwd` to get the real path before asserting.
+
+- **`bmad-party-speak.sh` execute permission** — The bash hook lost its `+x` bit, causing `party mode scripts ship with the package` CI test to fail. Restored `100755` mode via `git update-index`.
+
+### User Impact
+
+- No user-facing changes — CI infrastructure fixes only
+
+---
+
 ## 🐛 v4.6.3 — Patch Release
 
 **Release Date:** April 2026

package/bin/agentvibes.js

@@ -67,6 +67,11 @@ export function resolveStartTab(args, configService) {
   const cmd = args[0];
 
   if (cmd === 'install') {
+    // Non-interactive flags → delegate to CLI installer (src/installer.js), not TUI
+    const isNonInteractive = args.includes('--non-interactive') || args.includes('--yes') || args.includes('-y');
+    if (isNonInteractive) {
+      return { cliInstall: true, args: args.slice(1) };
+    }
     return { startTab: 'install' };
   }
 
@@ -139,6 +144,16 @@ if (_argv1 === _thisFile) {
     process.exit(1);
   }
 
+  if (result.cliInstall) {
+    // Route to CLI installer for non-interactive installs
+    const installerPath = path.resolve(__dirname, '..', 'src', 'installer.js');
+    execFileSync(process.execPath, [installerPath, 'install', ...result.args], {
+      stdio: 'inherit',
+      shell: false,
+    });
+    process.exit(0);
+  }
+
   launchConsole({ startTab: result.startTab }).catch(err => {
     process.stderr.write(`Failed to launch AgentVibes console: ${err.message}\n`);
     process.exit(1);

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "agentvibes",
-  "version": "4.6.3",
+  "version": "4.6.6",
   "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/src/console/app.js

@@ -151,7 +151,7 @@ export class AgentVibesConsole {
       top: 0,
       left: 0,
       width: '100%',
-      height: 3,
+      height: 4,
       tags: false,
       wrap: false,
       scrollable: false,
@@ -192,6 +192,28 @@ export class AgentVibesConsole {
       style: { bg: COLORS.headerBg },
     });
 
+    // Row 2: non-interactive mode hint — direct screen child (like tab items) so tags render correctly
+    blessed.text({
+      parent: this.screen,
+      top: 2,
+      left: 2,
+      shrink: true,
+      tags: true,
+      content: `{white-fg}Skip this TUI?{/white-fg}  {yellow-fg}npx agentvibes install --non-interactive{/yellow-fg}`,
+      style: { bg: COLORS.headerBg },
+    });
+
+    // Row 2 (right): sponsor message
+    blessed.text({
+      parent: this.screen,
+      top: 2,
+      right: 2,
+      shrink: true,
+      tags: true,
+      content: `{magenta-fg}\u2661{/magenta-fg} {white-fg}Sponsor this Developer{/white-fg}  {magenta-fg}github.com/sponsors/paulpreibisch{/magenta-fg}`,
+      style: { bg: COLORS.headerBg },
+    });
+
     // Row 1 (right): Active settings summary [provider][voice][effects][music]
     this._headerStatusText = blessed.text({
       parent: this.headerBox,
@@ -281,17 +303,17 @@ export class AgentVibesConsole {
     // Background strip — screen child so blessed uses absolute coordinates directly.
     // Tab items are ALSO screen children (not children of tabBarBox) to avoid the
     // WSL/Windows Terminal parent-relative positioning bug that renders them 1 row
-    // too high (at row 2 instead of row 3), producing a ghost duplicate tab bar.
+    // too high (at row 3 instead of row 4), producing a ghost duplicate tab bar.
     this.tabBarBox = blessed.box({
       parent: this.screen,
-      top: 3,
+      top: 4,
       left: 0,
       width: '100%',
       height: 1,
       style: { bg: COLORS.tabBarBg },
     });
 
-    // One box per tab — direct screen children at absolute top:3. No tag parsing, no wrapping.
+    // One box per tab — direct screen children at absolute top:4. No tag parsing, no wrapping.
     this._tabItems = {};
     this._tabItemXOffsets = {};  // track x positions for label refresh
     let xOffset = 1;
@@ -302,7 +324,7 @@ export class AgentVibesConsole {
       const text = ` [${shortcutKey}] ${label} `;
       const el = blessed.box({
         parent: this.screen,
-        top: 3,
+        top: 4,
         left: xOffset,
         width: text.length,
         height: 1,
@@ -318,14 +340,14 @@ export class AgentVibesConsole {
       xOffset += text.length + 1; // 1-space gap between tabs
     }
 
-    // Right-aligned Quit item — direct screen child at absolute top:3
+    // Right-aligned Quit item — direct screen child at absolute top:4
     const _quitText  = ' [Q] Quit ';
     const _quitBase  = _quitText;
     const _quitBlock = _quitText.slice(0, -1) + '█';
     let _quitInterval = null;
     this._quitItem = blessed.box({
       parent: this.screen,
-      top: 3,
+      top: 4,
       right: 1,
       width: _quitText.length,
       height: 1,
@@ -532,12 +554,12 @@ export class AgentVibesConsole {
   }
 
   // ---------------------------------------------------------------------------
-  // Private: Content area (rows 4..N-1) — tab components mount here
+  // Private: Content area (rows 5..N-1) — tab components mount here
 
   _createContentArea() {
     // bottom: 2 reserves 2 rows at the bottom: context footer (story 6.3) + GitHub footer
     this.contentArea = blessed.box({
-      top: 4,
+      top: 5,
       left: 0,
       width: '100%',
       bottom: 2,
@@ -747,18 +769,18 @@ export class AgentVibesConsole {
       this.screen.render = () => {};
 
       try {
-        // Nuclear clear: wipe the content area (row 4+) to remove stale cell content
-        // from the previous tab. Start at row 4 — header (0-2) and tab bar (3) are
+        // Nuclear clear: wipe the content area (row 5+) to remove stale cell content
+        // from the previous tab. Start at row 5 — header (0-3) and tab bar (4) are
         // static widgets that don't need clearing; wiping them causes the double
-        // tab bar artifact (row 2 of header shows tab bar ghost from prior render).
+        // tab bar artifact (row 3 of header shows tab bar ghost from prior render).
         // blessed's render loop never resets the `lines` buffer before rendering
         // (see: blessed/lib/widgets/screen.js line 733, commented-out clear).
-        this.screen.clearRegion(0, this.screen.cols, 4, this.screen.rows - 2);
+        this.screen.clearRegion(0, this.screen.cols, 5, this.screen.rows - 2);
 
         // Force-invalidate olines for the entire visible area (rows 0..rows-3).
-        // Includes header rows 0-1 so the branded header is always redrawn on
+        // Includes header rows 0-3 so the branded header is always redrawn on
         // tab switches — prevents corruption from persisting across tabs.
-        // Row 2 (header bottom), row 3 (tab bar) and content rows accumulate
+        // Row 3 (header bottom), row 4 (tab bar) and content rows accumulate
         // ghost rendering artifacts — draw() skips them when lines==olines even
         // though the terminal still shows stale chars from earlier renders.
         // Setting attr=-1 is impossible for any real cell, so draw() is forced
@@ -772,13 +794,13 @@ export class AgentVibesConsole {
           orow.dirty = true;
         }
 
-        // Row 2 (header bottom) is never dirty after draw 1 — its content (headerBg+
+        // Row 3 (header bottom) is never dirty after draw 1 — its content (headerBg+
         // spaces) never changes so element.render() never marks it dirty.  The olines
-        // invalidation above sets olines[2][c][0]=-1, but draw() only compares cells
+        // invalidation above sets olines[3][c][0]=-1, but draw() only compares cells
         // when lines[r].dirty is true; a false dirty flag skips the entire row without
         // ever consulting olines.  Force-mark it dirty so draw() emits the explicit
-        // cup(3,1)+headerBg+spaces sequence and overwrites any ghost terminal content.
-        if (this.screen.lines?.[2]) this.screen.lines[2].dirty = true;
+        // cup(4,1)+headerBg+spaces sequence and overwrites any ghost terminal content.
+        if (this.screen.lines?.[3]) this.screen.lines[3].dirty = true;
 
         // Update tab bar, footer, and header status inside suppression — no intermediate render.
         this._updateTabBar(tabId);

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

@@ -124,7 +124,7 @@ const COLORS = {
   sectionHdr: '#7b1fa2',
   labelFg:    '#e3f2fd',
   valueFg:    '#ffff00',
-  activeFg:   '#ce93d8',
+
   btnDefault: '#6a1b9a',
   btnFocus:   '#2e7d32',  // Green — focused/selected
   btnFocusFg: '#ffffff',
@@ -227,7 +227,7 @@ ${_tl('bmadDesc')}
 
   const box = blessed.box({
     parent: screen,
-    top: 4,
+    top: 5,
     left: 0,
     width: '100%',
     bottom: 2,
@@ -304,7 +304,7 @@ ${_tl('bmadDesc')}
       fg: COLORS.labelFg,
       bg: COLORS.contentBg,
       border: { fg: COLORS.borderFg },
-      selected: { bg: '#4a148c', fg: COLORS.activeFg, bold: true },
+      selected: { bg: 'blue', fg: 'yellow' },
       item: { fg: COLORS.labelFg },
     },
   });
@@ -681,7 +681,7 @@ ${_tl('bmadDesc')}
         fg: COLORS.labelFg,
         bg: COLORS.contentBg,
         border: { fg: '#4a148c' },
-        selected: { bg: '#4a148c', fg: COLORS.activeFg, bold: true },
+        selected: { bg: 'blue', fg: 'yellow' },
         item: { fg: COLORS.labelFg },
       },
     });
@@ -1529,7 +1529,7 @@ ${_tl('bmadDesc')}
         fg: COLORS.labelFg,
         bg: COLORS.contentBg,
         border: { fg: COLORS.btnFocus },
-        selected: { bg: '#4a148c', fg: COLORS.activeFg, bold: true },
+        selected: { bg: 'blue', fg: 'yellow' },
         item: { fg: COLORS.labelFg },
       },
     });

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

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

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

@@ -166,7 +166,7 @@ export function createInstallTab(screen, services) {
 
   const box = blessed.box({
     parent: screen,
-    top: 4,
+    top: 5,
     left: 0,
     width: '100%',
     bottom: 2,
@@ -942,13 +942,10 @@ export function createInstallTab(screen, services) {
       _screen--;
       _showCurrentScreen();
     } else {
-      box.hide();
-      screen.render();
-      // Defer so the escape keypress event finishes propagating before focus changes.
-      // Calling focusMainTabBar() synchronously here would set focus to the tab bar
-      // item mid-event, causing its own key(['escape']) handler to fire in the same
-      // emission and call onFocus() → re-focus a button inside the now-hidden box.
-      if (typeof focusMainTabBar === 'function') setTimeout(() => focusMainTabBar(), 0);
+      // User pressed Escape at the first screen — they want out of the installer.
+      // Switch to Settings so they can configure without being stuck on the install tab.
+      // (focusMainTabBar would re-focus the install tab item, which loops back here.)
+      setTimeout(() => navigationService?.switchTab('settings'), 0);
     }
   });
 

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

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

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

@@ -132,7 +132,7 @@ export function createReadmeTab(screen, services) {
 
   const box = blessed.box({
     parent: screen,
-    top: 4,
+    top: 5,
     left: 0,
     width: '100%',
     bottom: 2,
@@ -146,9 +146,12 @@ export function createReadmeTab(screen, services) {
   // 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)) {

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

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