claude-raid 0.1.1 → 0.1.3

package/template/.claude/hooks/raid-stop.sh

@@ -0,0 +1,68 @@
+#!/usr/bin/env bash
+# Raid lifecycle hook: Stop
+# Detects phase transitions and injects human confirmation gate.
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/raid-lib.sh"
+
+if [ "$RAID_ACTIVE" != "true" ]; then
+  exit 0
+fi
+
+if [ "$RAID_LIFECYCLE_PHASE_CONFIRM" != "true" ]; then
+  exit 0
+fi
+
+STORED_PHASE="$RAID_PHASE"
+
+# Phase ordering: name → rank for comparison
+phase_rank() {
+  case "$1" in
+    design)         echo 1 ;;
+    plan)           echo 2 ;;
+    implementation) echo 3 ;;
+    review)         echo 4 ;;
+    finishing)      echo 5 ;;
+    *)              echo 0 ;;
+  esac
+}
+
+# Detect current phase from Dungeon file
+# Only matches structured markers: <!-- RAID_PHASE: plan -->
+DETECTED_PHASE="$STORED_PHASE"
+if [ -f ".claude/raid-dungeon.md" ]; then
+  BEST_RANK=0
+  BEST_PHASE="$STORED_PHASE"
+  for phase_name in $(grep -oE '<!-- RAID_PHASE: (design|plan|implementation|review|finishing) -->' ".claude/raid-dungeon.md" 2>/dev/null | grep -oE '(design|plan|implementation|review|finishing)'); do
+    RANK=$(phase_rank "$phase_name")
+    if [ "$RANK" -gt "$BEST_RANK" ]; then
+      BEST_RANK=$RANK
+      BEST_PHASE=$phase_name
+    fi
+  done
+  DETECTED_PHASE="$BEST_PHASE"
+fi
+
+# Compare phases by rank
+STORED_RANK=$(phase_rank "$STORED_PHASE")
+DETECTED_RANK=$(phase_rank "$DETECTED_PHASE")
+
+if [ "$DETECTED_RANK" -gt "$STORED_RANK" ] 2>/dev/null; then
+  # Update raid-session with new phase name
+  if command -v jq >/dev/null 2>&1; then
+    jq --arg phase "$DETECTED_PHASE" '.phase = $phase' ".claude/raid-session" > ".claude/raid-session.tmp" 2>/dev/null && \
+      mv ".claude/raid-session.tmp" ".claude/raid-session"
+  fi
+
+  cat <<ENDJSON
+{
+  "hookSpecificOutput": {
+    "hookEventName": "Stop",
+    "additionalContext": "Phase transition detected ($STORED_PHASE → $DETECTED_PHASE). The Wizard must confirm with the human before opening the next phase."
+  }
+}
+ENDJSON
+fi
+
+exit 0

package/template/.claude/hooks/raid-task-completed.sh

@@ -0,0 +1,37 @@
+#!/usr/bin/env bash
+# Raid lifecycle hook: TaskCompleted
+# Blocks task completion if tests haven't run recently.
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/raid-lib.sh"
+
+if [ "$RAID_ACTIVE" != "true" ]; then
+  exit 0
+fi
+
+if [ "$RAID_LIFECYCLE_COMPLETION_GATE" != "true" ]; then
+  exit 0
+fi
+
+TEST_RUN_FILE=".claude/raid-last-test-run"
+
+if [ ! -f "$TEST_RUN_FILE" ]; then
+  raid_block "Tests must pass before marking a task complete. No test run recorded — run your test command first."
+fi
+
+LAST_RUN=$(cat "$TEST_RUN_FILE" 2>/dev/null | tr -d '[:space:]')
+NOW=$(date +%s)
+WINDOW=$((RAID_LIFECYCLE_TEST_WINDOW * 60))
+# Guard against corrupted/non-numeric timestamp
+case "$LAST_RUN" in
+  ''|*[!0-9]*) raid_block "Tests must pass before marking a task complete. Test run timestamp is invalid — run your test command first." ;;
+esac
+AGE=$((NOW - LAST_RUN))
+
+if [ "$AGE" -gt "$WINDOW" ]; then
+  MINS_AGO=$((AGE / 60))
+  raid_block "Tests last ran $MINS_AGO minutes ago (window is $RAID_LIFECYCLE_TEST_WINDOW min). Run tests again before marking this task complete."
+fi
+
+exit 0

package/template/.claude/hooks/raid-task-created.sh

