agentvibes 4.6.3 → 4.6.5

package/RELEASE_NOTES.md

@@ -1,5 +1,47 @@
 # AgentVibes Release Notes
 
+## 🔧 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).
+
+- **Standardized release process** — `/release` command now documents a privacy scan checkpoint: confirm no API keys, no personal info (email, phone, personal port numbers), before committing. CI must be green before releasing.
+
+### 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.5",
   "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

@@ -227,7 +227,7 @@ ${_tl('bmadDesc')}
 
   const box = blessed.box({
     parent: screen,
-    top: 4,
+    top: 5,
     left: 0,
     width: '100%',
     bottom: 2,

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,

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,

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,

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

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',
         }
@@ -5344,12 +5382,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'));