Add comprehensive documentation, E2E tests, and CI/CD workflow

- Add JSDoc enforcement and comprehensive docstrings across Python and JavaScript
- Implement Playwright E2E test suite for UI validation
- Add GitHub Actions CI workflow for cross-platform testing
- Add full autolog support for PyTorch Lightning and TensorFlow/Keras
- Reorganize examples into core, ml_frameworks, and domain_specific categories
- Consolidate config files and improve documentation structure
- Remove unique constraint on run names for better usability
- Update README with improved problem statement and ecosystem comparison

Author: walkerbdev

.depcheckrc.json

@@ -0,0 +1,204 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, docs/* ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    name: Test Python ${{ matrix.python-version }} on ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ['3.9', '3.10', '3.11', '3.12']
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Set up Node.js
+      uses: actions/setup-node@v4
+      with:
+        node-version: '20'
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -e '.[dev]'
+
+    - name: Build UI
+      run: npm install && npm run build
+
+    - name: Start Artifacta server (Unix)
+      if: runner.os != 'Windows'
+      run: |
+        mkdir -p data
+        nohup artifacta ui --port 8000 > server.log 2>&1 &
+        echo $! > server.pid
+
+        # Wait for server to be ready
+        echo "Waiting for server to start..."
+        SERVER_READY=false
+        for i in {1..30}; do
+          if curl -s http://localhost:8000/health > /dev/null 2>&1; then
+            echo "✓ Server is ready"
+            SERVER_READY=true
+            break
+          fi
+          echo "Waiting for server... ($i/30)"
+          sleep 1
+        done
+
+        # Fail if server never started
+        if [ "$SERVER_READY" = "false" ]; then
+          echo "✗ Server failed to start after 30 seconds"
+          echo "Server log:"
+          cat server.log
+          exit 1
+        fi
+
+    - name: Start Artifacta server (Windows)
+      if: runner.os == 'Windows'
+      shell: pwsh
+      run: |
+        if (-not (Test-Path data)) { New-Item -ItemType Directory -Path data }
+        $process = Start-Process python -ArgumentList "-m","tracking_server.cli","ui","--port","8000" -PassThru -WindowStyle Hidden
+        Start-Sleep -Seconds 2
+
+        # Health check with retries
+        $maxAttempts = 5
+        $attempt = 0
+        $success = $false
+        while ($attempt -lt $maxAttempts -and -not $success) {
+          try {
+            $response = Invoke-WebRequest -Uri "http://127.0.0.1:8000/health" -UseBasicParsing -TimeoutSec 2
+            if ($response.StatusCode -eq 200) {
+              $success = $true
+              Write-Host "Server is ready"
+            }
+          } catch {
+            $attempt++
+            if ($attempt -lt $maxAttempts) {
+              Start-Sleep -Seconds 3
+            }
+          }
+        }
+
+        if (-not $success) {
+          Write-Host "Server failed to start after $maxAttempts attempts"
+          exit 1
+        }
+
+    - name: Run pytest
+      run: pytest tests/ -v --tb=short
+      env:
+        TRACKING_SERVER_HOST: ${{ runner.os == 'Windows' && '127.0.0.1' || 'localhost' }}
+
+    - name: Stop Artifacta server (Unix)
+      if: always() && runner.os != 'Windows'
+      run: |
+        if [ -f server.pid ]; then
+          kill $(cat server.pid) || true
+          rm server.pid
+        fi
+
+    - name: Stop Artifacta server (Windows)
+      if: always() && runner.os == 'Windows'
+      shell: pwsh
+      run: |
+        Get-Process python -ErrorAction SilentlyContinue | Where-Object { $_.CommandLine -like '*tracking_server*' } | Stop-Process -Force -ErrorAction SilentlyContinue
+        Write-Host "Server cleanup completed"
+
+  e2e:
+    name: E2E Tests on ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python 3.11
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'
+
+    - name: Set up Node.js
+      uses: actions/setup-node@v4
+      with:
+        node-version: '20'
+
+    - name: Install Python dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -e '.[dev]'
+
+    - name: Install Node dependencies and build UI
+      run: npm install && npm run build
+
+    - name: Install Playwright browsers
+      run: npx playwright install --with-deps chromium
+
+    - name: Run E2E tests
+      run: npm run test:e2e
+      env:
+        ARTIFACTA_URL: ${{ runner.os == 'Windows' && 'http://127.0.0.1:8000' || 'http://localhost:8000' }}
+
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python 3.11
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -e '.[dev]'
+
+    - name: Run ruff
+      run: ruff check . --fix
+
+    - name: Run mypy
+      run: mypy --ignore-missing-imports tracking-server
+
+  build:
+    name: Build Package
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python 3.11
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.11'
+
+    - name: Install build tools
+      run: |
+        python -m pip install --upgrade pip
+        pip install build
+
+    - name: Build package
+      run: python -m build
+
+    - name: Upload artifacts
+      uses: actions/upload-artifact@v4
+      with:
+        name: dist
+        path: dist/

.github/workflows/ci.yml

@@ -63,3 +63,8 @@ logs/
 docs/_build/
 docs/_static/
 docs/_templates/
+
+# Playwright test outputs
+test-results/
+playwright-report/
+playwright/.cache/

.gitignore

@@ -29,16 +29,19 @@ repos:
           - --convention=google
         files: ^(artifacta|tracking-server)/
 
-  # ESLint - JavaScript/React linter
+  # ESLint - JavaScript/React linter with JSDoc enforcement
   - repo: https://github.com/pre-commit/mirrors-eslint
     rev: v9.17.0
     hooks:
       - id: eslint
         files: \.[jt]sx?$
         types: [file]
+        args: [--config, config/eslint.config.js]
         additional_dependencies:
           - eslint@9.17.0
           - eslint-plugin-react@7.37.2
+          - eslint-plugin-react-hooks@5.1.0
+          - eslint-plugin-jsdoc@50.6.1
 
   # Knip - Find unused files, exports, and dependencies (JavaScript/TypeScript)
   - repo: local
@@ -51,7 +54,7 @@ repos:
         files: \.[jt]sx?$
       - id: depcheck
         name: depcheck - unused npm dependencies
-        entry: npx depcheck --ignore-dirs=dist,node_modules,.git
+        entry: npx depcheck
         language: system
         pass_filenames: false
         files: package\.json

.pre-commit-config.yaml

@@ -3,7 +3,7 @@
 
 ## Our Pledge
 
-We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, caste, color, religion, or sexual identity and orientation.
+We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socioeconomic status, nationality, personal appearance, race, caste, color, religion, or sexual identity and orientation.
 
 We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community.
 
@@ -82,4 +82,3 @@ For answers to common questions about this code of conduct, see the FAQ at [http
 [Mozilla CoC]: https://github.com/mozilla/diversity
 [FAQ]: https://www.contributor-covenant.org/faq
 [translations]: https://www.contributor-covenant.org/translations
-

CODE_OF_CONDUCT.md

@@ -1,6 +1,6 @@
 # Contributing to Artifacta
 
-Thank you for your interest in contributing to Artifacta! 🎉
+Thank you for your interest in contributing to Artifacta!
 
 ## How to Contribute