@@ -0,0 +1,40 @@
+#!/usr/bin/env bash
+# Raid lifecycle hook: TaskCreated
+# Validates task subjects are descriptive enough.
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/raid-lib.sh"
+
+if [ "$RAID_ACTIVE" != "true" ]; then
+  exit 0
+fi
+
+if [ "$RAID_LIFECYCLE_TASK_VALIDATION" != "true" ]; then
+  exit 0
+fi
+
+raid_read_lifecycle_input
+
+SUBJECT=$(echo "$RAID_HOOK_INPUT" | jq -r '.task_subject // ""')
+
+if [ -z "$SUBJECT" ]; then
+  raid_block "Task subject cannot be empty."
+fi
+
+if [ "${#SUBJECT}" -lt 10 ]; then
+  raid_block "Task subject too short (${#SUBJECT} chars). Be more descriptive (min 10 chars)."
+fi
+
+FIRST_WORD=$(echo "$SUBJECT" | awk '{print tolower($1)}')
+WORD_COUNT=$(echo "$SUBJECT" | wc -w | tr -d ' ')
+
+if [ "$WORD_COUNT" -le 1 ]; then
+  case "$FIRST_WORD" in
+    fix|update|task|do|change|add|remove|delete)
+      raid_block "Task subject '$SUBJECT' is too generic. Describe what specifically needs to be done."
+      ;;
+  esac
+fi
+
+exit 0

package/template/.claude/hooks/raid-teammate-idle.sh

@@ -0,0 +1,28 @@
+#!/usr/bin/env bash
+# Raid lifecycle hook: TeammateIdle
+# Nudges idle agents to pick up unclaimed tasks.
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/raid-lib.sh"
+
+if [ "$RAID_ACTIVE" != "true" ]; then
+  exit 0
+fi
+
+if [ "$RAID_LIFECYCLE_NUDGE" != "true" ]; then
+  exit 0
+fi
+
+raid_read_lifecycle_input
+TEAMMATE=$(echo "$RAID_HOOK_INPUT" | jq -r '.teammate_name // "Agent"')
+
+cat <<ENDJSON
+{
+  "hookSpecificOutput": {
+    "hookEventName": "TeammateIdle",
+    "additionalContext": "$TEAMMATE: Unclaimed tasks remain on the board. Pick up the next available task and report your plan before starting."
+  }
+}
+ENDJSON
+exit 0

package/template/.claude/hooks/validate-browser-cleanup.sh

@@ -0,0 +1,36 @@
+#!/usr/bin/env bash
+# Raid quality gate: warns if browser testing ports are still occupied
+# PostToolUse hook for Bash commands
+# Checks portRange from .claude/raid.json
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/raid-lib.sh"
+
+# Skip if no active Raid session or browser testing not enabled
+if [ "$RAID_ACTIVE" != "true" ] || [ "$RAID_BROWSER_ENABLED" != "true" ]; then
+  exit 0
+fi
+
+# Skip if no port range configured
+if [ -z "$RAID_BROWSER_PORT_START" ] || [ -z "$RAID_BROWSER_PORT_END" ]; then
+  exit 0
+fi
+
+# Check if any ports in range are still occupied
+LEAKED_PORTS=""
+for PORT in $(seq "$RAID_BROWSER_PORT_START" "$RAID_BROWSER_PORT_END"); do
+  if lsof -i :"$PORT" > /dev/null 2>&1; then
+    LEAKED_PORTS="${LEAKED_PORTS} ${PORT}"
+  fi
+done
+
+if [ -n "$LEAKED_PORTS" ]; then
+  MSG="Raid Quality Check:\nWARNING: Browser testing ports still in use:${LEAKED_PORTS}\nThis may indicate a failed cleanup. To free them:\n"
+  for PORT in $LEAKED_PORTS; do
+    MSG="${MSG}  kill \$(lsof -t -i :${PORT})\n"
+  done
+  raid_warn "$MSG"
+fi
+
+exit 0

package/template/.claude/hooks/validate-browser-tests-exist.sh

