anvil-dev-framework 0.1.6

package/scripts/sync.sh

@@ -0,0 +1,623 @@
+#!/bin/bash
+
+#
+# Anvil Development Framework - Sync Script
+#
+# Syncs Anvil framework updates to global config and/or projects
+#
+# Usage:
+#   anvil sync --global                    # Sync to ~/.claude/
+#   anvil sync --project /path/to/project  # Sync to a specific project
+#   anvil sync --project .                 # Sync to current directory
+#   anvil sync --all                       # Sync global + all registered projects
+#   anvil sync --dry-run --project .       # Preview changes without applying
+#
+
+set -e
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+DIM='\033[2m'
+NC='\033[0m' # No Color
+
+# Symbols
+CHECK="${GREEN}✓${NC}"
+CROSS="${RED}✗${NC}"
+ARROW="${BLUE}→${NC}"
+SKIP="${YELLOW}⊘${NC}"
+
+# Configuration
+ANVIL_DIR=""
+DRY_RUN=false
+FORCE=false
+VERBOSE=false
+SYNC_GLOBAL=false
+SYNC_PROJECT=""
+SYNC_ALL=false
+
+# Files that should NEVER be overwritten (user customizations)
+PROTECTED_FILES=(
+    "CLAUDE.md"
+    "product.md"
+    "constitution.md"
+    "settings.local.json"
+    "coordination.md"
+    "linear.yaml"
+)
+
+# Files that should ALWAYS be synced (framework updates)
+SYNC_ALWAYS=(
+    "hooks/"
+    "examples/"
+)
+
+
+#######################################
+# Helper Functions
+#######################################
+
+print_banner() {
+    echo ""
+    echo -e "${BLUE}╔═══════════════════════════════════════╗${NC}"
+    echo -e "${BLUE}║${NC}       Anvil Framework Sync Tool       ${BLUE}║${NC}"
+    echo -e "${BLUE}╚═══════════════════════════════════════╝${NC}"
+    echo ""
+}
+
+log_info() {
+    echo -e "${BLUE}[INFO]${NC} $1"
+}
+
+log_success() {
+    echo -e "${GREEN}[SUCCESS]${NC} $1"
+}
+
+log_warning() {
+    echo -e "${YELLOW}[WARNING]${NC} $1"
+}
+
+log_error() {
+    echo -e "${RED}[ERROR]${NC} $1"
+}
+
+log_verbose() {
+    if [ "$VERBOSE" = true ]; then
+        echo -e "${DIM}[DEBUG] $1${NC}"
+    fi
+}
+
+log_dry_run() {
+    if [ "$DRY_RUN" = true ]; then
+        echo -e "${CYAN}[DRY-RUN]${NC} $1"
+    fi
+}
+
+# Check if file is protected
+is_protected() {
+    local filename=$(basename "$1")
+    for protected in "${PROTECTED_FILES[@]}"; do
+        if [ "$filename" = "$protected" ]; then
+            return 0
+        fi
+    done
+    return 1
+}
+
+# Find Anvil installation directory
+find_anvil_dir() {
+    # Check ANVIL_HOME env var first
+    if [ -n "$ANVIL_HOME" ] && [ -d "$ANVIL_HOME" ]; then
+        echo "$ANVIL_HOME"
+        return 0
+    fi
+    
+    # Check if we're in the anvil directory
+    if [ -f "./VERSION" ] && [ -d "./global" ]; then
+        echo "$(pwd)"
+        return 0
+    fi
+    
+    # Check common locations
+    local locations=(
+        "$HOME/Projects/anvil-dev-framework"
+        "$HOME/dev/anvil-dev-framework"
+        "$HOME/code/anvil-dev-framework"
+        "/opt/anvil-dev-framework"
+    )
+    
+    for loc in "${locations[@]}"; do
+        if [ -f "$loc/VERSION" ]; then
+            echo "$loc"
+            return 0
+        fi
+    done
+    
+    return 1
+}
+
+
+# Get current Anvil version
+get_version() {
+    if [ -f "$ANVIL_DIR/VERSION" ]; then
+        cat "$ANVIL_DIR/VERSION"
+    else
+        echo "unknown"
+    fi
+}
+
+# Compare files and return if different
+files_differ() {
+    local src="$1"
+    local dst="$2"
+    
+    if [ ! -f "$dst" ]; then
+        return 0  # Destination doesn't exist, so "different"
+    fi
+    
+    if ! diff -q "$src" "$dst" > /dev/null 2>&1; then
+        return 0  # Files differ
+    fi
+    
+    return 1  # Files are same
+}
+
+# Sync a single file
+sync_file() {
+    local src="$1"
+    local dst="$2"
+    local filename=$(basename "$src")
+    
+    # Check if file exists at destination
+    if [ ! -f "$dst" ]; then
+        if [ "$DRY_RUN" = true ]; then
+            log_dry_run "Would create: $dst"
+        else
+            mkdir -p "$(dirname "$dst")"
+            cp "$src" "$dst"
+            echo -e "  ${CHECK} Created: ${filename}"
+        fi
+        return 0
+    fi
+    
+    # Check if protected and not forcing
+    if is_protected "$filename" && [ "$FORCE" != true ]; then
+        if files_differ "$src" "$dst"; then
+            echo -e "  ${SKIP} Protected (use --force): ${filename}"
+        else
+            log_verbose "Protected file unchanged: $filename"
+        fi
+        return 0
+    fi
+    
+    # Check if files differ
+    if files_differ "$src" "$dst"; then
+        if [ "$DRY_RUN" = true ]; then
+            log_dry_run "Would update: $dst"
+            if [ "$VERBOSE" = true ]; then
+                echo -e "${DIM}--- Diff ---${NC}"
+                diff "$dst" "$src" || true
+                echo -e "${DIM}------------${NC}"
+            fi
+        else
+            cp "$src" "$dst"
+            echo -e "  ${CHECK} Updated: ${filename}"
+        fi
+    else
+        log_verbose "Unchanged: $filename"
+    fi
+}
+
+# Sync a directory recursively
+sync_directory() {
+    local src_dir="${1%/}"  # Remove trailing slash if present
+    local dst_dir="${2%/}"  # Remove trailing slash if present
+    local dir_name=$(basename "$src_dir")
+
+    if [ ! -d "$src_dir" ]; then
+        log_warning "Source directory not found: $src_dir"
+        return 1
+    fi
+    
+    if [ "$DRY_RUN" = true ]; then
+        log_dry_run "Would sync directory: $dir_name/"
+    fi
+    
+    mkdir -p "$dst_dir"
+    
+    # Sync all files in directory
+    find "$src_dir" -type f | while read -r src_file; do
+        local rel_path="${src_file#$src_dir/}"
+        local dst_file="$dst_dir/$rel_path"
+        sync_file "$src_file" "$dst_file"
+    done
+}
+
+
+#######################################
+# Sync Functions
+#######################################
+
+# Sync global config to ~/.claude/
+sync_global() {
+    local global_dir="$HOME/.claude"
+    local version=$(get_version)
+    
+    echo ""
+    echo -e "${BLUE}═══════════════════════════════════════${NC}"
+    echo -e "${BLUE}  Syncing Global Config (v${version})${NC}"
+    echo -e "${BLUE}═══════════════════════════════════════${NC}"
+    echo ""
+    
+    # Create directory structure
+    mkdir -p "$global_dir/commands"
+    mkdir -p "$global_dir/standards"
+    mkdir -p "$global_dir/templates"
+    mkdir -p "$global_dir/skills"
+    
+    # Sync commands (always update)
+    echo -e "${ARROW} Syncing commands..."
+    if [ -d "$ANVIL_DIR/global/commands" ]; then
+        for cmd in "$ANVIL_DIR/global/commands"/*.md; do
+            if [ -f "$cmd" ]; then
+                sync_file "$cmd" "$global_dir/commands/$(basename "$cmd")"
+            fi
+        done
+    fi
+    
+    # Sync standards
+    echo -e "${ARROW} Syncing standards..."
+    if [ -d "$ANVIL_DIR/global/standards" ]; then
+        for std in "$ANVIL_DIR/global/standards"/*.md; do
+            if [ -f "$std" ]; then
+                sync_file "$std" "$global_dir/standards/$(basename "$std")"
+            fi
+        done
+    fi
+    
+    # Sync templates (including subdirectories like ralph/)
+    echo -e "${ARROW} Syncing templates..."
+    if [ -d "$ANVIL_DIR/global/templates" ]; then
+        # Sync top-level template files
+        for tpl in "$ANVIL_DIR/global/templates"/*.md; do
+            if [ -f "$tpl" ]; then
+                sync_file "$tpl" "$global_dir/templates/$(basename "$tpl")"
+            fi
+        done
+        # Sync template subdirectories (e.g., ralph/)
+        for subdir in "$ANVIL_DIR/global/templates"/*/; do
+            if [ -d "$subdir" ]; then
+                local subdir_name=$(basename "$subdir")
+                mkdir -p "$global_dir/templates/$subdir_name"
+                sync_directory "$subdir" "$global_dir/templates/$subdir_name"
+            fi
+        done
+    fi
+
+    # Sync global hooks (ralph_stop.sh, etc.)
+    echo -e "${ARROW} Syncing global hooks..."
+    if [ -d "$ANVIL_DIR/global/hooks" ]; then
+        mkdir -p "$global_dir/hooks"
+        for hook in "$ANVIL_DIR/global/hooks"/*; do
+            if [ -f "$hook" ]; then
+                sync_file "$hook" "$global_dir/hooks/$(basename "$hook")"
+            fi
+        done
+    fi
+
+    # Sync global lib (ralph_state.py, etc.)
+    echo -e "${ARROW} Syncing global lib..."
+    if [ -d "$ANVIL_DIR/global/lib" ]; then
+        mkdir -p "$global_dir/lib"
+        for lib in "$ANVIL_DIR/global/lib"/*; do
+            if [ -f "$lib" ]; then
+                sync_file "$lib" "$global_dir/lib/$(basename "$lib")"
+            fi
+        done
+    fi
+
+    # Sync global tools (ralph-loop.sh, etc.)
+    echo -e "${ARROW} Syncing global tools..."
+    if [ -d "$ANVIL_DIR/global/tools" ]; then
+        mkdir -p "$global_dir/tools"
+        for tool in "$ANVIL_DIR/global/tools"/*; do
+            if [ -f "$tool" ]; then
+                sync_file "$tool" "$global_dir/tools/$(basename "$tool")"
+            fi
+        done
+    fi
+
+    # Sync global CLAUDE.md (protected)
+    if [ -f "$ANVIL_DIR/global/CLAUDE.md" ]; then
+        echo -e "${ARROW} Syncing CLAUDE.md..."
+        sync_file "$ANVIL_DIR/global/CLAUDE.md" "$global_dir/CLAUDE.md"
+    fi
+    
+    # Update version marker
+    if [ "$DRY_RUN" != true ]; then
+        echo "$version" > "$global_dir/.anvil-version"
+        echo -e "  ${CHECK} Version marker updated: v${version}"
+    fi
+    
+    echo ""
+    log_success "Global sync complete!"
+}
+
+
+# Sync to a specific project
+sync_project() {
+    local project_dir="$1"
+    local claude_dir="$project_dir/.claude"
+    local version=$(get_version)
+    
+    # Resolve to absolute path
+    project_dir=$(cd "$project_dir" && pwd)
+    claude_dir="$project_dir/.claude"
+    
+    # Check if project has .claude directory
+    if [ ! -d "$claude_dir" ]; then
+        log_warning "Project does not have .claude/ directory: $project_dir"
+        echo "Run 'anvil init $project_dir' first, or create manually."
+        return 1
+    fi
+    
+    local project_name=$(basename "$project_dir")
+    
+    echo ""
+    echo -e "${BLUE}═══════════════════════════════════════${NC}"
+    echo -e "${BLUE}  Syncing Project: ${project_name} (v${version})${NC}"
+    echo -e "${BLUE}═══════════════════════════════════════${NC}"
+    echo ""
+    
+    # Load project config if exists
+    local config_file="$claude_dir/.anvil-project.yaml"
+    
+    # Sync hooks (always - critical for functionality)
+    echo -e "${ARROW} Syncing hooks..."
+    if [ -d "$ANVIL_DIR/project/hooks" ]; then
+        sync_directory "$ANVIL_DIR/project/hooks" "$claude_dir/hooks"
+    fi
+    
+    # Sync examples (always - reference implementations)
+    echo -e "${ARROW} Syncing examples..."
+    if [ -d "$ANVIL_DIR/project/examples" ]; then
+        sync_directory "$ANVIL_DIR/project/examples" "$claude_dir/examples"
+    fi
+    
+    # Sync agents (always - sub-agent definitions)
+    echo -e "${ARROW} Syncing agents..."
+    if [ -d "$ANVIL_DIR/project/agents" ]; then
+        sync_directory "$ANVIL_DIR/project/agents" "$claude_dir/agents"
+    fi
+    
+    # Sync retro templates
+    echo -e "${ARROW} Syncing retro templates..."
+    if [ -d "$ANVIL_DIR/project/retros" ]; then
+        mkdir -p "$claude_dir/retros/templates"
+        if [ -f "$ANVIL_DIR/project/retros/README.md" ]; then
+            sync_file "$ANVIL_DIR/project/retros/README.md" "$claude_dir/retros/README.md"
+        fi
+        if [ -d "$ANVIL_DIR/project/retros/templates" ]; then
+            sync_directory "$ANVIL_DIR/project/retros/templates" "$claude_dir/retros/templates"
+        fi
+    fi
+    
+    # Sync protected files (only if --force or doesn't exist)
+    echo -e "${ARROW} Checking core files..."
+    
+    # CLAUDE.md
+    if [ -f "$ANVIL_DIR/project/CLAUDE.md.template" ]; then
+        if [ ! -f "$claude_dir/CLAUDE.md" ]; then
+            if [ "$DRY_RUN" = true ]; then
+                log_dry_run "Would create: CLAUDE.md"
+            else
+                cp "$ANVIL_DIR/project/CLAUDE.md.template" "$claude_dir/CLAUDE.md"
+                echo -e "  ${CHECK} Created: CLAUDE.md"
+            fi
+        else
+            echo -e "  ${SKIP} Protected: CLAUDE.md (exists)"
+        fi
+    fi
+    
+    # constitution.md
+    if [ -f "$ANVIL_DIR/project/constitution.md.template" ]; then
+        if [ ! -f "$claude_dir/constitution.md" ]; then
+            if [ "$DRY_RUN" = true ]; then
+                log_dry_run "Would create: constitution.md"
+            else
+                cp "$ANVIL_DIR/project/constitution.md.template" "$claude_dir/constitution.md"
+                echo -e "  ${CHECK} Created: constitution.md"
+            fi
+        else
+            echo -e "  ${SKIP} Protected: constitution.md (exists)"
+        fi
+    fi
+    
+    # product.md
+    if [ -f "$ANVIL_DIR/project/product.md.template" ]; then
+        if [ ! -f "$claude_dir/product.md" ]; then
+            if [ "$DRY_RUN" = true ]; then
+                log_dry_run "Would create: product.md"
+            else
+                cp "$ANVIL_DIR/project/product.md.template" "$claude_dir/product.md"
+                echo -e "  ${CHECK} Created: product.md"
+            fi
+        else
+            echo -e "  ${SKIP} Protected: product.md (exists)"
+        fi
+    fi
+    
+    # coordination.md (less protected, sync if newer)
+    if [ -f "$ANVIL_DIR/project/coordination.md" ]; then
+        sync_file "$ANVIL_DIR/project/coordination.md" "$claude_dir/coordination.md"
+    fi
+    
+    # Sync global commands to project (optional - projects can use global)
+    echo -e "${ARROW} Syncing commands..."
+    if [ -d "$ANVIL_DIR/global/commands" ]; then
+        mkdir -p "$claude_dir/commands"
+        for cmd in "$ANVIL_DIR/global/commands"/*.md; do
+            if [ -f "$cmd" ]; then
+                sync_file "$cmd" "$claude_dir/commands/$(basename "$cmd")"
+            fi
+        done
+    fi
+    
+    # Update version marker
+    if [ "$DRY_RUN" != true ]; then
+        echo "$version" > "$claude_dir/.anvil-version"
+        echo -e "  ${CHECK} Version marker: v${version}"
+    fi
+    
+    echo ""
+    log_success "Project sync complete: $project_name"
+}
+
+
+#######################################
+# Argument Parsing
+#######################################
+
+show_help() {
+    echo "Anvil Sync - Sync framework updates to global config and projects"
+    echo ""
+    echo "Usage: $0 [OPTIONS]"
+    echo ""
+    echo "Targets:"
+    echo "  --global              Sync to ~/.claude/ (global config)"
+    echo "  --project PATH        Sync to a specific project"
+    echo "  --all                 Sync global + all registered projects"
+    echo ""
+    echo "Options:"
+    echo "  --force, -f           Overwrite protected files"
+    echo "  --dry-run, -n         Preview changes without applying"
+    echo "  --verbose, -v         Show detailed output"
+    echo "  --help, -h            Show this help message"
+    echo ""
+    echo "Examples:"
+    echo "  $0 --global                          # Sync global commands"
+    echo "  $0 --project /path/to/myproject      # Sync to specific project"
+    echo "  $0 --project . --dry-run             # Preview project sync"
+    echo "  $0 --global --project . --force      # Full sync with overwrites"
+    echo ""
+    echo "Protected files (not overwritten without --force):"
+    echo "  - CLAUDE.md"
+    echo "  - product.md"
+    echo "  - constitution.md"
+    echo "  - settings.local.json"
+    echo ""
+    echo "Environment:"
+    echo "  ANVIL_HOME    Path to anvil-dev-framework (auto-detected if not set)"
+}
+
+parse_args() {
+    while [[ $# -gt 0 ]]; do
+        case $1 in
+            --global)
+                SYNC_GLOBAL=true
+                shift
+                ;;
+            --project)
+                SYNC_PROJECT="$2"
+                shift 2
+                ;;
+            --all)
+                SYNC_ALL=true
+                shift
+                ;;
+            --force|-f)
+                FORCE=true
+                shift
+                ;;
+            --dry-run|-n)
+                DRY_RUN=true
+                shift
+                ;;
+            --verbose|-v)
+                VERBOSE=true
+                shift
+                ;;
+            --help|-h)
+                show_help
+                exit 0
+                ;;
+            *)
+                log_error "Unknown option: $1"
+                show_help
+                exit 1
+                ;;
+        esac
+    done
+}
+
+
+#######################################
+# Main
+#######################################
+
+main() {
+    parse_args "$@"
+    
+    # Find Anvil directory
+    ANVIL_DIR=$(find_anvil_dir)
+    if [ -z "$ANVIL_DIR" ]; then
+        log_error "Could not find Anvil installation."
+        echo "Set ANVIL_HOME environment variable or run from anvil-dev-framework directory."
+        exit 1
+    fi
+    
+    log_verbose "Anvil directory: $ANVIL_DIR"
+    
+    # Print banner
+    print_banner
+    
+    local version=$(get_version)
+    echo -e "Anvil Framework v${version}"
+    echo -e "Source: ${DIM}${ANVIL_DIR}${NC}"
+    
+    if [ "$DRY_RUN" = true ]; then
+        echo -e "${CYAN}Mode: DRY RUN (no changes will be made)${NC}"
+    fi
+    if [ "$FORCE" = true ]; then
+        echo -e "${YELLOW}Mode: FORCE (protected files will be overwritten)${NC}"
+    fi
+    
+    # Check if any target specified
+    if [ "$SYNC_GLOBAL" != true ] && [ -z "$SYNC_PROJECT" ] && [ "$SYNC_ALL" != true ]; then
+        log_error "No sync target specified."
+        echo ""
+        echo "Use --global, --project PATH, or --all"
+        echo "Run '$0 --help' for usage information."
+        exit 1
+    fi
+    
+    # Execute syncs
+    if [ "$SYNC_GLOBAL" = true ] || [ "$SYNC_ALL" = true ]; then
+        sync_global
+    fi
+    
+    if [ -n "$SYNC_PROJECT" ]; then
+        if [ ! -d "$SYNC_PROJECT" ]; then
+            log_error "Project directory not found: $SYNC_PROJECT"
+            exit 1
+        fi
+        sync_project "$SYNC_PROJECT"
+    fi
+    
+    if [ "$SYNC_ALL" = true ]; then
+        # TODO: Read registered projects from ~/.claude/.anvil-projects
+        log_warning "--all currently only syncs global. Project registry coming soon."
+    fi
+    
+    echo ""
+    echo -e "${GREEN}════════════════════════════════════════${NC}"
+    echo -e "${GREEN}  Sync Complete!${NC}"
+    echo -e "${GREEN}════════════════════════════════════════${NC}"
+    echo ""
+}
+
+# Run main
+main "$@"