agentvibes 2.6.0 → 2.7.0

package/.claude/hooks/README-TTS-QUEUE.md

@@ -0,0 +1,135 @@
+# TTS Queue System for Party Mode
+
+## Overview
+
+The TTS Queue System enables BMAD party mode agents to speak sequentially without blocking Claude Code's response generation. This provides the best of both worlds:
+
+- ✅ **Non-blocking**: Claude Code continues generating agent responses immediately
+- ✅ **Sequential playback**: Agents speak one at a time in order, with correct voices
+- ✅ **No audio overlap**: The queue ensures voices don't talk over each other
+
+## How It Works
+
+### Architecture
+
+```
+bmad-speak.sh → tts-queue.sh → Queue Directory → tts-queue-worker.sh → play-tts.sh → Audio
+     ↓               ↓                                       ↓
+  Returns        Returns                              Processes queue
+immediately    immediately                            sequentially
+```
+
+### Components
+
+1. **`tts-queue.sh`** - Queue manager (adds requests, shows status, clears queue)
+2. **`tts-queue-worker.sh`** - Background worker process (plays audio sequentially)
+3. **`bmad-speak.sh`** - Updated to use queue system with `&` for non-blocking
+4. **Queue directory**: `/tmp/agentvibes-tts-queue/` - Stores pending TTS requests
+
+### Flow
+
+1. Party mode agent generates response
+2. `bmad-speak.sh` adds TTS request to queue and returns immediately (`&`)
+3. Queue worker automatically starts if needed
+4. Worker processes queue items sequentially (oldest first)
+5. Each audio file plays to completion before next one starts
+6. Worker auto-exits after 5 seconds of idle time
+
+## Usage
+
+### Normal Usage (Automatic)
+
+Party mode automatically uses the queue system. No manual intervention needed.
+
+### Manual Queue Management
+
+```bash
+# Check queue status
+bash .claude/hooks/tts-queue.sh status
+
+# Clear all pending TTS (emergency stop)
+bash .claude/hooks/tts-queue.sh clear
+
+# Manually add to queue
+bash .claude/hooks/tts-queue.sh add "Hello world" "en_US-ryan-high"
+```
+
+## Performance Benefits
+
+### Before (Sequential Blocking):
+```
+Agent 1 text output → [WAIT 3s for audio] → Agent 2 text → [WAIT 3s] → Agent 3 text
+Total time: ~9+ seconds
+```
+
+### After (Queue System):
+```
+Agent 1 text → Agent 2 text → Agent 3 text (all immediate)
+                         ↓
+            [Audio plays sequentially in background]
+Total text output time: <1 second
+Total audio time: ~9 seconds (plays while Claude continues working)
+```
+
+## Technical Details
+
+### Queue File Format
+
+Each queue item is a timestamped file containing escaped bash variables:
+
+```bash
+TEXT='First\ message\ from\ John'
+VOICE='en_US-ryan-high'
+```
+
+### Worker Lifecycle
+
+- **Start**: Automatically launched when first item added to empty queue
+- **Processing**: Continues while queue has items
+- **Idle timeout**: Exits after 5 seconds with no new items
+- **Auto-restart**: Next queue addition spawns new worker
+
+### Thread Safety
+
+- Queue items use nanosecond timestamps for uniqueness
+- Worker processes oldest items first (sorted by filename)
+- Audio lock mechanism in `play-tts.sh` prevents actual audio overlap
+- Worker PID tracked in `/tmp/agentvibes-tts-queue/worker.pid`
+
+## Troubleshooting
+
+### Queue stuck or voices not playing
+
+```bash
+# Check status
+bash .claude/hooks/tts-queue.sh status
+
+# Clear queue and restart
+bash .claude/hooks/tts-queue.sh clear
+```
+
+### Worker not starting
+
+Check for errors in the worker script:
+```bash
+bash .claude/hooks/tts-queue-worker.sh
+```
+
+### Audio still overlapping
+
+Verify the lock file mechanism is working:
+```bash
+ls -la /tmp/agentvibes-audio.lock
+```
+
+## Files Modified
+
+- `.claude/hooks/bmad-speak.sh` - Now uses queue system with `&` for non-blocking
+- `.claude/hooks/tts-queue.sh` - New queue manager (added)
+- `.claude/hooks/tts-queue-worker.sh` - New background worker (added)
+
+## Compatibility
+
+- Works with both Piper and ElevenLabs TTS providers
+- Compatible with all existing BMAD voice mappings
+- No changes needed to party mode workflow instructions

