claude-mods/scripts/install.sh

#!/usr/bin/env bash
#
# claude-mods Installer (Linux / macOS / Windows Git Bash)
# Copies commands, skills, agents, and rules to ~/.claude/
# Handles cleanup of deprecated items and command-to-skill migrations.
#
# Usage:
#   Linux/macOS:       ./scripts/install.sh
#   Windows Git Bash:  bash scripts/install.sh
#   Opt into the statusline: add --statusline

set -e

# --statusline is opt-in: off by default so a shared install never changes the
# user's prompt UI without being asked.
WANT_STATUSLINE=false
for arg in "$@"; do
    case "$arg" in
        --statusline) WANT_STATUSLINE=true ;;
    esac
done

BLUE='\033[0;34m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
RED='\033[0;31m'
NC='\033[0m'

echo -e "${BLUE}╔══════════════════════════════════════════════════════════════╗${NC}"
echo -e "${BLUE}║     claude-mods Installer (Linux / macOS / Git Bash)         ║${NC}"
echo -e "${BLUE}╚══════════════════════════════════════════════════════════════╝${NC}"
echo ""

SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
CLAUDE_DIR="${CLAUDE_DIR:-$HOME/.claude}"

# Detect Windows (Git Bash / MINGW / MSYS) — chmod is a no-op on NTFS
IS_WINDOWS=false
case "$(uname -s)" in
    MINGW*|MSYS*|CYGWIN*) IS_WINDOWS=true ;;
esac

# Wrapper: chmod is meaningful only on Unix
make_executable() {
    $IS_WINDOWS || chmod +x "$1"
}

# Ensure ~/.claude directories exist
for dir in commands skills agents rules output-styles hooks; do
    mkdir -p "$CLAUDE_DIR/$dir"
done

# =============================================================================
# DEPRECATED ITEMS - Remove these from user's config
# =============================================================================
echo -e "${YELLOW}Cleaning up deprecated items...${NC}"

deprecated_items=(
    # Removed commands (migrated to skills or deleted)
    "$CLAUDE_DIR/commands/review.md"      # Migrated to skill
    "$CLAUDE_DIR/commands/testgen.md"     # Migrated to skill
    "$CLAUDE_DIR/commands/conclave.md"    # Deprecated
    "$CLAUDE_DIR/commands/pulse.md"       # Now a skill only

    # Removed skills
    "$CLAUDE_DIR/skills/conclave"                # Deprecated
    "$CLAUDE_DIR/skills/claude-code-templates"   # Replaced by skill-creator
    "$CLAUDE_DIR/skills/agentmail"               # Renamed to pigeon (v2.3.0)
    "$CLAUDE_DIR/skills/claude-code-debug"       # Merged into claude-code-ops (v3.0)
    "$CLAUDE_DIR/skills/claude-code-headless"    # Merged into claude-code-ops (v3.0)
    "$CLAUDE_DIR/skills/claude-code-hooks"       # Merged into claude-code-ops (v3.0)
    "$CLAUDE_DIR/skills/dsp-launch"              # Superseded by fleet-worker + native background agents (2026-07)

    # Deprecated agents (v3.0): folded into their -ops skill twins
    "$CLAUDE_DIR/agents/python-expert.md"
    "$CLAUDE_DIR/agents/typescript-expert.md"
    "$CLAUDE_DIR/agents/javascript-expert.md"
    "$CLAUDE_DIR/agents/go-expert.md"
    "$CLAUDE_DIR/agents/rust-expert.md"
    "$CLAUDE_DIR/agents/react-expert.md"
    "$CLAUDE_DIR/agents/vue-expert.md"
    "$CLAUDE_DIR/agents/astro-expert.md"
    "$CLAUDE_DIR/agents/laravel-expert.md"
    "$CLAUDE_DIR/agents/sql-expert.md"
    "$CLAUDE_DIR/agents/postgres-expert.md"
    "$CLAUDE_DIR/agents/cypress-expert.md"       # -> skills/cypress-ops
    "$CLAUDE_DIR/agents/cloudflare-expert.md"    # -> skills/cloudflare-ops
    "$CLAUDE_DIR/agents/wrangler-expert.md"      # -> skills/cloudflare-ops
    "$CLAUDE_DIR/agents/bash-expert.md"          # -> skills/bash-ops
    "$CLAUDE_DIR/agents/claude-architect.md"     # -> skills/claude-code-ops
    "$CLAUDE_DIR/agents/aws-fargate-ecs-expert.md" # -> skills/container-orchestration
    "$CLAUDE_DIR/agents/craftcms-expert.md"      # -> skills/craftcms-ops
    "$CLAUDE_DIR/agents/payloadcms-expert.md"    # -> skills/payloadcms-ops
    "$CLAUDE_DIR/agents/asus-router-expert.md"   # -> skills/asus-router-ops
)

