agentvibes 4.0.0 → 4.2.0

package/src/console/widgets/personality-picker.js

@@ -0,0 +1,185 @@
+/**
+ * AgentVibes TUI — Shared Widget: Personality Picker
+ *
+ * Inline modal list for selecting voice personalities with TTS preview.
+ * Extracted from settings-tab.js for reuse across tabs.
+ */
+
+import path from 'node:path';
+import { spawn } from 'node:child_process';
+import { destroyList } from './destroy-list.js';
+import { buildAudioEnv } from '../audio-env.js';
+import { BRAND_PINK } from '../brand-colors.js';
+import { PERSONALITY_EMOJIS, PERSONALITIES } from '../constants/personalities.js';
+
+export { PERSONALITY_EMOJIS, PERSONALITIES };
+
+const IS_TEST = process.env.AGENTVIBES_TEST_MODE === 'true';
+let blessed;
+if (!IS_TEST) {
+  const { default: b } = await import('blessed');
+  blessed = b;
+}
+
+const _modalTitle = (text) => ` {${BRAND_PINK}-fg}${text}{/${BRAND_PINK}-fg} `;
+
+const PERSONALITY_PREVIEW_PHRASES = Object.freeze({
+  angry:        "UNACCEPTABLE! This build time is a DISASTER! Fix it NOW or so help me!",
+  annoying:     "Oh oh oh! Can I tell you something? Can I? Can I? PLEASE? It is so important!",
+  crass:        "Well damn, that code runs like my uncle's truck. Barely, and it smells funny.",
+  dramatic:     "The tests... have failed. I don't know how much longer I can do this.",
+  'dry-humor':  "Your code worked. I too am surprised.",
+  flirty:       "Ooh, a clean merge? You know exactly how to make my heart race.",
+  funny:        "Why do programmers hate nature? Too many bugs. I will show myself out.",
+  grandpa:      "Back in my day, we compiled by hand. Uphill. In the snow. Both ways.",
+  millennial:   "I literally cannot even with this error. I am so done. Like, actually deceased.",
+  moody:        "...It works. Whatever. Do not get used to it.",
+  pirate:       "Arrr! The build be sailin' smooth today, matey! No barnacles in sight!",
+  poetic:       "Like rivers to the sea, your code flows toward eventual compilation.",
+  professional: "I have completed the requested task and am prepared to document outcomes.",
+  rapper:       "Yo! Clean code flowin', tests are glowin', no bugs showin'!",
+  robot:        "TASK COMPLETE. EFFICIENCY: OPTIMAL. PROBABILITY OF SUCCESS: 97.3 PERCENT. BEEP.",
+  sarcastic:    "Oh wow, another bug. What a completely unexpected surprise. Truly shocking.",
+  sassy:        "Honey, whoever told you that was good code was not your friend.",
+  'surfer-dude':"Duuude! That commit totally shredded! Gnarly clean code, bro!",
+  zen:          "The bug is not the enemy. The bug is the teacher. Breathe. Commit.",
+  random:       "Who will I be today? Even I do not know. Expect the unexpected.",
+});
+
+/**
+ * Open the personality picker modal.
+ *
+ * @param {object}   screen             - blessed screen
+ * @param {string}   currentPersonality - current personality value
+ * @param {Function} onSelect           - called with selected personality
+ * @param {Function} [onClose]          - called after modal closes
+ */
+export function openPersonalityPicker(screen, currentPersonality, onSelect, onClose) {
+  const current = currentPersonality ?? 'none';
+  const currentIdx = Math.max(0, PERSONALITIES.indexOf(current));
+
+  const COLORS = {
+    btnFocus: '#00e5ff',
+    btnFocusFg: '#000000',
+  };
+
+  const list = blessed.list({
+    parent: screen,
+    top: 'center',
+    left: 'center',
+    width: 44,
+    height: Math.min(PERSONALITIES.length + 4, 22),
+    border: { type: 'line' },
+    tags: true,
+    label: _modalTitle('Select Personality'),
+    items: PERSONALITIES.map((p, i) => {
+      const emoji = PERSONALITY_EMOJIS[p] ?? '✨';
+      const label = p === 'none' ? 'None' : p.charAt(0).toUpperCase() + p.slice(1);
+      const mark  = i === currentIdx ? '✅' : '   ';
+      return `${mark} ${emoji} ${label}`;
+    }),
+    keys: true,
+    vi: true,
+    mouse: true,
+    style: {
+      border: { fg: COLORS.btnFocus },
+      selected: { bg: COLORS.btnFocus, fg: COLORS.btnFocusFg, bold: true },
+      item: { fg: '#e3f2fd' },
+    },
+  });
+
+  list.select(currentIdx);
+  list.focus();
+  screen.render();
+
+  // TTS preview on hover
+  let _pickerTtsProc = null;
+  let _playingItemIdx = -1;
+
+  function _setItemPlaying(idx, playing) {
+    const item = list.items?.[idx];
+    if (!item) return;
+    const base = (item.content ?? '').replace(/ █$/, '').replace(/ \(playing\)$/, '');
+    item.setContent(playing ? `${base} (playing)` : base);
+  }
+
+  function _killPickerTts() {
+    if (_pickerTtsProc) {
+      try { process.kill(-_pickerTtsProc.pid, 'SIGTERM'); } catch {}
+      _pickerTtsProc = null;
+    }
+    if (_playingItemIdx >= 0) {
+      _setItemPlaying(_playingItemIdx, false);
+      _playingItemIdx = -1;
+    }
+  }
+
+  function _speakPreview(personality) {
+    _killPickerTts();
+    const phrase = PERSONALITY_PREVIEW_PHRASES[personality];
+    if (!phrase) return;
+    const ttsScript = path.join(process.cwd(), '.claude', 'hooks', 'play-tts.sh');
+    _pickerTtsProc = spawn('bash', [ttsScript, phrase], {
+      stdio: 'ignore',
+      detached: true,
+      env: buildAudioEnv(),
+    });
+    _playingItemIdx = list.selected;
+    _setItemPlaying(_playingItemIdx, true);
+    screen.render();
+    _pickerTtsProc.on('exit', () => {
+      if (_playingItemIdx >= 0) {
+        _setItemPlaying(_playingItemIdx, false);
+        _playingItemIdx = -1;
+        screen.render();
+      }
+      _pickerTtsProc = null;
+    });
+    _pickerTtsProc.unref();
+  }
+
+  list.on('select item', () => {
+    _speakPreview(PERSONALITIES[list.selected]);
+  });
+
+  list.key(['space'], () => {
+    if (_pickerTtsProc && _playingItemIdx === list.selected) {
+      _killPickerTts();
+    } else {
+      _speakPreview(PERSONALITIES[list.selected]);
+    }
+  });
+
+  // Type-to-jump
+  const _jumpBlocked = new Set(['j', 'k', 'g', 'h', 'l', 'd', 'u', 'q']);
+  list.on('keypress', (ch, key) => {
+    if (!ch || key.ctrl || key.meta) return;
+    const lower = ch.toLowerCase();
+    if (!/^[a-z]$/.test(lower)) return;
+    if (_jumpBlocked.has(lower)) return;
+    const count = PERSONALITIES.length;
+    const start = list.selected ?? 0;
+    for (let i = 1; i <= count; i++) {
+      const idx = (start + i) % count;
+      if (PERSONALITIES[idx].startsWith(lower)) {
+        list.select(idx);
+        screen.render();
+        break;
+      }
+    }
+  });
+
+  list.key(['enter'], () => {
+    const selected = PERSONALITIES[list.selected];
+    if (!selected) return;
+    _killPickerTts();
+    // Call onSelect before destroying to avoid stale-state re-renders
+    onSelect(selected);
+    destroyList(list, screen, onClose);
+  });
+
+  list.key(['escape', 'q'], () => {
+    _killPickerTts();
+    destroyList(list, screen, onClose);
+  });
+}