@@ -0,0 +1,52 @@
+#!/usr/bin/env bash
+# Raid quality gate: warns if browser-facing code is committed without Playwright tests
+# PreToolUse hook for Bash commands containing 'git commit'
+# Checks for test files in the Playwright test directory
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/raid-lib.sh"
+
+raid_read_input
+
+# Only check git commit commands
+if ! echo "$RAID_COMMAND" | grep -qE 'git commit'; then
+  exit 0
+fi
+
+# Skip if no active Raid session or browser testing not enabled
+if [ "$RAID_ACTIVE" != "true" ] || [ "$RAID_BROWSER_ENABLED" != "true" ]; then
+  exit 0
+fi
+
+# Get staged files that are browser-facing code
+BROWSER_FILES=$(git diff --cached --name-only --diff-filter=ACMR 2>/dev/null | \
+  grep -E '\.(tsx|jsx|vue|svelte)$' | \
+  grep -E '^(src|app|pages|components)/' || true)
+
+if [ -z "$BROWSER_FILES" ]; then
+  exit 0
+fi
+
+# Check if any Playwright test files exist
+HAS_BROWSER_TESTS=false
+for DIR in tests/e2e e2e test/e2e; do
+  if [ -d "$DIR" ]; then
+    SPEC_COUNT=$(find "$DIR" -name '*.spec.ts' -o -name '*.spec.js' 2>/dev/null | wc -l | tr -d ' ')
+    if [ "$SPEC_COUNT" -gt "0" ]; then
+      HAS_BROWSER_TESTS=true
+      break
+    fi
+  fi
+done
+
+if [ "$HAS_BROWSER_TESTS" = false ]; then
+  MSG="Raid Quality Check:\nWARNING: Browser-facing code modified but no Playwright tests found.\nChanged files:\n"
+  while IFS= read -r FILE; do
+    MSG="${MSG}  - ${FILE}\n"
+  done <<< "$BROWSER_FILES"
+  MSG="${MSG}\nIf this component doesn't need browser testing, this is safe to ignore."
+  raid_warn "$MSG"
+fi
+
+exit 0

package/template/.claude/hooks/validate-commit.sh