# Renamed skills: -patterns -> -ops (March 2026)
renamed_skills=(
    cli-patterns
    mcp-patterns
    python-async-patterns
    python-cli-patterns
    python-database-patterns
    python-fastapi-patterns
    python-observability-patterns
    python-pytest-patterns
    python-typing-patterns
    rest-patterns
    security-patterns
    sql-patterns
    tailwind-patterns
    testing-patterns
)

for old_skill in "${renamed_skills[@]}"; do
    old_path="$CLAUDE_DIR/skills/$old_skill"
    if [ -d "$old_path" ]; then
        rm -rf "$old_path"
        echo -e "  ${RED}Removed renamed: $old_skill (now ${old_skill%-patterns}-ops)${NC}"
    fi
done

for item in "${deprecated_items[@]}"; do
    if [ -e "$item" ]; then
        rm -rf "$item"
        echo -e "  ${RED}Removed: $item${NC}"
    fi
done
echo ""

# =============================================================================
# COMMANDS - Only copy commands that haven't been migrated to skills
# =============================================================================
echo -e "${BLUE}Installing commands...${NC}"

# Commands that should NOT be copied (migrated to skills)
skip_commands=("review.md" "testgen.md")

for file in "$PROJECT_ROOT/commands"/*.md; do
    [ -f "$file" ] || continue
    filename=$(basename "$file")

    # Skip migrated commands
    skip=false
    for skip_cmd in "${skip_commands[@]}"; do
        if [ "$filename" = "$skip_cmd" ]; then
            skip=true
            break
        fi
    done

    # Skip archive directory contents
    [[ "$file" == *"/archive/"* ]] && continue

    if [ "$skip" = false ]; then
        cp "$file" "$CLAUDE_DIR/commands/"
        echo -e "  ${GREEN}$filename${NC}"
    fi
done
echo ""

# =============================================================================
# SKILLS - Copy all skill directories
# =============================================================================
echo -e "${BLUE}Installing skills...${NC}"

for skill_dir in "$PROJECT_ROOT/skills"/*/; do
    [ -d "$skill_dir" ] || continue
    skill_name=$(basename "$skill_dir")

    # _lib is the shared terminal library (skills/_lib/term.sh) that many skill
    # scripts source. It is NOT a skill, but it MUST be refreshed — scripts that
    # use newer term.sh features (TERM_DOT, brand glyphs, term_pip_bar) break with
    # an "unbound variable" under `set -u` against a stale copy.
    if [ "$skill_name" = "_lib" ]; then
        rm -rf "$CLAUDE_DIR/skills/_lib"
        cp -r "${skill_dir%/}" "$CLAUDE_DIR/skills/"
        echo -e "  ${GREEN}_lib/${NC} (shared term library)"
        continue
    fi

    # Remove existing and copy fresh. Strip trailing slash from $skill_dir
    # so cp creates a subdirectory rather than merging contents (the *.*/* glob
    # always returns paths with trailing slashes, which makes cp behave as if
    # asked to copy contents — that's a long-standing bug we just fixed).
    rm -rf "$CLAUDE_DIR/skills/$skill_name"
    cp -r "${skill_dir%/}" "$CLAUDE_DIR/skills/"
    echo -e "  ${GREEN}$skill_name/${NC}"
done
echo ""

# =============================================================================
# AGENTS - Copy all agent files
# =============================================================================
echo -e "${BLUE}Installing agents...${NC}"