package/src/console/widgets/reverb-picker.js

@@ -0,0 +1,94 @@
+/**
+ * AgentVibes TUI — Shared Widget: Reverb Preset Picker
+ *
+ * Inline modal list for selecting reverb presets.
+ * Extracted from settings-tab.js for reuse across tabs.
+ */
+
+import path from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { destroyList } from './destroy-list.js';
+import { BRAND_PINK } from '../brand-colors.js';
+
+const IS_TEST = process.env.AGENTVIBES_TEST_MODE === 'true';
+let blessed;
+if (!IS_TEST) {
+  const { default: b } = await import('blessed');
+  blessed = b;
+}
+
+const _modalTitle = (text) => ` {${BRAND_PINK}-fg}${text}{/${BRAND_PINK}-fg} `;
+
+export const REVERB_PRESETS = Object.freeze([
+  { label: 'Off (Dry, no reverb)',        value: 'off' },
+  { label: 'Light (Small room)',           value: 'light' },
+  { label: 'Medium (Conference room)',     value: 'medium' },
+  { label: 'Heavy (Large hall)',           value: 'heavy' },
+  { label: 'Cathedral (Epic space)',       value: 'cathedral' },
+]);
+
+/**
+ * Open the reverb preset picker modal.
+ *
+ * @param {object}   screen        - blessed screen
+ * @param {string}   currentPreset - current reverb preset value
+ * @param {Function} onSelect      - called with selected preset value
+ * @param {Function} [onClose]     - called after modal closes
+ * @param {object}   [opts]        - options
+ * @param {boolean}  [opts.applyToEffectsManager=true] - whether to apply via effects-manager.sh
+ */
+export function openReverbPicker(screen, currentPreset, onSelect, onClose, opts = {}) {
+  const applyToEffectsManager = opts.applyToEffectsManager !== false;
+  const currentIdx = Math.max(0, REVERB_PRESETS.findIndex(p => p.value === currentPreset));
+
+  const COLORS = {
+    btnFocus: '#00e5ff',
+    btnFocusFg: '#000000',
+  };
+
+  const list = blessed.list({
+    parent: screen,
+    top: 'center',
+    left: 'center',
+    width: 40,
+    height: REVERB_PRESETS.length + 4,
+    border: { type: 'line' },
+    tags: true,
+    label: _modalTitle('Select Reverb Preset'),
+    items: REVERB_PRESETS.map((p, i) => (i === currentIdx ? `● ${p.label}` : `  ${p.label}`)),
+    keys: true,
+    vi: false,
+    mouse: true,
+    style: {
+      border: { fg: COLORS.btnFocus },
+      selected: { bg: COLORS.btnFocus, fg: COLORS.btnFocusFg, bold: true },
+      item: { fg: '#e3f2fd' },
+    },
+  });
+
+  list.select(currentIdx);
+  list.focus();
+  screen.render();
+
+  list.key(['enter', 'space'], () => {
+    const selected = REVERB_PRESETS[list.selected];
+    if (!selected) return;
+
+    if (applyToEffectsManager) {
+      const effectsScript = path.join(process.cwd(), '.claude', 'hooks', 'effects-manager.sh');
+      spawnSync('bash', [effectsScript, 'set-reverb', selected.value, 'default'], {
+        stdio: 'ignore',
+        timeout: 5000,
+        env: { ...process.env },
+      });
+    }
+
+    // Call onSelect before destroying to avoid stale-state re-renders
+    onSelect(selected.value);
+    destroyList(list, screen, onClose);
+  });
+
+  list.key(['escape', 'q'], () => {
+    destroyList(list, screen, onClose);
+  });
+}

