agentvibes 5.3.0 → 5.5.0

package/.agentvibes/hooks/session-start-lite-v2.sh

@@ -0,0 +1,34 @@
+#!/usr/bin/env bash
+#
+# File: .agentvibes/hooks/session-start-lite-v2.sh
+#
+# AgentVibes LITE MODE v2 - Minimal Full Mode Architecture
+# Uses working tool-call approach with minimal token overhead
+#
+
+# Fix locale warnings
+export LC_ALL=C
+
+# Set lite mode environment variable to skip file saving
+export AGENTVIBES_LITE_MODE=true
+
+# Output minimal TTS protocol to stdout
+cat <<'EOF'
+
+# AgentVibes Lite Mode
+
+**At the END of your response, execute ONE TTS call:**
+
+`Bash: .claude/hooks/play-tts.sh "[brief summary of what you accomplished]"`
+
+**Rules:**
+- Only ONE TTS at completion (no acknowledgment)
+- Keep message under 100 characters
+- Summarize what you did, not how you did it
+- Examples:
+  - "Fixed authentication bug in login.js"
+  - "Found 12 TODO comments across 5 files"
+  - "Created new user registration endpoint"
+  - "Updated configuration and restarted service"
+
+EOF

package/.agentvibes/hooks/session-start-lite.sh

@@ -0,0 +1,29 @@
+#!/usr/bin/env bash
+#
+# File: .agentvibes/hooks/session-start-lite.sh
+#
+# AgentVibes LITE MODE SessionStart Hook
+# Minimal token overhead (~50 tokens vs ~500 in full mode)
+#
+
+# Fix locale warnings
+export LC_ALL=C
+
+# Get script directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Check if AgentVibes is installed
+if [[ ! -f "$SCRIPT_DIR/../../.claude/hooks/play-tts.sh" ]]; then
+  exit 0
+fi
+
+# Minimal protocol - just instruct to use output style marker
+cat <<'EOF'
+# AgentVibes Lite Mode
+
+**At the end of EVERY response, add:**
+
+**Audio Summary:** [Brief 1-sentence summary of what you accomplished]
+
+This will be spoken automatically via TTS.
+EOF

package/.agentvibes/hooks/stop-lite.sh