for file in "$PROJECT_ROOT/agents"/*.md; do
    [ -f "$file" ] || continue
    cp "$file" "$CLAUDE_DIR/agents/"
    echo -e "  ${GREEN}$(basename "$file")${NC}"
done
echo ""

# =============================================================================
# RULES - Copy all rule files
# =============================================================================
echo -e "${BLUE}Installing rules...${NC}"

for file in "$PROJECT_ROOT/rules"/*.md; do
    [ -f "$file" ] || continue
    cp "$file" "$CLAUDE_DIR/rules/"
    echo -e "  ${GREEN}$(basename "$file")${NC}"
done
echo ""

# =============================================================================
# OUTPUT STYLES - Copy all output style files
# =============================================================================
echo -e "${BLUE}Installing output styles...${NC}"

if [ -d "$PROJECT_ROOT/output-styles" ]; then
    for file in "$PROJECT_ROOT/output-styles"/*.md; do
        [ -f "$file" ] || continue
        cp "$file" "$CLAUDE_DIR/output-styles/"
        echo -e "  ${GREEN}$(basename "$file")${NC}"
    done
fi
echo ""

# =============================================================================
# HOOKS - Copy scripts and merge plugin-equivalent wiring into settings.json
# =============================================================================
echo -e "${BLUE}Installing hooks...${NC}"

for file in "$PROJECT_ROOT/hooks"/*.sh; do
    [ -f "$file" ] || continue
    cp "$file" "$CLAUDE_DIR/hooks/"
    make_executable "$CLAUDE_DIR/hooks/$(basename "$file")"
done

# Capability probe, not existence probe: walk/1 needs jq >= 1.6, and a 1.5 jq
# passes `command -v` then crashes mid-install under set -e, leaving hooks
# copied but settings.json unwired (adversarial-review finding, 2026-07).
if echo '{}' | jq -e 'walk(.) | true' >/dev/null 2>&1; then
    settings_path="$CLAUDE_DIR/settings.json"
    [ -f "$settings_path" ] || printf '{}\n' > "$settings_path"
    tmp_settings="$(mktemp)"
    jq --arg hook_dir "$CLAUDE_DIR/hooks" --slurpfile desired "$PROJECT_ROOT/hooks/hooks.json" '
      # Dedup on the script NAME under hooks/, not the resolved path: a hook
      # wired by a plugin install carries the ${CLAUDE_PLUGIN_ROOT}/hooks/
      # form and must still count as already-wired (mixed-method double-fire).
      def script_name:
        .command | sub("^.*hooks[/\\\\]"; "") | sub("\\\"$"; "");
      ($desired[0]
        | walk(if type == "string" then gsub("\\$\\{CLAUDE_PLUGIN_ROOT\\}/hooks"; $hook_dir) else . end)
      ) as $wanted
      | .hooks = (.hooks // {})
      | reduce ($wanted.hooks | to_entries[]) as $event (.;
          reduce $event.value[] as $group (.;
            ([.hooks[$event.key][]?.hooks[]?.command // ""]) as $existing
            |
            ($group.hooks | map(
              . as $hook
              | ($hook | script_name) as $name
              | select(any($existing[]; contains("hooks/" + $name) or contains("hooks\\" + $name)) | not)
            )) as $missing
            | if ($missing | length) > 0 then
                .hooks[$event.key] = ((.hooks[$event.key] // []) + [($group | .hooks = $missing)])
              else . end
          )
        )
    ' "$settings_path" > "$tmp_settings"
    mv "$tmp_settings" "$settings_path"
    echo -e "  ${GREEN}Security and peer-guard hooks wired in settings.json${NC}"
else
    echo -e "  ${YELLOW}jq with walk/1 (>=1.6) not available, skipping hook wiring (plugin installs unaffected)${NC}"
fi

# STATUSLINE - opt-in only (--statusline). Even when opted in we add it ONLY if
# the user has none: a statusline is a whole-config key, so we never clobber one
# the user already set, and we touch nothing else.
statusline_tpl="$PROJECT_ROOT/templates/settings.json"
if ! $WANT_STATUSLINE; then
    echo -e "  ${YELLOW}Statusline skipped (re-run with --statusline to install it)${NC}"
elif command -v jq >/dev/null 2>&1 && [ -f "$statusline_tpl" ]; then
    settings_path="$CLAUDE_DIR/settings.json"
    [ -f "$settings_path" ] || printf '{}\n' > "$settings_path"
    if [ "$(jq 'has("statusLine")' "$settings_path" 2>/dev/null)" = "true" ]; then
        echo -e "  ${GREEN}Existing statusline preserved (remove it first to use the claude-mods one)${NC}"
    else
        tmp_settings="$(mktemp)"
        if jq --slurpfile tpl "$statusline_tpl" '.statusLine = $tpl[0].statusLine' "$settings_path" > "$tmp_settings"; then
            mv "$tmp_settings" "$settings_path"
            echo -e "  ${GREEN}Context-usage statusline added to settings.json${NC}"
        else
            rm -f "$tmp_settings"
        fi
    fi
fi
echo ""

# =============================================================================
# PIGEON - Global install (scripts + hook config hint)
# =============================================================================
echo -e "${BLUE}Installing pigeon (pmail)...${NC}"

# Clean up old agentmail install if present
if [ -d "$CLAUDE_DIR/agentmail" ]; then
    rm -rf "$CLAUDE_DIR/agentmail"
    echo -e "  ${RED}Removed old agentmail/ (renamed to pigeon/)${NC}"
fi

mkdir -p "$CLAUDE_DIR/pigeon"
if [ -f "$PROJECT_ROOT/skills/pigeon/scripts/mail-db.sh" ]; then
    cp "$PROJECT_ROOT/skills/pigeon/scripts/mail-db.sh" "$CLAUDE_DIR/pigeon/"
    make_executable "$CLAUDE_DIR/pigeon/mail-db.sh"
    echo -e "  ${GREEN}mail-db.sh${NC}"
fi
if [ -f "$PROJECT_ROOT/hooks/check-mail.sh" ]; then
    cp "$PROJECT_ROOT/hooks/check-mail.sh" "$CLAUDE_DIR/pigeon/"
    make_executable "$CLAUDE_DIR/pigeon/check-mail.sh"
    echo -e "  ${GREEN}check-mail.sh${NC}"
fi

# Migrate stale agentmail hook path → pigeon
if grep -q "agentmail/check-mail.sh" "$CLAUDE_DIR/settings.json" 2>/dev/null; then
    sed -i 's|agentmail/check-mail\.sh|pigeon/check-mail.sh|g' "$CLAUDE_DIR/settings.json"
    echo -e "  ${GREEN}Migrated agentmail hook → pigeon in settings.json${NC}"
fi

# Check if hook is already configured (pigeon path)
if grep -q "pigeon/check-mail.sh" "$CLAUDE_DIR/settings.json" 2>/dev/null; then
    echo -e "  ${GREEN}Hook already configured in settings.json${NC}"
else
    echo ""
    echo -e "  ${YELLOW}To enable automatic pmail notifications, add this to ~/.claude/settings.json:${NC}"
    echo ""
    echo '  "hooks": {'
    echo '    "PreToolUse": [{'
    echo '      "matcher": "*",'
    echo '      "hooks": [{'
    echo '        "type": "command",'
    echo '        "command": "bash \"$HOME/.claude/pigeon/check-mail.sh\"",'
    echo '        "timeout": 5'
    echo '      }]'
    echo '    }]'
    echo '  }'
    echo ""
    echo -e "  ${YELLOW}Without this, pigeon works but you must check manually (pigeon read).${NC}"
fi
echo ""

# =============================================================================
# AUTO-SKILL - Global install (tracking + evaluation hooks)
# =============================================================================
echo -e "${BLUE}Installing auto-skill...${NC}"

mkdir -p "$CLAUDE_DIR/auto-skill"
for script in track-tools.sh evaluate.sh; do
    if [ -f "$PROJECT_ROOT/skills/auto-skill/scripts/$script" ]; then
        cp "$PROJECT_ROOT/skills/auto-skill/scripts/$script" "$CLAUDE_DIR/auto-skill/"
        make_executable "$CLAUDE_DIR/auto-skill/$script"
        echo -e "  ${GREEN}$script${NC}"
    fi
done

# Check if hooks are already configured
if grep -q "auto-skill" "$CLAUDE_DIR/settings.json" 2>/dev/null; then
    echo -e "  ${GREEN}Hooks already configured in settings.json${NC}"
else
    echo ""
    echo -e "  ${YELLOW}To enable automatic skill suggestions, add these hooks to ~/.claude/settings.json:${NC}"
    echo ""
    echo '  "PostToolUse": [{ "matcher": "*", "hooks": [{'
    echo '    "type": "command",'
    echo '    "command": "bash \"$HOME/.claude/auto-skill/track-tools.sh\"", "timeout": 2'
    echo '  }] }],'
    echo '  "Stop": [{ "hooks": [{'
    echo '    "type": "command",'
    echo '    "command": "bash \"$HOME/.claude/auto-skill/evaluate.sh\"", "timeout": 5'
    echo '  }] }]'
    echo ""
    echo -e "  ${YELLOW}Without this, /auto-skill still works but won't suggest automatically.${NC}"
fi
echo ""

# =============================================================================
# SUMMARY
# =============================================================================
echo -e "${BLUE}════════════════════════════════════════════════════════════════${NC}"
echo -e "  ${GREEN}Installation complete!${NC}"
echo -e "${BLUE}════════════════════════════════════════════════════════════════${NC}"
echo ""
echo -e "${YELLOW}Restart Claude Code to load the new extensions.${NC}"
echo ""