package/.claude/hooks/bmad-speak.sh

@@ -59,11 +59,26 @@ map_to_agent_id() {
   fi
 
   # Otherwise map display name to agent ID (for party mode)
-  # Extract 'name' (column 1) where displayName (column 2) matches
-  local agent_id=$(grep -i ",\"*${name_or_id}\"*," "$PROJECT_ROOT/.bmad/_cfg/agent-manifest.csv" | \
-                   head -1 | \
-                   cut -d',' -f1 | \
-                   tr -d '"')
+  # Extract 'name' (column 1) where displayName (column 2) contains the name
+  # displayName format in CSV: "John", "Mary", "Winston", etc. (first word before any parentheses)
+  local agent_id=$(awk -F',' -v name="$name_or_id" '
+    BEGIN { IGNORECASE=1 }
+    NR > 1 {
+      # Extract displayName (column 2)
+      display = $2
+      gsub(/^"|"$/, "", display)  # Remove surrounding quotes
+
+      # Check if display name starts with the search name (case-insensitive)
+      # This handles both "John" and "John (Product Manager)"
+      if (tolower(display) ~ "^" tolower(name) "($| |\\()") {
+        # Extract agent ID (column 1)
+        agent = $1
+        gsub(/^"|"$/, "", agent)
+        print agent
+        exit
+      }
+    }
+  ' "$PROJECT_ROOT/.bmad/_cfg/agent-manifest.csv")
 
   echo "$agent_id"
 }
@@ -71,16 +86,25 @@ map_to_agent_id() {
 # Get agent ID
 AGENT_ID=$(map_to_agent_id "$AGENT_NAME_OR_ID")
 
-# Get agent's voice
+# Get agent's voice and intro text
 AGENT_VOICE=""
+AGENT_INTRO=""
 if [[ -n "$AGENT_ID" ]] && [[ -f "$SCRIPT_DIR/bmad-voice-manager.sh" ]]; then
   AGENT_VOICE=$("$SCRIPT_DIR/bmad-voice-manager.sh" get-voice "$AGENT_ID" 2>/dev/null)
+  AGENT_INTRO=$("$SCRIPT_DIR/bmad-voice-manager.sh" get-intro "$AGENT_ID" 2>/dev/null)
+fi
+
+# Prepend intro text if configured (e.g., "John, Product Manager here. [dialogue]")
+FULL_TEXT="$DIALOGUE"
+if [[ -n "$AGENT_INTRO" ]]; then
+  FULL_TEXT="${AGENT_INTRO}. ${DIALOGUE}"
 fi
 
-# Speak with agent's voice
+# Speak with agent's voice using queue system (non-blocking for Claude)
+# Queue system ensures sequential playback while allowing Claude to continue
 if [[ -n "$AGENT_VOICE" ]]; then
-  bash "$SCRIPT_DIR/play-tts.sh" "$DIALOGUE" "$AGENT_VOICE" &
+  bash "$SCRIPT_DIR/tts-queue.sh" add "$FULL_TEXT" "$AGENT_VOICE" &
 else
   # Fallback to default voice
-  bash "$SCRIPT_DIR/play-tts.sh" "$DIALOGUE" &
+  bash "$SCRIPT_DIR/tts-queue.sh" add "$FULL_TEXT" &
 fi

package/.claude/hooks/bmad-voice-manager.sh

@@ -34,14 +34,14 @@
 # @fileoverview BMAD Voice Plugin Manager - Maps BMAD agents to unique TTS voices
 # @context Enables each BMAD agent to have its own distinct voice for multi-agent sessions
 # @architecture Markdown table-based voice mapping with enable/disable flag, auto-detection of BMAD
-# @dependencies .claude/plugins/bmad-voices.md (voice mappings), bmad-tts-injector.sh, .bmad-core/ (BMAD installation)
+# @dependencies .claude/config/bmad-voices.md (voice mappings), bmad-tts-injector.sh, .bmad-core/ (BMAD installation)
 # @entrypoints Called by /agent-vibes:bmad commands, auto-enabled on BMAD detection
 # @patterns Plugin architecture, auto-enable on dependency detection, state backup/restore on toggle
-# @related bmad-tts-injector.sh, .claude/plugins/bmad-voices.md, .bmad-agent-context file
+# @related bmad-tts-injector.sh, .claude/config/bmad-voices.md, .bmad-agent-context file
 
-PLUGIN_DIR=".claude/plugins"
-PLUGIN_FILE="$PLUGIN_DIR/bmad-voices.md"
-ENABLED_FLAG="$PLUGIN_DIR/bmad-voices-enabled.flag"
+CONFIG_DIR=".claude/config"
+VOICE_CONFIG_FILE="$CONFIG_DIR/bmad-voices.md"
+ENABLED_FLAG="$CONFIG_DIR/bmad-voices-enabled.flag"
 
 # AI NOTE: Auto-enable pattern - When BMAD is detected via install-manifest.yaml,
 # automatically enable the voice plugin to provide seamless multi-agent voice support.
@@ -115,7 +115,7 @@ auto_enable_if_bmad_detected() {
     # Check if BMAD is installed (any version) and plugin not already enabled
     if [[ "$version" != "0" ]] && [[ ! -f "$ENABLED_FLAG" ]]; then
         # BMAD detected but plugin not enabled - enable it silently
-        mkdir -p "$PLUGIN_DIR"
+        mkdir -p "$CONFIG_DIR"
         touch "$ENABLED_FLAG"
         return 0
     fi
@@ -144,7 +144,7 @@ get_agent_voice() {
         return
     fi
 
-    if [[ ! -f "$PLUGIN_FILE" ]]; then
+    if [[ ! -f "$VOICE_CONFIG_FILE" ]]; then
         echo ""  # Plugin file missing
         return
     fi
@@ -163,19 +163,47 @@ get_agent_voice() {
     fi
 
     # Extract voice from markdown table based on provider
-    # Column 4 = ElevenLabs Voice, Column 5 = Piper Voice
-    local column=4  # Default to ElevenLabs (column 4)
+    # Table: Agent ID | Agent Name | Intro | ElevenLabs Voice | Piper Voice | Personality
+    # AWK columns: $1=empty | $2=ID | $3=Name | $4=Intro | $5=ElevenLabs | $6=Piper | $7=Personality
+    local column=5  # Default to ElevenLabs (AWK column 5)
     if [[ "$active_provider" == "piper" ]]; then
-        column=5  # Use Piper column
+        column=6  # Use Piper (AWK column 6)
     fi
 
-    local voice=$(grep "^| $agent_id " "$PLUGIN_FILE" | \
+    local voice=$(grep "^| $agent_id " "$VOICE_CONFIG_FILE" | \
                   awk -F'|' "{print \$$column}" | \
                   sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
 
     echo "$voice"
 }
 
+# @function get_agent_intro
+# @intent Retrieve intro text for BMAD agent (spoken before their message)
+# @why Helps users identify which agent is speaking in party mode
+# @param $1 {string} agent_id - BMAD agent identifier
+# @returns Echoes intro text to stdout, empty string if not configured
+# @exitcode Always 0
+# @sideeffects None
+# @edgecases Returns empty string if plugin file missing, parses column 3 of markdown table
+# @calledby bmad-speak.sh for agent identification in party mode
+# @calls grep, awk, sed
+# @version 2.1.0 - New function for customizable agent introductions
+get_agent_intro() {
+    local agent_id="$1"
+
+    if [[ ! -f "$VOICE_CONFIG_FILE" ]]; then
+        echo ""
+        return
+    fi
+
+    # AWK column 4 = Intro text
+    local intro=$(grep "^| $agent_id " "$VOICE_CONFIG_FILE" | \
+                  awk -F'|' '{print $4}' | \
+                  sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
+
+    echo "$intro"
+}
+
 # @function get_agent_personality
 # @intent Retrieve TTS personality assigned to specific BMAD agent
 # @why Agents may have distinct speaking styles (friendly, professional, energetic, etc.)
@@ -190,14 +218,14 @@ get_agent_voice() {
 get_agent_personality() {
     local agent_id="$1"
 
-    if [[ ! -f "$PLUGIN_FILE" ]]; then
+    if [[ ! -f "$VOICE_CONFIG_FILE" ]]; then
         echo ""
         return
     fi
 
-    # Column 6 = Personality (changed from 5 due to new ElevenLabs/Piper columns)
-    local personality=$(grep "^| $agent_id " "$PLUGIN_FILE" | \
-                       awk -F'|' '{print $6}' | \
+    # AWK column 7 = Personality
+    local personality=$(grep "^| $agent_id " "$VOICE_CONFIG_FILE" | \
+                       awk -F'|' '{print $7}' | \
                        sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
 
     echo "$personality"
@@ -229,10 +257,10 @@ is_plugin_enabled() {
 # @calledby Main command dispatcher with "enable" argument
 # @calls mkdir, cat, source, list_mappings, bmad-tts-injector.sh
 enable_plugin() {
-    mkdir -p "$PLUGIN_DIR"
+    mkdir -p "$CONFIG_DIR"
 
     # Save current settings before enabling
-    BACKUP_FILE="$PLUGIN_DIR/.bmad-previous-settings"
+    BACKUP_FILE="$CONFIG_DIR/.bmad-previous-settings"
 
     # Save current voice
     if [[ -f ".claude/tts-voice.txt" ]]; then
@@ -369,7 +397,7 @@ ACTIVATION_EOF
 # @calledby Main command dispatcher with "disable" argument
 # @calls source, rm, echo, bmad-tts-injector.sh
 disable_plugin() {
-    BACKUP_FILE="$PLUGIN_DIR/.bmad-previous-settings"
+    BACKUP_FILE="$CONFIG_DIR/.bmad-previous-settings"
 
     # Check if we have a backup to restore
     if [[ -f "$BACKUP_FILE" ]]; then
@@ -435,15 +463,15 @@ disable_plugin() {
 # @calledby enable_plugin, show_status, main command dispatcher with "list"
 # @calls grep, sed, echo
 list_mappings() {
-    if [[ ! -f "$PLUGIN_FILE" ]]; then
-        echo "❌ Plugin file not found: $PLUGIN_FILE"
+    if [[ ! -f "$VOICE_CONFIG_FILE" ]]; then
+        echo "❌ Plugin file not found: $VOICE_CONFIG_FILE"
         return 1
     fi
 
     echo "📊 BMAD Agent Voice Mappings:"
     echo ""
 
-    grep "^| " "$PLUGIN_FILE" | grep -v "Agent ID" | grep -v "^|---" | \
+    grep "^| " "$VOICE_CONFIG_FILE" | grep -v "Agent ID" | grep -v "^|---" | \
     while IFS='|' read -r _ agent_id name voice personality _; do
         agent_id=$(echo "$agent_id" | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
         name=$(echo "$name" | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
@@ -471,19 +499,19 @@ set_agent_voice() {
     local voice="$2"
     local personality="${3:-normal}"
 
-    if [[ ! -f "$PLUGIN_FILE" ]]; then
-        echo "❌ Plugin file not found: $PLUGIN_FILE"
+    if [[ ! -f "$VOICE_CONFIG_FILE" ]]; then
+        echo "❌ Plugin file not found: $VOICE_CONFIG_FILE"
         return 1
     fi
 
     # Check if agent exists
-    if ! grep -q "^| $agent_id " "$PLUGIN_FILE"; then
+    if ! grep -q "^| $agent_id " "$VOICE_CONFIG_FILE"; then
         echo "❌ Agent '$agent_id' not found in plugin"
         return 1
     fi
 
     # Update the voice and personality in the table
-    sed -i.bak "s/^| $agent_id |.*| .* | .* |$/| $agent_id | $(grep "^| $agent_id " "$PLUGIN_FILE" | awk -F'|' '{print $3}') | $voice | $personality |/" "$PLUGIN_FILE"
+    sed -i.bak "s/^| $agent_id |.*| .* | .* |$/| $agent_id | $(grep "^| $agent_id " "$VOICE_CONFIG_FILE" | awk -F'|' '{print $3}') | $voice | $personality |/" "$VOICE_CONFIG_FILE"
 
     echo "✅ Updated $agent_id → $voice [$personality]"
 }
@@ -531,12 +559,12 @@ show_status() {
 # @calledby Main command dispatcher with "edit" argument
 # @calls echo
 edit_plugin() {
-    if [[ ! -f "$PLUGIN_FILE" ]]; then
-        echo "❌ Plugin file not found: $PLUGIN_FILE"
+    if [[ ! -f "$VOICE_CONFIG_FILE" ]]; then
+        echo "❌ Plugin file not found: $VOICE_CONFIG_FILE"
         return 1
     fi
 
-    echo "Opening $PLUGIN_FILE for editing..."
+    echo "Opening $VOICE_CONFIG_FILE for editing..."
     echo "Edit the markdown table to change voice mappings"
 }
 
@@ -564,6 +592,9 @@ case "${1:-help}" in
     get-voice)
         get_agent_voice "$2"
         ;;
+    get-intro)
+        get_agent_intro "$2"
+        ;;
     get-personality)
         get_agent_personality "$2"
         ;;
@@ -571,7 +602,7 @@ case "${1:-help}" in
         edit_plugin
         ;;
     *)
-        echo "Usage: bmad-voice-manager.sh {enable|disable|status|list|set|get-voice|get-personality|edit}"
+        echo "Usage: bmad-voice-manager.sh {enable|disable|status|list|set|get-voice|get-intro|get-personality|edit}"
         echo ""
         echo "Commands:"
         echo "  enable              Enable BMAD voice plugin"
@@ -580,6 +611,7 @@ case "${1:-help}" in
         echo "  list                List all agent voice mappings"
         echo "  set <id> <voice>    Set voice for agent"
         echo "  get-voice <id>      Get voice for agent"
+        echo "  get-intro <id>      Get intro text for agent"
         echo "  get-personality <id> Get personality for agent"
         echo "  edit                Edit plugin configuration"
         exit 1

package/.claude/hooks/play-tts.sh

@@ -46,6 +46,11 @@ export LC_ALL=C
 TEXT="$1"
 VOICE_OVERRIDE="$2"  # Optional: voice name or ID
 
+# Remove backslash escaping that Claude might add for special chars like ! and $
+# In single quotes these don't need escaping, but Claude sometimes adds \! anyway
+TEXT="${TEXT//\\!/!}"
+TEXT="${TEXT//\\\$/\$}"
+
 # Get script directory
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 

package/.claude/hooks/tts-queue-worker.sh

@@ -0,0 +1,68 @@
+#!/usr/bin/env bash
+#
+# File: .claude/hooks/tts-queue-worker.sh
+#
+# TTS Queue Worker - Background process that plays queued TTS sequentially
+# Automatically exits when queue is empty for 5 seconds
+
+set -euo pipefail
+
+QUEUE_DIR="/tmp/agentvibes-tts-queue"
+WORKER_PID_FILE="$QUEUE_DIR/worker.pid"
+IDLE_TIMEOUT=5  # Exit after 5 seconds of no new requests
+
+# Get script directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Trap to clean up on exit
+trap "rm -f $WORKER_PID_FILE" EXIT
+
+# Process queue items
+process_queue() {
+  local idle_count=0
+
+  while true; do
+    # Find oldest queue item
+    local queue_item=$(ls -1 "$QUEUE_DIR"/*.queue 2>/dev/null | sort | head -1)
+
+    if [[ -z "$queue_item" ]]; then
+      # Queue is empty, increment idle counter
+      idle_count=$((idle_count + 1))
+
+      if [[ $idle_count -ge $IDLE_TIMEOUT ]]; then
+        # No new items for timeout period, exit worker
+        exit 0
+      fi
+
+      # Wait 1 second and check again
+      sleep 1
+      continue
+    fi
+
+    # Reset idle counter - we have work
+    idle_count=0
+
+    # Load TTS request
+    source "$queue_item"
+
+    # Decode base64 values
+    TEXT=$(echo -n "$TEXT_B64" | base64 -d)
+    VOICE=$(echo -n "$VOICE_B64" | base64 -d)
+
+    # Play TTS (this blocks until audio finishes due to lock mechanism)
+    if [[ -n "${VOICE:-}" ]]; then
+      bash "$SCRIPT_DIR/play-tts.sh" "$TEXT" "$VOICE" 2>/dev/null || true
+    else
+      bash "$SCRIPT_DIR/play-tts.sh" "$TEXT" 2>/dev/null || true
+    fi
+
+    # Add 2-second pause between speakers for natural conversation flow
+    sleep 2
+
+    # Remove processed item
+    rm -f "$queue_item"
+  done
+}
+
+# Start processing
+process_queue

package/.claude/hooks/tts-queue.sh

@@ -0,0 +1,105 @@
+#!/usr/bin/env bash
+#
+# File: .claude/hooks/tts-queue.sh
+#
+# TTS Queue Manager for Party Mode
+# Queues TTS requests and plays them sequentially in the background
+# This allows Claude to continue generating responses while audio plays in order
+
+set -euo pipefail
+
+QUEUE_DIR="/tmp/agentvibes-tts-queue"
+QUEUE_LOCK="$QUEUE_DIR/queue.lock"
+WORKER_PID_FILE="$QUEUE_DIR/worker.pid"
+
+# Get script directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Initialize queue directory
+mkdir -p "$QUEUE_DIR"
+
+# @function add_to_queue
+# @intent Add a TTS request to the queue for sequential playback
+# @param $1 dialogue text
+# @param $2 voice name (optional)
+add_to_queue() {
+  local text="$1"
+  local voice="${2:-}"
+
+  # Create unique queue item with timestamp
+  local timestamp=$(date +%s%N)
+  local queue_file="$QUEUE_DIR/$timestamp.queue"
+
+  # Write request to queue file (base64 encoded to handle all special chars)
+  cat > "$queue_file" <<EOF
+TEXT_B64=$(echo -n "$text" | base64 -w0)
+VOICE_B64=$(echo -n "$voice" | base64 -w0)
+EOF
+
+  # Start queue worker if not already running
+  start_worker_if_needed
+}
+
+# @function start_worker_if_needed
+# @intent Start the queue worker process if it's not already running
+start_worker_if_needed() {
+  # Check if worker is already running
+  if [[ -f "$WORKER_PID_FILE" ]]; then
+    local pid=$(cat "$WORKER_PID_FILE")
+    if kill -0 "$pid" 2>/dev/null; then
+      # Worker is running
+      return 0
+    fi
+  fi
+
+  # Start worker in background
+  "$SCRIPT_DIR/tts-queue-worker.sh" &
+  echo $! > "$WORKER_PID_FILE"
+}
+
+# @function clear_queue
+# @intent Clear all pending TTS requests (emergency stop)
+clear_queue() {
+  rm -f "$QUEUE_DIR"/*.queue
+  echo "✅ Queue cleared"
+}
+
+# @function show_queue
+# @intent Display current queue status
+show_queue() {
+  local count=$(ls -1 "$QUEUE_DIR"/*.queue 2>/dev/null | wc -l)
+  echo "📊 Queue status: $count items pending"
+
+  if [[ -f "$WORKER_PID_FILE" ]]; then
+    local pid=$(cat "$WORKER_PID_FILE")
+    if kill -0 "$pid" 2>/dev/null; then
+      echo "✅ Worker process running (PID: $pid)"
+    else
+      echo "❌ Worker process not running"
+    fi
+  else
+    echo "❌ Worker process not running"
+  fi
+}
+
+# Main command dispatcher
+case "${1:-help}" in
+  add)
+    add_to_queue "${2:-}" "${3:-}"
+    ;;
+  clear)
+    clear_queue
+    ;;
+  status)
+    show_queue
+    ;;
+  *)
+    echo "Usage: tts-queue.sh {add|clear|status}"
+    echo ""
+    echo "Commands:"
+    echo "  add <text> [voice]  Add TTS request to queue"
+    echo "  clear               Clear all pending requests"
+    echo "  status              Show queue status"
+    exit 1
+    ;;
+esac

package/.claude/verbosity.txt

@@ -0,0 +1 @@
+high

package/README.md

@@ -11,7 +11,7 @@
 [![Publish](https://github.com/paulpreibisch/AgentVibes/actions/workflows/publish.yml/badge.svg)](https://github.com/paulpreibisch/AgentVibes/actions/workflows/publish.yml)
 [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 
-**Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v2.5.0
+**Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v2.7.0
 
 ---
 
@@ -94,16 +94,16 @@ Whether you're coding in Claude Code, chatting in Claude Desktop, or using Warp
 
 ## 📰 Latest Release
 
-**[v2.6.0 - BMAD Integration & Voice Management CLI](https://github.com/paulpreibisch/AgentVibes/releases/tag/v2.6.0)** 🎉
+**[v2.7.0 - Party Mode Voice Improvements](https://github.com/paulpreibisch/AgentVibes/releases/tag/v2.7.0)** 🎉
 
-AgentVibes v2.6.0 brings comprehensive BMAD integration with unique AI voices for all agents! BMAD is a revolutionary AI-driven agile framework that automatically adapts from single bug fixes to enterprise-scale systems.
+AgentVibes v2.7.0 transforms BMAD party mode into a professional multi-agent voice conversation system! This release introduces a sophisticated TTS queue architecture enabling sequential voice playback without blocking Claude Code, natural 2-second pauses between speakers, and customizable agent introductions.
 
 **Key highlights:**
-- 🎙️ **BMAD TTS Integration** - All BMAD agents can now speak with unique voices
-- 🛠️ **Voice Management CLI** - 5 new commands for managing agent voices
-- 🔍 **Fuzzy Voice Matching** - Use short names like "ryan" instead of full voice IDs
-- 📚 **Improved Help** - Built-in help command lists all available commands
-- 🔧 **BMAD v6 Support** - Detects and works with latest BMAD folder structure
+- 🎭 **TTS Queue System** - Sequential non-blocking voice playback for party mode
+- ⏸️ **Natural Speaker Pauses** - 2-second delay between agents for conversation flow
+- 🎤 **Speaker Introductions** - Configurable intro text (e.g., "John, Product Manager here")
+- 📁 **Config Reorganization** - Moved from `.claude/plugins/` to official `.claude/config/`
+- 🐛 **Text Escaping Fixes** - No more "backslash exclamation" in speech
 
 [→ View All Releases](https://github.com/paulpreibisch/AgentVibes/releases)