@codihaus/claude-skills 1.0.0

package/skills/dev-scout/scripts/scout-analyze.sh

@@ -0,0 +1,280 @@
+#!/bin/bash
+#
+# scout-analyze.sh - Codebase analysis with optional tool installation
+# Usage: ./scout-analyze.sh [path] [--install] [--json]
+#
+# Options:
+#   --install   Auto-install missing tools (requires sudo)
+#   --json      Output as JSON for parsing
+#   --check     Only check tools, don't analyze
+
+TARGET_PATH="${1:-.}"
+INSTALL_MODE=false
+JSON_MODE=false
+CHECK_ONLY=false
+
+# Parse flags
+for arg in "$@"; do
+    case $arg in
+        --install) INSTALL_MODE=true ;;
+        --json) JSON_MODE=true ;;
+        --check) CHECK_ONLY=true ;;
+    esac
+done
+
+# Colors (disabled in JSON mode)
+if [ "$JSON_MODE" = false ]; then
+    RED='\033[0;31m'
+    GREEN='\033[0;32m'
+    YELLOW='\033[1;33m'
+    BLUE='\033[0;34m'
+    NC='\033[0m'
+else
+    RED='' GREEN='' YELLOW='' BLUE='' NC=''
+fi
+
+# Tool definitions: name|check_cmd|install_cmd|fallback
+TOOLS=(
+    "tree|tree --version|sudo apt-get install -y tree|find . -type d"
+    "scc|scc --version|go install github.com/boyter/scc/v3@latest|wc -l"
+    "jq|jq --version|sudo apt-get install -y jq|cat"
+    "rg|rg --version|sudo apt-get install -y ripgrep|grep -r"
+)
+
+declare -A TOOL_STATUS
+declare -A TOOL_FALLBACK
+
+# Check which tools are available
+check_tools() {
+    echo -e "${BLUE}Checking available tools...${NC}"
+
+    local missing=0
+    for tool_def in "${TOOLS[@]}"; do
+        IFS='|' read -r name check_cmd install_cmd fallback <<< "$tool_def"
+
+        if command -v "$name" &> /dev/null; then
+            TOOL_STATUS[$name]="installed"
+            echo -e "  ${GREEN}✓${NC} $name"
+        else
+            TOOL_STATUS[$name]="missing"
+            TOOL_FALLBACK[$name]="$fallback"
+            echo -e "  ${RED}✗${NC} $name (fallback: $fallback)"
+            ((missing++))
+        fi
+    done
+
+    # Check git
+    if command -v git &> /dev/null && [ -d "$TARGET_PATH/.git" ]; then
+        TOOL_STATUS["git"]="installed"
+        echo -e "  ${GREEN}✓${NC} git (repo detected)"
+    else
+        TOOL_STATUS["git"]="unavailable"
+        echo -e "  ${YELLOW}○${NC} git (not a repo or not installed)"
+    fi
+
+    echo ""
+    # Don't return missing count as exit code
+    return 0
+}
+
+# Offer to install missing tools
+offer_install() {
+    local missing_tools=()
+
+    for tool_def in "${TOOLS[@]}"; do
+        IFS='|' read -r name check_cmd install_cmd fallback <<< "$tool_def"
+        if [ "${TOOL_STATUS[$name]}" = "missing" ]; then
+            missing_tools+=("$name")
+        fi
+    done
+
+    if [ ${#missing_tools[@]} -eq 0 ]; then
+        return 0
+    fi
+
+    echo -e "${YELLOW}Missing tools: ${missing_tools[*]}${NC}"
+    echo ""
+    echo "These tools provide better/faster analysis:"
+    echo "  - tree: Visual directory structure"
+    echo "  - scc: Fast code statistics (lines, languages, complexity)"
+    echo "  - jq: Parse package.json, tsconfig.json"
+    echo "  - rg: Faster search with context"
+    echo ""
+
+    if [ "$INSTALL_MODE" = true ]; then
+        echo "Installing missing tools..."
+        install_tools
+    else
+        echo "Run with --install to install, or continue with fallbacks."
+        echo "Example: ./scout-analyze.sh . --install"
+    fi
+}
+
+# Install missing tools
+install_tools() {
+    for tool_def in "${TOOLS[@]}"; do
+        IFS='|' read -r name check_cmd install_cmd fallback <<< "$tool_def"
+
+        if [ "${TOOL_STATUS[$name]}" = "missing" ]; then
+            echo -e "Installing $name..."
+            if eval "$install_cmd" 2>/dev/null; then
+                TOOL_STATUS[$name]="installed"
+                echo -e "  ${GREEN}✓${NC} $name installed"
+            else
+                echo -e "  ${RED}✗${NC} Failed to install $name, using fallback"
+            fi
+        fi
+    done
+}
+
+# Run analysis
+run_analysis() {
+    cd "$TARGET_PATH"
+
+    echo -e "${BLUE}═══════════════════════════════════════${NC}"
+    echo -e "${BLUE}  Codebase Analysis: $(basename $(pwd))${NC}"
+    echo -e "${BLUE}═══════════════════════════════════════${NC}"
+    echo ""
+
+    # 1. Basic stats
+    echo -e "${GREEN}## File Overview${NC}"
+    total_files=$(find . -type f ! -path './node_modules/*' ! -path './.git/*' ! -path './dist/*' ! -path './build/*' ! -path './.next/*' | wc -l)
+    total_dirs=$(find . -type d ! -path './node_modules/*' ! -path './.git/*' ! -path './dist/*' ! -path './build/*' ! -path './.next/*' | wc -l)
+    echo "Total files: $total_files"
+    echo "Total directories: $total_dirs"
+    echo ""
+
+    # 2. Directory structure
+    echo -e "${GREEN}## Directory Structure${NC}"
+    if [ "${TOOL_STATUS[tree]}" = "installed" ]; then
+        tree -L 2 -d --noreport -I 'node_modules|.git|dist|build|.next|__pycache__|venv' 2>/dev/null || echo "(tree failed)"
+    else
+        echo "(tree not installed, using find)"
+        find . -maxdepth 2 -type d ! -path './node_modules/*' ! -path './.git/*' ! -path './dist/*' | head -30
+    fi
+    echo ""
+
+    # 3. Code statistics
+    echo -e "${GREEN}## Code Statistics${NC}"
+    if [ "${TOOL_STATUS[scc]}" = "installed" ]; then
+        scc --no-cocomo --no-complexity -s lines . 2>/dev/null | head -30 || echo "(scc failed)"
+    else
+        echo "(scc not installed, basic count)"
+        echo "Lines by extension:"
+        find . -type f ! -path './node_modules/*' ! -path './.git/*' -name '*.ts' -o -name '*.tsx' -o -name '*.js' -o -name '*.jsx' -o -name '*.vue' -o -name '*.py' 2>/dev/null | head -100 | xargs wc -l 2>/dev/null | tail -1 || echo "0 total"
+    fi
+    echo ""
+
+    # 4. File types
+    echo -e "${GREEN}## File Types${NC}"
+    echo "Top 10 extensions:"
+    find . -type f ! -path './node_modules/*' ! -path './.git/*' ! -path './dist/*' | sed 's/.*\.//' | sort | uniq -c | sort -rn | head -10
+    echo ""
+
+    # 5. Package info
+    echo -e "${GREEN}## Dependencies${NC}"
+    if [ -f "package.json" ]; then
+        echo "Node.js project detected"
+        if [ "${TOOL_STATUS[jq]}" = "installed" ]; then
+            echo "Dependencies: $(jq -r '.dependencies // {} | keys | length' package.json 2>/dev/null || echo "?")"
+            echo "Dev dependencies: $(jq -r '.devDependencies // {} | keys | length' package.json 2>/dev/null || echo "?")"
+            echo ""
+            echo "Key dependencies:"
+            jq -r '.dependencies // {} | keys[]' package.json 2>/dev/null | head -10
+        else
+            echo "(jq not installed, raw package.json)"
+            grep -E '"(dependencies|devDependencies)"' -A 5 package.json | head -15
+        fi
+    elif [ -f "requirements.txt" ]; then
+        echo "Python project detected"
+        echo "Dependencies: $(wc -l < requirements.txt)"
+        head -10 requirements.txt
+    elif [ -f "go.mod" ]; then
+        echo "Go project detected"
+        grep -E "^require" -A 10 go.mod | head -12
+    else
+        echo "No standard package file found"
+    fi
+    echo ""
+
+    # 6. Git info
+    if [ "${TOOL_STATUS[git]}" = "installed" ]; then
+        echo -e "${GREEN}## Git Activity${NC}"
+        echo "Recent commits:"
+        git log --oneline -10 2>/dev/null || echo "(no commits)"
+        echo ""
+        echo "Recently modified files:"
+        git log --since="2 weeks ago" --name-only --pretty=format: 2>/dev/null | sort | uniq -c | sort -rn | head -10 || echo "(no recent changes)"
+        echo ""
+        echo "Contributors:"
+        git shortlog -sn --no-merges 2>/dev/null | head -5 || echo "(no contributors)"
+    fi
+    echo ""
+
+    # 7. Config files detected
+    echo -e "${GREEN}## Config Files Detected${NC}"
+
+    # Check each config file explicitly
+    [ -f "next.config.js" ] || [ -f "next.config.mjs" ] || [ -f "next.config.ts" ] && echo "  ✓ Next.js"
+    [ -f "nuxt.config.js" ] || [ -f "nuxt.config.ts" ] && echo "  ✓ Nuxt.js"
+    [ -f "vite.config.js" ] || [ -f "vite.config.ts" ] && echo "  ✓ Vite"
+    [ -f "tsconfig.json" ] && echo "  ✓ TypeScript"
+    [ -f "prisma/schema.prisma" ] && echo "  ✓ Prisma"
+    [ -f "docker-compose.yml" ] || [ -f "docker-compose.yaml" ] && echo "  ✓ Docker Compose"
+    [ -f "Dockerfile" ] && echo "  ✓ Docker"
+    [ -f ".env.example" ] || [ -f ".env.local" ] && echo "  ✓ Environment config"
+    [ -f "tailwind.config.js" ] || [ -f "tailwind.config.ts" ] && echo "  ✓ Tailwind CSS"
+    [ -f "package.json" ] && echo "  ✓ Node.js (package.json)"
+    [ -f "requirements.txt" ] && echo "  ✓ Python (requirements.txt)"
+    [ -f "go.mod" ] && echo "  ✓ Go (go.mod)"
+    [ -f "Cargo.toml" ] && echo "  ✓ Rust (Cargo.toml)"
+
+    echo ""
+
+    echo -e "${BLUE}═══════════════════════════════════════${NC}"
+    echo -e "${BLUE}  Analysis complete${NC}"
+    echo -e "${BLUE}═══════════════════════════════════════${NC}"
+}
+
+# Output as JSON
+run_analysis_json() {
+    cd "$TARGET_PATH"
+
+    cat << EOF
+{
+  "path": "$(pwd)",
+  "files": $(find . -type f ! -path './node_modules/*' ! -path './.git/*' ! -path './dist/*' | wc -l),
+  "directories": $(find . -type d ! -path './node_modules/*' ! -path './.git/*' | wc -l),
+  "tools": {
+    "tree": "${TOOL_STATUS[tree]}",
+    "scc": "${TOOL_STATUS[scc]}",
+    "jq": "${TOOL_STATUS[jq]}",
+    "rg": "${TOOL_STATUS[rg]}",
+    "git": "${TOOL_STATUS[git]}"
+  },
+  "has_package_json": $([ -f "package.json" ] && echo "true" || echo "false"),
+  "has_requirements_txt": $([ -f "requirements.txt" ] && echo "true" || echo "false"),
+  "is_git_repo": $([ -d ".git" ] && echo "true" || echo "false")
+}
+EOF
+}
+
+# Main
+main() {
+    check_tools
+
+    if [ "$CHECK_ONLY" = true ]; then
+        offer_install
+        exit 0
+    fi
+
+    if [ "$JSON_MODE" = true ]; then
+        run_analysis_json
+    else
+        offer_install
+        echo ""
+        run_analysis
+    fi
+}
+
+main