@@ -0,0 +1,130 @@
+#!/usr/bin/env bash
+# Raid quality gate: consolidated commit validation hook
+# PreToolUse hook for Bash commands containing 'git commit'
+# Consolidates: validate-commit-message.sh, validate-tests-pass.sh, validate-verification.sh
+# Cross-platform: uses grep -E (not grep -P)
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/raid-lib.sh"
+
+raid_read_input
+
+# Only check git commit commands
+if ! echo "$RAID_COMMAND" | grep -qE 'git commit'; then
+  exit 0
+fi
+
+# --- Extract commit message ---
+MSG=""
+if echo "$RAID_COMMAND" | grep -qE -- '-m '; then
+  # Try double-quoted: -m "..."
+  MSG=$(echo "$RAID_COMMAND" | sed -n 's/.*-m "\([^"]*\)".*/\1/p' | head -1)
+  # Try single-quoted: -m '...'
+  if [ -z "$MSG" ]; then
+    MSG=$(echo "$RAID_COMMAND" | sed -n "s/.*-m '\\([^']*\\)'.*/\\1/p" | head -1)
+  fi
+fi
+
+# Try heredoc pattern
+if [ -z "$MSG" ]; then
+  MSG=$(echo "$RAID_COMMAND" | sed -n 's/.*cat <<.*//;n;s/^ *//;p' | head -1)
+fi
+
+# If no message found (editor mode), allow
+if [ -z "$MSG" ]; then
+  exit 0
+fi
+
+# Use first line only for checks
+MSG=$(echo "$MSG" | head -1)
+
+# ============================================================
+# Check 1: Message format (always active, no session required)
+# ============================================================
+
+# Conventional commit format
+if ! echo "$MSG" | grep -qE '^(feat|fix|docs|style|refactor|perf|test|build|ci|chore|revert)(\(.+\))?: .+'; then
+  raid_block "COMMIT: Message must follow conventional commit format (type(scope): description). Got: '$MSG'"
+fi
+
+# Minimum length
+MIN_LENGTH="${RAID_COMMIT_MIN_LENGTH:-15}"
+MSG_LENGTH=${#MSG}
+if [ "$MSG_LENGTH" -lt "$MIN_LENGTH" ]; then
+  raid_block "COMMIT: Message too short (${MSG_LENGTH} chars, minimum ${MIN_LENGTH})."
+fi
+
+# Block generic messages
+LOWER_MSG=$(echo "$MSG" | tr '[:upper:]' '[:lower:]')
+case "$LOWER_MSG" in
+  update|fix|change|modify|edit|wip|temp|test|stuff|things|misc)
+    raid_block "COMMIT: Message is too generic. Describe WHAT changed and WHY."
+    ;;
+esac
+
+# ============================================================
+# Check 2: Tests pass (Raid-session only)
+# ============================================================
+
+if [ "$RAID_ACTIVE" = "true" ] && [ -n "$RAID_TEST_CMD" ]; then
+  # TRUST: RAID_TEST_CMD comes from project-local raid.json — user-controlled, not untrusted input
+  set +e
+  (eval "$RAID_TEST_CMD") > /dev/null 2>&1
+  _test_rc=$?
+  set -e
+  if [ "$_test_rc" -ne 0 ]; then
+    raid_block "TESTS: Tests failed. Fix before committing. Command: $RAID_TEST_CMD"
+  fi
+  # Run browser tests if enabled and Playwright is installed
+  if [ "$RAID_BROWSER_ENABLED" = "true" ] && [ -n "$RAID_BROWSER_PW_CONFIG" ] && [ -f "$RAID_BROWSER_PW_CONFIG" ]; then
+    set +e
+    ($RAID_BROWSER_EXEC_CMD playwright test --reporter=list) > /dev/null 2>&1
+    _pw_rc=$?
+    set -e
+    if [ "$_pw_rc" -ne 0 ]; then
+      raid_block "BROWSER TESTS: Playwright tests failed. Fix before committing. Command: $RAID_BROWSER_EXEC_CMD playwright test"
+    fi
+  fi
+
+  # Write timestamp on success (only when ALL tests pass — unit AND browser)
+  mkdir -p .claude
+  date +%s > .claude/raid-last-test-run
+fi
+
+# ============================================================
+# Check 3: Verification (Raid-session only, completion commits)
+# ============================================================
+
+if [ "$RAID_ACTIVE" = "true" ]; then
+  HAS_COMPLETION=false
+  for WORD in "complete" "done" "finish" "final"; do
+    if echo "$LOWER_MSG" | grep -qiw "$WORD"; then
+      HAS_COMPLETION=true
+      break
+    fi
+  done
+
+  if [ "$HAS_COMPLETION" = "true" ]; then
+    TIMESTAMP_FILE=".claude/raid-last-test-run"
+    MAX_AGE=600
+
+    if [ ! -f "$TIMESTAMP_FILE" ]; then
+      raid_block "VERIFICATION: Commit claims completion but no test run evidence found. Run tests before claiming work is complete."
+    fi
+
+    LAST_RUN=$(cat "$TIMESTAMP_FILE" | tr -d '[:space:]')
+    NOW=$(date +%s)
+    # Guard against corrupted/non-numeric timestamp
+    case "$LAST_RUN" in
+      ''|*[!0-9]*) raid_block "VERIFICATION: Test run timestamp is corrupted. Run tests again before claiming completion." ;;
+    esac
+    AGE=$((NOW - LAST_RUN))
+
+    if [ "$AGE" -gt "$MAX_AGE" ]; then
+      raid_block "VERIFICATION: Last test run was $((AGE / 60)) minutes ago. Run tests again before claiming completion."
+    fi
+  fi
+fi
+
+exit 0

package/template/.claude/hooks/validate-dungeon.sh