package/src/console/widgets/track-picker.js

@@ -0,0 +1,285 @@
+/**
+ * AgentVibes TUI — Shared Widget: Background Music Track Picker
+ *
+ * Inline modal list for selecting background music tracks.
+ * Extracted from settings-tab.js for reuse across tabs.
+ * Space previews track, Enter selects.
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+import { spawn } from 'node:child_process';
+import { destroyList } from './destroy-list.js';
+import { BRAND_PINK } from '../brand-colors.js';
+import { formatTrackName } from './format-utils.js';
+import { buildAudioEnv, detectMp3Player } from '../audio-env.js';
+
+const IS_TEST = process.env.AGENTVIBES_TEST_MODE === 'true';
+let blessed;
+if (!IS_TEST) {
+  const { default: b } = await import('blessed');
+  blessed = b;
+}
+
+const _modalTitle = (text) => ` {${BRAND_PINK}-fg}${text}{/${BRAND_PINK}-fg} `;
+const _hintLabel = '{#455a64-fg}[Space] Preview  [Enter] Select  [Esc] Cancel{/#455a64-fg}';
+
+/**
+ * Open a small volume input modal (0–100).
+ * Left/Right arrows adjust by 5; type a number directly; Enter confirms.
+ *
+ * @param {object}   screen     - blessed screen
+ * @param {number}   currentVol - current volume (0-100)
+ * @param {Function} onConfirm  - called with volume (number) on Enter
+ * @param {Function} [onClose]  - called when modal closes (confirm or cancel)
+ */
+export function openVolumeInput(screen, currentVol, onConfirm, onClose) {
+  if (IS_TEST) { onConfirm(currentVol ?? 70); return; }
+  let vol = (Number.isFinite(currentVol) && currentVol >= 0 && currentVol <= 100)
+    ? currentVol : 70;
+
+  const box = blessed.box({
+    parent: screen,
+    top: 'center',
+    left: 'center',
+    width: 38,
+    height: 8,
+    border: { type: 'line' },
+    tags: true,
+    label: _modalTitle('Music Volume'),
+    style: { border: { fg: '#00e5ff' } },
+  });
+
+  const barText = blessed.text({
+    parent: box,
+    top: 1,
+    left: 2,
+    width: 32,
+    tags: true,
+    content: '',
+  });
+
+  const hint = blessed.text({
+    parent: box,
+    top: 5,
+    left: 1,
+    width: 34,
+    tags: true,
+    content: '{#455a64-fg}[←→] ±5  [1-9] type  [Enter] OK  [Esc] Cancel{/#455a64-fg}',
+  });
+
+  function _renderBar() {
+    const filled = Math.round(vol / 5);
+    const empty = 20 - filled;
+    const bar = '{#00e5ff-fg}' + '█'.repeat(filled) + '{/#00e5ff-fg}' +
+                '{#263238-fg}' + '░'.repeat(empty) + '{/#263238-fg}';
+    barText.setContent(`{#90a4ae-fg}Volume:{/#90a4ae-fg} ${bar} {bold}${vol}%{/bold}`);
+    screen.render();
+  }
+  _renderBar();
+
+  // Capture keypress directly on screen to avoid input mode issues
+  let _digits = '';
+  function _onKey(ch, key) {
+    const name = key?.name ?? '';
+    if (name === 'enter') { _close(true); return; }
+    if (name === 'escape') { _close(false); return; }
+    if (name === 'left')  { vol = Math.max(0, vol - 5);   _digits = ''; _renderBar(); return; }
+    if (name === 'right') { vol = Math.min(100, vol + 5); _digits = ''; _renderBar(); return; }
+    if (ch && /^[0-9]$/.test(ch)) {
+      _digits += ch;
+      const n = parseInt(_digits, 10);
+      if (n >= 0 && n <= 100) { vol = n; _renderBar(); }
+      if (_digits.length >= 3) _digits = '';
+    }
+  }
+  screen.on('keypress', _onKey);
+
+  function _close(confirm) {
+    screen.removeListener('keypress', _onKey);
+    box.destroy();
+    screen.render();
+    if (confirm && onConfirm) onConfirm(vol);
+    if (onClose) onClose();
+  }
+}
+
+const BUILT_IN_TRACKS = [
+  { label: '🎻 Soft Flamenco',  file: 'agentvibes_soft_flamenco_loop.mp3' },
+  { label: '🌸 Bossa Nova',     file: 'agent_vibes_bossa_nova_v2_loop.mp3' },
+  { label: '🌊 Chillwave',      file: 'agent_vibes_chillwave_v2_loop.mp3' },
+  { label: '🪘 Gnawa Ambient',  file: 'agent_vibes_ganawa_ambient_v2_loop.mp3' },
+];
+
+/**
+ * Open the background music track picker modal.
+ * After selecting a track, prompts for volume (0-100) via openVolumeInput.
+ *
+ * @param {object}   screen        - blessed screen
+ * @param {string}   currentTrack  - currently selected track filename
+ * @param {number}   currentVolume - currently set volume (0-100, default 70)
+ * @param {Function} onSelect      - called with (trackFile, volume)
+ * @param {Function} [onClose]     - called after modal fully closes
+ */
+export function openTrackPicker(screen, currentTrack, currentVolume, onSelect, onClose) {
+  const tracksDir = path.join(process.cwd(), '.claude', 'audio', 'tracks');
+  let tracks;
+  try {
+    const files = fs.readdirSync(tracksDir);
+    tracks = files
+      .filter(f => /\.mp3$/i.test(f))
+      .sort()
+      .map(f => ({ file: f, label: formatTrackName(f) }));
+  } catch {
+    tracks = BUILT_IN_TRACKS;
+  }
+
+  const COLORS = {
+    btnFocus: '#00e5ff',
+    btnFocusFg: '#000000',
+  };
+
+  const items = tracks.map(t =>
+    t.file === currentTrack ? `● ${t.label}` : `  ${t.label}`
+  );
+  const currentIdx = tracks.findIndex(t => t.file === currentTrack);
+
+  const listHeight = Math.min(tracks.length + 6, Math.floor(screen.rows * 0.7));
+  const list = blessed.list({
+    parent: screen,
+    top: 'center',
+    left: 'center',
+    width: 54,
+    height: listHeight,
+    border: { type: 'line' },
+    tags: true,
+    label: _modalTitle('Select Track'),
+    items,
+    keys: true,
+    vi: false,
+    mouse: true,
+    scrollable: true,
+    scrollbar: { ch: '│', track: { bg: '#1e2a3a' }, style: { fg: COLORS.btnFocus } },
+    style: {
+      border: { fg: COLORS.btnFocus },
+      selected: { bg: COLORS.btnFocus, fg: COLORS.btnFocusFg, bold: true },
+      item: { fg: '#e3f2fd' },
+    },
+  });
+
+  // Helper: update hint text in the bottom border label
+  function _setHint(text) {
+    list.setLabel({ text: _modalTitle('Select Track'), side: 'left' });
+    // Use _ prefix convention for bottom border content (blessed doesn't have setFooter)
+    list._label2 && list._label2.destroy();
+    list._label2 = blessed.text({
+      parent: list,
+      bottom: -1,
+      left: 1,
+      width: 50,
+      height: 1,
+      tags: true,
+      content: text,
+      style: { fg: '#e3f2fd' },
+    });
+    screen.render();
+  }
+
+  _setHint(_hintLabel);
+
+  if (currentIdx >= 0) list.select(currentIdx);
+  list.focus();
+  screen.render();
+
+  // Preview playback state
+  const _spawnEnv = buildAudioEnv();
+  const _mp3Player = detectMp3Player(_spawnEnv);
+  let _previewProc = null;
+  let _previewTrackId = null;
+
+  function _killPreview() {
+    if (_previewProc) {
+      try { process.kill(-_previewProc.pid, 'SIGTERM'); } catch {}
+      _previewProc = null;
+    }
+    _previewTrackId = null;
+  }
+
+  function _previewTrack(trackFile) {
+    // Toggle off if same track
+    if (_previewTrackId === trackFile) {
+      _killPreview();
+      _setHint(_hintLabel);
+      return;
+    }
+
+    _killPreview();
+
+    const trackPath = path.resolve(tracksDir, trackFile);
+    const safeBase = path.resolve(tracksDir);
+    if (!trackPath.startsWith(safeBase + path.sep) && trackPath !== safeBase) return;
+
+    if (!_mp3Player || !fs.existsSync(trackPath)) {
+      _setHint('{red-fg}No MP3 player found or track missing{/red-fg}');
+      setTimeout(() => {
+        _setHint(_hintLabel);
+      }, 3000);
+      return;
+    }
+
+    _previewProc = spawn(_mp3Player.bin, _mp3Player.args(trackPath), {
+      stdio: 'ignore', detached: true, env: _spawnEnv,
+    });
+    _previewTrackId = trackFile;
+
+    const label = tracks.find(t => t.file === trackFile)?.label ?? trackFile;
+    _setHint(`{#00e5ff-fg}♪ Previewing: ${label}  (Space to stop){/#00e5ff-fg}`);
+
+    _previewProc.on('exit', () => {
+      if (_previewTrackId === trackFile) {
+        _previewTrackId = null;
+        _previewProc = null;
+        _setHint(_hintLabel);
+      }
+    });
+
+    _previewProc.on('error', () => {
+      _previewTrackId = null;
+      _previewProc = null;
+    });
+  }
+
+  function _close(callback) {
+    _killPreview();
+    if (list._label2) list._label2.destroy();
+    if (callback) {
+      callback();
+      destroyList(list, screen, onClose);
+    } else {
+      destroyList(list, screen, onClose);
+    }
+  }
+
+  // Space = preview
+  list.key(['space'], () => {
+    const selected = tracks[list.selected];
+    if (selected) _previewTrack(selected.file);
+  });
+
+  // Enter = select track, then prompt for volume
+  list.key(['enter'], () => {
+    const selected = tracks[list.selected];
+    if (!selected) return;
+    // Close the track list first (without firing onClose yet), then open volume input
+    _killPreview();
+    if (list._label2) list._label2.destroy();
+    destroyList(list, screen, null);
+    openVolumeInput(screen, currentVolume ?? 70, (volume) => {
+      onSelect(selected.file, volume);
+    }, onClose);
+  });
+
+  list.key(['escape', 'q'], () => {
+    _close();
+  });
+}

