Documentation Theme Updates: Vim-style Dark Mode Enhancements

.github/dependabot.yml

@@ -0,0 +1,24 @@
+version: 2
+updates:
+  # Enable version updates for Python dependencies
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    commit-message:
+      prefix: "deps"
+      include: "scope"
+    reviewers:
+      - "knowlen"  # Replace with your GitHub username
+    assignees:
+      - "knowlen"  # Replace with your GitHub username
+    open-pull-requests-limit: 5
+
+  # Enable version updates for GitHub Actions
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    commit-message:
+      prefix: "ci"
+      include: "scope"

.github/workflows/ci.yml

@@ -0,0 +1,192 @@
+name: CI/CD Pipeline
+
+on:
+  # Run on PR creation and updates, but with conditions to reduce waste
+  pull_request:
+    types: [opened, synchronize]
+    branches: [ main, v2-dev ]
+  # Allow manual triggering from GitHub UI
+  workflow_dispatch:
+    inputs:
+      run_integration_tests:
+        description: 'Run integration tests'
+        required: false
+        default: 'true'
+        type: boolean
+  # Still run on pushes to main/v2-dev (for releases)
+  push:
+    branches: [ main, v2-dev ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12"]
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v4
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Cache pip packages
+      uses: actions/cache@v3
+      with:
+        path: ~/.cache/pip
+        key: ${{ runner.os }}-pip-${{ hashFiles('**/pyproject.toml') }}
+        restore-keys: |
+          ${{ runner.os }}-pip-
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -e ".[dev]"
+
+    - name: Verify installation
+      run: |
+        pip list
+        python -c "import esologs; print('Package imported successfully')"
+
+    - name: Run pre-commit checks
+      run: |
+        pre-commit run --all-files
+
+    - name: Run unit tests
+      run: |
+        echo "Starting unit tests..."
+        pytest tests/unit/ -v --cov=esologs --cov-report=xml --cov-report=term
+
+    - name: Check secrets availability
+      env:
+        ESOLOGS_ID: ${{ secrets.ESOLOGS_ID }}
+        ESOLOGS_SECRET: ${{ secrets.ESOLOGS_SECRET }}
+      run: |
+        if [ -z "$ESOLOGS_ID" ]; then
+          echo "WARNING: ESOLOGS_ID secret not set"
+        else
+          echo "ESOLOGS_ID secret is available"
+        fi
+        if [ -z "$ESOLOGS_SECRET" ]; then
+          echo "WARNING: ESOLOGS_SECRET secret not set"
+        else
+          echo "ESOLOGS_SECRET secret is available"
+        fi
+
+    - name: Run integration tests
+      if: github.event_name != 'workflow_dispatch' || inputs.run_integration_tests == 'true'
+      env:
+        ESOLOGS_ID: ${{ secrets.ESOLOGS_ID }}
+        ESOLOGS_SECRET: ${{ secrets.ESOLOGS_SECRET }}
+      run: |
+        echo "Starting integration tests..."
+        pytest tests/integration/ -v --tb=short
+
+    - name: Run sanity tests
+      if: github.event_name != 'workflow_dispatch' || inputs.run_integration_tests == 'true'
+      env:
+        ESOLOGS_ID: ${{ secrets.ESOLOGS_ID }}
+        ESOLOGS_SECRET: ${{ secrets.ESOLOGS_SECRET }}
+      run: |
+        echo "Starting sanity tests..."
+        pytest tests/sanity/ -v --tb=short
+
+    - name: Upload coverage to Codecov
+      if: matrix.python-version == '3.11'
+      uses: codecov/codecov-action@v3
+      with:
+        file: ./coverage.xml
+        flags: unittests
+        name: codecov-umbrella
+
+  security:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: "3.11"
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install bandit safety
+
+    - name: Run security checks
+      run: |
+        echo "Running bandit security scan..."
+        bandit -r esologs/ -f json -o bandit-report.json || echo "Bandit completed with warnings"
+        echo "Running safety dependency check..."
+        safety check --json --output safety-report.json || echo "Safety completed with warnings"
+        ls -la *.json
+
+    - name: Upload security reports
+      if: always()
+      uses: actions/upload-artifact@v4
+      with:
+        name: security-reports
+        path: |
+          bandit-report.json
+          safety-report.json
+
+  build:
+    runs-on: ubuntu-latest
+    needs: [test, security]
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: "3.11"
+
+    - name: Install build dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install build twine
+
+    - name: Build package
+      run: |
+        python -m build
+
+    - name: Check package
+      run: |
+        twine check dist/*
+
+    - name: Upload build artifacts
+      uses: actions/upload-artifact@v4
+      with:
+        name: dist
+        path: dist/
+
+  docs:
+    runs-on: ubuntu-latest
+    if: github.ref == 'refs/heads/main'
+    needs: [test]
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: "3.11"
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -e ".[dev]"
+        pip install sphinx sphinx-rtd-theme
+
+    - name: Build documentation
+      run: |
+        # Add documentation build commands here when ready
+        echo "Documentation build placeholder"
+
+    - name: Deploy to GitHub Pages
+      if: success()
+      run: |
+        echo "Documentation deployment placeholder"

.github/workflows/claude-code-review.yml

@@ -1,8 +1,11 @@
 name: Claude Code Review
 
 on:
+  # Run on PR creation, skip on drafts and minor updates
   pull_request:
     types: [opened, synchronize]
+  # Allow manual triggering from GitHub UI
+  workflow_dispatch:
     # Optional: Only run on specific file changes
     # paths:
     #   - "src/**/*.ts"
@@ -12,19 +15,21 @@ on:
 
 jobs:
   claude-review:
+    # Skip Claude review on synchronize unless specifically requested
+    if: github.event.action == 'opened' || contains(github.event.head_commit.message, '[review]')
     # Optional: Filter by PR author
     # if: |
     #   github.event.pull_request.user.login == 'external-contributor' ||
     #   github.event.pull_request.user.login == 'new-developer' ||
     #   github.event.pull_request.author_association == 'FIRST_TIME_CONTRIBUTOR'
-    
+
     runs-on: ubuntu-latest
     permissions:
       contents: read
       pull-requests: read
       issues: read
       id-token: write
-    
+
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
@@ -39,7 +44,7 @@ jobs:
 
           # Optional: Specify model (defaults to Claude Sonnet 4, uncomment for Claude Opus 4)
           # model: "claude-opus-4-20250514"
-          
+
           # Direct prompt for automated review (no @claude mention needed)
           direct_prompt: |
             Please review this pull request and provide feedback on:
@@ -48,31 +53,30 @@ jobs:
             - Performance considerations
             - Security concerns
             - Test coverage
-            
+
             Be constructive and helpful in your feedback.
 
           # Optional: Use sticky comments to make Claude reuse the same comment on subsequent pushes to the same PR
           # use_sticky_comment: true
-          
+
           # Optional: Customize review based on file types
           # direct_prompt: |
           #   Review this PR focusing on:
           #   - For TypeScript files: Type safety and proper interface usage
           #   - For API endpoints: Security, input validation, and error handling
           #   - For React components: Performance, accessibility, and best practices
           #   - For tests: Coverage, edge cases, and test quality
-          
+
           # Optional: Different prompts for different authors
           # direct_prompt: |
-          #   ${{ github.event.pull_request.author_association == 'FIRST_TIME_CONTRIBUTOR' && 
+          #   ${{ github.event.pull_request.author_association == 'FIRST_TIME_CONTRIBUTOR' &&
           #   'Welcome! Please review this PR from a first-time contributor. Be encouraging and provide detailed explanations for any suggestions.' ||
           #   'Please provide a thorough code review focusing on our coding standards and best practices.' }}
-          
+
           # Optional: Add specific tools for running tests or linting
           # allowed_tools: "Bash(npm run test),Bash(npm run lint),Bash(npm run typecheck)"
-          
+
           # Optional: Skip review for certain conditions
           # if: |
           #   !contains(github.event.pull_request.title, '[skip-review]') &&
           #   !contains(github.event.pull_request.title, '[WIP]')
-

.github/workflows/claude.yml

@@ -39,26 +39,25 @@ jobs:
           # This is an optional setting that allows Claude to read CI results on PRs
           additional_permissions: |
             actions: read
-          
+
           # Optional: Specify model (defaults to Claude Sonnet 4, uncomment for Claude Opus 4)
           # model: "claude-opus-4-20250514"
-          
+
           # Optional: Customize the trigger phrase (default: @claude)
           # trigger_phrase: "/claude"
-          
+
           # Optional: Trigger when specific user is assigned to an issue
           # assignee_trigger: "claude-bot"
-          
+
           # Optional: Allow Claude to run specific commands
           # allowed_tools: "Bash(npm install),Bash(npm run build),Bash(npm run test:*),Bash(npm run lint:*)"
-          
+
           # Optional: Add custom instructions for Claude to customize its behavior for your project
           # custom_instructions: |
           #   Follow our coding standards
           #   Ensure all new code has tests
           #   Use TypeScript for new files
-          
+
           # Optional: Custom environment variables for Claude
           # claude_env: |
           #   NODE_ENV: test
-

.github/workflows/optimize-images.yml

@@ -0,0 +1,52 @@
+name: Optimize Images
+
+on:
+  pull_request:
+    paths:
+      - '**.png'
+      - '**.jpg'
+      - '**.jpeg'
+      - 'docs/assets/**'
+
+jobs:
+  optimize:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Install optimization tools
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y pngquant optipng jpegoptim webp
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.10'
+
+      - name: Install Python dependencies
+        run: |
+          pip install pillow
+
+      - name: Optimize images
+        run: |
+          python scripts/optimize_images.py
+
+      - name: Check if images were optimized
+        id: check_changes
+        run: |
+          if [[ -n $(git status --porcelain) ]]; then
+            echo "changes=true" >> $GITHUB_OUTPUT
+          else
+            echo "changes=false" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Commit optimized images
+        if: steps.check_changes.outputs.changes == 'true'
+        uses: EndBug/add-and-commit@v9
+        with:
+          message: 'Optimize images [skip ci]'
+          add: '*.png *.jpg *.jpeg *.webp'
+          committer_name: 'GitHub Actions'
+          committer_email: 'actions@github.com'