@@ -0,0 +1,115 @@
+#!/usr/bin/env bash
+#
+# File: .agentvibes/hooks/stop-lite.sh
+#
+# AgentVibes LITE MODE Stop Hook
+# Extracts "Audio Summary:" marker from transcript and speaks it via TTS
+# - Smart verbosity (skip for very short responses)
+# - No .wav file saving (direct TTS)
+# - Silent operation (no stdout)
+#
+
+set -euo pipefail
+
+# Fix locale warnings
+export LC_ALL=C
+
+# Read token thresholds
+MIN_TOKENS=${AGENTVIBES_MIN_TOKENS:-50}    # Skip TTS below this
+SHORT_TOKENS=${AGENTVIBES_SHORT_TOKENS:-200}  # Simplify to "Done" below this
+
+# Function to count approximate tokens (words)
+count_tokens() {
+  echo "$1" | wc -w
+}
+
+# Function to extract Audio Summary from transcript
+extract_audio_summary() {
+  local transcript_path="$1"
+
+  # Check if transcript exists
+  [[ ! -f "$transcript_path" ]] && return 1
+
+  # Get last assistant message from transcript
+  local last_response=$(jq -r '
+    [.[] | select(.role == "assistant") | .content[]? | select(.type == "text") | .text] | .[-1] // ""
+  ' "$transcript_path" 2>/dev/null || echo "")
+
+  [[ -z "$last_response" ]] && return 1
+
+  # Look for "**Audio Summary:**" marker (case-insensitive)
+  if echo "$last_response" | grep -qi "Audio Summary:"; then
+    # Extract text after the marker, trim whitespace
+    echo "$last_response" | sed -n 's/.*[Aa]udio [Ss]ummary:[[:space:]]*\(.*\)/\1/p' | head -1 | sed 's/^[[:space:]]*//;s/[[:space:]]*$//'
+    return 0
+  fi
+
+  return 1
+}
+
+# Function to play TTS (direct, no file saving)
+play_tts() {
+  local text="$1"
+
+  # Get TTS configuration
+  local config_dir=".agentvibes/config"
+  local provider="piper"
+  local voice=""
+
+  if [[ -f "$config_dir/provider.txt" ]]; then
+    provider=$(cat "$config_dir/provider.txt" 2>/dev/null | tr -d '[:space:]')
+  fi
+
+  if [[ -f "$config_dir/voice.txt" ]]; then
+    voice=$(cat "$config_dir/voice.txt" 2>/dev/null | tr -d '[:space:]')
+  fi
+
+  # Use AgentVibes play-tts.sh for consistent TTS
+  if [[ -f ".claude/hooks/play-tts.sh" ]]; then
+    bash .claude/hooks/play-tts.sh "$text" >/dev/null 2>&1 &
+  fi
+}
+
+# Main logic
+main() {
+  # Get transcript path from hook input (passed as JSON on stdin or as argument)
+  local transcript_path=""
+
+  if [[ -n "${1:-}" ]]; then
+    # Try to parse as JSON first
+    transcript_path=$(echo "$1" | jq -r '.transcript_path // empty' 2>/dev/null || echo "")
+  fi
+
+  # If not found, try reading from stdin
+  if [[ -z "$transcript_path" ]] && [[ -p /dev/stdin ]]; then
+    local input=$(cat)
+    transcript_path=$(echo "$input" | jq -r '.transcript_path // empty' 2>/dev/null || echo "")
+  fi
+
+  # If still no transcript path, exit
+  [[ -z "$transcript_path" ]] && exit 0
+
+  # Extract Audio Summary
+  local summary=$(extract_audio_summary "$transcript_path")
+
+  # If no Audio Summary marker found, exit silently
+  [[ -z "$summary" ]] && exit 0
+
+  # Count tokens in summary
+  local token_count=$(count_tokens "$summary")
+
+  # Skip TTS for very short summaries
+  [[ $token_count -lt $MIN_TOKENS ]] && exit 0
+
+  # For short responses, simplify to "Done"
+  if [[ $token_count -lt $SHORT_TOKENS ]]; then
+    summary="Done"
+  fi
+
+  # Play TTS in background
+  play_tts "$summary"
+
+  exit 0
+}
+
+main "$@"

package/.agentvibes/hooks/switch-mode.sh

@@ -0,0 +1,215 @@
+#!/usr/bin/env bash
+#
+# File: .agentvibes/hooks/switch-mode.sh
+#
+# AgentVibes Mode Switcher
+# Safely switches between Full Mode and Lite Mode
+#
+
+set -euo pipefail
+
+# Fix locale warnings
+export LC_ALL=C
+
+# Directories
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+AGENTVIBES_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+CLAUDE_DIR=".claude"
+CONFIG_DIR="$AGENTVIBES_DIR/config"
+BACKUP_DIR="$AGENTVIBES_DIR/backup"
+
+# Files
+MODE_FILE="$CONFIG_DIR/mode.txt"
+SESSION_START_HOOK="$CLAUDE_DIR/hooks/session-start-tts.sh"
+POST_TOOL_USE_HOOK="$CLAUDE_DIR/hooks/post-tool-use.sh"
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Functions
+print_info() {
+  echo -e "${BLUE}ℹ${NC} $1"
+}
+
+print_success() {
+  echo -e "${GREEN}✓${NC} $1"
+}
+
+print_warning() {
+  echo -e "${YELLOW}⚠${NC} $1"
+}
+
+print_error() {
+  echo -e "${RED}✗${NC} $1"
+}
+
+# Ensure directories exist
+ensure_dirs() {
+  mkdir -p "$CONFIG_DIR" "$BACKUP_DIR" "$CLAUDE_DIR/hooks"
+}
+
+# Get current mode
+get_current_mode() {
+  if [[ -f "$MODE_FILE" ]]; then
+    cat "$MODE_FILE"
+  else
+    echo "full"
+  fi
+}
+
+# Show current mode
+show_mode() {
+  local current_mode=$(get_current_mode)
+  echo ""
+  echo "═══════════════════════════════════════════"
+  echo "  AgentVibes Current Mode"
+  echo "═══════════════════════════════════════════"
+  echo ""
+
+  if [[ "$current_mode" == "lite" ]]; then
+    echo -e "${GREEN}●${NC} LITE MODE (Active)"
+    echo "  - Minimal tokens (~50 vs ~500)"
+    echo "  - No acknowledgment TTS"
+    echo "  - Smart completion TTS"
+    echo "  - No .wav files"
+    echo "  - Silent operation"
+    echo ""
+    echo "○ FULL MODE"
+    echo "  - All features (personalities, learning, effects)"
+  else
+    echo "○ LITE MODE"
+    echo ""
+    echo -e "${GREEN}●${NC} FULL MODE (Active)"
+    echo "  - Full protocol (~500 tokens)"
+    echo "  - Acknowledgment + completion TTS"
+    echo "  - Personalities & learning"
+    echo "  - Audio effects & background music"
+    echo "  - All features enabled"
+  fi
+
+  echo ""
+  echo "═══════════════════════════════════════════"
+  echo ""
+  echo "Switch modes: /agent-vibes mode [lite|full]"
+  echo ""
+}
+
+# Switch to lite mode
+switch_to_lite() {
+  print_info "Switching to LITE mode..."
+
+  # No need to copy hooks - they're sourced from .agentvibes/
+  # Just update the mode file
+  echo "lite" > "$MODE_FILE"
+
+  echo ""
+  echo "═══════════════════════════════════════════"
+  print_success "Switched to LITE MODE"
+  echo "═══════════════════════════════════════════"
+  echo ""
+  echo "Features:"
+  echo "  ✓ Minimal tokens (~50)"
+  echo "  ✓ No acknowledgment TTS"
+  echo "  ✓ Smart completion TTS"
+  echo "  ✓ No .wav files"
+  echo "  ✓ Silent operation"
+  echo ""
+  echo "Note: Restart your Claude session for changes to take effect"
+  echo ""
+}
+
+# Switch to full mode
+switch_to_full() {
+  print_info "Switching to FULL mode..."
+
+  # No need to copy hooks - they're sourced from .agentvibes/
+  # Just update the mode file
+  echo "full" > "$MODE_FILE"
+
+  # Prompt user for save-audio preference (GitHub Issue #74)
+  echo ""
+  echo "═══════════════════════════════════════════"
+  echo "  Audio File Saving Preference"
+  echo "═══════════════════════════════════════════"
+  echo ""
+  echo "Would you like to save TTS audio files to disk?"
+  echo ""
+  echo "  [y] Yes - Save files to .claude/audio/"
+  echo "            (useful for debugging, replay, archiving)"
+  echo ""
+  echo "  [N] No  - Use temporary files (default)"
+  echo "            (automatic cleanup, saves disk space)"
+  echo ""
+  read -p "Your choice [y/N]: " -n 1 -r
+  echo ""
+
+  SAVE_AUDIO_FILE="$CONFIG_DIR/save-audio.txt"
+  if [[ $REPLY =~ ^[Yy]$ ]]; then
+    echo "true" > "$SAVE_AUDIO_FILE"
+    print_success "Audio file saving ENABLED"
+    echo "  Files will be saved to .claude/audio/"
+  else
+    echo "false" > "$SAVE_AUDIO_FILE"
+    print_success "Audio file saving DISABLED (default)"
+    echo "  Temporary files will be used and auto-cleaned"
+  fi
+
+  echo ""
+  echo "═══════════════════════════════════════════"
+  print_success "Switched to FULL MODE"
+  echo "═══════════════════════════════════════════"
+  echo ""
+  echo "Features:"
+  echo "  ✓ Full protocol (~500 tokens)"
+  echo "  ✓ Acknowledgment + completion TTS"
+  echo "  ✓ Personalities & learning"
+  echo "  ✓ Audio effects & background music"
+  echo "  ✓ All features enabled"
+  echo ""
+  echo "💡 Change audio saving anytime: /agent-vibes:save-audio [on|off]"
+  echo ""
+  echo "Note: Restart your Claude session for changes to take effect"
+  echo ""
+}
+
+# Note: check_mode() has been removed in favor of /agent-vibes:help
+# which provides user-friendly diagnostics with actionable suggestions
+
+# Main
+main() {
+  local command="${1:-}"
+
+  ensure_dirs
+
+  case "$command" in
+    lite)
+      switch_to_lite
+      ;;
+    full)
+      switch_to_full
+      ;;
+    "")
+      show_mode
+      ;;
+    *)
+      print_error "Unknown command: $command"
+      echo ""
+      echo "Usage: $0 [lite|full]"
+      echo ""
+      echo "Commands:"
+      echo "  lite     - Switch to Lite Mode (minimal overhead)"
+      echo "  full     - Switch to Full Mode (all features)"
+      echo "  (none)   - Show current mode"
+      echo ""
+      echo "💡 For status and diagnostics, use: /agent-vibes:help"
+      echo ""
+      exit 1
+      ;;
+  esac
+}
+
+main "$@"