package/src/installer.js

@@ -4717,6 +4717,45 @@ async function updateCommandFiles(targetDir, spinner) {
   return commandFiles.length;
 }
 
+/**
+ * Critical hooks that must always be kept up-to-date in every installation,
+ * including the global ~/.claude/hooks/ directory.
+ * These hooks contain bug fixes (e.g. markdown stripping) that must propagate
+ * on every `npx agentvibes update` regardless of target directory.
+ */
+const CRITICAL_HOOKS = ['stop-tts.sh', 'stop.sh', 'play-tts.sh', 'session-start-tts.sh'];
+
+/**
+ * Update critical hooks in the global ~/.claude/hooks/ directory if it exists.
+ * Runs silently during every `update` — only touches files that are already installed.
+ * @param {string} srcHooksDir - Source hooks directory from the package
+ * @param {string} [homeDirOverride] - Override home dir (for testing only)
+ * @returns {Promise<number>} Number of hooks updated
+ */
+async function updateGlobalHooks(srcHooksDir, homeDirOverride) {
+  const globalHooksDir = path.join(homeDirOverride || os.homedir(), '.claude', 'hooks');
+  let updated = 0;
+  try {
+    await fs.access(globalHooksDir);
+  } catch {
+    return 0; // global hooks dir not present — nothing to do
+  }
+
+  for (const hook of CRITICAL_HOOKS) {
+    const destPath = path.join(globalHooksDir, hook);
+    const srcPath = path.join(srcHooksDir, hook);
+    try {
+      await fs.access(destPath); // only update if already installed
+      await fs.copyFile(srcPath, destPath);
+      await fs.chmod(destPath, 0o750);
+      updated++;
+    } catch {
+      // file not in global dir or src missing — skip silently
+    }
+  }
+  return updated;
+}
+
 /**
  * Perform all update operations
  * @param {string} targetDir - Target installation directory
@@ -4735,6 +4774,14 @@ async function performUpdateOperations(targetDir, spinner) {
   const hookResult = await copyHookFiles(targetDir, silentSpinner);
   console.log(chalk.green(`✓ Updated ${hookResult.count} TTS scripts`));
 
+  // Also update critical hooks in global ~/.claude/hooks/ if present (fixes stale installs)
+  const hooksSubdir = isNativeWindows() ? 'hooks-windows' : 'hooks';
+  const srcHooksDir = path.join(__dirname, '..', '.claude', hooksSubdir);
+  const globalHooksUpdated = await updateGlobalHooks(srcHooksDir);
+  if (globalHooksUpdated > 0) {
+    console.log(chalk.green(`✓ Updated ${globalHooksUpdated} critical scripts in ~/.claude/hooks/`));
+  }
+
   // Update personalities
   spinner.text = 'Updating personality templates...';
   const srcPersonalitiesDir = path.join(__dirname, '..', '.claude', 'personalities');
@@ -4937,15 +4984,19 @@ async function install(options = {}) {
       await fs.writeFile(sshHostConfigPath, userConfig.sshHost);
     }
 
-    // Set up receiver script if in receiver mode (Termux)
+    // Set up receiver script if in receiver mode
     if (userConfig.isReceiver) {
       const receiverDir = path.join(process.env.HOME || process.env.USERPROFILE, '.agentvibes');
       await fs.mkdir(receiverDir, { recursive: true, mode: 0o700 });
-      const receiverScriptPath = path.join(receiverDir, 'receiver.sh');
       const templatePath = path.join(__dirname, '..', 'templates', 'agentvibes-receiver.sh');
       try {
         const templateContent = await fs.readFile(templatePath, 'utf8');
+        // Install as play-remote.sh (ForceCommand target)
+        const receiverScriptPath = path.join(receiverDir, 'play-remote.sh');
         await fs.writeFile(receiverScriptPath, templateContent, { mode: 0o755 });
+        // Also install as receiver.sh for backward compatibility
+        const legacyPath = path.join(receiverDir, 'receiver.sh');
+        await fs.writeFile(legacyPath, templateContent, { mode: 0o755 });
       } catch {
         // Receiver script install failed — non-fatal
       }
@@ -5774,4 +5825,5 @@ export {
   copyPluginFiles, copyBmadConfigFiles, copyBackgroundMusicFiles,
   copyConfigFiles, configureSessionStartHook, ensureGitRepo,
   installPluginManifest, checkAndInstallPiper,
+  updateGlobalHooks, CRITICAL_HOOKS,
 };