@@ -0,0 +1,114 @@
+#!/usr/bin/env bash
+# Raid dungeon discipline: validates Dungeon entry format, evidence, and phase consistency
+# PostToolUse hook for Write|Edit operations on Dungeon files.
+set -euo pipefail
+
+HOOK_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "$HOOK_DIR/raid-lib.sh"
+
+raid_read_input
+
+# No file path — nothing to validate
+if [ -z "${RAID_FILE_PATH:-}" ]; then
+  exit 0
+fi
+
+# Only check Dungeon files
+case "$RAID_FILE_PATH" in
+  */.claude/raid-dungeon.md|*/.claude/raid-dungeon-phase-*.md) ;;
+  .claude/raid-dungeon.md|.claude/raid-dungeon-phase-*.md) ;;
+  *) exit 0 ;;
+esac
+
+# No active session — skip validation
+if [ "$RAID_ACTIVE" = "false" ]; then
+  exit 0
+fi
+
+# Read the actual file content
+if [ ! -f "$RAID_FILE_PATH" ]; then
+  exit 0
+fi
+
+issues=""
+
+while IFS= read -r line; do
+  # Skip empty lines
+  [ -z "$line" ] && continue
+
+  # Skip header lines (lines starting with #)
+  case "$line" in
+    \#*) continue ;;
+  esac
+
+  # Layer 1: Format check — must have a recognized prefix
+  has_prefix=false
+  entry_type=""
+  content_after_prefix=""
+
+  case "$line" in
+    "DUNGEON:"*|"📌 DUNGEON:"*)
+      has_prefix=true
+      entry_type="DUNGEON"
+      content_after_prefix="${line#*DUNGEON:}"
+      ;;
+    "UNRESOLVED:"*|"⚠️ UNRESOLVED:"*)
+      has_prefix=true
+      entry_type="UNRESOLVED"
+      ;;
+    "RESOLVED:"*|"✅ RESOLVED:"*)
+      has_prefix=true
+      entry_type="RESOLVED"
+      ;;
+    "TASK:"*|"📋 TASK:"*)
+      has_prefix=true
+      entry_type="TASK"
+      ;;
+  esac
+
+  if [ "$has_prefix" = "false" ]; then
+    issues="${issues}
+  - Unrecognized prefix on line: ${line:0:60}"
+    continue
+  fi
+
+  # Layer 2: Evidence check — only for pinned entries
+  if [ "$entry_type" = "DUNGEON" ]; then
+    # Strip leading whitespace from content after prefix
+    content_after_prefix="$(echo "$content_after_prefix" | sed 's/^[[:space:]]*//')"
+    content_len=${#content_after_prefix}
+    if [ "$content_len" -lt 50 ]; then
+      issues="${issues}
+  - Pinned entry too short. Include evidence."
+    fi
+
+    # Check that pinned entries reference at least two agents (survived challenge)
+    agent_count=0
+    echo "$content_after_prefix" | grep -qi "warrior" && agent_count=$((agent_count + 1))
+    echo "$content_after_prefix" | grep -qi "archer" && agent_count=$((agent_count + 1))
+    echo "$content_after_prefix" | grep -qi "rogue" && agent_count=$((agent_count + 1))
+    echo "$content_after_prefix" | grep -qi "wizard" && agent_count=$((agent_count + 1))
+    if [ "$agent_count" -lt 2 ]; then
+      issues="${issues}
+  - Pinned entry must reference at least 2 agents who verified it (e.g., 'verified by @Warrior and @Archer')."
+    fi
+  fi
+
+  # Layer 3: Phase consistency
+  if [ "$entry_type" = "TASK" ]; then
+    case "${RAID_PHASE:-}" in
+      design|implementation|review)
+        issues="${issues}
+  - TASK entries belong in Plan phase, not ${RAID_PHASE}."
+        ;;
+    esac
+  fi
+
+done < "$RAID_FILE_PATH"
+
+# Report all issues together
+if [ -n "$issues" ]; then
+  raid_block "Dungeon validation failed:${issues}"
+fi
+
+exit 0

package/template/.claude/hooks/validate-file-naming.sh

@@ -1,26 +1,20 @@
 #!/usr/bin/env bash
 # Raid quality gate: validates file naming conventions
 # PostToolUse hook for Write and Edit operations
-# Reads conventions from .claude/raid.json
+# Sources raid-lib.sh for config and input parsing
 set -euo pipefail
 
-INPUT=$(cat)
-FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // .tool_input.path // empty')
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/raid-lib.sh"
 
-if [ -z "$FILE_PATH" ]; then
+raid_read_input
+
+if [ -z "$RAID_FILE_PATH" ]; then
   exit 0
 fi
 
-RAID_CONFIG=".claude/raid.json"
 ISSUES=""
-
-# Read naming convention from config (default: none)
-NAMING="none"
-if [ -f "$RAID_CONFIG" ]; then
-  NAMING=$(jq -r '.conventions.fileNaming // "none"' "$RAID_CONFIG")
-fi
-
-BASENAME=$(basename "$FILE_PATH")
+BASENAME=$(basename "$RAID_FILE_PATH")
 
 # Check 1: No spaces in filenames (always enforced)
 if echo "$BASENAME" | grep -qE '[[:space:]]'; then
@@ -28,11 +22,11 @@ if echo "$BASENAME" | grep -qE '[[:space:]]'; then
 fi
 
 # Check 2: Naming convention (if configured)
-if [ "$NAMING" != "none" ]; then
+if [ "$RAID_NAMING" != "none" ]; then
   # Strip extension for naming check
   NAME_PART=$(echo "$BASENAME" | sed 's/\.[^.]*$//')
 
