agentvibes 4.2.0 → 4.4.0

package/.claude/hooks/migrate-to-agentvibes.sh

@@ -1,161 +1,161 @@
-#!/usr/bin/env bash
-#
-# File: .claude/hooks/migrate-to-agentvibes.sh
-#
-# AgentVibes - Migration Script for v2.10.0+
-# Migrates configuration from .claude/config/ and .claude/plugins/ to .agentvibes/
-#
-# This script is automatically run by the installer if old config is detected.
-# Can also be run manually: .claude/hooks/migrate-to-agentvibes.sh
-#
-
-set -euo pipefail
-
-# Colors for output
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-NC='\033[0m' # No Color
-
-echo -e "${BLUE}🔄 AgentVibes Configuration Migration${NC}"
-echo ""
-echo "Migrating from .claude/config/ and .claude/plugins/ to .agentvibes/"
-echo ""
-
-# Determine project root
-if [[ -n "${CLAUDE_PROJECT_DIR:-}" ]]; then
-    PROJECT_ROOT="$CLAUDE_PROJECT_DIR"
-else
-    PROJECT_ROOT="$(pwd)"
-fi
-
-cd "$PROJECT_ROOT"
-
-# Track if any migrations happened
-MIGRATED=false
-
-# Create target directories
-echo -e "${BLUE}📁 Creating .agentvibes/ directory structure...${NC}"
-mkdir -p .agentvibes/bmad
-mkdir -p .agentvibes/config
-echo -e "${GREEN}✓ Directories created${NC}"
-echo ""
-
-# Migrate BMAD files from .claude/plugins/
-echo -e "${BLUE}🔍 Checking for BMAD files in .claude/plugins/...${NC}"
-
-if [[ -f ".claude/plugins/bmad-voices-enabled.flag" ]]; then
-    echo -e "${YELLOW}  Found: bmad-voices-enabled.flag${NC}"
-    mv .claude/plugins/bmad-voices-enabled.flag .agentvibes/bmad/
-    echo -e "${GREEN}  ✓ Moved to .agentvibes/bmad/${NC}"
-    MIGRATED=true
-fi
-
-if [[ -f ".claude/plugins/bmad-party-mode-disabled.flag" ]]; then
-    echo -e "${YELLOW}  Found: bmad-party-mode-disabled.flag${NC}"
-    mv .claude/plugins/bmad-party-mode-disabled.flag .agentvibes/bmad/
-    echo -e "${GREEN}  ✓ Moved to .agentvibes/bmad/${NC}"
-    MIGRATED=true
-fi
-
-if [[ -f ".claude/plugins/.bmad-previous-settings" ]]; then
-    echo -e "${YELLOW}  Found: .bmad-previous-settings${NC}"
-    mv .claude/plugins/.bmad-previous-settings .agentvibes/bmad/
-    echo -e "${GREEN}  ✓ Moved to .agentvibes/bmad/${NC}"
-    MIGRATED=true
-fi
-
-echo ""
-
-# Migrate BMAD files from .claude/config/
-echo -e "${BLUE}🔍 Checking for BMAD files in .claude/config/...${NC}"
-
-if [[ -f ".claude/config/bmad-voices.md" ]]; then
-    echo -e "${YELLOW}  Found: bmad-voices.md${NC}"
-    mv .claude/config/bmad-voices.md .agentvibes/bmad/
-    echo -e "${GREEN}  ✓ Moved to .agentvibes/bmad/${NC}"
-    MIGRATED=true
-fi
-
-if [[ -f ".claude/config/bmad-voices-enabled.flag" ]]; then
-    echo -e "${YELLOW}  Found: bmad-voices-enabled.flag${NC}"
-    # Check if already exists in new location
-    if [[ -f ".agentvibes/bmad/bmad-voices-enabled.flag" ]]; then
-        echo -e "${BLUE}  (Already exists in .agentvibes/bmad/ - removing duplicate)${NC}"
-        rm .claude/config/bmad-voices-enabled.flag
-    else
-        mv .claude/config/bmad-voices-enabled.flag .agentvibes/bmad/
-        echo -e "${GREEN}  ✓ Moved to .agentvibes/bmad/${NC}"
-    fi
-    MIGRATED=true
-fi
-
-echo ""
-
-# Migrate AgentVibes config files
-echo -e "${BLUE}🔍 Checking for AgentVibes config in .claude/config/...${NC}"
-
-if [[ -f ".claude/config/agentvibes.json" ]]; then
-    echo -e "${YELLOW}  Found: agentvibes.json${NC}"
-    mv .claude/config/agentvibes.json .agentvibes/config/
-    echo -e "${GREEN}  ✓ Moved to .agentvibes/config/${NC}"
-    MIGRATED=true
-fi
-
-if [[ -f ".claude/config/personality-voice-defaults.default.json" ]]; then
-    echo -e "${YELLOW}  Found: personality-voice-defaults.default.json${NC}"
-    mv .claude/config/personality-voice-defaults.default.json .agentvibes/config/
-    echo -e "${GREEN}  ✓ Moved to .agentvibes/config/${NC}"
-    MIGRATED=true
-fi
-
-if [[ -f ".claude/config/personality-voice-defaults.json" ]]; then
-    echo -e "${YELLOW}  Found: personality-voice-defaults.json${NC}"
-    mv .claude/config/personality-voice-defaults.json .agentvibes/config/
-    echo -e "${GREEN}  ✓ Moved to .agentvibes/config/${NC}"
-    MIGRATED=true
-fi
-
-if [[ -f ".claude/config/README-personality-defaults.md" ]]; then
-    echo -e "${YELLOW}  Found: README-personality-defaults.md${NC}"
-    mv .claude/config/README-personality-defaults.md .agentvibes/config/
-    echo -e "${GREEN}  ✓ Moved to .agentvibes/config/${NC}"
-    MIGRATED=true
-fi
-
-echo ""
-
-# Clean up empty directories
-echo -e "${BLUE}🧹 Cleaning up...${NC}"
-
-if [[ -d ".claude/plugins" ]] && [[ -z "$(ls -A .claude/plugins 2>/dev/null)" ]]; then
-    rmdir .claude/plugins
-    echo -e "${GREEN}✓ Removed empty .claude/plugins/ directory${NC}"
-fi
-
-# Note: We don't remove .claude/config/ because it may contain runtime state files
-# like tts-speech-rate.txt that should stay there
-
-echo ""
-
-if [[ "$MIGRATED" == "true" ]]; then
-    echo -e "${GREEN}✅ Migration complete!${NC}"
-    echo ""
-    echo "Your AgentVibes configuration has been moved to:"
-    echo "  .agentvibes/bmad/    - BMAD voice mappings and state"
-    echo "  .agentvibes/config/  - AgentVibes settings"
-    echo ""
-    echo "Old locations are no longer used:"
-    echo "  .claude/plugins/     - (removed if empty)"
-    echo "  .claude/config/      - (AgentVibes files removed)"
-    echo ""
-    echo -e "${BLUE}ℹ️  Note: .claude/config/ still exists for runtime state files${NC}"
-    echo "   (like tts-speech-rate.txt - these belong to Claude Code)"
-else
-    echo -e "${GREEN}✓ No migration needed${NC}"
-    echo ""
-    echo "All configuration is already in .agentvibes/"
-fi
-
-echo ""
-echo -e "${GREEN}🎉 Ready to use AgentVibes!${NC}"
+#!/usr/bin/env bash
+#
+# File: .claude/hooks/migrate-to-agentvibes.sh
+#
+# AgentVibes - Migration Script for v2.10.0+
+# Migrates configuration from .claude/config/ and .claude/plugins/ to .agentvibes/
+#
+# This script is automatically run by the installer if old config is detected.
+# Can also be run manually: .claude/hooks/migrate-to-agentvibes.sh
+#
+
+set -euo pipefail
+
+# Colors for output
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+echo -e "${BLUE}🔄 AgentVibes Configuration Migration${NC}"
+echo ""
+echo "Migrating from .claude/config/ and .claude/plugins/ to .agentvibes/"
+echo ""
+
+# Determine project root
+if [[ -n "${CLAUDE_PROJECT_DIR:-}" ]]; then
+    PROJECT_ROOT="$CLAUDE_PROJECT_DIR"
+else
+    PROJECT_ROOT="$(pwd)"
+fi
+
+cd "$PROJECT_ROOT"
+
+# Track if any migrations happened
+MIGRATED=false
+
+# Create target directories
+echo -e "${BLUE}📁 Creating .agentvibes/ directory structure...${NC}"
+mkdir -p .agentvibes/bmad
+mkdir -p .agentvibes/config
+echo -e "${GREEN}✓ Directories created${NC}"
+echo ""
+
+# Migrate BMAD files from .claude/plugins/
+echo -e "${BLUE}🔍 Checking for BMAD files in .claude/plugins/...${NC}"
+
+if [[ -f ".claude/plugins/bmad-voices-enabled.flag" ]]; then
+    echo -e "${YELLOW}  Found: bmad-voices-enabled.flag${NC}"
+    mv .claude/plugins/bmad-voices-enabled.flag .agentvibes/bmad/
+    echo -e "${GREEN}  ✓ Moved to .agentvibes/bmad/${NC}"
+    MIGRATED=true
+fi
+
+if [[ -f ".claude/plugins/bmad-party-mode-disabled.flag" ]]; then
+    echo -e "${YELLOW}  Found: bmad-party-mode-disabled.flag${NC}"
+    mv .claude/plugins/bmad-party-mode-disabled.flag .agentvibes/bmad/
+    echo -e "${GREEN}  ✓ Moved to .agentvibes/bmad/${NC}"
+    MIGRATED=true
+fi
+
+if [[ -f ".claude/plugins/.bmad-previous-settings" ]]; then
+    echo -e "${YELLOW}  Found: .bmad-previous-settings${NC}"
+    mv .claude/plugins/.bmad-previous-settings .agentvibes/bmad/
+    echo -e "${GREEN}  ✓ Moved to .agentvibes/bmad/${NC}"
+    MIGRATED=true
+fi
+
+echo ""
+
+# Migrate BMAD files from .claude/config/
+echo -e "${BLUE}🔍 Checking for BMAD files in .claude/config/...${NC}"
+
+if [[ -f ".claude/config/bmad-voices.md" ]]; then
+    echo -e "${YELLOW}  Found: bmad-voices.md${NC}"
+    mv .claude/config/bmad-voices.md .agentvibes/bmad/
+    echo -e "${GREEN}  ✓ Moved to .agentvibes/bmad/${NC}"
+    MIGRATED=true
+fi
+
+if [[ -f ".claude/config/bmad-voices-enabled.flag" ]]; then
+    echo -e "${YELLOW}  Found: bmad-voices-enabled.flag${NC}"
+    # Check if already exists in new location
+    if [[ -f ".agentvibes/bmad/bmad-voices-enabled.flag" ]]; then
+        echo -e "${BLUE}  (Already exists in .agentvibes/bmad/ - removing duplicate)${NC}"
+        rm .claude/config/bmad-voices-enabled.flag
+    else
+        mv .claude/config/bmad-voices-enabled.flag .agentvibes/bmad/
+        echo -e "${GREEN}  ✓ Moved to .agentvibes/bmad/${NC}"
+    fi
+    MIGRATED=true
+fi
+
+echo ""
+
+# Migrate AgentVibes config files
+echo -e "${BLUE}🔍 Checking for AgentVibes config in .claude/config/...${NC}"
+
+if [[ -f ".claude/config/agentvibes.json" ]]; then
+    echo -e "${YELLOW}  Found: agentvibes.json${NC}"
+    mv .claude/config/agentvibes.json .agentvibes/config/
+    echo -e "${GREEN}  ✓ Moved to .agentvibes/config/${NC}"
+    MIGRATED=true
+fi
+
+if [[ -f ".claude/config/personality-voice-defaults.default.json" ]]; then
+    echo -e "${YELLOW}  Found: personality-voice-defaults.default.json${NC}"
+    mv .claude/config/personality-voice-defaults.default.json .agentvibes/config/
+    echo -e "${GREEN}  ✓ Moved to .agentvibes/config/${NC}"
+    MIGRATED=true
+fi
+
+if [[ -f ".claude/config/personality-voice-defaults.json" ]]; then
+    echo -e "${YELLOW}  Found: personality-voice-defaults.json${NC}"
+    mv .claude/config/personality-voice-defaults.json .agentvibes/config/
+    echo -e "${GREEN}  ✓ Moved to .agentvibes/config/${NC}"
+    MIGRATED=true
+fi
+
+if [[ -f ".claude/config/README-personality-defaults.md" ]]; then
+    echo -e "${YELLOW}  Found: README-personality-defaults.md${NC}"
+    mv .claude/config/README-personality-defaults.md .agentvibes/config/
+    echo -e "${GREEN}  ✓ Moved to .agentvibes/config/${NC}"
+    MIGRATED=true
+fi
+
+echo ""
+
+# Clean up empty directories
+echo -e "${BLUE}🧹 Cleaning up...${NC}"
+
+if [[ -d ".claude/plugins" ]] && [[ -z "$(ls -A .claude/plugins 2>/dev/null)" ]]; then
+    rmdir .claude/plugins
+    echo -e "${GREEN}✓ Removed empty .claude/plugins/ directory${NC}"
+fi
+
+# Note: We don't remove .claude/config/ because it may contain runtime state files
+# like tts-speech-rate.txt that should stay there
+
+echo ""
+
+if [[ "$MIGRATED" == "true" ]]; then
+    echo -e "${GREEN}✅ Migration complete!${NC}"
+    echo ""
+    echo "Your AgentVibes configuration has been moved to:"
+    echo "  .agentvibes/bmad/    - BMAD voice mappings and state"
+    echo "  .agentvibes/config/  - AgentVibes settings"
+    echo ""
+    echo "Old locations are no longer used:"
+    echo "  .claude/plugins/     - (removed if empty)"
+    echo "  .claude/config/      - (AgentVibes files removed)"
+    echo ""
+    echo -e "${BLUE}ℹ️  Note: .claude/config/ still exists for runtime state files${NC}"
+    echo "   (like tts-speech-rate.txt - these belong to Claude Code)"
+else
+    echo -e "${GREEN}✓ No migration needed${NC}"
+    echo ""
+    echo "All configuration is already in .agentvibes/"
+fi
+
+echo ""
+echo -e "${GREEN}🎉 Ready to use AgentVibes!${NC}"

