feat: add Astro docs site, CLI tooling, and versioning workflow

.changeset/api-improvements.md

@@ -0,0 +1,49 @@
+---
+"api": minor
+---
+
+Add significant API improvements and new features
+
+**Version Management:**
+
+- Version matching system between API and clients
+- Automatic version validation middleware
+- Client version compatibility checking with strict semantic versioning
+- Version information in health endpoint
+- API version exposed via response headers (`X-API-Version`)
+- Version mismatch error handling (HTTP 426)
+
+**Media Scanning:**
+
+- Batch scanning with job tracking and resume capability
+- Scan job status tracking in database (PENDING, IN_PROGRESS, COMPLETED, FAILED, PAUSED)
+- Progress tracking with batch processing
+- Folder-level batch processing for large libraries
+- Improved file detection with configurable regex patterns
+- Media type detection (movies, TV shows, music, comics)
+- Path validation and sanitization
+- Rate limiting for TMDB API calls
+- Timeout handling for long-running scans
+
+**Color Extraction & Mesh Gradients:**
+
+- Automatic color extraction from media posters/backdrops
+- Mesh gradient generation with 4-corner color mapping
+- Color caching in database for performance
+- On-demand color extraction middleware
+- Background color extraction for non-blocking requests
+
+**Logging & Monitoring:**
+
+- Real-time logs streaming with WebSocket support
+- REST endpoints for log retrieval
+- Log filtering by level (error, warn, info, debug)
+- Log file parsing and structured log entries
+- Log clearing functionality
+
+**API Improvements:**
+
+- Unified response structure across all endpoints
+- Enhanced Swagger/OpenAPI documentation
+- Improved error handling and validation
+- Input sanitization middleware

.changeset/publish-cli.md

@@ -0,0 +1,5 @@
+---
+"@desterlib/cli": minor
+---
+
+Initial release of DesterLib CLI tool for easy Docker-based setup and configuration

.github/pull_request_template.md

@@ -50,4 +50,3 @@
 ## Additional Notes
 
 <!-- Any additional information that reviewers should know -->
-

.github/workflows/changeset-check.yml

@@ -1,20 +1,24 @@
-name: Changeset Check
+name: CI
 
 on:
   pull_request:
     branches:
       - main
 
 jobs:
-  changeset-check:
-    name: Check for Changeset
+  ci:
+    name: Validate PR (changesets & versioning)
     runs-on: ubuntu-latest
     steps:
       - name: Checkout Repository
         uses: actions/checkout@v4
         with:
+          # Fetch full history of the current ref so git operations behave like locally
           fetch-depth: 0
 
+      - name: Ensure main branch is available
+        run: git fetch origin main:main
+
       - name: Setup pnpm
         uses: pnpm/action-setup@v4
         with:
@@ -24,7 +28,7 @@ jobs:
         uses: actions/setup-node@v4
         with:
           node-version: 20
-          cache: 'pnpm'
+          cache: "pnpm"
 
       - name: Install Dependencies
         run: pnpm install --frozen-lockfile
@@ -37,18 +41,21 @@ jobs:
             echo "Skipping changeset check for version PR"
             exit 0
           fi
-          
+
           # Skip check for chore commits that don't need changesets
           if [[ "${{ github.head_ref }}" == chore/* ]] || \
              [[ "${{ github.head_ref }}" == docs/* ]] || \
              [[ "${{ github.head_ref }}" == ci/* ]]; then
             echo "Skipping changeset check for chore/docs/ci PR"
             exit 0
           fi
-          
+
           # Check if changesets exist
           pnpm changeset status --since=origin/${{ github.base_ref }}
 
+      - name: Verify Versioning Setup
+        run: pnpm verify:versioning
+
       - name: Comment on PR
         if: failure()
         uses: actions/github-script@v7
@@ -58,6 +65,5 @@ jobs:
               issue_number: context.issue.number,
               owner: context.repo.owner,
               repo: context.repo.repo,
-              body: '⚠️ **No changeset found**\n\nThis PR appears to contain changes that should have a changeset.\n\nPlease run `pnpm changeset` and commit the generated changeset file.\n\nIf this PR doesn\'t need a changeset (e.g., docs, tests, or internal changes), you can ignore this message.'
+              body: '⚠️ **Versioning verification failed**\n\nPlease run `pnpm verify:versioning` locally to check the issues.\n\nCommon issues:\n- Missing changesets: Run `pnpm changeset`\n- Changelog sync issues: Run `pnpm changelog:sync`\n- Sidebar configuration: Check `apps/docs/astro.config.mjs`\n\nSee [Pre-Merge Checklist](.github/PRE_MERGE_CHECKLIST.md) for details.'
             })
-