fss-link 1.5.7 → 1.6.0

package/scripts/install-macos.sh

@@ -0,0 +1,343 @@
+#!/bin/bash
+
+# FSS Link macOS Installation Script
+# Supports macOS 10.15+ with Homebrew integration
+
+set -e  # Exit on any error
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Logging functions
+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"
+}
+
+# Check macOS version
+check_macos_version() {
+    MACOS_VERSION=$(sw_vers -productVersion)
+    MAJOR_VERSION=$(echo $MACOS_VERSION | cut -d. -f1)
+    MINOR_VERSION=$(echo $MACOS_VERSION | cut -d. -f2)
+    
+    log_info "macOS version: $MACOS_VERSION"
+    
+    # Check for macOS 10.15+ (Catalina and later)
+    if [ "$MAJOR_VERSION" -ge "11" ] || ([ "$MAJOR_VERSION" -eq "10" ] && [ "$MINOR_VERSION" -ge "15" ]); then
+        log_success "macOS version supported"
+        return 0
+    else
+        log_error "macOS 10.15+ required, found $MACOS_VERSION"
+        return 1
+    fi
+}
+
+# Check for Xcode Command Line Tools
+check_xcode_tools() {
+    log_info "Checking Xcode Command Line Tools..."
+    
+    if xcode-select -p &> /dev/null; then
+        log_success "Xcode Command Line Tools installed"
+        return 0
+    else
+        log_warning "Xcode Command Line Tools not found"
+        return 1
+    fi
+}
+
+# Install Xcode Command Line Tools
+install_xcode_tools() {
+    log_info "Installing Xcode Command Line Tools..."
+    
+    # Trigger installation
+    xcode-select --install
+    
+    log_info "Please complete the Xcode Command Line Tools installation in the dialog box"
+    log_info "Press Enter when installation is complete..."
+    read -r
+    
+    if check_xcode_tools; then
+        log_success "Xcode Command Line Tools installed successfully"
+    else
+        log_error "Xcode Command Line Tools installation failed"
+        exit 1
+    fi
+}
+
+# Check for Homebrew
+check_homebrew() {
+    log_info "Checking for Homebrew..."
+    
+    if command -v brew &> /dev/null; then
+        BREW_VERSION=$(brew --version | head -n1)
+        log_success "$BREW_VERSION found"
+        return 0
+    else
+        log_warning "Homebrew not found"
+        return 1
+    fi
+}
+
+# Install Homebrew
+install_homebrew() {
+    log_info "Installing Homebrew..."
+    
+    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+    
+    # Add Homebrew to PATH
+    if [[ -f "/opt/homebrew/bin/brew" ]]; then
+        # Apple Silicon
+        echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
+        eval "$(/opt/homebrew/bin/brew shellenv)"
+    else
+        # Intel
+        echo 'eval "$(/usr/local/bin/brew shellenv)"' >> ~/.zprofile
+        eval "$(/usr/local/bin/brew shellenv)"
+    fi
+    
+    if check_homebrew; then
+        log_success "Homebrew installed successfully"
+    else
+        log_error "Homebrew installation failed"
+        exit 1
+    fi
+}
+
+# Check Node.js version
+check_nodejs() {
+    log_info "Checking Node.js installation..."
+    
+    if command -v node &> /dev/null; then
+        NODE_VERSION=$(node --version | sed 's/v//')
+        MAJOR_VERSION=$(echo $NODE_VERSION | cut -d. -f1)
+        
+        if [ "$MAJOR_VERSION" -ge "20" ]; then
+            log_success "Node.js $NODE_VERSION detected (>= 20.0.0 required)"
+            return 0
+        else
+            log_warning "Node.js $NODE_VERSION detected, but 20.0.0+ required"
+            return 1
+        fi
+    else
+        log_warning "Node.js not found"
+        return 1
+    fi
+}
+
+# Install Node.js via Homebrew
+install_nodejs() {
+    log_info "Installing Node.js 20 via Homebrew..."
+    
+    brew install node@20
+    
+    # Link Node.js 20 if it's not the default
+    if ! check_nodejs; then
+        brew link node@20 --force
+    fi
+    
+    if check_nodejs; then
+        log_success "Node.js installed successfully"
+    else
+        log_error "Node.js installation failed"
+        exit 1
+    fi
+}
+
+# Install additional dependencies
+install_dependencies() {
+    log_info "Installing additional dependencies..."
+    
+    # Install SQLite (usually already installed on macOS)
+    if ! command -v sqlite3 &> /dev/null; then
+        brew install sqlite
+    fi
+    
+    # Install Python 3 (usually already installed on modern macOS)
+    if ! command -v python3 &> /dev/null; then
+        brew install python@3.11
+    fi
+    
+    log_success "Dependencies installed"
+}
+
+# Install FSS Link
+install_fss_link() {
+    log_info "Installing FSS Link..."
+    
+    # Try global installation
+    if npm install -g fss-link; then
+        log_success "FSS Link installed globally"
+        return 0
+    else
+        log_warning "Global installation failed, trying local installation"
+        
+        # Create local npm directory
+        mkdir -p ~/.npm-global
+        npm config set prefix ~/.npm-global
+        
+        # Add to PATH if not already there
+        if [[ ":$PATH:" != *":$HOME/.npm-global/bin:"* ]]; then
+            echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
+            echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bash_profile 2>/dev/null || true
+            export PATH=~/.npm-global/bin:$PATH
+        fi
+        
+        # Install locally
+        npm install -g fss-link
+        log_success "FSS Link installed locally"
+    fi
+}
+
+# Verify installation
+verify_installation() {
+    log_info "Verifying FSS Link installation..."
+    
+    # Source shell config to get new PATH
+    export PATH=~/.npm-global/bin:$PATH
+    
+    if command -v fss-link &> /dev/null; then
+        VERSION=$(fss-link --version 2>/dev/null || echo "unknown")
+        log_success "FSS Link installed successfully: $VERSION"
+        
+        # Run basic tests
+        log_info "Running functionality tests..."
+        
+        if fss-link --help > /dev/null 2>&1; then
+            log_success "✅ Help command working"
+        else
+            log_warning "⚠️ Help command failed"
+        fi
+        
+        if fss-link test-parsers > /dev/null 2>&1; then
+            log_success "✅ Document parsers working"
+        else
+            log_warning "⚠️ Document parsers test failed"
+        fi
+        
+        return 0
+    else
+        log_error "FSS Link installation verification failed"
+        log_info "Try running: source ~/.zshrc && fss-link --version"
+        return 1
+    fi
+}
+
+# Print usage information
+print_usage() {
+    cat << EOF
+
+🚀 FSS Link Installation Complete!
+
+📋 Quick Start:
+  fss-link --version              # Check version
+  fss-link --help                 # Show help
+  fss-link test-parsers           # Test document processing
+  
+🔧 Configuration:
+  fss-link init                   # Initialize configuration
+  fss-link models setup           # Set up model profiles
+
+📚 Documentation:
+  https://github.com/FSSCoding/fss-link/blob/main/INSTALLATION.md
+  https://github.com/FSSCoding/fss-link/blob/main/fss-docs/README.md
+
+🎯 Example Usage:
+  fss-link -p "analyze this project"
+  fss-link --tools excel-parser -p "parse spreadsheet.xlsx"
+  fss-link --tools web-scraper -p "scrape https://example.com"
+
+🍎 macOS Specific:
+  - FSS Link is now in your PATH
+  - Restart Terminal.app to ensure PATH changes take effect
+  - Use 'brew upgrade node@20' to update Node.js later
+
+EOF
+}
+
+# Main installation flow
+main() {
+    echo "🚀 FSS Link macOS Installation Script"
+    echo "====================================="
+    
+    # Check macOS version
+    if ! check_macos_version; then
+        exit 1
+    fi
+    
+    # Check/install Xcode Command Line Tools
+    if ! check_xcode_tools; then
+        install_xcode_tools
+    fi
+    
+    # Check/install Homebrew
+    if ! check_homebrew; then
+        log_info "Installing Homebrew for package management..."
+        install_homebrew
+    fi
+    
+    # Check/install Node.js
+    if ! check_nodejs; then
+        install_nodejs
+    fi
+    
+    # Install additional dependencies
+    install_dependencies
+    
+    # Install FSS Link
+    install_fss_link
+    
+    # Verify installation
+    if verify_installation; then
+        print_usage
+        log_success "🎉 FSS Link installation successful!"
+    else
+        log_error "Installation verification failed"
+        log_info "Please check the installation manually or report issues at:"
+        log_info "https://github.com/FSSCoding/fss-link/issues"
+        exit 1
+    fi
+}
+
+# Handle script arguments
+case "${1:-}" in
+    --help|-h)
+        echo "FSS Link macOS Installation Script"
+        echo ""
+        echo "Usage: $0 [options]"
+        echo ""
+        echo "Options:"
+        echo "  --help, -h     Show this help message"
+        echo "  --version, -v  Show script version"
+        echo ""
+        echo "This script will:"
+        echo "1. Check macOS version compatibility"
+        echo "2. Install Xcode Command Line Tools if needed"
+        echo "3. Install Homebrew if needed"
+        echo "4. Install Node.js 20+ via Homebrew"
+        echo "5. Install FSS Link from npm"
+        echo "6. Verify the installation"
+        exit 0
+        ;;
+    --version|-v)
+        echo "FSS Link macOS Installation Script v1.0.0"
+        exit 0
+        ;;
+    *)
+        main "$@"
+        ;;
+esac