-  case "$NAMING" in
+  case "$RAID_NAMING" in
     kebab-case)
       if ! echo "$NAME_PART" | grep -qE '^[a-z0-9]+(-[a-z0-9]+)*$'; then
         ISSUES="${ISSUES}NAMING: File '$BASENAME' does not follow kebab-case convention.\n"
@@ -51,18 +45,10 @@ if [ "$NAMING" != "none" ]; then
   esac
 fi
 
-# Check 3: Directory depth (default max 8)
-MAX_DEPTH=8
-if [ -f "$RAID_CONFIG" ]; then
-  CONFIGURED_DEPTH=$(jq -r '.conventions.maxDepth // empty' "$RAID_CONFIG")
-  if [ -n "$CONFIGURED_DEPTH" ]; then
-    MAX_DEPTH="$CONFIGURED_DEPTH"
-  fi
-fi
-
-DEPTH=$(echo "$FILE_PATH" | awk -F'/' '{print NF}')
-if [ "$DEPTH" -gt "$MAX_DEPTH" ]; then
-  ISSUES="${ISSUES}STRUCTURE: File at depth $DEPTH ($FILE_PATH). Maximum is $MAX_DEPTH.\n"
+# Check 3: Directory depth
+DEPTH=$(echo "$RAID_FILE_PATH" | awk -F'/' '{print NF}')
+if [ "$DEPTH" -gt "$RAID_MAX_DEPTH" ]; then
+  ISSUES="${ISSUES}STRUCTURE: File at depth $DEPTH ($RAID_FILE_PATH). Maximum is $RAID_MAX_DEPTH.\n"
 fi
 
 if [ -n "$ISSUES" ]; then

package/template/.claude/hooks/validate-no-placeholders.sh

@@ -1,32 +1,22 @@
 #!/usr/bin/env bash
 # Raid quality gate: blocks placeholder text in specs and plans
 # PostToolUse hook for Write and Edit operations
-# Only checks files within configured specs/plans paths
+# Sources raid-lib.sh for config and input parsing
 set -euo pipefail
 
-INPUT=$(cat)
-FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // .tool_input.path // empty')
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/raid-lib.sh"
 
-if [ -z "$FILE_PATH" ]; then
-  exit 0
-fi
+raid_read_input
 
-RAID_CONFIG=".claude/raid.json"
-
-# Read paths from config (defaults)
-SPECS_PATH="docs/raid/specs"
-PLANS_PATH="docs/raid/plans"
-if [ -f "$RAID_CONFIG" ]; then
-  CONFIGURED_SPECS=$(jq -r '.paths.specs // empty' "$RAID_CONFIG")
-  CONFIGURED_PLANS=$(jq -r '.paths.plans // empty' "$RAID_CONFIG")
-  [ -n "$CONFIGURED_SPECS" ] && SPECS_PATH="$CONFIGURED_SPECS"
-  [ -n "$CONFIGURED_PLANS" ] && PLANS_PATH="$CONFIGURED_PLANS"
+if [ -z "$RAID_FILE_PATH" ]; then
+  exit 0
 fi
 
 # Only check files in specs or plans directories
 IS_RAID_DOC=false
-case "$FILE_PATH" in
-  "$SPECS_PATH"/*|"$PLANS_PATH"/*) IS_RAID_DOC=true ;;
+case "$RAID_FILE_PATH" in
+  "$RAID_SPECS_PATH"/*|"$RAID_PLANS_PATH"/*) IS_RAID_DOC=true ;;
 esac
 
 if [ "$IS_RAID_DOC" = false ]; then
@@ -35,8 +25,8 @@ fi
 
 # Read the actual file content (tool_output is the tool's response message, not file content)
 CONTENT=""
-if [ -f "$FILE_PATH" ]; then
-  CONTENT=$(cat "$FILE_PATH")
+if [ -f "$RAID_FILE_PATH" ]; then
+  CONTENT=$(cat "$RAID_FILE_PATH")
 fi
 
 if [ -z "$CONTENT" ]; then
@@ -60,7 +50,7 @@ while IFS= read -r line; do
 done <<< "$CONTENT"
 
 if [ -n "$ISSUES" ]; then
-  printf "Raid Placeholder Check:\nBLOCKED: Placeholders found in %s:\n%b\nRemove all placeholders before proceeding.\n" "$FILE_PATH" "$ISSUES" >&2
+  printf "Raid Placeholder Check:\nBLOCKED: Placeholders found in %s:\n%b\nRemove all placeholders before proceeding.\n" "$RAID_FILE_PATH" "$ISSUES" >&2
   exit 2
 fi