@dtt_siye/atool 1.1.0

package/install.sh

@@ -0,0 +1,603 @@
+#!/usr/bin/env bash
+# aTool - AI Developer Toolkit
+# Main entry point - one command to configure all AI IDEs
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ATOOL_ROOT="$SCRIPT_DIR"
+
+# Load common library
+# shellcheck source=lib/common.sh
+source "$ATOOL_ROOT/lib/common.sh"
+
+# ── Defaults ────────────────────────────────────────────────────────────────
+ATOOL_YES="${ATOOL_YES:-0}"
+ATOOL_DRY_RUN="${ATOOL_DRY_RUN:-0}"
+ATOOL_FORCE="${ATOOL_FORCE:-0}"
+INSTALL_TARGETS=()
+PROJECT_PATH=""
+ANALYZE_PROJECT=""
+
+# ── Usage ───────────────────────────────────────────────────────────────────
+usage() {
+    cat <<EOF
+${BOLD}aTool${NC} - AI Developer Toolkit v${ATOOL_VERSION}
+
+${BOLD}Usage:${NC}
+  ./install.sh [OPTIONS]
+
+${BOLD}Options:${NC}
+  --all              Install to all detected IDEs (default)
+  --claude           Install to Claude Code CLI only
+  --cursor           Install to Cursor only
+  --kiro             Install to Kiro only
+  --project PATH     Initialize a project (detect stack + generate templates)
+  --analyze PATH     Prepare a project for deep analysis (project-analyze skill)
+  --uninstall        Remove all aTool configurations
+  --dry-run          Preview mode - no changes made
+  --force            Overwrite existing configs (default: merge + backup)
+  --update           Update aTool to latest version
+  --check-updates    Check for skill updates without installing
+  --yes              Skip confirmation prompts
+  --version          Show version
+  --help             Show this help
+
+${BOLD}Examples:${NC}
+  ./install.sh                        # Install to all detected IDEs
+  ./install.sh --claude --yes         # Install to Claude Code, no prompts
+  ./install.sh --project ./my-app     # Initialize a project
+  ./install.sh --analyze ./my-app     # Prepare for deep analysis
+  ./install.sh --dry-run --all        # Preview what would be installed
+
+EOF
+}
+
+# ── Argument Parsing ────────────────────────────────────────────────────────
+parse_args() {
+    if [[ $# -eq 0 ]]; then
+        INSTALL_TARGETS=("all")
+    fi
+
+    while [[ $# -gt 0 ]]; do
+        case "$1" in
+            --all)
+                INSTALL_TARGETS=("all")
+                shift
+                ;;
+            --claude)
+                INSTALL_TARGETS+=("claude")
+                shift
+                ;;
+            --cursor)
+                INSTALL_TARGETS+=("cursor")
+                shift
+                ;;
+            --kiro)
+                INSTALL_TARGETS+=("kiro")
+                shift
+                ;;
+            --project)
+                PROJECT_PATH="$2"
+                shift 2
+                ;;
+            --analyze)
+                ANALYZE_PROJECT="$2"
+                shift 2
+                ;;
+            --uninstall)
+                do_uninstall
+                exit 0
+                ;;
+            --dry-run)
+                ATOOL_DRY_RUN=1
+                export ATOOL_DRY_RUN
+                shift
+                ;;
+            --force)
+                ATOOL_FORCE=1
+                export ATOOL_FORCE
+                shift
+                ;;
+            --update)
+                do_update
+                exit 0
+                ;;
+            --check-updates)
+                do_check_updates
+                exit 0
+                ;;
+            --yes)
+                ATOOL_YES=1
+                export ATOOL_YES
+                shift
+                ;;
+            --version|-v)
+                show_version
+                exit 0
+                ;;
+            --help|-h)
+                usage
+                exit 0
+                ;;
+            *)
+                log_error "Unknown option: $1"
+                usage
+                exit 1
+                ;;
+        esac
+    done
+}
+
+# ── Uninstall ──────────────────────────────────────────────────────────────
+
+# Helper: Remove aTool MCP entries from an IDE config file (with backup)
+# Args: CONFIG_FILE
+_remove_mcp_entries() {
+    local config_file="$1"
+    if [[ ! -f "$config_file" ]]; then
+        return 0
+    fi
+
+    local mcp_names
+    mcp_names=$(jq -r '(.mcpServers // {}) | keys[]' "$config_file" 2>/dev/null || echo "")
+    if [[ -z "$mcp_names" ]]; then
+        return 0
+    fi
+
+    # Read aTool recommended MCP names
+    local recommended="$ATOOL_ROOT/mcp/recommended.json"
+    if [[ ! -f "$recommended" ]]; then
+        return 0
+    fi
+    local atool_mcps
+    atool_mcps=$(jq -r '.mcpServers | keys[]' "$recommended" 2>/dev/null || echo "")
+
+    local removed=0
+    local cleaned
+    cleaned=$(cat "$config_file")
+
+    for mcp_name in $atool_mcps; do
+        # Check if this MCP exists in the config
+        if echo "$mcp_names" | grep -qx "$mcp_name"; then
+            cleaned=$(echo "$cleaned" | jq "del(.mcpServers.\"$mcp_name\")")
+            removed=$((removed + 1))
+        fi
+    done
+
+    if [[ "$removed" -gt 0 ]]; then
+        backup_file "$config_file"
+        echo "$cleaned" | jq '.' > "$config_file"
+        log_info "Removed $removed aTool MCP entries from $config_file"
+    fi
+}
+
+do_uninstall() {
+    show_banner
+    log_step "Uninstalling aTool..."
+
+    if ! confirm "Remove all aTool configurations?" "N"; then
+        log_info "Uninstall cancelled."
+        exit 0
+    fi
+
+    local claude_config_dir
+    claude_config_dir=$(get_claude_config_dir)
+
+    # ── 1. Skills (dynamic discovery via .atool-skill-version markers) ──
+    local claude_skills_dir="$claude_config_dir/skills"
+    local skills_removed=0
+    if [[ -d "$claude_skills_dir" ]]; then
+        while IFS= read -r -d '' marker; do
+            local skill_dir
+            skill_dir=$(dirname "$marker")
+            local skill_name
+            skill_name=$(basename "$skill_dir")
+            run_cmd rm -rf "$skill_dir"
+            log_info "Removed skill: $skill_name"
+            skills_removed=$((skills_removed + 1))
+        done < <(find "$claude_skills_dir" -maxdepth 2 -name ".atool-skill-version" -print0 2>/dev/null)
+    fi
+    # Backward compatibility: clean up old skills without markers
+    local legacy_skills=("mobile-conventions")
+    for legacy in "${legacy_skills[@]}"; do
+        if [[ -d "$claude_skills_dir/$legacy" ]]; then
+            run_cmd rm -rf "$claude_skills_dir/$legacy"
+            log_info "Removed legacy skill: $legacy"
+            skills_removed=$((skills_removed + 1))
+        fi
+    done
+    log_info "Skills removed: $skills_removed"
+
+    # ── 2. Claude hooks (scripts + settings.json entries) ──
+    local claude_hooks_dir="$claude_config_dir/hooks"
+    local hook_scripts=("atool-session-start" "atool-prompt-guard" "atool-doc-sync-reminder")
+    for hook_script in "${hook_scripts[@]}"; do
+        if [[ -f "$claude_hooks_dir/$hook_script" ]]; then
+            run_cmd rm "$claude_hooks_dir/$hook_script"
+            log_info "Removed hook: $claude_hooks_dir/$hook_script"
+        fi
+    done
+
+    # Remove ALL aTool hook entries from settings.json (SessionStart, UserPromptSubmit, PostToolUse)
+    local claude_settings="$claude_config_dir/settings.json"
+    if [[ -f "$claude_settings" ]]; then
+        local cleaned="$claude_settings"
+        local changed=false
+
+        # SessionStart
+        local has_ss
+        has_ss=$(jq -r '.hooks.SessionStart[]?.hooks[]?.command // empty' "$claude_settings" 2>/dev/null | grep -c "atool-session-start" || echo "0")
+        if [[ "$has_ss" -gt 0 ]]; then
+            cleaned=$(echo "$cleaned" | jq 'del(.hooks.SessionStart[]?.hooks[]? | select(.command | test("atool-session-start")))')
+            changed=true
+        fi
+
+        # UserPromptSubmit
+        local has_ups
+        has_ups=$(jq -r '.hooks.UserPromptSubmit[]?.hooks[]?.command // empty' "$claude_settings" 2>/dev/null | grep -c "atool-prompt-guard" || echo "0")
+        if [[ "$has_ups" -gt 0 ]]; then
+            cleaned=$(echo "$cleaned" | jq 'del(.hooks.UserPromptSubmit[]?.hooks[]? | select(.command | test("atool-prompt-guard")))')
+            changed=true
+        fi
+
+        # PostToolUse
+        local has_ptu
+        has_ptu=$(jq -r '.hooks.PostToolUse[]?.hooks[]?.command // empty' "$claude_settings" 2>/dev/null | grep -c "atool-doc-sync-reminder" || echo "0")
+        if [[ "$has_ptu" -gt 0 ]]; then
+            cleaned=$(echo "$cleaned" | jq 'del(.hooks.PostToolUse[]?.hooks[]? | select(.command | test("atool-doc-sync-reminder")))')
+            changed=true
+        fi
+
+        if [[ "$changed" == true ]]; then
+            backup_file "$claude_settings"
+            echo "$cleaned" | jq '.' > "$claude_settings"
+            log_info "Removed aTool hook entries from settings.json"
+        fi
+    fi
+
+    # ── 3. Claude MCP servers ──
+    _remove_mcp_entries "$claude_settings"
+
+    # ── 4. Claude lib files ──
+    local claude_lib_dir="$claude_config_dir/lib"
+    local lib_files=("common.sh" "detect-stack.sh")
+    for lib_file in "${lib_files[@]}"; do
+        if [[ -f "$claude_lib_dir/$lib_file" ]]; then
+            run_cmd rm "$claude_lib_dir/$lib_file"
+            log_info "Removed: $claude_lib_dir/$lib_file"
+        fi
+    done
+
+    # ── 5. Cursor ──
+    local cursor_config_dir
+    cursor_config_dir=$(get_cursor_config_dir)
+    if [[ -d "$cursor_config_dir/rules" ]]; then
+        run_cmd rm -f "$cursor_config_dir/rules/atool-"*.mdc 2>/dev/null || true
+        log_info "Removed Cursor atool-*.mdc rules"
+    fi
+    if [[ -d "$cursor_config_dir/rules/.atool-staging" ]]; then
+        run_cmd rm -rf "$cursor_config_dir/rules/.atool-staging"
+        log_info "Removed Cursor staging dir"
+    fi
+    local cursor_hooks_dir="$cursor_config_dir/hooks"
+    for hook_script in "${hook_scripts[@]}"; do
+        if [[ -f "$cursor_hooks_dir/$hook_script" ]]; then
+            run_cmd rm "$cursor_hooks_dir/$hook_script"
+            log_info "Removed Cursor hook: $hook_script"
+        fi
+    done
+    _remove_mcp_entries "$cursor_config_dir/mcp.json"
+
+    # ── 6. Kiro ──
+    local kiro_config_dir
+    kiro_config_dir=$(get_kiro_config_dir)
+    if [[ -d "$kiro_config_dir/steering" ]]; then
+        run_cmd rm -f "$kiro_config_dir/steering/atool-"*.md 2>/dev/null || true
+        log_info "Removed Kiro atool-*.md steering files"
+    fi
+    if [[ -d "$kiro_config_dir/steering/.atool-staging" ]]; then
+        run_cmd rm -rf "$kiro_config_dir/steering/.atool-staging"
+        log_info "Removed Kiro staging dir"
+    fi
+    _remove_mcp_entries "$kiro_config_dir/settings/mcp.json"
+
+    # ── 7. Cache ──
+    if [[ -d "$HOME/.atool/cache" ]]; then
+        run_cmd rm -rf "$HOME/.atool/cache"
+        log_info "Removed: ~/.atool/cache"
+    fi
+
+    log_success "aTool uninstalled successfully."
+    log_info "Note: Superpowers skills (if installed) are preserved."
+    log_info "Note: jq binary and PATH entry (if installed) are preserved."
+}
+
+# ── Update ──────────────────────────────────────────────────────────────────
+do_update() {
+    show_banner
+    log_step "Updating aTool..."
+
+    if [[ ! -d "$ATOOL_ROOT/.git" ]]; then
+        log_warn "Not a git repository. Download the latest release manually."
+        exit 1
+    fi
+
+    local old_version="${ATOOL_VERSION:-unknown}"
+
+    run_cmd git -C "$ATOOL_ROOT" pull --ff-only
+
+    # Update submodules
+    if [[ -f "$ATOOL_ROOT/.gitmodules" ]]; then
+        run_cmd git -C "$ATOOL_ROOT" submodule update --remote
+        log_info "Submodules updated"
+    fi
+
+    # Clear Superpowers cache to force re-download (fallback path)
+    if [[ -d "$HOME/.atool/cache/superpowers" ]]; then
+        run_cmd rm -rf "$HOME/.atool/cache/superpowers"
+        log_info "Superpowers cache cleared - will use submodule on next install"
+    fi
+
+    # Re-read version after pull
+    ATOOL_VERSION="$(cat "$ATOOL_ROOT/VERSION" 2>/dev/null || echo "unknown")"
+    export ATOOL_VERSION
+
+    # Re-run install to all detected IDEs (incremental — only changed components update)
+    log_step "Reapplying updates to all IDEs..."
+    echo ""
+
+    # Re-source ALL lib modules (may have changed in update)
+    # shellcheck source=lib/common.sh
+    source "$ATOOL_ROOT/lib/common.sh"
+    # shellcheck source=lib/install-skills.sh
+    source "$ATOOL_ROOT/lib/install-skills.sh"
+    # shellcheck source=lib/install-hooks.sh
+    source "$ATOOL_ROOT/lib/install-hooks.sh"
+    # shellcheck source=lib/install-mcp.sh
+    source "$ATOOL_ROOT/lib/install-mcp.sh"
+
+    local detected
+    detected=($(detect_ides))
+
+    if [[ ${#detected[@]} -eq 0 ]]; then
+        log_warn "No supported IDEs detected."
+        log_info "Run './install.sh --all' manually after installing an IDE."
+        return 0
+    fi
+
+    log_info "Detected IDEs: ${detected[*]}"
+    echo ""
+
+    for ide in "${detected[@]}"; do
+        install_to_ide "$ide"
+        echo ""
+    done
+
+    echo ""
+    log_success "Update complete: v${old_version} → v${ATOOL_VERSION}"
+    echo ""
+    log_info "Next steps:"
+    log_info "  1. Restart your IDE to load updated rules"
+    log_info "  2. Run './install.sh --project /path/to/project' to update project templates"
+}
+
+# ── Check Updates ──────────────────────────────────────────────────────────
+do_check_updates() {
+    show_banner
+    log_step "Checking for skill updates..."
+    echo ""
+
+    local atool_root="${ATOOL_ROOT:-$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)}"
+    local claude_skills="$HOME/.claude/skills"
+    local atool_skills="$atool_root/skills"
+    local update_count=0
+
+    # Check aTool skills
+    if [[ -d "$atool_skills" ]]; then
+        for skill_dir in "$atool_skills"/*/; do
+            [[ ! -d "$skill_dir" ]] && continue
+            local skill_name
+            skill_name=$(basename "$skill_dir")
+            [[ "$skill_name" == "_superpowers" ]] && continue
+            [[ -L "$skill_dir" ]] && continue
+
+            local skill_md="$skill_dir/SKILL.md"
+            [[ ! -f "$skill_md" ]] && continue
+
+            local target_skill="$claude_skills/$skill_name"
+            local source_ver installed_ver
+            source_ver=$(get_atool_skill_version "$skill_dir")
+            installed_ver=$(get_installed_skill_version "$target_skill")
+
+            if [[ "$installed_ver" == "none" ]]; then
+                log_info "  [NEW]     $skill_name ($source_ver)"
+                update_count=$((update_count + 1))
+            elif [[ "$installed_ver" != "$source_ver" ]]; then
+                log_info "  [UPDATE]  $skill_name ($installed_ver -> $source_ver)"
+                update_count=$((update_count + 1))
+            fi
+        done
+    fi
+
+    # Check Superpowers
+    local sp_submodule="$atool_root/skills/_superpowers"
+    local sp_installed="$claude_skills"
+    if [[ -d "$sp_submodule/skills" ]]; then
+        local sp_ver
+        sp_ver=$(get_superpowers_version "$sp_submodule")
+        local sp_installed_ver="none"
+        # Check if any superpowers skill is installed
+        for sp_skill_dir in "$sp_submodule/skills"/*/; do
+            [[ ! -d "$sp_skill_dir" ]] && continue
+            local sp_skill_name
+            sp_skill_name=$(basename "$sp_skill_dir")
+            local target_sp="$sp_installed/$sp_skill_name"
+            local target_ver
+            target_ver=$(get_installed_skill_version "$target_sp")
+            local src_ver
+            src_ver=$(get_superpowers_skill_version "$sp_skill_dir")
+            if [[ "$target_ver" == "none" ]]; then
+                log_info "  [NEW]     superpowers:$sp_skill_name"
+                update_count=$((update_count + 1))
+            elif [[ "$target_ver" != "$src_ver" ]]; then
+                log_info "  [UPDATE]  superpowers:$sp_skill_name"
+                update_count=$((update_count + 1))
+            fi
+        done
+    fi
+
+    echo ""
+    if [[ "$update_count" -eq 0 ]]; then
+        log_success "All skills are up to date!"
+    else
+        log_info "$update_count update(s) available. Run './install.sh --claude' to apply."
+    fi
+}
+
+# ── Project Init ────────────────────────────────────────────────────────────
+do_project_init() {
+    local project_path="$1"
+
+    if [[ ! -d "$project_path" ]]; then
+        log_error "Project path does not exist: $project_path"
+        exit 1
+    fi
+
+    # shellcheck source=lib/project-init.sh
+    source "$ATOOL_ROOT/lib/project-init.sh"
+    project_init "$project_path"
+}
+
+# ── IDE Installation ────────────────────────────────────────────────────────
+
+# Source all install modules (they depend on common.sh which is already loaded)
+# shellcheck source=lib/install-skills.sh
+source "$ATOOL_ROOT/lib/install-skills.sh"
+# shellcheck source=lib/install-hooks.sh
+source "$ATOOL_ROOT/lib/install-hooks.sh"
+# shellcheck source=lib/install-mcp.sh
+source "$ATOOL_ROOT/lib/install-mcp.sh"
+
+install_to_ide() {
+    local ide="$1"
+
+    case "$ide" in
+        claude)
+            # shellcheck source=lib/install-claude.sh
+            source "$ATOOL_ROOT/lib/install-claude.sh"
+            install_claude
+            ;;
+        cursor)
+            # shellcheck source=lib/install-cursor.sh
+            source "$ATOOL_ROOT/lib/install-cursor.sh"
+            install_cursor
+            ;;
+        kiro)
+            # shellcheck source=lib/install-kiro.sh
+            source "$ATOOL_ROOT/lib/install-kiro.sh"
+            install_kiro
+            ;;
+        *)
+            log_error "Unknown IDE: $ide"
+            ;;
+    esac
+}
+
+# ── Analyze Init ──────────────────────────────────────────────────────────
+do_analyze_init() {
+    local project_path="$1"
+
+    if [[ ! -d "$project_path" ]]; then
+        log_error "Project path does not exist: $project_path"
+        exit 1
+    fi
+
+    local project_dir
+    project_dir="$(cd "$project_path" && pwd)"
+
+    log_step "Preparing project for deep analysis: $project_dir"
+
+    # Create .atool-docs directory structure
+    ensure_dir "$project_dir/.atool-docs/modules"
+
+    # Initialize analysis state if not exists
+    if [[ ! -f "$project_dir/.atool-docs/analysis-state.json" ]]; then
+        if ! is_dry_run; then
+            cat > "$project_dir/.atool-docs/analysis-state.json" <<STATE
+{
+  "version": "1.0",
+  "analyzed_at": null,
+  "stack": null,
+  "files": {}
+}
+STATE
+        fi
+        log_success "Created: .atool-docs/analysis-state.json"
+    else
+        log_info "Analysis state already exists — incremental analysis will be used"
+    fi
+
+    echo ""
+    log_success "Analysis directory ready: .atool-docs/"
+    log_info "Deep analysis will be performed by project-analyze skill in your IDE"
+    log_info "Trigger with: /project-analyze (Claude Code)"
+}
+
+# ── Main ────────────────────────────────────────────────────────────────────
+main() {
+    parse_args "$@"
+
+    show_banner
+
+    # Project mode
+    if [[ -n "$PROJECT_PATH" ]]; then
+        do_project_init "$PROJECT_PATH"
+        return 0
+    fi
+
+    # Analyze mode
+    if [[ -n "$ANALYZE_PROJECT" ]]; then
+        do_analyze_init "$ANALYZE_PROJECT"
+        return 0
+    fi
+
+    # Install mode
+    local targets=("${INSTALL_TARGETS[@]}")
+
+    # Default to "all" if no target specified
+    if [[ ${#targets[@]} -eq 0 ]]; then
+        targets=("all")
+    fi
+
+    if [[ " ${targets[*]} " == *" all "* ]]; then
+        # Detect and install to all available IDEs
+        local detected
+        detected=($(detect_ides))
+
+        if [[ ${#detected[@]} -eq 0 ]]; then
+            log_warn "No supported IDEs detected."
+            log_info "Supported: Claude Code CLI, Cursor, Kiro"
+            exit 1
+        fi
+
+        log_info "Detected IDEs: ${detected[*]}"
+        targets=("${detected[@]}")
+    fi
+
+    log_info "Installing to: ${targets[*]}"
+    echo ""
+
+    for ide in "${targets[@]}"; do
+        install_to_ide "$ide"
+        echo ""
+    done
+
+    log_success "Installation complete!"
+    echo ""
+    log_info "Next steps:"
+    log_info "  1. Restart your IDE"
+    log_info "  2. Run /atool-init in a new project to auto-configure"
+    log_info "  3. Check that MCP servers appear in your IDE's tool list"
+}
+
+main "$@"