package/.agentvibes/output-styles/audio-summary.md

@@ -0,0 +1,30 @@
+# Audio Summary Output Style
+
+This output style is used in AgentVibes Lite Mode to provide minimal TTS feedback.
+
+## Instructions
+
+At the end of EVERY response, add a brief summary in this format:
+
+**Audio Summary:** [1-sentence summary of what you accomplished]
+
+## Examples
+
+```
+**Audio Summary:** Created three new React components for the dashboard.
+```
+
+```
+**Audio Summary:** Fixed the authentication bug and added test coverage.
+```
+
+```
+**Audio Summary:** Refactored the API client to use async/await.
+```
+
+## Guidelines
+
+- Keep it to ONE sentence
+- Focus on WHAT you did, not HOW
+- Be specific but concise
+- This will be spoken via text-to-speech automatically

package/.claude/activation-instructions

@@ -1,54 +1,54 @@
-# BMAD Agent Activation Instructions
-
-When a BMAD agent activates, follow these steps EXACTLY:
-
-## STEP 3.5a: Create BMAD Context File (CRITICAL)
-
-**IMMEDIATELY after agent identification, create the context file:**
-
-```bash
-echo "$AGENT_ID" > .bmad-agent-context
-```
-
-Where `$AGENT_ID` is one of:
-- `pm` (Product Manager)
-- `dev` (Developer)
-- `qa` (QA)
-- `architect` (Architect)
-- `po` (Product Owner)
-- `analyst` (Analyst)
-- `sm` (Scrum Master)
-- `ux-expert` (UX Expert)
-- `bmad-master` (BMAD Master)
-- `bmad-orchestrator` (Orchestrator)
-
-**Example:**
-```bash
-# For Product Manager agent
-echo "pm" > .bmad-agent-context
-```
-
-This file allows AgentVibes to:
-1. Detect which BMAD agent is active
-2. Look up the correct voice mapping
-3. Automatically speak questions using the agent's assigned voice
-
-## STEP 10: Clean Up on Exit
-
-**Before exiting the agent, remove the context file:**
-
-```bash
-rm -f .bmad-agent-context
-```
-
-This ensures voice switching only happens when an agent is active.
-
-## Why This Matters
-
-Without the `.bmad-agent-context` file:
-- AgentVibes cannot detect which agent is active
-- Questions won't be spoken automatically
-- Voice switching won't work
-- The BMAD voice plugin becomes non-functional
-
-**This is MANDATORY for BMAD voice integration to work!**
+# BMAD Agent Activation Instructions
+
+When a BMAD agent activates, follow these steps EXACTLY:
+
+## STEP 3.5a: Create BMAD Context File (CRITICAL)
+
+**IMMEDIATELY after agent identification, create the context file:**
+
+```bash
+echo "$AGENT_ID" > .bmad-agent-context
+```
+
+Where `$AGENT_ID` is one of:
+- `pm` (Product Manager)
+- `dev` (Developer)
+- `qa` (QA)
+- `architect` (Architect)
+- `po` (Product Owner)
+- `analyst` (Analyst)
+- `sm` (Scrum Master)
+- `ux-expert` (UX Expert)
+- `bmad-master` (BMAD Master)
+- `bmad-orchestrator` (Orchestrator)
+
+**Example:**
+```bash
+# For Product Manager agent
+echo "pm" > .bmad-agent-context
+```
+
+This file allows AgentVibes to:
+1. Detect which BMAD agent is active
+2. Look up the correct voice mapping
+3. Automatically speak questions using the agent's assigned voice
+
+## STEP 10: Clean Up on Exit
+
+**Before exiting the agent, remove the context file:**
+
+```bash
+rm -f .bmad-agent-context
+```
+
+This ensures voice switching only happens when an agent is active.
+
+## Why This Matters
+
+Without the `.bmad-agent-context` file:
+- AgentVibes cannot detect which agent is active
+- Questions won't be spoken automatically
+- Voice switching won't work
+- The BMAD voice plugin becomes non-functional
+
+**This is MANDATORY for BMAD voice integration to work!**

