Merge PR #29: Add native Linux support

Adds native Linux support by @MagiCrazy with cascading audio backends
(pw-play/paplay/ffplay/mpv/play/aplay), notify-send notifications,
xdotool terminal focus detection, and comprehensive test coverage.

Resolves VERSION conflict (1.3.0 vs 1.3.4 → 1.4.0).

Co-Authored-By: Magic.Crazy <MagiCrazy@users.noreply.github.com>

Author: garysheng

README.md

@@ -1 +1 @@
-1.3.0
+1.4.0

VERSION

@@ -1141,6 +1141,50 @@ <h2 class="section-title">Choose your character</h2>
           </div>
         </div>
       </div>
+      <!-- Pack 6: TF2 Engineer -->
+      <div class="carousel-slide" data-pack="tf2_engineer">
+        <div class="pack-card-full">
+          <div class="pack-header">
+            <div class="pack-badge">New</div>
+            <div class="pack-name">TF2 Engineer</div>
+            <div class="pack-game">Team Fortress 2</div>
+            <code class="pack-id">tf2_engineer</code>
+            <div class="pack-credit">Added by <a href="https://github.com/Arie">@Arie</a></div>
+          </div>
+          <div class="pack-sounds">
+            <button class="pack-sound-btn" data-src="audio/Engineer_battlecry03.mp3" aria-label="Play: Cowboy up!">
+              <span class="pack-sound-icon">&#9654;</span>
+              <span class="pack-sound-quote">"Cowboy up!"</span>
+              <span class="pack-sound-cat">greeting</span>
+            </button>
+            <button class="pack-sound-btn" data-src="audio/Engineer_autobuildingsentry01.mp3" aria-label="Play: Sentry going up.">
+              <span class="pack-sound-icon">&#9654;</span>
+              <span class="pack-sound-quote">"Sentry going up."</span>
+              <span class="pack-sound-cat">acknowledge</span>
+            </button>
+            <button class="pack-sound-btn" data-src="audio/Eng_quest_complete_easy_01.mp3" aria-label="Play: Nice work!">
+              <span class="pack-sound-icon">&#9654;</span>
+              <span class="pack-sound-quote">"Nice work!"</span>
+              <span class="pack-sound-cat">complete</span>
+            </button>
+            <button class="pack-sound-btn" data-src="audio/Engineer_autodestroyedsentry01.mp3" aria-label="Play: Sentry down!">
+              <span class="pack-sound-icon">&#9654;</span>
+              <span class="pack-sound-quote">"Sentry down!"</span>
+              <span class="pack-sound-cat">error</span>
+            </button>
+            <button class="pack-sound-btn" data-src="audio/Engineer_wranglekills01.mp3" aria-label="Play: This thing ain't on auto-pilot, son!">
+              <span class="pack-sound-icon">&#9654;</span>
+              <span class="pack-sound-quote">"Ain't on auto-pilot, son!"</span>
+              <span class="pack-sound-cat">permission</span>
+            </button>
+            <button class="pack-sound-btn" data-src="audio/Engineer_goldenwrenchkill04.mp3" aria-label="Play: Erectin' a statue of a moron.">
+              <span class="pack-sound-icon">&#9654;</span>
+              <span class="pack-sound-quote">"Erectin' a statue of a moron."</span>
+              <span class="pack-sound-cat">annoyed</span>
+            </button>
+          </div>
+        </div>
+      </div>
     </div>
 
     <button class="carousel-arrow carousel-next" aria-label="Next pack">
@@ -1154,6 +1198,7 @@ <h2 class="section-title">Choose your character</h2>
     <button class="carousel-dot" data-index="2" aria-label="Soviet Engineer"></button>
     <button class="carousel-dot" data-index="3" aria-label="Battlecruiser"></button>
     <button class="carousel-dot" data-index="4" aria-label="Sarah Kerrigan"></button>
+    <button class="carousel-dot" data-index="5" aria-label="TF2 Engineer"></button>
   </div>
 
   <div class="contribute-cta">

docs/audio/Eng_quest_complete_easy_01.mp3

@@ -4,12 +4,24 @@
 # Re-running updates core files; sounds are version-controlled in the repo
 set -euo pipefail
 
