Merge branch 'main' into patch-1

Author: crocodilestick

.github/copilot-instructions.md

@@ -186,6 +186,7 @@ Pluggable providers in `cps/metadata_provider/`:
 - `CWA_WATCH_MODE`: Force polling watcher (`poll`) or inotify (default)
 - `HARDCOVER_TOKEN`: API key for Hardcover metadata provider
 - `COOKIE_PREFIX`: Custom prefix for session cookies
+- `TRUSTED_PROXY_COUNT`: Number of proxies to trust for X-Forwarded-* headers (default: 1, use 2+ for CF Tunnel + reverse proxy)
 
 ## Common Pitfalls
 1. **Don't import SQLite on main thread**: Always use `init_db_thread()` in background tasks
@@ -195,6 +196,7 @@ Pluggable providers in `cps/metadata_provider/`:
 5. **WAL mode errors**: Usually means network share deployment without `NETWORK_SHARE_MODE=true`
 6. **Port binding**: Ports below 1024 need `cap_add: [NET_BIND_SERVICE]` in docker-compose
 7. **Calibre plugins**: Requires `customize.py.json` in `/config/.config/calibre/` to register
+8. **Session protection errors**: Behind multiple proxies? Set `TRUSTED_PROXY_COUNT` to match your proxy chain depth
 
 ## Version Management
 - **Installed version**: `/app/CWA_RELEASE` (baked at build time)

.github/workflows/tests.yml

@@ -33,10 +33,18 @@ jobs:
   fast-tests:
     name: Fast Tests (Smoke + Unit)
     runs-on: ubuntu-latest
+    env:
+      PYTHONDONTWRITEBYTECODE: '1'
 
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
+
+      - name: Remove Python bytecode and pycache
+        run: |
+          echo "Removing any leftover .pyc and pycache"
+          find . -name '__pycache__' -type d -print -exec rm -rf {} +
+          find . -name '*.pyc' -type f -print -delete
       
       - name: Set up Python 3.13
         uses: actions/setup-python@v5
@@ -136,10 +144,15 @@ jobs:
           pip install -r requirements.txt
           pip install -r requirements-dev.txt
       
-      - name: Pull/cache Docker images
-        run: |
-          docker pull doubleuynn/calibre-web-automated:latest || true
-          docker pull python:3.13-slim || true
+      - name: Build Docker image
+        uses: docker/build-push-action@v5
+        with:
+          context: .
+          push: false
+          load: true
+          tags: crocodilestick/calibre-web-automated:latest
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
 
       - name: Run Docker integration tests
         run: |
@@ -151,6 +164,7 @@ jobs:
             --junitxml=integration-results.xml
         env:
           CWA_TEST_PORT: "8083"  # CI uses production default port
+          CWA_TEST_IMAGE: "crocodilestick/calibre-web-automated:latest"
         timeout-minutes: 30  # Kill if stuck
 
       - name: Upload test results

.gitignore

@@ -26,6 +26,8 @@ docs/
 test_venv
 cwa.code-workspace
 
+
+
 # Test Scripts
 DEV
 */REFERENCE
@@ -80,6 +82,7 @@ htmlcov/
 .cache
 nosetests.xml
 coverage.xml
+coverage.md
 *.cover
 *.py,cover
 .hypothesis/
@@ -156,13 +159,14 @@ celerybeat.pid
 *.sage.py
 
 # Environments
-.env
+*.env
 .venv
 env/
 venv/
 ENV/
 env.bak/
 venv.bak/
+tmp/
 
 # Spyder project settings
 .spyderproject
@@ -193,4 +197,7 @@ cython_debug/
 #  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
 #  and can be added to the global gitignore or merged into this file.  For a more nuclear
 #  option (not recommended) you can uncomment the following to ignore the entire idea folder.
-#.idea/
+#.idea/
+
+# Dev instance files for testing in the same folder
+instance/

CONTRIBUTORS

@@ -1,7 +1,6 @@
 CONTRIBUTORS
 
 This file is automatically generated. DO NOT EDIT MANUALLY.
-Generated on: 2025-12-02T08:25:18.397010Z
 
 Upstream project: https://github.com/janeczku/calibre-web
 Fork project (Calibre-Web Automated, since 2024): https://github.com/crocodilestick/calibre-web-automated
@@ -304,7 +303,7 @@ Copyright (C) 2024-2025 Calibre-Web Automated contributors
 - zhiyue (1 commits)
 # Fork Contributors (crocodilestick/calibre-web-automated)
 
-- crocodilestick (797 commits)
+- crocodilestick (796 commits)
 - jmarmstrong1207 (73 commits)
 - demitrix (30 commits)
 - sirwolfgang (29 commits)