package/.claude/hooks/optimize-background-music.sh

@@ -1,87 +1,87 @@
-#!/usr/bin/env bash
-#
-# File: .claude/hooks/optimize-background-music.sh
-#
-# AgentVibes - Background Music Optimizer
-# Creates small, looping clips optimized for RDP/remote playback
-#
-# Strategy:
-# 1. Extract 10-15 second clips from each track
-# 2. Find seamless loop points
-# 3. Convert to mono 22kHz 32kbps MP3
-# 4. Target: 50-100KB per file (vs 2-7MB originals)
-#
-
-set -euo pipefail
-export LC_ALL=C
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-BACKGROUNDS_DIR="$SCRIPT_DIR/../audio/tracks"
-OPTIMIZED_DIR="$BACKGROUNDS_DIR/optimized"
-
-mkdir -p "$OPTIMIZED_DIR"
-
-# Check dependencies
-if ! command -v ffmpeg &> /dev/null; then
-    echo "❌ Error: ffmpeg required for optimization"
-    exit 1
-fi
-
-echo "🎵 Optimizing background music for RDP/remote playback..."
-echo ""
-
-# Function to optimize a single track
-optimize_track() {
-    local input="$1"
-    local filename=$(basename "$input")
-    local output="$OPTIMIZED_DIR/${filename%.mp3}-loop.mp3"
-
-    # Skip if already optimized
-    if [[ -f "$output" ]]; then
-        echo "   ⏭️  Skipped (already exists): $filename"
-        return
-    fi
-
-    # Get duration
-    local duration
-    duration=$(ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 "$input" 2>/dev/null)
-    duration=${duration%.*}
-
-    # Extract middle 15 seconds (best chance for smooth loop)
-    local start=$((duration / 2 - 7))
-    [[ $start -lt 0 ]] && start=0
-
-    echo "   🔄 Processing: $filename"
-    echo "      • Extract: 15s loop from middle"
-    echo "      • Convert: mono, 22kHz, 32kbps"
-
-    # Extract 15 seconds, convert to mono 22kHz 32kbps, add fade in/out for seamless loop
-    ffmpeg -i "$input" -ss $start -t 15 \
-        -ac 1 -ar 22050 -b:a 32k \
-        -af "afade=t=in:d=0.3,afade=t=out:st=14.7:d=0.3" \
-        -y "$output" 2>/dev/null
-
-    # Show size comparison
-    local orig_size=$(du -h "$input" | cut -f1)
-    local new_size=$(du -h "$output" | cut -f1)
-    local reduction=$((100 - ($(stat -f%z "$output" 2>/dev/null || stat -c%s "$output") * 100 / $(stat -f%z "$input" 2>/dev/null || stat -c%s "$input"))))
-
-    echo "      ✓ Done: $orig_size → $new_size (${reduction}% reduction)"
-    echo ""
-}
-
-# Process all background music files
-for track in "$BACKGROUNDS_DIR"/*.mp3; do
-    [[ -f "$track" ]] || continue
-    optimize_track "$track"
-done
-
-echo "✅ Optimization complete!"
-echo ""
-echo "📊 Results:"
-echo "   Original dir: $(du -sh "$BACKGROUNDS_DIR" | cut -f1)"
-echo "   Optimized dir: $(du -sh "$OPTIMIZED_DIR" | cut -f1)"
-echo ""
-echo "💡 To use optimized tracks:"
-echo "   1. Update audio-effects.cfg to point to optimized/*.mp3"
-echo "   2. Or replace originals: cp optimized/* ./"
+#!/usr/bin/env bash
+#
+# File: .claude/hooks/optimize-background-music.sh
+#
+# AgentVibes - Background Music Optimizer
+# Creates small, looping clips optimized for RDP/remote playback
+#
+# Strategy:
+# 1. Extract 10-15 second clips from each track
+# 2. Find seamless loop points
+# 3. Convert to mono 22kHz 32kbps MP3
+# 4. Target: 50-100KB per file (vs 2-7MB originals)
+#
+
+set -euo pipefail
+export LC_ALL=C
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+BACKGROUNDS_DIR="$SCRIPT_DIR/../audio/tracks"
+OPTIMIZED_DIR="$BACKGROUNDS_DIR/optimized"
+
+mkdir -p "$OPTIMIZED_DIR"
+
+# Check dependencies
+if ! command -v ffmpeg &> /dev/null; then
+    echo "❌ Error: ffmpeg required for optimization"
+    exit 1
+fi
+
+echo "🎵 Optimizing background music for RDP/remote playback..."
+echo ""
+
+# Function to optimize a single track
+optimize_track() {
+    local input="$1"
+    local filename=$(basename "$input")
+    local output="$OPTIMIZED_DIR/${filename%.mp3}-loop.mp3"
+
+    # Skip if already optimized
+    if [[ -f "$output" ]]; then
+        echo "   ⏭️  Skipped (already exists): $filename"
+        return
+    fi
+
+    # Get duration
+    local duration
+    duration=$(ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 "$input" 2>/dev/null)
+    duration=${duration%.*}
+
+    # Extract middle 15 seconds (best chance for smooth loop)
+    local start=$((duration / 2 - 7))
+    [[ $start -lt 0 ]] && start=0
+
+    echo "   🔄 Processing: $filename"
+    echo "      • Extract: 15s loop from middle"
+    echo "      • Convert: mono, 22kHz, 32kbps"
+
+    # Extract 15 seconds, convert to mono 22kHz 32kbps, add fade in/out for seamless loop
+    ffmpeg -i "$input" -ss $start -t 15 \
+        -ac 1 -ar 22050 -b:a 32k \
+        -af "afade=t=in:d=0.3,afade=t=out:st=14.7:d=0.3" \
+        -y "$output" 2>/dev/null
+
+    # Show size comparison
+    local orig_size=$(du -h "$input" | cut -f1)
+    local new_size=$(du -h "$output" | cut -f1)
+    local reduction=$((100 - ($(stat -f%z "$output" 2>/dev/null || stat -c%s "$output") * 100 / $(stat -f%z "$input" 2>/dev/null || stat -c%s "$input"))))
+
+    echo "      ✓ Done: $orig_size → $new_size (${reduction}% reduction)"
+    echo ""
+}
+
+# Process all background music files
+for track in "$BACKGROUNDS_DIR"/*.mp3; do
+    [[ -f "$track" ]] || continue
+    optimize_track "$track"
+done
+
+echo "✅ Optimization complete!"
+echo ""
+echo "📊 Results:"
+echo "   Original dir: $(du -sh "$BACKGROUNDS_DIR" | cut -f1)"
+echo "   Optimized dir: $(du -sh "$OPTIMIZED_DIR" | cut -f1)"
+echo ""
+echo "💡 To use optimized tracks:"
+echo "   1. Update audio-effects.cfg to point to optimized/*.mp3"
+echo "   2. Or replace originals: cp optimized/* ./"

package/.claude/hooks/path-resolver.sh

@@ -1,60 +1,60 @@
-#!/usr/bin/env bash
-#
-# File: .claude/hooks/path-resolver.sh
-#
-# AgentVibes Path Resolver Utility - Robust path resolution for all hooks
-# Handles: symlinks, working directory changes, non-standard installations
-#
-# Usage in other scripts:
-#   source "$(dirname "${BASH_SOURCE[0]}")/path-resolver.sh"
-#   # Now use: $PROJECT_ROOT, $HOOKS_DIR, $SCRIPT_DIR
-#
-
-set -euo pipefail
-
-# Resolve the actual script location (handles symlinks)
-# This function must be called from the sourcing script
-_resolve_agentvibes_paths() {
-  local calling_script="$1"
-
-  # Get real path (resolve symlinks)
-  local script_path
-  if command -v readlink &>/dev/null; then
-    script_path="$(readlink -f "$calling_script")"
-  else
-    # Fallback for systems without readlink -f
-    script_path="$(cd "$(dirname "$calling_script")" && pwd)/$(basename "$calling_script")"
-  fi
-
-  local script_dir="$(dirname "$script_path")"
-
-  # Find PROJECT_ROOT by searching up for .claude/hooks directory
-  # This is resilient to non-standard installations
-  local current_dir="$script_dir"
-  local project_root=""
-
-  while [[ "$current_dir" != "/" ]]; do
-    if [[ -d "$current_dir/.claude/hooks" ]]; then
-      # Found .claude/hooks - PROJECT_ROOT is 2 levels up
-      project_root="$(dirname "$(dirname "$current_dir")")"
-      break
-    fi
-    current_dir="$(dirname "$current_dir")"
-  done
-
-  # Validate we found a valid project root
-  if [[ -z "$project_root" ]] || [[ ! -d "$project_root/.claude/hooks" ]]; then
-    echo "❌ ERROR: Could not locate AgentVibes installation" >&2
-    echo "   Script: $script_path" >&2
-    return 1
-  fi
-
-  # Export paths for use in sourcing script
-  export SCRIPT_PATH="$script_path"
-  export SCRIPT_DIR="$script_dir"
-  export HOOKS_DIR="$project_root/.claude/hooks"
-  export PROJECT_ROOT="$project_root"
-}
-
-# Call the resolver with the calling script
-_resolve_agentvibes_paths "${BASH_SOURCE[1]}"
+#!/usr/bin/env bash
+#
+# File: .claude/hooks/path-resolver.sh
+#
+# AgentVibes Path Resolver Utility - Robust path resolution for all hooks
+# Handles: symlinks, working directory changes, non-standard installations
+#
+# Usage in other scripts:
+#   source "$(dirname "${BASH_SOURCE[0]}")/path-resolver.sh"
+#   # Now use: $PROJECT_ROOT, $HOOKS_DIR, $SCRIPT_DIR
+#
+
+set -euo pipefail
+
+# Resolve the actual script location (handles symlinks)
+# This function must be called from the sourcing script
+_resolve_agentvibes_paths() {
+  local calling_script="$1"
+
+  # Get real path (resolve symlinks)
+  local script_path
+  if command -v readlink &>/dev/null; then
+    script_path="$(readlink -f "$calling_script")"
+  else
+    # Fallback for systems without readlink -f
+    script_path="$(cd "$(dirname "$calling_script")" && pwd)/$(basename "$calling_script")"
+  fi
+
+  local script_dir="$(dirname "$script_path")"
+
+  # Find PROJECT_ROOT by searching up for .claude/hooks directory
+  # This is resilient to non-standard installations
+  local current_dir="$script_dir"
+  local project_root=""
+
+  while [[ "$current_dir" != "/" ]]; do
+    if [[ -d "$current_dir/.claude/hooks" ]]; then
+      # Found .claude/hooks - PROJECT_ROOT is 2 levels up
+      project_root="$(dirname "$(dirname "$current_dir")")"
+      break
+    fi
+    current_dir="$(dirname "$current_dir")"
+  done
+
+  # Validate we found a valid project root
+  if [[ -z "$project_root" ]] || [[ ! -d "$project_root/.claude/hooks" ]]; then
+    echo "❌ ERROR: Could not locate AgentVibes installation" >&2
+    echo "   Script: $script_path" >&2
+    return 1
+  fi
+
+  # Export paths for use in sourcing script
+  export SCRIPT_PATH="$script_path"
+  export SCRIPT_DIR="$script_dir"
+  export HOOKS_DIR="$project_root/.claude/hooks"
+  export PROJECT_ROOT="$project_root"
+}
+
+# Call the resolver with the calling script
+_resolve_agentvibes_paths "${BASH_SOURCE[1]}"