-INSTALL_DIR="$HOME/.claude/hooks/peon-ping"
-SETTINGS="$HOME/.claude/settings.json"
+LOCAL_MODE=false
+for arg in "$@"; do
+  case "$arg" in
+    --local) LOCAL_MODE=true ;;
+  esac
+done
+
+if [ "$LOCAL_MODE" = true ]; then
+  BASE_DIR="$PWD/.claude"
+else
+  BASE_DIR="$HOME/.claude"
+fi
+INSTALL_DIR="$BASE_DIR/hooks/peon-ping"
+SETTINGS="$BASE_DIR/settings.json"
 REPO_BASE="https://raw.githubusercontent.com/tonyyont/peon-ping/main"
 
 # All available sound packs (add new packs here)
-PACKS="peon peon_fr peon_pl peasant peasant_fr ra2_soviet_engineer sc_battlecruiser sc_kerrigan"
+PACKS="acolyte_ru glados peon peon_fr peon_pl peon_ru peasant peasant_fr peasant_ru ra2_soviet_engineer sc_battlecruiser sc_firebat sc_kerrigan sc_medic sc_scv sc_tank sc_terran sc_vessel tf2_engineer"
 
 # --- Platform detection ---
 detect_platform() {
@@ -87,8 +99,12 @@ elif [ "$PLATFORM" = "linux" ]; then
   fi
 fi
 
-if [ ! -d "$HOME/.claude" ]; then
-  echo "Error: ~/.claude/ not found. Is Claude Code installed?"
+if [ ! -d "$BASE_DIR" ]; then
+  if [ "$LOCAL_MODE" = true ]; then
+    echo "Error: .claude/ not found in current directory. Is this a Claude Code project?"
+  else
+    echo "Error: ~/.claude/ not found. Is Claude Code installed?"
+  fi
   exit 1
 fi
 
@@ -152,35 +168,50 @@ fi
 chmod +x "$INSTALL_DIR/peon.sh"
 
 # --- Install skill (slash command) ---
-SKILL_DIR="$HOME/.claude/skills/peon-ping-toggle"
+SKILL_DIR="$BASE_DIR/skills/peon-ping-toggle"
 mkdir -p "$SKILL_DIR"
+if [ "$LOCAL_MODE" = true ]; then
+  SKILL_HOOK_CMD="bash .claude/hooks/peon-ping/peon.sh"
+else
+  SKILL_HOOK_CMD="bash ~/.claude/hooks/peon-ping/peon.sh"
+fi
 if [ -n "$SCRIPT_DIR" ] && [ -d "$SCRIPT_DIR/skills/peon-ping-toggle" ]; then
   cp "$SCRIPT_DIR/skills/peon-ping-toggle/SKILL.md" "$SKILL_DIR/"
+  if [ "$LOCAL_MODE" = true ]; then
+    sed -i.bak 's|bash ~/.claude/hooks/peon-ping/peon.sh|'"$SKILL_HOOK_CMD"'|g' "$SKILL_DIR/SKILL.md"
+    rm -f "$SKILL_DIR/SKILL.md.bak"
+  fi
 elif [ -z "$SCRIPT_DIR" ]; then
   curl -fsSL "$REPO_BASE/skills/peon-ping-toggle/SKILL.md" -o "$SKILL_DIR/SKILL.md"
+  if [ "$LOCAL_MODE" = true ]; then
+    sed -i.bak 's|bash ~/.claude/hooks/peon-ping/peon.sh|'"$SKILL_HOOK_CMD"'|g' "$SKILL_DIR/SKILL.md"
+    rm -f "$SKILL_DIR/SKILL.md.bak"
+  fi
 else
   echo "Warning: skills/peon-ping-toggle not found in local clone, skipping skill install"
 fi
 
-# --- Add shell alias ---
-ALIAS_LINE='alias peon="bash ~/.claude/hooks/peon-ping/peon.sh"'
-for rcfile in "$HOME/.zshrc" "$HOME/.bashrc"; do
-  if [ -f "$rcfile" ] && ! grep -qF 'alias peon=' "$rcfile"; then
-    echo "" >> "$rcfile"
-    echo "# peon-ping quick controls" >> "$rcfile"
-    echo "$ALIAS_LINE" >> "$rcfile"
-    echo "Added peon alias to $(basename "$rcfile")"
-  fi
-done
+# --- Add shell alias (global install only) ---
+if [ "$LOCAL_MODE" = false ]; then
+  ALIAS_LINE='alias peon="bash ~/.claude/hooks/peon-ping/peon.sh"'
+  for rcfile in "$HOME/.zshrc" "$HOME/.bashrc"; do
+    if [ -f "$rcfile" ] && ! grep -qF 'alias peon=' "$rcfile"; then
+      echo "" >> "$rcfile"
+      echo "# peon-ping quick controls" >> "$rcfile"
+      echo "$ALIAS_LINE" >> "$rcfile"
+      echo "Added peon alias to $(basename "$rcfile")"
+    fi
+  done
 
-# --- Add tab completion ---
-COMPLETION_LINE='[ -f ~/.claude/hooks/peon-ping/completions.bash ] && source ~/.claude/hooks/peon-ping/completions.bash'
-for rcfile in "$HOME/.zshrc" "$HOME/.bashrc"; do
-  if [ -f "$rcfile" ] && ! grep -qF 'peon-ping/completions.bash' "$rcfile"; then
-    echo "$COMPLETION_LINE" >> "$rcfile"
-    echo "Added tab completion to $(basename "$rcfile")"
-  fi
-done
+  # --- Add tab completion ---
+  COMPLETION_LINE='[ -f ~/.claude/hooks/peon-ping/completions.bash ] && source ~/.claude/hooks/peon-ping/completions.bash'
+  for rcfile in "$HOME/.zshrc" "$HOME/.bashrc"; do
+    if [ -f "$rcfile" ] && ! grep -qF 'peon-ping/completions.bash' "$rcfile"; then
+      echo "$COMPLETION_LINE" >> "$rcfile"
+      echo "Added tab completion to $(basename "$rcfile")"
+    fi
+  done
+fi
 
 # --- Verify sounds are installed ---
 echo ""
@@ -194,8 +225,8 @@ for pack in $PACKS; do
   fi
 done
 
-# --- Backup existing notify.sh (fresh install only) ---
-if [ "$UPDATING" = false ]; then
+# --- Backup existing notify.sh (global fresh install only) ---
+if [ "$LOCAL_MODE" = false ] && [ "$UPDATING" = false ]; then
   NOTIFY_SH="$HOME/.claude/hooks/notify.sh"
   if [ -f "$NOTIFY_SH" ]; then
     cp "$NOTIFY_SH" "$NOTIFY_SH.backup"
@@ -208,11 +239,17 @@ fi
 echo ""
 echo "Updating Claude Code hooks in settings.json..."
 
+if [ "$LOCAL_MODE" = true ]; then
+  HOOK_CMD=".claude/hooks/peon-ping/peon.sh"
+else
+  HOOK_CMD="$HOME/.claude/hooks/peon-ping/peon.sh"
+fi
+
 python3 -c "
 import json, os, sys
 
-settings_path = os.path.expanduser('~/.claude/settings.json')
-hook_cmd = os.path.expanduser('~/.claude/hooks/peon-ping/peon.sh')
+settings_path = '$SETTINGS'
+hook_cmd = '$HOOK_CMD'
 
 # Load existing settings
 if os.path.exists(settings_path):
@@ -268,9 +305,9 @@ fi
 echo ""
 echo "Testing sound..."
 ACTIVE_PACK=$(python3 -c "
-import json, os
+import json
 try:
-    c = json.load(open(os.path.expanduser('~/.claude/hooks/peon-ping/config.json')))
+    c = json.load(open('$INSTALL_DIR/config.json'))
     print(c.get('active_pack', 'peon'))
 except:
     print('peon')
@@ -329,7 +366,9 @@ fi
 echo ""
 echo "Quick controls:"
 echo "  /peon-ping-toggle  — toggle sounds in Claude Code"
-echo "  peon --toggle      — toggle sounds from any terminal"
-echo "  peon --status      — check if sounds are paused"
+if [ "$LOCAL_MODE" = false ]; then
+  echo "  peon --toggle      — toggle sounds from any terminal"
+  echo "  peon --status      — check if sounds are paused"
+fi
 echo ""
 echo "Ready to work!"