configs-all 1.0.0

package/scripts/sync/config-common.zsh

@@ -0,0 +1,882 @@
+#!/bin/zsh
+
+# Common configuration management functions
+# Used by both push-configs.zsh and pull-configs.zsh
+
+set -uo pipefail
+
+# Detect platform and set HOME appropriately
+if [[ "$OSTYPE" == "darwin"* ]]; then
+    HOME="${HOME:-$(cd ~ && pwd)}"
+    IS_MAC=true
+    IS_WINDOWS=false
+elif [[ -d "/mnt/c" ]]; then
+    # WSL or Windows environment - HOME should already be set correctly
+    HOME="${HOME:-$(cd ~ && pwd)}"
+    IS_MAC=false
+    IS_WINDOWS=true
+    # Get Windows username from WSL
+    WINDOWS_USER="wolfe"
+else
+    # Linux or other Unix - use standard HOME
+    HOME="${HOME:-$(cd ~ && pwd)}"
+    IS_MAC=false
+    IS_WINDOWS=false
+fi
+
+# Resolve repo root if CONFIG_DIR isn't provided by the environment
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+
+# Detect CONFIG_DIR dynamically based on hostname
+# On Windows/PowerShell, hostname might return incorrect value, so try alternatives
+if [[ "$IS_WINDOWS" == "true" ]]; then
+    # Try to detect based on current directory
+    if [[ "$PWD" == *"mikpc"* ]]; then
+        HOST="mikpc"
+    elif [[ "$PWD" == *"duplo"* ]]; then
+        HOST="duplo"
+    elif [[ "$PWD" == *"mikbook"* ]]; then
+        HOST="mikbook"
+    elif [[ "$PWD" == *"mikmac"* ]]; then
+        HOST="mikmac"
+    else
+        HOST="mikpc"  # Default fallback for Windows
+    fi
+else
+    HOST="$(hostname 2>/dev/null || echo 'unknown')"
+fi
+case "${HOST}" in
+    "mikmac")
+        CONFIG_DIR="${HOME}/Dropbox/dev/configs"
+        ;;
+    "mikbook")
+        CONFIG_DIR="${HOME}/Dropbox/mikbook/dev/configs"
+        ;;
+    "duplo")
+        CONFIG_DIR="${HOME}/Dropbox/duplo/dev/chiefmikey/configs"
+        ;;
+    "mikpc")
+        # Windows PC - handle both WSL and native paths
+        if [[ -n "${WSL_DISTRO_NAME:-}" ]] || [[ -f /proc/version ]] && grep -qi microsoft /proc/version 2>/dev/null; then
+            # WSL path - check if it exists, otherwise use SCRIPT_DIR fallback
+            if [[ -d "${HOME}/Dropbox/mikpc/dev/configs" ]]; then
+                CONFIG_DIR="${HOME}/Dropbox/mikpc/dev/configs"
+            elif [[ -d "/mnt/c/Users/${WINDOWS_USER:-$USER}/Dropbox/mikpc/dev/configs" ]]; then
+                CONFIG_DIR="/mnt/c/Users/${WINDOWS_USER:-$USER}/Dropbox/mikpc/dev/configs"
+            else
+                # Fallback to relative path resolution
+                CONFIG_DIR="${CONFIG_DIR:-$(cd "${SCRIPT_DIR}/.." && pwd)}"
+            fi
+        else
+            # Fallback to relative path resolution
+            CONFIG_DIR="${CONFIG_DIR:-$(cd "${SCRIPT_DIR}/.." && pwd)}"
+        fi
+        ;;
+    *)
+        # Fallback to relative path resolution
+        CONFIG_DIR="${CONFIG_DIR:-$(cd "${SCRIPT_DIR}/.." && pwd)}"
+        ;;
+esac
+
+# Backup configuration
+# On Windows/WSL, use Linux filesystem for backups (NTFS has permission issues)
+if [[ "$IS_WINDOWS" == "true" ]]; then
+    BACKUP_DIR="${HOME}/.config/config-backups"
+else
+    BACKUP_DIR="${CONFIG_DIR}/backups"
+fi
+MAX_BACKUPS=5  # Keep only 5 most recent backups per file
+
+# Load variable definitions if available
+if [ -f "${CONFIG_DIR}/shell/zsh/config/variables.zsh" ]; then
+    # Source the variables
+    source "${CONFIG_DIR}/shell/zsh/config/variables.zsh"
+fi
+
+# Color output functions
+info() { echo -e "\033[0;34m[INFO]\033[0m $1"; }
+success() { echo -e "\033[0;32m[SUCCESS]\033[0m $1"; }
+warn() { echo -e "\033[0;33m[WARN]\033[0m $1"; }
+error() { echo -e "\033[0;31m[ERROR]\033[0m $1"; }
+
+# Ensure directory exists
+ensure_dir() {
+    local dir="$1"
+    if [[ ! -d "$dir" ]]; then
+        mkdir -p "$dir"
+        info "Created directory: $dir"
+    fi
+}
+
+# Create backup directory structure for a file
+create_backup_dir() {
+    local file_path="$1"
+    # Convert absolute path to relative path for backup structure
+    local relative_path="${file_path#"${HOME}"}"
+    local backup_subdir="${BACKUP_DIR}${relative_path}"
+    local backup_dir
+    backup_dir="$(dirname "$backup_subdir")"
+    ensure_dir "$backup_dir" >/dev/null
+    echo "$backup_dir"
+}
+
+# Clean up old backups for a specific file
+cleanup_old_backups() {
+    local backup_dir="$1"
+    local file_basename="$2"
+
+    # Find all backup files for this specific file and sort by modification time (newest first)
+    local backup_files
+    backup_files="$(find "$backup_dir" -name "${file_basename}.backup.*" -type f -printf '%T@ %p\n' 2>/dev/null | sort -nr | cut -d' ' -f2- || true)"
+
+    if [[ -n "$backup_files" ]]; then
+        local count=0
+        while IFS= read -r backup_file; do
+            count=$((count + 1))
+            if [[ $count -gt $MAX_BACKUPS ]]; then
+                rm -f "$backup_file"
+                info "Removed old backup: $(basename "$backup_file")"
+            fi
+        done <<< "$backup_files"
+    fi
+}
+
+# Validation functions
+validate_json() {
+    local file="$1"
+    if command -v jq >/dev/null 2>&1; then
+        if ! jq empty "$file" 2>/dev/null; then
+            error "Invalid JSON in $file"
+            return 1
+        fi
+    else
+        warn "jq not available, skipping JSON validation for $file"
+    fi
+}
+
+validate_xml() {
+    local file="$1"
+    if command -v xmllint >/dev/null 2>&1; then
+        if ! xmllint --noout "$file" 2>/dev/null; then
+            error "Invalid XML in $file"
+            return 1
+        fi
+    else
+        warn "xmllint not available, skipping XML validation for $file"
+    fi
+}
+
+validate_plist() {
+    local file="$1"
+    if command -v plutil >/dev/null 2>&1; then
+        if ! plutil -lint "$file" >/dev/null 2>&1; then
+            error "Invalid plist in $file"
+            return 1
+        fi
+    else
+        warn "plutil not available, skipping plist validation for $file"
+    fi
+}
+
+validate_yaml() {
+    local file="$1"
+    if command -v yq >/dev/null 2>&1; then
+        if ! yq '.' "$file" >/dev/null 2>&1; then
+            error "Invalid YAML in $file"
+            return 1
+        fi
+    else
+        warn "yq not available, skipping YAML validation for $file"
+    fi
+}
+
+validate_shell() {
+    local file="$1"
+    local shell_type="$2"
+    if [[ "$shell_type" == "zsh" ]]; then
+        if ! zsh -n "$file" 2>/dev/null; then
+            error "Invalid zsh syntax in $file"
+            return 1
+        fi
+    fi
+}
+
+# Safe copy with validation and backup
+safe_copy() {
+    local src="$1"
+    local dest="$2"
+    local validate_func="$3"
+    local backup_suffix
+    backup_suffix=".backup.$(date +%Y%m%d_%H%M%S)"
+
+    if [[ ! -f "$src" ]]; then
+        warn "Source file not found: $src"
+        return 0  # Return success to allow script to continue processing other files
+    fi
+
+    # If destination is a dangling symlink, remove it so we can write the real file.
+    if [[ -L "$dest" && ! -e "$dest" ]]; then
+        rm -f "$dest"
+        warn "Removed dangling symlink: $dest"
+    fi
+
+    # Validate source file if validation function provided
+    if [[ -n "$validate_func" ]]; then
+        if ! "$validate_func" "$src"; then
+            error "Validation failed for $src, skipping copy"
+            return 0  # Return success to allow script to continue processing other files
+        fi
+    fi
+
+    # Create backup if destination exists
+    if [[ -f "$dest" ]]; then
+        local backup_dir
+        backup_dir="$(create_backup_dir "$dest")"
+        local file_basename
+        file_basename="$(basename "$dest")"
+        local backup_file="${backup_dir}/${file_basename}${backup_suffix}"
+
+        cp "$dest" "$backup_file" 2>/dev/null || warn "Could not backup: $dest"
+        info "Backed up existing file: $backup_file"
+
+        # Clean up old backups for this file
+        cleanup_old_backups "$backup_dir" "$file_basename"
+    fi
+
+    ensure_dir "$(dirname "$dest")"
+    if cp "$src" "$dest" 2>/dev/null; then
+        success "Copied: $src → $dest"
+    else
+        error "Failed to copy: $src → $dest (permission denied?)"
+        return 0  # Continue processing other files
+    fi
+}
+
+# Copy if source exists with validation
+copy_if_exists() {
+    local src="$1"
+    local dest="$2"
+    local validate_func="$3"
+
+    if [[ -f "$src" ]]; then
+        # Validate source file if validation function provided
+        if [[ -n "$validate_func" ]]; then
+            if ! "$validate_func" "$src"; then
+                error "Validation failed for $src, skipping copy"
+                return 1
+            fi
+        fi
+
+        ensure_dir "$(dirname "$dest")"
+
+        # Special handling for Rectangle config (use defaults command)
+        if [[ "$src" == *"RectangleConfig.plist" ]]; then
+            # Use defaults command to load Rectangle preferences
+            if defaults import com.knollsoft.Rectangle "$src" 2>/dev/null; then
+                success "Imported Rectangle preferences: $src → Rectangle defaults"
+            else
+                error "Failed to import Rectangle preferences"
+                return 1
+            fi
+        else
+            if cp "$src" "$dest" 2>/dev/null; then
+                success "Copied: $src → $dest"
+            else
+                error "Failed to copy: $src → $dest (permission denied?)"
+            fi
+        fi
+    else
+        warn "Source file not found: $src"
+    fi
+}
+
+# Determine git config based on hostname
+get_git_config() {
+    case "${HOST}" in
+        "mikbook") echo "personal.gitconfig" ;;
+        "duplo")   echo "work.gitconfig" ;;
+        "mikpc")   echo "personal.gitconfig" ;;  # Windows PC - default to personal
+        *)         echo "personal.gitconfig" ;;  # Default fallback
+    esac
+}
+
+# Determine SSH config based on hostname (allows host-specific SSH settings)
+get_ssh_config() {
+    case "${HOST}" in
+        "duplo") echo "config.duplo" ;;
+        "mikpc") echo "config.mikpc" ;;
+        *)       echo "config" ;;
+    esac
+}
+
+# Configuration file mappings (using functions instead of associative arrays for compatibility)
+get_config_dest() {
+    local config_file="$1"
+    case "$config_file" in
+        "shell/zsh/.zshrc") echo "${HOME}/.zshrc" ;;
+        "git/config/base.gitconfig") echo "${HOME}/.config/git/base.gitconfig" ;;
+        "git/config/chiefmikey.gitconfig") echo "${HOME}/.config/git/chiefmikey.gitconfig" ;;
+        "git/config/$(get_git_config)") echo "${HOME}/.gitconfig" ;;
+        "ide/vscode/settings.json")
+            if [[ "$IS_WINDOWS" == "true" ]] && [[ -d "/mnt/c/Users/${WINDOWS_USER:-$USER}/AppData/Roaming" ]]; then
+                echo "/mnt/c/Users/${WINDOWS_USER:-$USER}/AppData/Roaming/Code/User/settings.json"
+            elif [[ "$IS_MAC" == "true" ]]; then
+                echo "${HOME}/Library/Application Support/Code/User/settings.json"
+            else
+                echo "${HOME}/.config/Code/User/settings.json"
+            fi
+            ;;
+        "ide/vscode/keybindings.json")
+            if [[ "$IS_WINDOWS" == "true" ]] && [[ -d "/mnt/c/Users/${WINDOWS_USER:-$USER}/AppData/Roaming" ]]; then
+                echo "/mnt/c/Users/${WINDOWS_USER:-$USER}/AppData/Roaming/Code/User/keybindings.json"
+            elif [[ "$IS_MAC" == "true" ]]; then
+                echo "${HOME}/Library/Application Support/Code/User/keybindings.json"
+            else
+                echo "${HOME}/.config/Code/User/keybindings.json"
+            fi
+            ;;
+        "ide/vscode/insiders/settings.json")
+            if [[ "$IS_WINDOWS" == "true" ]] && [[ -d "/mnt/c/Users/${WINDOWS_USER:-$USER}/AppData/Roaming" ]]; then
+                echo "/mnt/c/Users/${WINDOWS_USER:-$USER}/AppData/Roaming/Code - Insiders/User/settings.json"
+            elif [[ "$IS_MAC" == "true" ]]; then
+                echo "${HOME}/Library/Application Support/Code - Insiders/User/settings.json"
+            else
+                echo "${HOME}/.config/Code - Insiders/User/settings.json"
+            fi
+            ;;
+        "ide/vscode/insiders/keybindings.json")
+            if [[ "$IS_WINDOWS" == "true" ]] && [[ -d "/mnt/c/Users/${WINDOWS_USER:-$USER}/AppData/Roaming" ]]; then
+                echo "/mnt/c/Users/${WINDOWS_USER:-$USER}/AppData/Roaming/Code - Insiders/User/keybindings.json"
+            elif [[ "$IS_MAC" == "true" ]]; then
+                echo "${HOME}/Library/Application Support/Code - Insiders/User/keybindings.json"
+            else
+                echo "${HOME}/.config/Code - Insiders/User/keybindings.json"
+            fi
+            ;;
+        "ide/cursor/settings.json")
+            if [[ "$IS_WINDOWS" == "true" ]] && [[ -d "/mnt/c/Users/${WINDOWS_USER:-$USER}/AppData/Roaming" ]]; then
+                echo "/mnt/c/Users/${WINDOWS_USER:-$USER}/AppData/Roaming/Cursor/User/settings.json"
+            elif [[ "$IS_MAC" == "true" ]]; then
+                echo "${HOME}/Library/Application Support/Cursor/User/settings.json"
+            else
+                echo "${HOME}/.config/Cursor/User/settings.json"
+            fi
+            ;;
+        "ide/cursor/keybindings.json")
+            if [[ "$IS_WINDOWS" == "true" ]] && [[ -d "/mnt/c/Users/${WINDOWS_USER:-$USER}/AppData/Roaming" ]]; then
+                echo "/mnt/c/Users/${WINDOWS_USER:-$USER}/AppData/Roaming/Cursor/User/keybindings.json"
+            elif [[ "$IS_MAC" == "true" ]]; then
+                echo "${HOME}/Library/Application Support/Cursor/User/keybindings.json"
+            else
+                echo "${HOME}/.config/Cursor/User/keybindings.json"
+            fi
+            ;;
+        "ide/cursor/mcp.json")
+            # Mac uses mcp.json directly, Windows transforms it
+            if [[ "$IS_WINDOWS" == "true" ]] && [[ -d "/mnt/c/Users/${WINDOWS_USER:-$USER}/AppData/Roaming" ]]; then
+                echo "/mnt/c/Users/${WINDOWS_USER:-$USER}/.cursor/mcp.json"
+            else
+                echo "${HOME}/.cursor/mcp.json"
+            fi
+            ;;
+        "scripts/mcp/mcp-launcher.sh")
+            # Install launcher into a stable per-user location (Mac/Unix)
+            if [[ "$IS_WINDOWS" == "true" ]]; then
+                echo ""
+            else
+                echo "${HOME}/.local/bin/mcp-launcher.sh"
+            fi
+            ;;
+        "scripts/mcp/mcp-launcher.ps1")
+            # Install launcher into a stable per-user location (Windows filesystem via WSL)
+            if [[ "$IS_WINDOWS" == "true" ]] && [[ -d "/mnt/c/Users/${WINDOWS_USER:-$USER}" ]]; then
+                echo "/mnt/c/Users/${WINDOWS_USER:-$USER}/.local/bin/mcp-launcher.ps1"
+            else
+                echo ""
+            fi
+            ;;
+        "gh/config.yml") echo "${HOME}/.config/gh/config.yml" ;;
+        "gh/hosts.yml") echo "${HOME}/.config/gh/hosts.yml" ;;
+        "ssh/$(get_ssh_config)") echo "${HOME}/.ssh/config" ;;
+        "ssh/personal_signing.pub")
+            # Only deploy on non-duplo hosts
+            if [[ "${HOST}" != "duplo" ]]; then
+                echo "${HOME}/.ssh/personal_signing.pub"
+            else
+                echo ""
+            fi
+            ;;
+        "iterm/com.googlecode.iterm2.plist")
+            # Mac only
+            if [[ "$IS_MAC" == "true" ]]; then
+                echo "${HOME}/Library/Preferences/com.googlecode.iterm2.plist"
+            else
+                echo ""
+            fi
+            ;;
+        "wezterm/wezterm.lua")
+            # Cross-platform (primarily Windows/Linux, but works on Mac too)
+            echo "${HOME}/.config/wezterm/wezterm.lua"
+            ;;
+        "ghostty/config")
+            # Cross-platform (Mac/Linux — Ghostty not available on Windows yet)
+            if [[ "$IS_WINDOWS" == "true" ]]; then
+                echo ""
+            else
+                echo "${HOME}/.config/ghostty/config"
+            fi
+            ;;
+        "shell/powershell/Microsoft.PowerShell_profile.ps1")
+            # Windows only — PowerShell profile with debug helpers
+            if [[ "$IS_WINDOWS" == "true" ]] && [[ -d "/mnt/c/Users/${WINDOWS_USER:-$USER}" ]]; then
+                echo "/mnt/c/Users/${WINDOWS_USER:-$USER}/Documents/WindowsPowerShell/Microsoft.PowerShell_profile.ps1"
+            else
+                echo ""
+            fi
+            ;;
+        "ide/vscode/vscode/extensions.txt")
+            if [[ "$IS_WINDOWS" == "true" ]] && [[ -d "/mnt/c/Users/${WINDOWS_USER:-$USER}/AppData/Roaming" ]]; then
+                echo "/mnt/c/Users/${WINDOWS_USER:-$USER}/AppData/Roaming/Code/User/extensions.txt"
+            elif [[ "$IS_MAC" == "true" ]]; then
+                echo "${HOME}/Library/Application Support/Code/User/extensions.txt"
+            else
+                echo "${HOME}/.config/Code/User/extensions.txt"
+            fi
+            ;;
+        "apps/RectangleConfig.plist")
+            # Mac only
+            if [[ "$IS_MAC" == "true" ]]; then
+                echo "${HOME}/Library/Preferences/com.knollsoft.Rectangle.plist"
+            else
+                echo ""
+            fi
+            ;;
+        "apps/iStat Menus Settings.ismp7")
+            # Mac only
+            if [[ "$IS_MAC" == "true" ]]; then
+                echo "${HOME}/Library/Preferences/com.bjango.istatmenus.plist"
+            else
+                echo ""
+            fi
+            ;;
+        "apps/Synergy")
+            # Can work on both, but path differs
+            if [[ "$IS_MAC" == "true" ]]; then
+                echo "${HOME}/Library/Preferences/Synergy/synergy.conf"
+            elif [[ "$IS_WINDOWS" == "true" ]]; then
+                echo "/mnt/c/Users/${WINDOWS_USER:-$USER}/AppData/Roaming/Synergy/synergy.conf"
+            else
+                echo "${HOME}/.synergy.conf"
+            fi
+            ;;
+        "docker/mcp/registry.yaml")
+            if [[ "$IS_WINDOWS" == "true" ]] && [[ -d "/mnt/c/Users/${WINDOWS_USER:-$USER}" ]]; then
+                echo "/mnt/c/Users/${WINDOWS_USER:-$USER}/.docker/mcp/registry.yaml"
+            else
+                echo "${HOME}/.docker/mcp/registry.yaml"
+            fi
+            ;;
+        "docker/mcp/catalog.json")
+            if [[ "$IS_WINDOWS" == "true" ]] && [[ -d "/mnt/c/Users/${WINDOWS_USER:-$USER}" ]]; then
+                echo "/mnt/c/Users/${WINDOWS_USER:-$USER}/.docker/mcp/catalog.json"
+            else
+                echo "${HOME}/.docker/mcp/catalog.json"
+            fi
+            ;;
+        "docker/mcp/config.yaml")
+            if [[ "$IS_WINDOWS" == "true" ]] && [[ -d "/mnt/c/Users/${WINDOWS_USER:-$USER}" ]]; then
+                echo "/mnt/c/Users/${WINDOWS_USER:-$USER}/.docker/mcp/config.yaml"
+            else
+                echo "${HOME}/.docker/mcp/config.yaml"
+            fi
+            ;;
+        "docker/mcp/tools.yaml")
+            if [[ "$IS_WINDOWS" == "true" ]] && [[ -d "/mnt/c/Users/${WINDOWS_USER:-$USER}" ]]; then
+                echo "/mnt/c/Users/${WINDOWS_USER:-$USER}/.docker/mcp/tools.yaml"
+            else
+                echo "${HOME}/.docker/mcp/tools.yaml"
+            fi
+            ;;
+        "docker/mcp/catalogs/docker-mcp.yaml")
+            if [[ "$IS_WINDOWS" == "true" ]] && [[ -d "/mnt/c/Users/${WINDOWS_USER:-$USER}" ]]; then
+                echo "/mnt/c/Users/${WINDOWS_USER:-$USER}/.docker/mcp/catalogs/docker-mcp.yaml"
+            else
+                echo "${HOME}/.docker/mcp/catalogs/docker-mcp.yaml"
+            fi
+            ;;
+        "docker/cli/daemon.json") echo "${HOME}/.docker/daemon.json" ;;
+        "docker/cli/features.json") echo "${HOME}/.docker/features.json" ;;
+        # Claude Code configs
+        "claude/settings.json") echo "${HOME}/.claude/settings.json" ;;
+        "claude/settings.local.json") echo "${HOME}/.claude/settings.local.json" ;;
+        "claude/hooks.json") echo "${HOME}/.claude/hooks.json" ;;
+        "claude/statusline-command.sh") echo "${HOME}/.claude/statusline-command.sh" ;;
+        "claude/CLAUDE.md") echo "${HOME}/CLAUDE.md" ;;
+        "claude/desktop/claude_desktop_config.json")
+            # Mac only - Claude Desktop app
+            if [[ "$IS_MAC" == "true" ]]; then
+                echo "${HOME}/Library/Application Support/Claude/claude_desktop_config.json"
+            else
+                echo ""
+            fi
+            ;;
+        # WSL configs (Windows only)
+        "wsl/.wslconfig")
+            if [[ "$IS_WINDOWS" == "true" ]] && [[ -d "/mnt/c/Users/${WINDOWS_USER:-$USER}" ]]; then
+                echo "/mnt/c/Users/${WINDOWS_USER:-$USER}/.wslconfig"
+            else
+                echo ""
+            fi
+            ;;
+        "wsl/wsl.conf")
+            if [[ "$IS_WINDOWS" == "true" ]]; then
+                echo "/etc/wsl.conf"
+            else
+                echo ""
+            fi
+            ;;
+        *) echo "" ;;
+    esac
+}
+
+get_validation_func() {
+    local config_file="$1"
+    case "$config_file" in
+        "shell/zsh/.zshrc") echo "validate_shell_zsh" ;;
+        "ide/vscode/settings.json") echo "validate_json" ;;
+        "ide/vscode/keybindings.json") echo "validate_json" ;;
+        "ide/vscode/insiders/settings.json") echo "validate_json" ;;
+        "ide/vscode/insiders/keybindings.json") echo "validate_json" ;;
+        "ide/cursor/settings.json") echo "validate_json" ;;
+        "ide/cursor/keybindings.json") echo "validate_json" ;;
+        "ide/cursor/mcp.json") echo "validate_json" ;;
+        "gh/config.yml") echo "validate_yaml" ;;
+        "gh/hosts.yml") echo "validate_yaml" ;;
+        "iterm/com.googlecode.iterm2.plist") echo "validate_plist" ;;
+        "wezterm/wezterm.lua") echo "" ;;
+        "ghostty/config") echo "" ;;
+        "shell/powershell/Microsoft.PowerShell_profile.ps1") echo "" ;;
+        "ide/vscode/vscode/extensions.txt") echo "" ;;
+        "apps/RectangleConfig.plist") echo "validate_plist" ;;
+        "apps/iStat Menus Settings.ismp7") echo "validate_plist" ;;
+        "apps/Synergy") echo "" ;;
+        "docker/mcp/registry.yaml") echo "validate_yaml" ;;
+        "docker/mcp/catalog.json") echo "validate_json" ;;
+        "docker/mcp/config.yaml") echo "validate_yaml" ;;
+        "docker/mcp/tools.yaml") echo "validate_yaml" ;;
+        "docker/mcp/catalogs/docker-mcp.yaml") echo "validate_yaml" ;;
+        "docker/cli/daemon.json") echo "validate_json" ;;
+        "docker/cli/features.json") echo "validate_json" ;;
+        "scripts/mcp/mcp-launcher.sh") echo "validate_shell_zsh" ;;
+        "scripts/mcp/mcp-launcher.ps1") echo "" ;;
+        # Claude Code configs
+        "claude/settings.json") echo "validate_json" ;;
+        "claude/settings.local.json") echo "validate_json" ;;
+        "claude/hooks.json") echo "validate_json" ;;
+        "claude/statusline-command.sh") echo "validate_shell_zsh" ;;
+        "claude/CLAUDE.md") echo "" ;;
+        "claude/desktop/claude_desktop_config.json") echo "validate_json" ;;
+        "wsl/.wslconfig") echo "" ;;
+        "wsl/wsl.conf") echo "" ;;
+        *) echo "" ;;
+    esac
+}
+
+# Wrapper functions for shell validation
+validate_shell_zsh() { validate_shell "$1" "zsh"; }
+
+# Transform MCP config from Mac to Windows format
+transform_mcp_mac_to_windows() {
+    local input_file="$1"
+    local output_file="$2"
+    local windows_user="${WINDOWS_USER:-$USER}"
+    local windows_config_dir="C:\\\\Users\\\\${windows_user}\\\\Dropbox\\\\mikpc\\\\dev\\\\configs"
+    local windows_home="C:\\\\Users\\\\${windows_user}"
+    local windows_npx_cmd=""
+
+    # On Windows, Cursor spawns MCP servers directly (not via PowerShell),
+    # so relying on PATH/PATHEXT for `npx` can be flaky. Prefer an absolute npx.cmd.
+    if [[ -f "/mnt/c/Program Files/nodejs/npx.cmd" ]]; then
+        windows_npx_cmd="C:\\Program Files\\nodejs\\npx.cmd"
+    elif [[ -f "/mnt/c/Users/${windows_user}/AppData/Roaming/npm/npx.cmd" ]]; then
+        windows_npx_cmd="C:\\Users\\${windows_user}\\AppData\\Roaming\\npm\\npx.cmd"
+    fi
+
+    # Use jq to transform the JSON
+    if command -v jq >/dev/null 2>&1; then
+        jq --arg win_dir "$windows_config_dir" --arg win_user "$windows_user" --arg win_home "$windows_home" --arg win_npx "$windows_npx_cmd" '
+            .mcpServers |= with_entries(
+                .value |= (
+                    # Transform filesystem and git paths
+                    if .args then
+                        .args = (.args | map(
+                            if type == "string" then
+                                if . == "/Users/mikl/Dropbox/dev" or (test("^\\$\\{userHome\\}/Dropbox/dev$")) then
+                                    "C:\\\\Users\\\\\($win_user)\\\\Dropbox\\\\mikpc\\\\dev"
+                                elif . == "/Users/mikl/Dropbox/dev/configs" or (test("^\\$\\{userHome\\}/Dropbox/dev/configs$")) then
+                                    $win_dir
+                                elif startswith("/Users/mikl/Dropbox/dev/configs/scripts/mcp/") then
+                                    $win_dir + "\\\\scripts\\\\mcp\\\\" + (. | split("/") | .[-1] | sub("\\.sh$"; ".ps1"))
+                                elif test("^\\$\\{userHome\\}/Dropbox/dev/configs/scripts/mcp/") then
+                                    $win_dir + "\\\\scripts\\\\mcp\\\\" + (. | split("/") | .[-1] | sub("\\.sh$"; ".ps1"))
+                                elif contains("${userHome}") then
+                                    gsub("\\$\\{userHome\\}"; $win_home) | gsub("/"; "\\\\")
+                                else
+                                    .
+                                end
+                            else
+                                .
+                            end
+                        ))
+                    else
+                        .
+                    end |
+                    # Transform wrapper script commands
+                    if .command then
+                        if (.command | endswith("mcp-launcher.sh")) then
+                            # Launcher: preserve wrapper arg, translate launcher + wrapper to ps1
+                            .command as $orig_cmd
+                            | (.args // []) as $orig_args
+                            | .command = "powershell"
+                            | .args = (
+                                [
+                                  "-ExecutionPolicy",
+                                  "Bypass",
+                                  "-File",
+                                  (
+                                    $orig_cmd
+                                    | sub("\\.sh$"; ".ps1")
+                                    | sub("/Users/mikl/Dropbox/dev/configs"; $win_dir)
+                                    | gsub("^\\$\\{userHome\\}/Dropbox/dev/configs"; $win_dir)
+                                    | gsub("\\$\\{userHome\\}"; $win_home)
+                                    | gsub("/"; "\\\\")
+                                  )
+                                ]
+                                + ($orig_args | map(
+                                    if type == "string" then
+                                        sub("\\.sh$"; ".ps1")
+                                    else
+                                        .
+                                    end
+                                ))
+                              )
+                        elif .command | test("\\.sh$") then
+                            .command as $orig_cmd |
+                            .command = "powershell" |
+                            .args = ["-ExecutionPolicy", "Bypass", "-File", ($orig_cmd | sub("\\.sh$"; ".ps1") | sub("/Users/mikl/Dropbox/dev/configs"; $win_dir) | gsub("/"; "\\\\"))]
+                        elif .command | startswith("/Users/mikl/Dropbox/dev/configs/scripts/mcp/") then
+                            .command as $orig_cmd |
+                            .command = "powershell" |
+                            .args = ["-ExecutionPolicy", "Bypass", "-File", ($orig_cmd | sub("/Users/mikl/Dropbox/dev/configs"; $win_dir) | gsub("/"; "\\\\") | sub("\\.sh$"; ".ps1"))]
+                        elif ($win_npx != "" and .command == "npx") then
+                            .command = $win_npx
+                        else
+                            .
+                        end
+                    else
+                        .
+                    end
+                )
+            )
+        ' "$input_file" > "$output_file"
+    else
+        # Fallback: simple sed-based transformation (less reliable)
+        warn "jq not available, using sed for MCP transformation (may be less accurate)"
+        sed -e "s|/Users/mikl/Dropbox/dev|C:\\\\\\\\Users\\\\\\\\${windows_user}\\\\\\\\Dropbox\\\\\\\\mikpc\\\\\\\\dev|g" \
+            -e "s|/Users/mikl/Dropbox/dev/configs|${windows_config_dir}|g" \
+            -e "s|\\.sh|.ps1|g" \
+            -e "s|\"command\": \"/[^\"]*mcp/[^\"]*\\.ps1\"|\"command\": \"powershell\", \"args\": [\"-ExecutionPolicy\", \"Bypass\", \"-File\", \"&\"|g" \
+            "$input_file" > "$output_file"
+    fi
+}
+
+# Transform Cursor settings from Mac to Windows format
+transform_cursor_settings_mac_to_windows() {
+    local input_file="$1"
+    local output_file="$2"
+    local windows_user="${WINDOWS_USER:-$USER}"
+
+    # Best-practice approach:
+    # - Keep the repo settings as Mac-first source of truth.
+    # - On Windows, strip Mac-only keys/values to avoid breaking Cursor UI/theme.
+    #
+    # We intentionally avoid "translating" most paths, because Windows layouts and
+    # installed locations vary. Cursor/VS Code will usually pick correct defaults.
+    if command -v jq >/dev/null 2>&1; then
+        jq '
+            # Remove obviously Mac-only keys (keep theme/editor behavior intact)
+            del(
+              .["terminal.integrated.env.osx"],
+              .["terminal.external.osxExec"],
+              .["terminal.integrated.defaultProfile.osx"],
+              .["git.path"],
+              .["sonarlint.pathToNodeExecutable"]
+            )
+            |
+            # Drop Parallels-specific settings (Mac-only)
+            with_entries(select(.key | test("^parallels-desktop\\.") | not))
+            |
+            # Drop any remaining macOS-scoped keys (e.g. *.osx)
+            with_entries(select(.key | test("(\\.|^)osx($|\\.)") | not))
+            |
+            # Drop string values that are Mac paths (avoid breaking Windows UI/features)
+            with_entries(
+              select(
+                (.value | type) != "string"
+                or
+                ((.value | test("^(\\/Users\\/|\\/opt\\/homebrew\\/|\\/Library\\/|\\$HOME\\/Library\\/)") ) | not)
+              )
+            )
+        ' "$input_file" > "$output_file"
+    else
+        warn "jq not available; copying Cursor settings without transformation"
+        cp "$input_file" "$output_file"
+    fi
+}
+
+# Transform MCP config from Windows to Mac format
+transform_mcp_windows_to_mac() {
+    local input_file="$1"
+    local output_file="$2"
+    local mac_user="${USER}"
+    local mac_config_dir="/Users/${mac_user}/Dropbox/dev/configs"
+
+    # Use jq to transform the JSON
+    if command -v jq >/dev/null 2>&1; then
+        jq --arg mac_dir "$mac_config_dir" --arg mac_user "$mac_user" '
+            .mcpServers |= with_entries(
+                .value |= (
+                    # Transform PowerShell commands back to shell scripts
+                    if .command == "powershell" and (.args | length > 0) and (.args[-1] | test("\\.ps1$")) then
+                        .command = (.args[-1] | sub("\\.ps1$"; ".sh") | sub("C:\\\\\\\\Users\\\\\\\\[^\\\\\\\\]+\\\\\\\\Dropbox\\\\\\\\mikpc\\\\\\\\dev\\\\\\\\configs"; $mac_dir) | gsub("\\\\"; "/"))
+                        | .args = []
+                    else
+                        .
+                    end |
+                    # Transform Windows paths back to Mac paths
+                    if .args then
+                        .args = (.args | map(
+                            if type == "string" then
+                                if test("C:\\\\\\\\Users\\\\\\\\[^\\\\\\\\]+\\\\\\\\Dropbox\\\\\\\\mikpc\\\\\\\\dev$") then
+                                    "/Users/\($mac_user)/Dropbox/dev"
+                                elif test("C:\\\\\\\\Users\\\\\\\\[^\\\\\\\\]+\\\\\\\\Dropbox\\\\\\\\mikpc\\\\\\\\dev\\\\\\\\configs") then
+                                    $mac_dir
+                                elif test(".*\\\\\\\\scripts\\\\\\\\mcp\\\\\\\\.*\\.ps1$") then
+                                    (. | gsub("\\\\"; "/") | sub("C:/Users/[^/]+/Dropbox/mikpc/dev/configs"; $mac_dir) | sub("\\.ps1$"; ".sh"))
+                                else
+                                    .
+                                end
+                            else
+                                .
+                            end
+                        ))
+                    else
+                        .
+                    end
+                )
+            )
+        ' "$input_file" > "$output_file"
+    else
+        # Fallback: simple sed-based transformation
+        warn "jq not available, using sed for MCP transformation (may be less accurate)"
+        sed -e "s|C:\\\\\\\\Users\\\\\\\\[^\\\\\\\\]*\\\\\\\\Dropbox\\\\\\\\mikpc\\\\\\\\dev|/Users/${mac_user}/Dropbox/dev|g" \
+            -e "s|C:\\\\\\\\Users\\\\\\\\[^\\\\\\\\]*\\\\\\\\Dropbox\\\\\\\\mikpc\\\\\\\\dev\\\\\\\\configs|${mac_config_dir}|g" \
+            -e "s|\\.ps1|.sh|g" \
+            -e "s|\"command\": \"powershell\",|\"command\":|g" \
+            -e "s|\"args\": \[\"-ExecutionPolicy\", \"Bypass\", \"-File\", \"\([^\"]*\)\"\]|\"args\": []|g" \
+            -e "s|\"command\": \"\([^\"]*\)\"|&|g" \
+            "$input_file" > "$output_file"
+    fi
+}
+
+
+# Get all configuration files (filtering Mac-only on Windows)
+get_all_configs() {
+    # Use zsh array for better performance and maintainability
+    local configs=(
+        "shell/zsh/.zshrc"
+        "git/config/base.gitconfig"
+        "git/config/chiefmikey.gitconfig"
+        "git/config/$(get_git_config)"
+        "ide/vscode/settings.json"
+        "ide/vscode/keybindings.json"
+        "ide/vscode/insiders/settings.json"
+        "ide/vscode/insiders/keybindings.json"
+        "ide/cursor/settings.json"
+        "ide/cursor/keybindings.json"
+        "gh/config.yml"
+        "gh/hosts.yml"
+        "ssh/$(get_ssh_config)"
+        "ssh/personal_signing.pub"
+        "ide/vscode/vscode/extensions.txt"
+    )
+
+    # MCP config (transformed on Windows)
+    configs+=("ide/cursor/mcp.json")
+
+    # MCP launcher (installed to stable per-user path)
+    configs+=("scripts/mcp/mcp-launcher.sh")
+    configs+=("scripts/mcp/mcp-launcher.ps1")
+
+    # Docker configs (cross-platform)
+    configs+=(
+        "docker/mcp/registry.yaml"
+        "docker/mcp/catalog.json"
+        "docker/mcp/config.yaml"
+        "docker/mcp/tools.yaml"
+        "docker/mcp/catalogs/docker-mcp.yaml"
+        "docker/cli/daemon.json"
+        "docker/cli/features.json"
+    )
+
+    # Mac-only configs
+    if [[ "$IS_MAC" == "true" ]]; then
+        configs+=(
+            "iterm/com.googlecode.iterm2.plist"
+            "apps/RectangleConfig.plist"
+            "apps/iStat Menus Settings.ismp7"
+        )
+    fi
+
+    # WezTerm (cross-platform terminal)
+    configs+=("wezterm/wezterm.lua")
+
+    # Ghostty (Mac/Linux terminal)
+    configs+=("ghostty/config")
+
+    # PowerShell profile (Windows only — debug helpers)
+    configs+=("shell/powershell/Microsoft.PowerShell_profile.ps1")
+
+    # Synergy works on both platforms
+    configs+=("apps/Synergy")
+
+    # Claude Code configs (cross-platform)
+    configs+=(
+        "claude/settings.json"
+        "claude/settings.local.json"
+        "claude/hooks.json"
+        "claude/statusline-command.sh"
+        "claude/CLAUDE.md"
+    )
+
+    # Claude Desktop (Mac only)
+    if [[ "$IS_MAC" == "true" ]]; then
+        configs+=("claude/desktop/claude_desktop_config.json")
+    fi
+
+    # WSL configs (Windows only)
+    if [[ "$IS_WINDOWS" == "true" ]]; then
+        configs+=(
+            "wsl/.wslconfig"
+            "wsl/wsl.conf"
+        )
+    fi
+
+    # Print array elements (zsh automatically handles this)
+    print -l $configs
+}
+
+# Get destination path for a config file
+get_dest_path() {
+    get_config_dest "$1"
+}