package/.claude/commands/agent-vibes/add.md

@@ -1,21 +1,21 @@
----
-description: Add a new custom Piper TTS TTS voice
-argument-hint: <voice_name> <voice_id>
----
-
-Add a new custom Piper TTS TTS voice to your voice library.
-
-Usage:
-- `/agent-vibes:add "My Custom Voice" abc123xyz456789`
-- `/agent-vibes:add Narrator KTPVrSVAEUSJRClDzBw7`
-
-The voice ID should be a 15-30 character alphanumeric string from your Piper TTS account.
-
-To find your voice IDs:
-1. Go to https://piper.io/app/voice-library
-2. Click on a voice
-3. Copy the voice ID from the URL or settings
-
-After adding, you can switch to it with `/agent-vibes:switch "Voice Name"`
-
-!bash .claude/hooks/voice-manager.sh add $ARGUMENTS
+---
+description: Add a new custom Piper TTS TTS voice
+argument-hint: <voice_name> <voice_id>
+---
+
+Add a new custom Piper TTS TTS voice to your voice library.
+
+Usage:
+- `/agent-vibes:add "My Custom Voice" abc123xyz456789`
+- `/agent-vibes:add Narrator KTPVrSVAEUSJRClDzBw7`
+
+The voice ID should be a 15-30 character alphanumeric string from your Piper TTS account.
+
+To find your voice IDs:
+1. Go to https://piper.io/app/voice-library
+2. Click on a voice
+3. Copy the voice ID from the URL or settings
+
+After adding, you can switch to it with `/agent-vibes:switch "Voice Name"`
+
+!bash .claude/hooks/voice-manager.sh add $ARGUMENTS