sync.sh

#!/bin/bash

################################################################################
# ONE Platform Documentation Sync Script
#
# This script syncs all documentation sources from their upstream repositories.
# Run this periodically to keep documentation up to date.
#
# Usage:
#   ./sync.sh              # Sync all sources
#   ./sync.sh --dry-run    # Preview changes without applying
#
################################################################################

set -e  # Exit on 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

# Configuration
DOCS_ROOT="/Users/toc/Server/ONE/docs"
LOG_FILE="$DOCS_ROOT/sync.log"
DRY_RUN=false

# Parse arguments
if [[ "$1" == "--dry-run" ]]; then
    DRY_RUN=true
    echo -e "${YELLOW}DRY RUN MODE - No changes will be applied${NC}"
fi

# Function to print section header
print_header() {
    echo ""
    echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
    echo -e "${BLUE}  $1${NC}"
    echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
}

# Function to sync a repository
sync_repo() {
    local repo_name="$1"
    local repo_path="$2"
    local branch="${3:-main}"

    print_header "Syncing $repo_name"

    if [[ ! -d "$repo_path" ]]; then
        echo -e "${RED}✗ Repository not found: $repo_path${NC}"
        return 1
    fi

    cd "$repo_path"

    # Show current status
    echo -e "${YELLOW}Repository:${NC} $repo_name"
    echo -e "${YELLOW}Path:${NC} $repo_path"
    echo -e "${YELLOW}Remote:${NC} $(git remote get-url origin)"

    # Stash any local changes
    if git diff --quiet && git diff --cached --quiet; then
        echo -e "${GREEN}✓ Working directory clean${NC}"
    else
        echo -e "${YELLOW}⚠ Local changes detected, stashing...${NC}"
        if [[ "$DRY_RUN" == false ]]; then
            git stash push -m "Auto-stash before sync $(date +%Y%m%d-%H%M%S)"
        fi
    fi

    # Fetch latest changes
    echo -e "${YELLOW}Fetching latest changes...${NC}"
    if [[ "$DRY_RUN" == false ]]; then
        git fetch origin "$branch"
    fi

    # Show what would change
    local commits_behind=$(git rev-list --count HEAD..origin/"$branch" 2>/dev/null || echo "0")

    if [[ "$commits_behind" -gt 0 ]]; then
        echo -e "${YELLOW}⚠ $commits_behind commits behind upstream${NC}"
        echo -e "${YELLOW}Changes:${NC}"
        git log --oneline HEAD..origin/"$branch" | head -5

        if [[ "$DRY_RUN" == false ]]; then
            echo -e "${YELLOW}Pulling changes...${NC}"
            git pull origin "$branch" --rebase
            echo -e "${GREEN}✓ Successfully synced $repo_name${NC}"
        else
            echo -e "${YELLOW}[DRY RUN] Would pull these changes${NC}"
        fi
    else
        echo -e "${GREEN}✓ Already up to date${NC}"
    fi

    # Return to docs root
    cd "$DOCS_ROOT"
}

# Main sync process
main() {
    print_header "ONE Platform Documentation Sync"
    echo "Started: $(date)"

    # Record start time
    START_TIME=$(date +%s)

    # Sync each documentation source
    sync_repo "Vercel AI SDK" "$DOCS_ROOT/ai-sdk" "main"
    sync_repo "Astro Documentation" "$DOCS_ROOT/astro" "main"
    sync_repo "Convex Backend" "$DOCS_ROOT/convex" "main"
    sync_repo "Effect TypeScript" "$DOCS_ROOT/effectts" "main"

    # Claude Code is maintained directly in this repo, so we don't sync it
    print_header "Claude Code Documentation"
    echo -e "${GREEN}✓ Claude Code docs maintained directly in this repository${NC}"

    # Show summary
    print_header "Sync Summary"

    END_TIME=$(date +%s)
    DURATION=$((END_TIME - START_TIME))

    echo "Completed: $(date)"
    echo "Duration: ${DURATION}s"

    if [[ "$DRY_RUN" == false ]]; then
        # Check if there are changes to commit
        cd "$DOCS_ROOT"

        if git diff --quiet && git diff --cached --quiet; then
            echo -e "${GREEN}✓ No changes to commit${NC}"
        else
            echo -e "${YELLOW}⚠ Changes detected in main docs repository${NC}"
            echo -e "${YELLOW}Run the following to commit:${NC}"
            echo ""
            echo "  cd $DOCS_ROOT"
            echo "  git add -A"
            echo "  git commit -m \"docs: sync upstream documentation sources\""
            echo "  git push origin main"
        fi
    else
        echo -e "${YELLOW}[DRY RUN] No changes were applied${NC}"
    fi

    print_header "Sync Complete"

    # Log to file
    if [[ "$DRY_RUN" == false ]]; then
        echo "Sync completed at $(date)" >> "$LOG_FILE"
    fi
}

# Verify we're in the docs directory
if [[ ! -d "$DOCS_ROOT" ]]; then
    echo -e "${RED}Error: Docs directory not found: $DOCS_ROOT${NC}"
    exit 1
fi

# Run main sync
main

exit 0