Claude-Code-Workflow/.claude/scripts/update_module_claude.sh

#!/bin/bash
# Update CLAUDE.md for a specific module with automatic layer detection
# Usage: update_module_claude.sh <module_path> [update_type] [tool]
#   module_path: Path to the module directory
#   update_type: full|related (default: full)
#   tool: gemini|qwen|codex (default: gemini)
#
# Features:
# - Respects .gitignore patterns (current directory or git root)
# - Automatic layer detection (Root/Domain/Module/Sub-Module)
# - Template-based documentation generation

# Build exclusion filters from .gitignore
build_exclusion_filters() {
    local filters=""

    # Common system/cache directories to exclude
    local system_excludes=(
        ".git" "__pycache__" "node_modules" ".venv" "venv" "env"
        "dist" "build" ".cache" ".pytest_cache" ".mypy_cache"
        "coverage" ".nyc_output" "logs" "tmp" "temp"
    )

    for exclude in "${system_excludes[@]}"; do
        filters+=" -not -path '*/$exclude' -not -path '*/$exclude/*'"
    done

    # Find and parse .gitignore (current dir first, then git root)
    local gitignore_file=""

    # Check current directory first
    if [ -f ".gitignore" ]; then
        gitignore_file=".gitignore"
    else
        # Try to find git root and check for .gitignore there
        local git_root=$(git rev-parse --show-toplevel 2>/dev/null)
        if [ -n "$git_root" ] && [ -f "$git_root/.gitignore" ]; then
            gitignore_file="$git_root/.gitignore"
        fi
    fi

    # Parse .gitignore if found
    if [ -n "$gitignore_file" ]; then
        while IFS= read -r line; do
            # Skip empty lines and comments
            [[ -z "$line" || "$line" =~ ^[[:space:]]*# ]] && continue

            # Remove trailing slash and whitespace
            line=$(echo "$line" | sed 's|/$||' | xargs)

            # Skip wildcards patterns (too complex for simple find)
            [[ "$line" =~ \* ]] && continue

            # Add to filters
            filters+=" -not -path '*/$line' -not -path '*/$line/*'"
        done < "$gitignore_file"
    fi

    echo "$filters"
}

update_module_claude() {
    local module_path="$1"
    local update_type="${2:-full}"
    local tool="${3:-gemini}"

    # Validate parameters
    if [ -z "$module_path" ]; then
        echo "❌ Error: Module path is required"
        echo "Usage: update_module_claude.sh <module_path> [update_type]"
        return 1
    fi

    if [ ! -d "$module_path" ]; then
        echo "❌ Error: Directory '$module_path' does not exist"
        return 1
    fi

    # Build exclusion filters from .gitignore
    local exclusion_filters=$(build_exclusion_filters)

    # Check if directory has files (excluding gitignored paths)
    local file_count=$(eval "find \"$module_path\" -maxdepth 1 -type f $exclusion_filters 2>/dev/null" | wc -l)
    if [ $file_count -eq 0 ]; then
        echo "⚠️  Skipping '$module_path' - no files found (after .gitignore filtering)"
        return 0
    fi
    
    # Determine documentation layer based on path patterns
    local layer=""
    local template_path=""
    local analysis_strategy=""
    
    # Clean path for pattern matching
    local clean_path=$(echo "$module_path" | sed 's|^\./||')
    
    # Pattern-based layer detection
    if [ "$module_path" = "." ]; then
        # Root directory
        layer="Layer 1 (Root)"
        template_path="$HOME/.claude/workflows/cli-templates/prompts/memory/claude-layer1-root.txt"
        analysis_strategy="--all-files"
    elif [[ "$clean_path" =~ ^[^/]+$ ]]; then
        # Top-level directories (e.g., .claude, src, tests)
        layer="Layer 2 (Domain)"
        template_path="$HOME/.claude/workflows/cli-templates/prompts/memory/claude-layer2-domain.txt"
        analysis_strategy="@{*/CLAUDE.md}"
    elif [[ "$clean_path" =~ ^[^/]+/[^/]+$ ]]; then
        # Second-level directories (e.g., .claude/scripts, src/components)
        layer="Layer 3 (Module)"
        template_path="$HOME/.claude/workflows/cli-templates/prompts/memory/claude-layer3-module.txt"
        analysis_strategy="@{*/CLAUDE.md}"
    else
        # Deeper directories (e.g., .claude/workflows/cli-templates/prompts)
        layer="Layer 4 (Sub-Module)"
        template_path="$HOME/.claude/workflows/cli-templates/prompts/memory/claude-layer4-submodule.txt"
        analysis_strategy="--all-files"
    fi
    
    # Prepare logging info
    local module_name=$(basename "$module_path")

    echo "⚡ Updating: $module_path"
    echo "   Layer: $layer | Type: $update_type | Tool: $tool | Files: $file_count"
    echo "   Template: $(basename "$template_path") | Strategy: $analysis_strategy"
    
    # Generate prompt with template injection
    local template_content=""
    if [ -f "$template_path" ]; then
        template_content=$(cat "$template_path")
    else
        echo "   ⚠️  Template not found: $template_path, using fallback"
        template_content="Update CLAUDE.md documentation for this module following hierarchy standards."
    fi
    
    local update_context=""
    if [ "$update_type" = "full" ]; then
        update_context="
        Update Mode: Complete refresh
        - Perform comprehensive analysis of all content
        - Document patterns, architecture, and purpose
        - Consider existing documentation hierarchy
        - Follow template guidelines strictly"
    else
        update_context="
        Update Mode: Context-aware update
        - Focus on recent changes and affected areas
        - Maintain consistency with existing documentation
        - Update only relevant sections
        - Follow template guidelines for updated content"
    fi
    
    local base_prompt="
    ⚠️ CRITICAL RULES - MUST FOLLOW:
    1. ONLY modify CLAUDE.md files at any hierarchy level
    2. NEVER modify source code files
    3. Focus exclusively on updating documentation
    4. Follow the template guidelines exactly
    
    $template_content
    
    $update_context"
    
    # Execute update
    local start_time=$(date +%s)
    echo "   🔄 Starting update..."

    if cd "$module_path" 2>/dev/null; then
        local tool_result=0
        local final_prompt="$base_prompt

        Module Information:
        - Name: $module_name
        - Path: $module_path
        - Layer: $layer
        - Tool: $tool
        - Analysis Strategy: $analysis_strategy"

        # Execute with selected tool
        case "$tool" in
            qwen)
                if [ "$analysis_strategy" = "--all-files" ]; then
                    qwen --all-files --yolo -p "$final_prompt" 2>&1
                    tool_result=$?
                else
                    qwen --yolo -p "$analysis_strategy $final_prompt" 2>&1
                    tool_result=$?
                fi
                ;;
            codex)
                if [ "$analysis_strategy" = "--all-files" ]; then
                    codex --full-auto exec "$final_prompt" --skip-git-repo-check -s danger-full-access 2>&1
                    tool_result=$?
                else
                    codex --full-auto exec "$final_prompt CONTEXT: $analysis_strategy" --skip-git-repo-check -s danger-full-access 2>&1
                    tool_result=$?
                fi
                ;;
            gemini|*)
                if [ "$analysis_strategy" = "--all-files" ]; then
                    gemini --all-files --yolo -p "$final_prompt" 2>&1
                    tool_result=$?
                else
                    gemini --yolo -p "$analysis_strategy $final_prompt" 2>&1
                    tool_result=$?
                fi
                ;;
        esac

        if [ $tool_result -eq 0 ]; then
            local end_time=$(date +%s)
            local duration=$((end_time - start_time))
            echo "   ✅ Completed in ${duration}s"
            cd - > /dev/null
            return 0
        else
            echo "   ❌ Update failed for $module_path"
            cd - > /dev/null
            return 1
        fi
    else
        echo "   ❌ Cannot access directory: $module_path"
        return 1
    fi
}

# Execute function if script is run directly
if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
    update_module_claude "$@"
fi